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<