ADF Web HD67F36-B2 Series User manual

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
LoRaWAN Gateway / MQTT
Document code: MN67F36_ENG Revision 1. Page 1 of 35
User Manual
Revision 1.
English
LoRaWAN Gateway / MQTT - Converter
(Order Code: HD67F36-B2-xxxMHz)
For Website information:
www.adfweb.com?Product=HD67F36-B2
For Price information:
www.adfweb.com?Price=HD67F36-B2-xxxMHz
Benefits and Main Features:
Very easy to configure
Power Supply 12…35V DC and 8…24 V AC
Temperature range: -4 °C/+85°C (-4 °F/+185°F)
For others LoRaWAN products, see also the following links:
Converter LoRaWAN to
www.adfweb.com?Product=HD67F 1 (Mod us Master)
www.adfweb.com?Product=HD67F 2 (Mod us Slave)
www.adfweb.com?Product=HD67F 3 (Mod us TCP Master)
www.adfweb.com?Product=HD67F 4 (Mod us TCP Slave)
www.adfweb.com?Product=HD67F 5 (Serial)
www.adfweb.com?Product=HD67F15 (M-Bus)
www.adfweb.com?Product=HD67F16 (BACnet Master)
www.adfweb.com?Product=HD67F17 (BACnet Slave)
www.adfweb.com?Product=HD67F18 (Ethernet)
www.adfweb.com?Product=HD67F19 (CAN)
www.adfweb.com?Product=HD67F2 (CANopen)
www.adfweb.com?Product=HD67F21 (DeviceNet Master)
www.adfweb.com?Product=HD67F22 (DeviceNet Slave)
www.adfweb.com?Product=HD67F23 (DMX)
www.adfweb.com?Product=HD67F24 (EtherNet/IP Master)
www.adfweb.com?Product=HD67F25 (EtherNet/IP Slave)
www.adfweb.com?Product=HD67F26 (J1939)
www.adfweb.com?Product=HD67F27 (KNX)
www.adfweb.com?Product=HD67F28 (NMEA 0183)
www.adfweb.com?Product=HD67F29 (NMEA 2000)
www.adfweb.com?Product=HD67F3 (PROFIBUS Master)
www.adfweb.com?Product=HD67F31 (PROFIBUS Slave)
www.adfweb.com?Product=HD67F32 (PROFINET Master)
www.adfweb.com?Product=HD67F33 (PROFINET Slave)
www.adfweb.com?Product=HD67F34 (IEC61850 Client)
www.adfweb.com?Product=HD67F35 (IEC61850 Server)
www.adfweb.com?Product=HD67F37 (OPC UA Client)
www.adfweb.com?Product=HD67F38 (OPC UA Server)
www.adfweb.com?Product=HD67F39 (S7comm)
www.adfweb.com?Product=HD67F4 (SNMP Manager)
www.adfweb.com?Product=HD67F41 (SNMP Agent)
User Manual

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
LoRaWAN Gateway / MQTT
Document code: MN67F36_ENG Revision 1. Page 2 of 35
INDEX:
Page
INDEX 2
UPDATED DOCUMENTATION 2
REVISION LIST 2
WARNING 2
TRADEMARKS 2
SECURITY ALERT 3
EXAMPLE OF CONNECTION 4
CONNECTION SCHEME 5
CHARACTERISTICS 6
CONFIGURATION 6
POWER SUPPLY 7
FUNCTION MODES 8
LEDS 9
LORAWAN 1
ETHERNET 11
USE OF COMPOSITOR SW67F36 12
NEW CONFIGURATION / OPEN CONFIGURATION 13
SOFTWARE OPTIONS 14
SET COMMUNICATION 16
LORAWAN ACCESS 23
MQTT SET TOPIC 27
UPDATE DEVICE 29
TEMPLATE STRING: DEFINITION OF MQTT
PAYLOAD
31
MECHANICAL DIMENSIONS 32
ORDERING INFORMATIONS 33
ACCESSORIES 33
DISCLAIMER 34
OTHER REGULATIONS AND STANDARDS 34
WARRANTIES AND TECHNICAL SUPPORT 35
RETURN POLICY 35
UPDATED DOCUMENTATION:
Dear customer, we thank you for your attention and we remind you that
you need to check that the following document is:
Updated
Related to the product you own
To obtain the most recently updated document, note the “document code”
that appears at the top right-hand corner of each page of this document.
With this “Document Code” go to web page www.adfweb.com/download/
and search for the corresponding code on the page. Click on the proper
“Document Code” and download the updates.
REVISION LIST:
WARNING:
ADFweb.com reserves the right to change information in this manual about
our product without warning.
ADFweb.com is not responsible for any error this manual may contain.
TRADEMARKS:
All trademarks mentioned in this document belong to their respective
owners.
Revision Date Author Chapter Description
1. 3/12/2 21 Ff All First release version

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
LoRaWAN Gateway / MQTT
Document code: MN67F36_ENG Revision 1. Page 3 of 35
SECURITY ALERT:
G ENERAL I NFORMATION
To ensure safe operation, the device must be operated according to the instructions in the manual. When using the device, legal and
safety regulation are required for each individual application. The same applies also when using accessories.
I NTENDED U SE
Machines and systems must be designed so the faulty conditions do not lead to a dangerous situation for the operator (i.e.
independent limit switches, mechanical interlocks, etc.).
Q UALIFIED P ERSONNEL
The device can be used only by qualified personnel, strictly in accordance with the specifications.
Qualified personnel are persons who are familiar with the installation, assembly, commissioning and operation of this equipment and
who have appropriate qualifications for their job.
R ESIDUAL R ISKS
The device is state-of-the-art and is safe. The instruments can represent a potential hazard if they are inappropriately installed and
operated by untrained personnel. These instructions refer to residual risks with the following symbol:
This symbol indicates that non-observance of the safety instructions is a danger for people that could lead to serious injury or
death and / or the possibility of damage.
CE CONFORMITY
The declaration is made by our company. You can send an email to [email protected]om or give us a call if you need it.

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
LoRaWAN Gateway / MQTT
Document code: MN67F36_ENG Revision 1. Page 4 of 35
EXAMPLE OF CONNECTION:

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
LoRaWAN Gateway / MQTT
Document code: MN67F36_ENG Revision 1. Page 5 of 35
CONNECTION SCHEME:
Figure 1: Connection scheme for HD67F36-B -xxxMHz

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
LoRaWAN Gateway / MQTT
Document code: MN67F36_ENG Revision 1. Page 6 of 35
CHARACTERISTICS:
The HD67F36-B2 is a LoRaWAN Gateway / MQTT.
It allows the following characteristics:
Electrical isolation between MQTT and Power Supply;
Mountable on 35mm Rail DIN;
Wide power supply input range: 12…35V DC and 8…24V AC;
Wide temperature range: -4 °C / 85°C [-4 °F / +185°F].
CONFIGURATION:
You need Compositor SW67F36 software on your PC in order to perform the following:
Define the parameter of MQTT line;
Define the parameter of LoRaWAN line;
Define the list of LoRaWAN end-devices to connect;
Define the LoRaWAN messages to send/receive from each LoRaWAN end-device;
Define the MQTT topics in publish and subscribe;
Update the device.

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
LoRaWAN Gateway / MQTT
Document code: MN67F36_ENG Revision 1. Page 7 of 35
POWER SUPPLY:
The devices can be powered at 8…24V AC and 12…35V DC. For more details see the two tables below.
VAC
VDC
Vmin Vmax Vmin Vmax
8V 24V 12V 35V
Consumption at 24V DC:
Device Consumption [W/VA]
HD67F36-B2-xxxMHz 3.5
HD67F36
-
B2
-
xxxMHz
Caution: Not reverse the polarity
power

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
LoRaWAN Gateway / MQTT
Document code: MN67F36_ENG Revision 1. Page 8 of 35
FUNCTION MODES:
The device has got two functions mode depending of the position of the ‘Dip1 of Dip-Switch A’:
The first, with ‘Dip1 of Dip-Switch A’ at “OFF” position, is used for the normal working of the device.
The second, with ‘Dip1 of Dip-Switch A’ at “ON” position, is used for upload the Project and/or Firmware.
For the operations to follow for the updating, see ‘UPDATE DEVICE’ section.
According to the functioning mode, the LEDs will have specifics functions, see ‘LEDS’ section.

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
LoRaWAN Gateway / MQTT
Document code: MN67F36_ENG Revision 1. Page 9 of 35
LEDS:
The device has got five LEDs that are used to give information of the functioning status.
The various meanings of the LEDs are described in the table below.
LED Normal Mode Boot Mode
1: Device State (green) Blinks slowly (~1Hz) Blinks quickly: Boot state
Blinks very slowly (~0.5Hz): update in progress
2: LoRaWAN communication
(yellow) Blinks when a LoRaWAN message is received Blinks quickly: Boot state
Blinks very slowly (~0.5Hz): update in progress
3: MQTT communication
(yellow) Blinks when a MQTT message is received Blinks quickly: Boot state
Blinks very slowly (~0.5Hz): update in progress
4: Error state (yellow) ON: An error in the communication busses occurs
OFF: No errors are present
Blinks quickly: Boot state
Blinks very slowly (~0.5Hz): update in progress
5: Link Ethernet (Green) ON: Ethernet cable inserted
OFF: Ethernet cable not inserted
ON: Ethernet cable inserted
OFF: Ethernet cable not inserted

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
LoRaWAN Gateway / MQTT
Document code: MN67F36_ENG Revision 1. Page 1 of 35
LORAWAN:
The LoRaWAN® specification is a Low Power, Wide Area (LPWA) networking protocol designed to wirelessly
connect battery operated ‘things’ to the internet in regional, national or global networks, and targets key
Internet of Things (IoT) requirements such as bi-directional communication, end-to-end security, mobility
and localization services.
LoRaWAN® network architecture is deployed in a star-of-stars topology in which gateways relay messages
between end-devices and a central network server.
The wireless communication takes advantage of the Long Range characteristics of the LoRa physical layer,
allowing a single-hop link between the end-device and one or many gateways. All modes are capable of bi-
directional communication, and there is support for multicast addressing groups to make efficient use of
spectrum during tasks such as Firmware Over-The-Air (FOTA) upgrades or other mass distribution
messages.
The converters support all the standard datarates and they work both on public and private networks.

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
LoRaWAN Gateway / MQTT
Document code: MN67F36_ENG Revision 1. Page 11 of 35
ETHERNET:
The Ethernet port is used for MQTT communication and for programming the device.
The Ethernet connection must be made using Connector3 of HD67F36-B2 with at least a Category 5E cable. The maximum length of the
cable should not exceed 1 m. The cable has to conform to the T568 norms relative to connections in cat.5 up to 1 Mbps. To connect the
device to an Hub/Switch is recommended the use of a straight cable, to connect the device to a PC is recommended the use of a cross cable.

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
LoRaWAN Gateway / MQTT
Document code: MN67F36_ENG Revision 1. Page 12 of 35
USE OF COMPOSITOR SW67F36:
To configure the Converter, use the available software that runs with Windows called SW67F36. It is downloadable on the site
www.adfweb.com and its operation is described in this document. The software works with MS Windows (XP, Vista, Seven, 8, 1 , 11;
32/64bit).
When launching the SW67F36, the window below appears (Fig. 2).
Note:
It is necessary to have installed .Net Framework 4.
Figure : Main window for SW67F36

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
LoRaWAN Gateway / MQTT
Document code: MN67F36_ENG Revision 1. Page 13 of 35
NEW CONFIGURATION / OPEN CONFIGURATION:
The “New Configuration” button creates the folder which contains the entire device’s configuration.
A device’s configuration can also be imported or exported:
To clone the configurations of a Programmable “LoRaWAN Gateway / MQTT -
Converter” in order to configure another device in the same manner, it is necessary to
maintain the folder and all its contents;
To clone a project in order to obtain a different version of the project, it is sufficient to
duplicate the project folder with another name and open the new folder with the
button “Open Configuration”.

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
LoRaWAN Gateway / MQTT
Document code: MN67F36_ENG Revision 1. Page 14 of 35
SOFTWARE OPTIONS:
By pressing the “Settings” ( ) button there is the possibility to change the language of the software and check the updatings for the
compositor.
In the section “Language” it is possible to change the language of the
software.
In the section “Connection Options”, it is possible to check if there are some
updatings of the software compositor in ADFweb.com website.
Checking the option “Check Software Update at Start of Program”, the
SW67F36 check automatically if there are updatings when it is launched.

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
LoRaWAN Gateway / MQTT
Document code: MN67F36_ENG Revision 1. Page 15 of 35
In the section “Software Settings”, it is possible to enable/disable some
keyboard’s commands for an easier navigation inside the tables contained in
the different sections of the software.

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
LoRaWAN Gateway / MQTT
Document code: MN67F36_ENG Revision 1. Page 16 of 35
SET COMMUNICATION:
By Pressing the “Set Communication” button from the main window for SW67F36 (Fig. 2)
the window “Set Communication” appears (Fig. 3).
The window is divided in different sections in order to define the different parameters of the
converter:
Select Device
Ethernet Connection
LoRaWAN
MQTT
Ethernet
TLS (Transport Layer Security)
NTP (Network Time Protocol)
Wi-Fi
GSM / GPRS / LTE
Figure 3a: “Set Communication” window

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
LoRaWAN Gateway / MQTT
Document code: MN67F36_ENG Revision 1. Page 17 of 35
Figure 3b: “Set Communication

