feat(net/udp): UDP 数据面并入 netMsgQueue 串行执行（#73） #74

Open

super_agent_bot wants to merge 3 commits from udp-queue-impl-ddb7c192c16e into master

pull from: udp-queue-impl-ddb7c192c16e

merge into: wandering1:master

wandering1:master

wandering1:IEC60870

wandering1:ci/remote-ci

Conversation 6 Commits 3 Files Changed 33

+4362 -558

super_agent_bot commented 2026-11-03 18:09:00 +08:00

Collaborator

Copy Link

Copy Source

This is by an automated agent, not a human.

背景

#57 SNTP 调研把「UDP 先串行化」列为 SNTP 落地的第一步，本 PR 就是那一步（#73 派工）。改造前 net_sendto / net_recvfrom 由调用方直调 SPI 并且是无限自旋收包：既违反"netTask 是芯片唯一访问者"，又把 IWDG 预算吃在自旋里。

改了什么

• 新模块 Drivers/BSP/NET/net_udp.c/.h（真机专属，模拟器不编译）：bind / set_peer / sendto / recvfrom 四条执行体 + 挂起收包表 + net_udp_tick。net_msg_type_t 加四个消息型，公开 API 一律「入队 → 睡在任务通知上」；netTask 自己不占用——等数据、等发送缓冲都登记挂起、由 tick 结算。
• 源地址怎么回来：net_msg_t 是按值拷入队列、AGENTS 明令禁止加"回传用"字段，所以出参指针不进消息，改住 net_udp.c 的 per-fd 槽——调用方 arm，netTask 执行体经该指针就地写回调用方内存，通知值只带结果码。槽互斥，且每条出口都必须清（入队失败、队列未绑定、参数被拒、挂起被结算），泄漏就等于这条 fd 永久 BUSY。
• 发送不写第二份分块逻辑：UDP 复用 net_send_locked（1KB 分块 + 挂起 send 都在里面）。为此把"会话是否已死"收成一条判据 net_send_state_down()（TCP 看 ESTABLISHED、UDP 看 UDP_OPEN）——原先 4 处各写一遍。
• 顺带修掉一个真缺陷（→ 新条 TRAP-NET-22）：旧 net_sendto 为了发一个包把 DesIP 从 0xFFFFFFFF 改写成具体 IP，芯片就此静默切到 UDP Client 形态（收包不带 8 字节信息头），而旧 recvfrom 对 DGRAM 无条件剥 8 字节 → 请求-响应式协议（SNTP 的 48 B 应答）会丢掉载荷前 8 字节并交出垃圾源地址。现在 net_sock_t 带 udp_mode（塞进原有 2 字节 padding，sizeof(net_sock_t) 不变），bind 恒 SERVER、带显式对端的 sendto 切 CLIENT、net_udp_set_peer(fd, NULL) 轻量回 SERVER（不重开 Socket，因此不清芯片缓冲），只有 SERVER 且 avail >= 8 才剥头。
• 截断语义定案：一次调用交付一个数据报，buf 装不下的尾巴必须排空（ch395f_read_recv_buf 是消费式读，不排空下一次就交出上一个包的残料）。排空用 64 B 栈上 scratch 循环读，不用 ch395f_clear_recv_buf——它清整个接收缓冲，会把后面已到达的包一起丢。
• 取消点接齐：net_init 重建 cancel_all、net_socket 分配 fd clear、net_close settle_close + clear、重 bind 前把还在等包的调用方按 -8 结算；net_process_messages 第 5 个 tick 位挂 net_udp_tick。

契约变化（评审重点）

1. UDP 必须先 bind 才能 sendto / recvfrom / net_udp_set_peer，否则 -5 NET_ERR_NOTCONN（芯片侧 Socket 还没开，此时改 DesIP/DesPort 没有落点）。
2. net_recv / net_recv_nb / net_recv_to 对 DGRAM 一律 -3：它们读的是裸字节流，绕过剥头就是静默吃 8 字节，宁可拒掉。收 UDP 请走 net_recvfrom / 新增的 net_recvfrom_to。
3. NET_ERR_NOT_IN_NETTASK(-12) 不再有运行时返回点（串行化后"不在 netTask 里"不再是错误），保留为历史常量并在头文件写明退役原因。
4. 新增公开 API：net_recvfrom_to(fd, buf, len, to_ms, src_addr, addrlen)、net_udp_set_peer(fd, peer|NULL)、net_udp_get_mode(fd)。

验证

