wandering1
f7f17931c9
实施方案 docs/网络/N34-自愈审计/实施方案.md §4 五原语，形态按
E2/E3/E4 定案（实验方案.md）：
1. 类型化状态回读 + 每 Socket 缓存（open=0 时 tcp_state 哨兵
0xFF；sn>7 边界返 {00,FF} 计 fault）；
2. 事件护栏 ch395f_sock_events：只读本 Socket SINT，全局寄存器
唯一读者=net_poll（F-NET-7 契约）；
3. ch395f_sock_reset_begin/poll 非阻塞状态机：读空 RX -> CLOSE
-> 排空事件(quiescent 2 轮) -> 轮询 byte0=00H；GRACEFUL/
QUARANTINE 最短等待 100/400ms（Trap 23）；WAIT_CLOSE 内置
LISTEN 态二段 CLOSE 补发（TC1502b 实证 ~180ms 落定）；
4. ch395f_cmd_done 状态回读判据（E3：GET_CMD_STATUS 对
OPEN/LISTEN/CLOSE 无判别力）；
5. 链路态缓存 ch395f_glob_event_feed + link_up/变化计数
（B9 判据 PHY!=DISCONN）。
Phase 15 板测（硬件层模式，Socket 7，无需 PC）：20/20 PASS，
含二段关闭语义断言（一段 05/00、二段 byte0=00）。
RAM +56B < 64B（g_sock_state 16B + g_rst 32B + 链路/fault 8B）；
产品 Code 与阶段 2 前逐字节同 209780（无调用者被链接器裁剪）。
@test PASS；relisten_stress 20/20、n30 3/3 零回归。
RAM 台账同步：RW_IRAM1 97952B 74.7% / RW_CCM 57376B 87.9%。
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 | 问题 | 状态 |
|---|---|---|
| Trap 21 | TC-NET-604 "RX 窗口冻结" 判定为非缺陷（原报告系测试程序自吞数据 + 判读工具误判） | ✅ 结案 |
| Trap 22 | 快速复连丢 CONNECT/DISCONNECT 中断 → 监听静默死亡；修复 = net_reconcile_tick() 周期对账自愈 |
✅ 已修 |
| Trap 23 | 上传中止后首笔复连被静默截断（≤2048B）并误报成功；修复 = 异常释放后复监听隔离排空 | ✅ 已修 |
完整台账与复现配方见
docs/问题记录/CH395F_Trap_Records.md（改驱动前必读）。
相关文档
- 测试指南：
docs/测试说明/CH395F_Test_Guide.md - 上层抽象：
../NET/README.md - 台架探针：
MDK-ARM/tcp_reconnect_probe.py、MDK-ARM/ftp_abort_probe.py