W&T MQTT.box User manual

MQTT.box
valid for the product:
#55990 MQTT.box
v1.04, 17.06.2021, english
Operating instructions
Commissioning and application

2
© 06/2021 by Wiesemann und Theis GmbH
Errors and omissions excepted:
Because we can make mistakes, none of our statements should be used without ve-
rication. Please report any errors or misunderstandings that come to your attention
so that we can identify and correct them as quickly as possible.
Only carry out work on or with W&T products if it is described here and you have
read and understood the instructions in full. Unauthorized action can cause ha-
zards. We are not liable for the consequences of unauthorized actions. In case of
doubt, please contact us or your dealer again!

3
Inhalt
1. Security and law................................................................. 6
Notes.................................................................................................................. 6
Instructions for action........................................................................................ 7
Solve task.................................................................................................................... 7
Other design elements....................................................................................... 7
Qualied personnel ............................................................................................ 8
Intended use....................................................................................................... 8
Product modications........................................................................................ 8
Electrical safety.................................................................................................. 8
Electromagnetic compatibility........................................................................... 9
Conformity to standards .................................................................................... 9
Storage ............................................................................................................. 10
Transportation.................................................................................................. 10
Disposal............................................................................................................ 10
2. Product information......................................................... 11
Manufacturer.................................................................................................... 11
Product labeling .............................................................................................. 11
Scope of delivery.............................................................................................. 11
Accessories and spare parts ........................................................................... 12
Symbols on the products ................................................................................. 12
3. Installation ....................................................................... 13
Mounting in the control cabinet ....................................................................... 13
Mount on top hat rail................................................................................................13
Set up power supply......................................................................................... 13
Set up power supply via PoE ...................................................................................13
Set up power supply via external power supply unit .............................................14
Connect network cable .................................................................................... 14
4. Commissioning................................................................ 15
Make network settings..................................................................................... 15
Make network settings via the WuTility.................................................................15

4
Make network settings via DHCP ...........................................................................15
Make network settings via the default IP...............................................................16
Call web interface............................................................................................. 16
Calling up the web interface via IP address...........................................................16
Calling up the web interface via the WuTility .........................................................16
Make language settings ..........................................................................................17
Make further settings via the web interface .................................................... 17
General notes on the web interface...............................................................................17
Log in administration user.......................................................................................17
Congure second network interface ......................................................................17
Set date and time .....................................................................................................18
Change device information .....................................................................................18
Set/change login password ....................................................................................19
5. Conguration of the MQTT broker................................... 20
Basic settings for the MQTT service................................................................ 20
Enable MQTT broker ................................................................................................20
Congure MQTT port ...............................................................................................20
Enable TLS encryption for the MQTT service ........................................................21
Set access rights for the MQTT service........................................................... 21
Enable user management .......................................................................................21
Set up user ................................................................................................................22
Allow anonymous access .......................................................................................22
Enable access restrictions via Access Control Lists ............................................22
Set up Access Control Lists (ACL)..........................................................................23
MQTT-Log......................................................................................................... 23
Congure log level....................................................................................................23
Download log outputs..............................................................................................24
Empty log outputs .................................................................................................... 24
6. Maintenance .................................................................... 25
Open housing ...........................................................................................................25
Restore factory settings on the hardware side......................................................25
Restore factory settings on the software side.......................................................26
Perform rmware update ........................................................................................26
Warm start ................................................................................................................26

5
7. Decommissioning............................................................ 28
Dismounting the device from the DIN rail ..............................................................28
Proper disposal ........................................................................................................28
8. Technical data.................................................................. 29

6
1. Security and law
Notes
This manual contains instructions concerning your personal safety. They are
introduced by a signal word expressing the seriousness of the danger:
DANGER means an imminently hazardous situation which, if not avoided, will result
in death or serious injury.
WARNING indicates a possible hazard that could result in death or serious injury.
CAUTION indicates a possible hazard that may result in injury.
In each case, the signal word of the highest applicable hazard level is used in a
warning. This means that if there is an indication of danger to life, there may also be
a danger of injury.
If a warning refers to an entire section or to a sequence of work steps, it precedes
them and is structured as follows.
⚠ SIGNAL WORD 0Nature and source of the hazard
Consequences of the danger
🢂An action step to avert the consequences of the danger
🢂Another action step to ward off the consequences of the danger
A warning notice that refers to an individual work step immediately precedes it and
is structured as follows:
1. Previous work step
⚠SIGNAL WORD: Nature and source of the hazard
Consequences of the danger
🢂Action step to avert the danger
🢂Further action step to avert the danger
2. Work step to which the note refers
3. Subsequent work step
Some other information within this guide is also highlighted:

