wandering1/STM32F4-Base
1
0
Fork 0
Code Issues 30 Pull Requests Actions Packages Projects 2 Releases Wiki Activity
429 Commits 3 Branches 0 Tags
f849c79b7a37ce991dd77537210835a3f47c6225
Commit Graph

8 Commits

Author SHA1 Message Date
wandering1 a12367981d fix(N34): E14 丢中断复核——芯片不丢事件；listen 排事件挪至 LISTEN 前+全局读收口+全库归因更正 
48 轮直读 SINT 矩阵（8 周期×6 变体）复核历史"丢中断"说法：芯片侧事件
丢失 = 0。归类：drain 读清消费 3/48（drain-int 探针现场抓获）、门控
竞态 2/48、主机同步 1/48、幽灵态 0/48 未复现。

根除性修复：net_listen_locked / net_listener_try 的排事件读清从
listen 后挪至 LISTEN 命令之前——新连接 CONNECT 落进该窗即被本方读清
吞掉，即"数据被吞"的生产侧自伤机制（台架 3/48 为同形态放大版）。

全局读收口：全局中断寄存器唯一读者 = net_poll（I7）；生产/测试/台架
游离全局读全部删除，ch395f.h 声明处加护栏注释。

归因更正：17 文件约 40 处"丢中断"措辞改为"事件未收到/读清消费竞态"
（机制全部保留，仅归因更正）；设计文档 §5.2 新增 E14 锚点；Trap
Records TRAP-NET-17/-20/B3 归因更正段；配图生成器与 SVG 重生成。

台架：事件未收到复核探针保留（drain-int / SINT 补读×3 / 超时归类），
下次跑矩阵自动归类；实验注册（main.c/uvprojx）已完全还原。

验证：@build 0 错误 0 警告；ci_local L0 32/0 + gitlint + L0.5
953/953；doc-links --all --sections-strict 通过；@test PASS（无
[ERR]，net init 619ms）；回归 :7003 300ms×10 = 10/10、:21 n30×50 =
0/50 失败。
 2026-10-14 02:48:50 +08:00
wandering1 1a35b3684c docs(N34): 自愈审计目录 7 份文档合并为单文档，全库引用同步
CI / L0 静态门禁 (pre-commit) (push) Failing after 44s
Details
CI / L0.5 主机侧单测 (MSVC) (push) Failing after 43s
Details 
- `docs/网络/N34-自愈审计/` 目录 7 份文档（根因总览 / net 层盘点 /
  驱动层审计 / 主流对照 / 汇总裁决 / 实施方案 / 实验方案）合并为
  `docs/网络/N34-自愈审计.md`（§0~§6），原目录删除；docs/README.md
  索引与变更日志登记归档
- 全库引用同步：4 篇文档 + 驱动/NET/test 代码注释 + 配图生成器与 SVG
- 内容零丢失抽查：E0~E13 实验记录、E6 裁决（命中=0 不立项）、
  提交表（含 `925058a` 收口行）均在位
- 门禁：@build 0/0（注释级路径更新）；check_doc_links --all 143 文档
  通过（净 −6 = 删 7 增 1 吻合）；ci_local L0+L0.5 全绿
 2026-10-13 23:23:55 +08:00
wandering1 925058a5ae fix(NET)+docs: lftpd 对端地址修复、E6 裁决收口、陷阱编号迁移重排 TRAP-NET-01~21 
- lftpd：net_inet_ntoa 段序改 MSB 首 + 新增 net_getpeername，FTP 日志打印
  真实对端地址（真机实证 192.168.1.2:55524，登记 TRAP-NET-21）
- E6：NET_U15_PROBE 命中=0（含压测）→ 阶段 3 项 4 不立项，U15 登记观察项；
  插桩留仓（宏=0 零成本），soak 驱动 test/host/e6_soak.py 入库
- 编号：全库 Trap NN → TRAP-NET-<nn> 迁移并重排连续 01~21（单调映射，
  沿革见 CH395F_Trap_Records.md 头注）；死号 12/13/19/21 引用全部清除；
  GD5F 域引用补正为 TRAP-GD5F-NN
- 陷阱文档全新化：索引 21 行行行真陷阱；删误判存档/发现时间/git 考古/
  FTP 附录；台架纪律教训沉淀第六章方法论
- RAM：Code 211348→211456（+108 lftpd 修复），RW+ZI 净增 +4B；
  优化方案/台账受管区/tsv 同笔同步
