Blinky實(shí)例分析來(lái)認(rèn)識(shí)一下QP狀態(tài)機(jī)

Blinky是自帶的一個(gè)很簡(jiǎn)單的例子，也就是我們俗稱的”Hello World!”，可以幫助我們了解QP。在這個(gè)blinky中，是以1HZ的速率閃爍LED燈，0.5s開燈，05s關(guān)燈。

關(guān)于Blinky工程

先來(lái)認(rèn)識(shí)QM這個(gè)軟件，我更改了模式，看起來(lái)還不錯(cuò)，

這個(gè)模式在view里可以設(shè)置

然后，新建一個(gè)QM工程

工程打開之后，我們看看工程目錄，

工程當(dāng)中有很多的快捷鍵，很方便，這里如果大家有興趣可以自己熟練一下，接下來(lái)看看具體的代碼以及功能。

實(shí)現(xiàn)的功能

在這個(gè)blinky應(yīng)用中，只有一個(gè)名為Blinky的活動(dòng)對(duì)象，這個(gè)小巧的對(duì)象只應(yīng)用了最基本的QP功能，先看看main函數(shù)。

int main() {
    static QEvt const *blinky_queueSto[10]; /*Blinky的事件隊(duì)列緩沖區(qū) 
*/
    QF_init();  /*初始化框架*/
    BSP_init(); /*初始化BSP*/

    /*實(shí)例化并啟動(dòng)Blinky活動(dòng)對(duì)象*/
    Blinky_ctor(); /*顯式調(diào)用Blinky構(gòu)造函數(shù) */
    QACTIVE_START(AO_Blinky,
        1U,                  /*優(yōu)先級(jí) */
        blinky_queueSto,     /*事件隊(duì)列緩沖區(qū)*/
        Q_DIM(blinky_queueSto), /*緩沖區(qū)的長(zhǎng)度*/
        (void *)0, 0U,       /*私有堆棧（未使用）*/
        (QEvt *)0);          /*初始化事件（未使用）*/
    
    /*讓框架運(yùn)行應(yīng)用程序*/
    return QF_run(); 
}

在這個(gè)demo中，初始化QP框架和bsp包，而且只定義一個(gè)簡(jiǎn)單的Blinky對(duì)象，為Blinky 對(duì)象寫了狀態(tài)機(jī)，然后開始運(yùn)行這個(gè)對(duì)象。

狀態(tài)機(jī)

雙擊Blinky ：QActive , 這個(gè)Blinky AO的狀態(tài)機(jī)如下圖所示：

在這個(gè)狀態(tài)機(jī)最頂端的initial transtion設(shè)定了一個(gè)QP event()中的QTimeEvt_armX())在每隔半秒鐘投遞一次超時(shí)信號(hào)。

QTimeEvt_armX函數(shù)原型如下，準(zhǔn)備一個(gè)時(shí)間事件（一次射擊或定期一次）以直接發(fā)布事件。

void QTimeEvt_armX ( QTimeEvt *const  me,
  QTimeEvtCtr const  nTicks,
  QTimeEvtCtr const  interval 
)  
//Definition at line 297 of file qf_time.c.

點(diǎn)擊下面的off，initial transtion導(dǎo)致狀態(tài)“off”，并在entry中執(zhí)行關(guān)閉LED的操作。

void BSP_ledOff(void) 
{ 
  printf("LED OFF\n"); 
}

當(dāng)TIMEOUT 事件抵達(dá)“off”狀態(tài)的時(shí)候，“off”狀態(tài)將會(huì)遷移到“on”狀態(tài)。

“on”狀態(tài)里的entry 動(dòng)作將會(huì)關(guān)閉LED。

void BSP_ledOn(void)  
{ 
  printf("LED ON\n");  
}

最后，當(dāng)“on”狀態(tài)接收到TIMEOUT 事件，“on”狀態(tài)會(huì)跳轉(zhuǎn)到“off”狀態(tài)，“off”狀態(tài)的entry 動(dòng)作將會(huì)被執(zhí)行關(guān)閉LED操作。

到此，以上的循環(huán)將會(huì)一直重復(fù)，整個(gè)狀態(tài)一直在運(yùn)轉(zhuǎn)了。

看看狀態(tài)機(jī)的代碼

不知道大家看到上面解釋中的代碼有沒(méi)有疑惑，BSP_ledOn()函數(shù)啥都沒(méi)有啊，難道不應(yīng)該控制某個(gè)gpio口來(lái)控制led燈的狀態(tài)嗎？

這里是專門被設(shè)計(jì)成了不需要直接訪問(wèn)目標(biāo)資源，不寫入特定的嵌入式主板的GPIO，而是訪問(wèn)調(diào)用封裝好的BSP，這樣就不需要改變它的狀態(tài)機(jī)代碼了。

對(duì)于不同的硬件平臺(tái)，狀態(tài)機(jī)實(shí)現(xiàn)代碼（blinky.c）是一樣的，只需要更改bsp包就行

工程中blinky.c源碼如下：

我們來(lái)看看主要的代碼：

void Blinky_ctor(void) {
    Blinky *me = (Blinky *)AO_Blinky;
    QActive_ctor(&me->super, Q_STATE_CAST(&Blinky_initial));
    QTimeEvt_ctorX(&me->timeEvt, &me->super, TIMEOUT_SIG, 0U);
}

static QState Blinky_initial(Blinky * const me, void const * const par) {
    (void)par;
    /*0.5s的定時(shí)*/
    QTimeEvt_armX(&me->timeEvt,
        BSP_TICKS_PER_SEC/2,
        BSP_TICKS_PER_SEC/2);
    return Q_TRAN(&Blinky_off);
}

static QState Blinky_off(Blinky * const me, QEvt const * const e) {
    QState status_;
    switch (e->sig) {
        /*狀態(tài)是off} */
        case Q_ENTRY_SIG: {
            BSP_ledOff();
            status_ = Q_HANDLED();//告知框架已經(jīng)處理事件，沒(méi)有別的什么動(dòng)作
            break;
        }
        /*超時(shí)信號(hào) */
        case TIMEOUT_SIG: {
            status_ = Q_TRAN(&Blinky_on);
            break;
        }
        default: {
            status_ = Q_SUPER(&QHsm_top);
            break;
        }
    }
    return status_;
}

static QState Blinky_on(Blinky * const me, QEvt const * const e) {
    QState status_;
    switch (e->sig) {
        /*狀態(tài)是on*/
        case Q_ENTRY_SIG: {
            BSP_ledOn();
            status_ = Q_HANDLED();//告知框架已經(jīng)處理事件，沒(méi)有別的什么動(dòng)作
            break;
        }
        /*超時(shí)狀態(tài)*/
        case TIMEOUT_SIG: {
            status_ = Q_TRAN(&Blinky_off);
            break;
        }
        default: {
            status_ = Q_SUPER(&QHsm_top);
            break;
        }
    }
    return status_;
}

最后是運(yùn)行的結(jié)果，因?yàn)槲覜](méi)有板子，所以就沒(méi)有最終的展示結(jié)果了，其實(shí)就是閃個(gè)燈，后續(xù)再繼續(xù)深入吧。

總結(jié)

一個(gè)簡(jiǎn)單的例子就介紹到這里，實(shí)際上我感覺(jué)還缺少對(duì)這個(gè)框架的理解，比如為什么不控制gpio就可以控制led，還有狀態(tài)機(jī)的運(yùn)行機(jī)制是什么樣的，這里我們主要是實(shí)操，用一個(gè)簡(jiǎn)單的例子來(lái)點(diǎn)個(gè)燈入門一下。

最后，QP感覺(jué)是一個(gè)很深的知識(shí)，我看了很久的書，有些理解，但是無(wú)法下手寫文章表達(dá)出來(lái)，所以一直耽誤，如果有理解不到位的或者錯(cuò)誤的地方，請(qǐng)大家多多諒解。(不知道大家感不感興趣，暫且開個(gè)贊賞，不在數(shù)額，只在出個(gè)頭像有個(gè)排面，感謝！)

嵌入式編程專輯
Linux 學(xué)習(xí)專輯
C/C++編程專輯
Qt進(jìn)階學(xué)習(xí)專輯

這是我另一個(gè)技術(shù)號(hào)，程序員的編程學(xué)習(xí)基地，注重編程思想，歡迎關(guān)注！