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.