Table of Contents
Advertisement
Quick Links
Advertisement
Table of Contents
Summary of Contents for Sensing Labs SLgateway V2.5 Series
- Page 1 SENSING LABS SAS Cap Omega Rond-point Benjamin Franklin CS 39521 34960 - Montpellier Cedex 2 France www.sensing-labs.com www.support.sensing-labs.com SLgateway V2.5.x © User Guide SENSING-LABS VERSION 02 – REV I / OCTOBER 2020 Support & docs ²...
-
Page 2: Table Of Contents
Sensing Labs SLgateway V2.5.x – User Guide E02 rev I Table des matières General overview ....................... 4 The Gateways range ......................4 SLgateway main features ...................... 5 LoRaWan ........................5 Graphical user interface (GUI) ................... 5 Data APIs access ......................5 SLgateway specification ...................... - Page 3 Sensing Labs SLgateway V2.5.x – User Guide E02 rev I HTTP Callback ........................23 HTTP Callback configuration (SLgateway side)................24 Callback format ......................24 MQTT ..........................25 MQTT configuration (SLgateway side) ..................25 MQTT format ........................ 26 CSV to FTP........................26 File format ........................
- Page 4 Sensing Labs SLgateway V2.5.x – User Guide E02 rev I ©2020 Sensing-labs...
-
Page 5: General Overview
Sensing Labs SLgateway V2.5.x – User Guide E02 rev I Thank you for choosing our SLgateway product! General overview SLgateway is an IoT station developed with the aim to reduce the cost of deploying a radio network for small and medium size applications. -
Page 6: Slgateway Main Features
Sensing Labs SLgateway V2.5.x – User Guide E02 rev I SLgateway main features LoRaWan ✓ Support of LoRaWan 868MHz devices, configurable in ABP / OTAA for PUBLIC network with configurable AppEUI ✓ Network level supervision with highlight of disconnected devices ✓... -
Page 7: Slgateway Specification
Sensing Labs SLgateway V2.5.x – User Guide E02 rev I SLgateway specification Specification Description Operating system (OS) Linux Debian Ethernet RJ45 plug GSM/GPRS (picoGW only) GPRS modem (full-size SIM card) Database Storage of last 100 days data Data APIs access... -
Page 8: Step 1: Configuration & Installation Of Gateway
Sensing Labs SLgateway V2.5.x – User Guide E02 rev I Before starting, remember the 4 steps to make the global system fully operational: Configuration & Device Activation of Device data Installation of provisioning the device access via APIs gateway into gateway... -
Page 9: Slgateway Assembly (Gateway-8Ch)
Sensing Labs SLgateway V2.5.x – User Guide E02 rev I SLgateway assembly (Gateway-8CH) The delivered package includes: 1. An 868MHz LoRa antenna 2. An ethernet cable (Cat 5.e - 1m) 3. A 230V power adapter (microUSB) 4. The SLgateway 5. The “Getting started” document... -
Page 10: Slgateway Positioning
Sensing Labs SLgateway V2.5.x – User Guide E02 rev I SLgateway positioning ➢ Position both antenna with 90° elbow and its main part upwardly (vertical) in free space area ➢ Avoid positioning the SLgateway against or inside metallic/electric elements o If not possible, use RF cable extension to position outside the LoRa antenna (see photos on next page) ➢... - Page 11 Sensing Labs SLgateway V2.5.x – User Guide E02 rev I Steps to follow with default configuration 1. Start your SLgateway (power up) 2. Configure your computer IPv4 static address: 192.168.2.2 subnet mask 255.255.255.0 (PC network Ethernet properties) 3. Connect your computer to SLgateway using the Ethernet cable 4.
-
Page 12: Set Slgateway Local Time
Sensing Labs SLgateway V2.5.x – User Guide E02 rev I Set SLgateway local time After 1 boot, you have to synchronize the timestamp of the gateway: 1. Check if your computer local time is OK? 2. Access to the “Maintenance → System” page 3. - Page 13 Sensing Labs SLgateway V2.5.x – User Guide E02 rev I GW with internet access ? (Ethenet or GPRS) Is there a local NTP server ? Nothing more to do: Clock is automaticly updated (with public NTP server) You need to customize You need to implement an periodic process the NTP server address.
-
Page 14: Authentication Password Configuration
Sensing Labs SLgateway V2.5.x – User Guide E02 rev I Authentication password configuration We advise you to replace the default password from “Maintenance → GUI Settings” ➢ In case of password lost, please create an online ticket here ➢ You can also change the friendly System Name into the same page... -
Page 15: Easy Gateway Update From Gui (From V2.3.0)
Sensing Labs SLgateway V2.5.x – User Guide E02 rev I Easy gateway update from GUI (from V2.3.0) The update file must be: - lower than 10 MB (V2.3.x) (a patch is available to expand this limit to 150MB) - lower than 150 MB (V2.4.1) If you need to load a larger file, please use SFTP process. -
Page 16: Advanced Configuration (For Expert In Network Management Only)
Sensing Labs SLgateway V2.5.x – User Guide E02 rev I Advanced configuration (for expert in network management only) In case of SLgateway massive deployment, you can configure all in one (for all SLgateways) in the same process, only for these configurations: •... -
Page 17: Hostname/Hosts Customization
Sensing Labs SLgateway V2.5.x – User Guide E02 rev I Hostname/hosts customization You can change the hostname of your SLgateway, useful in a DHCP configuration. You can also add your specifics server address in hosts file. Requirement: ➢ Active GPRS or local ethernet connection ➢... -
Page 18: Custom Openvpn Client
Sensing Labs SLgateway V2.5.x – User Guide E02 rev I Custom OpenVPN client You can configure SLgateway to connect to your own OpenVPN server. Requirement: ➢ OpenVPN server reachable from public IP address ➢ OpenVPN client configuration file (rename xxxx.ovpn to custom.conf) -
Page 19: Firewall Rules
Sensing Labs SLgateway V2.5.x – User Guide E02 rev I Firewall rules Warning: In case of bad firewall rules, you can lose communication with SLgateway You can customize firewall rules to increase the security level. Requirement: ➢ Active local ethernet connection ➢... -
Page 20: Step 2: Device Provisioning Into Gateway
Sensing Labs SLgateway V2.5.x – User Guide E02 rev I STEP 2: Device provisioning into gateway SLgatewayV2 is configured in PUBLIC network with appEUI 70B3D580A0000000 LoRaWan ➢ It supports both OTAA & ABP activation type. ➢ You have to check that your devices are commissioned in PUBLIC mode (with SLsetting tool for Senlab) ➢... -
Page 21: Remove A Device
Sensing Labs SLgateway V2.5.x – User Guide E02 rev I Remove a device To remove a device, you have to go into Network device detail page, and to confirm the suppression with button When you remove a device in SLgateway, the device still “keeps” the NetworkSessionKey and if OTAA, you will need to “disconnect”... -
Page 22: Device Data Transmission
Sensing Labs SLgateway V2.5.x – User Guide E02 rev I Device has successfully started if not empty Device data transmission Depending of the data transmission period of the device, device messages will be automatically decoded and accessible into the “Application device detail” view ➢... -
Page 23: Step 4: Device Data Access Via Apis
Sensing Labs SLgateway V2.5.x – User Guide E02 rev I STEP 4: Device data access via APIs The following APIs are available for recovering application data from SLgateway: • Rest API • HTTP Callback • MQTT • CST-to-FTP • Elacticsearch •... -
Page 24: Rest Api
Sensing Labs SLgateway V2.5.x – User Guide E02 rev I Rest API SLgateway Rest API is natively available on all SLgateway, and is always available. ➢ You will be able to choose your language & see how to interface with the API. -
Page 25: Http Callback Configuration (Slgateway Side)
Sensing Labs SLgateway V2.5.x – User Guide E02 rev I HTTP Callback configuration (SLgateway side) Access to “APIs → HTTP Callback” page 1. Choose options: o Content-compression: gzipped (by default) or plain o Payload filter: notification with or without Senlab devices 2. -
Page 26: Mqtt
Sensing Labs SLgateway V2.5.x – User Guide E02 rev I MQTT SLgateway MQTT integrated client allows to publish data and/or payload to an external broker and to subscribe to a downlink topic (for device reconfiguration). It supports MQTTS and private certificate can be specified. -
Page 27: Mqtt Format
Sensing Labs SLgateway V2.5.x – User Guide E02 rev I In case of GPRS connection, we strongly advise you to: - edit the “hosts” file by SFTP connection (contact us for more details) and add the line: 188.23.222.432 yourweburl.com (that will limit the request delay and decrease the GPRS data consumption) The same MQTT connection can be used for “fleet management”:... -
Page 28: Elasticseach
Sensing Labs SLgateway V2.5.x – User Guide E02 rev I Enter your server configuration validate with button a. Site ID can be used to identify your gateway ID b. Periodicity off (Sent every (hours)) → Service deactivated 2. Use button to check the connection to your server 3. -
Page 29: Sentilo
Sensing Labs SLgateway V2.5.x – User Guide E02 rev I URL format is: https://user:password@your_ES_server b. Index name: “measures” or any name fitting to your ES configuration c. Update interval (minute): periodicity of the sending process to ES server 2. Save configuration with button... -
Page 30: Modbus Mapping Configuration
Sensing Labs SLgateway V2.5.x – User Guide E02 rev I Modbus mapping configuration access to “Tools → Modbus mapping” page. Device with “Device index = 0" means that the device is not mapped to a Modbus register. By default, all new devices are affected to “Device index = 0". -
Page 31: Troubleshooting
Sensing Labs SLgateway V2.5.x – User Guide E02 rev I Troubleshooting I don’t succeed to activate my device onto the gateway Keep in mind the following process of radio message reception to try to found where the issue comes from? ✓... -
Page 32: I Have Forgotten The Current Ip Network Gateway Configuration
Sensing Labs SLgateway V2.5.x – User Guide E02 rev I I have forgotten the current IP network gateway configuration You can access to a permanent Ethernet interface of the gateway by using a USB cable. Link for driver ✓ You need:... -
Page 33: How To Configure My Slgateway To Static Ip Address (Ethernet)
Sensing Labs SLgateway V2.5.x – User Guide E02 rev I How to configure my SLgateway to static IP address (Ethernet)? 1. Connect to the gateway using Ethernet (current configuration) or USB cable. 2. Access to the config page: “Maintenance →... -
Page 34: How To Recover All Data Stored In My Slgateway
Sensing Labs SLgateway V2.5.x – User Guide E02 rev I How to recover all data stored in my SLgateway? You can download all data stored in SLgateway (until 100 days) in on CSV file. You can choose from date to date, and the type of data: Measures or Payloads. -
Page 35: Annex - Gui
Sensing Labs SLgateway V2.5.x – User Guide E02 rev I Annex - GUI GUI structure (V2.4.x) Application Network APIs Tools Maintenance Device list Device list HTTP callback SLsetting import GUI settings • Application status • Network status • Last measures •... -
Page 36: Application - Device List
Sensing Labs SLgateway V2.5.x – User Guide E02 rev I Application – device list This page gives an overview of application status for all device: Filter on all Take care if the columns connection is GPRS/3G Friendly Application Type Last received measures... -
Page 37: Network - Device List
Sensing Labs SLgateway V2.5.x – User Guide E02 rev I You can follow downlink status into Network detail page. ➢ Data history are visible into a graphical & a table Move the mousse over graph Number of value to get exact value and... -
Page 38: Network - Device Detail
Sensing Labs SLgateway V2.5.x – User Guide E02 rev I Network – device detail ➢ Device status Shortcut to Link to down device page application informations detail ➢ 50 last Payload history Timestamp CSV export of Frame direction Uplink: from device to gw... - Page 39 Sensing Labs SLgateway V2.5.x – User Guide E02 rev I o Send the hexadecimal payload with button o Sending status can be follow into “Downlink queue” ▪ Waiting for uplink frame / Sent to device / Success / Failed o You can remove all “Not sent” frame using button You can choose the type of downlink: •...
-
Page 40: Tools - Remote Management
Sensing Labs SLgateway V2.5.x – User Guide E02 rev I Any bad setting in Network advanced configuration can definitely lost the connection with device. Tools – Remote management How to connect remotely to SLgateway? How to manage a fleet of SLgateway and devices ? You can check SLgateway App. - Page 41 Sensing Labs SLgateway V2.5.x – User Guide E02 rev I 4. Press the device push button 2 seconds (until LED starts blinking) ✓ Wait for 20 seconds during range test processing (LED blinking) 5. Check Quality level on “SLtester” page ✓...
- Page 42 Sensing Labs SLgateway V2.5.x – User Guide E02 rev I ➢ Export kmz file at the end of the TEST session ➢ Display GPS point on a map and associate to Test points RF LEVEL RESULT INTERPRETATION Into “Tools → SLTester” page, choose your Test Senlab ID to filter results for this ID ➢...
-
Page 43: Maintenance - Network Settings
Sensing Labs SLgateway V2.5.x – User Guide E02 rev I Maintenance - Network settings You can customize the LoRaWan appEUI and netID code for your local radio network from “Maintenance → Network Settings” page ➢ Be sure you have your own LoRaWan alliance codes to use them. -
Page 44: Maintenance - Services
Sensing Labs SLgateway V2.5.x – User Guide E02 rev I Maintenance - Services The “Maintenance → Services” page give status of SLbase services ➢ In case of trouble, you can check if they are active and the uptime. ➢ “Backup / Restore” allows you to save full configuration and data to a file, and to load it in another SLgateway. -
Page 45: Legals
SENSING LABS SAS. © 2020 SENSING LABS SAS. All rights reserved. Sensing Labs logo, are registered trademarks of SENSING LABS SAS. All other brands and product names mentioned in this document are the property of their respective holders.
Need help?
Do you have a question about the SLgateway V2.5 Series and is the answer not in the manual?
Questions and answers