04ee5867b4
根因:静态 fd 零初始化为 0,而 0 是合法 socket 句柄;判据用 >=0 会把"未初始化"误判成"有效",关闭时误伤他人 fd。本次把该修复 契约化、机械化,而不是再补一个点。 - 新增 net_fd.h 定义唯一失效值 NET_FD_INVALID(-1),全仓零依赖复用 - fd 判据只用 ==/!= NET_FD_INVALID,禁 >=0/<0/数值形态/if(fd) - 网络层内部用 NET_FD_IN_RANGE 做范围校验,上界不外泄 - 主机 fake 改 0 基并跟踪已分配 fd,补冷启动回归(变异测试可捕获) - 新增 net-handle 静态门禁(钩子 53)+ 契约文档 + 审计 + 最小加固 验证:net-handle 487 文件 0 违规;8 个主机套件全绿;Keil 0 错误 0 警告; 审计 3 确认/5 疑似/35 安全,无第二处生产误判。
104 lines
4.4 KiB
C
104 lines
4.4 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 recv 语义主流化:删除 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
|
||
|
||
#include "net_fd.h" /* NET_FD_INVALID:fd 失效值契约(零依赖头) */
|
||
|
||
/*
|
||
* 最大支持的 Socket 数量(CH395F 支持 0~7)
|
||
*/
|
||
#ifndef NET_MAX_SOCKETS
|
||
#define NET_MAX_SOCKETS 8
|
||
#endif
|
||
|
||
/*
|
||
* fd 区间校验(**net 层内部专用**,契约 C4):0 号是合法句柄,NET_FD_INVALID
|
||
* 与一切越界值均无效。上界只在本头 / net 层内部出现,应用层判"是否持有 fd"
|
||
* 一律只与 NET_FD_INVALID 比较(docs/网络/网络句柄失效值契约.md)。
|
||
*/
|
||
#define NET_FD_IN_RANGE(fd) (((fd) > NET_FD_INVALID) && ((fd) < NET_MAX_SOCKETS))
|
||
|
||
/*
|
||
* 超时时间配置(毫秒)
|
||
* 0 = 无限等待(阻塞模式)
|
||
* 注:recv 侧无编译期默认预算(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 */
|