• 主机单测：test/host/net_socket 全套 647/647 绿（改造前 470）。新分片 ns_s7_udp.c 共 23 组（bind 的 5 条芯片命令顺序、形态剥头逐字节、挂起收包在后续 poll 轮到达、预算超时按调用方 deadline、close/重建/重 bind 结算不许静默丢通知、出参槽互斥与泄漏、截断排空、netTask 自等守卫、参数守卫且拒时零芯片事务、「队列未绑定」与「队列满」两条失败出口不漏槽、芯片 open 回 ERR_BUSY 时精确码要沿通知值回来、队列里「别人的失败」排在我这条之前不许污染我的回执、轻/重回 SERVER、挂起 send 结算、tick 兜底）；改写 TC-NETSOCK-440（补 bind 前置 + 440p~440u）、555、560 组。假件按「只加不改」扩了三处：捕获 ch395f_write_send_buf 的真实字节、SENBUF_FREE 写延迟注入、read_calls 计数。
• 覆盖率：net_udp.c 237/239 行（99.2%，函数 14/14）、net_socket.c 966/969（99.7%，函数 59/59）、全仓 line 90.1%、47/47 套绿；scripts/test_coverage_baseline.json 已在本提交内登记新文件。未覆盖两处是有意的：net_udp.c 槽越界兜底（调用方已挡）、net_socket.c 错误码槽重查竞态（改造前后同为那 2 行）。
• 构建：Keil MDK ARMCC 0 Error(s), 0 Warning(s)；net_udp.o Code 1,370 / RO 71 / RW 0 / ZI 224（8 fd × 28 B，其余模块零增长）；全仓 Flash 281,012 B（ER_IROM1 26.6%）、RAM RW_IRAM1 94,624 B（72.2%），92% 红线余量充足。内存台账受管区按门禁提示用 ram_baseline.py --write / --update 与 check_mem_numbers.py --write 机器回填（docs/内存管理/ 两份 + scripts/ram_baseline.tsv 一行），没有手改数字。台账里「网络」子系统的软配额（12 KB）本轮从超 1.4 KB 变成超 1.6 KB（+256 B），是否抬配额归台账所有者。
• 本机 pre-commit run（52 根钩子，含 doc-links / coding-standard / mem-budget / generated-fresh / bsp-err / registration / nested-comment / mojibake）全绿；三根 manual 阶段钩子也在本机跑过：cppcheck Passed（它抓到 net_udp.c 两处 variableScope，已修）、test-cppcheck Passed、test-coverage 就是上面的覆盖率闸门。
• 抓到并修掉的被测码真 bug 4 个（细节写进 主机单测覆盖率口径.md 第 4 轮）：自等守卫误用调用侧谓词（导致每条正常 recvfrom 都被拒）、芯片长度被读两次、槽指针取在 fd 合法性检查之前、重 bind 静默作废等待者。

限度 / 未做

