Embedded Radios Quick Start Guide - Revision history

Dvdakker: /* Experiment Setup */

2023-04-05T13:30:16Z

Experiment Setup

← Older revision		Revision as of 13:30, 5 April 2023
Line 8:		Line 8:

	* Open the JFed GUI, create a new experiment and drag in two wireless nodes.		* Open the JFed GUI, create a new experiment and drag in two wireless nodes.
			[[File:jfed_embedded_setup_01.png\|Experiment Setup\|480px]]
	* Configure the nodes. Make sure that you:		* 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 the correct testbed for the node (defaults to w-iLab.2, needs to be set to Citylab)
Line 14:		Line 14:
	** Explicitly set the specific node to use. '''Make sure that the nodes you select are within range of each other!'''. You can use the [https://doc.lab.cityofthings.eu/nodemap/ Node Map] to help you with this.		** Explicitly set the specific node to use. '''Make sure that the nodes you select are within range of each other!'''. You can use the [https://doc.lab.cityofthings.eu/nodemap/ Node Map] to help you with this.
	** name one of the nodes <code>nodeTX</code> and the other one <nodeRX>. You can use other node names but those are the node names that will be used throughout this guide.		** name one of the nodes <code>nodeTX</code> and the other one <nodeRX>. You can use other node names but those are the node names that will be used throughout this guide.
			[[File:jfed_embedded_setup_02.png\|Experiment Setup\|600px]]

	* 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 <code>Ubuntu 20.04 LTS 64-bit (CoT) with ARM gcc compiler</code> image we're using in this experiment is quite large so it'll take some time to load it onto the nodes.		* 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 <code>Ubuntu 20.04 LTS 64-bit (CoT) with ARM gcc compiler</code> image we're using in this experiment is quite large so it'll take some time to load it onto the nodes.

Dvdakker at 13:23, 5 April 2023

2023-04-05T13:23:50Z

← Older revision		Revision as of 13:23, 5 April 2023
Line 13:		Line 13:
	** Set Disk image to <code>Ubuntu 20.04 LTS 64-bit (CoT) with ARM gcc compiler</code>. This is important as we'll need the ARM gcc toolchain to compile the images for the devices.		** Set Disk image to <code>Ubuntu 20.04 LTS 64-bit (CoT) with ARM gcc compiler</code>. 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 [https://doc.lab.cityofthings.eu/nodemap/ Node Map] to help you with this.		** Explicitly set the specific node to use. '''Make sure that the nodes you select are within range of each other!'''. You can use the [https://doc.lab.cityofthings.eu/nodemap/ Node Map] to help you with this.
	** name one of the nodes <code>~~node_tx~~</code> 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.		** name one of the nodes <code>nodeTX</code> and the other one <nodeRX>. 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 <code>Ubuntu 20.04 LTS 64-bit (CoT) with ARM gcc compiler</code> image we're using in this experiment is quite large so it'll take some time to load it onto the nodes.		* 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 <code>Ubuntu 20.04 LTS 64-bit (CoT) with ARM gcc compiler</code> image we're using in this experiment is quite large so it'll take some time to load it onto the nodes.
Line 26:		Line 26:
	=== Preparing the receiver node ===		=== Preparing the receiver node ===

	1) SSH into the <code>~~node_rx~~</code> and clone the <code>LoRaMac-node</code> repository		1) SSH into the <code>nodeRX</code> and clone the <code>LoRaMac-node</code> repository
	<pre>		<pre>
	git clone https://github.com/imec-idlab/LoRaMac-node		git clone https://github.com/imec-idlab/LoRaMac-node
Line 65:		Line 65:
	The steps needed to prepare the transmitter node are almost identical to the steps needed to prepare the receiver node.		The steps needed to prepare the transmitter node are almost identical to the steps needed to prepare the receiver node.

	1) Open a new terminal, SSH into the <code>~~node_tx~~</code> and clone the <code>LoRaMac-node</code> repository		1) Open a new terminal, SSH into the <code>nodeTX</code> and clone the <code>LoRaMac-node</code> repository

	2) Change to the root dir of the repository		2) Change to the root dir of the repository
Line 96:		Line 96:
	</pre>		</pre>

	7) Switch back to the terminal of the <code>~~node_rx~~</code> testbed node. You should see lines similar to the ones below appearing		7) Switch back to the terminal of the <code>nodeRX</code> testbed node. You should see lines similar to the ones below appearing
	<pre>		<pre>
	0x520B4614248AB601,10,-33,25		0x520B4614248AB601,10,-33,25
Line 107:		Line 107:
	=== Experiment Cleanup ===		=== Experiment Cleanup ===

	In both the <code>~~node_tx~~</code> and <code>~~node_tx~~</code> terminals, perform the following actions to clean up the experiment:		In both the <code>nodeTX</code> and <code>nodeTX</code> terminals, perform the following actions to clean up the experiment:

	1) Press the 'Control' key and then press the 'A' and 'X' one after the other while holding the 'Control' key pressed down. This control-sequence stops the running <code>picocom</code> program		1) Press the 'Control' key and then press the 'A' and 'X' one after the other while holding the 'Control' key pressed down. This control-sequence stops the running <code>picocom</code> program
Line 127:		Line 127:
	=== Cloning, Compiling & Flashing the nodes ===		=== Cloning, Compiling & Flashing the nodes ===

	1) SSH into both the <code>~~node_tx~~</code> and <code>~~node_rx~~</code> experiment nodes in two separate terminals. Then perform the steps below '''on both experiment nodes'''		1) SSH into both the <code>nodeTX</code> and <code>nodeRX</code> experiment nodes in two separate terminals. Then perform the steps below '''on both experiment nodes'''

	2) Clone the contiki-ng git repository		2) Clone the contiki-ng git repository
Line 195:		Line 195:
	=== Pinging from one node to another ===		=== Pinging from one node to another ===

	If you've followed the steps above you should now have two 'terminal' windows open. One where you are logged in to the serial console of the OpenUSB devices of <code>~~node_tx~~</code> and one where you are logged in to the console of the OpenUSB device connected to <code>~~node_rx~~</code>.		If you've followed the steps above you should now have two 'terminal' windows open. One where you are logged in to the serial console of the OpenUSB devices of <code>nodeTX</code> and one where you are logged in to the console of the OpenUSB device connected to <code>nodeRX</code>.


	12) In the <code>~~node_rx~~</code> terminal, enter <code>ip-addr</code> and press enter to retrieve the link-local address of the Openmote. The result should be similar to this:		12) In the <code>nodeRX</code> terminal, enter <code>ip-addr</code> and press enter to retrieve the link-local address of the Openmote. The result should be similar to this:
	<pre>		<pre>
	#0012.4b00.0YYY.XXXX> ip-addr		#0012.4b00.0YYY.XXXX> ip-addr
Line 206:		Line 206:
	</pre>		</pre>

	13) In the <code>~~node_tx~~</code> terminal, enter the following command:		13) In the <code>nodeTX</code> terminal, enter the following command:
	<pre>ping <ip>		<pre>ping <ip>
	</pre>		</pre>
	Where <code><ip></code> is the ''ip-address'' of the <code>~~node_rx~~</code>. The result should be similar to this:		Where <code><ip></code> is the ''ip-address'' of the <code>nodeRX</code>. The result should be similar to this:
	<pre>		<pre>
	#0012.4b00.0YYY.ZZZZ> ping fe80::212:4b00:YYY:XXXX		#0012.4b00.0YYY.ZZZZ> ping fe80::212:4b00:YYY:XXXX
Line 218:		Line 218:
	=== Experiment Cleanup ===		=== Experiment Cleanup ===

	In both the <code>~~node_tx~~</code> and <code>~~node_tx~~</code> terminals, perform the following actions to clean up the experiment:		In both the <code>nodeTX</code> and <code>nodeTX</code> terminals, perform the following actions to clean up the experiment:

	1) Press the 'Control' key and then press the 'A' and 'X' one after the other while holding the 'Control' key pressed down. This control-sequence stops the running <code>picocom</code> program		1) Press the 'Control' key and then press the 'A' and 'X' one after the other while holding the 'Control' key pressed down. This control-sequence stops the running <code>picocom</code> program

Dvdakker: /* Experiment Cleanup */

2023-04-05T12:51:32Z

Experiment Cleanup

← Older revision		Revision as of 12:51, 5 April 2023
Line 218:		Line 218:
	=== Experiment Cleanup ===		=== Experiment Cleanup ===

	In both the node_tx and node_tx, perform the following actions to clean up the experiment:		In both the <code>node_tx</code> and <code>node_tx</code> terminals, perform the following actions to clean up the experiment:

			1) Press the 'Control' key and then press the 'A' and 'X' one after the other while holding the 'Control' key pressed down. This control-sequence stops the running <code>picocom</code> program

			2) From the <code>examples/hello-world</code> directory in the contiki-ng source tree, run the following command to wipe the flash on the OpenUSB device:
			<pre>
			../../tools/cc2538-bsl/cc2538-bsl.py -e -p /dev/ttyOPENUSB --bootloader-invert-lines
			</pre>
			It is important you do this since otherwise the OpenUSB devices will remain accessible over the wireless interface.

Dvdakker: /* Experiment Cleanup */

2023-04-05T12:44:05Z

Experiment Cleanup

← Older revision		Revision as of 12:44, 5 April 2023
Line 217:		Line 217:

	=== Experiment Cleanup ===		=== Experiment Cleanup ===

			In both the node_tx and node_tx, perform the following actions to clean up the experiment:

Dvdakker: /* Experiment Cleanup */

2023-04-05T12:43:50Z

Experiment Cleanup

← Older revision		Revision as of 12:43, 5 April 2023
Line 107:		Line 107:
	=== Experiment Cleanup ===		=== Experiment Cleanup ===

	In both the <code>node_tx</code> and <code>node_tx</code>, perform the following actions to clean up the experiment:		In both the <code>node_tx</code> and <code>node_tx</code> terminals, perform the following actions to clean up the experiment:

	1) Press the 'Control' key and then press the 'A' and 'X' one after the other while holding the 'Control' key pressed down. This control-sequence stops the running <code>picocom</code> program		1) Press the 'Control' key and then press the 'A' and 'X' one after the other while holding the 'Control' key pressed down. This control-sequence stops the running <code>picocom</code> program

Dvdakker: /* Running Contiki-NG on the OpenUSB Radios */

2023-04-05T12:43:29Z

Running Contiki-NG on the OpenUSB Radios

← Older revision		Revision as of 12:43, 5 April 2023
Line 215:		Line 215:
	Received ping reply from fe80::212:4b00:YYY:XXXX, len 4, ttl 64, delay 78 ms		Received ping reply from fe80::212:4b00:YYY:XXXX, len 4, ttl 64, delay 78 ms
	</pre>		</pre>

			=== Experiment Cleanup ===

Dvdakker: /* Pinging from one node to another */

2023-04-05T12:43:03Z

Pinging from one node to another

@@ Line 204: / Line 204: @@
 -- fe80::212:4b00:YYY:XXXX
 #0012.4b00.0YYY.XXXX>
 </pre>

Dvdakker: /* Running Contiki-NG on the OpenUSB Radios */

2023-04-05T12:33:10Z

Running Contiki-NG on the OpenUSB Radios

@@ Line 126: / Line 126: @@
 === Cloning, Compiling & Flashing the nodes ===
 ) SSH into both the <code>node_tx</code> and <code>node_rx</code> experiment nodes in two separate terminals. Then perform the steps below '''on both experiment nodes'''
@@ Line 158: / Line 157: @@
    etimer_set(&timer, CLOCK_SECOND * 120);
 </pre>
-The reason we do this is because we'll be using the serial port to issue commands to the m
+The reason we do this is because we'll be opening a 'shell' to the device later on and having the "''Hello World''" prompt interrupting the shell session every 10 seconds is annoying.

Dvdakker: /* Running Contiki on the OpenUSB Radios */

2023-04-05T11:35:44Z

Running Contiki on the OpenUSB Radios

@@ Line 117: / Line 117: @@
 It is important you do this since otherwise the transmitter node will keep sending beacons.
-== Running Contiki on the OpenUSB Radios ==
+== Running Contiki-NG on the OpenUSB Radios ==
-For this guide we re-use the same JFed experiment setup as for the 'LoRa device' (discussed above). In this section we'll flash two OpenUSB devices and ping from one to the other. For more information on how to use contiki consult the Contiki documentation at:
+For this guide we re-use the same JFed experiment setup as for the 'LoRa device' (discussed above). In this section we'll flash two OpenUSB devices and ping from one to the other. The guide in this section is based on the [https://docs.contiki-ng.org/en/develop/doc/tutorials/Hello%2C-World%21.html Hello World], [https://docs.contiki-ng.org/en/develop/doc/tutorials/Shell.html Shell] and [https://docs.contiki-ng.org/en/develop/doc/tutorials/IPv6-ping.html IPv6 Ping] tutorials on the Contiki-NG documentation website, but focusses specifically on the OpenMote platform.
 * https://docs.contiki-ng.org/en/develop/doc/tutorials/
 * https://github.com/contiki-ng/contiki-ng/wiki
-===  ===
+=== Cloning, Compiling & Flashing the nodes ===

Dvdakker: /* Running Contiki on the OpenUSB Module */

2023-04-05T11:22:03Z

Running Contiki on the OpenUSB Module

← Older revision		Revision as of 11:22, 5 April 2023
Line 117:		Line 117:
	It is important you do this since otherwise the transmitter node will keep sending beacons.		It is important you do this since otherwise the transmitter node will keep sending beacons.

	== Running Contiki on the OpenUSB ~~Module~~ ==		== Running Contiki on the OpenUSB Radios ==

			For this guide we re-use the same JFed experiment setup as for the 'LoRa device' (discussed above). In this section we'll flash two OpenUSB devices and ping from one to the other. For more information on how to use contiki consult the Contiki documentation at:
			* https://docs.contiki-ng.org/en/develop/doc/tutorials/
			* https://github.com/contiki-ng/contiki-ng/wiki

			=== ===