wandering1
504db26698
根因：`RAM使用分析与优化方案.md` 顶层有 §1 背景 / §2 现状测量（2.1~2.6），而 §4 「方案」下"阶段 N"的子项也用裸号 0.x / 1.x / 2.x——阶段 2 的 2.1/2.2/2.3 与顶层 2.x **完全同号**，阶段 1 的 1.x 又长得像"第 1 章第 x 节"。`doc-links` 对本文自 引用按设计直接放过，于是门禁和人一起看错：AGENTS.md 把"栈余量台账"写成 §1.4， 而 §1.4 其实是阶段 1 的 lftpd 静态化项（上一笔提交的信息里我把它误判成断链， 已 amend 更正）。 改法：阶段子项一律改层级编号，阶段号不变、只加 `4.` 前缀 —— 0.x→4.0.x、 1.x→4.1.x、2.x→4.2.x。共改 14 个标题；文内自引用与实施序列表（S4~S9 那套）、 暂缓清单、§5 预期效果列里的裸号一并补成 §4.x.y。 外部引用同步 15 处：AGENTS.md、lftpd/README ×2、菜单页面设计、RAM预算台账 ×2、 项目架构总览 ×3、FTP_Test_Guide ×3、boot_log_data/README、部署环境要求、审查 报告、ram_baseline.py ×3。最有说服力的两处歧义：审查报告与 RAM预算台账都写 "缩堆见 …§2.2"——既可读成顶层 §2.2（静态大项排行）也可读成阶段 2 第 2 项， 现均为 §4.2.2（阶段 2 第 2 项"缩堆"）。 另修 4 处把 §1.4 当"栈台账"的错指：采样有效性校验设计说明 :441/:593/:650 改 指 §2.3（任务栈配置与实测峰值）与 §4.0.6（静态最坏链与判定）；id_aliases.json 的 note 改指 §4.0.6 并标注"原 §1.4，2026-10-22 层级编号"。 冻结与示例：其它文档**变更记录行**里的旧编号按项目纪律不改写（项目架构总览 :367、RAM预算台账 :98），改在被引文档 §4 开头留一张换算表 + 约定说明；把旧号 当语法示例写的 7 处一并换掉（文档规范 ×3、check_doc_links ×3、rename_ref ×1）， 否则示例本身指向已改名的锚点。主文档版本行 bump 到 v1.3 / 2026-10-22。 门禁：check_doc_links.py --all --sections-strict → 146 个文档 0 问题（章节引用 2513 处、机器可判定 1491）；check_ids.py --strict 增量拦截通过；mem-numbers、 ram_baseline --gate（SRAM1 57.4% / CCM 87.9%）、task-table 全绿；本轮未改任何 .c/.h。16 个文件字节卫生自查 BOM/CR/U+FFFD/行尾空格全清。已提交本地，未推送。
42 lines
1.9 KiB
Markdown
42 lines
1.9 KiB
Markdown
# Drivers/BSP/NET/lftpd/ — 轻量 FTP 服务器（第三方移植）
|
||
|
||
> ⚠️ **第三方开源库移植**（lftpd，许可证见 [`LICENSE.txt`](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
|