esib_iot_challenge
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision | ||
esib_iot_challenge [2017/05/17 09:17] – samer | esib_iot_challenge [2017/05/17 16:16] – [2. Backend] samer | ||
---|---|---|---|
Line 1: | Line 1: | ||
====== ESIB IoT Challenge ====== | ====== ESIB IoT Challenge ====== | ||
- | Welcome to the ESIB IoT Challenge. In this challenge, you will designing and prototyping the first IoT services based on a LoRaWAN network. | + | Welcome to the ESIB IoT Challenge. In this challenge, you will be designing and prototyping the first IoT services based on a LoRaWAN network. |
- | ===== -. What is a LoRaWAN | + | ===== -. Platform ===== |
- | In this challenge, you will benefit from the first experimental platform implementing an end-to-end LoRaWAN solution in Lebanon. The platform consists of the following elements: | + | During |
* Devices that communicate to one or more gateways via a wireless interface using single hop LoRa and implementing the LoRaWAN protocol. These devices are physically connected to sensors that generate data. | * Devices that communicate to one or more gateways via a wireless interface using single hop LoRa and implementing the LoRaWAN protocol. These devices are physically connected to sensors that generate data. | ||
Line 14: | Line 14: | ||
[{{ : | [{{ : | ||
- | ===== -. Devices | + | <WRAP left help 100%> |
- | ==== -. Autonomo with LoRaBee ==== | + | * Where is the LoRa modulation implemented on the platform? |
+ | * What are the advantages of the LoRa modulation? | ||
+ | * How LoRa is compatible with LPWAN requirements and constraints? | ||
+ | * What is LoRaWAN? What is the difference between LoRaWAN and LoRa? | ||
+ | * Illustrate the protocol stacks on the LoRaWAN platform (you can refer to the contents of this presentation https:// | ||
+ | * What elements are IP enabled in the platform? What do you think about IP support in IoT? | ||
+ | </ | ||
+ | ===== -. Backend | ||
+ | In the platform, the devices communicate to a backend Loraserver through the gateway. The backend implements the network server functions and provides frame control and security. It has a web interface for configuring the applications and devices on the platform (https:// | ||
- | Starting with the devices in the LoRaWAN platform, we will use an [[http://support.sodaq.com/ | + | [{{ :app-loraserver.png? |
- | In order to configure | + | Start by choosing |
+ | * A unique node name: '' | ||
+ | * The node description | ||
+ | * A unique | ||
+ | * The application EUI on 64 bits: '' | ||
+ | * A unique application key on 128 bits also obtained by random generation. | ||
+ | * In advanced network settings, choose the receive window RX2. | ||
- | - Verify | + | Make sure that the '' |
- | - Install the board files as noted in [[http:// | + | |
- | - Add the following library {{ : | + | |
- | Now you are ready to write a sketch for the device. Here is one example sketch {{ : | + | <WRAP left help 100%> |
+ | * What does the application EUI mean? How is it used in LoRaWAN? | ||
+ | * What does the application key mean? How is it used in LoRaWAN security? | ||
+ | * Compare the two join methods used in LoRaWAN by giving the advantages | ||
+ | * What is the difference between the two receive windows in LoRaWAN? What are they used for? | ||
+ | </ | ||
+ | ===== -. Devices ===== | ||
- | In this part, you should put the keys for Over-The-Air Activation (OTAA) | + | Devices in the LoRaWAN platform are implemented on Arduino boards with Dragino shields. |
- | <code c++> | + | |
- | // USE YOUR OWN KEYS! | + | |
- | const uint8_t devEUI[8] = | + | |
- | { }; | + | |
- | // USE YOUR OWN KEYS! | + | Start by verifying the installation on your PC of the latest Arduino IDE and place the Arduino LMIC library in the corresponding folder. |
- | const uint8_t appEUI[8] = | + | |
- | { }; | + | |
- | const uint8_t appKey[16] = | + | <WRAP left round help 100%> |
- | { }; | + | * Give the characteristics of the Arduino you are using: number of pins, type of pins, memory sizes, etc. |
- | </code> | + | * Give the main characteristics of the LoRa shield from Dragino (www.dragino.com). |
- | + | * What type of Antenna are you using? Explain the corresponding characteristics. | |
- | The pins for connecting | + | </WRAP> |
- | <code c++> | + | |
- | int light_pin = A0; | + | |
- | int moisture_pin = A2; | + | |
- | int temperature_pin = 0; | + | |
- | int temperature_vcc_pin = 1; | + | |
- | int moisture_vcc_pin = 8; | + | |
- | int moisture_gnd_pin = 7; | + | |
- | </code> | + | |
- | The OTAA method is used for joining the network and Adaptive Data Rate (ADR) is activated: | ||
- | <code c++> | ||
- | LoRaBee.initOTA(loraSerial, | ||
- | </ | ||
- | Eight different sub channels are activated | + | Download the example sketch, open it with Arduino IDE and compile it. |
- | <code c++> | + | |
- | LoRaBee.configChFreq(0, | + | You can download the following sketch {{ : |
- | LoRaBee.configChFreq(1, | + | |
- | LoRaBee.configChFreq(2, | + | |
- | LoRaBee.configChFreq(3, | + | |
- | LoRaBee.configChFreq(4, | + | |
- | LoRaBee.configChFreq(5, | + | |
- | LoRaBee.configChFreq(6, | + | |
- | LoRaBee.configChFreq(7, | + | |
- | </ | + | |
- | Finally, | + | Verify that you have the latest Arduino IDE from https://www.arduino.cc/ |
- | <code c++> | + | Install the board files as noted in http:// |
- | LoRaBee.send(1, (uint8_t*)message.c_str(), message.length()) | + | Add the following library sodaq_rn2483_2.zip to your Arduino IDE as explained in https:// |
- | </code> | + | |
- | ==== -. Arduino with Dragino Shield ==== | + | |
- | === -. Periodic Message Sending === | + | |
- | Devices in the LoRaWAN | + | In order to program |
+ | * Arduino IDE | ||
+ | * LMIC Library | ||
+ | * | ||
The pin mapping corresponds to the Dragino electronic schematic: | The pin mapping corresponds to the Dragino electronic schematic: | ||
<code c++> | <code c++> | ||
Line 107: | Line 99: | ||
</ | </ | ||
- | The message containing the sensor values is transmitted on one of the radio channels | + | The message containing the sensor values is transmitted on one of the radio channels: |
<code c++> | <code c++> | ||
LMIC_setTxData2(1, | LMIC_setTxData2(1, | ||
- | </ | ||
- | |||
- | The adaptive data rate is not supported, and the spreading factor is configured as follows: | ||
- | <code c++> | ||
- | LMIC_setDrTxpow(DR_SF7, | ||
</ | </ | ||
Line 120: | Line 107: | ||
You can also find another example of sketch to download: {{ : | You can also find another example of sketch to download: {{ : | ||
- | ===== -. Gateways ===== | ||
- | ==== -. Single Channel Gateway ==== | ||
- | The single channel gateway includes a LoRa transmission module (Dragino Shield) connected to a Raspberry Pi (2 or 3) as shown in Figure 2. Communication between the two modules is done over an SPI interface. | + | <WRAP center help 100%> |
- | + | * OTAA | |
- | [{{ : | + | * ID |
- | + | * Security | |
- | In order to assemble the gateway, start by making the wire connections: | + | </WRAP> |
- | [{{ : | + | |
- | [{{ : | + | |
- | + | ||
- | Connect the Raspberry Pi to the Internet and install the packet forwarding software. The source code of the single channel packet forwarder is available on: [[https:// | + | |
- | * Enable SPI on the Raspberry Pi using raspi-config | + | |
- | * Download and unzip the source code: | + | |
- | + | ||
- | <code bash> | + | |
- | wget https:// | + | |
- | unzip master.zip | + | |
- | </ | + | |
- | + | ||
- | * Install the wiring library: | + | |
- | + | ||
- | <code bash> | + | |
- | apt-get update | + | |
- | apt-get install wiring | + | |
- | </code> | + | |
- | + | ||
- | Compile the packet forwarder: | + | |
- | <code bash> | + | |
- | make all | + | |
- | </ | + | |
- | + | ||
- | For gcc version 4.6.3, a compilation error results in the following warning '' | + | |
- | < | + | |
- | CFLAGS = -std=c++0x -c -Wall -I include/ | + | |
- | </ | + | |
- | + | ||
- | Now, you need to configure the single channel packet forwarder. This is done in the {{ : | + | |
- | + | ||
- | Finally, you can run the packet forwarder as root! | + | |
- | + | ||
- | <code bash> | + | |
- | nohup ./ | + | |
- | </ | + | |
- | ==== -. Kerlink IoT Station ==== | + | |
- | + | ||
- | < | + | |
- | # activates eth0 at startup | + | |
- | ETHERNET=yes | + | |
- | # claims dhcp request on eth0 | + | |
- | ETHDHCP=yes | + | |
- | + | ||
- | # Selector operator APN | + | |
- | GPRSAPN=gprs.touch.com.lb | + | |
- | # Enter pin code if activated | + | |
- | GPRSPIN=0000 | + | |
- | # Update / | + | |
- | GPRSDNS=yes | + | |
- | # PAP authentication | + | |
- | GPRSUSER= | + | |
- | GPRSPASSWORD= | + | |
- | + | ||
- | # Bearers priority order | + | |
- | # | + | |
- | BEARERS_PRIORITY=" | + | |
- | </ | + | |
- | + | ||
- | < | + | |
- | ./ | + | |
- | </ | + | |
- | + | ||
- | < | + | |
- | 3270 root 2548 S /bin/sh ./ | + | |
- | 3288 root 34908 S ./ | + | |
- | </ | + | |
- | + | ||
- | < | + | |
- | / | + | |
- | + | ||
- | [root@Wirgrid_0b03008c demo_gps_loramote]# | + | |
- | pppd (pid 5273) is running... | + | |
- | Session: Rx=58, Tx=163 | + | |
- | Globals: Rx=1130457, Tx=1195592 | + | |
- | Sum: | + | |
- | [root@Wirgrid_0b03008c demo_gps_loramote]# | + | |
- | </ | + | |
- | + | ||
- | ===== -. Backend ===== | + | |
- | ==== -. Loraserver ==== | + | |
- | + | ||
- | The Loraserver has a web interface for configuring the applications and devices on the platform. Full details for installing the software are provided on [[https:// | + | |
- | + | ||
- | [{{ : | + | |
- | + | ||
- | Start by creating and application as in Figure 5. Then create a node in this application and provide the following information: | + | |
- | * A unique node name | + | |
- | * The node description | + | |
- | * A unique device EUI on 64 bits: Random identifiers can be generated on [[https:// | + | |
- | * The application EUI on 64 bits: this can be a common identifier for all nodes using the same application. | + | |
- | * A unique application key on 128 bits | + | |
- | + | ||
- | In order to enable OTAA join method, you have to make sure that the '' | + | |
- | + | ||
- | + | ||
- | ==== -. The Things Network ==== | + | |
===== -. Applications ===== | ===== -. Applications ===== | ||
- | ==== -. mqtt-spy ==== | ||
- | |||
mqtt-spy is an open source utility intended to help you with monitoring activity on MQTT topics. It has been designed to deal with high volumes of messages, as well as occasional publications. mqtt-spy is a JavaFX application, | mqtt-spy is an open source utility intended to help you with monitoring activity on MQTT topics. It has been designed to deal with high volumes of messages, as well as occasional publications. mqtt-spy is a JavaFX application, | ||
You can use mqtt-spy to debug the messages received from the LoRaWAN devices. For this, you should download the software tool from [[https:// | You can use mqtt-spy to debug the messages received from the LoRaWAN devices. For this, you should download the software tool from [[https:// | ||
- | ==== -. Emoncms ==== |
esib_iot_challenge.txt · Last modified: 2021/08/28 09:53 by samer