wandering1
593c5d0c84
用户裁定（2026-10-28）：L1/L1.5/L2/L2.5/L3 这套层号「谁能看懂」，改用语义名。 映射（同一批定稿，含 L4/L5）： L1 → 语义取数与有效性 L1.5 → 标定折算 L2 → 全周傅氏相量 L2.5 → 测频与遥测快照 L3 → 保护判据 L4 → 出口与记录 L5 → 动作留痕 实测规模：384 站点 / 62 文件（App/algo、App/task、test/host 六个套件、docs/算法、 产品需求、架构总览、启动顺序、ADC 采样节拍、IEC104 上行、采集短板评测、内存管理、 AGENTS.md、README.md、docs/README.md、.pre-commit-config.yaml 与 scripts 里的注释）。 改法（不是全局替换，逐模式有上下文规则）： - 先吃同位语再落裸词：L1 有效性校验 → 语义取数与有效性校验、L2 相量层 → 全周傅氏 相量层、L3 保护 → 保护判据、L2.5 遥测快照 → 测频与遥测快照，避免「保护判据保护判据」 这类重复（第一版就是这么坏掉的，已整体回滚重做）。 - .c/.h 只改注释：先把字符串字面量切出去（引号数为奇数的跨行注释按整行处理）， C 字符串里的 L2-in ring 之类原样保留——AGENTS 铁律「字符串字面量必须纯 ASCII」。 - 层内条目号（L1-3 / L2-3 这类）**本批不动**，属批次 2；另外三族（UI 菜单层级 L0~L3、链路延迟分段 L1~L8、CubeMX 防丢失三层）也不动，属批次 3。 - 顺手修的措辞：范围写法 L1~L3 → 「分层（语义取数与有效性 → 保护判据）」、 CI 段「不含 L1/L2/L3」→「不含采集链分层」、目录地图里同一处并列表述。 验证：@build 0 错 0 警（Code=236456，与改前逐字节同尺寸——纯注释改动）； 内存布局配图已按新脚本重生成（自检通过）；doc-links --all --sections-strict 通过 （195 文档）；mojibake / bom-guard / coding-standard / 新编号门禁自查 全 rc=0； git diff --check 干净。
App/task/ — FreeRTOS 任务实现
6 个任务的入口函数与任务体。任务创建在
Src/freertos.c（MX_FREERTOS_Init）， 栈大小/优先级的唯一事实源也是Src/freertos.c；本目录只放任务实现。
任务清单
| 文件 | 任务 | 优先级 | 职责 |
|---|---|---|---|
default_task.c/h |
defaultTask | Normal | FTL + FatFS 挂载、配置引擎属主、syslog 唯一写者、LED 指示 |
net_task.c/h |
netTask | Normal | net_stack_bring_up → 置 NET_READY → 循环 net_poll + net_process_messages |
ui_task.c/h |
uiTask | BelowNormal | LVGL 界面（菜单 / 内容页 / 待机）+ 推流 |
adc_task.c/h |
adcTask | AboveNormal | ADC 采集消费：TPAFE5160 快照 + 消费 STM32 ADC1 DMA 乒乓缓冲一帧，经 ../algo/adc_input.c 按语义取数（采样节拍由 TIM3 硬件触发） |
rs485_task.c/h |
（RS-485 任务） | — | 半双工 RS-485 协议通信 |
../sync/time_sync.c |
timeSyncTask | Normal | 墙钟时间同步（实现不在本目录，见 ../sync/README.md） |
上表栈大小/优先级以
Src/freertos.c为准（README.md/AGENTS.md的任务表由scripts/gen_task_table.py生成，勿手抄）。
就绪屏障（重要）
任务间不用魔法延时，改用 App/app/sys_events.h 的 Event Flags：
SYS_EVT_NET_READY/SYS_EVT_STORAGE_READY等是状态位——等待时必须osFlagsWaitAny|osFlagsNoClear，不能用默认消费型等待（否则先到的消费者会清掉位， 导致ftpTask的WaitAll(两位)永不成立 → FTP 静默不监听）SYS_EVT_CFG_SAVE/SYS_EVT_NET_RECONFIG等命令位保持消费型等待
平台约束（改本目录前必读）
- 内核启动前禁止任何 FreeRTOS/CMSIS-RTOS API 调用（
osMessageQueueNew等会杀死启动） - 就绪屏障位一律用
osFlagsNoClear - 内存预算紧张，改栈/缓冲前先核算（
docs/内存管理/）
相关文档
- 启动顺序与屏障：
docs/架构设计/项目启动顺序管理.md - 内存与定栈规则：
docs/内存管理/RAM使用分析与优化方案.md - 栈水位实测：
scripts/stack_report.py