updated

Author: petesramek

examples/Basic_Duplex/README.md

@@ -1,36 +1,45 @@
-# Basic Duplex: MH-Tiny88 ↔ ESP-M3
+# Basic Duplex: MH-Tiny88 ↔ ESP-M3 (Polling Style)
 
-This example demonstrates a *full-duplex, bidirectional* link between an *MH-Tiny88* (acting as a sensor node) and an *ESP-M3* (acting as a Wi-Fi bridge). It utilizes *COBS framing* and *Fletcher-16 checksums* to ensure data integrity over a noisy serial line.
+This example demonstrates a *full-duplex, bidirectional* link between an *MH-Tiny88* (Sensor Node) and an *ESP-M3* (Wi-Fi Bridge). It uses the standard *Polling* pattern to check for new data, making it easy to integrate into existing Arduino sketches.
 
-## 🛠 Hardware Setup
+## 🌟 Features
 
-Since the MH-Tiny88 operates at *5V* and the ESP-M3 operates at *3.3V*, you must use a voltage divider or level shifter on the Tiny88's TX line to avoid damaging the ESP.
+- *Polling Logic*: Uses `link.available()` and `link.peek()` for manual data handling.
+- *Bi-Directional*: Both devices act as peers, sending and receiving data simultaneously.
+- *Reliable*: Protected by *COBS* framing and *Fletcher-16 checksums*.
 
-### Wiring Diagram
+## 🛠 Hardware Setup
 
-MH-Tiny88 (5V)	Connection	ESP-M3 (3.3V)
-TX (D1)	───[ 1kΩ ]──┬──	RX
-└─[ 2kΩ ]─┤ GND
-RX (D0)	──────────────	TX
-GND	──────────────	GND (Common)
+The MH-Tiny88 (*5V*) and ESP-M3 (*3.3V*) require a voltage divider on the Tiny88's TX line to protect the ESP.
 
-> Note: The 2kΩ resistor goes to Ground, creating a 3.3V signal from the 5V TX.
+*MH-Tiny88 (5V)* | *Connection* | *ESP-M3 (3.3V)*
+TX (D1) |	───[ 1kΩ ]──┬──	| RX
+        | └─[ 2kΩ ]─┤       | GND
+RX (D0) | ──────────────    | TX
+GND     | ──────────────    | GND (Common)
 
-## 📂 Example Structure
+## 📂 Code Overview
+This example uses a manual check inside the `loop()` function:
 
-*SharedData.h*: Defines the struct MyData used by both devices. *Must be identical on both sides*.
-*Tiny88_Sensor.ino*: Collects "simulated" sensor data and sends it every 2 seconds. Uses a *callback* to handle incoming commands from the ESP.
-*ESPM3_Bridge.ino*: Receives sensor data and immediately sends a command response back to the Tiny88.
+```cpp
+void loop() {
+    link.update(); // Keep the engine running
 
-## 🚀 How to Run
+    if (link.available()) {
+        const MyData& incoming = link.peek();
+        // Handle your data here...
+        
+        link.flush(); // Clear the flag to allow the next packet
+    }
+}
+```
 
-Open Tiny88_Sensor.ino in the Arduino IDE and upload it to your *MH-Tiny88*.
-Open ESPM3_Bridge.ino and upload it to your *ESP-M3*.
-Open the Serial Monitor for the *ESP-M3* at *9600 Baud*.
-You should see the incoming packets from the Tiny88 being displayed.
+- *`link.available()`*: Returns `true` only when a full, verified packet has arrived.
+- *`link.peek()`*: Provides a constant reference to the data without copying it, saving RAM.
+- *`link.flush()`*: Tells the library you have finished reading the data, allowing the hardware buffer to be parsed for the next packet.
 
-## 📈 Features Demonstrated
+## 🚀 How to Run
 
-*Asynchronous Callbacks*: Using link.onReceive() for non-blocking command handling.
-*Telemetry*: Monitoring link.getStats() for CRC errors or timeouts.
-*Safety*: Automatic buffer protection via COBS delimiting.
+Upload `Tiny88_Sensor.ino` to the *MH-Tiny88*.
+Upload `ESPM3_Bridge.ino` to the *ESP-M3*.
+Observe the interaction via the Serial Monitor.

examples/Basic_Duplex/Tiny88_Sensor.ino

@@ -1,31 +1,29 @@
-#include <../../src/TinyLink.h>
+#include <TinyLink.h>
 #include <../../src/adapters/TinyArduinoAdapter.h>
 #include "SharedData.h"
 
-// Initialize Adapter on Hardware Serial
 TinyArduinoAdapter adapter(Serial);
 TinyLink<MyData, TinyArduinoAdapter> link(adapter);
 
-void onCommandReceived(const MyData& data) {
-    // If ESP sends a command back
-    if (data.commandId == 1) {
-        digitalWrite(LED_BUILTIN, HIGH);
-    } else {
-        digitalWrite(LED_BUILTIN, LOW);
-    }
-}
-
 void setup() {
     Serial.begin(9600);
-    pinMode(LED_BUILTIN, OUTPUT);
-    
-    // Register asynchronous callback
-    link.onReceive(onCommandReceived);
 }
 
 void loop() {
     link.update();
 
+    // Polling for new data
+    if (link.available()) {
+        const MyData& incoming = link.peek();
+        
+        if (incoming.commandId == 1) {
+            digitalWrite(LED_BUILTIN, HIGH);
+        }
+        
+        link.flush(); // Clear flag for next packet
+    }
+
+    // Send sensor data every 2s
     static uint32_t lastSend = 0;
     if (millis() - lastSend > 2000) {
         MyData status = { millis(), 24.5f, 0 };