Adds an optional context pointer

.gitignore

@@ -20,3 +20,9 @@ pix
 *~
 *.swp
 *.swo
+
+# VSCode
+.vscode
+
+# PlatformIO
+.pio

examples/light_switch/light_switch.ino

@@ -1,3 +1,6 @@
+// If using PlatformIO, see the platformio.ini file for instructions
+// on how to pick which sample to run
+
 #include "Fsm.h"
 
 // State machine variables
@@ -10,38 +13,43 @@ Fsm fsm(&state_light_off);
 // Transition callback functions
 void on_light_on_enter()
 {
-  Serial.println("Entering LIGHT_ON");
+  Serial.println(F("Entering LIGHT_ON"));
 }
 
 void on_light_on_exit()
 {
-  Serial.println("Exiting LIGHT_ON");
+  Serial.println(F("Exiting LIGHT_ON"));
 }
 
 void on_light_off_enter()
 {
-  Serial.println("Entering LIGHT_OFF");
+  Serial.println(F("Entering LIGHT_OFF"));
 }
 
 void on_light_off_exit()
 {
-  Serial.println("Exiting LIGHT_OFF");
+  Serial.println(F("Exiting LIGHT_OFF"));
 }
 
 void on_trans_light_on_light_off()
 {
-  Serial.println("Transitioning from LIGHT_ON to LIGHT_OFF");
+  Serial.println(F("Transitioning from LIGHT_ON to LIGHT_OFF"));
 }
 
 void on_trans_light_off_light_on()
 {
-  Serial.println("Transitioning from LIGHT_OFF to LIGHT_ON");
+  Serial.println(F("Transitioning from LIGHT_OFF to LIGHT_ON"));
 }
 
 // standard arduino functions
 void setup()
 {
   Serial.begin(9600);
+  while (!Serial && !Serial.available()) {
+  }
+  delay(1000);
+
+  Serial.println(F("starting light_switch example"));
 
   fsm.add_transition(&state_light_on, &state_light_off,
                      FLIP_LIGHT_SWITCH,
@@ -53,7 +61,8 @@ void setup()
 
 void loop()
 {
-  // No "fsm.run_machine()" call needed as no "on_state" funcions or timmed transitions exists
+  // "fsm.run_machine()" call needed because Fsm needs to be initialized
+  fsm.run_machine();
   delay(2000);
   fsm.trigger(FLIP_LIGHT_SWITCH);
   delay(2000);

examples/multitasking/multitasking.ino

@@ -1,29 +1,32 @@
+// If using PlatformIO, see the platformio.ini file for instructions
+// on how to pick which sample to run
+
 // This example shows how two finite state machines can be used to simulate
 // multitasking on an arduino. Two LED's are turned on and off at irregular
 // intervals; the finite state machines take care of the transitions.
 
-#include "Fsm.h"
+#include <Fsm.h>
 
 #define LED1_PIN 10
 #define LED2_PIN 11
 
 void on_led1_on_enter() {
-    Serial.println("on_led1_on_enter");
+    Serial.println(F("on_led1_on_enter"));
     digitalWrite(LED1_PIN, HIGH);
 }
 
 void on_led1_off_enter() {
-    Serial.println("on_led1_off_enter");
+    Serial.println(F("on_led1_off_enter"));
     digitalWrite(LED1_PIN, LOW);
 }
 
 void on_led2_on_enter() {
-    Serial.println("on_led2_on_enter");
+    Serial.println(F("on_led2_on_enter"));
     digitalWrite(LED2_PIN, HIGH);
 }
 
 void on_led2_off_enter() {
-    Serial.println("on_led2_off_enter");
+    Serial.println(F("on_led2_off_enter"));
     digitalWrite(LED2_PIN, LOW);
 }
 

examples/timed_switchoff/timed_switchoff.ino

@@ -1,3 +1,6 @@
+// If using PlatformIO, see the platformio.ini file for instructions
+// on how to pick which sample to run
+
 #include "Fsm.h"
 
 /*
@@ -29,21 +32,21 @@ Fsm fsm(&state_led_off);
 // Transition functions
 void led_off()
 {
-  Serial.println("led_off");
+  Serial.println(F("led_off"));
   digitalWrite(LED_PIN, LOW);
 }
 
 void led_on()
 {
-  Serial.println("led_on");
+  Serial.println(F("led_on"));
   digitalWrite(LED_PIN, HIGH);
 }
 
 void check_button()
 {
   int buttonState = digitalRead(BUTTON_PIN);
   if (buttonState == LOW) {
-    Serial.println("button_pressed");
+    Serial.println(F("button_pressed"));
     fsm.trigger(BUTTON_EVENT);
   }
 }
@@ -60,7 +63,7 @@ void setup()
                      BUTTON_EVENT, NULL);
   fsm.add_timed_transition(&state_led_on, &state_led_off, 3000, NULL);
   fsm.add_transition(&state_led_on, &state_led_off, BUTTON_EVENT, NULL);
-  Serial.println("Setup END");
+  Serial.println(F("Setup END"));
 }
 
 void loop()

library.properties

@@ -1,9 +1,9 @@
 name=arduino-fsm
-version=2.2.0
+version=2.3.0
 author=Jon Black <jon@humblecoder.com>
 maintainer=Jon Black <jon@humblecoder.com>
 sentence=A library for implementing a finite state machine
 paragraph=Supports events for exiting and entering states.
 category=Other
 url=https://github.com/jonblack/arduino-fsm
-architectures=avr
+architectures=avr

platformio.ini

@@ -0,0 +1,21 @@
+; NOTE: When changing these platformio.ini files it sometimes helps to delete
+; the ./.pio folder before rebuilding.
+
+[platformio]
+; Uncomment one of the following to pick wwhich example PlatformIO will build & run
+src_dir = ./examples/light_switch
+;src_dir = ./examples/multitasking
+;src_dir = ./examples/timed_switchoff
+
+; This is just a default environment. Change it to match your Ardruino hardware.
+[env:megaatmega2560]
+platform = atmelavr
+board = megaatmega2560
+framework = arduino
+
+; Uncomment this to use the locally-built verison of the arduino-fsm library
+lib_deps = file://src
+
+; Uncomment this to use the verison of the arduino-fsm library found in the PlatformIO registry
+;lib_deps = arduino-fsm
+