[开源框架] 极简信号/状态机框架 NorthFrame

独孤帅

NorthFrame 单片机极简信号/状态机框架         讨论QQ群：431600056

gitee地址：https://gitee.com/PISCES_X/NorthFrame

单片机开发中是否被满天飞的全局变量困扰？
是否在寻找一种层级间松耦合的信号传递方式？
是否希望优雅无负担地使用状态机思路进行开发？
调试打Log很麻烦，希望自动生成，最好还有测试脚本？

NF_Signal和NF_FSM 来帮你

用法1：代替全局变量，使用方便

1. NF_Signal_Set("flag_connect", 1);
   
2. NF_Signal_Set("blink_cnt", 3);
   
3. 
   
4. NF_SignalValue flag_connect = NF_Signal_Get("flag_connect");

复制代码

用法2：配合状态机使用

以下例程在VS2012环境中运行一个判断QE组合键的状态机
注：未来会更新使用状态图绘图软件自动生成状态机代码

1. #include "n_frame.h"
   
2. 
   
3. #include "windows.h"
   
4. #include "stdio.h"
   
5. 
   
6. #define IS_KEY_PRESS(_key) ((GetKeyState(_key) >= 0) ? NF_Bool_False : NF_Bool_True )
   
7. 
   
8. /* 信号产生者 */
   
9. void Test_Key_Process(void)
   
10. {
    
11.     if ( IS_KEY_PRESS('Q') ){
    
12.         NF_Signal_Set("key_q_press", 1);
    
13.     }
    
14.     else{
    
15.         NF_Signal_Set("key_q_press", 0);
    
16.     }
    
17. 
    
18.     if ( IS_KEY_PRESS('E') ){
    
19.         NF_Signal_Set("key_e_press", 1);
    
20.     }
    
21.     else{
    
22.         NF_Signal_Set("key_e_press", 0);
    
23.     }
    
24. }
    
25. 
    
26. /* 状态机对象 */
    
27. NF_FSM Test_FSM_QandE;
    
28. 
    
29. /* 状态机的三个状态处理函数 */
    
30. void Test_FSM_QandE_IDLE(NF_FSM* me, NF_SignalName name, NF_SignalValue val);
    
31. void Test_FSM_QandE_QDOWN(NF_FSM* me, NF_SignalName name, NF_SignalValue val);
    
32. void Test_FSM_QandE_QEDOWN(NF_FSM* me, NF_SignalName name, NF_SignalValue val);
    
33. 
    
34. /* IDLE状态处理函数 */
    
35. void Test_FSM_QandE_IDLE(NF_FSM* me, NF_SignalName name, NF_SignalValue val)
    
36. {
    
37.     if ( NF_FSM_NameIs(name, "key_q_press") )
    
38.     {
    
39.         if ( val == 1 )
    
40.         {
    
41.             NF_FSM_TRAN(Test_FSM_QandE_QDOWN);
    
42.             printf("Test_FSM_QandE State Translate : IDLE --> QDOWN\n");
    
43.         }
    
44.     }
    
45. }
    
46. 
    
47. /* QDOWN状态处理函数 */
    
48. void Test_FSM_QandE_QDOWN(NF_FSM* me, NF_SignalName name, NF_SignalValue val)
    
49. {
    
50.     if ( NF_FSM_NameIs(name, "key_e_press") )
    
51.     {
    
52.         if ( val == 1 )
    
53.         {
    
54.             NF_FSM_TRAN(Test_FSM_QandE_QEDOWN);
    
55.             printf("Test_FSM_QandE State Translate : QDOWN --> QEDOWN\n");
    
56.         }
    
57.     }
    
58.     else if( NF_FSM_NameIs(name, "key_q_press") )
    
59.     {
    
60.         if ( val == 0 )
    
61.         {
    
62.             NF_FSM_TRAN(Test_FSM_QandE_IDLE);
    
63.             printf("Test_FSM_QandE State Translate : QDOWN --> IDLE\n");
    
64.         }
    
65.     }
    
66. }
    
67. 
    
68. /* QEDOWN状态处理函数 */
    
69. void Test_FSM_QandE_QEDOWN(NF_FSM* me, NF_SignalName name, NF_SignalValue val)
    
70. {
    
71.     if ( NF_FSM_NameIs(name, "key_e_press") )
    
72.     {
    
73.         if ( val == 0 )
    
74.         {
    
75.             NF_FSM_TRAN(Test_FSM_QandE_QDOWN);
    
76.             printf("Test_FSM_QandE State Translate : QEDOWN --> QDOWN\n");
    
77.         }
    
78.     }
    
79.     else if( NF_FSM_NameIs(name, "key_q_press") )
    
80.     {
    
81.         if ( val == 0 )
    
82.         {
    
83.             NF_FSM_TRAN(Test_FSM_QandE_IDLE);
    
84.             printf("Test_FSM_QandE State Translate : QEDOWN --> IDLE\n");
    
85.         }
    
86.     }
    
87. }
    
88. 
    
89. int main(void)
    
90. {
    
91.     /* 初始化状态机 */
    
92.     NF_FSM_Translate(&Test_FSM_QandE, NF_FSM_State(Test_FSM_QandE_IDLE));
    
93. 
    
94.     for (;;)
    
95.     {
    
96.         Test_Key_Process();
    
97.         NF_FSM_CheckSignal(&Test_FSM_QandE, "key_q_press");
    
98.         NF_FSM_CheckSignal(&Test_FSM_QandE, "key_e_press");
    
99.     }
    
100. }

复制代码

yklstudent

mark，感谢分享