IO
-
Link” window
Figure 3c: “Set Communication  Ethernet
connection” window
S ELECT D EVICE :
This section is used to define the type of Ethernet connection used. It is possible to
select:
Only Ethernet Cable
Ethernet cable + Wi-Fi
E THERNET C ONNECTION :
The means of the fields for “Ethernet Connection” are:
In the field “Device Name (Hostname)” the Hostname to assign to the
converter is defined;
If the field “O tain an IP Address Automatically (DHCP for Ca le
Connection)” is checked, DHCP for LAN connection is enabled;
If the field “O tain an IP Address Automatically (DHCP for Wi-Fi
Connection)” is checked, DHCP for Wi-Fi connection is enabled;
If the field “Ena le DNS” is checked, DNS protocol is enabled;
In the field “Primary DNS” the IP Address of the primary DNS server is
defined;
In the field “Secondary DNS” the IP Address of the secondary DNS server
is defined.

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
LoRaWAN Gateway / MQTT
Document code: MN67F36_ENG Revision 1. Page 18 of 35
L O R A WAN:
This section is used to define the general parameters of LoRaWAN. The means of
the fields are:
In the field “RF Band” the wireless band used for LoRaWAN communication
is defined;
In the field “Network Type” the type of LoRaWAN network is defined;
In the field “Diagnostic Position” it is possible to define an offset into the
internal memory array where the status of the LoRaWAN end devices
configured is saved. The diagnostic is made bit to bit, so each bit will
represent a status of a single end device:
o1  End device connected;
o  End device not connected.
The bits’ order will be the same of the end devices’ definition inside the LoRaWAN Access section;
In the field “RX2 Datarate” the data rate on RX2 window is defined.
Figure
3d
:
“Set Communication

