background image

 

Helmholz GmbH & Co. KG | Hannberger Weg 2 | D-91091 Großenseebach | Germany 
Phone +49 9135 7380-0 | Fax +49 9135 7380-110 | [email protected] | www.helmholz.com 

PN/MQTT Coupler 

Manual 

Version 2 | 6/18/2021 | for firmware V1.04 and above 

 

 

 

 

Link to newest version of 
manual

 

Содержание PN MQTT

Страница 1: ...berger Weg 2 D 91091 Gro enseebach Germany Phone 49 9135 7380 0 Fax 49 9135 7380 110 info helmholz de www helmholz com PN MQTT Coupler Manual Version 2 6 18 2021 for firmware V1 04 and above Link to n...

Страница 2: ...e granting of a patent or the registration of a utility model To download the latest version of this manual please visit our website at www helmholz de We welcome all ideas and suggestions Copyright 2...

Страница 3: ...tion 11 3 2 PN MQTT Coupler Features 12 4 Installation and removal 13 4 1 Access restriction 13 4 2 Mounting and minimum distances 13 4 3 Electrical installation 13 4 4 Protection against electrostati...

Страница 4: ...33 12 Further functions in the web interface 34 12 1 Module status 34 12 2 Export Import of the configuration 34 12 3 Account 35 12 4 Upload TLS certificates for HTTPS 35 12 5 SNTP Settings 35 12 6 Fi...

Страница 5: ...Create AWS IoT Things 46 17 3 Configure PN MQTT Coupler for AWS Access 49 17 4 Testing the MQTT Connection in AWS 50 18 Application example Microsoft Azure 52 18 1 Create device in Azure 52 18 2 Confi...

Страница 6: ...y intended for trained personnel qualified in control and automation engineering who are familiar with the applicable national standards For installation commissioning and operation of the components...

Страница 7: ...e and health of people from electrical voltage If the warning is ignored there is a probable danger to life and health of people If the caution note is ignored people can be injured or harmed Draws at...

Страница 8: ...systems Problem free and safe operation of the device presumes proper transport storage setup assembly installation commissioning operation and maintenance The ambient conditions provided in the tech...

Страница 9: ...elmholz GmbH CO KG is not liable for damage caused by software that is running on the user s equipment which compromises damages or infects additional equipment or processes through the remote mainten...

Страница 10: ...Compendium of the Federal Office for Information Security BSI https www bsi bund de SharedDocs Downloads EN BSI ICS ICS Security_compendium html Physical access Limit physical access to components of...

Страница 11: ...ers the data to all subscribers when new data has arrived from the publisher Data is always transmitted under a freely definable identifier the Topic The Topic is a descriptive text e g Temperature In...

Страница 12: ...Broker In the cloud IoT systems such as HiveMQ Amazon IoT Microsoft Azure or Siemens Mind sphere in preparation can be connected directly For a description of how to connect to the various cloud syst...

Страница 13: ...ect all existing connections and contacting possibilities with commercially available accessories There is space for any necessary cable routing Installation must be carried out in accordance with VDE...

Страница 14: ...strial plants During operation all covers on the unit and the installation must be closed in order to ensure protection against contact When the PN MQTT Coupler is switched off bus connections are int...

Страница 15: ...hernet network in which the MQTT broker is accessible The ports X1 P1 and X1 P2 as well as X2 P1 and X2 P2 are each internally connected to a switch The interfaces X1 and X2 are logically separate net...

Страница 16: ...er Version 2 6 18 2021 16 5 3 network connector Pin signal RJ45 connector color Wire pair 1 TD Transmission Data Yellow 1 2 TD Transmission Data Orange 1 3 RD Receive Data White 2 4 5 6 RD Receive Dat...

Страница 17: ...L V2 35 Helmholz PN MQTT coupler ____ xml at www helmholz de or scan the QR code Install the GSDML file in the Tools Manage device description file GSD menu in the TIA Portal The PN MQTT Coupler can b...

