Flexitron WebdynEasy LoRaWAN Manual de usuario

WebdynEasy LoRaWAN

User Manual

www.webdyn.com

contact@webdyn.com | webdyn.com

V1.0 subject to changes | Webdyn © by Flexitron Group

Index

Glossary ............................................................................................................................ 4

Historique du document ........................................................................................................................... 6

1. About this Document............................................................................................................................ 7

1.1 Scope ........................................................................................................................................ 7

1.2 Target Audience........................................................................................................................ 7

1.3 Product Versions ...................................................................................................................... 7

1.3.1 Safety Instructions...................................................................................................... 8

1.4 Regulations............................................................................................................................... 8

2. General Presentation ........................................................................................................................... 9

2.1 The LoRaWAN Protocol ............................................................................................................ 9

2.2 The Hub .................................................................................................................................... 10

2.2.1 General description .................................................................................................... 10

2.2.2 Technical Specications............................................................................................. 13

3. Installation and Maintenance.............................................................................................................. 17

3.1 Unpacking................................................................................................................................. 17

3.1.1 Product Contents ....................................................................................................... 17

3.1.2 Hub Identication ....................................................................................................... 18

3.2 Assembly................................................................................................................................... 18

3.2.1 Opening/Closing the Box ........................................................................................... 19

3.2.2 Wall Mounting............................................................................................................. 19

3.2.3 Cellular Network ......................................................................................................... 20

3.2.4 LoRa ............................................................................................................................ 22

3.2.5 Connection.................................................................................................................. 22

4. Conguration......................................................................................................................................... 27

4.1 ...................................................................................................................................................

Embedded web interface ............................................................................................................... 27

4.1.1 Hub Connectivity......................................................................................................... 29

4.1.2 LoRaWAN..................................................................................................................... 34

4.1.3 System......................................................................................................................... 37

4.1.4 VPN .............................................................................................................................. 38

4.1.5 Alarms ......................................................................................................................... 40

contact@webdyn.com | webdyn.com

V1.0 subject to changes | Webdyn © by Flexitron Group

4.1.6 Schedules.................................................................................................................... 41

4.1.7 Modbus ....................................................................................................................... 46

4.1.8 Run Actions ................................................................................................................. 51

5. ...............................................................................................................................................................

Operation................................................................................................................................................... 54

5.1 The remote server.................................................................................................................... 54

5.1.1 The FTP Server............................................................................................................ 54

5.1.2 Web Service ................................................................................................................ 56

5.2 The Conguration..................................................................................................................... 58

5.3 The Data ................................................................................................................................... 59

5.4 Alarms....................................................................................................................................... 60

5.5 Commands ............................................................................................................................... 60

5.5.1 “Reboot” Command.................................................................................................... 62

5.5.2 “Factory” Command ................................................................................................... 63

5.5.3 “Update” Command ................................................................................................... 63

5.5.4 6“Connect” Command ............................................................................................... 63

5.5.5 “Status” Command .................................................................................................... 63

5.5.6 “Log” Command ......................................................................................................... 64

5.5.7 “Settime” Command .................................................................................................. 65

5.5.8 “Modbus” Command.................................................................................................. 65

5.5.9 “Lorawan” Command ................................................................................................. 67

5.5.10 “Send” Subcommand .............................................................................................. 67

5.5.11 “Add” Subcommand................................................................................................. 69

5.5.12 “Delete” Subcommand ............................................................................................ 70

6. Update ................................................................................................................................................... 72

6.1 Local.......................................................................................................................................... 72

6.2 Remote...................................................................................................................................... 72

7. Appendix: XML conguration le variables.......................................................................................... 74

Ofces & Support Contact............................................................................................... 82

contact@webdyn.com | webdyn.com

V1.0 subject to changes | Webdyn © by Flexitron Group

Glossary

NAME DESCRIPTION

ABP Activation By Personalization: ABP activation forces to have the DevAddr and the

security key for the peripheral hard-coded in the product. This strategy may seem

simpler because the join procedure does not need to be known, but it has security

disadvantages.

ADR Adaptive Data Rate: a data rate and radio transmission power optimisation

mechanism. It is used to optimise battery consumption.

APN Access Point Name: the name of the access point the gateway uses to connect to

the Internet via a mobile connection.

AppEUI The EUI Application is a unique application identier issued by the IEEE

organisation (EUI-64). It is only used in OTAA mode and is used to get the server

keys during the JOIN.

AppKEY The Application Key is product specic. It is only used in OTAA mode and is used to

get the server keys during the JOIN.

AppSKey The Application Session Key is product specic and is used for end to end

application data encryption. It is required in ABP mode and is calculated

automatically by the server during the JOIN in OTAA mode.

Data Rate The Data Rate is dened by a digit from 0 to 5 and sets the modulation type, the

