ADF Web HD67934-B2 Series User manual

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
Modbus Slave / MQTT
Document code: MN67934_ENG Revision 1 001 Page 1 of 33
User Manual
Revision 1 000
English
Modbus Slave / MQTT - Converter
(Order Code: HD67934-x-B2)
For Website information:
www adfweb com?Product=HD67934-B2
For Price information:
www adfweb com?Price=HD67934-2-B2
www adfweb com?Price=HD67934-4-B2
Benefits and Main Features:
Very easy to configure
Power Supply 18…35V DC and 8…24 V AC
Temperature range: -40°C/+85°C (-40°F/+185°F)
For others MQTT products, see also the following links:
Converter MQTT to
www adfweb com?Product=HD67930 (Ethernet)
www adfweb com?Product=HD67931 (M-Bus)
www adfweb com?Product=HD67932 (Serial)
www adfweb com?Product=HD67933 (Modbus Master)
www adfweb com?Product=HD67935 (Modbus TCP Master)
www adfweb com?Product=HD67936 (Modbus TCP Slave)
www adfweb com?Product=HD67937 (BACnet Master)
www adfweb com?Product=HD67938 (BACnet Slave)
www adfweb com?Product=HD67939 (CA )
www adfweb com?Product=HD67940 (CA open)
www adfweb com?Product=HD67941 (DALI)
www adfweb com?Product=HD67942 (Device et Master)
www adfweb com?Product=HD67943 (Device et Slave)
www adfweb com?Product=HD67944 (DMX)
www adfweb com?Product=HD67945 (Ether et/IP)
www adfweb com?Product=HD67946 (J1939)
www adfweb com?Product=HD67947 (K X)
www adfweb com?Product=HD67948 ( MEA 0183)
www adfweb com?Product=HD67949 ( MEA 2000)
www adfweb com?Product=HD67950 (PROFIBUS Master)
www adfweb com?Product=HD67951 (PROFIBUS Slave)
www adfweb com?Product=HD67952 (PROFI ET)
www adfweb com?Product=HD67953 (S MP Manager)
www adfweb com?Product=HD67954 (S MP Agent)
Do you have an your customer protocol?
www adfweb com?Product=HD67003
Do you need to choose a device? do you want help?
www adfweb com?Cmd=helpme
User Manual

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
Modbus Slave / MQTT
Document code: MN67934_ENG Revision 1 001 Page 2 of 33
I DEX:
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
RS485 10
ETHERNET 11
USE OF COMPOSITOR SW67934 12
NEW CONFIGURATION / OPEN CONFIGURATION 13
SOFTWARE OPTIONS 14
SET COMMUNICATION 16
MQTT SET TOPIC (Synchronous Mode) 22
MQTT SET TOPIC (Sniffer Mode) 24
UPDATE DEVICE 25
TEMPLATE STRING: DEFINITION OF MQTT
PAYLOAD 27
MODBUS MAP (ASYNCRONOUS MODE) 28
MECHANICAL DIMENSIONS 30
ORDERING INFORMATIONS 31
ACCESSORIES 31
DISCLAIMER 32
OTHER REGULATIONS AND STANDARDS 32
WARRANTIES AND TECHNICAL SUPPORT 33
RETURN POLICY 33
UPDATED DOCUME TATIO :
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
REVISIO LIST:
WAR I G:
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 05/12/2017 Ff All First release version

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
Modbus Slave / MQTT
Document code: MN67934_ENG Revision 1 001 Page 3 of 33
SECURITY ALERT:
G E ERAL I FORMATIO
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 TE DED 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 ERSO EL
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 CO FORMITY
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
Modbus Slave / MQTT
Document code: MN67934_ENG Revision 1 001 Page 4 of 33
EXAMPLE OF CO ECTIO :

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
Modbus Slave / MQTT
Document code: MN67934_ENG Revision 1 001 Page 5 of 33
CO ECTIO SCHEME:
Figure 1: Connection scheme for HD67934 4 B2

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
Modbus Slave / MQTT
Document code: MN67934_ENG Revision 1 001 Page 6 of 33
CHARACTERISTICS:
The HD67934-B2 is a Modbus Slave / MQTT Converter
It allows the following characteristics:
Electrical isolation between Ethernet and Modbus;
Mountable on 35mm Rail DIN;
Wide power supply input range: 18…35V DC and 8…24V AC;
Wide temperature range: -40°C / 85°C [-40°F / +185°F]
CO FIGURATIO :
You need Compositor SW67934 software on your PC in order to perform the following:
Define the parameter of MQTT;
Define the parameter of Modbus line;
Define the MQTT topics to be published/subscribed in the MQTT Server;
Update the device

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
Modbus Slave / MQTT
Document code: MN67934_ENG Revision 1 001 Page 7 of 33
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]
HD67934-B2 3 5
HD67934-B2
Caution: ot reverse the polarity power

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
Modbus Slave / MQTT
Document code: MN67934_ENG Revision 1 001 Page 8 of 33
FU CTIO 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
Modbus Slave / MQTT
Document code: MN67934_ENG Revision 1 001 Page 9 of 33
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 ormal Mode Boot Mode
1: Device State (green) Blinks slowly (~1Hz) Blinks quickly: Boot state
Blinks very slowly (~0.5Hz): update in progress
2: Modbus communication
(yellow) Blinks when Modbus communication is running Blinks quickly: Boot state
Blinks very slowly (~0.5Hz): update in progress
3: MQTT status (yellow)
O : MQTT not connected
OFF: MQTT connected
Blinking: MQTT communication
Blinks quickly: Boot state
Blinks very slowly (~0.5Hz): update in progress
4: Not used (yellow) OFF Blinks quickly: Boot state
Blinks very slowly (~0.5Hz): update in progress
5: Ethernet Link (green) O : Ethernet cable connected
OFF: Ethernet cable disconnected
O : Ethernet cable connected
OFF: Ethernet cable disconnected

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
Modbus Slave / MQTT
Document code: MN67934_ENG Revision 1 001 Page 10 of 33
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
Modbus Slave / MQTT
Document code: MN67934_ENG Revision 1 001 Page 11 of 33
ETHER ET:
The Ethernet port is used for programming the device and for MQTT communication
The Ethernet connection must be made using Connector2 of HD67934-B2 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 is recommended the use of a cross cable

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
Modbus Slave / MQTT
Document code: MN67934_ENG Revision 1 001 Page 12 of 33
USE OF COMPOSITOR SW67934:
To configure the Converter, use the available software that runs with Windows called SW67934 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, 10; 32/64bit)
When launching the SW67934, the window below appears (Fig 2)
Note:
It is necessary to have installed Net Framework 4
Figure 2: Main window for SW67934

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
Modbus Slave / MQTT
Document code: MN67934_ENG Revision 1 001 Page 13 of 33
EW CO FIGURATIO / OPE CO FIGURATIO :
The “ ew 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 “Modbus Slave / 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
Modbus Slave / MQTT
Document code: MN67934_ENG Revision 1 001 Page 14 of 33
SOFTWARE OPTIO S:
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
SW67934 check automatically if there are updatings when it is launched

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
Modbus Slave / MQTT
Document code: MN67934_ENG Revision 1 001 Page 15 of 33
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
Modbus Slave / MQTT
Document code: MN67934_ENG Revision 1 001 Page 16 of 33
SET COMMU ICATIO :
By Pressing the “Set Communication” button from the main window for SW67934
(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:
Working Mode
Modbus Slave
MQTT
Ethernet
Wi-Fi
TLS (Transport Layer Security)
NTP (Network Time Protocol)
Figure 3a: “Set Communication” window

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
Modbus Slave / MQTT
Document code: MN67934_ENG Revision 1 001 Page 17 of 33
Figure 3b: “Set Communication  Working Mode” window
Figure 3c: “Set Communication  Modbus Slave”
window
W ORKI G M ODE :
This section is used to define the working mode of MQTT side of the converter It is
possible to define:
Sniffer: it is possible sniff a bus as a passive device The converter will
publish all the frames in the bus, using the message payload defined
Asynchronous: the converter acts as slave The Modbus Master can write
the data to transfer on MQTT side and read back the data subscribed by the
converter
M ODBUS S LAVE :
This section is used to define the main parameters of Modbus line The means of the
fields are:
In the field “Serial” the serial port to use is defined (RS232 or RS485);
In the field “Baudrate” the baudrate for the serial line is defined;
In the field “Parity” the parity of the serial line is defined;
In the field “Stop Bits” the number of Stop Bits of the serial line is defined;
In the field “ID Device” the ID of Modbus side of the converter is defined
(only if “Asynchronous” mode is set);
If the field “Read with Input Register / Status Function” is checked, it is
possible to read the data from MQTT side with Input Registers (Function 04)
and write the data to publish on MQTT side with Holding Registers (Function
06/16) The Output data are readable with Function 03 Otherwise, only
Holding Registers will be used and the Output data of MQTT side cannot be
read back

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
Modbus Slave / MQTT
Document code: MN67934_ENG Revision 1 001 Page 18 of 33
Figure 3d: “Set Communication

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 ame 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 “Password” the password for the connection to the MQTT server is defined;
In the field “Send Time (seconds)” the delay with which the MQTT messages are published is defined

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
Modbus Slave / MQTT
Document code: MN67934_ENG Revision 1 001 Page 19 of 33
Figure 3e: “Set Communication  Ethernet”
window
Figure 3f: “Set Communication

Wi
Fi” window
E THER ET :
This section is used to define the general parameters of Ethernet The means of the
fields are:
In the field “Ip Address” the IP address of the converter is defined;
In the field “Sub et Mask” the Subnet Mask of the converter is defined;
In the field “Gateway” the default gateway of the net is defined This feature
can be enabled or disabled pressing the Check Box field This feature is used
for going out of the net;
In the field “D S” the DNS address is defined This field is required if the
server address is define by URL and not IP Address
W I -F I :
This section is used to define the general parameters of Wi-Fi It is possible to defined
the type of Wi-Fi communication:
Access Point;
Client
The means of the fields for Access Point configuration are:
In the field “IP Address” the IP address of the converter is defined;
In the field “Subnet Mask” the SubNet Mask of the converter is defined;
In the field “GATEWAY” the default gateway of the net is defined This feature
can be enabled or disabled pressing the Check Box field This feature is used
for going out of the net;
In the field “D S” the DNS address is defined This field is required if the
server address is define by URL and not IP Address
In the field “Port” the port used for MQTT communication is defined;
In the field “SSID” the name of the Wi-Fi network to create is defined;
In the field “Password” the password used for Wi-Fi connection is defined;
In the field “Type” the type of security protocol used by the Wi-Fi network is
defined;

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
Modbus Slave / MQTT
Document code: MN67934_ENG Revision 1 001 Page 20 of 33
Figure 3g: “Set Communication

Wi
Fi” window
If the field “Enable DHCP” is checked, the converter acts as DHCP Server for the Clients connected If the option is enabled, in the
fields “DHCP First IP Address” and “DHCP SUB ET Mask” the IP Addresses range used for DHCP is defined In the field “Lease
Time (seconds)” the required time for the renewing of the IP Address assigned to the Client is defined;
In the field “Max Client” the maximum number of Wi-Fi Clients accepted is defined;
In the field “Channel” the channel for Wi-Fi communication is defined
The means of the fields for Client configuration are:
If the field “Obtain an IP Address automatically” is checked, the
converter gets the IP Address using DHCP Otherwise, the IP Address is
defined as static;
In the field “IP Address” the IP address of the converter is defined;
In the field “Subnet Mask” the SubNet Mask of the converter is defined;
In the field “GATEWAY” the default gateway of the net is defined This
feature can be enabled or disabled pressing the Check Box field This feature
is used for going out of the net;
In the field “D S” the DNS address is defined This field is required if the
server address is define by URL and not IP Address
In the field “Port” the port used for MQTT communication is defined;
In the field “SSID” the name of the Wi-Fi network to connect is defined;
In the field “Password” the password used to connect to the Wi-Fi network
is defined