# c51_task **Repository Path**: wenhuafeng/c51_task ## Basic Information - **Project Name**: c51_task - **Description**: 8051 MCU 任务管理 - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-03 - **Last Updated**: 2026-11-03 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # tasks —— 协作式任务调度框架 不含厂商私有依赖:显示、DAC、蓝牙协议栈、文件系统、板级上电时序,全部通过 5 个钩子由应用层挂回来。 - 无操作系统、无独立栈、无上下文切换 - 单线程执行,不需要互斥量 - 纯 C89,`unsigned char/short/long`,可在 IAR EW8051、SDCC、Keil C51、GCC 下编译 ## 文件说明 | 文件 | 行数 | 作用 | |---|---|---| | `task_port.h` | 74 | 移植层:基础类型、编译器适配、tick 周期、喂狗、临界区 | | `task_cfg.h` | 26 | 模式裁剪开关(等价原 `config_setting.h` 里的 `TASK_XXX_EN`) | | `task.h` | 111 | 模式枚举、`type_task_ctl`、全部接口声明 | | `task.c` | 296 | `task_init` / `task_clear` / `run_task` / 消息队列 / 时基 / 抢占 | | `task_demo.c` | 157 | 3 个模式模板(`task_music` / `task_fm` / `task_idle`)+ 钩子示例 | 默认只启用 `TASK_MUSIC`、`TASK_FM`、`TASK_IDLE` 三个模式,其余按需自行添加。 ## 快速上手 **1. 把整个 `tasks/` 目录拷进工程,加入编译** **2. 在 `task_cfg.h` 打开需要的模式** ```c #define TASK_BT_EN 1 ``` **3. 在 `task.h` 的枚举里加模式号(放在 `TASK_IDLE` 之前)** ```c enum { TASK_NULL = 0, TASK_MUSIC, TASK_FM, TASK_BT, /* 新增 */ TASK_IDLE, TASK_EXIT /* 退出请求,必须留在最后 */ }; ``` **4. 在 `task.h` 声明、`task.c` 的 `switch` 与 `tbl_task_order[]` 里各加一条** ```c /* task.h */ #if TASK_BT_EN extern void task_bt(void); #endif /* task.c —— run_task 的 switch */ #if TASK_BT_EN case TASK_BT: task_ctl.last_work = TASK_BT; task_bt(); break; #endif /* task.c —— 轮换顺序 */ #if TASK_BT_EN TASK_BT, #endif ``` **5. 实现模式函数(照 `task_demo.c` 的三段式)** ```c void task_bt(void) { SCH_U8 msg; /* 进入:播报、加载算法库、初始化显示 */ while (IS_TASK(TASK_BT)) { task_event(); /* 公共事件:来电/插卡/低电抢占 */ msg = get_msg(); switch (msg) { case KU_MODE: task_ctl.work_sta = TASK_EXIT; break; default: break; } /* 刷新显示 */ } /* 退出:停播放、释放资源 */ } ``` **6. 主函数与中断** ```c void main(void) { sys_init(); /* 你自己的初始化 */ msg_init(msg_pool, MSG_POOL_DEPTH); /* 可选,不调用则用内部缓冲 */ task_demo_install_hooks(); /* 注册你自己的钩子 */ run_task(); /* 不返回 */ } /* 定时器中断,周期 = TASK_TICK_MS */ void timer_isr(void) { task_tick(); /* 产生 QSYSTEM_1S / QSYSTEM_10S */ } /* 按键扫描 */ put_msg(KU_MODE); ``` ## API 速查 ### 调度核心 | 接口 | 说明 | |---|---| | `void run_task(void)` | 主循环,不返回 | | `void task_init(void)` | 状态初始化(`work_sta = TASK_IDLE`、清队列、调 init 钩子) | | `void task_clear(void)` | 每次切模式后:喂狗、清队列、调 clear 钩子 | | `type_task_ctl task_ctl` | `work_sta` / `last_work` / `work_sub` / `dev_*` | | `IS_TASK(id)` | 判断当前模式,等价 `task_ctl.work_sta == id` | ### 模式切换 | 接口 | 说明 | |---|---| | `task_ctl.work_sta = id` | 直接切(最常用) | | `void task_switch(id)` | 同上,函数形式 | | `void task_exit(void)` | `TASK_MENU_EN` 为 1 回菜单,否则按表轮换 | | `void task_next(void)` | 按 `tbl_task_order[]` 切下一个,末尾回绕 | | `task_ctl.work_sta = TASK_EXIT` | 请求退出当前模式(`run_task` 收到后调 `task_exit()`) | ### 抢占 | 接口 | 说明 | |---|---| | `void task_interrupt(id)` | 记录当前模式到 `work_sta_interrupt`,再切到 `id` | | `SCH_U8 task_take_interrupt(void)` | 取出并清零,返回 0 表示正常进入 | | `void task_restore_interrupt(void)` | 回到被抢占前的模式并清零 | | `work_sta_interrupt` | 全局变量,可自行判断 | ### 消息队列 | 接口 | 说明 | |---|---| | `void msg_init(SCH_U8 *pool, SCH_U8 depth)` | `pool` 传 0 用内部缓冲;`depth` 向下取整到 2 的幂 | | `void put_msg(SCH_U8 msg)` | 投递,可在中断里调用 | | `SCH_U8 get_msg(void)` | 无消息返回 `QSYSTEM_NONE(0)` | | `void flush_msg(void)` | 清空队列 | | `SCH_U16 task_msg_dropped(void)` | 队列满导致的丢弃累计次数 | ### 时基 | 接口 | 说明 | |---|---| | `void task_tick(void)` | 定时器中断里每 `TASK_TICK_MS` 调一次 | | `SCH_U16 task_ms(void)` | 毫秒计数(16 位,约 65 秒回绕) | | `SCH_U32 task_uptime_s(void)` | 上电秒数 | ### 应用层钩子 | 钩子 | 对应原 SDK | 调用时机 | |---|---|---| | `task_set_init_hook()` | `task_init()` 里的板级初始化 | `run_task()` 开始时一次 | | `task_set_clear_hook()` | `task_clear()` 里的显示/静音复位 | 每次切模式后 | | `task_set_event_hook()` | `comm_event(1)` | `task_event()` 被调用时(模式循环里) | | `task_set_1s_hook()` | `ui_comm.c` 的 `QSYSTEM_1S` 分支 | 每秒一次(中断上下文) | | `task_set_tick_hook()` | `timer5ms_hook()` 里的扫描 | 每 `TASK_TICK_MS` 一次(中断上下文) | ## 消息约定 - `0` 表示"无消息",`put_msg(0)` 被忽略 - 保留:`QSYSTEM_1S(0x01)`、`QSYSTEM_10S(0x02)` - 业务消息从 `MSG_USER(0x10)` 开始编号 - 队列深度必须是 2 的幂(内部用位与取模),**实际可用条数 = depth - 1** - 队列满时丢弃新消息(不覆盖旧消息),并累加 `task_msg_dropped()` ## 移植 只改 `task_port.h` 三处: 1. `TASK_TICK_MS`:与你定时器中断周期一致(默认 5ms) 2. `TASK_WATCHDOG_CLR()`:指向你的喂狗宏,没有就留空 3. `TASK_USE_CRITICAL`:中断里会 `put_msg()` 时置 1(EW8051 下默认已置 1) 若宿主工程已定义 `u8/u16/u32`(如原 SDK 的 `include.h`),加编译选项 `-DTASK_HAS_APP_TYPES` 即可复用,不必重复 typedef。 8051 下 `TASK_CODE` 展开为 `const __code`(模式表放代码段),`TASK_MSG_ATTR` 展开为 `__no_init __xdata`(队列不占 idata)。 ## 与原 `task/` 的差异 | 项目 | 原 `task/` | 本框架 | |---|---|---| | 模式数量 | 27 个,全部实现 | 3 个模板,按需添加 | | `TASK_XXX_EN` | `config_setting.h` | `task_cfg.h` | | 队列 / 时基 / 抢占 | 闭源库 + 用户代码 | 框架自带,函数名不变 | | 板级初始化 | 写在 `task_init()` 里 | `init` 钩子 | | 显示/静音复位 | 写在 `task_clear()` 里 | `clear` 钩子 | | 公共事件 | 每个 `task_xxx_event()` 手写 `comm_event(1)` | 同样手写,改为调 `task_event()` + 注册钩子 | | 定时检查 | `ui_comm.c` 里 `QSYSTEM_1S` 分支 | `1s` 钩子 | | 代码段布局 | `#pragma location="TASK_BT_SEG"` 等 | 未提供,需要时自行添加 | | 子状态机 | `task/sub/tasksub_*.c` | 只有 `work_sub` 字段 | ## 已知限制 - **无优先级、无抢占式切换**:只能靠 `task_interrupt()` 在公共事件里改 `work_sta` 实现"软抢占" - **模式函数忘记改 `work_sta` 就返回** → `task_clear()` 空转(原工程同样有此风险) - **`task_clear()` 里的 `flush_msg()`** 会丢掉切模式瞬间积压的系统消息(继承原工程行为) - **单队列、无优先级、无 ACK**:重要事件请用 `sys_ctl` 类全局状态兜底 ## 验证 host 下自测(临时文件已删除,可自行恢复): ```bash gcc -std=c89 -pedantic -Wall -Wextra -Werror -c task_demo.c -o demo.o ``` 覆盖:枚举值、`task_init` 默认状态、FIFO / 满队列 / `0` 不投递、外部缓冲与非 2 的幂深度、 `tick` 钩子与 1s 钩子、`QSYSTEM_1S`/`QSYSTEM_10S` 投递、丢弃计数、抢占记录与恢复、 `task_exit` 轮换与回绕、`run_task` 分发(IDLE → MUSIC → `TASK_EXIT` → FM)、enter/exit 各一次。