- ftp_abort_probe.py 挪 test/host/；引用关系图重生成
- 回归：@build 0/0；@test PASS；ftp_abort 10/10；relisten :7003 20/20；
  ci_local L0+L0.5 全绿；E6 窗口零复位，7 条 WD stall 登记压测假象备查
 2026-10-13 20:54:31 +08:00
wandering1 f7f17931c9 feat(N34 阶段2): ch395f 五原语只加不接线 + Phase 15 套件 20/20 
实施方案 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%。
 2026-10-13 12:43:17 +08:00
wandering1 4c0a0af9f8 fix(net): N34 阶段0 零风险清理 9 条（注释债/死码/三处小逻辑门） 
纯注释/死码（零行为变更）：
- 0-1 pump 注释 50ms→100ms（宏真值源 100U，net_socket.c）
- 0-2 D10 give-up 文案改"retry budget exhausted, pump takes over"
  （旧文案夸大永久失效语义，pump 100ms 仍周期认领重建）
- 0-7 IP 字节序注释更正：set_ip/gw/mask 实为点分十进制序（调用方
  parse_ip_string 数组直传、芯片按首段接受、台架多年实证）；
  set_des_ip 补"与 get_remot_ipp 输出同序"往返注（ch395f.h/.c）
- 0-8 Trap 13 注释降级为"未证实历史观察"（对齐 2026-10-11 Trap 13
  复核注，与手册 §5.34 相左）：DMA 定容理由改"接收缓冲 2KB 整缓冲
  单读=Trap 25 排空契约形态"；net_socket.c 四处引用改写
- 0-9 删死声明：GET_GLOB_INT_STATUS(0x29)/ENTER_SLEEP/EEPROM×3/
  GPIO×2/SPI_BEGIN_DELAY_MS/GINT_STAT_SOCK0..3（全仓零引用核实）

小逻辑（台架冒烟实证）：
- 0-3 U12 对称：TCP_LISTEN 失败补 close 两处（net_relisten_locked /
  net_listen_locked）——防芯片 Socket 卡"OPEN 无监听"、下轮 open
  恒返 USE（U12 同源事故形态）
- 0-4 retry_tick 状态门：仅 LISTENING/CLOSED 才重试；已转 ESTABLISHED
  （新会话抢先）清陈旧登记，防 open→close 摧毁活连接（认领口径同 pump）
- 0-5 FUN_PARA 裸 0x08 → CH395F_FUN_PARA_SOCKET_CLOSE（复用既有宏
  (1UL<<3)，注释补 §5.52/版本/红线口径；曾重复定义触发 9 警告，
  已并入原宏块）
- 0-6 版本门控：ver<0x46 拒置 bit3 并 [ERR] 留痕（防芯片批次漂移；
  本台架 ≥0x46 行为不变，fun_para 日志改打实际值）

验证：@build 全量重编 0 错 0 警（Code=209580，RW/ZI 不变）；@test
PASS（回读无差异）；冒烟 n30 0/20、:21 @0ms 20/20、:7003 20/20、
ftp_regression 11/11。

门禁说明：doc-links 工作树 junction 伪影按既定口径 SKIP；mem-budget
分支 .map 漂移同前；cppcheck/coding-standard 手跑 Passed。
 2026-10-13 05:54:42 +08:00
wandering1 afb0bfd5ff fix(net-audit): 修 6 处寄存器口径/注释错误 + Trap 记录全量复核与审计章节 
智能体团队四路并行只读审计（驱动层逐命令 / NET+测试层逐调用点 /
Trap 01-12 复核 / Trap 13-25 复核），三源交叉：芯片手册 + WCH 官方
SDK（CH395CMD.c / CH395INC.H / 21 个例程）+ git 历史。本提交只落
"已确认且低风险"的修法，其余发现登记进文末审计章节待逐项决策。

已修（A 类，全部有手册/SDK 出处）：
A1 测试 TC-203 反核实写成 st_chk[0]==CH395F_TCP_ESTABLISHED——§5.22
   byte0 只有 00H/05H，条件恒假，这道 Trap 14 防线自写下起从未生效
   且日志无痕（与 Trap 07 同类的 byte0/byte1 语义越界）。改为
   byte0==OPEN && byte1==ESTABLISHED。
A2 测试 Phase3/4 把 GET_RECV_LEN 返回值直接当读取长度（本地
   rx_buf[300]/[64]，芯片 RX 缓冲 2KB）→ 栈溢出；补夹取 + 留痕
   （同文件 TC201/202/204 早已 clamp，这两处是漏）。