Страница 18: ...Ethernet address for the device 7 1 Parameterization of the PN MQTT coupler The parameterization of the PN MQTT coupler is performed via the PROFINET hardware configurator e g TIA Portal The PROFINET...

Страница 19: ...function with DHCP and IP address from web page Static IP subnet mask If the address mode has been set to Static IP the subnet mask of the X2 network can be specified here This setting has no function...

Страница 20: ...y one value which is exchanged with the broker via its MQTT topic name A value is usually sent via MQTT in a readable form direct text or JSON formatted For this reason there are different representat...

Страница 21: ...can be specified Transmission without acknowledge 0 The topic is sent without an acknowledgement from the broker fire and forget Transmission with acknowledge 1 The topic is sent and an acknowledgeme...

Страница 22: ...Use the Update list button to search the network for PROFINET stations With Assign name the PROFINET device name can be assigned to the device The unique identification of the PN MQTT coupler is guar...

Страница 23: ...ssword must be assigned for the user admin with at least 8 characters After logging in you will see the Overview view The PN MQTT Coupler still shows Bus Error BF on the Overview page on the X2 interf...

Страница 24: ...n the same network as the PROFINET PLC see note in chapter 5 2 The necessary information for the connection with the MQTT broker can be made in the MQTT menu under MQTT Client Settings MQTT version Th...

Страница 25: ...piry interval Seconds MQTT 5 0 only In the context of Clean start if Session expiry interval is set to 0 the session is terminated when the network connection is closed Otherwise the session is kept o...

Страница 26: ...0xFFFF Unsigned Int 2 Bytes Decimal 0 65536 Signed Int 2 Bytes Decimal 32767 32787 Double Word 4 Bytes Hexadecimal 0x00000000 0xFFFFFFFF Unsigned double Int 4 Bytes Decimal 0 4294967295 Signed double...

Страница 27: ...of PN MQTT Coupler The PN MQTT coupler can be controlled via the following control bits 1 byte in the PROFINET output image Byte Bit 7 6 5 4 3 2 1 0 Output Byte 0 Clear MQTT Error Code MQTT Disconnec...

Страница 28: ...T menu under MQTT Encryption encryption can be activated certificates can be stored and self generated certificates can also be created Transport Layer Security TLS Disabled unencrypted data exchange...

Страница 29: ...ndshake Verify broker certificate Certificates contain an expiration date and must be updated regularly This option checks whether the broker certificate is still valid When using certificates for aut...

Страница 30: ...able see Chapter 18 If an encrypted and authenticated connection is to be established for a test setup with a local broker e g Mosquitto the PN MQTT coupler can create the certificates and the private...

Страница 31: ...MQTT menu 11 1 Topic Mode The topic mode determines how all configured topic messages are sent Usually each topic each configured module is sent or received individually as an MQTT message Topic Mode...

Страница 32: ...application please contact us The payload variants are constantly being expanded 11 2 Last Will Message The Last Will Message is an MQTT message to inform other clients about an improperly dis connect...

Страница 33: ...MQTT coupler when the coupler is ready for operation For this the coupler must be configured via PROFINET and the PLC must be in RUN The Communication Stopped message is always sent by the PN MQTT co...

Страница 34: ...are displayed If there is a configuration error the error is displayed in the Diagnostic message column 12 2 Export Import of the configuration The settings made on the web page can be saved on the P...

Страница 35: ...or secure access to the PN MQTT Coupler website a company certificate can be stored in the System menu under HTTPS Certificates This ensures that the call to the PN MQTT Coupler configuration web page...

Страница 36: ...nd select the storage location with Browse and start the firmware update with Submit The firmware file is then transferred decrypted and checked If the content is correct the firmware is burned into t...

Страница 37: ...to factory settings The PROFINET name and IP addresses are deleted communication with the PLC is stopped and the PLC detects a configuration error and may also go to stop 12 7 1 Reset to factory setti...

Страница 38: ...ice name is incorrect or there is no connection with the PROFINET controller No connection to the MQTT broker can be established Flashing PROFINET function LED flashing for finding the device is execu...

