Difference between revisions of "Embedded Radios Quick Start Guide"

From CityLab Testbed
Jump to navigation Jump to search
Line 20: Line 20:
 
== Getting started with the EFM32GG+RFM95W (LoRa) module ==
 
== Getting started with the EFM32GG+RFM95W (LoRa) module ==
  
To help you get started with the "EFM32GG+RFM95W" module
+
To help you get started with the "EFM32GG+RFM95W" module, we've ported the [https://github.com/Lora-net/LoRaMac-node LoraWAN network stack] to the "EFM32GG+RFM95W". This port can be found in the following Github repository:
 +
* https://github.com/imec-idlab/LoRaMac-node
  
 +
In this guide, we'll use that repository to set up a basic broadcast tx/rx between two nodes but the stack has many other capabilities as well.
  
=== SSH into both the <code>node_tx</code> and <code>node_rx</code> nodes in separate terminals. ===
+
=== Preparing the receiver node ===
  
 +
* SSH into the <code>node_rx</code> and clone the <code>LoRaMac-node</code> repository
 +
<pre>
 +
git clone https://github.com/imec-idlab/LoRaMac-node
 +
</pre>
 +
* Change to the root dir of the repository
 +
<pre>
 +
cd LoraMac-node
 +
</pre>
 +
* Edit the file <code>Makefile.local</code> and make sure it has the following contents:
 +
<pre>
 +
TARGET=
 +
</pre>
  
  
  
  
 +
=== SSH into both the <code>node_tx</code> and <code>node_rx</code> nodes in separate terminals. ===
  
 
== OpenMote / OpenUSB ==
 
== OpenMote / OpenUSB ==

Revision as of 08:51, 5 April 2023

This quick start guide will explain how to get started with the "LoRa" (EFM32GG+RFM95W) an the OpenUSB modules of the Citylab testbed nodes.

Prerequisites

This quick start guide assumes you already have access to the Citylab Testbed and that you are familiar with the steps required to start experiments. If that is not the case then please follow the Getting Started guide first.


Experiment Setup

  • Open the JFed GUI, create a new experiment and drag in two wireless nodes.
  • Configure the nodes. Make sure that you:
    • Set the correct testbed for the node (defaults to w-iLab.2, needs to be set to Citylab)
    • Set Disk image to Ubuntu 20.04 LTS 64-bit (CoT) with ARM gcc compiler. This is important as we'll need the ARM gcc toolchain to compile the images for the devices.
    • Explicitly set the specific node to use. **Make sure that the nodes you select are within range of each other!**. You can use the Node Map to help you with this.
    • name one of the nodes node_tx and the other one <node_rx>. You can use other node names but those are the node names that will be used throughout this guide.
  • Click "Run" to start the experiment and wait the the nodes to finish initialising. Important: It'll take a bit longer than usual to start the experiment as the Ubuntu 20.04 LTS 64-bit (CoT) with ARM gcc compiler image we're using in this experiment is quite large so it'll take some time to load it onto the nodes.


Getting started with the EFM32GG+RFM95W (LoRa) module

To help you get started with the "EFM32GG+RFM95W" module, we've ported the LoraWAN network stack to the "EFM32GG+RFM95W". This port can be found in the following Github repository:

In this guide, we'll use that repository to set up a basic broadcast tx/rx between two nodes but the stack has many other capabilities as well.

Preparing the receiver node

  • SSH into the node_rx and clone the LoRaMac-node repository
git clone https://github.com/imec-idlab/LoRaMac-node
  • Change to the root dir of the repository
cd LoraMac-node
  • Edit the file Makefile.local and make sure it has the following contents:
TARGET=



SSH into both the node_tx and node_rx nodes in separate terminals.

OpenMote / OpenUSB