NorthFrame是基于非UML极简理念的状态机框架
; M2 Y* X* v6 {9 J+ Y) Y( [. p
3 G5 W: j' B4 u- o
配合NF_FsmDesigner图形化开发工具，可无负担替代传统switch-case状态机开发
$ K9 R  H3 h3 H
. M* ]+ e. a( l/ f
- r# v: Z& u# Y, D1、NorthFrame的组件
4 f/ g; `$ r5 n" b5 O3 k: ENF_FSM :
) W' ?% P% n4 [

- B/ i- P" \/ G) n- H! f2 b7 k( m极简非UML状态机框架
3 I  ^! i6 w. N6 n/ H# Z/ B

- \  h( b' [( C+ KNF_FsmDesigner :
4 H3 d4 i* z  Q9 A

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


NF_Signal :


用于代替全局变量的动态信号机制
/ {2 v& ]2 p, r9 A' Z) I

& H) n, y3 _" `% ENF_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>

复制代码

, I  P: z  n; k
' F# I9 M1 D0 _7 h1 u( T
2、NorthFrame图形化状态机开发
/ B2 N6 }1 J: j; K: \+ [% C以下例程在VS2012环境中运行一个判断QE组合键的状态机：
5 y3 ]/ ~: ?+ U: `% z/ c

  C7 Z3 |6 L1 S0 Y1 L+ ]Step1 : 使用NF_FsmDesigner工具设计绘制状态转换图，并保存为XML文件
' U. }$ p: |% X: A$ T6 h
: h! d& B3 O' a# H


# J4 W0 o0 X  j/ _/ O
! y' I/ f- ~  f4 A4 OStep2 : 点击生成代码，生成如下C语言代码

1. <font face="微软雅黑" size="3">#include <n_frame.h>
   5 {/ a+ s; `- Q
2. #include <fsm_qande.h>
   ! t/ o% U$ k. ^/ [* e. n$ b/ d0 S
3. 
   6 X; ]- b/ B3 o
4. /* 转换执行的外部函数声明 */
   
5. extern void IDLE_TO_Q(void);
   5 B+ [3 k6 z% ~6 L" p* }
6. extern void Q_TO_QE(void);
   4 y: ^" E( F% Z; P
7. extern void QE_TO_IDLE(void);
   
8. extern void QE_TO_Q(void);
   
9. extern void Q_TO_IDLE(void);
   
10. 
    4 V6 w. A3 e; K8 Z
11. /* 状态处理函数声明 */
    ) g7 P5 Z  A) k8 M6 o  K) ^# D0 r
12. void FSM_QandE_IDLE(NF_FSM* me, NF_Event event);
    ! \: k+ |- T  b
13. void FSM_QandE_Q_DOWN(NF_FSM* me, NF_Event event);
    7 U- Z7 z- ]$ P8 ~8 R4 R* C
14. void FSM_QandE_QE_DOWN(NF_FSM* me, NF_Event event);
    
15. 
    
16. /* 状态机对象 */
    
17. NF_FSM FSM_QandE = {
    7 B, C' c" Y7 X! |3 ~' j
18.     FSM_QandE_IDLE
    
19. };
    
20. 
    
21. /* IDLE状态处理函数 */
    # B( e! _- C& b1 K3 g$ D
22. void FSM_QandE_IDLE(NF_FSM* me, NF_Event event)
    
23. {
    $ M1 t3 F9 ?3 u5 g$ V
24. 
    
25.     if (NF_FSM_NameIs(event.Name, "Q_DOWN"))
    
26.     {
    
27.         IDLE_TO_Q();
    % b/ z1 ], U4 m- Y' U4 s
28.         NF_FSM_TRAN(FSM_QandE_Q_DOWN);
    
29.         return ;
    / T- _1 U+ l7 j% S& ^
30.     }
    . e& D0 k" s& m) `
31. 
    # q6 {. C- i' p& ]
32.     if (NF_FSM_NameIs(event.Name, "test"))
    
