Laird Sentrius RG1 Series User manual

A
Version 1.2

https://www.lairdconnect.com/iot-devices/iot-sensors
2
© Copyright 2019 Laird. All Rights Reserved
Americas: [phone]
Europe: [phone]
Hong Kong: [phone]
Version
Date
Notes
Contributor
Approver
1.0
4 Apr 2018
Initial Release
Seokwoo Yoon
Jonathan Kaye
1.1
19 Dec 2018
Updated template, logos, and URLs
Sue White
Jonathan Kaye
1.2
3 Jan 2020
Updated pictures and contents
according to the new firmware v5.4
Seokwoon Yoon
Chris Boorman
1.3
14 Jan 2020
Updated Figure 1 to include wireless
protocols
Dave Drogowski
Sue White

https://www.lairdconnect.com/iot-devices/iot-sensors
3
© Copyright 2019 Laird. All Rights Reserved
Americas: [phone]
Europe: [phone]
Hong Kong: [phone]
1Overview .............................................................................................................................................................................4
2Data Flow Architecture........................................................................................................................................................4
3Gateway Factory Reset.......................................................................................................................................................4
4Connect the Gateway..........................................................................................................................................................5
5Log into the Gateway...........................................................................................................................................................6
5.1 Logging into Gateway Web Interface..........................................................................................................................6
5.2 Updating Gateway Firmware ......................................................................................................................................6
5.3 LoRa Packet Forwarding Set Up ................................................................................................................................7
6Senet Configuration.............................................................................................................................................................7
6.1 Senet Account Setup..................................................................................................................................................7
6.2 Registering Your Gateway..........................................................................................................................................9
6.3 Adding Devices an Application .................................................................................................................................10
7RS1xx Configuration..........................................................................................................................................................11
8Setting up MQTT Broker on Amazon AWS .......................................................................................................................13
8.1 Setting up AWS server .............................................................................................................................................13
8.2 Installing MQTT Broker on AWS instance.................................................................................................................15
9MQTT Integration on Senet...............................................................................................................................................16
10 node-RED Setup...........................................................................................................................................................18
10.1 Install node.js Package Manager and node.js ..........................................................................................................18
10.2 Install JSON Files.....................................................................................................................................................18
10.3 Installing node-RED..................................................................................................................................................19
10.4 Installing node-RED-Dashboard...............................................................................................................................20
10.5 Updating RS1xx-Demo-Config File...........................................................................................................................20
10.6 Running node-RED with Default Settings.................................................................................................................21
10.7 Establishing MQTT Broker Connections...................................................................................................................22
10.8 Loading node-RED User Interface............................................................................................................................24
11 Appendix.......................................................................................................................................................................26
11.1 Troubleshooting Tips for Sentrius Gateway Connections.........................................................................................26
11.2 Troubleshooting Tips for Senet Connections............................................................................................................26
11.3 Troubleshooting Tips for node_RED (MQTT Broker Links) Connections .................................................................26

https://www.lairdconnect.com/iot-devices/iot-sensors
4
© Copyright 2019 Laird. All Rights Reserved
Americas: [phone]
Europe: [phone]
Hong Kong: [phone]
This guide provides instructions on configuring a Sentrius RG1xx gateway and Sentrius RS1xx sensor using the Senet server
and node-RED web-based user interface.
Note: Step-by-step instructions, screenshots, and pictures are based on the Sentrius RG191 and Sentrius RS191, but
the same is applicable for the Sentrius RG186 and Sentrius RS186. Differences are noted.
For more detailed information on how to use all Sentrius gateway and sensor features, please see the Sentrius RG1xx User
Guide, available from documentation tab at: https://connectivity.lairdtech.com/wireless-modules/lorawan-solutions/sentrius-rg1xx-
lora-enabled-gateway-wi-fi-bluetooth-ethernet and the Sentrius RS1xx User Guide: https://connectivity.lairdtech.com/wireless-
modules/lorawan-solutions/sentrius-rs1xx-lora-enabled-sensors.
The following block diagram (Figure 1) displays the overall architecture described in this demo. This is a high-level
representation of how the sensor’s LoRaWAN data is transferred through the gateway (which plays a role of packet forwarder)
to Senet server where the data packets are processed. They are then forwarded to the MQTT Broker. The node-RED
application contains an MQTT client that receives sensor data and displays it on a browser-based user interface.
Figure 1: Data flow architecture
This guide shows a step-by-step approach to setting up a test LoRaWAN network. It starts on the left side of the block diagram
with the Gateway configuration and progresses toward the UI application on the right. Sensor devices are added when
configuring the Senet backend.
If setting up a previously configured gateway, we recommend that you clear any prior settings by resetting the gateway to its
factory default values. To do this, complete the steps described in the Factory Reset section of the RG1xx User Guide. You
can access this guide on the RG1xx product page from the Documentation tab.
LoRa
Wi-Fi /
Ethernet
Cloud
Cloud

