04ee5867b4
根因:静态 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 安全,无第二处生产误判。
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 补一行说明。