33.     {
    & o" Z$ s0 E# _; B1 ]" i% }
34.         NF_FSM_TRAN(FSM_QandE_IDLE);
    ; O1 A; C; S9 E! O% m4 R
35.         return ;
    
36.     }
    
37. }
    0 I! y! S6 @2 D- S7 F3 V& r9 p
38. 
    # B1 N  F" |* b; p; l% \% W3 H# ~; F
39. /* Q_DOWN状态处理函数 */
    ' u1 K( E3 r$ N# U5 a. R5 F2 |9 o
40. void FSM_QandE_Q_DOWN(NF_FSM* me, NF_Event event)
    % @$ X4 U1 ]+ `: x
41. {
    ( |$ a+ ^# c: P
42. 
    , ?4 s/ y( o% y( j0 P8 k% W, X: R
43.     if (NF_FSM_NameIs(event.Name, "E_DOWN"))
    
44.     {
    
45.         Q_TO_QE();
    6 H1 ~" [0 p) h* d7 y( J  F0 g% M  @
46.         NF_FSM_TRAN(FSM_QandE_QE_DOWN);
    
47.         return ;
    
48.     }
    
49. 
    / ^! a9 Q, U4 V. K. x! J7 F, y
50.     if (NF_FSM_NameIs(event.Name, "Q_UP"))
    + C, G# T) e5 W7 c4 |
51.     {
    ; i! d/ i5 X% B! |( j6 p% X
52.         Q_TO_IDLE();
    
53.         NF_FSM_TRAN(FSM_QandE_IDLE);
    . P  ^) Z; G" Z3 K6 ^3 |) |1 `
54.         return ;
    7 A+ P" g- G+ [5 m6 d
55.     }
    
56. }
    2 e3 i% w0 \6 G
57. 
    6 M# a+ H3 l! w& G$ `
58. /* QE_DOWN状态处理函数 */
    
59. void FSM_QandE_QE_DOWN(NF_FSM* me, NF_Event event)
    - e( T' s5 [+ r7 p" f5 F
60. {
    
61. 
    # h6 ^2 t( e' w, [& x+ S( g
62.     if (NF_FSM_NameIs(event.Name, "Q_UP"))
    
63.     {
    # \! |8 m1 L8 a6 D( w. U; Z
64.         QE_TO_IDLE();
    ! u# A, I# T  I! A; Y
65.         NF_FSM_TRAN(FSM_QandE_IDLE);
    9 D' d; `& U, k; u
66.         return ;
    
67.     }
    6 U: H* }1 b3 X
68. 
    
69.     if (NF_FSM_NameIs(event.Name, "E_UP"))
    
70.     {
    9 B* d, F# R" F
71.         QE_TO_Q();
    3 h/ y9 l- G3 t( B, J5 ~! J; f
72.         NF_FSM_TRAN(FSM_QandE_Q_DOWN);
    . D2 K& \% X9 C" j0 p
73.         return ;
    
74.     }
    5 L' q, @4 x) k- B% `& @) X
75. }</font>

复制代码

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

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

1. <font face="微软雅黑" size="3">#include "n_frame.h"
   
2. 
   
3. #include "windows.h"
   7 L$ e/ H6 C6 I, ^# r
4. #include "stdio.h"
   9 k- x7 F/ E4 V- L
5. 
   
6. #include "fsm_qande.h"
   ! q! t' e1 k, c7 ?
7. 
   
8. #define KEY_VALUE(_key) ((GetKeyState(_key) >= 0) ? NF_Bool_False : NF_Bool_True )
   8 X8 z5 i- y* G- Y
9. 
   
10. /* 信号产生者 */
    
11. void Test_Key_Process(void)
    " K2 l4 w/ }/ K' \+ x
12. {
    
13. static NF_Bool last_q_val = NF_Bool_False;
    & H9 J, J1 |' h2 j1 T; n$ ^
14. static NF_Bool last_e_val = NF_Bool_False;
    
15. 
    ' \( b) B- \! f9 h' J' e
16. NF_Bool then_q_val;
    
17. NF_Bool then_e_val;
    
18. 
    * c  ]. D: m; Y3 A: U  q
19. then_q_val = KEY_VALUE('Q');
    7 l% \, c( d; R  m) \
20. then_e_val = KEY_VALUE('E');
    ; M. u" {) J# Y( h1 ^/ D
21. 
    
22. /* Q键事件处理 */
    
23. if ((last_q_val == NF_Bool_False) && (KEY_VALUE('Q') == NF_Bool_True))
    # W* |# l* K8 a. c# q
24. {
    , b- i/ U. j. R' Y. l  v+ a
25.   NF_FSM_Dispatch(&FSM_QandE, NF_FSM_Event("Q_DOWN"));
    
26. }
    , ]; K5 `- K6 g4 G: h
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"));
    ) F9 F1 ?$ }  `& |
