NorthFrame是基于非UML极简理念的状态机框架


配合NF_FsmDesigner图形化开发工具，可无负担替代传统switch-case状态机开发


1、NorthFrame的组件
NF_FSM :


极简非UML状态机框架


NF_FsmDesigner :


基于C# Winform开发的状态机图形化开发工具，可直接生成C代码


NF_Signal :


用于代替全局变量的动态信号机制


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

1. <font face="微软雅黑" size="3">NF_Signal_Set("flag_connect", 1);
   
2. 
   
3. NF_Signal_Set("blink_cnt", 3);
   
4. 
   
5. NF_SignalValue flag_connect = NF_Signal_Get("flag_connect");</font>

复制代码

2、NorthFrame图形化状态机开发
以下例程在VS2012环境中运行一个判断QE组合键的状态机：


Step1 : 使用NF_FsmDesigner工具设计绘制状态转换图，并保存为XML文件





Step2 : 点击生成代码，生成如下C语言代码

1. <font face="微软雅黑" size="3">#include <n_frame.h>
   
2. #include <fsm_qande.h>
   
3. 
   
4. /* 转换执行的外部函数声明 */
   
5. extern void IDLE_TO_Q(void);
   
6. extern void Q_TO_QE(void);
   
7. extern void QE_TO_IDLE(void);
   
8. extern void QE_TO_Q(void);
   
9. extern void Q_TO_IDLE(void);
   
10. 
    
11. /* 状态处理函数声明 */
    
12. void FSM_QandE_IDLE(NF_FSM* me, NF_Event event);
    
13. void FSM_QandE_Q_DOWN(NF_FSM* me, NF_Event event);
    
14. void FSM_QandE_QE_DOWN(NF_FSM* me, NF_Event event);
    
15. 
    
16. /* 状态机对象 */
    
17. NF_FSM FSM_QandE = {
    
18.     FSM_QandE_IDLE
    
19. };
    
20. 
    
21. /* IDLE状态处理函数 */
    
22. void FSM_QandE_IDLE(NF_FSM* me, NF_Event event)
    
23. {
    
24. 
    
25.     if (NF_FSM_NameIs(event.Name, "Q_DOWN"))
    
26.     {
    
27.         IDLE_TO_Q();
    
28.         NF_FSM_TRAN(FSM_QandE_Q_DOWN);
    
29.         return ;
    
30.     }
    
31. 
    
32.     if (NF_FSM_NameIs(event.Name, "test"))
    
33.     {
    
34.         NF_FSM_TRAN(FSM_QandE_IDLE);
    
35.         return ;
    
36.     }
    
37. }
    
38. 
    
39. /* Q_DOWN状态处理函数 */
    
40. void FSM_QandE_Q_DOWN(NF_FSM* me, NF_Event event)
    
41. {
    
42. 
    
43.     if (NF_FSM_NameIs(event.Name, "E_DOWN"))
    
44.     {
    
45.         Q_TO_QE();
    
46.         NF_FSM_TRAN(FSM_QandE_QE_DOWN);
    
47.         return ;
    
48.     }
    
49. 
    
50.     if (NF_FSM_NameIs(event.Name, "Q_UP"))
    
51.     {
    
52.         Q_TO_IDLE();
    
53.         NF_FSM_TRAN(FSM_QandE_IDLE);
    
54.         return ;
    
55.     }
    
56. }
    
57. 
    
58. /* QE_DOWN状态处理函数 */
    
59. void FSM_QandE_QE_DOWN(NF_FSM* me, NF_Event event)
    
60. {
    
61. 
    
62.     if (NF_FSM_NameIs(event.Name, "Q_UP"))
    
63.     {
    
64.         QE_TO_IDLE();
    
65.         NF_FSM_TRAN(FSM_QandE_IDLE);
    
66.         return ;
    
67.     }
    
68. 
    
69.     if (NF_FSM_NameIs(event.Name, "E_UP"))
    
70.     {
    
71.         QE_TO_Q();
    
72.         NF_FSM_TRAN(FSM_QandE_Q_DOWN);
    
73.         return ;
    
74.     }
    
75. }</font>

复制代码

Step3 : 在main.c文件中实现按键处理，并发送事件给状态机

备注 : 后续版本会加入发布-订阅机制，目前仅支持直接派发

1. <font face="微软雅黑" size="3">#include "n_frame.h"
   
2. 
   
3. #include "windows.h"
   
4. #include "stdio.h"
   
5. 
   
6. #include "fsm_qande.h"
   
7. 
   
8. #define KEY_VALUE(_key) ((GetKeyState(_key) >= 0) ? NF_Bool_False : NF_Bool_True )
   
9. 
   
10. /* 信号产生者 */
    
11. void Test_Key_Process(void)
    
12. {
    
13. static NF_Bool last_q_val = NF_Bool_False;
    
14. static NF_Bool last_e_val = NF_Bool_False;
    
15. 
    
16. NF_Bool then_q_val;
    
17. NF_Bool then_e_val;
    
18. 
    
19. then_q_val = KEY_VALUE('Q');
    
20. then_e_val = KEY_VALUE('E');
    
21. 
    
22. /* Q键事件处理 */
    
23. if ((last_q_val == NF_Bool_False) && (KEY_VALUE('Q') == NF_Bool_True))
    
24. {
    
25.   NF_FSM_Dispatch(&FSM_QandE, NF_FSM_Event("Q_DOWN"));
    
26. }
    
27. else if ((last_q_val == NF_Bool_True) && (KEY_VALUE('Q') == NF_Bool_False))
    
28. {
    
29.   NF_FSM_Dispatch(&FSM_QandE, NF_FSM_Event("Q_UP"));
    
30. }
    
31. 
    
32. /* E键事件处理 */
    
33. if ((last_e_val == NF_Bool_False) && (KEY_VALUE('E') == NF_Bool_True))
    
34. {
    
35.   NF_FSM_Dispatch(&FSM_QandE, NF_FSM_Event("E_DOWN"));
    
36. }
    
37. else if ((last_e_val == NF_Bool_True) && (KEY_VALUE('E') == NF_Bool_False))
    
38. {
    
39.   NF_FSM_Dispatch(&FSM_QandE, NF_FSM_Event("E_UP"));
    
40. }
    
41. 
    
42. last_q_val = then_q_val;
    
43. last_e_val = then_e_val;
    
44. }
    
45. 
    
46. void IDLE_TO_Q(void)
    
47. {
    
48. printf("state translate : IDLE -> Q_DOWN\n");
    
49. }
    
50. 
    
51. void Q_TO_QE(void)
    
52. {
    
53. printf("state translate : Q_DOWN -> QE_DOWN\n");
    
54. }
    
55. 
    
56. void QE_TO_IDLE(void)
    
57. {
    
58. printf("state translate : QE_DOWN -> IDLE\n");
    
59. }
    
60. 
    
61. void QE_TO_Q(void)
    
62. {
    
63. printf("state translate : QE_DOWN -> Q_DOWN\n");
    
64. }
    
65. 
    
66. void Q_TO_IDLE(void)
    
67. {
    
68. printf("state translate : Q_DOWN -> IDLE\n");
    
69. }
    
70. 
    
71. int main(void)
    
72. {
    
73. for (;;)
    
74. {
    
75.   Test_Key_Process();
    
76. }
    
77. }</font>

复制代码

克隆链接：

1. <font face="微软雅黑" size="3">git clone https://gitee.com/PISCES_X/NorthFrame.git</font>

复制代码