Files
STM32F4-Base/App/protocol
wandering1 c1e7e8c42c
CI / L0 静态门禁 (pre-commit) (push) Failing after 3s
CI / L0.5 主机侧单测 (MSVC) (push) Failing after 2s
fix(104): 拆掉四处恒假的上界判断——合法带只改判下界,口径不变
L0 的 cppcheck 在 --all-files 下恒红四处,全在同一文件:
App/protocol/iec104/iec104_comm.c 的 80 / 94 / 107 / 121 行,诊断为
compareValueOutOfTypeRangeError —— 拿 unsigned short 与 65535 比较,
Condition is always false。根因是 IEC104_COMM_CA_MAX 与 PORT_MAX 都等于
65535u,而被比较的量是 uint16_t:那个上界判断在类型上就不可能成立。
这四处随上游 iec104_comm 落地进来,本地提交只跑暂存文件所以没人看见,
CI 跑 --all-files 就每轮都红(同族盲区:暂存面与全量面不等价)。

处置走「语义不动」那一支(用户裁定 2026-10-27:A):只删恒假的半边、
改判 if (v < MIN),合法带口径一字未改(仍照 iec104_comm.h 的常量注释:
ca 1..65535、port 1024..65535),只在第一处写清为何不再写上界、其余三处
短引用。没有把 MAX 改成 65534(按 60870-5-104 的 65535 = 未编址),因为
test/host/iec104/iec104_test.c:1521 明确断言 ca 设成 IEC104_COMM_CA_MAX
必须被接受——那会同时打断这条断言并改变现场设备行为(配 65535 的站会
突然回退工厂默认),属协议决定,不在本次范围;要改请单独裁。

验证:单文件 cppcheck 原样复刻钩子参数 → RC=0;cppcheck --all-files 由
红转绿;iec104-unit-test Passed(即 65535 那条合同照过);@build 0 错误
0 警告(Code 231732→231720,减 12 B,RO/RW/ZI 不变);凭证与两份台账
随之重盖(ER_IROM1 257,292→257,280、Flash 合计 258,812→258,800);
本次触发的 13 根钩子全 Passed,含 test-coverage(删掉 4 行已覆盖代码
未被判成回退)。
2026-10-27 10:34:39 +08:00
..
2026-07-19 15:27:49 +08:00

App/protocol/ — 通信协议(纯逻辑层)

存放跨接口复用的协议逻辑(解析 / 组帧 / 状态机),零 I/O、依赖注入, 可被任意任务/接口承载;板端 I/O 胶水在对应 task(如 App/task/iec104_serv.c)。 其余协议实现暂分散在:

  • RS-485 侧:App/task/rs485_task.c(CRC 在驱动内)
  • 网络侧:Drivers/BSP/NET/
  • 远端显示:docs/UI设计/RemoDispBus协议与接收设计说明.md

已落地协议

子目录 协议 说明
iec104/ IEC 60870-5-104 被控站(TCP 2404 上行) 纯逻辑三件套(asdu/pts/link,零 I/O,数据源 vtable 注入)→ 全栈 L0.5 主机单测;板端胶水与点表决策 → docs/子系统设计/IEC104上行设计说明.md

何时使用本目录

当出现跨接口复用的协议逻辑(如统一的帧编解码器、协议状态机)时,落到此处, 避免散落到各 task 里。新增后请在本 README 补一行说明。