快速入门
合宙 IOT 通用报文协议 AirCloud
二、快速入门
2.1 协议基本结构
AirCloud 协议报文分为消息头和消息体两部分：
- 消息头：固定 16 字节，包含设备 ID、流水号、消息长度和消息标识
- 消息体：可变长度，采用 TLV 格式，可包含多个字段
2.2 示例报文
以下是一个简单的 AirCloud 协议报文示例，展示了设备上报温度数据的结构：
| 字段 | 字节数 | 示例值 | 说明 |
|---|---|---|---|
| 消息头 | 16 | 0x01861234567890120001000C00000001 | 包含设备 ID、流水号、消息长度和消息标识 |
| TLV 类型 | 2 | 0x0101 | 字段类型（256-温度）+ 数据类型（0001-浮点数） |
| TLV 长度 | 2 | 0x0004 | 温度值长度（4字节） |
| TLV 值 | 4 | 0x41C80000 | 温度值（25.0°C） |
2.3 通信流程
- 设备连接：设备通过 TCP 或 MQTT 或 UDP连接到合宙云平台
- 设备鉴权：设备发送鉴权请求，携带用户 key、设备 ID 等信息
- 数据上报：鉴权成功后，设备按照 AirCloud 协议上报数据
- 指令下发：服务器可以通过 AirCloud 协议向设备下发控制指令
- 心跳维持：设备定期发送心跳包，维持连接活性