Spreading Factor and the bandwidth used.

DevEUI Device EUI: the unique identier issued by the IEEE organisation (EUI-64).

Device

Address

32 bit device identier that is used to uniquely identify the product on the

LoRaWAN server. It is required in ABP mode and is supplied automatically by the

server during the JOIN in OTAA mode.

Ftp File Transfer Protocol: communication protocol used to exchange les over a TCP/

IP network.

HTTP HyperText Transfer Protocol: client-server communication protocol developed for

the Web.

IP Internet Protocol: message protocol in charge of addressing and sending TCP

packets over the network.

JSON JavaScript Object Notation: JSON is an easily interpretable data interchange

format.

contact@webdyn.com | webdyn.com

V1.0 subject to changes | Webdyn © by Flexitron Group

LoRa LoRa is radio modulation including the physical connection and the physical layer

in the OSI model.

LoRaWAN LoRaWAN is a transmission protocol that uses LoRa modulation.

MD5 Message Digest 5: cryptographic hash function used to obtain a le's digital

imprint.

Modbus Modbus is a communication protocol routinely used by industry to dialogue with

industrial equipment over a network.

NTP Network Time Protocol: protocol used to synchronise the local hub clock with a

time reference via a computer network.

NwkSKey The Network Session Key is product specic and is used for end to end

LoRaWAN network data encryption. It is required in ABP mode and is calculated

automatically by the server during the JOIN in OTAA mode.

OTAA Over The Air Activation: OTAA activation is the preferred and most secure method

for connecting to the LoRaWAN network. The product runs a join procedure with

the network during which a dynamic DevAddr is assigned and security keys are

brokered with the product.

PEM File format standard for storing certicates and private keys in Base64-encoded

text format.

DIN rail Standard 35 mm metal rail used in Europe in industrial control equipment in

racks.

RTU RTU mode is an RS422/485 hard-wired bus for Modbus.

Spreading

Factor (SF)

The spreading factor is the length of the sent frames. The more the signal is

spread, the lower the speed. However it increases the product range.

TCP Transmission Control Protocol: an Internet-based connection-oriented protocol

that provides data packet segmenting services that the IP protocol sends over the

network. This protocol provides a reliable data transfer service. See also IP.

TCP/IP Transmission Control Protocol/Internet Protocol: a set of network protocols

that provide interconnection services between computers of different

hardware architectures and operating systems. TCP/IP includes standards for

communication between computers and conventions for network interconnection

and routing.

contact@webdyn.com | webdyn.com

V1.0 subject to changes | Webdyn © by Flexitron Group

UDP User Datagram Protocol: non connection-oriented protocol of the TCP/IP model

transport layer. This protocol is very simple because is does not provide error

checks (it is not connection-oriented...).

VPN Virtual Private Network: ecure and encrypted connection between the concentrator

and a private network, thus allowing isolation from public telecommunications

networks.

XML Extensible Markup Language: generic tagging computer metalanguage. The

purpose of XML is to facilitate the automated exchange of complex content

between heterogeneous information systems.

XSD XML Schema Denition: le used to validate XML tags and data in an XML le.

Historique du document

VERSION DESCRIPTION

V0.11 Creation

V1.0 Added VPN

contact@webdyn.com | webdyn.com

V1.0 subject to changes | Webdyn © by Flexitron Group

1. About this Document

This guide describes the hub assembly, installation and conguration as well as its remote operation.

1.1 Scope

This technical description is valid for WebdynEasy LoRaWAN hubs from hardware version V1 and software

version V1.0 onwards.

1.2 Target Audience

This guide is intended for WebdynEasy LoRaWAN hub installers and users, but also for people using our

Sens’RF LoRaWAN sensors.

1.3 Product Versions

LoRaWAN hub:

REFERENCES VERSIONS

WG0610-A01 WebdynEasy LoRaWAN

LoRaWAN Webdyn compatible sensor:

REFERENCES DESCRIPTION

WG0307-D01-EU Sens'RF-LoRaWAN-Pulse (no external power supply)

WG0307-D02-EU Sens'RF-LoRaWAN-Pressure Humidity & Temp. (no external power supply)

WG0307-D03-EU Sens'RF-LoRaWAN-TIC (no external power supply)

WG0307-D08-EU Sens'RF-LoRaWAN-Analog (0-10V/4-20mA) (no external power supply)

WG0307-D11-EU Sens'RF-LoRaWAN-Pulse (with external power supply)

WG0307-D12-EU Sens'RF-LoRaWAN-Pressure Humidity & Temp. (with external power supply)

WG0307-D13-EU Sens'RF-LoRaWAN-TIC (with external power supply)

WG0307-D18-EU Sens'RF-LoRaWAN-Analog (0-10V/4-20mA) (with external power supply)

