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;
}
}
这些代码定义了状态的行为和状态之间的转换条件,是项目配置的核心部分。