A3 CH395F_GINT_STAT_DHCPV6 由 0x8000(bit15) 改 0x1000：SDK 是
   (1<<12)、§5.16 明确 CH395F 的 [12:15] 保留。全仓零引用。
A4 ch395f.h 命令分组注释字节数错 4 处（GET_GLOB_INT_STATUS_ALL /
   GET_UNREACH_IPPT 归"1 字节输出"、SET_FUN_PARA 归"1 入 1 出"、
   SET_RETRAN_PERIOD 归"3 字节输入"、GET_SOCKET_STATUS_SN 归"1 字节
   输出"）；KeepAlive 参数注释"秒"改"毫秒"（§5.53/5.54 单位 ms）；
   set_retrans_count 删"0=默认值5"（§5.17 默认 12、无 0=默认语义）。
   实现全对、注释误导——Trap 25 的 1 字节缓冲栈越界正是这类注释发起。
A5 net_socket.c 六处注释与手册/HEAD 相反：FUN_PARA(SOCKET_CLOSE=0)
   实为 bit3=1（正是 closed-with-data accept 的契约依据，写反会诱导
   把 0x08 改回去）、"初始化成功后设置 MAC"（§9.2.1 ① 是之前）、
   "复用默认缓冲"（net_init 已为 8 Socket 显式分配）、"由 MSS 推导"
   （固定布局、Trap 21 已解耦）、"等 SEND_OK"（门控是 SENBUF_FREE）、
   UDP 头 [0-1] reserved（§9.2.4 是数据长度）。
A6 ch395f.c write_send_buf 超限静默 return（void 无日志），且上限取
   DMA 2048 而非发送缓冲 1024；读路径有 OVERSIZE 金丝雀、写路径没有
   → 补 [ERR] 留痕 + >1KB 告警，行为不变（分块责任仍在调用方）。

审计确认"不是 bug"的最危险一项：GET_GLOB_INT_STATUS_ALL 拼装方向。
我们"第1字节|第2字节<<8"与官方 CH395CMDGetGlobIntStatus() 逐字相同，
glob & (1<<(sock+4)) = §5.16 bit4..bit11 = SDK GINT_STAT_SOCKn，三源
一致。另 55 条命令码、9 处 16 位字节序、14 条读命令字节数、60 个
常量、12 个单位参数点、48 块缓冲布局逐条核对无异常；17 处
get_socket_status 调用点全是 st[2]，Trap 25 的 1 字节 bug 无残留。

文档：Trap_Records 加文末「2026-10-11 寄存器/数值口径全量审计」章节
（干净清单计数 + 15 条新发现含已修/待修 + 文档待修清单）。就地修正：
Trap 07 定案更正里"全文 RST 仅见于错误码与引脚"的绝对表述（§5.29 /
§9.2.6 其实写了芯片发 TCP RESET，只是都与 close 无关）+ 删不可核验的
"11 个悬空提交"；Trap 16 的"IP/端口寄存器大端"（端口 §5.25/5.26 明确
低字节在前）+ 注明 §5.8 总括与官方例程自相矛盾；Trap 18 删悬空
"Trap 19"（该条从未存在）、net_socket() 改 net_bind()；速查清单 DMA
1500 改 2052；Trap 13 加复核注（最高优先级：其"部分读后 recv_len
归零"与 §5.34 直接相左、与本仓 TC201 注释相反，且同族结论已被 Trap 21
撤回，却仍被 6 处当现行约束引用）；Test_Guide 的 TRAP-07 行仍教
"卡 FIN_WAIT_2 / close(RST)"、悬空的 Trap 19 与两处"见风险 #N"。

待修（B 类，登记未动，需逐项决策与实测）：B1 产品路径从未启用 Socket
KeepAlive（唯一调用点在 client 分支，产品三服务全是 TCP Server，
§5.56 要求服务器在 CONNECT 后开，60s/5s/3 参数空转）；B2 tcp_connect
返回值丢弃且 CONNECTING 不在对账范围；B3 net_listen_locked 全 8 Socket
读即清会吞别槽事件；B4 全局中断 bit0-3 从不消费、get_unreach_info 零
调用；B5 getsockname 的 s_addr 与本层约定相反致 FTP 日志设备 IP 反序
（PASV 双重反转恰好正确，勿误判）；B6 三处判据只看 byte1 未按 byte0
门控；B7 Phase5 单次写 4093B；B8 Phase4 缓冲块与 sock4 交叠；B9 杂项。

