Messaging

Usage notes

When you forward messages, take note of the following items:

• You can use only the new version of the data forwarding feature to configure data forwarding rules for cloud gateway devices. For more information, see Configure a data forwarding parser.

• You cannot subscribe to topics for GB/T 32960 cloud gateway devices. Therefore, you cannot forward the data of GB/T 32960 cloud gateway devices from a topic to another topic.

• If you want to forward the messages of GB/T 32960 cloud gateway devices, you can add the following types of topics as a data source: Custom, Device Status Change Notification, and Device Changes Throughout Lifecycle. If you want to add a custom topic as a data source, you must specify the Vehicle Identification Number (VIN) of the vehicle in the topic name. For more information, see Add a data source.

• You can use server-side subscriptions to push only the following types of data: Device Upstream Notification, Device Status Change Notification, and Device Changes Throughout Lifecycle. For more information, see Configure an AMQP server-side subscription.

Device logon

Topic: /sys/${productKey}/${deviceName}/device/message/uplink.

{
    "header": {
        "command": 1,
        "responseFlag": 254,
        "vin": "onepart1234567891"
    },
    "body": {
        "iccid": "12345678901234567890",
        "month": 3,
        "hour": 16,
        "year": 23,
        "subSystemNumber": 2,
        "systemEncode": [
            "12345678",
            "87654321"
        ],
        "systemEncodeLength": 8,
        "day": 21,
        "serialNo": 1,
        "minute": 20,
        "second": 12
    }
}

Submit device status

Topic: /sys/${productKey}/${deviceName}/device/status/notify.

• Format of data that is submitted by a device when the device goes online:

  {
      "protocol": "gb32960",
      "status":"online",
      "iotId":"4z819VQHk6VSLmmBJfrf00107e****",
      "productKey":"al12345****",
      "deviceName":"deviceName1234",
      "time":"2018-08-31 15:32:28.205",
      "utcTime":"2018-08-31T07:32:28.205Z",
      "lastTime":"2018-08-31 15:32:28.195",
      "utcLastTime":"2018-08-31T07:32:28.195Z",
      "clientIp":"192.0.2.1"
  }

• Format of data that is submitted by a device when the device goes offline:

  {
      "protocol": "gb32960",
      "status":"offline",
      "iotId":"4z819VQHk6VSLmmBJfrf00107e****",
      "offlineReasonCode":427,
      "productKey":"al12345****",
      "deviceName":"deviceName1234",
      "time":"2018-08-31 15:32:28.205",
      "utcTime":"2018-08-31T07:32:28.205Z",
      "lastTime":"2018-08-31 15:32:28.195",
      "utcLastTime":"2018-08-31T07:32:28.195Z",
      "clientIp":"192.0.2.1"
  }

Parameter description

Device data submission

Topic: /sys/${productKey}/${deviceName}/device/message/uplink.

{
    "header": {
        "command": 123,
        "responseFlag":1,
        "vin":""
    },
    "body": {
        "data":""
    }
}

Device unregistration

Topic: /sys/${productKey}/${deviceName}/device/message/uplink.

{
    "header": {
        "command": 4,
        "responseFlag": 254,
        "vin": "onepart1234567891"
    },
    "body": {
        "month": 3,
        "hour": 16,
        "year": 23,
        "day": 21,
        "minute": 20,
        "second": 12,
        "serialNo": 1
    }
}