OTA Updates based on tags created via git (#159)

* OTA Updates based on tags created via git

* Fixes from code review

Author: k3ldar

Docs/Commands.md

@@ -18,6 +18,8 @@ These are commands used to configure the system settings and can only be sent fr
 | `F9` — SD Card Log File Size | `F9` | Get current log file size in bytes. Returns `v=<bytes>` where bytes is the size of the active log file. Returns `v=0` if no file is open. No params. |
 | `F10` — RTC Diagnostic | `F10` | Perform DS1302 RTC diagnostics. Returns status message with RTC health (availability, running state, write protection, time validity). Returns error message if RTC fails any check. No params. |
 | `F11` — Uptime | F11 | Returns system uptime as "days HH:MM:SS" (e.g. 2d 03:12:45). No params. |
+| `F12` — OTA Check / Apply | `F12` or `F12:apply=1` | Trigger an OTA firmware check against the latest GitHub release. Without params (or `apply=0`) checks only and returns current status. With `apply=1` downloads and applies the update if one is available (or queues apply if a check is already in progress). Response params: `v=<current>` current firmware version, `av=<available>` available version tag (empty if none found yet), `s=<state>` OTA state string. **SFB only** — requires `OTA_AUTO_UPDATE`, ESP32 and WiFi in client mode. |
+| `F13` — OTA Status | `F13` | Query current OTA state without triggering a check. Response params: `v=<current>` current firmware version, `av=<available>` available version tag, `s=<state>` OTA state string (`idle`, `checking`, `available`, `downloading`, `rebooting`, `failed`, `uptodate`), `auto=<0\|1>` whether auto-apply is enabled. **SFB only** — requires `OTA_AUTO_UPDATE`, ESP32 and WiFi in client mode. |
 
 **Heartbeat Behavior:**
 - Sent every 1 second (1000ms) from both devices
@@ -30,7 +32,17 @@ These are commands used to configure the system settings and can only be sent fr
 ### Wifi System Commands (SFB)
 Only F0 is supported via wifi.
 Route: /api/system/{command}
-Example: Return free memory = /api/system/F2 
+Example: Return free memory = /api/system/F2
+
+### OTA Behavior (F12 / F13)
+- Automatic periodic check runs every 24 hours (first check fires 24 h after boot to allow WiFi to fully connect).
+- F12 without params (or `apply=0`) triggers an immediate check and broadcasts the result — it does **not** apply the update automatically.
+- F12 with `apply=1` downloads and applies immediately if an update is available; if a check is still in progress the apply is queued.
+- Auto-apply on each periodic check is **off by default**; enable it by setting bit `OtaFlagAutoApply (0x01)` in `SystemHeader::reserved[0]`.
+- State transitions broadcast an `F12` command automatically as they occur (e.g. `checking` → `available` → `downloading` → `rebooting`).
+- Debug and error messages are broadcast via the debug channel with source `OTA` at each key milestone: API query, tag found/not found, checksum fetch, binary size, download progress (25 / 50 / 75%), hash verification, and reboot.
+- F13 is read-only — it never triggers any OTA activity.
+- OTA is only active when `OTA_AUTO_UPDATE` is defined, the board is an ESP32, `WIFI_SUPPORT` is defined, and WiFi is in connected client mode.
 
 
 ------

SmartFuseBox/BoardConfig.h

@@ -83,3 +83,13 @@
 #if defined(ARDUINO_UNO_R4) && defined(WIFI_SUPPORT) && defined(BLUETOOTH_SUPPORT)
   #error "WIFI_SUPPORT and BLUETOOTH_SUPPORT cannot both be active on Arduino Uno R4. Disable one in Local.h."
 #endif
+
+// ─── OTA Auto-Update Guard ───────────────────────────────────────────────────
+// OTA requires ESP32 (Update library) and an active WiFi client connection.
+// Silently strip the define on unsupported boards instead of erroring, so that
+// the same Local.h can be used across board types without manual edits.
+#if defined(OTA_AUTO_UPDATE)
+  #if !defined(ESP32) || !defined(WIFI_SUPPORT)
+    #undef OTA_AUTO_UPDATE
+  #endif
+#endif

SmartFuseBox/Config.h

@@ -44,6 +44,9 @@ constexpr uint8_t ConfigMaxSensorPins = 4;
 
 constexpr uint32_t SystemHeaderMagic = 0x53464201;  // 'SFB\x01'
 
+// Flags stored in SystemHeader::reserved[0]
+constexpr uint8_t OtaFlagAutoApply = 0x01;  // bit0: automatically download and apply updates
+
 struct SystemHeader {
     uint32_t magic;               // offset 0  — must equal SystemHeaderMagic
     uint32_t bootCount;           // offset 4
@@ -52,7 +55,7 @@ struct SystemHeader {
     uint8_t  crashCounter;        // offset 11
     uint8_t  lastResetReason;     // offset 12
     uint8_t  safeModeFlagsf;      // offset 13
-    uint8_t  reserved[16];        // offset 14
+    uint8_t  reserved[16];        // offset 14 — reserved[0] = OTA flags (see OtaFlagAutoApply)
     uint16_t checksum;            // offset 30 — always last
 } __attribute__((packed));        // = 32 bytes
 

SmartFuseBox/Dht11SensorHandler.h

@@ -119,6 +119,7 @@ class Dht11SensorHandler : public BaseSensor, public BroadcastLoggerSupport
 		_warningManager(warningManager), _sensorPin(sensorPin), _dht11Sensor(sensorPin), _humidityOffset(humidityOffset),
 		_temperatureOffset(temperatureOffset), _humidity(0.0f), _celsius(0.0f)
 	{
+		_dht11Sensor.setDelay(0);
 #if defined(MQTT_SUPPORT)
 		snprintf(_slugTemp, sizeof(_slugTemp), "%s_temperature", _safeSlug);
 		snprintf(_slugHumidity, sizeof(_slugHumidity), "%s_humidity", _safeSlug);
@@ -144,8 +145,8 @@ class Dht11SensorHandler : public BaseSensor, public BroadcastLoggerSupport
 		dtostrf(_temperatureOffset, 1, 1, celsiusOffset);
 		dtostrf(_humidityOffset, 1, 1, humidityOffset);
 
-		int written = snprintf(buffer, size, "\"name\":\"%s\",\"SensorPin\":%u,\"temperature\":%s,\"humidity\":%s,\"humOffset\":%s,\"tempOffset\":%s",
-			_name, _sensorPin, celsius, humidity, humidityOffset, celsiusOffset);
+		int written = snprintf(buffer, size, "\"name\":\"%s\",\"SensorPin\":%u,\"temperature\":%s,\"tempOffset\":%s,\"humidity\":%s,\"humOffset\":%s",
+			_name, _sensorPin, celsius, celsiusOffset, humidity, humidityOffset);
 
 		if (written < 0 || (size_t)written >= size)
 		{

SmartFuseBox/FirmwareVersion.h

@@ -0,0 +1,28 @@
+/*
+ * SmartFuseBox
+ * Copyright (C) 2025 Simon Carter (s1cart3r@gmail.com)
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+#pragma once
+#include <Arduino.h>
+
+// Firmware version constants.
+// On release builds these values are overwritten by the CI workflow from the
+// git tag (v<major>.<minor>.<patch>.<build>) — do not edit the four lines below.
+// For local/development builds these fallback values are used instead.
+constexpr uint8_t FirmwareMajor = 0;
+constexpr uint8_t FirmwareMinor = 9;
+constexpr uint8_t FirmwarePatch = 0;
+constexpr uint8_t FirmwareBuild = 3;

SmartFuseBox/Local.h

@@ -68,6 +68,12 @@
 // MQTT home-assistant discovery (requires WIFI_SUPPORT — enforced in BoardConfig.h)
 #define MQTT_SUPPORT
 
+// OTA auto-update via GitHub releases (requires ESP32 + WIFI_SUPPORT — enforced in BoardConfig.h).
+// When enabled, the device checks for a new release every 24 hours and broadcasts the result.
+// Auto-applying the update is OFF by default; use the F12:apply=1 command or set the
+// OtaFlagAutoApply bit in SystemHeader::reserved[0] to enable automatic installs.
+#define OTA_AUTO_UPDATE
+
 // Bluetooth BLE (mutually exclusive with WIFI_SUPPORT on Arduino Uno R4)
 #define BLUETOOTH_SUPPORT_