Arduino FSM 开源项目教程

Arduino FSM 开源项目教程

arduino-fsmArduino library for implementing a finite state machine.项目地址:https://gitcode.com/gh_mirrors/ar/arduino-fsm

1. 项目的目录结构及介绍

arduino-fsm/
├── examples/
│   ├── Blink/
│   ├── Button/
│   └── StateMachine/
├── src/
│   ├── Fsm.cpp
│   └── Fsm.h
├── LICENSE
└── README.md

• examples/: 包含多个示例项目，如 Blink, Button, 和 StateMachine，每个示例展示了如何使用 FSM 库。
• src/: 包含 FSM 库的核心文件，包括 Fsm.cpp 和 Fsm.h。
• LICENSE: 项目的许可证文件。
• README.md: 项目的介绍和使用说明。

2. 项目的启动文件介绍

项目的启动文件通常是指 examples/ 目录下的示例项目。以 examples/Blink/Blink.ino 为例：

#include <Fsm.h>

// 定义状态
void state_led_on() {
  digitalWrite(LED_BUILTIN, HIGH);
}

void state_led_off() {
  digitalWrite(LED_BUILTIN, LOW);
}

// 定义状态转换
void on_led_on_to_off() {
  static unsigned long previousMillis = 0;
  unsigned long currentMillis = millis();
  if (currentMillis - previousMillis >= 1000) {
    fsm_led.trigger(1);
    previousMillis = currentMillis;
  }
}

void on_led_off_to_on() {
  static unsigned long previousMillis = 0;
  unsigned long currentMillis = millis();
  if (currentMillis - previousMillis >= 1000) {
    fsm_led.trigger(2);
    previousMillis = currentMillis;
  }
}

// 创建状态机
State state_led_on_state(&state_led_on, &on_led_on_to_off);
State state_led_off_state(&state_led_off, &on_led_off_to_on);
Fsm fsm_led(&state_led_on_state);

void setup() {
  pinMode(LED_BUILTIN, OUTPUT);
  fsm_led.add_transition(&state_led_on_state, &state_led_off_state, 1, NULL);
  fsm_led.add_transition(&state_led_off_state, &state_led_on_state, 2, NULL);
}

void loop() {
  fsm_led.run_machine();
}

3. 项目的配置文件介绍

Arduino FSM 项目本身没有传统的配置文件，其配置主要通过代码实现。例如，在 examples/Blink/Blink.ino 中，状态和状态转换的定义就是项目的配置部分。

// 定义状态
void state_led_on() {
  digitalWrite(LED_BUILTIN, HIGH);
}

void state_led_off() {
  digitalWrite(LED_BUILTIN, LOW);
}

// 定义状态转换
void on_led_on_to_off() {
  static unsigned long previousMillis = 0;
  unsigned long currentMillis = millis();
  if (currentMillis - previousMillis >= 1000) {
    fsm_led.trigger(1);
    previousMillis = currentMillis;
  }
}

void on_led_off_to_on() {
  static unsigned long previousMillis = 0;
  unsigned long currentMillis = millis();
  if (currentMillis - previousMillis >= 1000) {
    fsm_led.trigger(2);
    previousMillis = currentMillis;
  }
}

这些代码定义了状态的行为和状态之间的转换条件，是项目配置的核心部分。

arduino-fsmArduino library for implementing a finite state machine.项目地址:https://gitcode.com/gh_mirrors/ar/arduino-fsm