wandering1
d59c2198eb
新增 App/algo/adc_input.c/h（L1 采集与预处理层，落实 L1-3/L1-4）：
- L1-4 语义通道映射表 k_adc_map[]：UA/UN/IA → TPAFE buf[6]/[5]/[2]；
UB/UC/IB/IC/IN/TEMP → STM32 ADC1 CH14/3/6/1/2/5。消费侧一律经
adc_input_raw() 按语义取数，不写死下标（V0.2 改版只改表内容）。
- L1-3 STM32 ADC1 9 通道软件触发顺序扫描：HAL_ADC_Start + 逐通道
PollForConversion/GetValue（EOC_SINGLE_CONV + 无 DMA，可逐通道轮询）。
- adc_input_poll() 统一"TPAFE 原子快照 + STM32 扫描"；
adc_input_init() 做映射自检（STM32 映射通道必落在扫描序列内，否则
返回 -1），挡住"映射到不扫描的通道 → 恒读陈旧值"的静默错。
集成：
- adc_task.c 取数改走 L1 层（首帧日志补全 8 路 + 温度；心跳增
adc1_rc/adc1_err 观测 STM32 侧健康度）。
- app_main.c 在 tpafe5160_init() 之后调 adc_input_init()，失败记
SYSLOG_SELFTEST("ADC map fault")。
- Keil 工程挂 adc_input.c 并加 ../App/algo 包含路径。
- 文档同步：继电保护规划 §1.2/§3.1（L1-3/L1-4 改 ✅）、ADC通道映射说明
§7/§8/§9、产品需求 §5.9/§9、架构总览 §7、AGENTS.md、App/README.md、
App/task/README.md、新增 App/algo/README.md、boot_log_data 清单。
验证：
- @build 0 错 0 警；镜像无源文件新于 hex。
- 台架 @test PASS：ADC input layer init OK、adc1_rc=0/adc1_err=0
（30 s ≈27 万次转换零超时）、seq 仍 1000.0 Hz、adc 栈峰值
528→584 B（余 71%）、回读一致、零 [ERR]/HardFault。
证据 docs/测试说明/boot_log_data/20261010_prod_adc_l1_boot_log.txt
- 内存快照已刷新（Flash 269,404→270,712 B）。
40 lines
2.2 KiB
Markdown
40 lines
2.2 KiB
Markdown
# 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` | （ADC 任务） | — | ADC 采集消费：TPAFE5160 快照 + STM32 ADC1 顺序扫描，经 [`../algo/adc_input.c`](../algo/README.md) **按语义**取数（采样节拍由 TIM6 硬件触发） |
|
||
| `rs485_task.c/h` | （RS-485 任务） | — | 半双工 RS-485 协议通信 |
|
||
| `../sync/time_sync.c` | timeSyncTask | Normal | 墙钟时间同步（实现不在本目录，见 [`../sync/README.md`](../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`
|