Sensing Labs SLgateway V2.5 Series Manuel utilisateur

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

 
©2020 Sensing-labs 
1 
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........................................................................................................ 6 
STEP 1: Configuration & Installation of gateway ........................................................................... 7 
SLgateway assembly (picoGW) ................................................................................................ 7 
SLgateway assembly (Gateway-8CH) ......................................................................................... 8 
SLgateway positioning .......................................................................................................... 9 
First access to the GUI (over ethernet on 192.168.2.1) ................................................................... 9 
Set SLgateway local time .....................................................................................................11 
Authentication password configuration .....................................................................................13 
Ethernet interface configuration ............................................................................................13 
GSM/GPRS configuration (picoGW only) .................................................................................... 13 
Easy gateway update from GUI (from V2.3.0)..............................................................................14 
SFTP access (for Update & advanced configuration) (for expert in network management only) ...................14 
Advanced configuration (for expert in network management only) ................................................... 15 
DynDNS ...................................................................................................................... 15 
NTP server....................................................................................................................15 
Hostname/hosts customization .........................................................................................16 
DNS server customization ................................................................................................16 
Custom OpenVPN client ................................................................................................. 17 
Firewall rules.................................................................................................................18 
STEP 2: Device provisioning into gateway .................................................................................. 19 
Add a new device .............................................................................................................. 19 
Add multiple devices at once................................................................................................. 19 
Remove a device ............................................................................................................... 20 
STEP 3: Activation of device..................................................................................................20 
Device network activation process .......................................................................................... 20 
Device application start .......................................................................................................20 
Device data transmission......................................................................................................21 
STEP 4: Device data access via APIs ......................................................................................... 22 
Rest API..........................................................................................................................23 

 
©2020 Sensing-labs 
2 
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 ...................................................................................................................26 
CSV to FTP configuration ...................................................................................................26 
Elasticseach ..................................................................................................................... 27 
Elasticseach configuration (SLgateway side) ............................................................................27 
Sentilo ...........................................................................................................................28 
Sentilo configuration (SLgateway side)...................................................................................28 
Modbus API ......................................................................................................................28 
Modbus mapping configuration ............................................................................................29 
Troubleshooting ................................................................................................................ 30 
I don’t succeed to activate my device onto the gateway ................................................................30 
I have forgotten the current IP network gateway configuration ........................................................31 
I have forgotten the user and/or password to access to the GUI .......................................................31 
How to configure my SLgateway to static IP address (Ethernet)? .......................................................32 
How to come back to the default Ethernet configuration (static 192.168.2.1)? ......................................32 
How to recover all data stored in my SLgateway? .........................................................................33 
Do you have any other questions?............................................................................................33 
How to get technical support?................................................................................................ 33 
Annex - GUI .....................................................................................................................34 
GUI structure (V2.4.x) .........................................................................................................34 
Application –device list ....................................................................................................... 35 
Application –device detail.................................................................................................... 35 
Network –device list...........................................................................................................36 
Network –device detail .......................................................................................................37 
Tools –Remote management ................................................................................................. 39 
Tools –SLTester ................................................................................................................ 39 
Maintenance - Network settings ............................................................................................. 42 
Maintenance - Services ........................................................................................................43 
Maintenance - System .........................................................................................................43 
Legals ............................................................................................................................ 44 
 

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.

The gateway integrates the SLbase software designed to meet the need for a plug and

play LoRaWAN™ local network solution:

•All in one LoRaWan solution with RF modem, Network & Application layers

•Graphical user interface for managing LoRa devices, accessing to application

data (measures, payloads) and RF network information, and secured access to

gateway

•Various types of API to access device data (Rest API, HTTP Callback, Modbus, MQTT)

The Gateways range

All gateways references embed SLGatewayV2.

Part number

Gateway name

Modem

Channels

Protection level

Dimensions / Weight

(without accessories)

PIC-LAB-63NS

Pico GPRS

GPRS

3 CH

IP30

(indoor use)

101x74x35 mm / 135 gr

GAT-LAB-6NN3

Gateway-8CH

8 CH

IP30

(indoor use)

126x80x46 mm / 290 gr

Pico GPRS Gateway-8CH

LoRa devices

(sensors...) SLgateway

Final customer

Application

•WebApp

•PLC

•...

Figure 1 : SLGateway basic diagram

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

✓Up to 200 devices with 1 message transmission every hour

✓Storage of all received data for 100 days

For more information about the LoRaWAN concept and technology, we advise you to

read these documents:

•General overview: LoRaWAN™ What is it?

•Technical description: LoRaWAN™ 101 – A Technical Introduction

(source: lora-alliance.org)

Graphical user interface (GUI)

✓Add/ Import/Remove devices

✓Quick visualization of current device measures

✓Quick visualization of current device network state

✓Export all displayed data in CSV format file

✓Export all stored data in CSV format file (since V2.3.0)

✓Remotely downlink message management (reconfiguration for Senlab)

✓Graphical configuration of system (IP network, log access, …)

✓Backup/restore services configuration

✓RF range test dashboard and results export: SLtester tool

✓Same GUI for all SLgateway references

Data APIs access

✓REST API: SLbase HTTP standard API for accessing all data in application/xml or

application/json formats

✓HTTP Callback(s): Real time customer listener notification of received

data/payload/status in json or xml format

