boards Arduino Zero BBC micro bit IoT-LAB M3 Microchip SAMR21 Microchip SAMR30 Nordic nRF51DK Nordic nRF52840DK Nordic nRF52DK nRF52832-MDK nRF52840-MDK NXP FRDM-KW41Z Phytec PhyNODE-KW2X ST B-L072Z-LRWAN1 ST B-L475E-IOT01A Zolertia Firefly
RIOT is a real-time multi-threading operating system that explicitly considers devices with minimal resources but eases development across the wide range of devices that are typically found in the Internet of Things. RIOT is based on design objectives including energy-efficiency, reliability, real-time capabilities, small memory footprint, modularity, and uniform API access, independent of the underlying hardware (this API offers partial POSIX compliance). Several libraries (e.g. Wiselib) are already available on RIOT, as well as a full IPv6 network protocol stack including the latest standards of the IETF for connecting constrained systems to the Internet (6LoWPAN, IPv6, RPL, TCP and UDP).
Good RIOT tutorials are also available on GitHub:
Compilation from IoT-LAB SSH frontend
With recent versions of RIOT (2018.01+), the default version of the GNU Toolchain for ARM (4.9) doesn’t work.
RIOT recommends to use 7.2+. Before building any RIOT firmware on an SSH frontend, ensure RIOT related environment variables are correctly set with:
Border Router and IPv6 networking on IoT-LAB
To connect to the serial link of your border router and propagate an IPv6 prefix through your network, RIOT provides the
ethos_uhcpd tool. It uses the serial interface, ethos (Ethernet Over Serial) and UHCP (micro Host Configuration Protocol). Ethos multiplexes serial data to separate ethernet packets from shell commands. UHCP is in charge of configuring the wireless interface prefix and routes on the Border Router.
For boards based on a microcontroller
Usually, it needs sudo privileges to be able to create a dedicated tap interface. Since the command has to be launched from the SSH frontend to have access to serial link, where you are not part of the sudoers, you have to use a wrapper we developed:
sudo ethos_uhcpd.py <node-id> tap<num> fd00::1/64
node-idrefers to the node acting as Border Router;
numspecifies a free tap interface (see below);
fd00::1/64is the default IPv6 prefix. It can be replaced by another local prefix, or even by a global prefix (see IPv6).
To list tap interface currently in use, launch the following command on the SSH frontend:
<login>@<site>:~$ ip addr show | grep tap
Choose one not in the list. You could use tap0 if there is not output.
For boards running an embedded Linux
Get the RIOT release onto the embedded Linux environment.
Start the network from the embedded node, using the serial link to the co-microcontroller, which has to run a border router firmware:
make -C <path-to-riot>/tools/uhcpd clean all make -C <path-to-riot>/tools/ethos clean all cd <path-to-riot>/tools/ethos ./start_network.sh <device> tap0 fd00::1/64
refers to the local device serial link; for example, for IoT-LAB A8-M3 boards the M3 co-microcontroller's serial link is `/dev/ttyA8_M3`
fd00::1/64is the default IPv6 prefix. It can be replaced by another local prefix, or even by a global prefix. In this later case, get it thanks to environment variables set in the embedded Linux environment:
root@node-a8-1:~# printenv ... INET6_PREFIX_LEN=64 INET6_PREFIX=2001:660:5307:3001 ...