refactor(NET): 源码注释去阶段化 + 网络两份文档重构 + 不稳根因图更新
- 源码注释:删去自愈收敛阶段 1/1.5/3等 scaffolding 称谓,改为语义引用 (E-02 收口 / F-NET-2/3/4 / docs/网络/网络自愈架构设计.md §5.2 E13); 涉及 net_socket/.h、net_events、net_listener、net_pending、net_types、 net_config、ch395f、time_sync、iec104_serv、ui_net_sink、lftpd、 simulator/sim/net_socket_sim、board/host 测试与探针 - 文档重构:网络自愈架构设计.md 与 Net层阻塞模型架构设计.md 改为现状口径 (删历史节与阶段叙事),NET/README.md、docs/README.md 同步 - 工具与配图:gen_net_instability_svg.py 与 docs/images/网络不稳根因总览.svg 随源码口径一并更新 - 门禁:@build 0 错误 0 警告
This commit is contained in:
@@ -13,7 +13,7 @@
|
||||
* 旧 N-30 定案矩阵(对照 vs "CONNECT 事件未收到捕获自 accept"修复组)保留在 s_vars[]/
|
||||
* bench_round(),由 s_bench_legacy=0 停泊不运行。
|
||||
*
|
||||
* 2026-10-13 自愈收敛阶段 2 前置实验(task-9):同一固件合并跑 E2/E3/E4——
|
||||
* 驱动原语前置实验:同一固件合并跑 E2/E3/E4——
|
||||
* E2 = GET_SOCKET_STATUS 单次 SPI 成本(DWT 周期计数)+ TCP_LISTEN 可见延迟矩阵;
|
||||
* E3 = GET_CMD_STATUS 判别力矩阵(OPEN/LISTEN/CLOSE/SET_SOUR_PORT/SET_PROTO_TYPE,
|
||||
* 含"命令未发时"对照读,复核 Trap 记录的 SET 类无判别力 + 陈旧 BUSY 残留);
|
||||
@@ -392,7 +392,7 @@ static void bench_round(unsigned idx) {
|
||||
}
|
||||
|
||||
/* =====================================================================
|
||||
* 自愈收敛阶段 2 前置实验区(2026-10-13):E2 / E3 / E4 一次固件合并跑
|
||||
* 驱动原语前置实验区:E2 / E3 / E4 一次固件合并跑
|
||||
* ===================================================================== */
|
||||
|
||||
/* 旧 N-30 定案矩阵停泊开关:0 = 不运行(保留代码备查,勿删) */
|
||||
|
||||
@@ -67,7 +67,7 @@ extern "C" {
|
||||
* E11 实证);勿与 Phase 6/9/10/13 混选(recv 互抢数据) */
|
||||
/* ---- 链路时延基线(M1;分段/阈值见 docs/测试说明/链路延迟测试说明.md)---- */
|
||||
//#define ENABLE_PHASE12_TESTS /* [硬] SPI 字节命令 / DMA 时延基线(L1/L2,无需 PC)—— M1 已完成,基线见说明文档 §6.1 */
|
||||
//#define ENABLE_PHASE15_TESTS /* [硬] 自愈收敛阶段 2 驱动原语:状态回读一致性/cmd_done/sock_reset 状态机跑通/链路缓存(无需 PC)——TC 详见 docs/测试说明/CH395F_Test_Guide.md 阶段 15;2026-10-13 台架 20/20 PASS */
|
||||
//#define ENABLE_PHASE15_TESTS /* [硬] 自愈驱动原语:状态回读一致性/cmd_done/sock_reset 状态机跑通/链路缓存(无需 PC)——TC 详见 docs/测试说明/CH395F_Test_Guide.md 阶段 15;台架 20/20 PASS */
|
||||
/* ---- 链路时延(M2/M3;分段/阈值见 docs/测试说明/链路延迟测试说明.md)---- */
|
||||
//#define ENABLE_PHASE13_TESTS /* [网] 芯片 + 队列时延(L3~L7/L10,需 PC peer)—— M2 已完成,基线见说明文档 §6.2 */
|
||||
#define ENABLE_PHASE14_TESTS /* [网] 生产路径时延(L8~L11 + 模拟器 Δ)—— M3,需 peer --mode remo(:7003);
|
||||
|
||||
@@ -1580,7 +1580,7 @@ static void phase5_run(void) {
|
||||
#endif
|
||||
|
||||
/* ===================================================================
|
||||
* Phase 15 — 自愈收敛阶段 2 驱动原语(无需 PC)
|
||||
* Phase 15 — 自愈驱动原语(无需 PC)
|
||||
*
|
||||
* 测试目的:验证 ch395f 新增原语(设计 docs/网络/网络自愈架构设计.md §4.4)
|
||||
* 语义正确:类型化状态回读一致性 / cmd_done(E3 定案=状态回读)/
|
||||
@@ -1734,7 +1734,7 @@ void ch395f_test_run(void)
|
||||
net_latency_phase12_run();
|
||||
#endif
|
||||
#ifdef ENABLE_PHASE15_TESTS
|
||||
/* Phase 15(自愈收敛阶段 2 驱动原语):独占态下直调驱动,放 HW 层末尾 */
|
||||
/* Phase 15(自愈驱动原语):独占态下直调驱动,放 HW 层末尾 */
|
||||
phase15_run();
|
||||
#endif
|
||||
}
|
||||
|
||||
@@ -760,10 +760,10 @@ void net_latency_phase13_run(int32_t sockfd)
|
||||
if (s_p13_state != P13_ST_ABORT) {
|
||||
return; /* 正常完成/DONE:会话终态,不再处理 */
|
||||
}
|
||||
/* 自愈收敛阶段1(F-NET-3):原"进 abort 分状态手动重同步 + 10s 周期 relisten"
|
||||
* 已删——三种去向全部由 net 层自动机制认领(run8 静默回收滞留 ESTABLISHED
|
||||
* → 对账⑤ RESYNC;CLOSED 失位 → pump 100ms 认领重建;LISTENING 静默丢
|
||||
* 监听 → pump"芯片不在听"判据),手动 API net_resync_listen/net_relisten
|
||||
/* F-NET-3:原"进 abort 分状态手动重同步 + 10s 周期 relisten"
|
||||
* 已删——三种去向全部由 net 层自动机制认领(静默回收滞留 ESTABLISHED
|
||||
* → 对账⑤ RESYNC;CLOSED 失位 → 对账③④ 认领重建;LISTENING 静默丢
|
||||
* 监听 → 形态③"芯片不在听"判据),手动 API net_resync_listen/net_relisten
|
||||
* 已退役。此处只保留收包与 peer re-HELLO 探测。 */
|
||||
n = net_recv(sockfd, s_p13_rx, (int)sizeof(s_p13_rx), NET_MSG_DONTWAIT);
|
||||
if (n > 0) {
|
||||
|
||||
Reference in New Issue
Block a user