ADF Web HD67948-2-A1 User manual

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
NMEA
1083
/
MQTT
Document code: MN67948_ENG Revision 1 000 Page 1 of 30
User Manual
Revision 1 000
English
NMEA 0183 / MQTT - Converter
(Order Code: HD67948-2-A1, HD67948-5-A1)
For Website information:
www adfweb com?Product=HD67948
For Price information:
www adfweb com?Price=HD67948-2-A1
www adfweb com?Price=HD67948-5-A1
Benefits and Main Features:
Very easy to configure
Triple Electrical isolation
Temperature range:
-
40°C/
+
85°C (
-
40°F/
+
185°F)
For other NMEA 0183 products see also the following link:
Converter NMEA 0183 to
www adfweb com?Product=HD67B20 (O C UA Client)
www adfweb com?Product=HD67B43 (O C UA Server)
www adfweb com?Product=HD67C58 (EnOcean)
www adfweb com?Product=HD67C72 (EnOcean)
www adfweb com?Product=HD67C73 (EnOcean)
www adfweb com?Product=HD67D28 (LoRaWAN)
www adfweb com?Product=HD67E18 (EtherCAT)
www adfweb com?Product=HD67615 ( ROINET)
www adfweb com?Product=HD67616 (Modbus Slave)
www adfweb com?Product=HD67617 (Modbus TC Slave)
www adfweb com?Product=HD67748 (IEC 61850 Server)
www adfweb com?Product=HD67775 (IEC 61850 Client)
www adfweb com?Product=HD67874 (IO-Link Master)
www adfweb com?Product=HD67979 (IO-Link Slave)
Do you have an your customer protocol?
See the following links:
www adfweb com?Product=HD67003
Do you need to choose a device? do you want help?
Ask it to the following link:
www adfweb com?Cmd=helpme
User Manual

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
NMEA
1083
/
MQTT
Document code: MN67948_ENG Revision 1 000 Page 2 of 30
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 7
CONFIGURATION 7
POWER SUPPLY 8
FUNCTION MODES 9
LEDS 10
RS232 11
RS485 12
ETHERNET 13
USE OF COMPOSITOR SW67948 14
NEW CONFIGURATION / OPEN CONFIGURATION 15
SOFTWARE OPTIONS 16
SET COMMUNICATION 18
NMEA 0183 ACCESS 22
MQTT SET TOPIC 23
UPDATE DEVICE 24
TEMPLATE STRING: DEFINITION OF MQTT
PAYLOAD
26
MECHANICAL DIMENSIONS 27
ORDERING INFORMATIONS 28
ACCESSORIES 28
DISCLAIMER 29
OTHER REGULATIONS AND STANDARDS 29
WARRANTIES AND TECHNICAL SUPPORT 30
RETURN POLICY 30
U DATED 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 000 18/09/2020 VDB All First Release

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
NMEA
1083
/
MQTT
Document code: MN67948_ENG Revision 1 000 Page 3 of 30
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 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 support@adfweb com or give us a call if you need it

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
NMEA
1083
/
MQTT
Document code: MN67948_ENG Revision 1 000 Page 4 of 30
EXAM LE OF CONNECTION:

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
NMEA
1083
/
MQTT
Document code: MN67948_ENG Revision 1 000 Page 5 of 30
CONNECTION SCHEME:
Figure 1a: Connection scheme for HD6794 -2-A1

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
NMEA
1083
/
MQTT
Document code: MN67948_ENG Revision 1 000 Page 6 of 30
Figure 1b: Connection scheme for HD6794 -5-A1

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
NMEA
1083
/
MQTT
Document code: MN67948_ENG Revision 1 000 Page 7 of 30
CHARACTERISTICS:
The HD67948-x-A1 are NMEA 0183 / MQTT - Converters
It allows for the following characteristics:
Isolation between NMEA 0183 – MQTT – Power Supply;
Two-directional information between NMEA 0183 bus and MQTT bus;
Mountable on 35mm Rail DIN;
Wide power supply input range: 8…24V AC or 12…35V DC;
Wide temperature range: -40°C / 85°C [-40°F / +185°F]
CONFIGURATION:
You need Compositor SW67948-x-A1 software on your PC in order to perform the following:
Define the parameters of NMEA 0183 line;
Define the parameters of MQTT line;
Define the list of NMEA 0183 sentences in reception;
Define the list of MQTT topics to publish/subscribe to the server;
Update the device

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
NMEA
1083
/
MQTT
Document code: MN67948_ENG Revision 1 000 Page 8 of 30
OWER SU LY:
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]
HD67948-x-A1 3 5
HD67948-x-A1
Caution:
Do n
ot reverse the polarity power

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
NMEA
1083
/
MQTT
Document code: MN67948_ENG Revision 1 000 Page 9 of 30
FUNCTION MODES:
The device has got two function modes depending on 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 uploading 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 specific functions, see ‘LEDS’ section

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
NMEA
1083
/
MQTT
Document code: MN67948_ENG Revision 1 000 Page 10 of 30
LEDS:
The device has got seven LEDs that are used to give information about 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: NMEA 0183 comm
(green) It blinks when NMEA 0183 communication is running Blinks quickly: Boot state
Blinks very slowly (~0.5Hz): update in progress
3: MQTT comm (green) It blinks when MQTT communication is running Blinks quickly: Boot state
Blinks very slowly (~0.5Hz): update in progress
4: Error state (green) 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

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
NMEA
1083
/
MQTT
Document code: MN67948_ENG Revision 1 000 Page 11 of 30
RS232:
The connection from RS232 socket to a serial port (example one from a personal computer) must be made with a NULL MODEM cable (a
serial cable where the pins 2 and 3 are crossed)
It is recommended that the RS232 cable not exceed 15 meters

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
NMEA
1083
/
MQTT
Document code: MN67948_ENG Revision 1 000 Page 12 of 30
RS485:
For terminate the RS485 line with a 120Ω resistor it is necessary to put ON dip 1, like in figure
The maximum length of the cable should be 1200m (4000 feet)
Here some codes of cables:
Belden: p/n 8132 - 2x 28AWG stranded twisted pairs conductor + foil shield + braid shield;
Belden p/n 82842 - 2x 24AWG stranded twisted pairs conductor + foil shield + braid shield;
Tasker: p/n C521 - 1x 24AWG twisted pair conductor + foil shield + braid shield;
Tasker: p/n C522 - 2x 24AWG twisted pairs conductor + foil shield + braid shield

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
NMEA
1083
/
MQTT
Document code: MN67948_ENG Revision 1 000 Page 13 of 30
ETHERNET:
The Ethernet port is used for programming the device and for MQTT communication
Ethernet connection and the updating of the converter must be made using Connector9 and/or Connector10 of the HD67948-x-A1 with at
least a Category 5E cable The maximum length of the cable should not exceed 100m The cable has to conform to the T568 norms relative
to connections in cat 5 up to 100 Mbps To connect the device to an Hub/Switch is recommended the use of a straight cable, to connect the
device to a PC/PLC/other is recommended the use of a cross cable

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
NMEA
1083
/
MQTT
Document code: MN67948_ENG Revision 1 000 Page 14 of 30
USE OF COM OSITOR SW67948:
To configure the Converter, use the available software that runs with Windows called SW67948 It is downloadable on the site
www adfweb com and its operation is described in this document (This manual is referenced to the last version of the software present on
our web site) The software works with MSWindows (XP, Vista, Seven, 8, 10; 32/64bit)
When launching the SW67948, the window below appears (Fig 2)
Note:
It is necessary to have installed Net Framework 4
F
igure 2: Main window for SW6794

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
NMEA
1083
/
MQTT
Document code: MN67948_ENG Revision 1 000 Page 15 of 30
NEW CONFIGURATION / O EN 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 “NMEA 0183 / 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
NMEA
1083
/
MQTT
Document code: MN67948_ENG Revision 1 000 Page 16 of 30
SOFTWARE O TIONS:
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 rogram”, the
SW67948 checks automatically if there are updatings when it is launched

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
NMEA
1083
/
MQTT
Document code: MN67948_ENG Revision 1 000 Page 17 of 30
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
NMEA
1083
/
MQTT
Document code: MN67948_ENG Revision 1 000 Page 18 of 30
SET COMMUNICATION:
This section define the fundamental communication parameters of two buses, NMEA
0183 and MQTT
By Pressing the “Set Communication” button from the main window for SW67948
(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:
MQTT
Serial
TLS (Transport Layer Security)
NTP (Network Time Protocol)
Ethernet
Figure 3
a
: “Set Communication” window

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
NMEA
1083
/
MQTT
Document code: MN67948_ENG Revision 1 000 Page 19 of 30
Figure 3b: “Set Communication  MQTT” window
M QTT :
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 ort” 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;
Im the field “Username” the username for the connection to the MQTT server is defined;
In the field “ assword” the password for the connection to the MQTT server is defined

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
NMEA
1083
/
MQTT
Document code: MN67948_ENG Revision 1 000 Page 20 of 30
Figure 3d: “Set Communication  TLS” window
Figure 3
e
: “Set Communication

NTP” window
Figure 3c: “Set Communication

Se
rial” window
S ERIAL :
This section is used to define the parameters of Serial line The means of the fields are:
In the field “Baudrate” the baudrate for the serial line is defined;
In the field “ arity” the parity of the serial line is defined;
In the field “Stop Bits” the number of Stop Bits of the serial line is defined
T LS :
This section is used to define the parameters of TLS protocol The means of the fields
are:
If the field “Enable 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
NT (N ETWORK T IME 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 “ oll Time (seconds)” the polling time for the time
synchronization is defined