作者：ming_mei

前言

前些日子在微信上看到李肖遙的公眾號，里面系統(tǒng)講述了QP框架，我很有感觸。我用QP框架很多年了，一開始是使用QM和QPC ，到后來拋棄了QM，直接使用QPC裸寫程序，到后來自己寫狀態(tài)機框架。

可以這么說，QP框架引導(dǎo)了我的技術(shù)成長。我共享的博文，雖然都以QP為起點進行展開，但很多東西，都是QP官網(wǎng)的資料所沒有的。我希望接受大家的意見、建議和批評，相信對我來說，會有更大的提升。

這一系列的博文，稱為《當(dāng)單片機遇上狀態(tài)機》系列，暫時先規(guī)劃以下幾篇：

• 入門QP

讓大家開始使用QP，消除對QP的畏難心理，建立起初步的信心。這一步非常重要。

• 從switch-case到框架的進化

大家很難理解，自己用switch-case實現(xiàn)狀態(tài)機，用的好好的，干嘛要用狀態(tài)機框架。這篇博文，就是為了說明，switch-case狀態(tài)機，是如何一步一步進化到一個狀態(tài)機框架的。我們所寫的這個狀態(tài)機框架，和QP之間，到底有著什么關(guān)系，有著多少差距。

• QP的高階使用和QM的使用

QM作為一個輔助工具？它的作用是什么？它是怎么生成代碼的？它和QP之間是什么關(guān)系？在這一篇里，將會做詳細(xì)介紹。

• QP的哲學(xué)

精通QP，理解其哲學(xué)思想非常重要。它的哲學(xué)思想是什么樣的？是如何體現(xiàn)的？

• 其他

后續(xù)的規(guī)劃，我希望根據(jù)大家的反饋意見而定。我用狀態(tài)機框架多年，難免做不到換位思考，不能照顧到初學(xué)者的感受。希望大家踴躍反饋意見。無論是贊揚還是批評，我都虛心接受。

入門QP

我們學(xué)習(xí)一個語言，或者一項技術(shù)，第一件要做的事情，就是實現(xiàn)一個類似于Hello world的最小程序。在單片機上，當(dāng)然就是LED燈的閃爍。不說廢話了，先上代碼。

代碼結(jié)構(gòu)

代碼結(jié)構(gòu)，可以在Keil工程中看到，是一個QP的運行最小系統(tǒng)。QP版本使用的是最新的V6.9.3版本。

為了便于大家的學(xué)習(xí)，我拋棄了官方例程。官方例程有些繁瑣，里面還有大量的doxygen格式的注釋，對初學(xué)者不友好。與官方例程相比，能刪掉的部分，全部都刪掉了，只留下代碼和必要中文注釋，目的就是為了最大限度降低大家學(xué)習(xí)QP的入門門檻，也算是中國特色吧。這四個源碼，代碼未來我們程序架構(gòu)的不同層次，以后所有的例程，就是以這個代碼結(jié)構(gòu)為基礎(chǔ)，進行擴充。

還有一個需要說明的，第一個例程，我并沒有使用QM建模工具進行LED狀態(tài)機的建模和代碼生成。QM工具，本質(zhì)上基于模型的開發(fā)方法，是形式化開發(fā)方法之一。在軟件開發(fā)中，這種方法一直飽受爭議。這個世界現(xiàn)存的大部分軟件框架，是不存在所謂代碼生成工具的。目前我對QM等建模工具持保守態(tài)度，軟件開發(fā)還是要回歸代碼本身，能利用工具，但不要依賴工具。QM工具，我認(rèn)為是QP框架在營銷和商業(yè)上的需求推動的。因此，在未來的教程中，我將QM的使用，放在次要位置，主要還直接編程為主，我認(rèn)為這樣才會給大家?guī)碚嬲奶嵘?

這四個源碼分別是：

• main.c 包含了硬件的初始化、QP框架的初始化、各狀態(tài)機模塊（暫定稱呼，嚴(yán)謹(jǐn)應(yīng)叫AO模塊）的構(gòu)建，框架的啟動等一系列流程。

  
  

• bsp.c 硬件初始化，此處僅包含SysTick的初始化和SysTick中斷函數(shù)。

  
  

• ao_led.c LED狀態(tài)機的源碼。

  
  

• hook.c QP框架的回調(diào)函數(shù)的實現(xiàn)，此處都為空函數(shù)，暫時不予實現(xiàn)。

  
  

• evt_def.h 事件的定義。QP框架的事件定義，使用枚舉實現(xiàn)。個人覺得，事件的定義，如果用字符串實現(xiàn)，更加有利于模塊的解耦和對分布式的支持（這個問題可參考后續(xù)的博客《將軟總線進行到底》）。QP使用枚舉來定義事件，個人認(rèn)為是為了降低RAM和CPU的開銷。

  
  

• 其他

  
  

• QP源碼
• QP接口代碼
• QP框架對硬件平臺或者RTOS的接口源碼。
• MCU相關(guān)代碼，包含Startup文件、CMSIS相關(guān)、固件庫相關(guān)代碼

QP的啟動流程

以下代碼就是QP框架的啟動過程。

#include "qpc.h"                                        // qpc框架頭文件
#include "evt_def.h"                                    // 事件定義頭文件
#include "bsp.h"                                        // 硬件初始化
#include "ao_led.h"                                     // LED狀態(tài)機

Q_DEFINE_THIS_MODULE("Main")        // 定義當(dāng)前的模塊名稱，此名稱在QS和斷言中會使用。

ao_led_t led;                                           // 狀態(tài)機LED對象

int main(void)
{
static QSubscrList sub_sto[MAX_PUB_SIG];            // 定義訂閱緩沖區(qū)
static QF_MPOOL_EL(m_evt_t) sml_pool_sto[128];      // 定義事件池

QF_init();                                          // 狀態(tài)機框架初始化
QF_psInit(sub_sto, Q_DIM(sub_sto));                 // 發(fā)布-訂閱緩沖區(qū)的初始化
QF_poolInit(sml_pool_sto,                           // 事件池的初始化
sizeof(sml_pool_sto),
sizeof(sml_pool_sto[0]));

ao_led_ctor(