7
❗Note: Risk of property damage imminent
Circumstances that can lead to property damage
ℹGeneral information
General information on the following text section
📚Further information
Reference to further information
🅿Produkt
The following section refers only to a specic product.
👥Target groups
The following section or sequence of actions is aimed at a specic target group.
Instructions for action
Tasks for achieving specic goals are instructions for action in the form of step-by-
step instructions. These have the following structure:
⛳Solve task
The introductory paragraph summarizes the task and points out general prere-
quisites needed to perform it. The following is a list of
• items needed for implementation and
• concrete requirements that must be met
1. rst action step
2. second action step
3. third action step
Achieved result and, where applicable, a performance review.
Other design elements
References to websites:
🌎www.wut.de

8
User input:
129.11.121.1
Sourcecode:
print(„This is a programming example“)
Emphasis in text:
Identiers, such as button labels, are highlighted in the body text.
Qualied personnel
⚠ WARNING 0Danger to life due to electric current
Improper installation can lead to accidents with electric current
🢂Installation by qualied personnel only
🢂Observe documentation
🢂Observe safety regulations
The products described in this manual may only be installed and started up by per-
sonnel qualied for the task in hand. The documentation corresponding to the re-
spective task must be observed; in particular the safety and warning instructions
contained therein.
Qualied personnel, based on their training and experience, are capable of recogni-
zing risks and avoiding possible hazards when handling the products described.
Intended use
The MQTT.box is a communication gateway for networking systems that implement
the MQTT protocol. It is intended to be permanently installed in control cabinets.
Any other use is not in accordance with the intended purpose. Wiesemann & Theis
GmbH is not liable for any damage resulting from improper use.
Product modications
Product modications are not permitted. Wiesemann & Theis GmbH shall not be lia-
ble for any damage resulting from unauthorized product modication.
Electrical safety
• Before starting any work on the MQTT.box, completely disconnect the pow-
er supply by taking suitable measures and secure it against being switched on

9
again.
• Only use the device in closed and dry rooms.
• Do not expose the device to high ambient temperatures or direct sunlight. Ob-
serve restrictions with regard to the maximum ambient temperature.
• Keep ventilation openings free and maintain a distance of at least 10cm bet-
ween the MQTT.box and neighboring heat sources.
• Observe nominal values for input voltage and output currents.
• During installation, ensure that no free-hanging wires protrude into the interior of
the device. Make sure that no individual wires are sticking out of stranded wires.
Use wire end ferrules.
• Screw the terminals tightly.
• Screw down unused terminals.
• Only use power supplies that ensure safe isolation of the low-voltage side from
the supply mains in accordance with EN62368-1 and have „LPS“ property.
Electromagnetic compatibility
❗Note: Electromagnetic interference
To ensure electromagnetic compatibility, use only shielded network cables!
The MQTT.box meets the industrial limits for immunity as well as the stricter
emission limits for household and small business. There are no EMC-based
restrictions with regard to the usability of the devices in these environments.
Conformity to standards
📚Complete declarations of conformity
The complete declarations of conformity for your device can be found on the asso-
ciated online data sheet at 🌎www.wut.de/55990
The MQTT.box is compliant with the following standards and normative documents:
• EN 55032: 2012 Kl. B
• EN 61000-3-2: 2014
• EN 61000-3-3: 2013
• EN 61000-4-2: 2009
• EN 61000-4-3: 2006 + A1: 2008 + A2: 2010
• EN 61000-4-4: 2012
• EN 61000-4-5: 2014 +A1

