When working with connectors on Industrial Edge, the Databus app is required to exchange the data via MQTT. The configuration of the connectors is done via the Common Configurator app. Therefore also the IIH Registry Service app is necessary, to find installed connectors on an Industrial Edge Device.
Make sure the following apps are installed and running on the Industrial Edge Device (IED):
- Databus
- Common Configurator
- IIH Registry Service
The Ethernet IP Connector app must be available in your IEM catalog. Proceed the following steps to install the app on your IED:
- open the catalog in the IEM
- select the Ethernet IP Connector
- click 'Install'
- in the tab 'Configurations' click 'Next'
- in the tab 'Devices' choose your IED
- click 'Install Now'
- click 'Install' to allow the installation
The system app Databus is essential to exchange data between a PLC and the IED. The Ethernet IP Connector sends the transfered data to the Databus on the IED. From there the data can be used for further processing.
You need to create a user and one or more topics in the Databus configuration, which cover the Ethernet IP data:
- ie/m/j/simatic/v1/eip1/dp for Ethernet IP metadata
- ie/d/j/simatic/v1/eip1/dp/# for Ethernet IP data
Therefore follow these steps:
- open the Industrial Edge Management (IEM)
- go to 'Data Connections' > Databus
- select the corresponding IED
- create the topic
ie/#
and a dedicated user with username and password ('edge'/'edge'), set permissions to 'Publish and Subscribe' - deploy the configuration and wait for the job to be finished successfully
With the Common Configurator, you can configure several connectors and publish the data to the Databus. Therefore, you must enter the Databus credentials within the Common Configurator:
- open the IED web interface
- open the app Common Configurator
- go to the tab 'Settings' and select the menu 'Databus credentials'
- in the Common Configurator settings enter the databus service name: 'ie-databus:1883'
- in the Common Configurator settings under the tab 'Data Publisher settings' enter the databus user name and password ('edge'/'edge')
- in the Common Configurator settings under the tab 'Data Subscriber settings' enter the databus user name and password ('edge'/'edge')
- Save the settings
As soon as the Ethernet IP Connector is installed and started on the same IED as the Common Configurator, the connector is visible within the configurator. In this example we want to configure an EtherNet/IP connection to a CompactLogix PLC (Allen-Bradley). To configure the Ethernet IP Connector, proceed as following:
- go to the tab 'Get data' and select tab 'Connector Configuration'
- select the Ethernet IP Connector
- switch to tab 'Tags'
- choose 'Add data source'
- configure the PLC accordingly and save
- under tab 'Tag' of the newly created PLC, choose 'Add tag'
- configure a tag as needed and save
-
Add the three tags that mentioned bellow and select the newly created Datasource 'Compactlogix'
- Counter_INT
- Var_BOOL
- Var_REAL
-
For writing the tag values onto the MQTT databus you need to ctivate and confirm the 'Publish on the databus' option for each tag. And click Deploy
- back on the overview page 'Available connectors', the status of the Ethernet IP Connector should be shown as connected
Now data can be transferred via the Ethernet IP connection. Please find more information in the Usage documentation.