QP/C：一个专门为资源受限的 MCU 量身定制，小巧可裁剪的实时操作系统（RTOS）

嵌入式开发是不是常常让你感觉像在放飞自我？各种中断、任务调度、状态机……分分钟被搞蒙。别急，今天给你安利一个神器——QP/C（Real-Time Event Framework），让你的项目秒懂事件驱动，效率暴涨。

什么是 QP/C？
QP/C，全称 QP/C Real-Time Event Framework，是一套轻量级的异步、事件驱动的 Active Object（也叫 Actor）模型框架。它本质上就是一个小巧可裁剪的实时操作系统（RTOS），专门为资源受限的 MCU 量身定制。尤其擅长分层状态机（Hierarchical State Machines），用 UML 2.5 标准来规范行为。

能帮你干啥？

• • 把复杂逻辑拆成自包含的 Active Objects，解耦又清晰。

• • 提供确定性的调度，满足硬实时需求。

• • 支持事件排队、发布/订阅机制，数据和控制完美分离。

• • 附带 QM 模型工具和 QTools，开发效率直线上升。

解决了哪些痛点？

1. 1. 任务堆栈管理繁琐？QP/C 用事件队列自动搞定。

2. 2. 状态机写一大堆 switch-case、goto？框架让状态、转换一目了然。

3. 3. 多任务优先级混乱，死锁、饥饿？内置优先级调度，安全无忧。

4. 4. 可移植性差？同一套代码轻松跑在不同 MCU 上。

QP 框架家族一览

如何安装与使用

1. 1. 克隆仓库：

   git clone https://github.com/QuantumLeaps/qpc --recurse-submodules --depth 1

2. 2. 进入目录，照 README 配置交叉编译器。

3. 3. 运行示例 “Blinky” 应用，几行代码就能点亮 LED。

4. 4. 把你的逻辑封装成 Active Object，交给 QP/C 花式调度。

示例代码（极简版）：

#include "qpc.h"

typedef struct BlinkyTag {
    QActive super;
    QTimeEvt timeEvt;
} Blinky;

static QState Blinky_initial(Blinky *me){
    return Q_TRAN(&Blinky_blink);
}

static QState Blinky_blink(Blinky *me){
    switch(Q_SIG(me)){
        case Q_ENTRY_SIG:
            HAL_LED_ON();
            QTimeEvt_postIn(&me->timeEvt, Q_ACTIVE_CAST(QActive, me),50);
            return Q_HANDLED();
        case Q_TIMEOUT_SIG:
            HAL_LED_TOGGLE();
            QTimeEvt_postIn(&me->timeEvt, Q_ACTIVE_CAST(QActive, me),50);
            return Q_HANDLED();
     }
     return Q_SUPER(&QHSM_top);
}

int main(void){
    QF_init();
    static Blinky blinky;
    QActive_ctor(&blinky.super, Q_STATE_CAST(QStateHandler,&Blinky_initial));
    QActive_start(&blinky.super,1U,(void*)&blinky.timeEvt,sizeof(blinky.timeEvt),0U,0);
    ...
}

优缺点对比表

总结
QP/C 真真切切是嵌入式实战利器，让复杂状态机和任务调度在事件驱动下井然有序。不管你是爱折腾的发烧友，还是对稳定性有极高要求的商业项目，都能从中受益。想要更深入、更完整的功能，赶快前往下方项目地址吧！

项目地址：https://github.com/QuantumLeaps/qpc