40 lines
2.1 KiB
Markdown
40 lines
2.1 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）数据采集 |
|
||
| `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`
|