wikiroute

networking recipes

User Tools

Site Tools


deploying_lorawan

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
deploying_lorawan [2017/04/30 16:28] – [Deploying an End-to-End LoRaWAN Platform] samerdeploying_lorawan [2021/08/28 09:50] (current) samer
Line 3: Line 3:
 Starting from September 2016, Saint-Joseph University of Beirut (USJ) will be deploying the first academic [[http://www.semtech.com/wireless-rf/internet-of-things/what_is_lora.html | LoRa]] network in Lebanon. The network will support monitoring of micro-climate conditions in vineyards. Here below you can find a detailed description of the experimental platform implementing an end-to-end LoRaWAN solution. The platform consists of the following elements: Starting from September 2016, Saint-Joseph University of Beirut (USJ) will be deploying the first academic [[http://www.semtech.com/wireless-rf/internet-of-things/what_is_lora.html | LoRa]] network in Lebanon. The network will support monitoring of micro-climate conditions in vineyards. Here below you can find a detailed description of the experimental platform implementing an end-to-end LoRaWAN solution. The platform consists of the following elements:
  
-  * Wireless devices with sensing interface and a communication interface implementing the LoRaWAN protocol. +  * Devices that communicate to one or more gateways via wireless interface using single hop LoRa and implementing the LoRaWAN protocol. These devices are physically connected to sensors that generate data.  
-  * Gateways or base stations that relay the radio frames to the IP backend+  * Gateways or base stations that forward frames between the devices and the network server. Gateways are connected to the network server via IP interfaces
-  * A LoRAWAN backend implementing the network server function+  * A LoRAWAN backend that implements the network server functions and provides frame control and security
-  * Application examples that enable to visualize and store the sensor data. +  * Applications that enable to visualize and store the sensor data obtained from the devices
  
-[{{ :lora-pilot-architecture.png?direct&650 | Figure 2. Architecture of the LoRaWAN Platform}}] +[{{ :lora-pilot-architecture.png?direct&650 | Figure 1. Architecture of the LoRaWAN Platform}}] 
-===== -Devices ===== +===== - Devices ===== 
-==== -Autonomo with LoRaBee ====+==== - Autonomo with LoRaBee ====
  
 Starting with the devices in the LoRaWAN platform, we will use an [[http://support.sodaq.com/sodaq-one/autonomо/|Autonomo]] board with a LoRaBee Microchip RN2483 module. According to [[http://shop.sodaq.com]], Autonomo is a matchbox-sized powerhouse which uses the new Atmel Cortex M0+ 32bit micro controller. One advantage of such device is that it can be powered by a smartphone-sized solar panel. Starting with the devices in the LoRaWAN platform, we will use an [[http://support.sodaq.com/sodaq-one/autonomо/|Autonomo]] board with a LoRaBee Microchip RN2483 module. According to [[http://shop.sodaq.com]], Autonomo is a matchbox-sized powerhouse which uses the new Atmel Cortex M0+ 32bit micro controller. One advantage of such device is that it can be powered by a smartphone-sized solar panel.
Line 67: Line 67:
 LoRaBee.send(1, (uint8_t*)message.c_str(), message.length()) LoRaBee.send(1, (uint8_t*)message.c_str(), message.length())
 </code> </code>
-==== -Arduino with Dragino Shield ====+==== - Arduino with Dragino Shield ==== 
 +=== - Periodic Message Sending ===
  
-Devices in the LoRaWAN platform can also be 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]]. As for the Autonomo device, you can download the following sketch {{ :test-loraserver-comb-loraserver-dragino.zip |}} and modify it according to your preferences. Below you can find somme commented extracts of the sketch.+Devices in the LoRaWAN platform can also be 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]]. Similarly to the Autonomo device, you can download the following sketch {{ :test-loraserver-comb-loraserver-dragino.zip |}} and modify it according to your preferences. Below you can find somme commented extracts of the sketch.
  
 The pin mapping corresponds to the Dragino electronic schematic: The pin mapping corresponds to the Dragino electronic schematic:
Line 96: Line 97:
 </code> </code>
  
-This send function is initially scheduled here:+The send function is initially scheduled here:
 <code c++> <code c++>
 do_send(&sendjob); do_send(&sendjob);
Line 110: Line 111:
 LMIC_setDrTxpow(DR_SF7,14); LMIC_setDrTxpow(DR_SF7,14);
 </code> </code>
-===== -. 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 1. Communication between the two modules is done over an SPI interface.+=== - Triggered Message Sending === 
 + 
 +You can also find another example of sketch to download: {{ :test-loraserver-moisture-on-move.ino.zip |}}. Here the message sending is not periodic but related to an event. For example, an infrared sensor detects a movement and triggers a signal for the device to send a LoRaWAN message. Note also that the join method used in this second sketch is Activation by Personalisation (ABP): the device address, the network session key, and the application session key are directly configured on the device. 
 +===== - 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.
  
 [{{ :2017-01-04_11.34.54.jpg?direct&300 |Figure 2. LoRa single channel gateway}}]  [{{ :2017-01-04_11.34.54.jpg?direct&300 |Figure 2. LoRa single channel gateway}}] 
  
