{"en_US": {"title": "Message type", "content": "The RINGA server subscribes to the message queue and uses a newly defined message format. The message format is divided into two layers: the outermost layer defines superMsg for message supersets and for message categorization. For example, after a device goes online, superMsg is the device status change notification (600) and msgT is deviceOnline. This topic describes the latest message formats and types in server-side subscriptions.\n\n## Format Description\n\nThe data format of a message queue is divided into two layers:\n\n* The format of the first layer is as follows\n\n```js\n#msg\n{\n \"superMsg\": \"message set\",\n \"PV\": \"protocol version\",\n \"t\": \"the system time of pushing to the developer\",\n \"data\": \"business data pushed to developers\",\n \"sign\": \"the message sign\"\n}\n```\n\n* The format of the 2nd layer message is as follows: data at 1st layer, which needs to be decrypted and used in JSON format. [Data Decryption Method](/doc/v5/fuse/detail/539)\n\n![](/fuse/middlelayer/file/download?file=LNIIrCvgB6iexG0csjUC.png)\n\n## Message sets and message types\n\n| Message set (superMsg) | Message Type (msgType)|\n| --- | --- |\n| Device Status Change Notification (600) | deviceOnline, deviceOffline|\n| Device Management(601) | Device Creation (deviceCreate) and Device Delete (deviceDelete) |\n| Device Data Reporting(602) | thingProperty, thingEvent, dataPoints|\n| Device Response Notification (603) | Thing model Service Call Response (thingServiceReply), NB Device Cache Command Delivery Response (NBcommandCacheReply), Device Image Update Notification (deviceImagePropertyUpdate) |\n| Linkage Rules(620) | SceneLog |\n* * *\n\n## Message format\n\n2nd layer message format description\n\n* The general format of the 2nd layer is as follows\n\n```js\n#msg.data\n{\n \"msgType\": \"message type\", //message type,described as follow\n \"subData\": {\n \"dataType\": \"dataValue\",\n // ...\n }\n}\n```\n\n## deviceOnline\n\n| Field | Field Type | Description |\n| --- | --- |---- |\n| productId | string |product id |\n| deviceName | string | Device name |\n| deviceId | string |device id|\n| imei | string | Device IMEI |\n| time | Long |on-line time, timestamp |\n\n**DATA EXAMPLES**\n\n```json\n{\n \"msgType\": \"deviceOnline\",\n \"subData\": {\n \"deviceId\": \"50103***\",\n \"deviceName\": \"LwM2M-I***\",\n \"imei\": \"202110********\",\n \"productId\": \"rY5iZ****\",\n \"time\": 1703581741909\n }\n}\n```\n\n## deviceOffline\n\n| Field | Field Type | Description |\n| --- | --- |---- |\n|productId | string |product id |\n| deviceName | string | Device name |\n| deviceId | string |device id|\n| imei | string | Device IMEI |\n| time | Long |Offline time, timestamp |\n\n**DATA EXAMPLES**\n\n```json\n{\n \"msgType\": \"deviceOffline\",\n \"subData\": {\n \"deviceId\": \"50103***\",\n \"deviceName\": \"LwM2M-I***\",\n \"imei\": \"202110********\",\n \"productId\": \"rY5iZ****\",\n \"time\": 1703581741909\n }\n}\n```\n\n* * *\n\nDevice Management (601)\n\n## Device Create\n\n| Field | Field Type | Description |\n| --- | --- |---- |\n| productId | string |product id |\n| deviceName | string | Device name |\n| deviceId | string |device id|\n| imei | string | Device IMEI |\n| time | Long |Create time, timestamp |\n\n**DATA EXAMPLES**\n\n```json\n{\n \"msgType\": \"deviceCreate\",\n \"subData\": {\n \"deviceId\": \"50103***\",\n \"deviceName\": \"LwM2M-I***\",\n \"imei\": \"202110********\",\n \"productId\": \"rY5iZ****\",\n \"time\": 1703581741909\n }\n}\n```\n\n* * *\n\n## Device Delete\n\n| Field | Field Type | Description |\n| --- | --- |---- |\n| productId | string |product id |\n| deviceName | string | Device name |\n| deviceId | string |device id|\n| imei | string | Device IMEI |\n| time | Long |delete time, timestamp |\n\n**DATA EXAMPLES**\n\n```json\n{\n \"msgType\": \"deviceDelete\",\n \"subData\": {\n \"deviceId\": \"50103***\",\n \"deviceName\": \"LwM2M-I***\",\n \"imei\": \"202110********\",\n \"productId\": \"rY5iZ****\",\n \"time\": 1703581741909\n }\n}\n```\n\n* * *\n\nDevice Data Reporting(602)\n\n## thingProperty\n\n| Field | Field Type | Description |\n| --- | --- |---- |\n| productId | string |product id |\n| deviceName | string | Device name |\n| deviceId | string |device id|\n| imei | string | Device IMEI |\n| params |map |Thing model Property Data|\n\n**DATA EXAMPLES**\n\n```json\n{\n \"msgType\":\"thingProperty\",\n \"subData\":{\n \"deviceId\": \"50103***\",\n \"deviceName\": \"LwM2M-I***\",\n \"imei\": \"202110********\",\n \"productId\": \"rY5iZ****\",\n \"params\": {\n \"Power\": {\n \"value\": \"on\",\n \"time\": 1524448722123\n },\n \"WF\": {\n \"value\": 23.6,\n \"time\": 1524448722123\n }\n }\n }\n}\n```\n\n## Thing model Event (thingEvent)\n\n| Field | Field Type | Description |\n| --- | --- |---- |\n| productId | string |product id |\n| deviceName | string | Device name |\n| deviceId | string |device id|\n| imei | string | Device IMEI |\n| params |map |Thing model Event Data|\n\n**DATA EXAMPLES**\n\n```json\n{\n \"msgType\":\"thingEvent\",\n \"subData\":{\n \"deviceId\": \"50103***\",\n \"deviceName\": \"LwM2M-I***\",\n \"imei\": \"202110********\",\n \"productId\": \"rY5iZ****\",\n \"params\": {\n \"Power\": {\n \"value\": \"on\",\n \"time\": 1524448722123\n },\n \"WF\": {\n \"value\": 23.6,\n \"time\": 1524448722123\n }\n }\n }\n}\n```\n\n## DataStream - DataPoints\n\n| Field | Field Type | Description |\n| --- | --- |---- |\n| productId | string |product id |\n| deviceName | string | Device name |\n| deviceId | string |device id|\n| imei | string | device imei |\n| datastreamId |string |data point id |\n|value |object | device upload value |\n| time |Long |reporting time, timestamp|\n\n**DATA EXAMPLES**\n\n```json\n{\n \"msgType\":\"dataPoints\",\n \"subData\":{\n \"deviceId\": \"50103***\",\n \"deviceName\": \"LwM2M-I***\",\n \"imei\": \"202110********\",\n \"productId\": \"rY5iZ****\",\n \"datastreamId\": \"3_0_26261\",\n \"time\": 1703580644076,\n \"value\": 2048000\n }\n}\n```\n\n* * *\n\n**Device Response Notification(603)**\n\n## Thing model Service Call Response (thingServiceReply)\n\n| Field | Field Type | Description |\n| --- | --- |---- |\n| productId | string |product id |\n| deviceName | string | Device name |\n| deviceId | string |device id|\n| imei | string | device imei |\n| callType | string | Calling method: synchronous call async: asynchronous call |\n| rtime| Long | Service response time |\n| stime | Long | Service call time |\n| request | object | Service Call Data |\n| request.params | object | Service Call Data - Input Data |\n| response |object | service response data |\n| response.code | Integer |200 is a normal response |\n| response.data |object | Service Response Data - Output Data |\n\n**DATA EXAMPLES**\n\n```json\n{\n \"msgType\":\"thingServiceReply\",\n \"subData\":{\n \"deviceId\": \"50103***\",\n \"deviceName\": \"LwM2M-I***\",\n \"imei\": \"202110********\",\n \"productId\": \"rY5iZ****\",\n \"callType\":\"async\",\n \"stime\": 1524448722123,\n \"rtime\": 1524448722123,\n \"request\": {\n \"id\":\"123\",\n \"version\": \"1.0\",\n \"params\": {\n \"identifier\": \"service1\",\n \"input\": {\n \"Power1\": \"on\",\n \"WF1\": \"2\"\n }\n \n }\n },\n \"response\": {\n \"id\": \"123\",\n \"code\": 200,\n \"msg\": \"xxxx\",\n \"data\": {\n \"identifier\": \"service1\",\n \"output\": {\n \"result1\": \"1\",\n \"result2\": \"2\"\n }\n }\n }\n }\n}\n```\n\n## NB Device Cache Command Delivery Response (NBcommandCacheReply)\n\n| Field | Field Type | Description |\n| --- | --- |---- |\n| productId | string |product id |\n| deviceName | string | Device name |\n| deviceId | string |device id|\n| imei | string | device imei |\n| cmdId |string | Cached command ID |\n| cmdType | string| Cached command type, 0:READ, 1:WRITE:2:EXECUTE |\n| sendTime | Long | Cached command send time |\n|sendStatus|int|1. command wait;
2. Cancle;
3. The command has been sent to the device (send);
4. Expired commands;
5. The command is delivered successfully.
6. Failed command delivery.
7. Command delivery timeout;
8. Other unknown error |(undefined)|\n| confirmTime |Long | Device response time |\n|confirmStatus |int|0. SUCCESS (command execution successful);
1. METHOD_NOT_ALLOWED (the object or resource does not allow the operation);
2. FORBIDDEN (terminal is not registered);
3. NOT_FOUND (no object or resource found);
4. INTERNAL_SERVER_ERROR (device response code error, etc.);
5. TIME_OUT (device response timeout);
6. REQ_PARAM_ERROR (wrong request parameters);
7. RESP_ERROR (the device responds to an error packet);
8. UNAUTHORIZED;
9. BAD_REQUEST (request format error, such as few parameters or encoding, etc.);
10. NOT_ACCEPTABLE (no preferred message format can be returned);
11. UNSUPPORTED_CONTENT_FORMAT (the specified packet format is not supported);
12. OFFLINE (device is not registered);
13. ADDR_OCCUPIED (The address of the device is occupied by another device)|\n| confirmBody | object | Device Response Message |\n\n**DATA EXAMPLES**\n\n```json\n{\n \"msgType\": \"NBcommandCacheReply\",\n \"subData\": {\n \"deviceId\": \"50103***\",\n \"deviceName\": \"LwM2M-I***\",\n \"imei\": \"202110********\",\n \"productId\": \"rY5iZ****\",\n \"cmdId\": \"31cefd28-a6ff-54ea-bea7-aabe537ea647\",\n \"cmdType\": 0,\n \"confirmStatus\": 0,\n \"confirmTime\": 1703581337493,\n \"sendStatus\": 5,\n \"sendTime\": 1703581337288,\n \"confirmBody\": {\n \"obj_id\": 3,\n \"obj_inst\": [{\n \"obj_inst_id\": 0,\n \"res\": [\n {\n \"res_inst\": [{\n \"val\": 0,\n \"res_inst_id\": 0\n }],\n \"res_id\": 11\n },\n {\n \"val\": 1530496927000,\n \"res_id\": 13\n }\n ]\n }]\n }\n }\n}\n\n```\n\n## Device Image Update Notification (deviceImagePropertyUpdate)\n\n|Field|Type|Field Description|\n|--|--|--|\n| productId | string |product id |\n| deviceName | string | Device name |\n| deviceId | string |device id|\n| imei | string | device imei |\n|dataTimestamp |Long | The time when the image was updated, timestamp |\n| body| object | Image Update Message |\n\n**DATA EXAMPLES**\n\n```json\n{\n \"msgType\":\"deviceImagePropertyUpdate\",\n \"subData\":{\n \"deviceId\": \"50103***\",\n \"deviceName\": \"LwM2M-I***\",\n \"imei\": \"202110********\",\n \"productId\": \"rY5iZ****\",\n \"dataTimestamp\":1524448722123,\n \"body\": {\n \"metadata\": {\n \"desired\": {\n \"color\": {\n \"timestamp\": 1666259752\n }\n },\n \"reported\": {\n \"cccc\": {\n \"timestamp\": 1647248298\n },\n \"color\": {\n \"timestamp\": 1666259752\n }\n }\n },\n \"state\": {\n \"delta\": {\n \"color\": \"pink\"\n },\n \"desired\": {\n \"color\": \"pink\"\n },\n \"reported\": {\n \"cccc\": \"test\",\n \"color\": \"blue\"\n }\n },\n \"timestamp\": 1666259752,\n \"version\": 9\n }\n }\n}\n```\n\n* * *\n\nLinkage Rule (620)\n\n## SceneLog\n\n|Field|Type|Field Description|\n|--|--|--|\n|sceneName | string | Name of the scene linkage rule |\n| data |object | Scene linkage log information |\n|data.conditions |Arr[object] | Scene linkage trigger condition |\n|data.actions |Arr[object] |Scene Linkage Execution Action|\n| data.time | Long |Scene linkage trigger time |\n\n**DATA EXAMPLES**\n\n```json\n{\n \"msgType\": \"SceneLog\",\n \"subData\": {\n \"data\": {\n \"actions\": [{\n \"identifier\": \"FreezerDoorStatus\",\n \"productId\": \"6Tw****\",\n \"success\": true,\n \"type\": \"order\",\n \"deviceName\": \"123\",\n \"value\": \"true\"\n }],\n \"conditions\": [{\n \"productId\": \"6Twc****\",\n \"type\": \"lifeCycle\",\n \"deviceId\": \"501***\",\n \"deviceName\": \"123\",\n \"value\": \"online\"\n }],\n \"time\": 1701943466661\n },\n \"sceneName\": \"pulsar_dispatch_test1\"\n }\n}\n```\n\n* * *"}, "zh_CN": {"title": "消息类型", "content": "RINGA服务端订阅消息队列中，使用了全新定义的消息格式。消息格式分为两层：最外层定义了superMsg用于消息超集，用于消息归类。里层通过msgType区分不同的消息，如设备上线后，superMsg为设备状态变化通知（600），里层msgTpye为deviceOnline。本文将介绍服务端订阅中最新的消息格式与消息类型。\n\n## 格式说明\n\n消息队列的数据格式分为两层：\n\n* 第一层格式如下\n\n#msg\n\n{\n\nsuperMsg：消息集，\n\npv：协议版本，\n\nt：推送给开发者的系统时间，\n\ndata：推送给开发者的业务数据，\n\nsign：消息签名\n\n}\n\n* 第二层消息格式如下为第一层的data数据，需要解密后使用，为JSON格式。 [数据解密方式](/doc/v5/fuse/detail/539)\n\n![](https://upfiles.heclouds.com/portal5-admin/portal5-admin/2024/01/25/1c414905b0ddede227cd3fdae23f1a9e.jpg)\n\n## 消息集和消息类型\n\n| 消息集（superMsg） | 消息类型（msgType）|\n| --- | --- |\n| 设备状态变化通知（600） | 设备在线（deviceOnline）、设备离线（deviceOffline）|\n| 设备管理（601） | 设备创建(deviceCreate)、设备删除(deviceDelete) |\n| 设备数据上报（602） | 物模型属性(thingProperty)、物模型事件(thingEvent)、数据流-数据点(dataPoints) |\n| 设备响应通知（603） | 物模型服务调用响应(thingServiceReply)、 NB设备缓存命令下发响应(NBcommandCacheReply)、设备镜像更新通知（deviceImagePropertyUpdate） |\n| 联动规则（620） | 场景联动触发日志（SceneLog） |\n| 设备位置信息（630） | 设备位置信息（LBS） |\n\n* * *\n\n## 消息格式\n\n第二层消息格式说明\n\n**设备状态变化通知（600）**\n\n## 设备在线（deviceOnline)\n\n| 字段 | 字段类型 | 描述 |\n| --- | --- |---- |\n| productId | string |产品id |\n| deviceName | string | 设备名称 |\n| deviceId | string |设备id |\n| imei | string |设备imei|\n| time | Long |上线时间，时间戳 |\n\n**数据示例**\n\n```json\n{\n \"msgType\": \"deviceOnline\",\n \"subData\": {\n \"deviceId\": \"50103***\",\n \"deviceName\": \"LwM2M-I***\",\n \"imei\": \"202110********\",\n \"productId\": \"rY5iZ****\",\n \"time\": 1703581741909\n }\n}\n```\n\n## 设备离线（deviceOffline)\n\n| 字段 | 字段类型 | 描述 |\n| --- | --- |---- |\n| productId | string |产品id |\n| deviceName | string | 设备名称 |\n| deviceId | string |设备id |\n| imei | string |设备imei|\n| time | Long |离线时间,时间戳 |\n\n**数据示例**\n\n```json\n{\n \"msgType\": \"deviceOffline\",\n \"subData\": {\n \"deviceId\": \"50103***\",\n \"deviceName\": \"LwM2M-I***\",\n \"imei\": \"202110********\",\n \"productId\": \"rY5iZ****\",\n \"time\": 1703581741909\n }\n}\n```\n\n* * *\n\n**设备管理（601）**\n\n## 设备创建(deviceCreate)\n\n| 字段 | 字段类型 | 描述 |\n| --- | --- |---- |\n| productId | string |产品id |\n| deviceName | string | 设备名称 |\n| deviceId | string |设备id |\n| imei | string |设备imei|\n| time | Long |创建时间 |\n\n**数据示例**\n\n```json\n{\n \"msgType\": \"deviceCreate\",\n \"subData\": {\n \"deviceId\": \"50103***\",\n \"deviceName\": \"LwM2M-I***\",\n \"imei\": \"202110********\",\n \"productId\": \"rY5iZ****\",\n \"time\": 1703581741909\n }\n}\n```\n\n* * *\n\n## 设备删除(deviceDelete)\n\n| 字段 | 字段类型 | 描述 |\n| --- | --- |---- |\n| productId | string |产品id |\n| deviceName | string | 设备名称 |\n| deviceId | string |设备id |\n| imei | string |设备imei|\n| time | Long |删除时间,时间戳 |\n\n**数据示例**\n\n```json\n{\n \"msgType\": \"deviceDelete\",\n \"subData\": {\n \"deviceId\": \"50103***\",\n \"deviceName\": \"LwM2M-I***\",\n \"imei\": \"202110********\",\n \"productId\": \"rY5iZ****\",\n \"time\": 1703581741909\n }\n}\n```\n\n* * *\n\n设备数据上报（602）\n\n## 物模型属性(thingProperty)\n\n| 字段 | 字段类型 | 描述 |\n| --- | --- |---- |\n| productId | string |产品id |\n| deviceName | string | 设备名称 |\n| deviceId | string |设备id |\n| imei | string |设备imei|\n| params |map |物模型属性数据 |\n\n**数据示例**\n\n```json\n{\n \"msgType\":\"thingProperty\",\n \"subData\":{\n \"deviceId\": \"50103***\",\n \"deviceName\": \"LwM2M-I***\",\n \"imei\": \"202110********\",\n \"productId\": \"rY5iZ****\",\n \"params\": {\n \"Power\": {\n \"value\": \"on\",\n \"time\": 1524448722123\n },\n \"WF\": {\n \"value\": 23.6,\n \"time\": 1524448722123\n }\n }\n }\n}\n```\n\n## 物模型事件(thingEvent)\n\n| 字段 | 字段类型 | 描述 |\n| --- | --- |---- |\n| productId | string |产品id |\n| deviceName | string | 设备名称 |\n| deviceId | string |设备id |\n| imei | string |设备imei|\n| params |map |物模型事件数据 |\n\n**数据示例**\n\n```json\n{\n \"msgType\":\"thingEvent\",\n \"subData\":{\n \"deviceId\": \"50103***\",\n \"deviceName\": \"LwM2M-I***\",\n \"imei\": \"202110********\",\n \"productId\": \"rY5iZ****\",\n \"params\": {\n \"Power\": {\n \"value\": \"on\",\n \"time\": 1524448722123\n },\n \"WF\": {\n \"value\": 23.6,\n \"time\": 1524448722123\n }\n }\n }\n}\n```\n\n## 数据流-数据点(dataPoints)\n\n| 字段 | 字段类型 | 描述 |\n| --- | --- |---- |\n| productId | string |产品id |\n| deviceName | string | 设备名称 |\n| deviceId | string |设备id |\n| imei | string |设备imei |\n| datastreamId |string |数据点id |\n| value |object |设备上报数值 |\n| time |Long |上报时间，时间戳|\n\n**数据示例**\n\n```json\n{\n \"msgType\":\"dataPoints\",\n \"subData\":{\n \"deviceId\": \"50103***\",\n \"deviceName\": \"LwM2M-I***\",\n \"imei\": \"202110********\",\n \"productId\": \"rY5iZ****\",\n \"datastreamId\": \"3_0_26261\",\n \"time\": 1703580644076,\n \"value\": 2048000\n }\n }\n}\n```\n\n* * *\n\n**设备响应通知（603）**\n\n## 物模型服务调用响应(thingServiceReply)\n\n| 字段 | 字段类型 | 描述 |\n| --- | --- |---- |\n| productId | string |产品id |\n| deviceName | string | 设备名称 |\n| deviceId | string |设备id |\n| imei | string |设备imei |\n| callType | string | 调用方式sync：同步调用async：异步调用 |\n| rtime| Long | 服务响应时间 |\n| stime | Long | 服务调用时间 |\n| request | object |服务调用数据 |\n| request.params | object | 服务调用数据-输入数据 |\n| response |object |服务响应数据 |\n|response.code | Integer |200为正常响应 |\n| response.data |object | 服务响应数据-输出数据 |\n\n**数据示例**\n\n```json\n{\n \"msgType\":\"thingServiceReply\",\n \"subData\":{\n \"deviceId\": \"50103***\",\n \"deviceName\": \"LwM2M-I***\",\n \"imei\": \"202110********\",\n \"productId\": \"rY5iZ****\",\n \"callType\":\"async\",\n \"stime\": 1524448722123,\n \"rtime\": 1524448722123,\n \"request\": {\n \"id\":\"123\",\n \"version\": \"1.0\",\n \"params\": {\n \"identifier\": \"service1\",\n \"input\": {\n \"Power1\": \"on\",\n \"WF1\": \"2\"\n }\n }\n },\n \"response\": {\n \"id\": \"123\",\n \"code\": 200,\n \"msg\": \"xxxx\",\n \"data\": {\n \"identifier\": \"service1\",\n \"output\": {\n \"result1\": \"1\",\n \"result2\": \"2\"\n }\n }\n }\n }\n}\n```\n\n## NB设备缓存命令下发响应(NBcommandCacheReply)\n\n| 字段 | 字段类型 | 描述 |\n| --- | --- |---- |\n| productId | string |产品id |\n| deviceName | string | 设备名称 |\n| deviceId | string |设备id |\n| imei | string |设备imei |\n| cmdId |string | 缓存命令ID |\n| cmdType | string| 缓存命令类型，0：READ，1:WRITE：2：EXECUTE |\n| sendTime | Long | 缓存命令发送时间 |\n|sendStatus|int|1. 命令等待（wait）;
2. 命令取消（cancle）;
3. 命令已发往设备（send）;
4. 命令过期（expired）;
5. 命令下发成功（success）;
6. 命令下发失败（failed）;
7.命令下发超时 ;
8. 其他未知错误|（undefined）|\n| confirmTime |Long | 设备响应时间 |\n|confirmStatus |int|0. SUCCESS(命令执行成功);
1. METHOD_NOT_ALLOWED（对象或资源不允许该操作） ;
2. FORBIDDEN（终端未注册）;
3. NOT_FOUND（未发现该对象或资源）;
4. INTERNAL_SERVER_ERROR（设备响应码错误等）;
5. TIME_OUT（设备响应超时）;
6. REQ_PARAM_ERROR（请求参数错误）;
7. RESP_ERROR（设备响应报文错误）；
8. UNAUTHORIZED（访问权限不允许）;
9. BAD_REQUEST（请求格式错误，如少参数或编码等）;
10. NOT_ACCEPTABLE（无任何首选的报文格式可以返回）;
11. UNSUPPORTED_CONTENT_FORMAT（指定的报文格式不支持）;
12. OFFLINE（设备未注册）;
13. ADDR_OCCUPIED（设备的地址被其他设备占用）|\n| confirmBody | object | 设备响应信息 |\n\n**数据示例**\n\n```json\n{\n \"msgType\": \"NBcommandCacheReply\",\n \"subData\": {\n \"deviceId\": \"50103***\",\n \"deviceName\": \"LwM2M-I***\",\n \"imei\": \"202110********\",\n \"productId\": \"rY5iZ****\",\n \"cmdId\": \"31cefd28-a6ff-54ea-bea7-aabe537ea647\",\n \"cmdType\": 0,\n \"confirmStatus\": 0,\n \"confirmTime\": 1703581337493,\n \"sendStatus\": 5,\n \"sendTime\": 1703581337288,\n \"confirmBody\": {\n \"obj_id\": 3,\n \"obj_inst\": [{\n \"obj_inst_id\": 0,\n \"res\": [{\n \"res_inst\": [{\n \"val\": 0,\n \"res_inst_id\": 0\n }],\n \"res_id\": 11\n },\n {\n \"val\": 1530496927000,\n \"res_id\": 13\n }\n ]\n }]\n }\n }\n}\n\n```\n\n## 设备镜像更新通知（deviceImagePropertyUpdate）\n\n|字段|类型|字段说明|\n|--|--|--|\n| productId | string |产品id |\n| deviceName | string | 设备名称 |\n| deviceId | string |设备id |\n| imei | string |设备imei |\n|dataTimestamp |Long | 镜像更新时间,时间戳 |\n| body| object | 镜像更新消息 |\n\n**数据示例**\n\n```json\n{\n \"msgType\":\"deviceImagePropertyUpdate\",\n \"subData\":{\n \"deviceId\": \"50103***\",\n \"deviceName\": \"LwM2M-I***\",\n \"imei\": \"202110********\",\n \"productId\": \"rY5iZ****\",\n \"dataTimestamp\":1524448722123,\n \"body\": {\n \"metadata\": {\n \"desired\": {\n \"color\": {\n \"timestamp\": 1666259752\n }\n },\n \"reported\": {\n \"cccc\": {\n \"timestamp\": 1647248298\n },\n \"color\": {\n \"timestamp\": 1666259752\n }\n }\n },\n \"state\": {\n \"delta\": {\n \"color\": \"pink\"\n },\n \"desired\": {\n \"color\": \"pink\"\n },\n \"reported\": {\n \"cccc\": \"test\",\n \"color\": \"blue\"\n }\n },\n \"timestamp\": 1666259752,\n \"version\": 9\n }\n }\n }\n}\n```\n\n* * *\n\n**联动规则（620）**\n\n## 场景联动触发日志（SceneLog）\n\n|字段|类型|字段说明|\n|--|--|--|\n|sceneName | string | 场景联动规则名称 |\n| data |object | 场景联动日志信息 |\n|data.conditions |Arr[object] | 场景联动触发条件 |\n|data.actions |Arr[object] |场景联动执行动作 |\n| data.time | Long |场景联动触发时间 |\n\n**数据示例**\n\n```json\n{\n \"msgType\": \"SceneLog\",\n \"subData\": {\n \"data\": {\n \"actions\": [\n {\n \"identifier\": \"FreezerDoorStatus\",\n \"productId\": \"6Tw****\",\n \"success\": true,\n \"type\": \"order\",\n \"deviceName\": \"123\",\n \"value\": \"true\"\n }\n ],\n \"conditions\": [\n {\n \"productId\": \"6Twc****\",\n \"type\": \"lifeCycle\",\n \"deviceId\": \"501***\",\n \"deviceName\": \"123\",\n \"value\": \"online\"\n }\n ],\n \"time\": 1701943466661\n },\n \"sceneName\": \"pulsar_dispatch_test1\"\n }\n}\n```\n\n* * *\n\n**设备位置信息（630）**\n\n## 设备位置信息（LBS）\n\n|字段|类型|字段说明|\n|--|--|--|\n| productId | string |产品id |\n| deviceName | string | 设备名称 |\n| deviceId | string |设备id |\n| imei | string |设备imei |\n| type | Integer |定位类型， 1：基站定位，2：wifi定位 |\n|timestamp |Long | 毫秒时间戳 |\n| data | Float | 维度 |\n| data.lat | Float | 维度 |\n|data.lon | Float | 经度 |\n|data.accuracy |Float |定位精确度，type=1才有该字段 |\n\n**数据示例**\n\n```json\n{\n \"msgType\":\"LBS\",\n \"subData\":{\n \"deviceId\": \"50103***\",\n \"deviceName\": \"LwM2M-I***\",\n \"imei\": \"202110********\",\n \"productId\": \"rY5iZ****\",\n \"type\":\"1\",\n \"timestamp\": 1662426560258\n \"data\": {\n \"lat\": 31.581616709196908,\n \"lon\": 120.34759566694639,\n \"accuracy\": 744\n }\n }\n}\n```"}, "zh_HK": {"title": "消息類型", "content": "RINGA服務端訂閱消息隊列中，使用了全新定義的消息格式。消息格式分為兩層：最外層定義了superMsg用於消息超集，用於消息歸類。裡層通過msgType區分不同的消息，如設備上線後，superMsg為設備狀態變化通知（600），裡層msgTpye為deviceOnline。本文將介紹服務端訂閱中最新的消息格式與消息類型。\n\n## 格式說明\n\n消息隊列的數據格式分為兩層：\n\n* 第一層格式如下\n\n#msg\n\n{\n\nsuperMsg：消息集，\n\npv：協議版本，\n\nt：推送給開發者的系統時間，\n\ndata：推送給開發者的業務數據，\n\nsign：消息簽名\n\n}\n\n* 第二層消息格式如下為第一層的data數據，需要解密后使用，為JSON格式。 [數據解密方式](/doc/v5/fuse/detail/539)\n\n![](/fuse/middlelayer/file/download?file=pQLpw0FHU2sk2PRJxMjE.png)\n\n## 消息集和消息類型\n\n| 消息集（superMsg） | 消息類型（msgType）|\n| --- | --- |\n| 設備狀態變化通知（600） | 設備在線（deviceOnline）、設備離線（deviceOffline）|\n| 設備管理（601） | 設備創建(deviceCreate)、設備刪除(deviceDelete) |\n| 設備數據上報（602） | 物模型屬性(thingProperty)、物模型事件(thingEvent)、數據流-數據點(dataPoints) |\n| 設備響應通知（603） | 物模型服務調用響應(thingServiceReply)、 NB設備緩存命令下發響應(NBcommandCacheReply)、設備鏡像更新通知（deviceImagePropertyUpdate） |\n| 聯動規則（620） | 場景聯動觸發日誌（SceneLog） |\n| 設備位置信息（630） | 設備位置信息（LBS） |\n\n* * *\n\n## 消息格式\n\n第二層消息格式說明\n\n**設備狀態變化通知（600）**\n\n## 設備在線（deviceOnline)\n\n| 字段 | 字段類型 | 描述 |\n| --- | --- |---- |\n| productId | string |產品id |\n| deviceName | string | 設備名稱 |\n| deviceId | string |設備id |\n| imei | string |設備imei|\n| time | Long |上線時間，時間戳 |\n\n**數據示例**\n\n```json\n{\n \"msgType\": \"deviceOnline\",\n \"subData\": {\n \"deviceId\": \"50103***\",\n \"deviceName\": \"LwM2M-I***\",\n \"imei\": \"202110********\",\n \"productId\": \"rY5iZ****\",\n \"time\": 1703581741909\n }\n}\n```\n\n## 設備離線（deviceOffline)\n\n| 字段 | 字段類型 | 描述 |\n| --- | --- |---- |\n| productId | string |產品id |\n| deviceName | string | 設備名稱 |\n| deviceId | string |設備id |\n| imei | string |設備imei|\n| time | Long |離線時間,時間戳 |\n\n**數據示例**\n\n```json\n{\n \"msgType\": \"deviceOffline\",\n \"subData\": {\n \"deviceId\": \"50103***\",\n \"deviceName\": \"LwM2M-I***\",\n \"imei\": \"202110********\",\n \"productId\": \"rY5iZ****\",\n \"time\": 1703581741909\n }\n}\n```\n\n* * *\n\n**設備管理（601）**\n\n## 設備創建(deviceCreate)\n\n| 字段 | 字段類型 | 描述 |\n| --- | --- |---- |\n| productId | string |產品id |\n| deviceName | string | 設備名稱 |\n| deviceId | string |設備id |\n| imei | string |設備imei|\n| time | Long |創建時間 |\n\n**數據示例**\n\n```json\n{\n \"msgType\": \"deviceCreate\",\n \"subData\": {\n \"deviceId\": \"50103***\",\n \"deviceName\": \"LwM2M-I***\",\n \"imei\": \"202110********\",\n \"productId\": \"rY5iZ****\",\n \"time\": 1703581741909\n }\n}\n```\n\n* * *\n\n## 設備刪除(deviceDelete)\n\n| 字段 | 字段類型 | 描述 |\n| --- | --- |---- |\n| productId | string |產品id |\n| deviceName | string | 設備名稱 |\n| deviceId | string |設備id |\n| imei | string |設備imei|\n| time | Long |刪除時間,時間戳 |\n\n**數據示例**\n\n```json\n{\n \"msgType\": \"deviceDelete\",\n \"subData\": {\n \"deviceId\": \"50103***\",\n \"deviceName\": \"LwM2M-I***\",\n \"imei\": \"202110********\",\n \"productId\": \"rY5iZ****\",\n \"time\": 1703581741909\n }\n}\n```\n\n* * *\n\n設備數據上報（602）\n\n## 物模型屬性(thingProperty)\n\n| 字段 | 字段類型 | 描述 |\n| --- | --- |---- |\n| productId | string |產品id |\n| deviceName | string | 設備名稱 |\n| deviceId | string |設備id |\n| imei | string |設備imei|\n| params |map |物模型屬性數據 |\n\n**數據示例**\n\n```json\n{\n \"msgType\":\"thingProperty\",\n \"subData\":{\n \"deviceId\": \"50103***\",\n \"deviceName\": \"LwM2M-I***\",\n \"imei\": \"202110********\",\n \"productId\": \"rY5iZ****\",\n \"params\": {\n \"Power\": {\n \"value\": \"on\",\n \"time\": 1524448722123\n },\n \"WF\": {\n \"value\": 23.6,\n \"time\": 1524448722123\n }\n }\n }\n}\n```\n\n## 物模型事件(thingEvent)\n\n| 字段 | 字段類型 | 描述 |\n| --- | --- |---- |\n| productId | string |產品id |\n| deviceName | string | 設備名稱 |\n| deviceId | string |設備id |\n| imei | string |設備imei|\n| params |map |物模型事件數據 |\n\n**數據示例**\n\n```json\n{\n \"msgType\":\"thingEvent\",\n \"subData\":{\n \"deviceId\": \"50103***\",\n \"deviceName\": \"LwM2M-I***\",\n \"imei\": \"202110********\",\n \"productId\": \"rY5iZ****\",\n \"params\": {\n \"Power\": {\n \"value\": \"on\",\n \"time\": 1524448722123\n },\n \"WF\": {\n \"value\": 23.6,\n \"time\": 1524448722123\n }\n }\n }\n}\n```\n\n## 數據流-數據點(dataPoints)\n\n| 字段 | 字段類型 | 描述 |\n| --- | --- |---- |\n| productId | string |產品id |\n| deviceName | string | 設備名稱 |\n| deviceId | string |設備id |\n| imei | string |設備imei |\n| datastreamId |string |數據點id |\n| value |object |設備上報數值 |\n| time |Long |上報時間，時間戳|\n\n**數據示例**\n\n```json\n{\n \"msgType\":\"dataPoints\",\n \"subData\":{\n \"deviceId\": \"50103***\",\n \"deviceName\": \"LwM2M-I***\",\n \"imei\": \"202110********\",\n \"productId\": \"rY5iZ****\",\n \"datastreamId\": \"3_0_26261\",\n \"time\": 1703580644076,\n \"value\": 2048000\n }\n }\n}\n```\n\n* * *\n\n**設備響應通知（603）**\n\n## 物模型服務調用響應(thingServiceReply)\n\n| 字段 | 字段類型 | 描述 |\n| --- | --- |---- |\n| productId | string |產品id |\n| deviceName | string | 設備名稱 |\n| deviceId | string |設備id |\n| imei | string |設備imei |\n| callType | string | 調用方式sync：同步調用async：異步調用 |\n| rtime| Long | 服務響應時間 |\n| stime | Long | 服務調用時間 |\n| request | object |服務調用數據 |\n| request.params | object | 服務調用數據-輸入數據 |\n| response |object |服務響應數據 |\n|response.code | Integer |200為正常響應 |\n| response.data |object | 服務響應數據-輸出數據 |\n\n**數據示例**\n\n```json\n{\n \"msgType\":\"thingServiceReply\",\n \"subData\":{\n \"deviceId\": \"50103***\",\n \"deviceName\": \"LwM2M-I***\",\n \"imei\": \"202110********\",\n \"productId\": \"rY5iZ****\",\n \"callType\":\"async\",\n \"stime\": 1524448722123,\n \"rtime\": 1524448722123,\n \"request\": {\n \"id\":\"123\",\n \"version\": \"1.0\",\n \"params\": {\n \"identifier\": \"service1\",\n \"input\": {\n \"Power1\": \"on\",\n \"WF1\": \"2\"\n }\n }\n },\n \"response\": {\n \"id\": \"123\",\n \"code\": 200,\n \"msg\": \"xxxx\",\n \"data\": {\n \"identifier\": \"service1\",\n \"output\": {\n \"result1\": \"1\",\n \"result2\": \"2\"\n }\n }\n }\n }\n}\n```\n\n## NB設備緩存命令下發響應(NBcommandCacheReply)\n\n| 字段 | 字段類型 | 描述 |\n| --- | --- |---- |\n| productId | string |產品id |\n| deviceName | string | 設備名稱 |\n| deviceId | string |設備id |\n| imei | string |設備imei |\n| cmdId |string | 緩存命令ID |\n| cmdType | string| 緩存命令類型，0：READ，1:WRITE：2：EXECUTE |\n| sendTime | Long | 緩存命令發送時間 |\n|sendStatus|int|1. 命令等待（wait）;
2. 命令取消（cancle）;
3. 命令已發往設備（send）;
4. 命令過期（expired）;
5. 命令下發成功（success）;
6. 命令下發失敗（failed）;
7.命令下發超時 ;
8. 其他未知錯誤|（undefined）|\n| confirmTime |Long | 設備響應時間 |\n|confirmStatus |int|0. SUCCESS(命令執行成功);
1. METHOD_NOT_ALLOWED（對象或資源不允許該操作） ;
2. FORBIDDEN（終端未註冊）;
3. NOT_FOUND（未發現該對象或資源）;
4. INTERNAL_SERVER_ERROR（設備響應碼錯誤等）;
5. TIME_OUT（設備響應超時）;
6. REQ_PARAM_ERROR（請求參數錯誤）;
7. RESP_ERROR（設備響應報文錯誤）；
8. UNAUTHORIZED（訪問權限不允許）;
9. BAD_REQUEST（請求格式錯誤，如少參數或編碼等）;
10. NOT_ACCEPTABLE（無任何首選的報文格式可以返回）;
11. UNSUPPORTED_CONTENT_FORMAT（指定的報文格式不支持）;
12. OFFLINE（設備未註冊）;
13. ADDR_OCCUPIED（設備的地址被其他設備佔用）|\n| confirmBody | object | 設備響應信息 |\n\n**數據示例**\n\n```json\n{\n \"msgType\": \"NBcommandCacheReply\",\n \"subData\": {\n \"deviceId\": \"50103***\",\n \"deviceName\": \"LwM2M-I***\",\n \"imei\": \"202110********\",\n \"productId\": \"rY5iZ****\",\n \"cmdId\": \"31cefd28-a6ff-54ea-bea7-aabe537ea647\",\n \"cmdType\": 0,\n \"confirmStatus\": 0,\n \"confirmTime\": 1703581337493,\n \"sendStatus\": 5,\n \"sendTime\": 1703581337288,\n \"confirmBody\": {\n \"obj_id\": 3,\n \"obj_inst\": [{\n \"obj_inst_id\": 0,\n \"res\": [{\n \"res_inst\": [{\n \"val\": 0,\n \"res_inst_id\": 0\n }],\n \"res_id\": 11\n },\n {\n \"val\": 1530496927000,\n \"res_id\": 13\n }\n ]\n }]\n }\n }\n}\n\n```\n\n## 設備鏡像更新通知（deviceImagePropertyUpdate）\n\n|字段|類型|字段說明|\n|--|--|--|\n| productId | string |產品id |\n| deviceName | string | 設備名稱 |\n| deviceId | string |設備id |\n| imei | string |設備imei |\n|dataTimestamp |Long | 鏡像更新時間,時間戳 |\n| body| object | 鏡像更新消息 |\n\n**數據示例**\n\n```json\n{\n \"msgType\":\"deviceImagePropertyUpdate\",\n \"subData\":{\n \"deviceId\": \"50103***\",\n \"deviceName\": \"LwM2M-I***\",\n \"imei\": \"202110********\",\n \"productId\": \"rY5iZ****\",\n \"dataTimestamp\":1524448722123,\n \"body\": {\n \"metadata\": {\n \"desired\": {\n \"color\": {\n \"timestamp\": 1666259752\n }\n },\n \"reported\": {\n \"cccc\": {\n \"timestamp\": 1647248298\n },\n \"color\": {\n \"timestamp\": 1666259752\n }\n }\n },\n \"state\": {\n \"delta\": {\n \"color\": \"pink\"\n },\n \"desired\": {\n \"color\": \"pink\"\n },\n \"reported\": {\n \"cccc\": \"test\",\n \"color\": \"blue\"\n }\n },\n \"timestamp\": 1666259752,\n \"version\": 9\n }\n }\n }\n}\n```\n\n* * *\n\n**聯動規則（620）**\n\n## 場景聯動觸發日誌（SceneLog）\n\n|字段|類型|字段說明|\n|--|--|--|\n|sceneName | string | 場景聯動規則名稱 |\n| data |object | 場景聯動日誌信息 |\n|data.conditions |Arr[object] | 場景聯動觸發條件 |\n|data.actions |Arr[object] |場景聯動執行動作 |\n| data.time | Long |場景聯動觸發時間 |\n\n**數據示例**\n\n```json\n{\n \"msgType\": \"SceneLog\",\n \"subData\": {\n \"data\": {\n \"actions\": [\n {\n \"identifier\": \"FreezerDoorStatus\",\n \"productId\": \"6Tw****\",\n \"success\": true,\n \"type\": \"order\",\n \"deviceName\": \"123\",\n \"value\": \"true\"\n }\n ],\n \"conditions\": [\n {\n \"productId\": \"6Twc****\",\n \"type\": \"lifeCycle\",\n \"deviceId\": \"501***\",\n \"deviceName\": \"123\",\n \"value\": \"online\"\n }\n ],\n \"time\": 1701943466661\n },\n \"sceneName\": \"pulsar_dispatch_test1\"\n }\n}\n```\n\n* * *\n\n**設備位置信息（630）**\n\n## 設備位置信息（LBS）\n\n|字段|類型|字段說明|\n|--|--|--|\n| productId | string |產品id |\n| deviceName | string | 設備名稱 |\n| deviceId | string |設備id |\n| imei | string |設備imei |\n| type | Integer |定位類型， 1：基站定位，2：wifi定位 |\n|timestamp |Long | 毫秒時間戳 |\n| data | Float | 維度 |\n| data.lat | Float | 維度 |\n|data.lon | Float | 經度 |\n|data.accuracy |Float |定位精確度，type=1才有該字段 |\n\n**數據示例**\n\n```json\n{\n \"msgType\":\"LBS\",\n \"subData\":{\n \"deviceId\": \"50103***\",\n \"deviceName\": \"LwM2M-I***\",\n \"imei\": \"202110********\",\n \"productId\": \"rY5iZ****\",\n \"type\":\"1\",\n \"timestamp\": 1662426560258\n \"data\": {\n \"lat\": 31.581616709196908,\n \"lon\": 120.34759566694639,\n \"accuracy\": 744\n }\n }\n}\n```"}}