ThingsHub can act as a agent for the Cumulocity IoT platform, synchronize devices and send device data.

Integration Configuration

ParameterDescription
params.serverAddress of the Cumulocity instance.
params.usernameUsername for logging into Cumulocity.
params.passwordPassword for logging into Cumulocity.

Example

{
  "description": "cumulocity events demo integration",
  "name": "demo-events",
  "params": {
    "server": "https://smartmakers.cumulocity.com",
    "username": "user@smartmakers.de"
    "password": "super_protected",
  },
  "selector": {
    "$or": [
      "nke-s0"
    ]
  },
  "type": "Cumulocity"
}
JS

The server parameter value should contain protocol scheme (http:// or https://) `prefix`

Discovering data in Cumulocity

When integration is successfully created and running, all boolean values from message will be published as Events.

To observe Events in Cumulocity instance UI go to Devices → All devices → (select device) → Events.

Event object explained

Example of expanded event:

Every event from thingshub contains next data fields:

  • header: consists of value path and value reported ("binary_input/0/present_value/value reported true" in example above)
  • device: device reported event ("sm-nke-s0")
  • time: datetime event was sent by thingshub ("Time 15 Jan 2019 13:56:06")
  • server time: datetime event was created in Cumulocity ("Server creation time 15 Jan 2019 13:56:09")
  • type : indicates type of event. For events from thingshub it's always "Type thingshub_Event"
  • properties :  full message event was generated from ("Properties {"RawPayload":"110a000f00551001","binary_input":{"0":{"present_value":{"value":true}}}}")