docs: clear task and layer shorthand IDs
Replace task/batch shorthand IDs and residual layer labels in human-facing docs with semantic phrases. Add the new cleanup policy to docs/编号规范.md and update the entry docs. Machine keys (TC/CODE-RULE/MENU-STATE/TRAP/FR), hardware designators/pins/MAC, protocol/version numbers and frozen historical evidence are intentionally kept. Docs only; no code behavior change. Verified with check_doc_links.py --all and git diff --check.
This commit is contained in:
@@ -59,7 +59,7 @@ dhara 失败类 +84；RO 另 +208，全是该失败类名表）→ `ER_IROM1`
|
||||
|---|---|---|
|
||||
| 主 SRAM (0x20000000) | 128 KB（RW_IRAM1 Max `0x20000`） | scatter `STM32F407-Demo.sct:22` |
|
||||
| CCM SRAM (0x10000000) | 64 KB；FreeRTOS 堆于 2026-09-21 迁入（§4.1.2） | scatter `STM32F407-Demo.sct:25`；RM0090 §3.1.1 |
|
||||
| FreeRTOS 堆 (heap_4) | **56 KB（57,344 B）**，**位于 RW_CCM**；2026-10-12（B5）由 48 KB 扩容（protectTask/iec104Task 栈入堆，CCM 水位 87.9% < 92% 门禁）；旧 48KB 池实测 `free=8,784 / min_ever=4,848` B（2026-10-03），新池 min_ever 待上板复测 | `Inc/FreeRTOSConfig.h:71` `configTOTAL_HEAP_SIZE`（语义取数与有效性：`.ioc` `FREERTOS.configTOTAL_HEAP_SIZE`） |
|
||||
| FreeRTOS 堆 (heap_4) | **56 KB（57,344 B）**，**位于 RW_CCM**；2026-10-12（保护任务）由 48 KB 扩容（protectTask/iec104Task 栈入堆，CCM 水位 87.9% < 92% 门禁）；旧 48KB 池实测 `free=8,784 / min_ever=4,848` B（2026-10-03），新池 min_ever 待上板复测 | `Inc/FreeRTOSConfig.h:71` `configTOTAL_HEAP_SIZE`（语义取数与有效性：`.ioc` `FREERTOS.configTOTAL_HEAP_SIZE`） |
|
||||
| C 库堆/栈 (startup) | 512 B / 1 KB，启动期 main() 用 | map `startup_stm32f407xx.o` HEAP/STACK 节 |
|
||||
|
||||
### 2.2 静态大项排行（2026-10-10 当前，完整台账 `data/ram_report_20261010.md`）
|
||||
@@ -103,7 +103,7 @@ dhara 失败类 +84；RO 另 +208，全是该失败类名表）→ `ER_IROM1`
|
||||
`Src/freertos.c` 中 `osThreadAttr_t.stack_size` 单位为**字节**（CubeMX 生成代码，`1024 * 4` 表示 4096 字节）：
|
||||
|
||||
> ✅ **本表已于 2026-10-10 重新基线**（产品构建 `suite=NONE`，开机 + 空闲采样，静态链取 `stack_report.py`）。
|
||||
> 同日**增列 `adcTask`**（B1：ADC 采集消费者，512 words，静态最坏链 504 B / 余 75%）。
|
||||
> 同日**增列 `adcTask`**（ADC 采集链路：ADC 采集消费者，512 words，静态最坏链 504 B / 余 75%）。
|
||||
> **2026-10-11 全周傅氏相量层接入后复测**：adcTask 静态 **832 B** / 台架实测峰值 **928 B / 2048（余 54%）**，
|
||||
> 增量为压环 + `phasor_run()`（`win[20]` 80 B）+ `log_phasors` 日志链；仍高于 1024 B 底线，7 任务全 PASS。
|
||||
> **同日采样有效性校验后抬栈 512→640 words**：`adc_health_report`→`syslog_post` 控制台回显尾把静态
|
||||
@@ -111,7 +111,7 @@ dhara 失败类 +84；RO 另 +208，全是该失败类名表）→ `ER_IROM1`
|
||||
> 堆 `min_ever` 7152 → **6640 B**（-512 B，符合预算）。
|
||||
> 此前 2026-10-04 的 V5 30 min 重采曾把 defaultTask 推到 **3664B/4096（余量 432B ≈ 10%，曾登记在案）**；
|
||||
> 2026-10-10 的栈整改（**未抬栈**，见 §4 阶段 0 的"2026-10-10 复测"）把它压回 **2152B/4096**，该项已销项。
|
||||
> **2026-10-12 栈余量收口（登记簿销项，「采集保护收尾」M1）**：B7 定值持久化把 defaultTask 静态链推到 **3016 B**
|
||||
> **2026-10-12 栈余量收口（登记簿销项，「采集保护收尾」M1）**：保护定值持久化把 defaultTask 静态链推到 **3016 B**
|
||||
> （storage_bring_up→cfg 写→f_rename→dhara GC→控制台回显尾），1024 words 余 1080 B < 30% 线；
|
||||
> timeSyncTask 链 **1264 B**（同一控制台回显尾），512 words 余 784 B < ISR 底线 → **抬栈**
|
||||
> defaultTask 1024→**1280**、timeSyncTask 512→**640**（堆 +1536 B，台账 §6 已登记）；
|
||||
@@ -126,9 +126,9 @@ dhara 失败类 +84；RO 另 +208，全是该失败类名表）→ `ER_IROM1`
|
||||
| testTask | `2048*4` | 8KB | 测试套件（产品构建不创建；存储套件深链需要） | 未创建 / 静态 496 B |
|
||||
| defaultTask | `1280*4` | 5KB | FatFS 挂载/探针 + 配置引擎 + syslog + 栈水位探针 | 2152 B（余 41%）/ 静态 **3016 B**（栈余量收口时抬栈 1024→1280，2026-10-12） |
|
||||
| timeSyncTask | `640*4` | 2.5KB | TCP 时间同步 | 616 B（余 50%）/ 静态 **1264 B**（栈余量收口时抬栈 512→640，2026-10-12） |
|
||||
| adcTask | `640*4` | 2.5KB | TPAFE5160 采样消费 + 全周傅氏相量 + 有效性校验（TIM3 1 kHz 节拍，B1→全周傅氏相量→「采样有效性校验」 2026-10-11） | **952 / 2560**（余 1608 B / 62%，台架 `/serial-boot-test` 实测 2026-10-11）；静态 **1320 B**（2026-10-12 复测，保护判据接线后） |
|
||||
| iec104Task | `640*4` | 2.5KB | IEC104 上行服务（默认 2404 监听 + link 状态机，B4 2026-10-12） | 未上板 / 静态 **1456 B**（拆链→重建监听→net_bind→SPI 故障→日志尾，日志主导；512 words 时余 592 B < ISR 底线 → 抬至 640，余 1104 B / 43%） |
|
||||
| protectTask | `512*4` | 2KB | 保护判据节拍（prot_elm_run 消费者 + 「自检失败闭锁」采样闭锁，B5 2026-10-12） | 未上板 / 静态 **872 B**（float 判据 + phasor 快照 + 日志尾，余 1176 B / 57%） |
|
||||
| adcTask | `640*4` | 2.5KB | TPAFE5160 采样消费 + 全周傅氏相量 + 有效性校验（TIM3 1 kHz 节拍，ADC 采集链路→全周傅氏相量→「采样有效性校验」 2026-10-11） | **952 / 2560**（余 1608 B / 62%，台架 `/serial-boot-test` 实测 2026-10-11）；静态 **1320 B**（2026-10-12 复测，保护判据接线后） |
|
||||
| iec104Task | `640*4` | 2.5KB | IEC104 上行服务（默认 2404 监听 + link 状态机，IEC 104 上行 2026-10-12） | 未上板 / 静态 **1456 B**（拆链→重建监听→net_bind→SPI 故障→日志尾，日志主导；512 words 时余 592 B < ISR 底线 → 抬至 640，余 1104 B / 43%） |
|
||||
| protectTask | `512*4` | 2KB | 保护判据节拍（prot_elm_run 消费者 + 「自检失败闭锁」采样闭锁，保护任务 2026-10-12） | 未上板 / 静态 **872 B**（float 判据 + phasor 快照 + 日志尾，余 1176 B / 57%） |
|
||||
| idle（内核） | `configMINIMAL_STACK_SIZE=128` | 0.5KB | 空闲 | 未观测（未取句柄） |
|
||||
| timer（内核） | `configTIMER_TASK_STACK_DEPTH=256` | 1KB | 软定时器 | 未观测 |
|
||||
|
||||
@@ -548,7 +548,7 @@ Linker run 时刻**——commit hash 不是稳定身份（重写正文即换 has
|
||||
|
||||
依据 RM0090 §3.1.1：F407 的 64KB CCM @0x10000000 仅 CPU 可访问（DMA 不可达、无 cache）。
|
||||
|
||||
**进度（2026-09-21）**：第一阶段已落地——scatter 新增 `RW_CCM` 区（`sct:25`，注释 "FreeRTOS heap only"）并把 **FreeRTOS 堆整体迁入**（当时历史快照：49,184 B，CCM 占用 75.3%；现值见 §2.1——2026-10-12 B5 堆已扩至 56 KB）。下表缓冲迁入清单为**后续剩余项**（LVGL 池/UI 缓冲现仍在主 SRAM）；`APP_CCM_ENABLE` 门禁宏**尚未实现**（scatter 无开关，见下"风险门禁"）。
|
||||
**进度（2026-09-21）**：第一阶段已落地——scatter 新增 `RW_CCM` 区（`sct:25`，注释 "FreeRTOS heap only"）并把 **FreeRTOS 堆整体迁入**（当时历史快照：49,184 B，CCM 占用 75.3%；现值见 §2.1——2026-10-12 保护任务 堆已扩至 56 KB）。下表缓冲迁入清单为**后续剩余项**（LVGL 池/UI 缓冲现仍在主 SRAM）；`APP_CCM_ENABLE` 门禁宏**尚未实现**（scatter 无开关，见下"风险门禁"）。
|
||||
|
||||
**迁入 CCM 的缓冲（全部纯 CPU 读写）：**
|
||||
|
||||
@@ -654,7 +654,7 @@ ISR 余量：该任务运行期间可能被中断打断的最深中断链（SPI/
|
||||
|---|---|---|
|
||||
| 主 SRAM 静态占用 | 87,040 B / 128KB（66.4%） | **~27KB / 128KB**（LVGL 池 + UI 缓冲迁 CCM、`ui_net_sink` 关） |
|
||||
| 主 SRAM 余量 | 44,032 B（43.0KB） | **~101KB** |
|
||||
| CCM 使用 | 49,184 B / 64KB（75.0%，FreeRTOS 堆，历史当时值。2026-10-12 B5 后堆 56 KB / 87.9%） | ~56KB / 64KB（堆 32K + 池 16K + UI 缓冲 + BBT） |
|
||||
| CCM 使用 | 49,184 B / 64KB（75.0%，FreeRTOS 堆，历史当时值。2026-10-12 保护任务 后堆 56 KB / 87.9%） | ~56KB / 64KB（堆 32K + 池 16K + UI 缓冲 + BBT） |
|
||||
| 任务栈合计 | 38,912 B（38.0KB） | ~21.5KB（§4.1.3 修正目标） |
|
||||
| FreeRTOS 堆 | 49,152 B（`free=8,784 / min_ever=4,848` B） | 32,768 B（余 ≥8KB，全负载验证） |
|
||||
| **总余量** | **~68KB**（47.9 + 16.0 + 4.8） | **~120KB** |
|
||||
@@ -675,7 +675,7 @@ ISR 余量：该任务运行期间可能被中断打断的最深中断链（SPI/
|
||||
| 步骤 5 | §4.1.1 LVGL 池 40K→16K | UI 全量回归（模拟器 + 实机），无断言失败 | ✅ **2026-10-15**（11 页黄金参考 + 池水位 5,448 B + `/serial-boot-test` 真机 `used=3192`；实测峰值 6,568 B = 池的 40%，§2.6.2） |
|
||||
| 步骤 6 | §4.1.2 CCM（scatter + section + 门禁宏） | map 显示 `RW_CCM`；关 `APP_CCM_ENABLE` 也能编译通过 | ⏸ **暂缓（2026-10-15 裁定）**；已完成部分仅 `RW_CCM` + 堆迁入（09-21），缓冲 section 迁移与门禁宏不再排期 |
|
||||
| 步骤 7 | §4.1.3 栈缩减（按步骤 3 数据）+ 复测 | 每任务 `free_min ≥ 新栈×30%`，无溢出钩子触发 | ⏸ **暂缓（2026-10-15 裁定）**（目标值已按 09-21 实测修正，重开时可直接用） |
|
||||
| 步骤 8 | §4.2.2 堆 48K→32K + 复测 | 全负载 `heap free ≥ 8KB` | ⏸ **暂缓（2026-10-15 裁定）**；⚠ 2026-10-12 B5 反向扩容至 56 KB，重开时须重跑 `stack_report.py` + 上板 `min_ever` |
|
||||
| 步骤 8 | §4.2.2 堆 48K→32K + 复测 | 全负载 `heap free ≥ 8KB` | ⏸ **暂缓（2026-10-15 裁定）**；⚠ 2026-10-12 保护任务 反向扩容至 56 KB，重开时须重跑 `stack_report.py` + 上板 `min_ever` |
|
||||
| 步骤 9 | §4.1.5 小项 + 台账/门禁/AGENTS.md | `/keil-build` + `/serial-boot-test` 全绿 | ◐ AGENTS.md 内存条目已增补（09-21）；台账 / 趋势 / `mem-budget` 三件套 ✅ 2026-10-12（**常开，不受暂缓影响**） |
|
||||
|
||||
每步都必须 `/keil-build` 通过（0 错误 0 警告）后再进入下一步；涉及 UI 的步骤用 `simulator` 先过一遍再上实机。
|
||||
|
||||
Reference in New Issue
Block a user