contact@webdyn.com | webdyn.com

V1.0 subject to changes | Webdyn © by Flexitron Group

1.3.1 Safety Instructions

It is imperative to follow all the safety instructions in this guide.

Failure to follow these instructions can damage equipment and endanger people.

Electric connections

• All wiring must be carried out only by a specialized qualied electrician.

• Please follow all the safety instructions featured in the equipment documentation.

The WebdynEasy product can be damaged by electrostatic discharges (ESD). When the equipment

is open, do not carry out any operations other than those described in this manual. Avoid any contact with

the components.

Class 3 equipment: the device operates on safety extra-low voltage (SELV) (50V maximum). The

voltage reduction must be obtained using a safety transformer providing safe galvanic isolation between

primary and secondary.

Do not install the equipment near a heat source or at a height greater than 2m.

To clean the product, only use a slightly damp cloth to gently clean and wipe the surfaces. Never

use aggressive chemical agents or solvents that could alter the plastic material or corrode the metal

parts.

To optimise radio and cellular modem reception sensitivity, it is imperative to leave 20 cm free

space around the antennas.

1.4 Regulations

The product complies with the European directives according to the EU Declaration of Conformity available

from Webdyn or on website: www.webdyn.com.

Recycling:

The European directives enacted into national law covering battery waste and electric and electronic

equipment provide the framework for the actions needed to limit the negative impact of the product’s

end of life. These products are collected separately. Use an authorised battery collection and processing

centre or contact Webdyn.

contact@webdyn.com | webdyn.com

V1.0 subject to changes | Webdyn © by Flexitron Group

2. General Presentation

The WebdynEasy LoRaWAN hub is part of a line of Webdyn hubs specic to wireless networks. The hub’s

main function is to be a LoRaWAN gateway to create a LoRaWAN network and collect the data from the

different LoRa sensors deployed nearby. The LoRaWAN gateway has 2 running modes:

• Packet Forwarder

• Packet Forwarder with embedded LoRaWAN server

The hub is also used to communicate with Modbus devices in IP or RTU mode.

Principle diagram for a complete LoRaWAN solution

2.1 The LoRaWAN Protocol

LoRaWAN is a communication protocol that uses LoRa modulation. This communication protocol uses

several radio bands (ISM) that are available in the 868 MHz range in Europe without a licence.

In a LoRaWAN network, the radio modules are not paired to a single base station. The data they send

is relayed by multiple base stations. Each one sends the information received from a radio module to

the management server via a gateway. The intelligence and complexity are located on the server which

manages data redundancy, integrity checks, receipt conrmation and the adaptation of the sensor data

rate and emission power.

contact@webdyn.com | webdyn.com

2.2 The Hub

The purpose of the hub is to collect LoRaWAN and/or Modbus data and regularly send it to a remote

server (IS) using Ethernet or 3G/4G.

2.2.1 General description

Exterior

Box front face:

Tabla de contenidos

Otros manuales de Módem de Flexitron

Flexitron

Flexitron webdyn MTX-StarSensor Manual de instalación

Flexitron

Flexitron Webdyn MTX-StarEnergy Driver ETH-USB Manual de usuario

Flexitron

Flexitron Mtx MTX-STARENERGY-M Manual de usuario

Flexitron

Flexitron MTX-4G-JAVA-IoT Manual de usuario

Flexitron

Flexitron webdyn MTX-StarSensor Manual de usuario

Flexitron

Flexitron MTX-G-JAVA-T Series Manual de instalación

Manuales populares de Módem de otras marcas

Davicom

Davicom DM562AP Manual de usuario

EpiValley

EpiValley TATA indicom SXC-1080 Manual de usuario

Zte

Zte WiMAX Manual de usuario

Intelimax

Intelimax MA-2060 Manual de usuario

SMC Networks

SMC Networks D3CM1604V Manual de uso y cuidado

Telstra

Telstra Wi-Fi 4G Advanced Pro X Manual de usuario

Thrane&Thrane

Thrane&Thrane imarsat EXPLORER 300 Manual de usuario

Samsung

Samsung AceLink SAM-335A Manual de usuario

Enfora

Enfora Enabler-G Guía de configuración rápida

iRZ

iRZ ATM2-232 Manual de usuario

Zhone

Zhone 6310 Manual de usuario

Paradyne

Paradyne Hotwire 7976 Manual de usuario

US Robotics

US Robotics 3453C Manual de usuario

MaxTech

MaxTech Plug & Play Internal Voice/FAX/Data/SVD... Manual de usuario

Zte

Zte MF823 Manual de usuario

Four-Faith

Four-Faith F1403 Manual de usuario

Sierra Wireless

Sierra Wireless AIRLINK MP595W Manual de usuario

Gemtek

Gemtek WiMAX WIXFBR-103 Manual de usuario