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。
Drivers/BSP/NET/lftpd/ — 轻量 FTP 服务器（第三方移植）
⚠️ 第三方开源库移植（lftpd，许可证见
LICENSE.txt），非自研代码。 本目录 README 仅说明其在本项目中的定位与对接方式；库内部逻辑请参考上游。
文件一览
| 文件 | 作用 |
|---|---|
lftpd.c/h |
FTP 服务器主体（命令解析、状态机、数据通道） |
lftpd_io.c |
I/O 适配层（本项目对接 FatFs 的关键所在） |
lftpd_inet.c |
网络适配（对接本项目的 BSD Socket API） |
lftpd_log.c |
日志输出适配 |
lftpd_string.c |
字符串工具 |
private/*.h |
内部头文件 |
LICENSE.txt |
上游许可证 |
在本项目中的对接
ftpTask（App/ 侧创建）
↓ 等待 SYS_EVT_NET_READY + SYS_EVT_STORAGE_READY（osFlagsNoClear！）
lftpd（本目录）
├── lftpd_inet.c → Drivers/BSP/NET/net_socket.c（BSD Socket API）
└── lftpd_io.c → Lib/FatFs（文件读写）
⚠️ 项目相关注意
- ftpTask 就绪屏障：
osEventFlagsWait等两位就绪必须加osFlagsNoClear， 否则位被先到的消费者清掉 → FTP 21 端口静默不监听（无日志无报错） - lftpd 大局部缓冲：已按
docs/内存管理/RAM使用分析与优化方案.md§1.4 静态化 9 处 大局部缓冲（BSS +4.6KB），使 ftpTask 栈峰值从 3480B 降到 1184B——勿改回局部变量 - 上传中止截断：FTP STOR 中途断开后首笔复连被截断（Trap 23）已在
net_socket.c侧修复 - 本目录受 pre-commit 的部分排除（第三方代码）
相关文档
- 测试指南：
docs/测试说明/FTP_Test_Guide.md - 台架探针：
MDK-ARM/ftp_abort_probe.py、MDK-ARM/ftp_freeze_probe.py - 内存优化：
docs/内存管理/RAM使用分析与优化方案.md§1.4