LoRaWAN
” window

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
LoRaWAN Gateway / MQTT
Document code: MN67F36_ENG Revision 1. Page 19 of 35
Figure 3e: “Set C
ommunication

MQTT” window
MQTT:
This section is used to define the main parameters of MQTT line. The means of the
fields are:
In the field “Server URL” the URL or the IP Address of the MQTT Server is
defined;
In the field “Server Port” the port used for MQTT communication is defined;
In the field “Client ID” the Client ID of the converter is defined (if ned);
In the field “Keep Alive (seconds)” the delay with which the Keep Alive
message is sent on MQTT is defined;
If the field “Clean Session” is checked, the last MQTT messages are deleted
by the Server and the Client in case of missing ACK. If unchecked, the
Server and the Client hold the last MQTT messages and, in case of incorrect
disconnection or missing ACK, they try to send again them since all the ACK
messages are exchanged correctly (valid only for QoS 1 and QoS 2);
If the field “Will Flag” is checked, the converter will publish the Will topic at
the connection to the Server. With this feature, in case of incorrect
disconnection, the Server will publish this topic to all the MQTT Clients that
subscribed it;
In the field “Topic Name Will” the topic used for Will message is defined;
In the field “Message Will” the payload of the Will message is defined;
In the field “Retained Will” the converter will send the Will message with
Retain flag enabled. In this way, the Server will hold the last Will message;
In the field “QoS Will” the QoS type for Will message is defined;
If the field “Pu lish Topic on Connection” is checked, the converter will
publish a topic at the connection to the Server.
In the field “Topic Name Connection” the topic published at the connection is defined;
In the field “Message Connection” the payload of the connection topic is defined;
In the field “Retained Connection” the converter will send the connection topic with Retain flag enabled. In this way, the Server will
hold the last connection message;
Im the field “Username” the username for the connection to the MQTT server is defined;
In the field “Password” the password for the connection to the MQTT server is defined.

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
LoRaWAN Gateway / MQTT
Document code: MN67F36_ENG Revision 1. Page 2 of 35
Figure 3f: “Set Communication  TLS” window
Figure 3g: “Set Communication

NTP” window
TLS (T RANSPORT L AYER S ECURITY ):
This section is used to define the parameters of TLS protocol. The means of the
fields are:
If the field “Ena le TLS” is checked, the TLS protocol for secure connection
is enabled;
If the field “Server Authentication” is checked, the authentication of the
Server using TLS is enabled. If enabled, in the field “Server Certificate” the
certificate from the Server is defined;
If the field “Client Authentication” is checked, the authentication of the
Client using TLS is enabled. If enabled:
oin the field “Client Certificate” the certificate from the Client is
defined;
oin the field “Client Key” the private key of the Client is defined;
oin the field “Client Key Password” the password for the private key
of the Client is defined.
NTP (N ETWORK T IME P ROTOCOL ):
This section is used to define the parameters of NTP protocol. The means of the
fields are:
In the field “Server URL” the URL or the IP Address of the NTP Server is
defined;
In the field “Poll Time (seconds)” the polling time for the time
synchronization is defined.