feat: add heartbeat indicator on builtin led for core examples

Author: CameronBrooks11

examples/core_usage/arduino/advanced_controller/advanced_controller.ino

@@ -11,11 +11,26 @@
 
 // Instantiate CRUMBS as Controller, set to true for Controller mode
 static crumbs_context_t crumbsController; // C struct
+static uint32_t last_heartbeat_ms = 0;
+static bool led_state = false;
+
+static void heartbeat_tick()
+{
+    const uint32_t now = millis();
+    if ((uint32_t)(now - last_heartbeat_ms) < HEARTBEAT_INTERVAL_MS)
+        return;
+
+    last_heartbeat_ms = now;
+    led_state = !led_state;
+    digitalWrite(LED_BUILTIN, led_state ? HIGH : LOW);
+}
 
 // Initializes the Controller device, sets up serial communication, and provides usage instructions.
 void setup()
 {
     Serial.begin(SERIAL_BAUD); /**< Initialize serial communication at configured baud rate */
+    pinMode(LED_BUILTIN, OUTPUT);
+    digitalWrite(LED_BUILTIN, LOW);
 
     while (!Serial)
     {
@@ -36,6 +51,7 @@ void setup()
 // Main loop that listens for serial input, parses commands, and sends crumbs_message_ts to the specified Slice.
 void loop()
 {
+    heartbeat_tick();
     // Listen for serial input to send commands or request data
     handleSerialInput();
 }

examples/core_usage/arduino/advanced_controller/config.h

@@ -3,10 +3,10 @@
 #include <stdint.h>
 
 static const uint32_t SERIAL_BAUD = 115200;
+static const uint32_t HEARTBEAT_INTERVAL_MS = 500;
 static const uint32_t SERIAL_WAIT_MS = 10;
 
 static const uint32_t REQUEST_READ_DELAY_MS = 50;
 static const uint8_t SCAN_START_ADDR = 0x03;
 static const uint8_t SCAN_END_ADDR = 0x77;
 static const uint32_t SCAN_TIMEOUT_US = 50000;
-

examples/core_usage/arduino/basic_controller/basic_controller.ino

@@ -9,6 +9,19 @@
 #include "config.h"
 
 crumbs_context_t ctx;
+static uint32_t last_heartbeat_ms = 0;
+static bool led_state = false;
+
+static void heartbeat_tick()
+{
+    const uint32_t now = millis();
+    if ((uint32_t)(now - last_heartbeat_ms) < HEARTBEAT_INTERVAL_MS)
+        return;
+
+    last_heartbeat_ms = now;
+    led_state = !led_state;
+    digitalWrite(LED_BUILTIN, led_state ? HIGH : LOW);
+}
 
 void send_store_data()
 {
@@ -101,6 +114,8 @@ void query_stored_data()
 void setup()
 {
     Serial.begin(SERIAL_BAUD);
+    pinMode(LED_BUILTIN, OUTPUT);
+    digitalWrite(LED_BUILTIN, LOW);
     crumbs_arduino_init_controller(&ctx);
 
     Serial.println("=== Basic Controller ===");
@@ -113,6 +128,8 @@ void setup()
 
 void loop()
 {
+    heartbeat_tick();
+
     if (Serial.available())
     {
         char cmd = Serial.read();

examples/core_usage/arduino/basic_controller/config.h

@@ -4,6 +4,7 @@
 #include <stdint.h>
 
 static const uint32_t SERIAL_BAUD = 115200;
+static const uint32_t HEARTBEAT_INTERVAL_MS = 500;
 
 static const uint8_t TARGET_ADDR = 0x08;
 static const uint8_t TARGET_TYPE_ID = 0x01;
@@ -23,4 +24,3 @@ static const char CMD_KEY_STORE = 's';
 static const char CMD_KEY_CLEAR = 'c';
 static const char CMD_KEY_QUERY_VERSION = 'v';
 static const char CMD_KEY_QUERY_STORED = 'd';
-

examples/core_usage/arduino/basic_peripheral/basic_peripheral.ino

@@ -10,6 +10,19 @@
 crumbs_context_t ctx;
 uint8_t stored_data[STORED_DATA_CAPACITY];
 uint8_t stored_len = 0;
+static uint32_t last_heartbeat_ms = 0;
+static bool led_state = false;
+
+static void heartbeat_tick()
+{
+    const uint32_t now = millis();
+    if ((uint32_t)(now - last_heartbeat_ms) < HEARTBEAT_INTERVAL_MS)
+        return;
+
+    last_heartbeat_ms = now;
+    led_state = !led_state;
+    digitalWrite(LED_BUILTIN, led_state ? HIGH : LOW);
+}
 
 void on_message(crumbs_context_t *ctx, const crumbs_message_t *msg)
 {
@@ -69,6 +82,8 @@ void on_request(crumbs_context_t *ctx, crumbs_message_t *reply)
 void setup()
 {
     Serial.begin(SERIAL_BAUD);
+    pinMode(LED_BUILTIN, OUTPUT);
+    digitalWrite(LED_BUILTIN, LOW);
     crumbs_arduino_init_peripheral(&ctx, DEVICE_ADDR);
     crumbs_set_callbacks(&ctx, on_message, on_request, NULL);
     Serial.print("Basic peripheral ready at 0x");
@@ -77,5 +92,7 @@ void setup()
 
 void loop()
 {
-    // All processing in callbacks
+    // All processing in callbacks.
+    heartbeat_tick();
+    delay(1);
 }

examples/core_usage/arduino/basic_peripheral/config.h

@@ -4,6 +4,7 @@
 #include <stdint.h>
 
 static const uint32_t SERIAL_BAUD = 115200;
+static const uint32_t HEARTBEAT_INTERVAL_MS = 500;
 
 static const uint8_t DEVICE_ADDR = 0x08;
 static const uint8_t DEVICE_TYPE_ID = 0x01;
@@ -19,4 +20,3 @@ static const uint8_t MODULE_VERSION_MINOR = 0;
 static const uint8_t MODULE_VERSION_PATCH = 0;
 
 static const size_t STORED_DATA_CAPACITY = 10u;
-

examples/core_usage/arduino/basic_peripheral_noncrumbs/basic_peripheral_noncrumbs.ino

@@ -19,6 +19,20 @@
 #include <Wire.h>
 #include "config.h"
 
+static uint32_t last_heartbeat_ms = 0;
+static bool led_state = false;
+
+static void heartbeat_tick()
+{
+    const uint32_t now = millis();
+    if ((uint32_t)(now - last_heartbeat_ms) < HEARTBEAT_INTERVAL_MS)
+        return;
+
+    last_heartbeat_ms = now;
+    led_state = !led_state;
+    digitalWrite(LED_BUILTIN, led_state ? HIGH : LOW);
+}
+
 void onReceiveHandler(int numBytes)
 {
     // Drain and count bytes (we intentionally do not interpret them as CRUMBS)
@@ -42,6 +56,8 @@ void onRequestHandler()
 void setup()
 {
     Serial.begin(SERIAL_BAUD);
+    pinMode(LED_BUILTIN, OUTPUT);
+    digitalWrite(LED_BUILTIN, LOW);
     while (!Serial)
         ; // wait for serial monitor on some boards
 
@@ -56,5 +72,6 @@ void setup()
 void loop()
 {
     // Nothing to do here - interrupts drive I2C callbacks.
-    delay(LOOP_DELAY_MS);
+    heartbeat_tick();
+    delay(1);
 }

examples/core_usage/arduino/basic_peripheral_noncrumbs/config.h

@@ -3,7 +3,6 @@
 #include <stdint.h>
 
 static const uint32_t SERIAL_BAUD = 115200;
+static const uint32_t HEARTBEAT_INTERVAL_MS = 500;
 static const uint8_t NONCRUMBS_ADDR = 69; // 0x45
-static const uint32_t LOOP_DELAY_MS = 1000;
 static const char NONCRUMBS_PAYLOAD[] = "NOCRUMBS";
-

examples/core_usage/arduino/hello_controller/config.h

@@ -4,6 +4,7 @@
 #include <stdint.h>
 
 static const uint32_t SERIAL_BAUD = 115200;
+static const uint32_t HEARTBEAT_INTERVAL_MS = 500;
 
 static const uint8_t TARGET_ADDR = 0x08;
 static const uint8_t TARGET_TYPE_ID = 0x01;
@@ -18,4 +19,3 @@ static const uint32_t READ_TIMEOUT_US = 5000;
 
 static const char CMD_SEND = 's';
 static const char CMD_REQUEST = 'r';
-

examples/core_usage/arduino/hello_controller/hello_controller.ino

@@ -8,6 +8,19 @@
 #include "config.h"
 
 crumbs_context_t ctx;
+static uint32_t last_heartbeat_ms = 0;
+static bool led_state = false;
+
+static void heartbeat_tick()
+{
+    const uint32_t now = millis();
+    if ((uint32_t)(now - last_heartbeat_ms) < HEARTBEAT_INTERVAL_MS)
+        return;
+
+    last_heartbeat_ms = now;
+    led_state = !led_state;
+    digitalWrite(LED_BUILTIN, led_state ? HIGH : LOW);
+}
 
 void send_hello()
 {
@@ -48,12 +61,16 @@ void request_data()
 void setup()
 {
     Serial.begin(SERIAL_BAUD);
+    pinMode(LED_BUILTIN, OUTPUT);
+    digitalWrite(LED_BUILTIN, LOW);
     crumbs_arduino_init_controller(&ctx);
     Serial.println("Commands: s=send, r=request");
 }
 
 void loop()
 {
+    heartbeat_tick();
+
     if (Serial.available())
     {
         char c = Serial.read();