josh/hj_datalink
1
0
Fork 0
forked from gatsby/df_datalink
Code Issues Pull Requests Releases Activity

doc & fix: 增加comtool plugin, 修改上传遥测长度问题

Browse Source
This commit is contained in:
josh
2025-06-16 16:08:05 +08:00
parent c468bd9ca1
commit 4932c9c6c7
3 changed files with 455 additions and 19 deletions
Download Patch File Download Diff File Expand all files Collapse all files
doc/HSJL 上位机串口通信协议.md
+18 -15
View File
@@ -1,7 +1,7 @@
# HSJL 上位机串口通信协议
> 版本：v1.2
> 日期：2025 年 6 月 12 日
> 日期：2025 年 6 月 16 日
---
@@ -46,19 +46,19 @@ block-beta
| 字段名 | 字节数 (Byte) | 说明 |
|--|--|--|
| 帧头 | 2 | 固定值：`0x54 0x5A` |
| 帧头 | 2 | 固定值：`0x5A 0x54` |
| 数据段 | ≤950 | 业务数据内容 |
| Dummy Byte | 1 | 固定填充：`0x00` |
| 校验和 | 1 | 所有**数据段**字节累加和（无符号累加） |
| 数据段长度 | 2 | 数据段字节数（不含 Dummy/校验/帧尾） |
| 帧尾 | 2 | 固定值：`0xFE 0x5A` |
| 帧尾 | 2 | 固定值：`0x5A 0xFE` |
### 帧内冲突规避规则
为防止数据段中出现帧尾 `0xFE 0x5A`：
为防止数据段中出现帧尾 `0x5A 0xFE`：
- 若数据段中出现 `0xFE 0x5A`，需插入 `0x00` 变成 `0x00 0xFE 0x5A`
- 接收端收到 `0x00 0xFE 0x5A` 还原为 `0xFE 0x5A`
- 若数据段中出现 `0x5A 0xFE`，需插入 `0x00` 变成 `0x00 0x5A 0xFE`
- 接收端收到 `0x00 0x5A 0xFE` 还原为 `0x5A 0xFE`
### 帧长说明
@@ -192,13 +192,13 @@ block-beta
### （可选）遥测指令
遥测指令上传的 Payload 由 5 部分组成，顺序存储，共 188 字节：
遥测指令上传的 Payload 由 5 部分组成，顺序存储，共 200 字节：
| 字段名 | 字节数 (Byte) |
| ------------ | ------------- |
| 时间戳 | 8 |
| 总线日志 | 16 |
| 链路层日志 | 88 |
| 链路层日志 | 100 |
| 物理层日志 | 56 |
| 硬件状态日志 | 20 |
@@ -219,7 +219,7 @@ block-beta
#### 链路层日志
链路层日志顺序存储，共 88字节：
链路层日志顺序存储，共 100 字节：
| 字段名 | 字节数 (Byte) | 说明 |
| -------------------- | ------------- | ---------------------------------------- |
@@ -239,12 +239,15 @@ block-beta
| 分发帧发送计数器 | 4 | 每发送一次分发帧，计数器+1（仅簇首） |
| 分发帧接收计数器 | 4 | 每配置接收一次分发帧，计数器+1（仅成员） |
| 分发帧接收正确计数器 | 4 | 每正确接收一次分发帧，计数器+1（仅成员） |
| 网关帧发送计数器 | 4 | 每发送一次网关帧，计数器+1 |
| 网关帧接收计数器 | 4 | 每配置接收一次网关帧，计数器+1 |
| 网关帧接收正确计数器 | 4 | 每正确接收一次网关帧，计数器+1 |
| RTT帧发送计数器 | 4 | 每发送一次RTT帧，计数器+1 |
| RTT帧接收计数器 | 4 | 每配置接收一次RTT帧，计数器+1 |
| RTT帧接收正确计数器 | 4 | 每正确接收一次RTT帧，计数器+1 |
| 网管帧发送计数器 | 4 | 每发送一次网管帧，计数器+1 |
| 网管帧接收计数器 | 4 | 每配置接收一次网管帧，计数器+1 |
| 网管帧接收正确计数器 | 4 | 每正确接收一次网管帧，计数器+1 |
| RTT帧发送计数器 | 4 | 每发送一次 RTT 帧，计数器+1 |
| RTT帧接收计数器 | 4 | 每配置接收一次 RTT 帧，计数器+1 |
| RTT帧接收正确计数器 | 4 | 每正确接收一次 RTT 帧，计数器+1 |
| 业务帧发送计数器 | 4 | 每发送一次业务帧，计数器+1 |
| 业务帧接收计数器 | 4 | 每配置接收一次业务帧，计数器+1 |
| 业务帧接收正确计数器 | 4 | 每正确接收一次业务帧，计数器+1 |
| 时间偏移量记录 | 4, int32 | 记录上一次节点时间和帧同步时间的偏差 |
| 发送数据ID记录 | 4 | 记录上一次发送数据的ID |
| 接收数据ID记录 | 4 | 记录上一次接收数据的ID |