单片机与物联网 / 系统课时
确定多设备协议需求边界
确定多设备协议需求边界
多节点串口通信最容易在实现阶段反复返工:地址怎么分、哪些命令需要响应、长度怎么算、超时等多久、错误如何返回都没有明确答案。本篇把这些问题收敛成一份可执行的协议边界,确保后续帧格式和程序实现有稳定输入。
学习目标
- 能从多节点采集与控制场景提取协议必须固定的约束
- 能明确地址、数据类型、命令、最大帧长和响应时限的边界
- 能把异常、超时和非法报文处理规则写成实现可执行的约定
先区分必须固定和可扩展项
协议定稿前,先把所有需求放进同一张边界表。核心原则是:通信双方必须同时知道的内容必须固定;未来可能增加但不影响旧设备解析的内容才保留扩展空间。
| 需求项 | 定稿时要回答的问题 | 典型约束 |
|---|---|---|
| 设备地址 | 一条总线上如何唯一定位节点? | 地址长度、广播地址、保留地址 |
| 数据类型 | 采集值和控制值如何编码? | 整数、无符号数、定点数、字节串 |
| 命令类别 | 哪些操作需要支持? | 读、写、控制、状态查询、异常响应 |
| 最大帧长 | 单帧最多携带多少字节? | 总帧长和负载长度都要明确 |
| 响应时限 | 主站多久判断本次请求失败? | 响应超时、重试次数 |
| 错误处理 | 解码失败或设备拒绝时怎么表示? | CRC 错误、长度错误、非法命令、设备忙 |
先固定这些边界,可以避免“帧格式已经写完,但程序不知道超时多久”这类跨模块返工。
地址边界要先解决多设备冲突
多节点场景下,地址不是普通字段,而是路由依据。每个设备必须拥有唯一地址;协议还应明确广播地址是否存在,以及广播请求是否允许设备回复。否则多个节点同时响应,会直接破坏总线上的请求与响应关系。
地址分配还应考虑预留范围。例如可以约定普通设备使用一段连续地址,其余值保留给广播、维护或未来扩展。具体数值属于项目协议本身,不能依赖程序员各自理解。
命令和数据类型要绑定语义
不要只定义“命令字有哪些”,还要定义每个命令的请求数据、响应数据和长度规则。例如同一个采集值如果协议约定为 16 位无符号整数,那么字节序、缩放关系和合法范围都应写清楚;否则发送方和接收方即使都能解析两字节,也可能得到不同数值。
可以把最终约束整理成类似下面的协议草案。这里的数字只是片段示例,用于说明如何写清边界,不代表某个固定项目的最终取值。
# 片段示例:协议需求边界清单
address:
widthBytes: 1
uniquePerBus: true
broadcastAllowed: false
commands:
- code: 0x01
name: read
- code: 0x02
name: write
frame:
maxLengthBytes: 256
lengthMeans: payloadBytes
response:
timeoutMs: <TIME>
retryCount: 2
errors:
- crc_error
- invalid_length
- invalid_command
- device_busy这类定义的重点不是 YAML 本身,而是让协议评审时每一个字段都有明确答案。实际项目应把 <TIME> 替换为经实测确认的响应时限,并在设备规格、任务周期和串口速率之间校验是否合理。
最大帧长不能只看负载
“最大帧长”至少要区分总帧长与最大负载长度。假设最终帧由地址、命令、长度、负载和 CRC 组成,那么接收程序分配缓冲区时必须按完整帧的最大字节数考虑,而不是只按业务数据长度申请。
同时要定义长度字段到底表示什么:只表示负载,还是表示从命令开始到 CRC 的全部字节。这个决定会直接影响接收状态机,一旦双方口径不同,就可能出现整批报文错位解析。
响应时限必须和设备行为一起确定
响应超时不是随意填一个数字。应考虑设备最慢处理路径、总线传输时间、校验与业务处理时间,以及是否允许重试。对于周期采集,还要确认一次请求及其重试是否会占满下一个采集周期。
错误处理也应区分“报文无效”和“业务拒绝”。例如 CRC 错误通常意味着帧不可信,设备可以直接丢弃;而合法请求但设备忙,则属于业务层状态,是否返回明确错误码应在协议中写死。
用验收问题检查边界是否闭合
协议进入下一阶段前,至少应能连续回答这些问题:一个设备如何被唯一寻址?广播是否响应?每条命令的请求和响应数据类型是什么?最大总帧长是多少?长度字段统计哪一段?设备多久必须响应?哪些错误直接丢帧,哪些错误必须回包?重试后仍失败如何结束一次事务?
当这些问题都能得到唯一答案时,后续帧格式才真正具备落地条件;否则即使已经画出报文结构,也只是草案而不是可以交给固件、上位机和测试同时实现的协议。