wandering1
9bbe117f97
用户选定最彻底方案（B2）：DMA + 定时器 TRGO 硬件触发 + 消费上一拍 已完成的半区。对应 P1-5 拆出的"单拍硬上界"，现已办结。 硬件事实更正（查 CubeMX 器件库 + 本仓 HAL 头证实）：F4 上 ADC1 的 外部触发清单里没有 TIM6/TIM7 TRGO（只接 DAC）。故 1 kHz 节拍源由 TIM6 改为 TIM3（PSC 83 / ARR 999，TRGO=UPDATE），同一个更新事件 同时 ① ISR 脉冲 TPAFE CONVST ② 经 TRGO 触发 ADC1 一轮 9 通道 ③ 置位 ADC_WAKE_FLAG 唤醒 adcTask。TIM6 从 .ioc 整体移除。 代码： - Src/tim.c/h：新增 MX_TIM3_Init（含 MasterSlaveMode），删 htim6 - Src/adc.c：ExternalTrigConv=T3_TRGO + EDGE_RISING + DMAContinuousRequests=ENABLE；MspInit 挂 hdma_adc1（DMA2_Stream4 循环模式）。DDS 位关掉 = 一轮只发一次请求，静默丢 8 路 - Src/dma.c：DMA2_Stream4 NVIC 优先级 6（CubeMX 换流会把它重置为 0， 优先级 0 会抢占 FreeRTOS 临界区，违反"外设中断 ≥5"） - Src/main.c：周期回调加 TIM3 分支；stm32f4xx_it.c 向量同步 - App/algo/adc_input.c：stm32_scan() → stm32_take()，逐通道 PollForConversion 全删；乒乓半区由完成计数奇偶推出（只读一个 32 位量 → 与 ISR 无竞态）；STM32 侧数据固定滞后 1 拍 - App/task/adc_task.c：心跳日志拆出四类计数 观测性：adc1_seq（完成计数）/ adc1_gap（seq 前进 >1 = 丢帧）/ adc1_err（连续 ≥2 拍无新帧 = 停摆）/ adc1_hw（HAL 错误回调）。 单拍无新帧是消费者相位伪影（DMA 完成落在唤醒后 ≈67 µs），不计故障。 验证： - 主机单测 79 → 101 全绿；反向验证四连均咬（半区奇偶取反 11 条、 停摆拍置 valid 4 条、STALL_RUN_MAX 改 1 为 6 条、gap 阈值 1 条） - @build 0 错 0 警，Code 256872 → 257660 - @test PASS：adcp 122 µs → 8 µs、adc1_err=0、adc1_hw=0、 adc1_gap=27/20002 拍、adc1_seq 与 seq 恒定偏移 2 - stack_report 7/7 PASS，adcTask 832 B / 余 59%（不变） - cubemx-survival 新增 5 项审计（TIM3 分支 / T3_TRGO / DDS / DMA 挂载 / 流优先级），28 通过 0 失败 文档：ADC 采样节拍设计说明新增 §11；看门狗停摆分析 §4.4 与 §8 收口； 算法规划 L1-1/L1-3、通道映射、测试说明、各 README 同步。
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` | adcTask | AboveNormal | ADC 采集消费：TPAFE5160 快照 + 消费 STM32 ADC1 DMA 乒乓缓冲一帧，经 [`../algo/adc_input.c`](../algo/README.md) **按语义**取数（采样节拍由 TIM3 硬件触发） |
|
||
| `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`
|