wandering1
d346e4ee84
核心语义（实施方案 §3.5）： - net_recv 默认无限阻塞：删除 NET_RECV_TIMEOUT_MS（30s 隐藏默认预算）， 超时归调用方策略；唤醒源=数据/EOF/close/网络重建(CONNRESET)， 会话死亡由对账① ~400ms 判死兜底，无"对端消失永久挂死"窗口 - 新增 net_recv_nb（NET_MSG_DONTWAIT 路径转正具名）与 net_setblocking(fd,on)（阻塞模式挂控制块属性，对齐 O_NONBLOCK/ Python setblocking；直写单字节，net_set_event_cb 先例） - net_types.h net_sock_t 新增 blocking 属性；net_socket() 默认置 1 （close memset 清零后显式重置，同 released_abnormal 纪律） - 原 1s 强制了结看门狗降级为 60s tripwire：只 [ERR] 留痕一次， 绝不伪造 TIMEDOUT 返回值（旧实现掩盖完成路径缺陷） - net_recvfrom 删 30s 自旋超时、同判据对齐（零生产调用者，注释警示） - 文档契约：IWDG required_mask 内任务禁止无限阻塞 recv（BSD 指南 §3.5/§10.1 + net_socket.h 注释） 调用点审计（§3.5.5）：零生产调用点采用无限默认——iec104_serv/ ui_net_sink 转 net_recv_nb（受监控任务逐位等价）；lftpd/time_sync 已是显式预算 net_recv_to 不动；32 轮盲收兜底未动（阶段 3 E6 门禁） 模拟器双端镜像 net_recv_nb/net_recv_to/net_setblocking（包装层 Sleep(1) 轮询模拟阻塞）；差距清单 N-3/N-6 登记义务已履行 门禁与台架： - @build 0/0：Code 209580→209780(+200B) ZI +32B；RAM 受管区官方 脚本同步；ci_local L0 32/32 + L0.5 951/951 - 台架全回归：relisten :7003 50/50、iec104 18/18、对时正常、 ftp_regression 11/11、Trap23 RST 5/5+FIN 5/5、ftp_integrity 20/20 字节一致、n30 0/10、@test PASS - 模拟器 build_sim OK + check_remo_sink 黄金参考 0/25600 位差 队友 p15-recv-semantics 实施，Lead 全量审阅 + 独立复跑门禁与回归
80 lines
3.0 KiB
C
80 lines
3.0 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 N34 阶段 1.5：删除 NET_RECV_TIMEOUT_MS（30s 默认预算）——
|
||
* recv 超时改为调用方策略（net_recv 无限阻塞 /
|
||
* net_recv_to 显式预算 / net_select 首选），API 不再强加默认值
|
||
*/
|
||
|
||
#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 侧无编译期默认预算（N34 阶段 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
|
||
|
||
/*
|
||
* 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 */
|