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 16:01] – [3. Backend] samer | esib_iot_challenge [2017/05/17 18:50] – [3. Devices] samer | ||
---|---|---|---|
Line 3: | Line 3: | ||
Welcome to the ESIB IoT Challenge. In this challenge, you will be 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 ===== |
During 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 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: | ||
Line 14: | Line 14: | ||
[{{ : | [{{ : | ||
- | < | + | < |
* Where is the LoRa modulation implemented on the platform? | * Where is the LoRa modulation implemented on the platform? | ||
* What are the advantages of the LoRa modulation? | * What are the advantages of the LoRa modulation? | ||
* How LoRa is compatible with LPWAN requirements and constraints? | * How LoRa is compatible with LPWAN requirements and constraints? | ||
* What is LoRaWAN? What is the difference between LoRaWAN and LoRa? | * What is LoRaWAN? What is the difference between LoRaWAN and LoRa? | ||
- | * Where is LoRaWAN implemented in the platform? | ||
- | * Where does the IP layer start in the platform? Comment your answer considering the trends in IoT. | ||
* Illustrate the protocol stacks on the LoRaWAN platform. | * Illustrate the protocol stacks on the LoRaWAN platform. | ||
+ | * What elements are IP enabled in the platform? What do you think about IP support in IoT? | ||
+ | </ | ||
+ | ===== -. Backend ===== | ||
+ | In a LoRaWAN network, the devices communicate with a Network Server through the gateway. The backend installed in the platform is based on an open-source LoRaWAN network-server https:// | ||
+ | |||
+ | [{{ : | ||
+ | |||
+ | Start by choosing the application named '' | ||
+ | * 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: '' | ||
+ | * A unique application key on 128 bits also obtained by random generation. | ||
+ | |||
+ | Make sure that the '' | ||
+ | |||
+ | <WRAP left round 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 device activation methods used in LoRaWAN by giving the advantages and inconvenients. | ||
+ | * What is the difference between the two receive windows in LoRaWAN? What are they used for? | ||
</ | </ | ||
===== -. Devices ===== | ===== -. Devices ===== | ||
Line 27: | Line 46: | ||
Devices in the LoRaWAN platform are implemented on Arduino boards with Dragino shields. The combined module as well as the basic configuration steps are presented in [[simple_lora_prototype|Simple Prototype of LoRa Communications]]. | Devices in the LoRaWAN platform are implemented on Arduino boards with Dragino shields. The combined module as well as the basic configuration steps are presented in [[simple_lora_prototype|Simple Prototype of LoRa Communications]]. | ||
- | Start by verifying the installation on your PC of the latest Arduino IDE and place the Arduino LMIC library in the corresponding folder. | + | Start by verifying the installation on your PC of the latest Arduino IDE. Drop the Arduino LMIC library in the corresponding folder. These tools are provided at the beginning of the challenge. Open the example sketch '' |
<WRAP left round help 100%> | <WRAP left round help 100%> | ||
- | * Give the characteristics of the Arduino you are using: number of pins, type of pins, memory sizes, etc. | + | * Give the characteristics of the Arduino you are using: |
* Give the main characteristics of the LoRa shield from Dragino (www.dragino.com). | * Give the main characteristics of the LoRa shield from Dragino (www.dragino.com). | ||
* What type of Antenna are you using? Explain the corresponding characteristics. | * What type of Antenna are you using? Explain the corresponding characteristics. | ||
</ | </ | ||
+ | Now you should configure your device with the same identifiers '' | ||
- | Download the example sketch, open it with Arduino IDE and compile it. | ||
- | |||
- | You can download the following sketch {{ : | ||
- | |||
- | Verify that you have the latest Arduino IDE from https:// | ||
- | Install the board files as noted in http:// | ||
- | Add the following library sodaq_rn2483_2.zip to your Arduino IDE as explained in https:// | ||
- | |||
- | In order to program the LoRaWAN devices, you should verify the installation one your PC of the following software: | ||
- | |||
- | * Arduino IDE | ||
- | * LMIC Library | ||
- | * | ||
- | The pin mapping corresponds to the Dragino electronic schematic: | ||
<code c++> | <code c++> | ||
- | const lmic_pinmap lmic_pins | + | static |
- | .nss = 10, | + | void os_getArtEui (u1_t* buf) { memcpy_P(buf, APPEUI, 8);} |
- | .rxtx = LMIC_UNUSED_PIN, | + | |
- | .rst = 9, | + | |
- | .dio = {2, 6, 7}, | + | |
- | }; | + | |
- | </ | + | |
- | The send function is rescheduled TX_INTERVAL seconds after each transmission complete event: | + | // This should also be in little endian format, see above. |
- | <code c++> | + | static const u1_t PROGMEM DEVEUI[8]= { }; |
- | case EV_TXCOMPLETE: | + | void os_getDevEui |
- | Serial.println(F(" | + | |
- | if(LMIC.dataLen) { | + | |
- | | + | |
- | Serial.print(F(" | + | |
- | Serial.write(LMIC.frame+LMIC.dataBeg, LMIC.dataLen); | + | |
- | | + | |
- | } | + | |
- | // Schedule next transmission | + | |
- | os_setTimedCallback(& | + | |
- | break; | + | |
- | </ | + | |
- | The send function is initially scheduled here: | + | static const u1_t PROGMEM APPKEY[16] = { }; |
- | <code c++> | + | void os_getDevKey (u1_t* buf) { memcpy_P(buf, APPKEY, 16);} |
- | do_send(& | + | |
</ | </ | ||
- | The message containing the sensor values is transmitted on one of the radio channels: | + | <WRAP left round tip 100%> |
- | <code c++> | + | Note that the device and application identifiers should be in little endian format, while the application key is in big endian format. For example, '' |
- | LMIC_setTxData2(1, | + | </WRAP> |
- | </code> | + | |
- | + | ||
- | === -. Triggered Message Sending === | + | |
- | You can also find another example of sketch | + | Let us analyze |
- | < | + | < |
- | * OTAA | + | * In the setup function, which channels are activated on the device? |
- | * ID | + | * What are the different spreading factors on each channel? |
- | * Security | + | * What is the regulation on the radio channels in LoRa? |
</ | </ | ||
- | ===== -. Backend ===== | ||
- | The Loraserver has a web interface for configuring the applications and devices on the platform. | ||
- | [{{ : | + | The LMIC library defines a set of events corresponding to the protocol machine state. These events appear in the '' |
- | Start by choosing the application named '' | + | <WRAP left round help 100%> |
- | * A unique node name: '' | + | * What is the difference between the JOINING and the JOINED events? |
- | * The node description | + | * When is the EV_TXCOMPLETE event called? |
- | * A unique device EUI on 64 bits: Random identifiers can be generated on [[https:// | + | </WRAP> |
- | * 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. | + | |
- | Make sure that the '' | + | Finally let us look at the message sending on the device. |
- | <WRAP left help 100%> | + | <WRAP left round help 100%> |
- | * What does the application EUI mean? How is it used in LoRaWAN? | + | * What is the function for sending messages on the device? How it is called? |
- | * What does the application key mean? How is it used in LoRaWAN security? | + | * What is the period of message sending? Explain |
- | * Compare the two join methods used in LoRaWAN by giving | + | * Is this period guaranteed according to the LoRaWAN |
- | * What is the difference between the two receive windows in LoRaWAN? | + | |
</ | </ | ||
- | ===== -. Applications ===== | ||
- | ==== -. mqtt-spy ==== | ||
+ | Now you are ready to compile the sketch and upload it to the LoRaWAN device. Connect the device a USB port on your PC, choose the board type as '' | ||
+ | |||
+ | Open the serial monitor in the Arduino IDE at 115200 baud and analyse the debug messages. | ||
+ | |||
+ | ===== -. Applications ===== | ||
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