wandering1
f849c79b7a
net_pending.c/h 增设第二张挂起表 s_net_send[]（与 recv 表完全独立，收发 互不阻塞）；net_send_locked 快速路径改为有界自旋，单次等待超出 NET_SEND_SPIN_MS(2ms) 即登记挂起 send，由 net_send_pending_tick 按主循环 节拍分块推进，netTask 最坏停滞由 1s 压到 2ms。net_listener_retry_tick 的 挂起保险扩展到 send 侧；net_close_locked / 网络重建 / 状态对账三路均先 取消再动作（取消必通知，调用方永不挂死）。 台架复测（A/B 对照 + 插桩定位）发现并修复末块挂起越界缺陷：内层"等本块 发完(SENBUF_FREE)"位于写块之后，写完末块时 sent 已 == len，若该次等待越过 2ms 预算便会调用 net_send_pending_register，而登记函数按 sent >= len 拒收 并回 -1，把一次实际已完整交付芯片的发送报成失败。修复为内层等待开头判 sent >= len 即跳出（末块已交付、SENBUF_FREE 等待是纯保守自旋），并置于 超时/自旋判定之前；该守卫同时保证后续登记必伴随 sent < len。 复验：ftp_regression 连续 19 次 11/11；ftp_integrity_test 20 轮 x 64KB STOR/RETR SHA-256 20/20 一致（两轮），吞吐稳定约 80KB/s；设备日志零 write error；ST-LINK 回读 No difference found。 文档：Net层阻塞模型架构设计.md 补二期设计与新增 9.1 缺陷记录，netTask 栈实测峰值按本次台架 920B 订正为 1116/3840（FTP 传输期 1164）；网络自愈 架构设计.md 吸收原监听生命周期文档、新增编号术语导读表，并把 5.2 "实验锚点速查"的 E 编号含义与 E-02 审计编号歧义写在表头（用户反馈该表 E 编号无法读懂）。 门禁：Keil 0 错 0 警；cppcheck / 编码规范 / 乱码零告警； check_mem_numbers PASS；check_doc_links --all --sections-strict 142 篇 PASS。
95 lines
3.9 KiB
C
95 lines
3.9 KiB
C
/*
|
||
* 模块名称：Network Configuration
|
||
* 模块功能：网络子系统编译期参数——Socket 数量、收发超时、TCP KeepAlive。
|
||
* 仅保留**实际被引用**的宏；未使用项已清理。
|
||
* 适用平台：STM32F4 系列（CH395F 以太网芯片）
|
||
* 作者：王建锋
|
||
* 创建日期：2026-07-18
|
||
* 修改记录：
|
||
* 2026-09-10 王建锋 清理未引用宏（TCP Server 监听 Socket 索引、收发缓冲、
|
||
* 连接/接受超时、select/队列/轮询）；KeepAlive 三宏改为
|
||
* 实际生效值 60s/5s/3 并在 net_socket.c 引用（原宏为无效遗留值）
|
||
* 2026-09-22 新增 NET_RETRANS_COUNT/NET_RETRANS_PERIOD_MS（P0-a：重传周期
|
||
* 500→200ms 治 D1 症状），net_socket.c 的字面量 8/500 移入本文件
|
||
* 2026-10-13 自愈收敛阶段 1.5：删除 NET_RECV_TIMEOUT_MS（30s 默认预算）——
|
||
* recv 超时改为调用方策略（net_recv 无限阻塞 /
|
||
* net_recv_to 显式预算 / net_select 首选），API 不再强加默认值
|
||
* 2026-10-14 二期 SEND pending：新增 NET_SEND_SPIN_MS（发送快速路径有界自旋
|
||
* 预算，超预算转挂起登记）——netTask 发送最坏停滞由
|
||
* NET_SEND_TIMEOUT_MS（1s）压到本值，健康路径行为不变
|
||
*/
|
||
|
||
#ifndef NET_CONFIG_H
|
||
#define NET_CONFIG_H
|
||
|
||
#ifdef __cplusplus
|
||
extern "C" {
|
||
#endif
|
||
|
||
/*
|
||
* 最大支持的 Socket 数量（CH395F 支持 0~7）
|
||
*/
|
||
#ifndef NET_MAX_SOCKETS
|
||
#define NET_MAX_SOCKETS 8
|
||
#endif
|
||
|
||
/*
|
||
* 超时时间配置（毫秒）
|
||
* 0 = 无限等待（阻塞模式）
|
||
* 注：recv 侧无编译期默认预算（自愈收敛阶段 1.5 删除 NET_RECV_TIMEOUT_MS）——
|
||
* 超时是调用方策略：net_recv() 无限阻塞、net_recv_to() 显式预算、
|
||
* net_select() 首选机制。
|
||
*/
|
||
#ifndef NET_SEND_TIMEOUT_MS
|
||
#define NET_SEND_TIMEOUT_MS 1000 /* 发送超时 */
|
||
#endif
|
||
|
||
/*
|
||
* 发送快速路径有界自旋预算（毫秒，SEND pending 配套）
|
||
* 分块发送时"等发送缓冲腾出"的正常代价实测仅 219µs（中位，max 378µs，
|
||
* 见《链路延迟测试说明.md》§6.2 chunk_wait）——留约 5 倍余量用有界自旋吃掉，
|
||
* 使**健康路径逐位不变**（多块帧仍在一次分派内发完，不额外引入 tick 延迟）；
|
||
* 一旦单次等待超过本预算即登记挂起请求，把等待交回调用方上下文，
|
||
* netTask 的最坏停滞由 NET_SEND_TIMEOUT_MS（1s）压到本值。
|
||
*/
|
||
#ifndef NET_SEND_SPIN_MS
|
||
#define NET_SEND_SPIN_MS 2
|
||
#endif
|
||
|
||
/*
|
||
* TCP 重传配置（由 net_socket.c 的 net_init() 在 ch395f_init() 之前下发）
|
||
* P0-a（2026-09-22）：周期 500→200ms——单次丢包代价 500→200ms（治 D1 症状），
|
||
* 总窗口 8×200=1.6s，链路真断时判失败更快（对远端显示重连有利）。
|
||
* 手册 §5.18 仅标注上限（≤1000ms）未标注下限；200ms 已经台架验证芯片接受
|
||
*（GET_CMD_STATUS=0x00 + 全套件无回归，见《链路延迟测试说明.md》§10.2 记录）。
|
||
*/
|
||
#ifndef NET_RETRANS_COUNT
|
||
#define NET_RETRANS_COUNT 8 /* 重传次数（手册：最大 20，默认 12） */
|
||
#endif
|
||
|
||
#ifndef NET_RETRANS_PERIOD_MS
|
||
#define NET_RETRANS_PERIOD_MS 200 /* 重传周期 ms（手册：最大 1000，默认 500） */
|
||
#endif
|
||
|
||
/*
|
||
* TCP KeepAlive 配置（单位 ms；须为 500 的倍数且 IDLE > INTVL）
|
||
* 由 net_socket.c 的 net_init() 在 ch395f_init() 之前下发
|
||
*/
|
||
#ifndef NET_KEEPALIVE_IDLE_MS
|
||
#define NET_KEEPALIVE_IDLE_MS 60000 /* 空闲 60 秒后开始探测 */
|
||
#endif
|
||
|
||
#ifndef NET_KEEPALIVE_INTVL_MS
|
||
#define NET_KEEPALIVE_INTVL_MS 5000 /* 5 秒探测一次 */
|
||
#endif
|
||
|
||
#ifndef NET_KEEPALIVE_CNT
|
||
#define NET_KEEPALIVE_CNT 3 /* 最多探测 3 次 */
|
||
#endif
|
||
|
||
#ifdef __cplusplus
|
||
}
|
||
#endif
|
||
|
||
#endif /* NET_CONFIG_H */
|