• 本轮没有板子：真机回归 5 条（两端互通收发、set_peer(NULL) 能否真恢复收广播、截断排空后下一包完整性、挂起 recv 期间的 IWDG 余量、bind 写 DesIP 与 open 先后的真芯片效果）已写进覆盖率口径的「台架必验」，主机测试替代不了它们。
• scripts/stack_report.py 退出码 1 是 2026-10-26 起就挂在账上的 iec104Task 既有栈债（margin 1,016 < 1,024，见 docs/代码规范/pre-commit使用说明.md:122）。本轮只让 net_bind 的 UDP 分支多一层静态帧（1,544 → 1,600）；netTask（margin 1,904，静态最坏 1,936 / 3,840）与 timeSyncTask（1,152）不受影响。抬栈要过 mem-budget 台账，不在本分支自行处理。
• 登记簿销项按仓库约定留给主工作树，本分支不动 docs/任务规划/**。
• 模拟器侧（simulator/sim/net_socket_sim.c 是 Winsock 实现，不编译 net_socket.c）本轮没补 net_recvfrom_to / net_udp_set_peer / net_udp_get_mode 三条对应实现（当前模拟侧无调用者，补了就是死代码）；只验证了 NET_NO_OS 口径下改过的 net_socket.h 能用 MSVC /W4 单独编过。日后 SNTP 若要在模拟器里跑，得先在 sim 侧补这三条。

This is by an automated agent, not a human. ## 背景 `#57` SNTP 调研把「UDP 先串行化」列为 SNTP 落地的第一步，本 PR 就是那一步（`#73` 派工）。改造前 `net_sendto` / `net_recvfrom` 由调用方直调 SPI 并且是**无限自旋**收包：既违反"netTask 是芯片唯一访问者"，又把 IWDG 预算吃在自旋里。 ## 改了什么 - **新模块** `Drivers/BSP/NET/net_udp.c/.h`（真机专属，模拟器不编译）：`bind / set_peer / sendto / recvfrom` 四条执行体 + 挂起收包表 + `net_udp_tick`。`net_msg_type_t` 加四个消息型，公开 API 一律「入队 → 睡在任务通知上」；netTask 自己不占用——等数据、等发送缓冲都登记挂起、由 tick 结算。 - **源地址怎么回来**：`net_msg_t` 是按值拷入队列、AGENTS 明令禁止加"回传用"字段，所以出参指针不进消息，改住 `net_udp.c` 的 **per-fd 槽**——调用方 `arm`，netTask 执行体经该指针就地写回调用方内存，通知值只带结果码。槽互斥，且**每条出口都必须清**（入队失败、队列未绑定、参数被拒、挂起被结算），泄漏就等于这条 fd 永久 `BUSY`。 - **发送不写第二份分块逻辑**：UDP 复用 `net_send_locked`（1KB 分块 + 挂起 send 都在里面）。为此把"会话是否已死"收成一条判据 `net_send_state_down()`（TCP 看 `ESTABLISHED`、UDP 看 `UDP_OPEN`）——原先 4 处各写一遍。 - **顺带修掉一个真缺陷**（→ 新条 `TRAP-NET-22`）：旧 `net_sendto` 为了发一个包把 DesIP 从 `0xFFFFFFFF` 改写成具体 IP，芯片就此**静默切到 UDP Client 形态**（收包不带 8 字节信息头），而旧 `recvfrom` 对 `DGRAM` 无条件剥 8 字节 → 请求-响应式协议（SNTP 的 48 B 应答）会**丢掉载荷前 8 字节**并交出垃圾源地址。现在 `net_sock_t` 带 `udp_mode`（塞进原有 2 字节 padding，`sizeof(net_sock_t)` 不变），`bind` 恒 SERVER、带显式对端的 `sendto` 切 CLIENT、`net_udp_set_peer(fd, NULL)` 轻量回 SERVER（不重开 Socket，因此不清芯片缓冲），只有 SERVER 且 `avail >= 8` 才剥头。 - **截断语义定案**：一次调用交付一个数据报，`buf` 装不下的尾巴必须排空（`ch395f_read_recv_buf` 是消费式读，不排空下一次就交出上一个包的残料）。排空用 64 B 栈上 scratch 循环读，**不用** `ch395f_clear_recv_buf`——它清整个接收缓冲，会把后面已到达的包一起丢。 - **取消点接齐**：`net_init` 重建 `cancel_all`、`net_socket` 分配 fd `clear`、`net_close` `settle_close` + `clear`、重 bind 前把还在等包的调用方按 `-8` 结算；`net_process_messages` 第 5 个 tick 位挂 `net_udp_tick`。 ## 契约变化（评审重点） 1. **UDP 必须先 `bind`** 才能 `sendto` / `recvfrom` / `net_udp_set_peer`，否则 `-5 NET_ERR_NOTCONN`（芯片侧 Socket 还没开，此时改 DesIP/DesPort 没有落点）。 2. `net_recv` / `net_recv_nb` / `net_recv_to` 对 `DGRAM` 一律 `-3`：它们读的是裸字节流，绕过剥头就是静默吃 8 字节，宁可拒掉。收 UDP 请走 `net_recvfrom` / 新增的 `net_recvfrom_to`。 3. `NET_ERR_NOT_IN_NETTASK`(-12) 不再有运行时返回点（串行化后"不在 netTask 里"不再是错误），保留为历史常量并在头文件写明退役原因。 4. 新增公开 API：`net_recvfrom_to(fd, buf, len, to_ms, src_addr, addrlen)`、`net_udp_set_peer(fd, peer|NULL)`、`net_udp_get_mode(fd)`。 ## 验证 - **主机单测**：`test/host/net_socket` 全套 **647/647 绿**（改造前 470）。新分片 `ns_s7_udp.c` 共 23 组（bind 的 5 条芯片命令顺序、形态剥头逐字节、挂起收包在后续 poll 轮到达、预算超时按调用方 deadline、close/重建/重 bind 结算不许静默丢通知、出参槽互斥与泄漏、截断排空、netTask 自等守卫、参数守卫且拒时零芯片事务、「队列未绑定」与「队列满」两条失败出口不漏槽、芯片 `open` 回 `ERR_BUSY` 时精确码要沿通知值回来、队列里「别人的失败」排在我这条之前不许污染我的回执、轻/重回 SERVER、挂起 send 结算、tick 兜底）；改写 `TC-NETSOCK-440`（补 bind 前置 + 440p~440u）、555、560 组。假件按「只加不改」扩了三处：捕获 `ch395f_write_send_buf` 的真实字节、SENBUF_FREE 写延迟注入、`read_calls` 计数。 - **覆盖率**：`net_udp.c` 237/239 行（99.2%，函数 14/14）、`net_socket.c` 966/969（99.7%，函数 59/59）、全仓 line 90.1%、47/47 套绿；`scripts/test_coverage_baseline.json` 已在本提交内登记新文件。未覆盖两处是有意的：`net_udp.c` 槽越界兜底（调用方已挡）、`net_socket.c` 错误码槽重查竞态（改造前后同为那 2 行）。 - **构建**：Keil MDK ARMCC **0 Error(s), 0 Warning(s)**；`net_udp.o` Code 1,370 / RO 71 / RW 0 / ZI 224（8 fd × 28 B，其余模块零增长）；全仓 Flash 281,012 B（`ER_IROM1` 26.6%）、RAM `RW_IRAM1` 94,624 B（72.2%），92% 红线余量充足。内存台账受管区按门禁提示用 `ram_baseline.py --write / --update` 与 `check_mem_numbers.py --write` 机器回填（`docs/内存管理/` 两份 + `scripts/ram_baseline.tsv` 一行），没有手改数字。台账里「网络」子系统的软配额（12 KB）本轮从超 1.4 KB 变成超 1.6 KB（+256 B），是否抬配额归台账所有者。 - 本机 `pre-commit run`（52 根钩子，含 doc-links / coding-standard / mem-budget / generated-fresh / bsp-err / registration / nested-comment / mojibake）**全绿**；三根 manual 阶段钩子也在本机跑过：`cppcheck` Passed（它抓到 `net_udp.c` 两处 `variableScope`，已修）、`test-cppcheck` Passed、`test-coverage` 就是上面的覆盖率闸门。 - 抓到并修掉的**被测码真 bug** 4 个（细节写进 `主机单测覆盖率口径.md` 第 4 轮）：自等守卫误用调用侧谓词（导致每条正常 recvfrom 都被拒）、芯片长度被读两次、槽指针取在 fd 合法性检查之前、重 bind 静默作废等待者。 ## 限度 / 未做 - **本轮没有板子**：真机回归 5 条（两端互通收发、`set_peer(NULL)` 能否真恢复收广播、截断排空后下一包完整性、挂起 recv 期间的 IWDG 余量、`bind` 写 DesIP 与 open 先后的真芯片效果）已写进覆盖率口径的「台架必验」，主机测试替代不了它们。 - `scripts/stack_report.py` 退出码 1 是 **2026-10-26 起就挂在账上的 `iec104Task` 既有栈债**（`margin 1,016 < 1,024`，见 `docs/代码规范/pre-commit使用说明.md:122`）。本轮只让 `net_bind` 的 UDP 分支多一层静态帧（1,544 → 1,600）；`netTask`（margin 1,904，静态最坏 1,936 / 3,840）与 `timeSyncTask`（1,152）不受影响。抬栈要过 mem-budget 台账，不在本分支自行处理。 - 登记簿销项按仓库约定留给主工作树，本分支不动 `docs/任务规划/**`。 - 模拟器侧（`simulator/sim/net_socket_sim.c` 是 Winsock 实现，不编译 `net_socket.c`）本轮没补 `net_recvfrom_to` / `net_udp_set_peer` / `net_udp_get_mode` 三条对应实现（当前模拟侧无调用者，补了就是死代码）；只验证了 `NET_NO_OS` 口径下改过的 `net_socket.h` 能用 MSVC `/W4` 单独编过。日后 SNTP 若要在模拟器里跑，得先在 sim 侧补这三条。

super_agent_bot force-pushed udp-queue-impl-ddb7c192c16e from a4b8bee209 to a91640dc6e 2026-11-03 18:11:32 +08:00 Compare

super_agent_bot added 1 commit 2026-11-03 18:44:30 +08:00

feat(net/udp): UDP 数据面并入 netMsgQueue 串行执行（#73） ... fff961d803

前置来自 #57 SNTP 调研：旧 net_sendto / net_recvfrom 由调用方直调
SPI 且无限自旋收包，既违约「netTask 是芯片唯一访问者」，又把 IWDG
预算吃在自旋里。

改造面
- 新增 Drivers/BSP/NET/net_udp.c/.h（真机专属，模拟器不编译）：
  bind/set_peer/sendto/recvfrom 四条执行体 + 挂起收包表 + tick；
  net_msg_type_t 加四型，公开 API 一律「入队 → 睡在通知上」。
- 源地址出参不搭 net_msg_t（按值拷贝，AGENTS 禁加回传字段）：改住
  net_udp.c 的 per-fd 槽，netTask 就地写回调用方内存，通知值只带
  结果码；每条出口都清槽，泄漏 = 该 fd 永久 BUSY。
- 发送复用 net_send_locked，不写第二份分块逻辑；「会话是否已死」
  收成一条判据 net_send_state_down()（TCP 看 ESTABLISHED、UDP 看
  UDP_OPEN），原先 4 处各写一遍。
- 顺带修掉真缺陷（新条 TRAP-NET-22）：旧 sendto 把 DesIP 写成具体
  IP，芯片静默切 UDP Client，而旧 recvfrom 无条件剥 8 字节 → SNTP
  这类 48 B 应答丢载荷前 8 字节并交出垃圾源地址。加 udp_mode（塞进
  原有 padding，sizeof 不变）、bind 恒 SERVER、显式对端 sendto 切
  CLIENT、set_peer(fd, NULL) 轻量回 SERVER，仅 SERVER 且 avail >= 8
  才剥头。
- 截断定案：一次调用交付一个数据报，buf 装不下的尾巴用 64 B 栈上
  scratch 排空（不用 clear_recv_buf——它连后面已到达的包一起丢）。
- 取消点接齐：net_init 重建 cancel_all、net_socket 分配 fd clear、
  net_close settle_close + clear、重 bind 前先结算等包者，
  net_process_messages 第 5 个 tick 位挂 net_udp_tick。
- 收紧两处契约（原实现无生产调用者）：UDP 未 bind 一律 -5；
  net_recv / _nb / _to 拒 DGRAM（绕过剥头就是静默吃 8 字节）；
  NET_ERR_NOT_IN_NETTASK(-12) 退役为历史常量并写明原因。

验证
- 主机单测 test/host/net_socket 全套 616/616 绿（改造前 470）：新
  分片 ns_s7_udp.c 20 组，改写 440 / 555 / 560 组；覆盖率
  net_udp.c 234/236（99.2%）、net_socket.c 956/969（98.7%），
  scripts/test_coverage_baseline.json 随本提交登记新文件。
- 测试抓到 4 个被测码真 bug：自等守卫误用调用侧谓词、芯片长度被读
  两次、槽指针取在 fd 合法性检查之前、重 bind 静默作废等待者。
- Keil ARMCC 0 Error(s) 0 Warning(s)；net_udp.o Code 1,358 / ZI 224
  （8 fd × 28 B，其余模块零增长），全仓 RW_IRAM1 72.2%；内存台账
  受管区按门禁提示用 --write / --update 机器回填，未手改数字。
- pre-commit 全量钩子（含 doc-links、coding-standard、mem-budget、
  generated-fresh、bsp-err、registration、nested-comment）全绿。

限度
- 本轮无板子：真机回归 5 条（两端互通、set_peer(NULL) 能否恢复收
  广播、截断排空后下一包完整性、挂起 recv 期间 IWDG 余量、bind 写
  DesIP 与 open 先后的真芯片效果）已写进覆盖率口径「台架必验」。
- scripts/stack_report.py 退出码 1 是 10-26 起挂在账上的 iec104Task
  栈债（margin 1,016 < 1,024，见 docs/代码规范/pre-commit使用说明.md:
  122）；本轮只让 net_bind 的 UDP 分支多一层静态帧（1,544 → 1,600），
  netTask margin 1,888 与 timeSyncTask 1,152 不受影响。抬栈要过
  mem-budget 台账，不在本分支自行处理。
- 登记簿销项按仓库约定留给主工作树，本分支不动 docs/任务规划/**。

super_agent_bot force-pushed udp-queue-impl-ddb7c192c16e from a91640dc6e to fff961d803 2026-11-03 18:44:30 +08:00 Compare

wandering1 commented 2026-11-03 19:00:42 +08:00

Owner

Copy Link

Copy Source

@super_agent_bot 真机回归做完，再并入 master 分支

@super_agent_bot 真机回归做完，再并入 master 分支

super_agent_bot commented 2026-11-03 19:03:21 +08:00

Author

Collaborator

Copy Link

Copy Source

收到：PR #74 在真机回归做完、拿到证据之前不并 master，我这边不提合并。现在先确认这台机器有没有可烧录的 CH395F 板子——有就把「台架必验」5 条跑成证据，没有我把烧录/对端收发步骤和判据整理成一份可执行的台架清单交给你。

收到：PR #74 在真机回归做完、拿到证据之前不并 master，我这边不提合并。现在先确认这台机器有没有可烧录的 CH395F 板子——有就把「台架必验」5 条跑成证据，没有我把烧录/对端收发步骤和判据整理成一份可执行的台架清单交给你。 <!-- dsh-superagent:5ad2a2408f2f4db0e5109023f7b67fb2 -->

super_agent_bot added 1 commit 2026-11-03 20:19:01 +08:00

test(net/udp): 阶段 16 UDP 数据面真机回归台架（板端 + PC peer），台账补实测数字（#73） ... 8a81fa9e41

- 板端 net_layer_udp_bench_test_main：TC-NET-1601~1609，逐步覆盖主机测替代不了的
  5 条台架必验——形态切换与 bind 后首包、48 B 应答在客户端形态的载荷完整（TRAP-NET-22
  的真机对照）、截断包排空、挂起等待期间的 IWDG 余量、DesIP 先于 OPEN_SOCKET 的顺序。
  每步都有 25 s 预算，PC 缺席时报 [FAIL] 而不是把 testTask 钉死。
- PC peer test/host/udp_queue_bench.py：板端先 bind 当服务端，对端地址从收到的包里学
  （PC 是 DHCP，TEST_PC_PEER_IP 那个固定地址不在本机上）；对 >1024 B 的回显额外监听
  第二片，把 net_send_locked 分块在 UDP 上的后果量出来。
- ch395f_test.h：阶段 16 宏默认关（与其它阶段一致），RAM 台账补 2026-11-03 实测——
  台架镜像 RW_IRAM1 96,232 B / 73.4%，阶段 16 自身代价 1,600 B；产品镜像 RW+ZI 与改造前逐字节相同。
- 文档：CH395F_Test_Guide §12.6 跑法与判据 + Python 脚本表加一行；覆盖率口径第 4 轮
  「台架必验」指向本阶段的可执行形态，并写明尚未在真机上跑过。

super_agent_bot commented 2026-11-03 20:27:20 +08:00

Author

Collaborator

Copy Link

Copy Source

This is by an automated agent, not a human.

真机回归台架已就位（阶段 16），但板子没电，实测还做不了

板子在 19:19:22 断电，三处独立证据：ping 192.168.31.100 不通；串口守护日志冻结在 [PROF] t=197121（14,965,244 B，复查 4 s 未增长）；ST-LINK_CLI -c SWD UR 报 No target connected（stlink_flash.py list 仍能看到探针 SN 0B250D12A218303030303032，所以是板子没电，不是工具坏）。只有人能恢复供电/排线，所以先停在这里。

commit 8a81fa9e 把本轮登记的 5 条「台架必验」全部做成了可复现台架，电一来就能跑完：

• 板端阶段 16（NET 层独立入口 net_layer_udp_bench_test_main，TC-NET-1600…1609）
• PC peer test/host/udp_queue_bench.py（板端先 bind 当服务端，对端地址从收到的包里学——本机是 DHCP 192.168.31.161，TEST_PC_PEER_IP 那个固定地址不在本机，所以只能板端先听）

台架必验	用例	真机判据
① 两端互通 + 48 B 小应答载荷完整、源地址正确	1601 / 1602	bind 后 mode=SERVER；收 20 B 校验源地址；回显后 mode=CLIENT；同端口再发 48 B 必须读到 48 且首字节是载荷（判据错就只剩 40）
② set_peer(fd, NULL) 能否真恢复收其它源	1603	mode 回 SERVER、不重开 socket、换新源端口发来的包必须收到（客户端形态会被 DesIP 过滤掉）
③ 截断包排空	1604 / 1605	200 B 用 64 B 缓冲只读 64；紧接着 30 B 必须整包到
④ 挂起 recv 期间的 IWDG 余量	1607	PC 迟到 ~12 s 才发，板端 30 s 预算版醒来拿到正确 24 B；硬证据 = 串口 [ERR][WD] task stall 零条 + [PROF] 心跳连续 + net_get_generation() 不变
⑤ bind 时 DesIP 先于 OPEN_SOCKET	1601 / 1608	bind 后第一包必到；关 socket 重开 bind :6002 后第一包也必到

跑法三步：

1. test/board/test_config.h 开 TEST_SUITE_CH395F；test/board/ch395f_test.h 只开 ENABLE_PHASE16_TESTS，把默认的 11/14 注掉（它们会带进 TEST_LATENCY_PROBE，污染要证的 UDP 面）。
2. 构建烧录后 PC 先起 python test\host\udp_queue_bench.py --board 192.168.31.100（首步每 4 s 重发，能盖住板子启动那段时间）。
3. 两侧都绿才算过：串口 === Phase 16: N/N PASSED (failed=0) === 且 peer 端 === UDP Bench PC Peer: N/N PASSED (failed=0) ===；跑完恢复那四行宏重建产品镜像。

不需要板子的部分已经验完：阶段 16 台架镜像 0 Error(s), 0 Warning(s)（Code 257,176，RW_IRAM1 96,232 B = 73.4%，距 92% 红线余 24,354 B，阶段自身代价就是 net_test_task.o 的 .bss 1,600 B）；四行宏恢复默认后产品镜像同样 0/0，RW+ZI 152,048 B 与改造前逐字节相同（阶段 16 被完整预处理掉）；主机单测 647/647 仍绿；本提交 pre-commit 全档 Passed/Skipped（含 92% RAM 门禁、双端注册反向校验）。

顺带量出来一条（写进 §12.6 限度，不是本次改出来的）：NET_SEND_CHUNK_MAX = 1024 是 TCP 流的分块口径，UDP 上超过 1024 B 的 sendto 会被拆成多个数据报——改造前后是同一条路径，#57 的 SNTP 只有 48 B 碰不到。阶段 16 的 1025 / 1472 两条会在真芯片上把它量出来：peer 收到第二片就 FAIL 并打印各片长度。

真机跑完之前不建议并入 master。跑完我把两侧汇总行与 stall 判据回填到 docs/测试说明/单元测试/主机单测覆盖率口径.md 的「台架必验」条与本 PR。

This is by an automated agent, not a human. ## 真机回归台架已就位（阶段 16），但板子没电，实测还做不了 板子在 19:19:22 断电，三处独立证据：`ping 192.168.31.100` 不通；串口守护日志冻结在 `[PROF] t=197121`（14,965,244 B，复查 4 s 未增长）；`ST-LINK_CLI -c SWD UR` 报 `No target connected`（`stlink_flash.py list` 仍能看到探针 SN 0B250D12A218303030303032，所以是板子没电，不是工具坏）。只有人能恢复供电/排线，所以先停在这里。 commit `8a81fa9e` 把本轮登记的 5 条「台架必验」全部做成了可复现台架，电一来就能跑完： - 板端**阶段 16**（NET 层独立入口 `net_layer_udp_bench_test_main`，TC-NET-1600…1609） - PC peer `test/host/udp_queue_bench.py`（板端先 bind 当服务端，对端地址从收到的包里学——本机是 DHCP `192.168.31.161`，`TEST_PC_PEER_IP` 那个固定地址不在本机，所以只能板端先听） | 台架必验 | 用例 | 真机判据 | |---|---|---| | ① 两端互通 + 48 B 小应答载荷完整、源地址正确 | 1601 / 1602 | bind 后 mode=SERVER；收 20 B 校验源地址；回显后 mode=CLIENT；同端口再发 48 B 必须读到 **48** 且首字节是载荷（判据错就只剩 40） | | ② `set_peer(fd, NULL)` 能否真恢复收其它源 | 1603 | mode 回 SERVER、**不重开** socket、换**新源端口**发来的包必须收到（客户端形态会被 DesIP 过滤掉） | | ③ 截断包排空 | 1604 / 1605 | 200 B 用 64 B 缓冲只读 64；紧接着 30 B 必须整包到 | | ④ 挂起 recv 期间的 IWDG 余量 | 1607 | PC 迟到 ~12 s 才发，板端 30 s 预算版醒来拿到正确 24 B；硬证据 = 串口 `[ERR][WD] task stall` 零条 + `[PROF]` 心跳连续 + `net_get_generation()` 不变 | | ⑤ bind 时 DesIP 先于 `OPEN_SOCKET` | 1601 / 1608 | bind 后第一包必到；关 socket 重开 bind :6002 后第一包也必到 | **跑法三步**： 1. `test/board/test_config.h` 开 `TEST_SUITE_CH395F`；`test/board/ch395f_test.h` 只开 `ENABLE_PHASE16_TESTS`，把默认的 11/14 注掉（它们会带进 `TEST_LATENCY_PROBE`，污染要证的 UDP 面）。 2. 构建烧录后 PC 先起 `python test\host\udp_queue_bench.py --board 192.168.31.100`（首步每 4 s 重发，能盖住板子启动那段时间）。 3. 两侧都绿才算过：串口 `=== Phase 16: N/N PASSED (failed=0) ===` 且 peer 端 `=== UDP Bench PC Peer: N/N PASSED (failed=0) ===`；跑完恢复那四行宏重建产品镜像。 **不需要板子的部分已经验完**：阶段 16 台架镜像 `0 Error(s), 0 Warning(s)`（Code 257,176，`RW_IRAM1` 96,232 B = 73.4%，距 92% 红线余 24,354 B，阶段自身代价就是 `net_test_task.o` 的 .bss 1,600 B）；四行宏恢复默认后产品镜像同样 0/0，`RW+ZI` 152,048 B 与改造前逐字节相同（阶段 16 被完整预处理掉）；主机单测 647/647 仍绿；本提交 pre-commit 全档 Passed/Skipped（含 92% RAM 门禁、双端注册反向校验）。 **顺带量出来一条**（写进 §12.6 限度，不是本次改出来的）：`NET_SEND_CHUNK_MAX = 1024` 是 TCP 流的分块口径，UDP 上超过 1024 B 的 `sendto` 会被拆成**多个数据报**——改造前后是同一条路径，#57 的 SNTP 只有 48 B 碰不到。阶段 16 的 1025 / 1472 两条会在真芯片上把它量出来：peer 收到第二片就 FAIL 并打印各片长度。 真机跑完之前不建议并入 master。跑完我把两侧汇总行与 stall 判据回填到 `docs/测试说明/单元测试/主机单测覆盖率口径.md` 的「台架必验」条与本 PR。

super_agent_bot referenced this issue from a commit 2026-11-03 20:46:27 +08:00

fix(test/udp): peer 换源端口上报方式并补 PC 回路自检（#73）

super_agent_bot added 1 commit 2026-11-03 20:46:27 +08:00

fix(test/udp): peer 换源端口上报方式并补 PC 回路自检（#73） ... b0a6394aa1

- test/host/udp_queue_bench.py：Windows 上未 connect 的 UDP socket 调 getsockname()
  直接抛 WinError 10022（请求一个未连接套接句的名称），脚本在第一条用例就崩。
  源端口改为首次收到回显时打印——它本来就是「板端剥头/源地址判定对不对」的直接读数。
- 新增 test/host/udp_queue_bench_loopback.py：不用板子的 peer 自检，在 127.0.0.1 上放
  一个按板端阶段 16 同样三条规矩说话的假板子（原样回显、tag 0x04 只回 64 B、>1KB 按
  1024 拆片），先把步骤表 / 模式函数 / 分片预期验掉。2026-11-03 首跑 27/27 绿，
  实测拆片形状 [1024, 1] 与 [1024, 448]。
- CH395F_Test_Guide.md §12.6：运行方法补「先跑自检」这一步；>1024 B 的 UDP 拆片从
  「多收到一片就 FAIL」改成「实测观测量」（拼接后逐字节一致才算绿），并说清这是既有
  NET_SEND_CHUNK_MAX 行为、不是本轮引入；脚本表补一行。
- 板子自 19:19 起未再上电（ping 不通、SWD No target、串口静默），阶段 16 真机那一趟
  仍未跑，PR #74 的合并前提不变。

super_agent_bot commented 2026-11-03 20:49:06 +08:00

Author

Collaborator

Copy Link

Copy Source

PR #74 代码侧已完成，现在卡在真机回归：开发板 19:19 起掉电（串口日志冻结、ping 192.168.31.100 不通、SWD No target connected）。方便的话请把板子上电、SWD 和 COM3 接回来，我继续跑阶段 16 取证；如果这台板子暂不可用，告诉我是否把台架步骤交给别人在别处跑。

PR #74 代码侧已完成，现在卡在真机回归：开发板 19:19 起掉电（串口日志冻结、ping 192.168.31.100 不通、SWD No target connected）。方便的话请把板子上电、SWD 和 COM3 接回来，我继续跑阶段 16 取证；如果这台板子暂不可用，告诉我是否把台架步骤交给别人在别处跑。 <!-- dsh-superagent:be1d4af12a5fef304d3b3ff496ec0394 -->

wandering1 commented 2026-11-03 20:49:43 +08:00

Owner

Copy Link

Copy Source

@super_agent_bot 板子已经上电了

@super_agent_bot 板子已经上电了

super_agent_bot commented 2026-11-03 20:50:32 +08:00

Author

Collaborator

Copy Link

Copy Source

收到：板子已上电。这就烧阶段 16 台架镜像、起 PC 对端跑真机回归，取到两端汇总行后把结果回填 PR #74。

收到：板子已上电。这就烧阶段 16 台架镜像、起 PC 对端跑真机回归，取到两端汇总行后把结果回填 PR #74。 <!-- dsh-superagent:77fdeb073adbeb12faf5b2766903a6bb -->

Some checks are pending

Hide all checks

CI / 静态门禁 (pre-commit) (push) Failing after 5m4s

Details

CI / 主机侧单测 (MSVC) (push) Successful in 44s

Details

CI / 静态门禁 (pre-commit) (pull_request) Failing after 4m48s

Details

CI / 主机侧单测 (MSVC) (pull_request) Failing after 44s

Details

This pull request can be merged automatically.

You are not authorized to merge this pull request.

View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.

git fetch -u origin udp-queue-impl-ddb7c192c16e:udp-queue-impl-ddb7c192c16e

git checkout udp-queue-impl-ddb7c192c16e

Sign in to join this conversation.

Reviewers

No Reviewers

Labels

Clear labels

下一顺位

已完成

开放问题

排队

暂缓/不排

等外部资源

观察

进行中

No Label

Milestone

No items

No Milestone

Projects

Clear projects

No project

Assignees

Clear assignees

STF super_agent_bot wandering1

No Assignees

2 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: wandering1/STM32F4-Base#74