wandering1
0054ae629a
批次一（不碰门禁即可清）的最后半批，原派道中途失败且**未留任何改动**（Lead 核实那批文件零 diff 后重派 setpage 执行，14 只文件 / 46 处），测试侧与一张生成器共 9 处由 Lead 收尾。 做法：**逐处先读属主文档 §7 速查表里那条的语义**，再改写成「一句话结论 + §指针」，同号跨文件同一措辞， 无一处机械删号（例：`F-NET-7` → 「唯一读者红线（docs/网络/网络自愈架构设计.md §7 I7）」）。属主登记处 **12 条定义行原样保留**、不删登记族（删了历史行会报未登记前缀），只在该章加停发句。 顺带清掉 **3 处裸形**（`T6` → 「台架实测」、`M4-lite`、`Q1` 语义化）——裸形正是 id-check 校验 2 抓的形态， 属净减。测试侧收尾时两条纪律：主机侧**断言字符串必须保持 ASCII**（`ns_s3_msg.c` 等三处的号在 CHECK 文本 里，改成 `sole reader of the global register` 而不是中文）；板端注释可用中文。 生成器 gen_net_instability_svg.py 文案改动 → 同批重跑产物 `docs/images/网络不稳根因总览.svg`：只有那一 行的**框宽随文字自适应**（526 → 551，右缘 1411 未越界），画布 1560x1468 不变，无溢出告警。 ⚠ 本笔**只含代码注释面**：该半批的文档面（BSD 函数调用关系 9 处、属主文档 §7 停发句、 生成器与产物那张网络不稳图）已被上一笔 `git add docs tools` 一并收走，两笔合起来才是完整的 F-* 批次。 自证：@build **0 错 0 警**且 Program Size 与改前**逐字节同数**（Code=233900 RO=26104 RW=1 536 ZI=136808， 注释无误伤的机器证据）；net_socket 457/457、iec104_serv / net_pending 两套 exit 0；cppchec k 钩子参数零 发现、coding-standard 0（lftpd_inet.c 那 4 条是存量且该目录本在钩子 exclude 内，用 HEAD 副本对照 甄别过）。
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