单片机与物联网 / 系统课时
整理联调与上线检查清单
整理联调与上线检查清单
本课把串口系统从“能通信”整理到“可交付”:逐项确认串口参数、RS-485 接线、协议版本、测试向量、超时策略、日志字段与故障排查路径,避免上线后只能靠经验定位问题。
学习目标
- 能建立一份覆盖物理层、协议层和软件层的上线检查表
- 能为关键参数和测试结果定义可验证的通过条件
- 能把常见故障绑定到明确的检查顺序与日志证据
串口与 RS-485 基础检查
首先冻结实际部署参数,不要只写“按默认配置”。串口参数至少记录波特率、数据位、校验位和停止位;RS-485 还需要确认设备角色、A/B 线定义、终端电阻以及现场是否存在明显的共地或接地差异。
| 检查项 | 通过条件 | 验证方式 |
|---|---|---|
| 波特率 | 两端配置一致 | 读取配置并现场核对 |
| 数据格式 | 数据位、校验位、停止位一致 | 设备配置与抓包结果 |
| RS-485 线缆 | A/B 与设备定义一致 | 接线表或现场万用表核对 |
| 终端匹配 | 与总线拓扑要求一致 | 原理图与现场核对 |
| 节点编号 | 无重复且符合协议范围 | 启动日志或枚举结果 |
其中最容易漏掉的是“配置正确但实际接线错误”。联调时应把软件参数和现场端子号同时拍照或记录,不能只保留程序配置。
协议版本与测试向量
协议文档、固件和测试工具必须明确对应版本。至少记录帧格式版本、命令定义版本、设备固件版本和测试脚本版本;只要其中一项不一致,测试结果就不能直接作为上线证据。
测试向量不要只保存“正常通信”样例,应覆盖合法最小帧、合法典型帧、最大长度帧、错误 CRC、非法长度、缺失字节、随机前缀以及未知命令等边界情况。每个向量都应有明确的输入字节和预期结果。
一个适合交付的测试记录可以直接采用如下格式:
测试向量:valid-typical-01
协议版本:<PROTOCOL_VERSION>
输入帧:AA 55 <LEN> <PAYLOAD> <CRC>
预期结果:接受 1 帧,业务层收到对应命令
实际结果:接受 1 帧,业务层收到对应命令
结论:PASS预期结果
测试记录包含固定的协议版本、输入帧、预期结果、实际结果和 PASS/FAIL 结论。超时策略与日志字段
超时必须说明“等待什么”和“超时后做什么”。常见边界包括:帧头等待超时、收满长度前超时、响应等待超时以及设备离线重试。不要把这些情况都压缩成一个模糊的“通信超时”。
日志字段应足够支持离线定位。建议至少保留时间、设备标识、方向、命令或消息类型、帧长度、结果、错误类别以及关联请求 ID。涉及原始字节时,还要明确是否记录完整帧,以及是否对敏感数据做脱敏。
例如,应用层可以统一记录如下结构:
{
"time": "<TIME>",
"deviceId": "<ID>",
"direction": "RX",
"messageType": "STATUS",
"length": 12,
"result": "CRC_ERROR",
"requestId": "<ID>"
}预期结果
日志结构能够直接区分设备、方向、消息类型、长度、错误类别和关联请求,并可用时间字段回放故障发生顺序。不要为了“方便排查”而无条件记录所有原始数据。上线前应确认日志级别、保留周期和磁盘占用边界,避免调试日志本身成为新的故障源。
故障排查路径
排障顺序要从成本最低、信息量最大的检查开始。看到“设备无响应”时,不应第一时间修改协议代码,而应依次确认设备供电与连接、串口参数、RS-485 接线、节点地址、请求是否真正发出、对端是否收到、响应是否返回,以及响应在哪一层被丢弃。
现象:设备无响应
1. 确认设备在线与物理连接
2. 核对波特率、数据位、校验位、停止位
3. 核对 RS-485 A/B 与总线拓扑
4. 检查请求是否发出
5. 检查对端是否收到请求
6. 检查响应是否返回
7. 检查长度、帧头和 CRC
8. 检查业务层是否拒绝合法帧预期结果
每一步都能产生可观察证据;故障能够被定位到物理层、传输层、协议解析层或业务层,而不是停留在“串口不通”。上线检查表最终应由“项目专属参数”和“通用排障方法”两部分组成。项目专属部分负责保证现场配置准确,通用部分负责保证出现异常时任何维护人员都能按同一顺序取得证据。
交付前最终核对
正式上线前,把检查项变成可勾选、可留证据的条目,而不是一页只有“已确认”的结论。每项最好同时留下实际值、验证方法和责任人;对未执行项目明确标记为未完成,而不是默认为通过。
建议最终至少确认:串口参数已冻结,RS-485 接线已现场核对,协议版本已统一,测试向量已执行,超时与重试策略已验证,关键日志字段可检索,常见故障有明确排查路径。做到这些,联调结果才真正具备交付价值。