Hac - NBh 标准 JSON 协议使用说明文档

一、协议概述

Hac - NBh 标准 JSON 协议是专为物联网设备与服务器数据交互设计的通信协议。以 JSON 格式为基础，采用键值对（KV 值）组织数据，支持灵活选取数据项，通过 CBOR 格式实现高效传输，并利用 AES 128 加密保障数据安全。

二、协议结构

2.1 数据帧格式

| 帧头(2字节) | 帧长(2字节) | 版本号(1字节) | 设备ID(8字节) | 命令字(1字节) | 数据域格式(1字节) | 数据域(n字节) | CRC校验(2字节) | 帧尾(2字节) |

2.2 各字段说明

字段名	长度	描述
帧头	2 字节	固定值55 AA，标识帧起始
帧长	2 字节	整个帧的长度，含帧头和帧尾
版本号	1 字节	协议版本，如01代表 V1.0
设备 ID	8 字节	设备唯一标识，通常为 MAC 地址或序列号
命令字	1 字节	指示帧类型和用途，如81H表示加密数据帧
数据域格式	1 字节	指示数据域格式，3C表示 CBOR 格式
数据域	n 字节	实际数据内容，格式由数据域格式字段决定
CRC 校验	2 字节	采用 CRC16/AUG - CCITT 算法，用于验证数据完整性
帧尾	2 字节	固定值0D 0A，标识帧结束

三、数据格式

3.1 JSON 数据格式

协议数据域基于 JSON 格式，以键值对呈现，示例如下：

[{"Manufacturer": "Hac","Model": "H51A","Serial Nember": "1234567890","Power Source Voltage": 360,"Battery Level": 95}]

3.2 CBOR 数据格式

JSON 数据最终需转换为 CBOR 格式传输。CBOR 是二进制的 JSON 数据格式，传输效率更高。可使用http😕/cbor.me<