doc: README with usage example ver: 0.1.0

Author: eigen-value

README.md

@@ -3,3 +3,64 @@ In this repo it will be implemented an Arduino library wrapper for RPClite to be
 The desired API is shown in https://github.com/bcmi-labs/Arduino_BridgeImola/blob/main/desired.ino.
 
 This is WIP. Expects changes soon.
+
+## The Bridge object ##
+
+Including Arduino_BridgeImola.h gives the user access to a Bridge object that can be used both as a RPC client and/or server to execute and serve RPCs to/from the CPU Host running a GOLANG router.
+
+- The Bridge object is defined on Serial1
+- The Bridge.call method is blocking and works the same as in RPClite
+- The Bridge can provide callbacks to incoming RPC requests both in a thread-unsafe and thread-safe fashion (provide & provide_safe)
+- Thread-safe methods execution is granted in the main loop thread where update_safe is called. By design users cannot access .update_safe() freely
+- Thread-unsafe methods are served in an update callback, whose execution is granted in a separate thread. Nonetheless users can access .update() freely with caution
+
+
+```cpp
+bool set_led(bool state) {
+    digitalWrite(LED_BUILTIN, state);
+    return state;
+}
+
+String greet() {
+    return String("Hello Friend");
+}
+
+void setup() {
+    Serial.begin(115200);
+    while (!Serial);
+
+    Serial1.begin(115200);
+    while (!Serial1);
+    
+    pinMode(LED_BUILTIN, OUTPUT);
+
+    if (!Bridge.begin()) {
+        Serial.println("Error initializing Bridge");
+        while(1);
+    } else {
+        Serial.println("Bridge initialized successfully");
+    }
+
+    if (!Bridge.provide("set_led", set_led)) {
+        Serial.println("Error providing method: set_led");
+    } else {
+        Serial.println("Registered method: set_led");
+    }
+
+    Bridge.provide_safe("greet", greet);
+
+}
+
+void loop() {
+    float res;
+    if (!Bridge.call("multiply", res, 1.0, 2.0)) {
+        Serial.println("Error calling method: multiply");
+        Serial.println(Bridge.get_error_code());
+        Serial.println(Bridge.get_error_message());
+    };
+
+    Bridge.notify("signal", 200);
+
+    //Bridge.update(); // Thread-unsafe update execution is granted in its own thread. It can be called manually with caution
+}
+```

examples/simple_bridge/simple_bridge.ino

@@ -38,7 +38,7 @@ void setup() {
 
     Bridge.provide("add", add);
 
-    Bridge.provide("greet", greet);
+    Bridge.provide_safe("greet", greet);
 
 }
 
@@ -48,10 +48,9 @@ void loop() {
         Serial.println("Error calling method: multiply");
         Serial.println(Bridge.get_error_code());
         Serial.println(Bridge.get_error_message());
-        delay(1000);
     };
 
     Bridge.notify("signal", 200);
 
-    //Bridge.update();
+    //Bridge.update(); // Thread-unsafe update execution is granted in its own thread. It can be called manually with caution
 }

examples/zephyr_thread/zephyr_thread.ino

@@ -11,12 +11,12 @@
     "url": "https://github.com/bcmi-labs/Arduino_BridgeImola",
     "maintainer": true
   },
-  "version": "0.0.1",
+  "version": "0.1.0",
   "license": "MIT",
   "frameworks": "arduino",
   "platforms": "*",
   "dependencies":
   {
-    "bcmi-labs/Arduino_RPClite": ">=0.0.1"
+    "bcmi-labs/Arduino_RPClite": ">=0.1.0"
   }
 }

library.json

@@ -1,10 +1,10 @@
 name=Arduino_BridgeImola
-version=0.0.1
+version=0.1.0
 author=BCMI-labs
 maintainer=BCMI-labs
 sentence=A RPC bridge for Imola boards
 paragraph=This library provides a simple RPC bridge for Imola boards, allowing communication between the board and other devices using MsgPack serialization.
 category=Communication
 url=https://www.arduino.cc/
 architectures=*
-depends=Arduino_RPClite (>=0.0.1)
+depends=Arduino_RPClite (>=0.1.0)