Skip to content

Open Edge Device Kit – Configuration Updates

This section describes configuration messages published by the Open Edge Device Kit. They provide configuration updates, which have been made in MindSphere using Device Configuration Service. The Open Edge Device Kit obtains these updates using the Deployment Workflow Service. Modules running on devices must subscribe to the topics listed in this section.

Info

If the connection with MindSphere is interrupted, the Open Edge Device Kit receives and publishes configuration updates after the connection is re-established.

Device Configuration Update

Topic cloud/monitoring/update/configuration
Description Specifies the new device configuration downloaded by the Open Edge Device Kit.
Quality of Service 1
Retained TRUE

Sample Body:

1
2
3
4
5
6
{
  "jobid": "000-111-222",
  "device" : {
        ...
  }
}

After applying the new configuration, the Open Edge Device Kit expects a status message to be published via boxmanager/monitoring/opresult/configupdate with the provided ID and a status.

Application Configuration Update

Topic cloud/monitoring/update/configuration/{app_id}
Description Contains the new configuration for the specified Edge application. This message is published by the Open Edge Device Kit after the configuration has been changed in the MindSphere backend and published to the device. Every Edge application must subscribe to this channel, appended with its associated identifier.
Quality of Service 1
Retained TRUE

Sample Body:

1
2
3
4
{
  "job": { The Configuration Job },
  "fileContent" : "..."
}

After applying the new configuration, the Open Edge Device Kit expects a status message to be published via boxmanager/monitoring/opresult/configupdate with the provided ID and a status.

Data Source Configuration Update

Topic cloud/monitoring/update/configuration/{protocol}
Description Contains a new data source configuration. Modules reading data must subscribe to the topic using the protocol they are supposed to support.
Quality of Service 2
Retained FALSE

Sample Body:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
{
  "name": "GAIA",
  "description": "",
  "protocol": "MODBUS",
  "dataSourceId" "32D434ADS3"
  "readCycleInSeconds": "1",
  "protocolData": {
    "ipAddress": "192.168.0.211"
  },
  "dataPoints": [
    {
      "dataPointId": "1526635470331",
      "name": "byte_variable",
      "description": "",
      "unit": "PERCENT",
      "dataType": "INT",
      "dataPointData": {
        "address": "DB1.DBB150",
        "onDataChanged": false}
    },
    {
      "dataPointId": "1526635496767",
      "name": "float_variable",
      "description": "",
      "unit": "PERCENT",
      "dataType": "DOUBLE",
      "dataPointData": {
        "address": "DB1.DBREAL1800",
        "onDataChanged": false}
    },
    {
      "dataPointId": "1526635524797",
      "name": "int_variable",
      "description": "",
      "unit": "PERCENT",
      "dataType": "INT",
      "dataPointData": {
        "address": "DB1.DBW2830",
        "onDataChanged": false}
    }
  ]
}

Any questions left?

Ask the community


Except where otherwise noted, content on this site is licensed under the MindSphere Development License Agreement.