验证：产品构建 0 错 0 警、Code=196912（+124B，写路径两条新日志）；
测试路径（PHASE2/3/4 打开）单独编译 0/0；内存快照已刷新；doc-links
EXIT=0、无 U+FFFD、pre-commit 全绿；@test 闭环 PASS（戳匹配 + 回读无
差异 + 锚点 x1 + 548ms）。
 2026-10-12 00:20:17 +08:00
wandering1 bca6cc694c test(net): TC-NET-204 定案 Trap 07——disconnect→close 不卡死，真因是 bit3 
Trap 07（2026-07-19 写成"2025-07"）断言"disconnect→close 让 Socket 卡
FIN_WAIT_2 数分钟、因为 close 不发 RST"。新增定案用例 TC-NET-204（Phase 2
硬件层，同一 Socket、同一 PC 回显、FUN_PARA=0x08，三模式 × 5 轮 = 45 项判定
全过）做受控对照，实测推翻其机制说法、保留其做法：

  A close                → 回 CLOSED 0/0/150/0/0 ms，重开 5/5 OK
  B disconnect → close   → 全部 +0 ms，重开 5/5 OK（"卡死"未出现）
  C disconnect（不 close）→ 10 s 内从未回 CLOSED，byte0 恒 0x05、byte1 0x00；
                            直接 open → 0x20 FAIL（5/5），补 close 后 +0 ms

三条推翻：① FIN_WAIT_2(06H) 全程未出现（15 轮 × 9 采样点），实测过渡态只有
TIME_WAIT(0AH)；② 手册无 RST 语义（§5.35 只说 close 前自动断链），且主动发
FIN 先进 FIN_WAIT_1 才进 FIN_WAIT_2，原说法跳拍；③ 观测越过了 byte1 的语义
边界——§5.22 byte0 只有 00H/05H，官方 SDK 注释明确 byte1 仅在 byte0=OPEN 时
有意义，而当年代码判据用的是正确的 byte0，break 后照样打印 byte1，于是"已
CLOSED 下的残留读数"被读成"卡在某个 TCP 态"。

真因：FUN_PARA bit3 SOCKET_CLOSE=1（§5.52 ②）下产生 DISCONNECT 后芯片不关
Socket、不清缓冲，Socket 停在 0x05(OPEN)/0x00(TCP_CLOSED)，此时 open_socket
必返 0x20 FAIL——即历史那条 Phase 2 open_socket: 0x20 / socket 未完全关闭。
拉回 CLOSED 的动作是 close，与 RST 无关。

git 佐证：ch395f_tcp_disconnect() 自首个提交起只有定义、零调用点（含全部分支
与 11 个悬空提交），"disconnect→close" 从未进入提交代码；当时驱动已轮询
GET_CMD_STATUS（4 s 上限），也不是"命令没等完成"。

做法保留，理由换成三条有支撑的：§5.35 close 已自动断链故 disconnect 多余；
disconnect 制造的 DISCONNECT 事件在 bit3=1 下须我方消费/预清（Trap 14/17/22）；
它把芯片推进 closing 过渡态、重开需沉降（Trap 09）。本轮 15 轮重开均未观察到
残留 DISCONNECT(0x10)——close 顺带清掉锁存，这才是"直接 close"安全的原因。
另消解 Trap 17 与 Trap 07 的旧矛盾：实测支持 Trap 17（close 走 FIN teardown、
0~150 ms 可见 TIME_WAIT），不支持 RST 说法。

文档：Trap_Records.md 加 Trap 07「定案更正」整节 + 改写「驱动关键点 → TCP 关闭
重连」速查清单（删 RST 说法、补 byte0/byte1 口径与 0x20 陷阱）；Test_Guide.md
新增 TC-NET-204 用例表（前置含 tcp_server --timeout 900 这条坑：首连后连接
间隔 >60 s 服务器会自行退出）。

验证：测试构建 0 错 0 警、Phase 2 74/75（唯一 FAIL 是 TC-203 环境守卫，PC 服务
未及时关闭）；宏已还原，产品构建 Code=196788 与 HEAD 一致（用例全在测试宏内、
产品零足迹），@test 闭环 PASS（戳匹配 + 回读无差异 + 锚点 x1 + 590 ms）。
pre-commit 全绿（test-cppcheck / doc-links / no-mojibake 均 Passed）。
 2026-10-11 21:40:45 +08:00
wandering1 22559365b9 整理 App 与 test 目录：按职责分子目录并同步全库引用 2026-09-26 12:52:39 +08:00