QP移植

 以STM32平台为例,该单片机的ARM Cortex-M系列内核正是被QP长期支持,所以QP在ARM Cortex-M系列内核上已经有长时间的应用验证。

在配套书籍PSICC2中的例程为QP最原始的版本4.0.00(只有IAR例程,当然,可以修改汇编文件qk_port.s使适用于其他编译器),当前(2017/04/01)最新版本是5.8.2(直接支持gnu、iar、arm的编译器),以下都是使用最新版本为例。(看过从4.0.00至5.8.2版本的Revision History,官方修复了不少bug)。

qpc5.8.2文件夹与文件:

qpc\

|     +-3rd_party\        -与硬件相关,stm32f4、stm32f7、tms等mcu驱动程序,一般不需要移植,用我们以往常用的(包括CMSIS标准(ARM Cortex)、具体MCU型号相关的lib的.c/.h)

|     +-source\            -qp框架的源文件(src.c),直接复制移植

|     +-include\           -qp框架的头文件(src.h),直接复制移植

|     +-ports\              -存放着跟mcu内核、qp调度方式、编译器相关的接口函数,根据需要选择合适的文件夹

|     |     +-arm7-9\

|     |     +-arm-cm\    -例如选择我们公司常用的Cortex-M系列内核的MCU

|     |     |     +-qk\       -例如用抢占式qk内核的qp框架

|     |     |     |     +-arm\       -例如用keil(ARMCC编译器)建立工程

|     |     |     |     +-iar\

|     |     |     |     +-...\

|     |     |     +-qv\

|     |     |     +-qxk\

|     |     +-msp430\

|     |     +-...\

|     +-examples\  -官方例程:存放官方例程的应用层(状态机)、硬件抽象层(bsp.c),不需要移植,可以参考编写自己的程序。

|     |     +-arm-cm\  -Cortex-M系列MCU的例程

|     |     |     +-game_efm32-slstk3401a\ -PSICC书籍讲述的飞行与射击游戏

|     |     |     |     +-bsp.c  –硬件抽象函数,这个文件可以直接复制然后根据自己需求修改

|     |     |     |     +-main.c –主函数,参考主函数建立自己的工程,包含qp框架初始化

|     |     |     |     +-...    -参考其他状态机函数上手编写自己的状态机

|     |     |     +-...\其他功能例程

|    |     +-...\其他MCU例程

移植完先尝试建立一个状态机,进行简单的状态切换、产生事件、事件派发、事件订阅/派发、事件处理、定时任务、延时任务等,可以测试出该框架有没有遗漏移植的文件。

移植完成后使用中需要注意:

1、 QS是非必要的,是一个调试器,打印信息需要占用一个串口。

2、 Q_onAssert()是断言,在qp框架多处使用,也是用于辅助提示,当出现问题(例如队列溢出、内存池溢出、事件派发失败等)时断言会触发(官方例程是触发后进入while()循环,led闪烁,可以修改成我们需要的操作,例如打印错误信息),这个是调试中使用,产品上线需要关闭此功能。

3、 qp框架的事件回收QF_gc()函数对事件回收时,不会清除事件对应事件内存块的内容,只是将该内存块的指针链接空闲块链表以便下次使用(全局的事件内存池,生存期是整个程序运行期),如果你创建的事件携带参数,但又并不是每次创建都对事件的参数完全重新填充,这样可能会造成垃圾数据重复使用。

4、 QtimeEvt时间事件链表每一个时间事件唯一,例如发送一个时间事件A:2s后处理任务B。如果2s未到达又想要创建一个时间事件A,此时会触发断言。可以修改QTimeEvt_armX()函数,常用有两种处理方式,以第一次创建的时间起点为准,以最后一次创建的为准。

5、 用抢占式qk内核框架,如果高优先级的状态机存在处理时间较长、较频繁的任务,需要注意优先级低的状态机容易出现消息队列溢出、相应的事件内存池溢出,因为低优先级状态机被抢占,事件得不到响应。

6、 看PSICC2书上提到的需要避免的错误

7、 欢迎补充...

三、学习资料与附件

1、官网主页、下载页:https://state-machine.com/(完全开源,官方提供的资料相当完整)

2、官方Revision History:http://www.state-machine.com/qpc/blinky.html

3、http://www.cnblogs.com/hyper99/archive/2015/11/01/QP-zhiQF-yuan-li.html

4、AN_ARM-Cortex-M_Interrupt-Priorities.pdf(中断优先级!)、PSiCC2-CN.pdf(教材,中英文官方都有下)