init commit

include/StatusLed.h

@@ -0,0 +1,52 @@
+#pragma once
+
+/**
+ * @file StatusLed.h
+ * @brief NeoPixel RGB LED status indicator.
+ *
+ * Encodes BLE and WiFi operational state as colour + blink pattern:
+ *
+ *  BLE Scanning     → Blue pulse (on 100 ms / off 900 ms)
+ *  BLE Connecting   → Blue pulse (on 300 ms / off 300 ms)
+ *  BLE Connected    → Solid green
+ *  BLE Disconnected → Red blink (on 200 ms / off 800 ms)
+ *  BLE Error        → Solid red
+ *  WiFi AP active   → Amber pulse (on 500 ms / off 500 ms)
+ *  OTA in progress  → Magenta rapid pulse
+ *  All off          → Black
+ */
+
+#include "Config.h"
+#include <Adafruit_NeoPixel.h>
+
+class StatusLed {
+public:
+    void begin();
+
+    /**
+     * @brief Call from loop() to update the LED animation.
+     *        Non-blocking — uses millis() internally.
+     */
+    void update(AppState::BleStatus ble, AppState::WifiStatus wifi, bool ota = false);
+
+    /** @brief Immediately set a solid colour (overrides animation until next update()). */
+    void setColor(uint32_t color, uint8_t brightness = 40);
+
+    /** @brief Turn off the LED. */
+    void off();
+
+private:
+    Adafruit_NeoPixel _strip{STATUS_LED_COUNT, STATUS_LED_PIN, NEO_GRB + NEO_KHZ800};
+
+    uint32_t _lastToggle = 0;
+    bool     _ledOn      = false;
+
+    AppState::BleStatus  _prevBle  = AppState::BleStatus::IDLE;
+    AppState::WifiStatus _prevWifi = AppState::WifiStatus::OFF;
+    bool                 _prevOta  = false;
+
+    void _pulse(uint32_t color, uint32_t onMs, uint32_t offMs, uint8_t brightness = 40);
+    void _solid(uint32_t color, uint8_t brightness = 40);
+};
+
+extern StatusLed statusLed;