wandering1
b8c6a3dab0
BREAKING CHANGE: 删除公开 API net_relisten / net_resync_listen / net_can_accept 与消息类型 NET_MSG_RESYNC_LISTEN / NET_MSG_RELISTEN。 生产调用者为零（仅看门狗文档与 iec104 门控），应用侧无迁移成本； 如有外部消费者须改用对账/pump 自动机制（见下）。 1. 对账①扩展为①②⑤（F-NET-2 缺口，先补缺口再删 API） net_reconcile_tick 新增 bad=5：本层 ESTABLISHED 且芯片 0x05/0x01 （Socket OPEN + TCP LISTEN，静默回收回监听、不发 DISCONNECT） → RESYNC 语义只修本层（state→LISTENING + last_peer_port 转登 + lost_conn_seen 清零 + 取消挂起 recv），**不发任何芯片命令** （纪律同 pump③ U11，run8 实证重下发会 170s 永拒）。 原判据①要求 TCP==CLOSED、②要求本层 LISTENING，均不命中此形态 ——此前生产无人认领（仅手动 API 能修）。 2. 删 net_relisten（net_socket.c 函数 + 消息分派 + 头文件声明） footgun：对健康监听器无条件 open→USE→close 自毁 ~1s（原注释自认）； 与 pump(100ms)/D10(30ms) 完全重叠。 3. 删 net_resync_listen（同上；语义并入第 1 条） 4. 删 net_can_accept（net_socket.c + net_socket.h + sim 三处） 只认 ESTABLISHED 的旧门控把"监听器在服役、待 CONNECT"窗口全挡掉， :2404 丢 CONNECT 探针因此从不运行；iec104 门控迁 net_listener_armed。 5. timeSync :8888 会话收尾不再 net_close（同 fd 续 accept，监听跨会话 常驻；原 close→重建每会话一个 Trap 09 沉降窗）。server 脚本注释同步 新契约（PC 侧 2s 宽限后自行关闭）。 6. lftpd 应用层阻塞重试退役：lftpd_inet_listen 5 轮(500ms/2000ms，最坏 10s 阻塞 ftpTask) → 单次 + 失败即 425；cmd_pasv 3×200ms 同删。 就绪屏障已消除 Trap 09 启动形态，客户端自带传输重试语义。 台架实证修正（本提交内二次修复，务必留痕）： - net_listener_armed 补齐 **ESTABLISHED 放行**。首版迁移只放行 LISTENING/CLOSED+残留，漏了 ESTABLISHED=单连接模型的"待 accept"电平 → iec104 200ms 任务周期抢不过对账② 的 ~400ms 去抖，对账②先 standalone accept 转 ESTABLISHED 后 armed=0 → 应用整场不 accept，18/18 检查全 FAIL （设备日志证据：sock1 standalone accept 后无 i104 accepted，直至对端 FIN 才由 closed-with-data 救回）。补放行后 18/18 PASS，且耗时 127s→8.3s。 该态 accept 必返 fd，无 RPC 风暴风险。 - 期间顺带验证 M3 无辜：sock1 suspect DISCONNECT on live conn 命中后 defer→对账①→closed-with-data accept 把未 accept 的 RX 数据救回， 正是 M3 设计意图（资产门保护）。 验证（全绿）：@build 0/0（Code=209580；含 CH395F 套件+Phase13 全量重编 0/0 的编译验证）；@test PASS（回读无差异）；iec104 18/18（8.3s）； n30 0/50；:21 @0ms 50/50 p50=512；:7003 50/50 p50=517；ftp_regression 11/11；Trap23 RST 5/5 + FIN 5/5；time_sync :8888 连续推送正常（RTC 更新、 无 [ERR]）。文档同步：BSD 指南（§3.3/3.6/10.1/10.2/12 + 变更记录）、 函数调用关系、监听生命周期设计说明、IEC104 上行设计说明、模拟器差距 清单、链路延迟测试说明。 门禁说明：doc-links 工作树 junction 伪影按既定口径 SKIP；mem-budget 分支 .map 漂移同前；cppcheck/coding-standard 手跑 Passed。
65 lines
2.6 KiB
C
65 lines
2.6 KiB
C
/*
|
||
* 模块名称：UI Network Sink (RemoDispBus 服务端)
|
||
* 模块功能：实现 RemoDispBus 协议服务端，接收远端连接与导航按键，回送 1bpp 帧缓冲
|
||
* 适用平台：STM32F407ZGTx + CH395F 以太网
|
||
* 作者：王建锋
|
||
* 创建日期：2026-08-29
|
||
* 修改记录：
|
||
* 2026-08-29 王建锋 创建初始版本
|
||
* 2026-08-29 王建锋 修正监听端口为 7003，与 DTU-RemoteLCD 客户端默认端口对齐
|
||
*/
|
||
#ifndef UI_NET_SINK_H
|
||
#define UI_NET_SINK_H
|
||
|
||
#include <stdint.h>
|
||
|
||
#ifdef __cplusplus
|
||
extern "C" {
|
||
#endif
|
||
|
||
/* RemoDispBus 标签与命令 */
|
||
#define UI_REMO_TAG_CLIENT 0xAA
|
||
#define UI_REMO_TAG_DEVICE 0xBB
|
||
#define UI_REMO_CMD_KEEP 0
|
||
#define UI_REMO_CMD_INIT 1
|
||
#define UI_REMO_CMD_KEY 2
|
||
#define UI_REMO_CMD_LCDMEM 3
|
||
|
||
/* UI 推流监听端口（须与 DTU-RemoteLCD 客户端默认端口 7003 一致） */
|
||
#define UI_NET_SINK_PORT 7003
|
||
|
||
/*
|
||
* 函数功能：启动 UI 专用 TCP 监听 Socket
|
||
* 入口参数：port - 监听端口号 uint16_t 1 - 65535
|
||
* 返回值：0 - 成功，其他 - 失败（socket 创建/绑定/监听失败）
|
||
* 限定条件：net_init() 已完成，网络子系统就绪
|
||
* 函数说明：1. 创建流式 Socket 并绑定到指定端口与任意本地地址
|
||
* 2. 进入监听状态，等待远端客户端连接
|
||
* 3. 调用前需确保 CH395F 网络已初始化
|
||
*/
|
||
int ui_net_sink_start(uint16_t port);
|
||
|
||
/*
|
||
* 函数功能：轮询 RemoDispBus 协议（接受连接、收帧、逐字节解析）
|
||
* 入口参数：无
|
||
* 返回值：无
|
||
* 限定条件：ui_net_sink_start() 已成功调用
|
||
* 函数说明：1. 无客户端时先门控（net_listener_armed，纯 RAM 读）再尝试接受连接
|
||
* 2. 有客户端时先门控（net_can_read）再用 DONTWAIT 收帧并解析
|
||
* （KEEPLIVE/INIT/KEY/LCDMEM）；门控判为无数据时仍每 32 轮兜底收一次
|
||
* 3. 对端关闭或异常时复位客户端，等待下次重监听
|
||
* ⚠ **不是"零成本非阻塞"**：门控只消除无谓往返；真有活时仍是
|
||
* "入队 + 等 netTask 回执"（osMessageQueuePut(osWaitForever) +
|
||
* xTaskNotifyWait(portMAX_DELAY)，均无上界；LCDMEM 应答 3204 B 最坏 ≈4 s）
|
||
* → 会拖住宿主（uiTask）的刷新；"搬出 uiTask"已完整评估并**决定不做**
|
||
* （实测刷新最坏周期 = LVGL 帧周期地板，与网络无关），见
|
||
* docs/UI设计/RemoDispBus协议与接收设计说明.md §3
|
||
*/
|
||
void ui_net_sink_poll(void);
|
||
|
||
#ifdef __cplusplus
|
||
}
|
||
#endif
|
||
|
||
#endif /* UI_NET_SINK_H */
|