Helmholz PN MQTT Manual Download Page 1

Page: 1 / 58

PN/MQTT Coupler

Manual

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

Link to newest version of
manual

Summary of Contents for PN MQTT

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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...

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Search results

Summary of Contents for PN MQTT

Reviews:

Helmholz PN MQTT, Manual, Page: 1 / 58

Search results

Summary of Contents for PN MQTT

Reviews: