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:
@@ -7,7 +7,7 @@
|
||||
全体消费者的队列消息停摆最长 30s;
|
||||
2. 2s 后从 PC 发起 FTP(:21) 连接,测 banner 到达时延 = 队列响应性:
|
||||
修复前 ≈ 25~30s(队头冻结),修复后 ≈ 数百 ms 内;
|
||||
3. 34s 时 30s 总预算应已耗尽:设备拆掉该会话(自愈收敛阶段 3 net_drop_conn:
|
||||
3. 34s 时 30s 总预算应已耗尽:设备拆掉该会话(net_drop_conn:
|
||||
FIN 关闭 + 本层收口 + 重监听),随后**本探针模拟守规矩对端**:
|
||||
close 自己的 socket;
|
||||
4. 芯片回 CLOSED(TC-NET-204 模式 A:TIME_WAIT 过渡 ~150ms)→ relisten,
|
||||
|
||||
@@ -235,7 +235,7 @@ int net_close(int sockfd) {
|
||||
return 0;
|
||||
}
|
||||
|
||||
/* ---- net_drop_conn(自愈收敛阶段 3 E-02 收口):计数 + 记录 fd ---- */
|
||||
/* ---- net_drop_conn(E-02 收口):计数 + 记录 fd ---- */
|
||||
static int s_drop_calls;
|
||||
static int s_drop_socks[32];
|
||||
|
||||
@@ -511,7 +511,7 @@ static void tc_open_listener(void) {
|
||||
}
|
||||
|
||||
/* ===================== TC-TS-020..029:handle_conn =====================
|
||||
* ⚠ 自愈收敛阶段1(2026-10-13)契约变更:handle_conn **不再** net_close
|
||||
* ⚠ 契约变更:handle_conn **不再** net_close
|
||||
* (单连接模式下 conn==listen,close 会连监听一起毁);会话收尾只返回外层,
|
||||
* 由 time_sync_task 在 `conn != ls`(模拟器多连接后端)时才关数据 fd。
|
||||
* 故本组断言一律为 s_close_calls == 0;任务级关闭见 TC-TS-040e。 */
|
||||
@@ -530,7 +530,7 @@ static void tc_handle_conn(void) {
|
||||
CHECK(s_set_unix_last == 0x12345678u, "TC-TS-020b epoch 按大端解析");
|
||||
CHECK((s_recv_calls == 1) && (s_recv_len_log[0] == 16), "TC-TS-020c 首次请求 16 字节");
|
||||
CHECK(s_recv_to_log[0] == 50U, "TC-TS-020d 单次等待片长 = 50ms");
|
||||
CHECK(s_close_calls == 0, "TC-TS-020e 处理完**不**关闭连接(自愈收敛阶段1:close 交外层 conn!=ls 分支)");
|
||||
CHECK(s_close_calls == 0, "TC-TS-020e 处理完**不**关闭连接(close 交外层 conn!=ls 分支)");
|
||||
CHECK(s_drop_calls == 0, "TC-TS-020g 成功会话不拆(drop 只用于放弃路径)");
|
||||
CHECK(g_tstest_info_count == 1, "TC-TS-020f 留痕 wall clock updated");
|
||||
|
||||
@@ -605,7 +605,7 @@ static void tc_handle_conn(void) {
|
||||
CHECK(s_recv_calls == 1, "TC-TS-027 预算耗尽后不再读(只读 1 次)");
|
||||
CHECK(g_tstest_info_count == 1, "TC-TS-027b 留痕 no TIME packet in 30s, drop conn");
|
||||
CHECK(s_close_calls == 0, "TC-TS-027c 预算耗尽也不关闭连接");
|
||||
CHECK(s_drop_calls == 1, "TC-TS-027d 预算耗尽主动拆会话(自愈收敛阶段 3 E-02 收口:net_drop_conn 拆连接保监听)");
|
||||
CHECK(s_drop_calls == 1, "TC-TS-027d 预算耗尽主动拆会话(E-02 收口:net_drop_conn 拆连接保监听)");
|
||||
|
||||
/* 9) 剩余预算不足一片 */
|
||||
fakes_reset();
|
||||
|
||||
@@ -57,7 +57,7 @@ def main():
|
||||
# 关键:发送后保持连接打开,给板子留出读完 8 字节的窗口。
|
||||
# 若立即 close,CH395F 收到 FIN 会丢弃接收缓冲里尚未被板子读出的
|
||||
# 8 字节时间包,导致板子 net_recv 看到 CLOSED 而无数据、时间同步失败。
|
||||
# 自愈收敛阶段1-5 起板子会话收尾**不再 close**(单连接监听跨会话常驻,
|
||||
# 板子会话收尾**不再 close**(单连接监听跨会话常驻,
|
||||
# EOF 时 net_close 会连监听一起毁掉)——这里 recv 等 2s 宽限后由
|
||||
# 本端关闭;板子 net 层 auto_relisten 随即恢复监听,下一轮照常连接。
|
||||
sock.settimeout(2.0)
|
||||
|
||||
Reference in New Issue
Block a user