✓Modbus API: Gateway as a TCP Modbus slave for getting data threw a PLC system

✓CSV to FTP: Periodic transfer of CSV format file on an FTP/SFTP server of last received

data (for Senlab only)

✓MQTT: Subscription management to services, real time data notification to

customer server

✓Elasticsearch: RESTful search and analytics engine capable of solving a growing

number of use cases (www.elastic.co)

✓Sentilo: open source sensor and actuator platform designed to fit in the Smart City

architecture (www.sentilo.io)

(refer to section “STEP 4” for more details and “how to use” for each APIs)

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

IoT platform compatibility

Rest API, HTTP Callback(s), CSV to FTP, Modbus TCP

DEXCell(Dexma), Sentilo

MQTT, Elasticsearch

Graphical User Interface

Light GUI for gateway configuration & management

Security

Firewall rules

RTC (picoGW only)

Hold current clock/date without external power supply.

Software maintenance

Easy update from GUI (or SFTP)

Advanced configuration processes (SFTP)

Backup/Restore

Backup and restore all service configuration of the SLgateway

For massive SLgateway configuration

CSV data export

Export all data or from selected days to CSV file

Remote access

VPN: Easy activation for remote access for SL support team

(you can also to connect to your own OpenVPN server)

DynDNS: need dynDNS account and a public IP

Ngrok: need ngrok account, work with private or public IP

Remote management

(since V2.4.x)

Embedded tools and features for GW fleet management:

(with REST API, MQTT, HTTP callback, or ngrok):

- automatic send of gateway and device status

- remote reconfiguration for gateway and devices

ISM 868Mhz band (Power +14dBm / Sensitivity -137dBm)

RF Range tester

Local LoRaWAN network coverage test dashboard

(required a Senlab Test devices)

LoRaWan network server

ABP or OTAA activation mode

PUBLIC (default since V2.0.2) or PRIVATE network type

Downlink acknowledge option

picoGW: 3 channels (868.1,868.3,868.5MHz)mono datarate (SF12)

Gateway-8CH: 8 channels - ADR from DR0 (SF12) to DR5 (SF7)

LoRaWan application server

Application messages Decryption & Encryption

Integrates SLcodec for Senlab messages decoding

Sensing Labs SLgateway V2.5.x –User Guide E02 rev I

Before starting, remember the 4 steps to make the global system fully operational:

STEP 1

STEP 2

STEP 3

STEP 4

This document describes all these 4 steps.

We strongly advise to back up the full gateway configuration after the on-site

deployment step, after first data (Refer to Maintenance - Services section)

STEP 1: Configuration & Installation of gateway

SLgateway assembly (picoGW)

The delivered package includes:

1. A GSM/GPRS antenna (the smaller)

2. An 868MHz LoRa antenna (the longer)

3. An ethernet cable (Cat 5.e - 1m)

4. A 230V power adapter

5. The SLgateway

6. The “Getting started” document

Assembly of the SLgateway (picoGW)

1. Insert SIM card:

✓open the upper side of the gateway casing

✓LOCK the grey cap by pushing it outwards

✓Close the upper side of the gateway casing

2. Screw both antennas

3. Plug the power supply

✓To prevent electronic damage:

the gateway must not be powered without antennas

Configuration &

Installation of

gateway

Device

provisioning

into gateway

Activation of

the device Device data

access via APIs

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

Assembly of the SLgateway (Gateway-8CH)

1. Screw the antenna

2. Plug the power supply on micro USB port (see photo)

✓To prevent electronic damage:

the gateway must not be powered without antenna

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

oIf not possible, use RF cable extension to position outside the LoRa antenna

(see photos on next page)

➢If LoRa devices are in a different building than or outside the building where the

gateway is installed, it is recommended to deport antennas (at least LoRa

antenna) and/or SLgateway on a higher position.

First access to the GUI (over ethernet on 192.168.2.1)

Computer SLgateway

Ce manuel convient aux modèles suivants

Table des matières

Manuels Modem populaires d'autres marques

Davicom

Davicom DM562AP Manuel utilisateur

EpiValley

EpiValley TATA indicom SXC-1080 Manuel utilisateur

Zte

Zte WiMAX Manuel utilisateur

Intelimax

Intelimax MA-2060 Manuel utilisateur

SMC Networks

SMC Networks D3CM1604V Manuel d'utilisation et d'entretien

Telstra

Telstra Wi-Fi 4G Advanced Pro X Manuel utilisateur

Thrane&Thrane

Thrane&Thrane imarsat EXPLORER 300 Manuel utilisateur

Samsung

Samsung AceLink SAM-335A Manuel utilisateur

Enfora

Enfora Enabler-G Guide de configuration rapide

iRZ

iRZ ATM2-232 Manuel utilisateur

Zhone

Zhone 6310 Manuel utilisateur

Paradyne

Paradyne Hotwire 7976 Manuel utilisateur

US Robotics

US Robotics 3453C Manuel utilisateur

MaxTech

MaxTech Plug & Play Internal Voice/FAX/Data/SVD... Manuel utilisateur

Zte

Zte MF823 Manuel utilisateur

Four-Faith

Four-Faith F1403 Manuel utilisateur

Sierra Wireless

Sierra Wireless AIRLINK MP595W Manuel utilisateur

Gemtek

Gemtek WiMAX WIXFBR-103 Manuel utilisateur