Files
STM32F4-Base/Drivers/BSP/NET/lftpd
wandering1 8e1cc26c5d fix(ftp): 控制通道超时改字节间隔语义,保活 NOOP 可续命会话
- lftpd_inet_read_line 预算原为「整行总时长」:t0 只在入口置一次,
  保活型客户端的零散短行会被 30s 总预算误掐,会话周期被关闭
- 改为任何字节到达即重置 t0(字节间隔超时);空闲回收语义不变,
  零字节静默满预算仍判超时释放
- 台架 2026-11-13:FileZilla 下载失败三方互证闭环——MobaXterm
  单连接成功、本地探针服务器捕获 FileZilla 第二条控制连接行为、
  ftplib 主机侧下载/上传全过
- 编译 0 错误 0 警告(keil_build)
2026-11-13 16:20:30 +08:00
..
2026-07-21 20:18:28 +08:00

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 §4.1.4 静态化 9 处 大局部缓冲(BSS +4.6KB),使 ftpTask 栈峰值从 3480B 降到 1184B——勿改回局部变量
  • 上传中止截断:FTP STOR 中途断开后首笔复连被截断(TRAP-NET-18)已在 net_socket.c 侧修复
  • 本目录受 pre-commit 的部分排除(第三方代码)

相关文档

  • 测试指南:docs/测试说明/板级测试/FTP_Test_Guide.md
  • 台架探针:test/host/ftp_abort_probe.py、MDK-ARM/ftp_freeze_probe.py
  • 内存优化:docs/内存管理/RAM使用分析与优化方案.md §4.1.4