Страница 39: ...e are many more tools 14 1 MQTT Explorer The MQTT Explorer by Thomas Nordquist http mqtt explorer com is a very practical little tool for Windows Mac and Linux Besides a tidy interface hierarchical di...

Страница 40: ...The test broker can be addressed with MQTT V3 1 1 as well as with MQTT V5 The easiest way to reach the test broker is unencrypted port 1883 Details on usage are explained on the Mosquitto test broker...

Страница 41: ...two versions can be run on your own servers on premise or used as a cloud service by HiveMQ 16 1 Use of HiveMQ in a virtual machine An out of the box trial version of the enterprise version HiveMQ so...

Страница 42: ...l for testing and small use cases In addition a professional cluster with full functionality can be tested free of charge for a few days in the Starter model You can access the Cluster Detail via Mana...

Страница 43: ...ID can be any Under Username and Password accept the values entered in the MQTT Credentials Under Broker address copy the HiveMQ URL Set Broker Port to 8883 The remaining settings can be selected as d...

Страница 44: ...ler makes it very easy to transfer data directly to the Amazon Cloud AWS The AWS IoT Core component is an MQTT broker in the AWS Cloud MQTT messages can be sent directly to AWS IoT Core and then proce...

Страница 45: ...QTT Coupler under Secure Policies and assign a name for the policy Give the policy a name and enter iot for Action for Resource ARN and check Allow for Effect Switch to the Advanced mode and check the...

Страница 46: ...rsion 2 6 18 2021 46 17 2 Create AWS IoT Things Under Manage Things select Create a single thing Give the Thing a name The other fields on this page are not relevant for now In the next dialog select...

Страница 47: ...Thing public key and private key and keep them in a safe place they cannot be reloaded Additionally download the root certificate root CA from AWS For this sample application use the RSA 248 bit key A...

Страница 48: ...ct the policy created at the beginning and create the device with Register Thing The device now appears in the list of Things Click on the device and select Interact in the next dialog Copy the access...

Страница 49: ...connect to AWS IoT Core it is mandatory to specify a gateway and DNS server in the IP Settings On the PN MQTT Coupler website the following settings must now be made in the MQTT menu under MQTT Clien...

Страница 50: ...he AWS IoT Core 17 4 Testing the MQTT Connection in AWS To check whether the data exchange with the PN MQTT Coupler works via MQTT MQTT Test Client can be called in the AWS IoT Core Under Thing select...

Страница 51: ...e test is successful the configuration is complete For the connection with amazon AWS it is mandatory to specify a gateway and a DNS server in the IP settings To check that the certificates are up to...

Страница 52: ...an IoT Hub must first be created Choose an appropriate subscription For a new AWS account the Free Trial can be used if applicable The IoT Hub name can be chosen arbitrarily In the next dialog the de...

Страница 53: ...PN MQTT Coupler Version 2 6 18 2021 53 Then select the newly created IoT Hub In the menu tree select IoT devices at the bottom left and create a new device with New at the top...

Страница 54: ...n the following dialog you can give the device a device ID The other settings can be used unchanged important are the options Symmetric key and Generate key automatically Select the device Copy the Pr...

Страница 55: ...nder MQTT Encryption The Primary connection string from the clipboard see previous page must be entered as the Azure connection string As Expiration date and Expiration time a time in the future must...

Страница 56: ...ID messages devicebound The device ID of the device created in Azure must be specified correctly here e g devices PNMQTTCoupler messages events If all settings are correct the PN MQTT Coupler should...

Страница 57: ...can be seen in the IoT Hub overview under IoT Hub usage The active connections and the number of messages used are displayed there Additionally you can view the received messages in the Azure Console...

Страница 58: ...RJ45 integrated switch Protocol MQTT V3 1 1 V5 Transmission rate 10 100 Mbit s full half duplex Status indicator 9 LEDs function status 8 LEDs Ethernet status Voltage supply DC 24 V 18 28 V DC Curren...

Отзывы: