嵌入式框架Zorb Framework搭建五:事件的实现

嵌入式框架Zorb Framework搭建过程

嵌入式框架Zorb
Framework搭建一:嵌入式环境搭建、调试输出和建立时间系统

嵌入式框架Zorb
Framework搭建二:环形缓冲区的实现

嵌入式框架Zorb
Framework搭建三:列表的实现

嵌入式框架Zorb
Framework搭建四:状态机的实现

嵌入式框架Zorb
Framework搭建五:事件的实现

嵌入式框架Zorb
Framework搭建六:定时器的实现

嵌入式框架Zorb
Framework搭建七:任务的实现

 

二、事件功能设计

  我们先来看看要实现的事件提供什么功能:

  初步要提供的功能如下:

  1、可以生成事件

  2、事件里边应该有事件处理函数

  3、可以添加事件处理函数的参数

  4、最好事件可以有优先级,优先级高的先执行

88bf必发娱乐,  5、最好事件可以自动回收

  因此,初步设计的数据结构如下: 

 1 /* 事件结构 */
 2 struct _Event
 3 {
 4     uint8_t Priority;               /* 优先级 */
 5     IEventProcess EventProcess;     /* 事件程序 */
 6     List *pArgList;                 /* 事件程序的参数指针 */
 7     
 8     /* 增加程序参数(深拷贝,按先后顺序入队列) */
 9     bool (*AddArg)(Event * const pEvent, void *pArg, uint32_t size);
10     
11     /* 销毁事件 */
12     bool (*Dispose)(Event * const pEvent);
13 };
14 
15 /* 事件处理器结构 */
16 struct _EventHandler
17 {
18     List *pEventList;   /* 事件列表 */
19     bool IsRunning;     /* 是否正在运行:默认开 */
20     
21     /* 获取事件数 */
22     uint32_t (*GetEventCount)(EventHandler * const pEventHandler);
23     
24     /* 增加事件(按优先级排序) */
25     bool (*Add)(EventHandler * const pEventHandler, Event *pEvent);
26     
27     /* 删除事件(释放空间) */
28     bool (*Delete)(EventHandler * const pEventHandler, Event *pEvent);
29     
30     /* 清空事件列表(释放空间) */
31     bool (*Clear)(EventHandler * const pEventHandler);
32     
33     /* 销毁事件处理器(释放空间) */
34     bool (*Dispose)(EventHandler * const pEventHandler);
35     
36     /* 执行事件(按列表位置) */
37     void (*Execute)(struct _EventHandler * const pEventHandler);
38 };

  事件和事件处理器已经设计好了,再定义一个宏来帮助推送事件。

1 /* 推送事件 */
2 #define EVENT_POST(handler_, event_) handler_->Add(handler_, event_)

  具体实现请看附件代码或在文末的github地址拉框架源码。

 

二、状态机设计

  我们先来看看要实现的状态机提供什么功能:

  初步要提供的功能如下:

  1、可以设置初始状态

  2、可以进行状态转换

  3、可以进行信号调度

  4、最好可以在进入和离开状态的时候可以做一些自定义的事情

  5、最好可以有子状态机

  因此,初步设计的数据结构如下: 

 1 /* 状态机结构 */
 2 struct _Fsm
 3 {
 4     uint8_t Level;                  /* 嵌套层数,根状态机层数为1,子状态机层数自增 */
 5                                     /* 注:严禁递归嵌套和环形嵌套 */
 6     List *ChildList;                /* 子状态机列表 */
 7     Fsm *Owner;                     /* 父状态机 */
 8     IFsmState OwnerTriggerState;    /* 当父状态机为设定状态时,才触发当前状态机 */
 9                                     /* 若不设定,则当执行完父状态机,立即运行子状态机 */
10     IFsmState CurrentState;         /* 当前状态 */
11     bool IsRunning;                 /* 是否正在运行(默认关) */
12     
13     /* 设置初始状态 */
14     void (*SetInitialState)(Fsm * const pFsm, IFsmState initialState);
15     
16     /* 运行当前状态机 */
17     bool (*Run)(Fsm * const pFsm);
18     
19     /* 运行当前状态机和子状态机 */
20     bool (*RunAll)(Fsm * const pFsm);
21     
22     /* 停止当前状态机 */
23     bool (*Stop)(Fsm * const pFsm);
24     
25     /* 停止当前状态机和子状态机 */
26     bool (*StopAll)(Fsm * const pFsm);
27     
28     /* 释放当前状态机 */
29     bool (*Dispose)(Fsm * const pFsm);
30     
31     /* 释放当前状态机和子状态机 */
32     bool (*DisposeAll)(Fsm * const pFsm);
33     
34     /* 添加子状态机 */
35     bool (*AddChild)(Fsm * const pFsm, Fsm * const pChildFsm);
36     
37     /* 移除子状态机(不释放空间) */
38     bool (*RemoveChild)(Fsm * const pFsm, Fsm * const pChildFsm);
39     
40     /* 调度状态机 */
41     bool (*Dispatch)(Fsm * const pFsm, FsmSignal const signal);
42     
43     /* 状态转移 */
44     void (*Transfer)(Fsm * const pFsm, IFsmState nextState);
45     
46     /* 状态转移(触发转出和转入事件) */
47     void (*TransferWithEvent)(Fsm * const pFsm, IFsmState nextState);
48 };

  关于信号,Zorb Framework做了以下定义:

1 /* 状态机信号0-31保留,用户信号在32以后定义 */
2 enum {
3     FSM_NULL_SIG = 0,
4     FSM_ENTER_SIG,
5     FSM_EXIT_SIG,
6     FSM_USER_SIG_START = 32
7     /* 用户信号请在用户文件定义,不允许在此定义 */
8 };

  其中,0-31为框架信号,用户信号在32之后定义。

  状态机已经设计好了,具体实现请看附件代码或在文末的github地址拉框架源码。

 

三、事件结果测试

  简单的测试代码如下:

  1 /**
  2   *****************************************************************************
  3   * @file    app_event.c
  4   * @author  Zorb
  5   * @version V1.0.0
  6   * @date    2018-06-28
  7   * @brief   事件测试的实现
  8   *****************************************************************************
  9   * @history
 10   *
 11   * 1. Date:2018-06-28
 12   *    Author:Zorb
 13   *    Modification:建立文件
 14   *
 15   *****************************************************************************
 16   */
 17 
 18 #include "app_event.h"
 19 #include "zf_includes.h"
 20 
 21 /* 事件处理器 */
 22 static EventHandler *pEventHandler;
 23 
 24 /******************************************************************************
 25  * 描述  :事件程序1
 26  * 参数  :(in)-pArgList 事件参数列表指针
 27  * 返回  :无
 28 ******************************************************************************/
 29 void EventProcess1(List *pArgList)
 30 {
 31     uint32_t i;
 32     
 33     ZF_DEBUG(LOG_D, "\r\n");
 34     ZF_DEBUG(LOG_D, "event1 arg count is %d\r\n", pArgList->Count);
 35     for (i = 0; i < pArgList->Count; i ++)
 36     {
 37         ZF_DEBUG(LOG_D, "event1 arg %d is %s\r\n", i,
 38             pArgList->GetElementDataAt(pArgList, i));
 39     }
 40 }
 41 
 42 /******************************************************************************
 43  * 描述  :事件程序2
 44  * 参数  :(in)-pArgList 事件参数列表指针
 45  * 返回  :无
 46 ******************************************************************************/
 47 void EventProcess2(List *pArgList)
 48 {
 49     uint32_t i;
 50     
 51     ZF_DEBUG(LOG_D, "\r\n");
 52     ZF_DEBUG(LOG_D, "event2 arg count is %d\r\n", pArgList->Count);
 53     for (i = 0; i < pArgList->Count; i ++)
 54     {
 55         ZF_DEBUG(LOG_D, "event2 arg %d is %s\r\n", i,
 56             pArgList->GetElementDataAt(pArgList, i));
 57     }
 58 }
 59 
 60 /******************************************************************************
 61  * 描述  :任务初始化
 62  * 参数  :无
 63  * 返回  :无
 64 ******************************************************************************/
 65 void App_Event_init(void)
 66 {
 67     Event *pEvent; /* 事件指针 */
 68     
 69     /* 初始化事件处理器 */
 70     EventHandler_create(&pEventHandler);
 71     
 72     /* 创建事件1 */
 73     Event_create(&pEvent);
 74     pEvent->EventProcess = EventProcess1;
 75     pEvent->AddArg(pEvent, "hello", sizeof("hello") + 1);
 76     
 77     /* 推送事件1 */
 78     EVENT_POST(pEventHandler, pEvent);
 79     
 80     /* 创建事件2 */
 81     Event_create(&pEvent);
 82     pEvent->EventProcess = EventProcess2;
 83     pEvent->AddArg(pEvent, "zorb", sizeof("zorb") + 1);
 84     pEvent->AddArg(pEvent, "framework", sizeof("framework") + 1);
 85     
 86     /* 推送事件2 */
 87     EVENT_POST(pEventHandler, pEvent);
 88 }
 89 
 90 /******************************************************************************
 91  * 描述  :任务程序
 92  * 参数  :无
 93  * 返回  :无
 94 ******************************************************************************/
 95 void App_Event_process(void)
 96 {
 97     while(1)
 98     {
 99         /* 执行事件 */
100         if (pEventHandler->GetEventCount(pEventHandler) > 0)
101         {
102             pEventHandler->Execute(pEventHandler);
103         }
104         else
105         {
106             /* 可在此实现低功耗 */
107         }
108     }
109 }
110 
111 /******************************** END OF FILE ********************************/

  结果:

event1 arg count is 1
event1 arg 0 is hello

event2 arg count is 2
event2 arg 0 is zorb
event2 arg 1 is framework

 

三、状态机结果测试

  简单的测试代码如下:

  1 /**
  2   *****************************************************************************
  3   * @file    app_fsm.c
  4   * @author  Zorb
  5   * @version V1.0.0
  6   * @date    2018-06-28
  7   * @brief   状态机测试的实现
  8   *****************************************************************************
  9   * @history
 10   *
 11   * 1. Date:2018-06-28
 12   *    Author:Zorb
 13   *    Modification:建立文件
 14   *
 15   *****************************************************************************
 16   */
 17 
 18 #include "app_fsm.h"
 19 #include "zf_includes.h"
 20 
 21 /* 定义用户信号 */
 22 enum Signal
 23 {
 24     SAY_HELLO = FSM_USER_SIG_START
 25 };
 26 
 27 Fsm *pFsm;        /* 父状态机 */
 28 Fsm *pFsmSon;     /* 子状态机 */
 29 
 30 /* 父状态机状态1 */
 31 static void State1(Fsm * const pFsm, FsmSignal const fsmSignal);
 32 /* 父状态机状态2 */
 33 static void State2(Fsm * const pFsm, FsmSignal const fsmSignal);
 34 
 35 /******************************************************************************
 36  * 描述  :父状态机状态1
 37  * 参数  :-pFsm       当前状态机
 38  *         -fsmSignal  当前调度信号
 39  * 返回  :无
 40 ******************************************************************************/
 41 static void State1(Fsm * const pFsm, FsmSignal const fsmSignal)
 42 {
 43     switch(fsmSignal)
 44     {
 45         case FSM_ENTER_SIG:
 46             ZF_DEBUG(LOG_D, "enter state1\r\n");
 47             break;
 48         
 49         case FSM_EXIT_SIG:
 50             ZF_DEBUG(LOG_D, "exit state1\r\n\r\n");
 51             break;
 52         
 53         case SAY_HELLO:
 54             ZF_DEBUG(LOG_D, "state1 say hello, and want to be state2\r\n");
 55             /* 切换到状态2 */
 56             pFsm->TransferWithEvent(pFsm, State2);
 57             break;
 58     }
 59 }
 60 
 61 /******************************************************************************
 62  * 描述  :父状态机状态2
 63  * 参数  :-pFsm       当前状态机
 64  *         -fsmSignal  当前调度信号
 65  * 返回  :无
 66 ******************************************************************************/
 67 static void State2(Fsm * const pFsm, FsmSignal const fsmSignal)
 68 {
 69     switch(fsmSignal)
 70     {
 71         case FSM_ENTER_SIG:
 72             ZF_DEBUG(LOG_D, "enter state2\r\n");
 73             break;
 74         
 75         case FSM_EXIT_SIG:
 76             ZF_DEBUG(LOG_D, "exit state2\r\n\r\n");
 77             break;
 78         
 79         case SAY_HELLO:
 80             ZF_DEBUG(LOG_D, "state2 say hello, and want to be state1\r\n");
 81             /* 切换到状态1 */
 82             pFsm->TransferWithEvent(pFsm, State1);
 83             break;
 84     }
 85 }
 86 
 87 /******************************************************************************
 88  * 描述  :子状态机状态
 89  * 参数  :-pFsm       当前状态机
 90  *         -fsmSignal  当前调度信号
 91  * 返回  :无
 92 ******************************************************************************/
 93 static void SonState(Fsm * const pFsm, FsmSignal const fsmSignal)
 94 {
 95     switch(fsmSignal)
 96     {
 97         case SAY_HELLO:
 98             ZF_DEBUG(LOG_D, "son say hello only in state2\r\n");
 99             break;
100     }
101 }
102 
103 /******************************************************************************
104  * 描述  :任务初始化
105  * 参数  :无
106  * 返回  :无
107 ******************************************************************************/
108 void App_Fsm_init(void)
109 {
110     /* 创建父状态机,并设初始状态 */
111     Fsm_create(&pFsm);
112     pFsm->SetInitialState(pFsm, State1);
113     
114     /* 创建子状态机,并设初始状态 */
115     Fsm_create(&pFsmSon);
116     pFsmSon->SetInitialState(pFsmSon, SonState);
117     
118     /* 设置子状态机仅在父状态State2触发 */
119     pFsmSon->OwnerTriggerState = State2;
120     
121     /* 把子状态机添加到父状态机 */
122     pFsm->AddChild(pFsm, pFsmSon);
123     
124     /* 运行状态机 */
125     pFsm->RunAll(pFsm);
126 }
127 
128 /******************************************************************************
129  * 描述  :任务程序
130  * 参数  :无
131  * 返回  :无
132 ******************************************************************************/
133 void App_Fsm_process(void)
134 {
135     ZF_DELAY_MS(1000);
136     /* 每1000ms调度状态机,发送SAY_HELLO信号 */
137     pFsm->Dispatch(pFsm, SAY_HELLO);
138 }
139 
140 /******************************** END OF FILE ********************************/

  结果:

state1 say hello, and want to be state2
exit state1

enter state2
son say hello only in state2
state2 say hello, and want to be state1
exit state2

enter state1
state1 say hello, and want to be state2
exit state1

enter state2
son say hello only in state2
state2 say hello, and want to be state1
exit state2

enter state1
state1 say hello, and want to be state2
exit state1

省略...

 

我是卓波,我是一名嵌入式工程师,我万万没想到我会在这里跟大家吹牛皮。

一、前言

  在这一篇中,我们将为Zorb
Framework提供状态机功能。中小型嵌入式程序说白了就是由各种状态机组成,因此掌握了如何构建状态机,开发嵌入式应用程序可以说是手到拈来。简单的状态机可以用Switch-Case实现,但复杂一点的状态机再继续使用Switch-Case的话,层次会变得比较乱,不方便维护。因此我们为Zorb
Framework提供了函数式状态机。

 

一、前言

  事件有同步事件和异步事件,在这一篇中,我们将为Zorb
Framework提供异步事件功能。在很多时候,我们来不及处理部分操作或者对操作的实时性要求不高时,可以考虑使用异步事件功能。如在中断中处理大量的操作是不太明智的,这时候就可以发出一个事件出来,等待事件处理程序在中断外完成。

 

四、最后

  本篇为Zorb
Framework提供了状态机功能,复杂的状态转换关系被分解成了一个个状态函数,然后在状态函数中仅仅需要处理本状态出现的情况,忽然感觉世界变得简单很多。后面再配上即将为框架添加的事件功能,会让状态机的功能发挥到极致。

 

  Zorb Framework
github:https://github.com/54zorb/Zorb-Framework

  版权所有,转载请打赏哟

 

如果你喜欢我的文章,可以通过微信扫一扫给我打赏哟

88bf必发娱乐 1

嵌入式框架Zorb Framework搭建过程

嵌入式框架Zorb
Framework搭建一:嵌入式环境搭建、调试输出和建立时间系统

嵌入式框架Zorb
Framework搭建二:环形缓冲区的实现

嵌入式框架Zorb
Framework搭建三:列表的实现

嵌入式框架Zorb
Framework搭建四:状态机的实现

嵌入式框架Zorb
Framework搭建五:事件的实现

嵌入式框架Zorb
Framework搭建六:定时器的实现

嵌入式框架Zorb
Framework搭建七:任务的实现

 

我是卓波,我是一名嵌入式工程师,我万万没想到我会在这里跟大家吹牛皮。

四、最后

  本篇为Zorb
Framework提供了事件功能。事件功能主要用于搭建基于事件驱动的程序,如果一直习惯于开发时间驱动程序(轮询程序)的你,尝试一下事件驱动程序,你会发现别有一番风味。

 

  Zorb Framework
github:https://github.com/54zorb/Zorb-Framework

  版权所有,转载请打赏哟

 

如果你喜欢我的文章,可以通过微信扫一扫给我打赏哟

88bf必发娱乐 1