background image

20

 

5. Configuration of the MQTT broker

📚

  Introduction to the MQTT protocol

These instructions cover the commissioning and configuration 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

 field.

3. 

Click the 

Save

 button to apply the changes.

The MQTT port is now configured.

Summary of Contents for MQTT.box

Page 1: ...MQTT box valid for the product 55990 MQTT box v1 04 17 06 2021 english Operating instructions Commissioning and application ...

Page 2: ...understandings 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 ...

Page 3: ...rtation 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 ne...

Page 4: ...e login password 19 5 Configuration of the MQTT broker 20 Basic settings for the MQTT service 20 Enable MQTT broker 20 Configure 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 C...

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

Page 6: ...f 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 ind...

Page 7: ...et group Instructions for action Tasks for achieving specific 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 first a...

Page 8: ... contained therein Qualified 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 inten...

Page 9: ...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 wit...

Page 10: ...h 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...

Page 11: ...s 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 identification 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 d...

Page 12: ...op 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 w...

Page 13: ...ith 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 firmly 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 ...

Page 14: ...ore 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 specifications 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 c...

Page 15: ...igure multiple devices make a note of the respective MAC addresses which you can find 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 configure 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 ...

Page 16: ...sign a temporary or secondary IP configuration 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 configuration 8 Click the Save button at the bottom right The MQTT box adopts your setting and is accessible via ...

Page 17: ...a of the web interface Here you will find 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 first 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 th...

Page 18: ...servers Alternatively deactivate the External time server function and specify the current time in Manual configuration 5 Select the time zone that applies to the device location 6 Click Save The MQTT box takes over the configuration 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 in...

Page 19: ... 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 first 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 confirm it by entering it again 4 Th...

Page 20: ...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 ...

Page 21: ... Plea se refer to their product documentation Afterwards the encrypted communica tion between MQTT box and the clients is established Set access rights for the MQTT service Access to the MQTT service can be granted in three different ways anonymous access Access with user name and password Access restrictions through access control lists ACL Note Danger from cyber attacks Allow anonymous access on...

Page 22: ...up ACLs to further restrict access rights Allow anonymous access By enabling the anonymous user any system can access the MQTT service wi thout having to authenticate 1 Open the web interface as an administration user 2 Click in the left menu under the item MQTT on the button User Management 3 Activate the Anonymous access option in the Authentication section 4 Click Save Anonymous systems can now...

Page 23: ... to the wildcards and you can also use the variables c for the client ID and u for the user name 6 Accept the entries with Add 7 Click Save The access restriction is now active MQTT Log The MQTT box records events of the broker and provides this data for evaluation The following event types are available Error Error Warning Circumstances that can lead to errors Notice Notes that are worth noting I...

Page 24: ... 3 Press the DOWNLOAD MQTT LOG button to download the log outputs You will now find the log file named mqtt log in your download folder Empty log outputs Log outputs that are no longer needed can be deleted 1 In the administration navigation under the MQTT section open the Log menu item 2 Press the Clear Log button The memory is now cleared and the recording of events starts again from the beginni...

Page 25: ...from the housing body 5 Pull off the front cover You can now pull the board out of your guide to perform maintenance Restore factory settings on the hardware side Using a jumper inside the device the MQTT box can be reset to factory settings 1 Open the housing of the MQTT box according to the previous instructions 2 Pull the board out of the guide 3 In the center of the board you will find two jum...

Page 26: ...e software WuTitliy www wut de wutility the latest firmware for your product www wut de 55990 1 Download the latest firmware from the above Internet address 2 Unzip the zip file 3 Open the WuTility 4 Select the device whose firmware you want to update from the list of availa ble devices 5 Click the Firmware button in the toolbar 6 Select the UHD file with the current firmware 7 Click Next to perfo...

Page 27: ...27 3 Confirm the restart in the following dialog After a successful restart the web interface is reloaded ...

Page 28: ...he MQTT box there is a black tab at the height of the DIN rail Use the screwdriver to pull it down 3 Tilt the front of the MQTT box upwards to lift the device from the DIN rail You can now maintain store or dispose of the MQTT box Proper disposal Electrical appliances must not be disposed of with household waste 1 Please dispose of the MQTT box at the local collection point or return it to your sp...

Page 29: ...ver Ethernet PoE or 24 48V DC 10 per screw terminal Current consumption PoE Class 2 3 84 6 49W typ 140mA at 24V DC external supply Displays LEDs for system error and network status Hardware and software Processor and memory Marvell 88F6820 Flash 4GB eMMC RAM 1GB DDR3 MQTT broker Mosquitto Housing and other data Housing Plastic housing with integrated DIN rail mounting 105 x 22 x 77mm L x W x H Wei...

Page 30: ...30 Wiesemann Theis GmbH Porschestraße 12 D 42279 Wuppertal Mail info wut de Web www wut de Tel 49 0 202 2680 110 Fax 49 0 202 2680 265 ...

Reviews: