@alteriom/painlessmesh 1.8.5 → 1.8.7

package/examples/bridge_failover/README.md

@@ -30,10 +30,20 @@ Regular nodes track these broadcasts and detect failures when:
 
 ### 2. Election Trigger
 
-When the primary bridge fails:
+An election is triggered when:
+
+**Scenario 1: No Bridge Exists (Auto-Election Mode)**
+- After 60-second startup period
+- Periodic monitoring (every 30s) detects no healthy bridge
 - Nodes with router credentials configured start an election
 - Nodes without credentials remain passive
 
+**Scenario 2: Bridge Failure**
+- Primary bridge fails or loses Internet connectivity
+- No status received within 60 seconds (configurable timeout)
+- Bridge reports `internetConnected: false`
+- Nodes detect failure and start election
+
 ### 3. Election Protocol
 
 **Step 1: Candidacy Broadcast (Type 611)**
@@ -97,34 +107,77 @@ To prevent oscillation:
 
 ## Setup Instructions
 
-### 1. Flash Initial Bridge Node
+You can choose between two deployment modes:
+
+### Option A: Auto-Election Mode (Recommended)
+
+**Best for**: Equal peers where any node can become the bridge based on signal strength.
+
+1. Keep `INITIAL_BRIDGE = false` on **ALL nodes**
+2. Configure mesh credentials (MESH_PREFIX, MESH_PASSWORD)
+3. Configure router credentials (ROUTER_SSID, ROUTER_PASSWORD)
+4. Flash the same sketch to all ESP32/ESP8266 devices
+5. Power on all nodes simultaneously
+
+**What happens**:
+- Nodes start as regular mesh nodes
+- After 60-second startup period, automatic monitoring begins
+- If no bridge exists, nodes trigger an election
+- Node with best router RSSI wins and becomes bridge
+- Other nodes remain regular with failover capability
+
+**Advantages**:
+- Simpler setup - no need to designate a specific node
+- True dynamic failover - any node can become bridge
+- Best bridge selected based on signal strength
+
+### Option B: Pre-Designated Bridge Mode
+
+**Best for**: When you want a specific node to start as the bridge.
+
+**1. Flash Initial Bridge Node**
 
 1. Set `INITIAL_BRIDGE` to `true`
 2. Configure router credentials
 3. Flash to one ESP32/ESP8266
 4. This node will connect to router and start as bridge
 
-### 2. Flash Regular Nodes
+**2. Flash Regular Nodes**
 
 1. Set `INITIAL_BRIDGE` to `false`
 2. Configure same mesh and router credentials
 3. Flash to other ESP32/ESP8266 devices
 4. These nodes can become bridges via election
 
-### 3. Test Failover
+**Advantages**:
+- Immediate bridge availability (no 60s wait)
+- Predictable initial bridge selection
+- Good for nodes with fixed locations
+
+### Test Failover Scenarios
 
-**Scenario 1: Bridge Goes Offline**
-1. Power off the initial bridge node
+**Scenario 1: Auto-Election (No Initial Bridge)**
+1. Flash all nodes with `INITIAL_BRIDGE = false`
+2. Power on all nodes
+3. Wait 60 seconds for startup period
+4. Automatic monitoring detects no bridge
+5. Election starts automatically within 30 seconds
+6. Node with best router signal becomes bridge
+7. Monitor serial output to see election process
+
+**Scenario 2: Bridge Goes Offline**
+1. Power off the current bridge node (initial or elected)
 2. After 60 seconds, regular nodes detect failure
 3. Election starts automatically
 4. Node with best router signal becomes new bridge
 5. Monitor serial output to see election process
 
-**Scenario 2: Bridge Loses Internet**
-1. Disconnect router from Internet
+**Scenario 3: Bridge Loses Internet**
+1. Disconnect router from Internet (or block bridge node's Internet)
 2. Bridge reports `internetConnected: false`
-3. Election may start (nodes decide if failover needed)
-4. New bridge elected if necessary
+3. Nodes detect loss of Internet via status broadcasts
+4. Election starts to find a node with working Internet
+5. New bridge elected if another node has Internet access
 
 ## Serial Output
 
@@ -287,6 +340,17 @@ bool amBridge = mesh.isBridge();
 - Wait a few seconds after startup for initial discovery
 - Bridge now broadcasts immediately on startup and when nodes connect (fixed in v1.8.4+)
 
+### Bridge Reports No Internet When Router Has Internet
+
+**Symptoms**: Bridge shows "Internet available: NO" or `hasInternet: false` despite router having Internet
+
+**Cause**: Fixed in v1.8.5+. Previously only checked WiFi connection status, not actual Internet availability.
+
+**Solutions**:
+- Update to painlessMesh v1.8.5 or later
+- Bridge now checks both WiFi connection AND valid gateway IP
+- If still seeing issues, verify router's gateway IP is accessible: check `WiFi.gatewayIP()` returns valid IP (not 0.0.0.0)
+
 ### Election Doesn't Start
 
 **Symptoms**: Bridge fails but no election occurs

package/examples/bridge_failover/bridge_failover.ino

@@ -9,14 +9,26 @@
 // - ESP32 or ESP8266
 // - WiFi router with Internet connection
 //
-// Setup:
+// Setup Options:
+//
+// OPTION A - Auto-Election Mode (Recommended):
+// 1. Configure your mesh credentials (MESH_PREFIX, MESH_PASSWORD)
+// 2. Configure your router credentials (ROUTER_SSID, ROUTER_PASSWORD)
+// 3. Keep INITIAL_BRIDGE = false on ALL nodes
+// 4. Flash multiple nodes with this sketch
+// 5. After startup (~60 seconds), nodes will automatically elect a bridge
+//    based on best router signal strength (RSSI)
+//
+// OPTION B - Pre-Designated Bridge Mode:
 // 1. Configure your mesh credentials (MESH_PREFIX, MESH_PASSWORD)
 // 2. Configure your router credentials (ROUTER_SSID, ROUTER_PASSWORD)
-// 3. Flash multiple nodes with this sketch
-// 4. Designate one as the initial bridge by calling mesh.initAsBridge()
-// 5. Other nodes will automatically participate in elections if bridge fails
+// 3. Set INITIAL_BRIDGE = true on ONE node (your designated bridge)
+// 4. Keep INITIAL_BRIDGE = false on all other nodes
+// 5. Flash the nodes - designated bridge starts immediately
+// 6. If designated bridge fails, others will hold election
 //
 // Features Demonstrated:
+// - Automatic bridge election when no bridge exists
 // - Automatic bridge failure detection via heartbeats
 // - RSSI-based election protocol
 // - Deterministic winner selection with tiebreakers

package/examples/ntpTimeSyncBridge/ntpTimeSyncBridge.ino

@@ -46,7 +46,12 @@ Task taskBroadcastNTP(NTP_INTERVAL, TASK_FOREVER, [](){
   pkg.timestamp = millis();
   
   // Serialize and broadcast to mesh
-  String msg = pkg.toJson();
+  JsonDocument doc;
+  JsonObject obj = doc.to<JsonObject>();
+  pkg.addTo(std::move(obj));
+  
+  String msg;
+  serializeJson(doc, msg);
   mesh.sendBroadcast(msg);
   
   Serial.printf("Broadcast NTP time: %u from %s (accuracy: %ums)\n", 

package/library.json

@@ -6,7 +6,7 @@
     "type": "git",
     "url": "https://github.com/Alteriom/painlessMesh"
   },
-  "version": "1.8.5",
+  "version": "1.8.7",
   "frameworks": [
     "arduino"
   ],

package/library.properties

@@ -1,5 +1,5 @@
 name=Alteriom PainlessMesh
-version=1.8.5
+version=1.8.7
 author=Coopdis,Scotty Franzyshen,Edwin van Leeuwen,Germán Martín,Maximilian Schwarz,Doanh Doanh,Alteriom
 maintainer=Alteriom
 sentence=A painless way to setup a mesh with ESP8266 and ESP32 devices with Alteriom extensions

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alteriom/painlessmesh",
-  "version": "1.8.5",
+  "version": "1.8.7",
   "description": "painlessMesh is a user-friendly library for creating mesh networks with ESP8266 and ESP32 devices. This Alteriom fork includes additional packages for sensor data (SensorPackage), device commands (CommandPackage), and status monitoring (StatusPackage). It handles routing and network management automatically, so you can focus on your application. The library uses JSON-based messaging and syncs time across all nodes, making it ideal for coordinated behaviour like synchronized light displays or sensor networks reporting to a central node.",
   "keywords": [
     "arduino",

package/src/AlteriomPainlessMesh.h

@@ -29,10 +29,10 @@
 /**
  * @brief AlteriomPainlessMesh library version information
  */
-#define ALTERIOM_PAINLESS_MESH_VERSION "1.6.1"
+#define ALTERIOM_PAINLESS_MESH_VERSION "1.8.7"
 #define ALTERIOM_PAINLESS_MESH_VERSION_MAJOR 1
-#define ALTERIOM_PAINLESS_MESH_VERSION_MINOR 6
-#define ALTERIOM_PAINLESS_MESH_VERSION_PATCH 1
+#define ALTERIOM_PAINLESS_MESH_VERSION_MINOR 8
+#define ALTERIOM_PAINLESS_MESH_VERSION_PATCH 7
 
 /**
  * @brief Library description and usage information

package/src/arduino/wifi.hpp

@@ -155,6 +155,44 @@ class Mesh : public painlessmesh::Mesh<Connection> {
       }
     });
 
+    // Add periodic monitoring task to detect when no bridge exists
+    // This handles the case where no node was initially configured as a bridge
+    this->addTask(30000, TASK_FOREVER, [this]() {
+      // Only check if failover is enabled and we have credentials
+      if (!bridgeFailoverEnabled || !routerCredentialsConfigured) {
+        return;
+      }
+      
+      // Don't check if we're already a bridge
+      if (this->isBridge()) {
+        return;
+      }
+      
+      // Skip check during startup period (60 seconds) to allow initial bridge discovery
+      if (millis() < 60000) {
+        return;
+      }
+      
+      // Check if there are any healthy bridges
+      bool hasHealthyBridge = false;
+      for (const auto& bridge : this->getBridges()) {
+        if (bridge.isHealthy(bridgeTimeoutMs) && bridge.internetConnected) {
+          hasHealthyBridge = true;
+          break;
+        }
+      }
+      
+      // If no healthy bridge exists, trigger an election
+      if (!hasHealthyBridge) {
+        Log(CONNECTION, "Bridge monitor: No healthy bridge detected, triggering election\n");
+        // Small delay to randomize election start across nodes
+        uint32_t randomDelay = random(1000, 3000);
+        this->addTask(randomDelay, TASK_ONCE, [this]() {
+          this->startBridgeElection();
+        });
+      }
+    });
+
     tcpServerInit();
     eventHandleInit();
 
@@ -1147,7 +1185,12 @@ class Mesh : public painlessmesh::Mesh<Connection> {
     obj["from"] = this->nodeId;
     obj["routing"] = 2;  // BROADCAST routing
     obj["timestamp"] = this->getNodeTime();
-    obj["internetConnected"] = (WiFi.status() == WL_CONNECTED);
+    
+    // Check Internet connectivity: WiFi connected AND valid gateway IP
+    bool hasInternet = (WiFi.status() == WL_CONNECTED) && 
+                       (WiFi.gatewayIP() != IPAddress(0, 0, 0, 0));
+    obj["internetConnected"] = hasInternet;
+    
     obj["routerRSSI"] = WiFi.RSSI();
     obj["routerChannel"] = WiFi.channel();
     obj["uptime"] = millis();
@@ -1158,7 +1201,7 @@ class Mesh : public painlessmesh::Mesh<Connection> {
     serializeJson(doc, msg);
     
     Log(GENERAL, "sendBridgeStatus(): Broadcasting status (Internet: %s)\n",
-        (WiFi.status() == WL_CONNECTED) ? "Connected" : "Disconnected");
+        hasInternet ? "Connected" : "Disconnected");
     
     this->sendBroadcast(msg);
   }

package/src/painlessMesh.h

@@ -5,7 +5,7 @@
  * @file painlessMesh.h
  * @brief Main header file for Alteriom painlessMesh library
  * 
- * @version 1.8.4
+ * @version 1.8.7
  * @date 2025-11-12
  * 
  * painlessMesh is a user-friendly library for creating mesh networks with