https://www.lairdconnect.com/iot-devices/iot-sensors
5
© Copyright 2019 Laird. All Rights Reserved
Americas: [phone]
Europe: [phone]
Hong Kong: [phone]
To use the gateway, you must power it up and access the web interface via the Ethernet port. To do this, follow these steps:
Follow the label on the box and connect the three antennas. Refer to Antenna Configuration for additional information.
Connect the power supply (see #2 in Figure 2).
Connect the gateway to your router (#3 Figure 2) using the Ethernet cable (#1 in Figure 2).
Your gateway is now connected and ready.
Figure 2: Connecting the gateway
To configure the antenna properly, do the following:
Attach the two shorter antennas to the 2.4/5.5 GHz (Wi-Fi) ports.
Attach the third and longer antenna to the 868 MHz/900 MHz (LoRa) port.
Figure 3: Antenna configuration
3
2
1

https://www.lairdconnect.com/iot-devices/iot-sensors
6
© Copyright 2019 Laird. All Rights Reserved
Americas: [phone]
Europe: [phone]
Hong Kong: [phone]
To log into the gateway web interface, follow the steps from the RG1xx User Guide’s Log into the Gateway section. This guide
is accessible from the website’s RG1xx product page on the Documentation tab.
Figure 4: Gateway interface login screen
Note: For this guide, we assume the LAN or Wi-Fi connection is successfully set up and the user login credentials are
updated. We recommend that you update the credentials as soon as possible to minimize a potential security risk.
Update these credentials on the Settings page.
Update the firmware by clicking Settings > Update Firmware. (Figure 5)
Figure 5: Updating gateway firmware
Depending on the current version of firmware loaded, different URL should be used. If v93.7.2.10 is loaded, use
https://connectivity-firmware.s3.amazonaws.com/rg1xx-lora-gateway/firmware/newest/fw.txt. For firmware v93.7.3.x and later,
the URL should be auto populated. Note: It is recommended to have GA4 (v93.7.3.x) firmware or greater.
Once the gateway is finished updating the firmware, follow the on-screen instructions to reboot the device. This requires a
login using your updated profile credentials.

https://www.lairdconnect.com/iot-devices/iot-sensors
7
© Copyright 2019 Laird. All Rights Reserved
Americas: [phone]
Europe: [phone]
Hong Kong: [phone]
Simply select Senet on LoRa > Preset. The gateway connection status should stay false in UI when the Preset is applied.
(Figure 6)
Figure 6: Setting presets
Note: Before performing any actions, ensure that port 1700 is open (LoRaWAN traffic port) as well as ports 1883 and
8883 (Senet MQTT traffic port) in your network. UDP traffic is sent over port 1700. TCP and TCP/TLS socket
connections are made on ports 1883 and 8883. We recommend that you work with your IT group to provide access
for this install.
To set up an account with Senet, follow these steps:
Go to https://portal.senetco.io/#/home and click Create New Account in the lower right of the window to start the process
as shown in Figure 7. If you already have an account, click Login and skip to step four.

https://www.lairdconnect.com/iot-devices/iot-sensors
8
© Copyright 2019 Laird. All Rights Reserved
Americas: [phone]
Europe: [phone]
Hong Kong: [phone]
Figure 7: Senet account setup
Note: It is important that you have access to the email address entered in the account setup since Senet requires you
to validate your email before proceeding with the rest of the setup.
1. Log in to Senet after the email is verified. (Figure 8)
Figure 8: Senet login page
2. The dashboard appears as the home page once logged in.

https://www.lairdconnect.com/iot-devices/iot-sensors
9
© Copyright 2019 Laird. All Rights Reserved
Americas: [phone]
Europe: [phone]
Hong Kong: [phone]
To register your gateway with the Senet network, follow these steps:
Click + button on Devices & Gateways in Dashboard
Select Register Gateway (Figure 9)
Figure 9: Senet gateway configuration page
Follow the prompts. When Select Device Type appears, choose Laird Sentrius (Figure 10).
Figure 10: Semtech Packet Forwarder
3. On the next page, register your gateway as shown in Figure 11. For serial number, enter 0x followed by Ethernet MAC
ID from at the bottom of the RG1xx case (Figure 12). For Gateway Vendor and Type, enter Laird. For Description,
enter your own description.
Figure 11: Gateway Information

https://www.lairdconnect.com/iot-devices/iot-sensors
10
© Copyright 2019 Laird. All Rights Reserved
Americas: [phone]
Europe: [phone]
Hong Kong: [phone]
Figure 12: On a bottom label, M2 EUI corresponds to Serial number.
4. Continue to follow the prompts and click Register to complete setup. Senet sends an approval email for gateway
registration.
click + button on Devices & Gateways in Dashboard.
Select Register Device. (Figure 13)
Figure 13: Device registration
5. Enter Device EUI from the RS191 label. Choose Laird for Device Type. Check the box for Supports Senet Packets.
Then, click Register New Device.
Note: The Sensor Dev EUI can be found on the bottom of the sensor. This field is lower-case sensitive.