-In order to assemble the gateway, start by making the wire connections: the connection pins are identified in Figures 2 and 3. +In order to assemble the gateway, start by making the wire connections: the connection pins are identified in Figures 3 and 4
-[{{ :schema-single-channel-pi3.png?direct&300 |Figure 2. Dragino pin mapping}}] +[{{ :schema-single-channel-pi3.png?direct&300 |Figure 3. Dragino pin mapping}}] 
-[{{ :schema-pins-pi3.png?direct&300 |Figure 3. Raspberry pi 3 pins}}]+[{{ :schema-pins-pi3.png?direct&300 |Figure 4. Raspberry pi 3 pins}}]
  
 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://github.com/samerlahoud/single_chan_pkt_fwd]]. In order to install it, you need to: 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://github.com/samerlahoud/single_chan_pkt_fwd]]. In order to install it, you need to:
Line 147: Line 152:
 </code> </code>
  
-Now, you need to configure the single channel packet forwarder. This is done in the ''global_conf.json'' configuration file. Particularly, you need to choose the channel, the spreading factor, the pins for SPI communication, and the address of the backend server. Note that you can specify multiple backends for testing purposes. +Now, you need to configure the single channel packet forwarder. This is done in the {{ :global_config.json.zip |}} configuration file. Particularly, you need to choose the channel, the spreading factor, the pins for SPI communication, and the address of the backend server. Note that you can specify multiple backends for testing purposes.
- +
-<file | global_config.json> +
-+
-  "SX127x_conf": +
-  { +
-    "freq": 868100000, +
-    "spread_factor": 7, +
-    "pin_nss": 6, +
-    "pin_dio0": 7, +
-    "pin_rst": 0, +
-    "pin_led1":+
-  }, +
-  "gateway_conf": +
-  { +
-    "ref_latitude": 33.86576536772, +
-    "ref_longitude": 35.56378662935, +
-    "ref_altitude": 165, +
- +
-    "name": "ESIB SC Gateway", +
-    "email": "cimti@usj.edu.lb", +
-    "desc": "Dragino Single Channel Gateway on RPI", +
- +
-    "servers": +
-    [ +
-      { +
-        "address": "router.eu.thethings.network", +
-        "port": 1700, +
-        "enabled": true +
-      }, +
-      { +
-        "address": "212.98.137.194", +
-        "port": 1700, +
-        "enabled": true +
-      }, +
-      { +
-        "address": "172.17.17.129", +
-        "port": 1700, +
-        "enabled": false +
-      } +
-    ] +
-  } +
-+
-</file>+
  
 Finally, you can run the packet forwarder as root! Finally, you can run the packet forwarder as root!
Line 197: Line 159:
 nohup ./single_chan_pkt_fwd & nohup ./single_chan_pkt_fwd &
 </code> </code>
-==== -Kerlink IoT Station ====+==== - Kerlink IoT Station ====
  
 +more /etc/sysconfig/network
 <code> <code>
 # activates eth0 at startup # activates eth0 at startup
Line 239: Line 202:
 [root@Wirgrid_0b03008c demo_gps_loramote]#  [root@Wirgrid_0b03008c demo_gps_loramote]# 
 </code> </code>
 +===== - 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://www.loraserver.io]]. 
 +
 +[{{ :app-loraserver.png?direct&400 | Figure 5. Loraserver web interface}}]
 +
 +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://www.random.org/bytes/]]
 +  * 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 ''ABP activation'' button is unchecked. 
 +
 +
 +==== - The Things Network ====
  
-===== -. Backend ===== +===== - Applications ===== 
-==== -. Loraserver ==== +==== - mqtt-spy ====
-==== -. The Things Network ====+
  
-===== -. 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, so it should work on any operating system with an appropriate version of Java 8 installed. A very useful tutorial is available on [[https://github.com/eclipse/paho.mqtt-spy/wiki]]
-==== -. MQTT spy ==== +You can use mqtt-spy to debug the messages received from the LoRaWAN devicesFor this, you should download the software tool from [[https://github.com/eclipse/paho.mqtt-spy/wiki]]. After starting the application, configure a new connection to the MQTT broker by simply adding the IP address of the broker in the ''Server URI'' field. Now you can subscribe to any MQTT topic. If you want to receive all messages arriving at the backend, you can use the generic topic ''#''. You can also limit to the topic including the messages of any specific device: ''application/APPLICATION_ID/node/DEVICE_EUI/rx'' 
-==== -Emoncms ====+==== - Emoncms ====
deploying_lorawan.1493562493.txt.gz · Last modified: 2017/04/30 16:28 by samer