The information related to the PROFINET IO Connector is split between two topics: the status topic and the info topic. The status topic provides an interface as defined in Siemens Cloud's Industrial Edge System Apps Documentation for Developers (V1.2.2). This interface offers details about the application and its connections.
The additional live information of the PROFINET IO Connector is published to the info-topic.
The status messages are more clearly described and standardized, providing the status of the connector and the connections so that other applications can interpret and display relevant information.
Configuration
The status topic can be configured in the config json file as well as with the Common Configurator. For more information, refer Configuring PROFINET IO Connector Using Common Configurator.
The info-topic is not configurable: ie/s/j/simatic/v1/pnhs1/info
Example
For specific topic configurations, refer to the default MQTT topics for:
- For Controller Configuration, refer step no. 6 of Add data sources.
- For Device Configuration, refer step no. 6 of Add data sources.
For practical examples of JSON configuration for both Controller and Device, you can find detailed guidance in the following resources:
- For Controller Configuration example, refer Example of JSON Configuration for Controller.
- For Device Configuration example, refer [Example of JSON Configuration for Device](../configuring-profinet-io-connector-as-pn-device/example-of-json-configuration-for-device.md.
Status values
Since the status message is defined, there are following possible values for the connector and connection:
| Connector | Description |
|---|---|
| Good | Connector is running properly |
| Bad | Run without config - no functionality |
| Available | Connector just started up |
| Unavailable | Connector has stopped |
| Connection | Description |
|---|---|
| Good | Connection is established |
| Stopped | Connection is not established |
| Bad | Connection has error |
Example
Defined status message of the PROFINET IO Connector is as follows:
{
"seq": 3,
"ts": "2023-01-11T07:02:15.1232539Z",
"connector": {
"status": "good",
"reason": "ok"
},
"connections": [
{
"name": "plcxb1d0ed (station'1' slot'1' laddr'261')",
"status": "good",
"reason": "ok"
},
{
"name": "unknown (station'2' slot'0' laddr'267')",
"status": "stopped",
"reason": "ok"
}
]
}
The following info message gives additional details in controller mode:
{
"pn-controller": {
"name": "profinetxadriver4933",
"order-no": "6ES7195-3AA00-0YA0",
"sw-version": "PROFINET-IO-Connector V2.1.0.0-R",
"ip-addr": "192.168.4.102",
"ip-addr-num": [192, 168, 4, 102]
},
"stations": [
{
"name": "plcxb1d0ed",
"station-no": 1,
"ip-addr": "192.168.4.10",
"ip-addr-num": [192, 168, 4, 10],
"submodules": [
{
"slot-no": 1,
"laddr": 261,
"order-no": "6ES7 510-1DJ01-0AB0",
"sn": "S C-K3L994142018",
"pn-addr-out": [0, 3],
"status": "online",
"status-num": 3
}
]
},
{
"name": "",
"station-no": 2,
"ip-addr": "",
"ip-addr-num": [0, 0, 0, 0],
"submodules": [
{
"slot-no": 1,
"laddr": 271,
"order-no": "",
"sn": "",
"pn-addr-in": [32, 32],
"status": "offline",
"status-num": 2
}
]
}
]
}
The following info message gives additional details in device mode:
{
"pn-device": {
"name": "pn-io-conn-device",
"sw-version": "PROFINET-IO-Connector V2.1.0.0-R"
},
"controllers": [
{
"ip-addr": "192.168.4.10"
}
]
}