wandering1
b7c0889cc7
用户裁定「不要用字母加数字的编号，语义标识是最好的」后的批次二代码半（道 ui-param 执行，逐文件站点数与 自证见其交付）。唯一口径 = 映射表 ci-artifacts/lprot_map.tsv 的功能名列原文，**零自造同义词**；L2.5 与 L-TEST 经实测各 0 处（不是本族），TC 族一字未动。 固件 22 文件 128 处（adc_task.c 21、phasor.c 22、phasor.h 13…），主机测试 13 文件 87 处（pha sor_test.c 57…）；设计文档指针新增 19 行，另 16 只文件本来就写着规划文档 ⇒ 不重复加。 **两条只有真改过 215 处才会踩到的坑，都写进注释规范实践**： · 指针**不能接在原句尾部**——那会替原文一个未闭合的半括号封口，实测咬坏 App/algo/sample_ring.h 这类 跨行句 ⇒ 指针一律**单独成行**； · 号删掉会留下**叠词**（「自检失败闭锁 闭锁判定」「定值校验和 定值巡检」）⇒ 复扫并收口 4 处，措辞只用 映射名本身；具体对象需要留住时写成「自检失败闭锁（采样故障闭锁）」。 自证（不靠嘴说）：改前把 35 只文件原文备份到仓外 temp，逐文件比 `/*`、`*/` 计数、三类括号计数、行数增量 恰等于指针行数、全角括号增删相等、残留号 0 ⇒ **35/35 通过**；Lead 复核后跑权威 @build **0 错 0 警**， Program Size `Code=233900 RO=26104 RW=1536 ZI=136808` —— **与三条道各自改前改后测的四数逐 字节同数**， 这就是「只动注释与文本」的机器证据；八套主机单测 exit 0，cppcheck 按钩子参数零发现，coding-standard 0。 文件头「修改记录」里的号**一并换名、不还原**（Lead 裁定）：这些号是全仓退役的，留一个查无此号的引用比 留一条改过名的条目更坏——「冻结历史不回改」保护的是**别替历史改口**，不是保护一个再也查不到的字符串； id-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