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 安全,无第二处生产误判。
Drivers/BSP/CH395F/ — CH395F 以太网控制器驱动
CH395F 是 SPI 接口的 10/100M 以太网 MAC+PHY 控制器。本目录是其底层寄存器级驱动, 上层的 BSD Socket 抽象见
../NET/。
文件一览
| 文件 | 作用 |
|---|---|
ch395f.c/h |
SPI 命令收发、寄存器读写、芯片初始化、通道/中断管理 |
关键点
- SPI 接口:SPI2(PB12 CS / PB13 SCK / PB14 MISO / PB15 MOSI)
- 每次 SPI 事务必须
ch395f_spi_begin()/ch395f_spi_end()包裹 - SPI 分频系数必须为 8(PCB 信号完整性约束,勿"优化"改快)
- 芯片最多 8 个 socket,本层用事件中断 + 周期轮询驱动
- PHY 强制 100M 全双工(
net_task中配置)
⚠️ 改本驱动前必读陷阱(Trap Records)
| Trap | 问题 | 状态 |
|---|---|---|
| TC-NET-604 | "RX 窗口冻结" 判定为非缺陷(原报告系测试程序自吞数据 + 判读工具误判) | ✅ 结案 |
| TRAP-NET-17 | 快速复连事件面未收到 → 监听静默死亡(E14 复核:非芯片丢事件,是读清消费竞态);修复 = net_reconcile_tick() 周期对账自愈 |
✅ 已修 |
| TRAP-NET-18 | 上传中止后首笔复连被静默截断(≤2048B)并误报成功;修复 = 异常释放后复监听隔离排空 | ✅ 已修 |
完整台账与复现配方见
docs/问题记录/CH395F_Trap_Records.md(改驱动前必读)。
相关文档
- 测试指南:
docs/测试说明/板级测试/CH395F_Test_Guide.md - 上层抽象:
../NET/README.md - 台架探针:
MDK-ARM/tcp_reconnect_probe.py、test/host/bench/ftp/ftp_abort_probe.py