ADF Web HD67933 B2 Series User manual

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
Modbus Master / MQTT
Document code: MN67933_ENG Revision 1.1 1 Page 1 of 45
User Manual
Revision 1.1 1
English
Modbus Master / MQTT - Converter
(Order Code: HD67933-x-B2, HD67933-x-GPRS-B2,
HD67933-x-G43-B2)
For Website information:
www.adfweb.com?Product=HD67933-B2
For Price information:
www.adfweb.com?Price=HD67933-2-B2
www.adfweb.com?Price=HD67933-4-B2
www.adfweb.com?Price=HD67933-2-GPRS-B2
www.adfweb.com?Price=HD67933-4-GPRS-B2
www.adfweb.com?Price=HD67933-2-G43-B2
www.adfweb.com?Price=HD67933-4-G43-B2
Benefits and Main Features:
Very easy to configure
Power Supply 18…35V DC and 8…24 V AC
Temperature range: -4 °C/+85°C (-4 °F/+185°F)
For others MQTT products, see also the following links:
Converter MQTT to
www.adfweb.com?Product=HD67873 (IO-Link Master)
www.adfweb.com?Product=HD67747 (IEC6 850 Server)
www.adfweb.com?Product=HD67774 (IEC6 850 Client)
www.adfweb.com?Product=HD6791 (HART)
www.adfweb.com?Product=HD6793 (Ethernet)
www.adfweb.com?Product=HD67931 (M-Bus)
www.adfweb.com?Product=HD67932 (Serial)
www.adfweb.com?Product=HD67934 (Modbus Slave)
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 (CAN)
www.adfweb.com?Product=HD6794 (CANopen)
www.adfweb.com?Product=HD67941 (DALI)
www.adfweb.com?Product=HD67942 (DeviceNet Master)
www.adfweb.com?Product=HD67943 (DeviceNet Slave)
www.adfweb.com?Product=HD67944 (DMX)
www.adfweb.com?Product=HD67945 (EtherNet/IP Slave)
www.adfweb.com?Product=HD67946 (J 939)
www.adfweb.com?Product=HD67947 (KNX)
www.adfweb.com?Product=HD67948 (NMEA 0 83)
www.adfweb.com?Product=HD67949 (NMEA 2000)
www.adfweb.com?Product=HD6795 (PROFIBUS Master)
www.adfweb.com?Product=HD67951 (PROFIBUS Slave)
www.adfweb.com?Product=HD67952 (PROFINET Slave)
www.adfweb.com?Product=HD67953 (SNMP Manager)
www.adfweb.com?Product=HD67954 (SNMP Agent)
www.adfweb.com?Product=HD67955 (EtherNet/IP Master)
www.adfweb.com?Product=HD67978 (IO-Link Slave)
www.adfweb.com?Product=HD67B8 (PROFINET Master)
www.adfweb.com?Product=HD67C7 (EnOcean)
www.adfweb.com?Product=HD67D36 (LoRaWAN)
www.adfweb.com?Product=HD67E17 (EtherCAT Slave)
Do you have an your customer protocol?
www.adfweb.com?Product=HD67 3
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 Master / MQTT
Document code: MN67933_ENG Revision 1.1 1 Page 2 of 45
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 11
CONFIGURATION 11
POWER SUPPLY 12
FUNCTION MODES 13
LEDS 14
RS232 15
RS485 16
ETHERNET 17
GPRS 17
USE OF COMPOSITOR SW67933 18
NEW CONFIGURATION / OPEN CONFIGURATION 19
SOFTWARE OPTIONS 2
SET COMMUNICATION 22
MQTT SET TOPIC (Synchronous Mode) 29
MQTT SET TOPIC (Asynchronous Mode) 3
MODBUS SET ACCESS (Synchronous Mode) 33
MODBUS SET ACCESS (Asynchronous Mode) 34
UPDATE DEVICE 36
TEMPLATE STRING: DEFINITION OF MQTT
PAYLOAD 38
MODBUS WRITING WITH SYNCHRONOUS MODE 4
MECHANICAL DIMENSIONS 41
ORDERING INFORMATIONS 42
ACCESSORIES 43
DISCLAIMER 44
OTHER REGULATIONS AND STANDARDS 44
WARRANTIES AND TECHNICAL SUPPORT 45
RETURN POLICY 45
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. 5/12/2 17 Ff All First release version
1. 1 23/ 3/2 18 Ff All Revision
1.1 2 / 6/2 19 Ff All Revision
1.1 1 28/ 5/2 21 Ff All Revision

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
Modbus Master / MQTT
Document code: MN67933_ENG Revision 1.1 1 Page 3 of 45
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
Modbus Master / MQTT
Document code: MN67933_ENG Revision 1.1 1 Page 4 of 45
EXAMPLE OF CONNECTION:

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
Modbus Master / MQTT
Document code: MN67933_ENG Revision 1.1 1 Page 5 of 45
CONNECTION SCHEME:
Figure 1a: Connection scheme for HD67933 2 B2

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
Modbus Master / MQTT
Document code: MN67933_ENG Revision 1.1 1 Page 6 of 45
Figure 1b: Connection scheme for HD67933 4 B2

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
Modbus Master / MQTT
Document code: MN67933_ENG Revision 1.1 1 Page 7 of 45
Figure 1c: Connection scheme for HD67933 2 G43 B2

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
Modbus Master / MQTT
Document code: MN67933_ENG Revision 1.1 1 Page 8 of 45
Figure 1d: Connection scheme for HD67933 4 G43 B2

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
Modbus Master / MQTT
Document code: MN67933_ENG Revision 1.1 1 Page 9 of 45
Figure 1e: Connection scheme for HD67933 2 GPRS B2

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
Modbus Master / MQTT
Document code: MN67933_ENG Revision 1.1 1 Page 1 of 45
Figure 1e: Connection scheme for HD67933 4 GPRS B2

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
Modbus Master / MQTT
Document code: MN67933_ENG Revision 1.1 1 Page 11 of 45
CHARACTERISTICS:
The HD67933-B2 is a Modbus Master / MQTT Converter.
It allows the following characteristics:
Electrical isolation between MQTT and Modbus;
Mountable on 35mm Rail DIN;
Wide power supply input range: 18…35V DC and 8…24V AC;
Wide temperature range: -4 °C / 85°C [-4 °F / +185°F].
CONFIGURATION:
You need Compositor SW67933 software on your PC in order to perform the following:
Define the parameter of MQTT;
Define the parameter of Modbus line;
Define which Modbus variables are sent to MQTT Server;
Define which Modbus variables are written by MQTT Server;
Update the device.

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
Modbus Master / MQTT
Document code: MN67933_ENG Revision 1.1 1 Page 12 of 45
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 2V 35V
Consumption at 24V DC:
Device Consumption [W/VA]
HD67933-B2 3.5
HD67933-x-B2
HD67933-x-G43-B2
HD67933-x-GPRS-B2
Caution: Not reverse the polarity power

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
Modbus Master / MQTT
Document code: MN67933_ENG Revision 1.1 1 Page 13 of 45
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
Modbus Master / MQTT
Document code: MN67933_ENG Revision 1.1 1 Page 14 of 45
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: MQTT communication
(yellow) Blinks when MQTT communication is running Blinks quickly: Boot state
Blinks very slowly (~0.5Hz): update in progress
3: Modbus communication
(yellow) Blinks when Modbus communication is running Blinks quickly: Boot state
Blinks very slowly (~0.5Hz): update in progress
4:Modbus error (yellow) Turns ON when an error occurs Blinks quickly: Boot state
Blinks very slowly (~0.5Hz): update in progress
5: Ethernet Link (green) ON: Ethernet cable connected
OFF: Ethernet cable disconnected
ON: Ethernet cable connected
OFF: Ethernet cable disconnected

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
Modbus Master / MQTT
Document code: MN67933_ENG Revision 1.1 1 Page 15 of 45
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
Modbus Master / MQTT
Document code: MN67933_ENG Revision 1.1 1 Page 16 of 45
RS485:
For terminate the RS485 line with a 12 Ω resistor it is necessary to put ON dip 1, like in figure.
The maximum length of the cable should be 12 m (4 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 Master / MQTT
Document code: MN67933_ENG Revision 1.1 1 Page 17 of 45
ETHERNET:
The Ethernet port is used for programming the device and for MQTT communication.
The Ethernet connection must be made using Connector2 of HD67933 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.
MOBILE:
The HD67933-x-G43-B2 uses LTE module and the HD67933-x-GPRS-B2 uses a Quad-band
GSM/GPRS module.
The Antenna connector is a SMA Female (‘Female Outer Shell’ and ‘Female Receptacle’) so
the Antenna must have a SMA Male connector (there are two antennas for HD67933-x-G43-
B2). The SIM type is Micro-Sim.

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

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
Modbus Master / MQTT
Document code: MN67933_ENG Revision 1.1 1 Page 19 of 45
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 “Modbus Master / 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 Master / MQTT
Document code: MN67933_ENG Revision 1.1 1 Page 2 of 45
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
SW67933 check automatically if there are updatings when it is launched.