@alteriom/painlessmesh 1.7.9 → 1.8.1

package/examples/multi_bridge/regular_node.ino

@@ -0,0 +1,141 @@
+//************************************************************
+// Multi-Bridge Example: Regular Node
+//
+// This example demonstrates a regular mesh node in a multi-bridge
+// network. The node automatically discovers and uses available bridges
+// for Internet connectivity.
+//
+// Features demonstrated:
+// - Automatic bridge discovery
+// - Bridge selection awareness
+// - Message routing to best available bridge
+// - Failover handling
+//************************************************************
+
+#include "painlessMesh.h"
+
+#define MESH_PREFIX     "MultiBridgeMesh"
+#define MESH_PASSWORD   "meshpassword"
+#define MESH_PORT       5555
+
+Scheduler userScheduler;
+painlessMesh mesh;
+
+// Simulated sensor data
+float temperature = 22.5;
+float humidity = 45.0;
+
+// Task to send sensor data
+Task taskSendMessage(5000, TASK_FOREVER, [](){
+  // Simulate sensor readings
+  temperature += (random(-10, 10) / 10.0);
+  humidity += (random(-50, 50) / 10.0);
+  
+  String msg = "Temperature: " + String(temperature, 1) + "°C, Humidity: " + String(humidity, 1) + "%";
+  
+  Serial.println("\n--- Sending Sensor Data ---");
+  
+  // Get recommended bridge
+  uint32_t recommendedBridge = mesh.getRecommendedBridge();
+  
+  if (recommendedBridge != 0) {
+    Serial.printf("Recommended Bridge: %u\n", recommendedBridge);
+    Serial.printf("Message: %s\n", msg.c_str());
+    
+    // Send to specific bridge
+    mesh.sendSingle(recommendedBridge, msg);
+    Serial.println("✓ Sent to bridge");
+  } else {
+    Serial.println("⚠️ No bridge available!");
+    Serial.println("Message queued for later delivery");
+    // In production, you would queue this message
+  }
+  Serial.println("---------------------------\n");
+});
+
+// Task to display network status
+Task taskNetworkStatus(15000, TASK_FOREVER, [](){
+  Serial.println("\n=== Network Status ===");
+  Serial.printf("Node ID: %u\n", mesh.getNodeId());
+  Serial.printf("Connected Nodes: %d\n", mesh.getNodeList().size());
+  
+  // Show all active bridges
+  auto activeBridges = mesh.getActiveBridges();
+  Serial.printf("Active Bridges: %d\n", activeBridges.size());
+  
+  if (activeBridges.empty()) {
+    Serial.println("  ⚠️ NO BRIDGES AVAILABLE");
+  } else {
+    for (auto bridgeId : activeBridges) {
+      Serial.printf("  - Bridge: %u\n", bridgeId);
+    }
+  }
+  
+  // Check Internet connectivity
+  bool hasInternet = mesh.hasInternetConnection();
+  Serial.printf("Internet Available: %s\n", hasInternet ? "YES" : "NO");
+  
+  Serial.println("======================\n");
+});
+
+void receivedCallback(uint32_t from, String& msg) {
+  Serial.printf("📨 Received from %u: %s\n", from, msg.c_str());
+}
+
+void newConnectionCallback(uint32_t nodeId) {
+  Serial.printf("🔗 New Connection: %u\n", nodeId);
+}
+
+void changedConnectionCallback() {
+  Serial.printf("🔄 Connections changed. Total nodes: %d\n", mesh.getNodeList().size());
+}
+
+void bridgeStatusCallback(uint32_t bridgeNodeId, bool hasInternet) {
+  Serial.printf("\n🌉 Bridge Status Update: Bridge %u - Internet %s\n", 
+                bridgeNodeId, hasInternet ? "CONNECTED" : "OFFLINE");
+  
+  if (hasInternet) {
+    Serial.println("✓ Internet connection available");
+  } else {
+    Serial.println("⚠️ Bridge lost Internet - checking for alternatives...");
+    
+    auto activeBridges = mesh.getActiveBridges();
+    if (activeBridges.empty()) {
+      Serial.println("⚠️ No alternative bridges available!");
+    } else {
+      Serial.printf("✓ %d alternative bridge(s) available\n", activeBridges.size());
+    }
+  }
+}
+
+void setup() {
+  Serial.begin(115200);
+  delay(2000);
+  
+  Serial.println("\n\n=== Multi-Bridge: REGULAR NODE ===\n");
+  
+  // Initialize as regular mesh node
+  mesh.setDebugMsgTypes(ERROR | STARTUP | CONNECTION);
+  
+  mesh.init(MESH_PREFIX, MESH_PASSWORD, &userScheduler, MESH_PORT);
+  
+  mesh.onReceive(&receivedCallback);
+  mesh.onNewConnection(&newConnectionCallback);
+  mesh.onChangedConnections(&changedConnectionCallback);
+  mesh.onBridgeStatusChanged(&bridgeStatusCallback);
+  
+  // Add tasks
+  userScheduler.addTask(taskSendMessage);
+  userScheduler.addTask(taskNetworkStatus);
+  taskSendMessage.enable();
+  taskNetworkStatus.enable();
+  
+  Serial.println("\n=== Regular Node Ready ===");
+  Serial.println("This node will automatically discover and use available bridges");
+  Serial.println("In multi-bridge mode, it will use the highest priority bridge");
+  Serial.println("If primary fails, it automatically switches to secondary\n");
+}
+
+void loop() {
+  mesh.update();
+}

