separate SM：小巧易用且移植性超高的嵌入式状态机内核，一个函数就实现！

Separate SM: 高度封装，使用简单，一个函数就实现！简洁且独立的状态机内核，为业务逻辑提供及其清晰的代码框架基础，极度适合状态管理复杂的单片机项目，也可用于RTOS操作系统下的单任务或单线程内的代码框架https://gitee.com/fuxiaoy/separate-sm简介：

简洁且独立的状态机内核，为业务逻辑提供及其清晰的代码框架基础，极度适合状态管理复杂的单片机项目，也可用于RTOS操作系统下的单任务或单线程内的代码框架。

特性：

Separte SM使用了高度封装的宏，在保留通用性的同时，将内核极致的压缩到了简单的一个函数，用户只需要简单的一句调用，就可以轻松的实现内核的运行，快速的移植可让用户专注于业务代码。

移植流程：

separate SM的移植非常简单，只需要包含其头文件和cpp文件即可。若是c语言环境，将cpp后缀改为c即可。

Separte SM 是通过上下文切换变量来管理状态，每个状态都对应一个函数，当状态机切换到该状态时，就会调用该函数，从而实现状态的切换。

用户只需要做以下初始化操作：

1.定义一个枚举类型的上下文状态切换量
2.申明未找到状态时的回调函数
3.调用初始化内核宏

1.首先创建一个枚举类型，作为上下文切换的状态量，并定义枚举变量：

enum ENUM_WORKSTATE
{
  LED_INIT,
  LED_ON,
  LED_OFF,
};


//状态机上下文切换量
ENUM_WORKSTATE WorkStat = LED_INIT;

2.对内核进行初始化，将用于上下文切换的状态量和相应的枚举类型，通过SEPARATE_INIT_KERNEL传递到内核，其中传参为（状态机列表，枚举类型，上下文切换量，默认回调函数）。

//定义每个状态下执行的函数
const static SEPARATE_STATE BusinessList[] = 
{
  SEPARATE_DEFINE_STATE(LED_INIT, led_init),
  SEPARATE_DEFINE_STATE(LED_ON, led_on),
  SEPARATE_DEFINE_STATE(LED_OFF, led_off),
};


//默认未找到状态的回调函数（WorkStat非法值的容错处理-可选）
static void SEPARATE_DEFAULT_NOT_FOUND_CALLBACK() 
{
  WorkStat = LED_INIT;
}

// 初始化内核
SEPARATE_INIT_KERNEL(BusinessList,       \
              ENUM_WORKSTATE,        \
              &WorkStat,             \
              SEPARATE_DEFAULT_NOT_FOUND_CALLBACK); //可选 func or null

3.在main函数或RTOS的任务中调用内核启动函数，内核函数可使用 USE_LOOP宏控制循环是由外部管理还是内核管理

#define USE_LOOP //是否使用内核管理循环while 1

main函数调用：

void main()
{
    // 运行内核 
    SEPARATE_RUN_KERNEL; 
}

4.实现状态机列表中的函数即可：

业务逻辑与状态机内核解耦，每个状态都对应一个函数，用户只需要专注于每个状态函数中的业务逻辑，即可完成状态机内核的调用。
1.简单状态机

void led_init()
{
    led.init();
    WorkStat = LED_ON;
}

void led_on()
{
    led.on();
    delay(500);
    WorkStat = LED_OFF;
}

void led_off()
{
    led.off();
    delay(500);
    WorkStat = LED_ON;
}

2.复杂业务针对更复杂的状态业务应用，在每个状态下实现独立的业务逻辑。
 

int blick_count = 0;
void led_on()
{
    //进入led_on的业务初始化代码块
    {
        blick_count = 0;
    }

    while(1)
    {
        blick_count++;

        if(blick_count <20)
        {
            led.onGreen();
            delay(500);
            led.onRed();
            delay(500);
        }
        else
        {
            break; //跳出状态函数
        }
    }

    {
        //退出led_on业务的状态切换与资源清理代码块
        WorkStat = LED_OFF;
    }

}