30. }
    
31. 
    # ]9 x- _1 H2 `$ n
32. /* E键事件处理 */
    " E$ t$ M7 B2 o, S; L* `
33. if ((last_e_val == NF_Bool_False) && (KEY_VALUE('E') == NF_Bool_True))
    
34. {
    4 u' v- i- m5 i: t! w5 \' U
35.   NF_FSM_Dispatch(&FSM_QandE, NF_FSM_Event("E_DOWN"));
    ! k; G5 y! q" r6 X( H
36. }
    
37. else if ((last_e_val == NF_Bool_True) && (KEY_VALUE('E') == NF_Bool_False))
    ! @& a& T' {3 g1 y
38. {
    + Q& k: M6 }3 y( I
39.   NF_FSM_Dispatch(&FSM_QandE, NF_FSM_Event("E_UP"));
    
40. }
    1 s( @- h- x0 o9 j- o# @3 ^
41. 
    9 e* ]% `& f. J/ ^8 ?1 |2 d8 b
42. last_q_val = then_q_val;
      D, Y) Z% ~7 L  _% ^! I6 j6 c5 b
43. last_e_val = then_e_val;
    
44. }
    
45. 
    ( o# F( `$ j9 P
46. void IDLE_TO_Q(void)
    7 k+ Z0 u. m( ]" d& V5 @7 a5 E
47. {
    
48. printf("state translate : IDLE -> Q_DOWN\n");
    / M: N+ W2 V" H+ ^# B1 u5 H
49. }
    
50. 
    
51. void Q_TO_QE(void)
      D* c* h3 r; a5 P
52. {
    " B  b' P0 t- A! q$ r* g
53. printf("state translate : Q_DOWN -> QE_DOWN\n");
    
54. }
    8 O* S7 ~$ m$ u. I6 [
55. 
    * T7 ^: G, k6 ^% F& c8 e& P
56. void QE_TO_IDLE(void)
    
57. {
    
58. printf("state translate : QE_DOWN -> IDLE\n");
    8 D1 N5 [, c. g0 E1 \: ^9 m1 ?' c
59. }
    
60. 
    
61. void QE_TO_Q(void)
    2 T% t- b+ n5 Z
62. {
    4 h. W, T" C/ C, U7 ~
63. printf("state translate : QE_DOWN -> Q_DOWN\n");
    $ V; x  j/ t/ G% B
64. }
    
65. 
    ( S; _1 m" x" h' q6 {
66. void Q_TO_IDLE(void)
    / E" m: a3 H# x& U# x
67. {
    
68. printf("state translate : Q_DOWN -> IDLE\n");
    
69. }
    % @% r9 e$ U, d  G" D9 K) ~1 Z
70. 
    ! e' @+ O( T* X  \8 @
71. int main(void)
    
72. {
    
73. for (;;)
    / k" m8 U8 ^- a$ s+ M/ Q
74. {
    % U* x3 O; `* @9 G$ y
75.   Test_Key_Process();
    
76. }
    & I$ A$ H% F  o6 \9 w& F% V
77. }</font>

复制代码

克隆链接：

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

复制代码

. o/ \" c/ p7 J+ x6 s% r