Files
STM32F4-Base/App/protocol
wandering1 04ee5867b4 fix(net): 建立网络 fd 失效值契约,杜绝零初始化误判
根因:静态 fd 零初始化为 0,而 0 是合法 socket 句柄;判据用 >=0
会把"未初始化"误判成"有效",关闭时误伤他人 fd。本次把该修复
契约化、机械化,而不是再补一个点。

- 新增 net_fd.h 定义唯一失效值 NET_FD_INVALID(-1),全仓零依赖复用
- fd 判据只用 ==/!= NET_FD_INVALID,禁 >=0/<0/数值形态/if(fd)
- 网络层内部用 NET_FD_IN_RANGE 做范围校验,上界不外泄
- 主机 fake 改 0 基并跟踪已分配 fd,补冷启动回归(变异测试可捕获)
- 新增 net-handle 静态门禁(钩子 53)+ 契约文档 + 审计 + 最小加固

验证:net-handle 487 文件 0 违规;8 个主机套件全绿;Keil 0 错误 0 警告;
审计 3 确认/5 疑似/35 安全,无第二处生产误判。
2026-11-18 22:20:00 +08:00
..
2026-07-19 15:27:49 +08:00

App/protocol/ — 通信协议与共享运行核心

存放跨接口复用的协议逻辑(解析 / 组帧 / 状态机)及成熟协议运行核心。 纯逻辑部分依赖注入;网络后端承担 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 注入)与现行板端服务;历史单测及板端决策见 docs/子系统设计/IEC104上行设计说明.md
iec104/ 新共享路径与 iec60870/ 成熟 Slave/TcpServer 共享核心,模拟器显式启用 core/source/table 装配成熟业务状态机与平台网络后端;模拟器首里程碑已验证,未替换旧板端路径,详见下文边界

成熟核心迁入边界

新入口 iec104/iec104_core.c 装配 iec60870/ 的 Slave、TcpServer 与业务状态机,数据接缝位于 iec104/iec104_source.c,标准演示元数据位于 iec104/iec104_dtu_table.c。平台网络后端承担 I/O,因此本目录新增部分不能再一概称为零 I/O。来源及兼容补丁见 iec60870/IMPORT.md。

  • 模拟器以 --iec104 显式启用共享核心;旧板端服务仍用原实现,尚未替换或删除旧栈。
  • 协议参数暂为独立 RAM 模型,不等于现有 UI 参数真源;新旧同址不能作为语义桥。模拟读写不持久、不驱动物理开出。
  • 虚拟设备墙钟不改宿主系统钟;链路与事务超时使用单调时基。
  • 模拟器首个里程碑已有同哈希独立 TCP 与黄金回归证据,见设计文档。MCU 替换、旧栈删除、真实 UI 参数绑定仍未完成;构建或模拟器通过不能代替 MCU 资源与硬件验证,也不代表全部门禁通过。
  • 设计与精确集合见 docs/子系统设计/IEC104上行设计说明.md §0;历史日志、录波继续归现有子系统,不另起示例存储栈。

何时使用本目录

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