10
• EN 61000-4-6: 2014
• EN 61000-4-8: 2010
• EN 61000-4-11: 2004
• EN 61000-6-2: 2005
• EU Directive 2011/65/EU (RoHS)
Storage
Store the MQTT.box in a dry room. Make sure to comply with the ambient condi-
tions. The temperature must be between -40°C and +70°C, the humidity must not
exceed 95% rel. humidity. We recommend storage in the original packaging.
Transportation
No special restrictions apply with regard to transport. To protect the product from
mechanical stress, we nevertheless recommend transporting it exclusively in its ori-
ginal packaging.
Disposal
Electronic devices must not be disposed of with household waste, but must
be taken to a professional electronic waste disposal. The MQTT.box is marked
according to 2012/19/EU on waste electrical and electronic equipment. This
directive regulates the Europe-wide take-back and recycling of waste electronic
equipment. You can dispose of the device via existing collection and return systems
or return it to your specialist dealer.

11
2. Product information
Manufacturer
Wiesemann & Theis GmbH
Porschestr. 12
42279 Wuppertal
Germany
Tel: [phone]
Fax: [phone]
E-Mail: [email protected]
🌎www.wut.de
WEEE registration: DE 77008276
BattG registration: 21000788
Product labeling
The unique identication of the product type is done via the article number on the
device label. The unique device identication is found in the form of the MAC ad-
dress on the underside of the device. This consists of twelve characters (six bytes in
hexadecimal representation), starting with the manufacturer identication 00:c0:3d.
The following 6 characters uniquely identify your device.
ℹDamage to or loss of the device label
Part number and MAC address can be read out via the web interface and via the Wu-
Tility tool (🌎www.wut.de/wutility) if the device label is damaged or lost.
Scope of delivery
The scope of delivery includes:
• MQTT.box (#55990)
• Connector (#11111)
• Quick guide
• Device passport
• Risk information

12
Accessories and spare parts
For reliable operation we recommend the use of original W&T accessories:
Connector (#11111)
2-pole, 5.08 mm pitch for power supply connection
🌎www.wut.de/11111
Power supply with Euro plug (#11021)
Output: 24V DC, 500mA, energy efciency: Level VI, no-load power < 0.075W
🌎www.wut.de/11021
15 Watt Top Hat Rail Power Supplyl (#11080)
Universal LPS power supply with wide range input 100-240V, 1 TE
🌎www.wut.de/11080
Ethernet-Switch Industrie, 4 Port (#55604)
Industrial PoE switch with four ports
🌎www.wut.de/55604
Symbols on the products
Symbol Explanation
CE marking
The product complies with the requirements of
the applicable EU directives.
WEEE marking
The product must not be disposed of with
household waste, but in accordance with the
disposal regulations for electrical waste appli-
cable at the place of installation.

13
3. Installation
👥Installers
The following section is intended for the installers of the MQTT.box and assumes
appropriate expertise.
Mounting in the control cabinet
⛳Mount on top hat rail
❗Note: Risk of property damage imminent
Please observe the safety instructions in chapter 1.
The MQTT.box can be mounted on DIN rail (TH 35).
1. Place the MQTT.box slightly angled upwards with the receptacle on the up-
per edge of the top-hat rail.
2. Press the device against the top-hat rail from the top front until the holder
clicks into place.
The MQTT.box is now rmly mounted on top-hat rail.
Set up power supply
⛳Set up power supply via PoE
The MQTT.box can be electrically supplied via network socket 1 as a device of
power class 2 via PoE according to IEEE802.3af. For this you need
• A PoE switch or a PoE injector
1. Connect the network socket 1 of the MQTT.box to the PoE switch / the PoE
injector via a shielded network cable.
The MQTT.box starts operation.

14
⛳Set up power supply via external power supply unit
⚠ WARNING 0Danger to life due to electric current
The use of an incorrect power supply can lead to accidents with electric current
and re
🢂Only use power supplies according to the specication
🢂Observe documentation
🢂Observe safety regulations
The MQTT.box can be supplied with voltage via an external power supply
unit. Such a power supply must be potential-free and the reference ground for
the output voltage must not have a direct connection to the protective earth.
Furthermore, a safe isolation between the extra-low voltage side and the supply
network according to EN60950-1, as well as LPS property are mandatory.
• a power supply unit that meets the specications (see Accessories
section)
• a screwdriver
1. Attach the green terminal adapter to the power supply unit
2. Plug the green terminal adapter into the socket on the device
The MQTT.box starts operation.
Connect network cable
The MQTT.box is equipped with two network interfaces. These network interfa-
ces can be congured independently in the user interface. For the connection to
a network you need:
• a patch cable
1. Connect the MQTT.box via a patch cable to the network in which you want to
integrate the device.
The MQTT.box is connected to the network.
4. Commissioning
👥Network Administrator
This section is intended for network administrators and assumes knowledge of net-
work conguration. If you as a user do not know what to do with the steps described
here, please contact your system administrator.
Make network settings
To perform the tasks described below, you will need the following information:
• MAC addresses of the devices to be congured
• Network parameters of the device to be congured: IP addresses, subnet deni-
tions, gateways, DNS and time servers.
⛳ Make network settings via the WuTility
In this section, you assign a basic network conguration to the MQTT.box using
the WuTility conguration software. If you want to congure multiple devices,
make a note of the respective MAC addresses, which you can nd on the bottom
of the device. For the implementation you need:
• a current web browser
• the software WuTitliy (🌎www.wut.de/wutility)
1. Open the Wutility
2. Select the device you want to congure by its MAC address from the list of
available devices.
3. In the toolbar at the top, click the IP Address button
4. Set the desired network parameters
5. Click Next
The MQTT.box adopts its setting and then restarts.
⛳Make network settings via DHCP
If automatic conguration via DHCP is enabled in your network, your box will ob-
tain a conguration after you have connected it to the network. To nd out the IP
address of your MQTT.box, you need either
• Access to the leases of your DHCP server, for example via the log le
or via the display of network subscribers on your router.
• the software WuTitliy (🌎www.wut.de/wutility)

15
4. Commissioning
👥Network Administrator
This section is intended for network administrators and assumes knowledge of net-
work conguration. If you as a user do not know what to do with the steps described
here, please contact your system administrator.
Make network settings
To perform the tasks described below, you will need the following information:
• MAC addresses of the devices to be congured
• Network parameters of the device to be congured: IP addresses, subnet deni-
tions, gateways, DNS and time servers.
⛳ Make network settings via the WuTility
In this section, you assign a basic network conguration to the MQTT.box using
the WuTility conguration software. If you want to congure multiple devices,
make a note of the respective MAC addresses, which you can nd on the bottom
of the device. For the implementation you need:
• a current web browser
• the software WuTitliy (🌎www.wut.de/wutility)
1. Open the Wutility
2. Select the device you want to congure by its MAC address from the list of
available devices.
3. In the toolbar at the top, click the IP Address button
4. Set the desired network parameters
5. Click Next
The MQTT.box adopts its setting and then restarts.
⛳Make network settings via DHCP
If automatic conguration via DHCP is enabled in your network, your box will ob-
tain a conguration after you have connected it to the network. To nd out the IP
address of your MQTT.box, you need either
• Access to the leases of your DHCP server, for example via the log le
or via the display of network subscribers on your router.
• the software WuTitliy (🌎www.wut.de/wutility)

16
1. Open the log le of your DHCP server or the overview of the network partici-
pants at your router to determine its IP address based on the MAC address
of the MQTT.box.
2. If necessary, congure a xed lease for the MQTT.box so that it is always
accessible under the same IP address.
The MQTT.box can now be reached via the IP address assigned by the DHCP
server.
⛳Make network settings via the default IP
In this section, you assign an IP conguration to the MQTT.box via the
web interface. To do this, use the preset default IP of the device. For the imple-
mentation you need:
• Administration rights for the network interface of your PC
• a current web browser
1. Assign a temporary or secondary IP conguration to your network interface
on network 190.107.233/24.
2. Open your web browser.
3. Enter the IP address 190.107.233.110 in the address line.
4. Log in as an administration user.
5. Click on Basic Settings.
6. Click Network.
7. Enter the desired network conguration.
8. Click the Save button at the bottom right.
The MQTT.box adopts your setting and is accessible via the assigned IP ad-
dress.
Call web interface
⛳Calling up the web interface via IP address
The web interface can be accessed via the IP address of the MQTT.box.
1. Open your web browser.
2. Enter the IP address of the MQTT.box in the address bar.
The web interface is displayed.
⛳Calling up the web interface via the WuTility
The web interface can be accessed via the WuTility.
1. Open the WuTility.
2. Select the device whose web interface you want to access from the list of

17
available devices.
3. Click the Browser button in the toolbar at the top.
The web interface of the MQTT.box is opened in your web browser.
⛳Make language settings
The web interface is available in German and English translation.
1. Click the circle with the country ag in the upper right corner of the web in-
terface.
2. Select the language in which you want the web interface to be displayed ba-
sed on the country ag.
The language of the web interface changes.
Make further settings via the web interface
General notes on the web interface
All other settings of the MQTT.box are made in the administration area of the web
interface. Here you will nd the following controls:
• Crumb navigation (top)
• Administration menu (left)
• Save button
• Reload button
• Buttons in dialog boxes
⛳Log in administration user
To make settings via the web interface, you must rst log in as an administration
user. No password is set in the delivery state.
1. Call up the web interface.
2. Click the Login button in the upper right corner of the user interface.
3. Specify the password for the administration user, if you have assigned one.
4. Click Login.
You can now make settings via the web interface.
⛳Configure second network interface
The device can be connected to another network segment via the second net-
work interface.
1. Log in to the web interface as an administration user.
2. Click Network in the Basic Settings section of the Administration menu.

18
3. Make the conguration of the second network interface.
4. Click Save to apply the changes.
The second network interface can now be used.
⛳Set date and time
ℹManually set time is not stored permanently
Note that a manually entered time will be lost after a few days if the power supply is
interrupted.
The MQTT.box is set in the delivery state so that the time is automatically ob-
tained from 🌎ntp.org when Internet access is functioning. Alternatively, you can
congure your own time servers or specify the time manually.
1. Open the web interface as an administration user.
2. Click the Basic Settings button in the Administration menu.
3. Then click Date and Time.
4. Activate the External time server option and specify up to two time servers.
Alternatively, deactivate the External time server function and specify the
current time in Manual conguration.
5. Select the time zone that applies to the device location.
6. Click Save.
The MQTT.box takes over the conguration for date and time.
⛳Change device information
The MQTT.box displays information about the device and the manufacturer on
the web interface. In the delivery state, this information refers to the product and
to Wiesemann & Theis as the manufacturer. You can customize this information,
for example if you use the MQTT.box as a component in your own product.
1. In the administration area, under the Basic settings menu item, select Infor-
mation.
2. Enter details about the product in the Device Information area.
3. In the Manufacturer Information area, enter information about the manufac-
turer.
4. Save the changes.
On the start page of the MQTT.box, the changed information is displayed under
the menu item „Properties“.

19
⛳Set/change login password
❗Note: Danger from cyber attacks
No login password is set in the factory setting. To prevent unauthorized access, you
should set a secure password for the administration area.
To protect the MQTT.box from unauthorized access, the administration area can
be protected by a password.
• To set or change a password for the administration area, you must be
logged in to the administration area.
1. Select Password in the left menu under the Basic Settings item.
2. To set a password for the rst time, click the Set password button. If a pass-
word is already set, click the Change password button.
3. Enter the new password in the dialog box and conrm it by entering it again.
4. Then click the Save button.
The administration area of the MQTT.box is now password protected.

20
5. Conguration of the MQTT broker
📚Introduction to the MQTT protocol
These instructions cover the commissioning and conguration of the MQTT.box. For
an overview of the functionality and various application scenarios for the MQTT pro-
tocol, see our topic page 🌎www.wut.de/mqtt.
Basic settings for the MQTT service
⛳Enable MQTT broker
To use the MQTT service, you must enable it.
1. Open the web interface as an administration user.
2. Click the Broker button in the Administration menu under the MQTT Settings
item.
3. In the Broker area, select the Enable checkbox.
4. Click Save.
The MQTT service is started.
⛳Configure MQTT port
The default port assigned by IANA for the unencrypted MQTT service is port
1883. For TLS-encrypted MQTT, the default port is 8883. You can customize the-
se ports for your needs.
1. Click the Broker button in the left menu under the MQTT Settings item.
2. In the Broker area, specify the desired port in the MQTT Port eld.
3. Click the Save button to apply the changes.
The MQTT port is now congured.