package/examples/multi_bridge/secondary_bridge.ino

@@ -0,0 +1,111 @@
+//************************************************************
+// Multi-Bridge Example: Secondary Bridge Node
+//
+// This example demonstrates a secondary bridge (priority 5) in a
+// multi-bridge deployment. This provides hot standby redundancy
+// and can handle load if the primary bridge is busy.
+//
+// Features demonstrated:
+// - Secondary bridge with medium priority
+// - Hot standby mode (always ready)
+// - Automatic failover if primary fails
+// - Load balancing support
+//************************************************************
+
+#include "painlessMesh.h"
+
+#define MESH_PREFIX     "MultiBridgeMesh"
+#define MESH_PASSWORD   "meshpassword"
+#define MESH_PORT       5555
+
+// Secondary router connection (backup Internet or different ISP)
+#define ROUTER_SSID     "SecondaryRouter"
+#define ROUTER_PASSWORD "routerpass2"
+
+Scheduler userScheduler;
+painlessMesh mesh;
+
+// Task to display bridge coordination status
+Task taskBridgeStatus(10000, TASK_FOREVER, [](){
+  Serial.println("\n=== Secondary Bridge Status ===");
+  Serial.printf("Node ID: %u\n", mesh.getNodeId());
+  Serial.printf("Connected Nodes: %d\n", mesh.getNodeList().size());
+  
+  // Show all active bridges in the mesh
+  auto activeBridges = mesh.getActiveBridges();
+  Serial.printf("Active Bridges: %d\n", activeBridges.size());
+  for (auto bridgeId : activeBridges) {
+    Serial.printf("  - Bridge: %u%s\n", bridgeId, 
+                  (bridgeId == mesh.getNodeId()) ? " (ME)" : "");
+  }
+  
+  // Show recommended bridge for next message
+  uint32_t recommended = mesh.getRecommendedBridge();
+  Serial.printf("Recommended Bridge: %u\n", recommended);
+  
+  if (recommended == mesh.getNodeId()) {
+    Serial.println("⚠️  I AM THE ACTIVE BRIDGE (primary likely failed!)");
+  } else {
+    Serial.println("✓ Standby mode - primary bridge is active");
+  }
+  Serial.println("=============================\n");
+});
+
+void receivedCallback(uint32_t from, String& msg) {
+  Serial.printf("Received from %u: %s\n", from, msg.c_str());
+}
+
+void newConnectionCallback(uint32_t nodeId) {
+  Serial.printf("New Connection, nodeId = %u\n", nodeId);
+}
+
+void changedConnectionCallback() {
+  Serial.printf("Changed connections. Node count: %d\n", mesh.getNodeList().size());
+}
+
+void bridgeStatusCallback(uint32_t bridgeNodeId, bool hasInternet) {
+  if (hasInternet) {
+    Serial.printf("✓ Bridge %u: Internet connected\n", bridgeNodeId);
+  } else {
+    Serial.printf("⚠️ Bridge %u: Internet OFFLINE\n", bridgeNodeId);
+  }
+}
+
+void setup() {
+  Serial.begin(115200);
+  delay(2000);
+  
+  Serial.println("\n\n=== Multi-Bridge: SECONDARY BRIDGE ===\n");
+  
+  // Initialize mesh as secondary bridge with priority 5
+  mesh.setDebugMsgTypes(ERROR | STARTUP | CONNECTION);
+  
+  // Enable multi-bridge coordination mode
+  mesh.enableMultiBridge(true);
+  
+  // Set bridge selection strategy (PRIORITY_BASED is default)
+  mesh.setBridgeSelectionStrategy(painlessMesh::PRIORITY_BASED);
+  
+  // Initialize as bridge with priority 5 (secondary)
+  mesh.initAsBridge(MESH_PREFIX, MESH_PASSWORD,
+                    ROUTER_SSID, ROUTER_PASSWORD,
+                    &userScheduler, MESH_PORT, 5);  // Priority 5 = Secondary
+  
+  mesh.onReceive(&receivedCallback);
+  mesh.onNewConnection(&newConnectionCallback);
+  mesh.onChangedConnections(&changedConnectionCallback);
+  mesh.onBridgeStatusChanged(&bridgeStatusCallback);
+  
+  // Add status reporting task
+  userScheduler.addTask(taskBridgeStatus);
+  taskBridgeStatus.enable();
+  
+  Serial.println("\n=== Secondary Bridge Ready ===");
+  Serial.println("This node is the SECONDARY bridge (Priority 5)");
+  Serial.println("It operates in hot standby mode");
+  Serial.println("Will take over if primary bridge fails\n");
+}
+
+void loop() {
+  mesh.update();
+}