ADF Web HD67937-IP-B2 User manual

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
BACnet Master / MQTT
Document code: MN67937_ENG Revision 1. Page 1 of 36
User Manual
Revision 1.
English
BACnet Master / MQTT - Converter
(Order Code: HD67937-IP-B2, HD67937-MSTP-B2)
For Website information:
www.adfweb.com?Product=HD67937-B2
For Price information:
www.adfweb.com?Price=HD67937-IP-B2
www.adfweb.com?Price=HD67937-MSTP-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=HD6793 (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=HD67934 (Modbus Slave)
www.adfweb.com?Product=HD67935 (Modbus TCP Master)
www.adfweb.com?Product=HD67936 (Modbus TCP Slave)
www.adfweb.com?Product=HD67938 (BACnet Slave)
www.adfweb.com?Product=HD67939 (CA )
www.adfweb.com?Product=HD6794 (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=HD6795 (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=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
BACnet Master / MQTT
Document code: MN67937_ENG Revision 1. Page 2 of 36
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 7
CONFIGURATION 7
POWER SUPPLY 8
FUNCTION MODES 9
LEDS 1
RS485 11
ETHERNET 12
USE OF COMPOSITOR SW67937 13
NEW CONFIGURATION / OPEN CONFIGURATION 14
SOFTWARE OPTIONS 15
SET COMMUNICATION 17
MQTT SET TOPIC 24
SET BACNET ACCESS 26
UPDATE DEVICE 3
TEMPLATE STRING: DEFINITION OF MQTT
PAYLOAD 32
MECHANICAL DIMENSIONS 33
ORDERING INFORMATIONS 34
ACCESSORIES 34
DISCLAIMER 35
OTHER REGULATIONS AND STANDARDS 35
WARRANTIES AND TECHNICAL SUPPORT 36
RETURN POLICY 36
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. 5/12/2 17 Ff All First release version

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
BACnet Master / MQTT
Document code: MN67937_ENG Revision 1. Page 3 of 36
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 [email protected]om or give us a call if you need it.

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
BACnet Master / MQTT
Document code: MN67937_ENG Revision 1. Page 4 of 36
EXAMPLE OF CO ECTIO :

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
BACnet Master / MQTT
Document code: MN67937_ENG Revision 1. Page 5 of 36
CO ECTIO SCHEME:
Figure 1a: Connection scheme for HD67937 IP B2

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
BACnet Master / MQTT
Document code: MN67937_ENG Revision 1. Page 6 of 36
Figure 1b: Connection scheme for HD67937 MSTP B2

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
BACnet Master / MQTT
Document code: MN67937_ENG Revision 1. Page 7 of 36
CHARACTERISTICS:
The HD67937-B2 is a BACnet Master / MQTT Converter.
It allows the following characteristics:
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].
CO FIGURATIO :
You need Compositor SW67937 software on your PC in order to perform the following:
Define the parameter of MQTT;
Define the parameter of BACnet line;
Define the MQTT topics to be published/subscribed in the MQTT Server;
Define the list of BACnet objects that the converter will read/write;
Update the device.

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
BACnet Master / MQTT
Document code: MN67937_ENG Revision 1. Page 8 of 36
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]
HD67937-IP-B2 3.5
HD67937-MSTP-B2 3.5
HD67937-B2
Caution: ot reverse the polarity power

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
BACnet Master / MQTT
Document code: MN67937_ENG Revision 1. Page 9 of 36
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
BACnet Master / MQTT
Document code: MN67937_ENG Revision 1. Page 1 of 36
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: BACnet communication
(yellow) Blinks when BACnet 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: BACnet error (yellow) O : at least one BACnet request is not working
OFF: No errors
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
BACnet Master / MQTT
Document code: MN67937_ENG Revision 1. Page 11 of 36
RS485 (for BACnet MS/TP):
For terminating 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
BACnet Master / MQTT
Document code: MN67937_ENG Revision 1. Page 12 of 36
ETHER ET:
The Ethernet port is used for programming the device and for MQTT and BACnet/IP communication.
The Ethernet connection must be made using Connector2 of HD67937-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
BACnet Master / MQTT
Document code: MN67937_ENG Revision 1. Page 13 of 36
USE OF COMPOSITOR SW67937:
To configure the Converter, use the available software that runs with Windows called SW67937. 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 SW67937, the window below appears (Fig. 2).
Note:
It is necessary to have installed .Net Framework 4.
Figure 2: Main window for SW67937

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
BACnet Master / MQTT
Document code: MN67937_ENG Revision 1. Page 14 of 36
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 “BACnet 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
BACnet Master / MQTT
Document code: MN67937_ENG Revision 1. Page 15 of 36
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
SW67937 check automatically if there are updatings when it is launched.

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
BACnet Master / MQTT
Document code: MN67937_ENG Revision 1. Page 16 of 36
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
BACnet Master / MQTT
Document code: MN67937_ENG Revision 1. Page 17 of 36
SET COMMU ICATIO :
By Pressing the “Set Communication” button from the main window for SW67937 (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:
BACnet Master
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
BACnet Master / MQTT
Document code: MN67937_ENG Revision 1. Page 18 of 36
Figure 3b: “Set Communication  BACnet/IP Master”
window
BAC ET M ASTER ( FOR BAC ET /IP):
This section is used to define the main parameters of BACnet/IP line. The means of
the fields are:
In the field “IP ADDRESS” the IP address to assign to 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 network 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 “Port” the port used for BACnet communication is defined. The
default port used for BACnet communication is 478 8, but it is possible to
insert any value (except 1 and 1 1);
In the field "BACnet Device ame" the name to the BACnet node is
defined;
In the field “Device Identifier” the number to the BACnet node (used for
the Device Identifier) is defined;
In the field “TimeOut Polling (ms)” the timeout for the BACnet requests is
defined.

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
BACnet Master / MQTT
Document code: MN67937_ENG Revision 1. Page 19 of 36
Figure 3c: “Set Communication  BACnet MS/TP
Master” window
BAC ET M ASTER ( FOR BAC ET MS/TP):
This section is used to define the main parameters of BACnet MS/TP line. The
means of the fields are:
In the field “Baudrate” it is possible to select the baudrate of the BACnet;
In the field “Parity” it is possible to select the parity of the line;
In the field “BACnet Device ame” is possible to insert the name to give to
the BACnet node;
In the field “MAC Address” it is possible to define the MAC of BACnet node
(from to 254);
The field “Max Masters” specifies the highest allowable address for master
nodes. The value shall be less than or equal to 127;
The field “Max Info Frames” specifies the maximum number of information
frames the node may send before it must pass the token;
In the field “Device Istance” it is possible to assign a number to the BACnet
node (Used for the Device Istance).

Industrial Electronic Devices
ADFweb.com S.r.l.
User Manual
BACnet Master / MQTT
Document code: MN67937_ENG Revision 1. Page 2 of 36
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.