设备数据格式

不同设备类型的数据格式

设备数据通过 Topic inteagle/{customerId}/p/{projectId}/d/{deviceId} 推送。

通用消息结构

所有 MQTT 消息采用统一的包装结构：

{
  "type": "telemetry | 3A | event | image | attributes",
  "ts": 1735560000000,
  "payload": {
    ...
  }
}

字段	类型	说明
`type`	String	消息类型
`ts`	Long	Unix 毫秒时间戳
`payload`	Object	具体数据内容

开发者可以统一解析：

const { type, ts, payload } = message;
switch(type) {
  case 'telemetry': handleTelemetry(payload); break;
  case '3A':        handleAlarm(payload); break;
  case 'event':     handleEvent(payload); break;
  case 'image':     handleImage(payload); break;
  case 'attributes': handleAttributes(payload); break;
}

消息类型

type	说明	payload 内容
`telemetry`	遥测数据	位移、环境、状态
`3A`	告警	告警详情
`event`	事件	事件类型和数据
`image`	图像	图片 URL 和元数据
`attributes`	属性变更	变更的属性

告警消息 (3A)

{
  "type": "3A",
  "ts": 1735560000000,
  "payload": {
    "id": "alm_20251230_001",
    "alarmType": "LOW_BATTERY",
    "severity": "alarm",
    "status": "ACTIVE_UNACK",
    "originator": {
      "entityType": "DEVICE",
      "id": "dev_001"
    },
    "detail": {
      "metric": "pwr.battery",
      "value": 3.2,
      "threshold": 3.5,
      "message": "电池电压低"
    }
  }
}

payload 字段说明

字段	类型	必填	说明
`id`	String	是	告警唯一标识
`alarmType`	String	是	告警类型（见数据字典）
`severity`	String	是	告警级别
`status`	String	是	告警状态
`originator.entityType`	String	是	实体类型：`DEVICE`、`POINT`
`originator.id`	String	是	实体 ID
`detail.metric`	String	是	触发告警的指标
`detail.value`	Number	否	触发时的实际值
`detail.threshold`	Number	否	阈值
`detail.message`	String	是	告警描述

告警级别 (severity)

值	说明
`ALERT`	预警
`ALARM`	报警
`ACTION`	紧急

告警状态 (status)

值	说明
`ACTIVE_UNACK`	触发未确认
`ACTIVE_ACK`	触发已确认
`CLEARED_UNACK`	恢复未确认
`CLEARED_ACK`	恢复已确认

事件消息 (event)

事件分为通用事件（所有设备）和设备事件（取决于设备能力）。

{
  "type": "event",
  "ts": 1735560000000,
  "payload": {
    "deviceId": "dev_001",
    "eventType": "DEVICE_ONLINE",
    "data": {}
  }
}

payload 字段说明

字段	类型	说明
`deviceId`	String	设备 ID
`eventType`	String	事件类型
`data`	Object	事件相关数据

通用事件类型

eventType	说明
`DEVICE_ONLINE`	设备上线
`DEVICE_OFFLINE`	设备离线

设备特有事件参见各设备文档。

属性变更消息 (attributes)

{
  "type": "attributes",
  "ts": 1735560000000,
  "payload": {
    "deviceId": "dev_001",
    "data": {
      "firmwareVersion": "2.1.0"
    }
  }
}