wandering1
fca414102e
步骤 1：追溯器分两档（不改数据，改判据） - BENCH：文档**定义行**（标题行或表格首格）带「（硬件层）」或其所属章节带的号 → 人工台架用例，不期望有 C 代码载体；NOTIMPL：定义行标了未实现/待补/暂缓/已取消 - 两档**单列示数恒打印**、明细进 --verbose，不是静默豁免；也不等于"已验证" - 两个实测坑写在脚本注释里：① 按"任意行出现即算"实现时 BENCH 收 14 个号却只消掉 1 处差异（同一号被别处引用一次就复活）→ 改为只认定义行 + 从文档全集整体减档； ② 载体类型必须由定义处决定，引用行不影响判断 - 另把 has_intent() 收窄到同号所在行（原先整文件任意位置有人话就算过关） 步骤 2：板级 NET 用例标注归一（真债，改名 109 处 / 5 文件） - 取证发现"文档声明却无载体"绝大多数是**标注形态烂**：实现体里写的是 TC204 / TC-201 / TC 703 / TC1501 / TC1502b（三种畸形），文档写 TC-NET-204 等 - 序号一位不改、只补模块码（§7.1）；作用域限定 5 个真载体文件： test/board/ch395f_test_task.c(67) net_test_task.c(37) net_test_task.h(1) test/host/ch395f_socket_test.py(3) Drivers/BSP/CH395F/ch395f.c(1) - 审计轨迹 scripts/rename_maps/batch6-net-annotate.json；别名自动登记（scoped） 实测 - DOC-ONLY 29 → 15：701~704 的 NET 层实现体一直存在（net_test_task.c）， 此前因裸形标注被误判成"未实现"；1501~1503 属硬件层人工 + 同样裸形 - 交集 260 不变、代码侧 578 不减（识别面没缩）；BENCH 14 个号 / NOTIMPL 1 个 - 台账 --prune-backlog 还清 6 条（只减不增）；@build 0 错误 0 警告 （Program Size 与改前逐字节相同：Code=213356 RO=18580 RW=1184 ZI=131480 → 证实只动了注释与日志串）；7 个改动文件 BOM/CR/U+FFFD 与 HEAD 逐项一致 剩余 15 处 DOC-ONLY 的组成（步骤 3 未完，下轮处理） - 4 处文档侧无模块码形态（TC-1003/206/501/704）→ 属 ② 大批 - TC-NET-607 一条是历史指称（原文"原 607/608/609，现 701/702/703"） - 真未实现 10 条：TC-NET-101/102/601/606/801/802/901/902/1006/1101 ——其中 801/802/901/902 曾在 2026-08 的代码里有载体、后被重构丢掉，最值得补
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/ftp_abort_probe.py