feat(I3C): Add I3C examples

Signed-off-by: Aymane Bahssain <aymane.bahssain@st.com>

Author: Aymane-ST

libraries/I3C/examples/BasicBegin/BasicBegin.ino

@@ -0,0 +1,24 @@
+#include <I3C.h>
+
+// Choose the bus instance available on your board.
+
+#define I3C_BUS = I3C1Bus;
+
+void setup() {
+  Serial.begin(115200);
+  while (!Serial) {}
+
+  Serial.println("I3C Basic Begin");
+
+  // Option 1: use default board I3C pins
+  if (!I3C_BUS.begin(1000000)) {
+    Serial.println("Failed to initialize I3C bus");
+    while (1) {}
+  }
+
+  Serial.println("I3C bus initialized at 1 MHz");
+}
+
+void loop() {
+  delay(1000);
+}

libraries/I3C/examples/Controller_Target/ControllerWrite/ControllerWrite.ino

@@ -0,0 +1,53 @@
+#include "I3C.h"
+
+#define I3C_BUS I3C1Bus
+static I3CDiscoveredDevice devices[8];
+
+void printHex2(uint8_t v) {
+  if (v < 0x10) Serial.print('0');
+  Serial.print(v, HEX);
+}
+
+void setup() {
+  Serial.begin(115200);
+  while (!Serial) {}
+  delay(1000);
+
+  Serial.println("=== Controller Write / Target Receive ===");
+
+  if (!I3C_BUS.begin(I3C_SDA, I3C_SCL, 1000000U)) {
+    Serial.println("begin() failed");
+    while (1) {}
+  }
+
+  size_t found = 0;
+  int rc = I3C_BUS.discover(devices, 8, &found);
+
+  if (rc != 0 || found == 0) {
+    Serial.println("No target found");
+    while (1) {}
+  }
+
+  uint8_t da = devices[0].dynAddr;
+
+  Serial.print("Target DA=0x");
+  printHex2(da);
+  Serial.println();
+
+  delay(1000);
+
+  uint8_t tx[16] = {
+    0x01, 0x02, 0x03, 0x04,
+    0x05, 0x06, 0x07, 0x08,
+    0x09, 0x0A, 0x0B, 0x0C,
+    0x0D, 0x0E, 0x0F, 0x10
+  };
+
+  int wr = I3C_BUS.write(da, tx, sizeof(tx), 1000);
+  Serial.print("write rc = ");
+  Serial.println(wr);
+}
+
+void loop() {
+  delay(1000);
+}

libraries/I3C/examples/Controller_Target/TargetReceive/TargetReceive.ino

@@ -0,0 +1,52 @@
+#include "I3C.h"
+
+#define I3C_BUS I3C1Bus
+static uint8_t rxBuf[16];
+
+void printHex2(uint8_t v) {
+  if (v < 0x10) Serial.print('0');
+  Serial.print(v, HEX);
+}
+
+void setup() {
+  Serial.begin(115200);
+  while (!Serial) {}
+  delay(1000);
+
+  Serial.println("=== Target Receive ===");
+
+  I3CTargetConfig cfg{};
+  cfg.identifier = 0x62;
+  cfg.mipiIdentifier = 0x1;
+
+  if (!I3C_BUS.beginTarget(I3C_SDA, I3C_SCL, cfg)) {
+    Serial.println("beginTarget failed");
+    while (1) {}
+  }
+
+  while (!I3C_BUS.hasAddress()) {
+    delay(10);
+  }
+
+  Serial.print("DA = 0x");
+  Serial.println(I3C_BUS.address(), HEX);
+
+  HAL_I3C_FlushAllFifo(I3C_BUS.halHandle());
+
+  int rc = I3C_BUS.receive(rxBuf, sizeof(rxBuf), 10000);
+  Serial.print("receive rc = ");
+  Serial.println(rc);
+
+  if (rc == 0) {
+    Serial.print("RX: ");
+    for (size_t i = 0; i < sizeof(rxBuf); ++i) {
+      printHex2(rxBuf[i]);
+      Serial.print(' ');
+    }
+    Serial.println();
+  }
+}
+
+void loop() {
+  delay(1000);
+}

libraries/I3C/examples/DeviceReady/DeviceReady.ino

@@ -0,0 +1,31 @@
+#include <I3C.h>
+
+#define I3C_BUS = I3C1Bus;
+
+
+void setup() {
+  Serial.begin(115200);
+  while (!Serial) {}
+
+  Serial.println("I3C Device Ready Example");
+
+  if (!I3C_BUS.begin(1000000)) {
+    Serial.println("Failed to initialize I3C bus");
+    while (1) {}
+  }
+
+  for (uint8_t addr = 1; addr < 0x7F; ++addr) {
+
+    bool i3cReady = I3C_BUS.isI3CDeviceReady(addr);
+    if (i3cReady) {
+      Serial.print("I3C device at DA 0x");
+      Serial.print(addr, HEX);
+      Serial.print(": ");
+      Serial.println("READY");
+    }
+  }
+}
+
+void loop() {
+  delay(1000);
+}

libraries/I3C/examples/LPS22DF/Basic/Basic.ino

@@ -0,0 +1,55 @@
+#include "I3C.h"
+#include "LPS22DFSensor.h"
+
+#define I3C_BUS I3C1Bus
+
+static const uint8_t LPS22DF_DYN_ADDR = 0x30;
+
+LPS22DFSensor sensor(&I3C_BUS, LPS22DF_I3C_ADD_H, LPS22DF_DYN_ADDR);
+
+void setup() {
+  Serial.begin(115200);
+  while (!Serial) {}
+  delay(1000);
+
+  Serial.println("=== LPS22DF SETDASA ===");
+
+  if (!I3C_BUS.begin(I3C_SDA, I3C_SCL, 1000000U)) {
+    Serial.println("begin() failed");
+    while (1) {}
+  }
+
+  if (!I3C_BUS.resetDynamicAddresses()) {
+    Serial.println("resetDynamicAddresses() failed");
+    while (1) {}
+  }
+
+  if (sensor.begin() != LPS22DF_OK) {
+    Serial.println("sensor.begin() failed");
+    while (1) {}
+  }
+
+  if (sensor.Enable() != LPS22DF_OK) {
+    Serial.println("sensor.Enable() failed");
+    while (1) {}
+  }
+
+  Serial.println("LPS22DF ready");
+}
+
+void loop() {
+  float p = 0.0f;
+  float t = 0.0f;
+
+  if (sensor.GetPressure(&p) == LPS22DF_OK && sensor.GetTemperature(&t) == LPS22DF_OK) {
+    Serial.print("P = ");
+    Serial.print(p, 2);
+    Serial.print(" hPa   T = ");
+    Serial.print(t, 1);
+    Serial.println(" C");
+  } else {
+    Serial.println("Read failed");
+  }
+
+  delay(500);
+}

libraries/I3C/examples/LPS22DF/DynAddrAssign/DynAddrAssign.ino

@@ -0,0 +1,73 @@
+#include "I3C.h"
+#include "LPS22DFSensor.h"
+
+#define I3C_BUS I3C1Bus
+
+LPS22DFSensor sensor(&I3C_BUS, 0x00);
+
+void setup() {
+  Serial.begin(115200);
+  while (!Serial) {}
+  delay(1000);
+
+  Serial.println("=== LPS22DF DAA ===");
+
+  if (!I3C_BUS.begin(I3C_SDA, I3C_SCL, 1000000U)) {
+    Serial.println("begin() failed");
+    while (1) {}
+  }
+
+  I3CDiscoveredDevice devices[8]{};
+  size_t found = 0;
+
+  if (I3C_BUS.discover(devices, 8, &found)) {
+    Serial.println("discover() failed");
+    while (1) {}
+  }
+
+  uint8_t lpsDynAddr = 0U;
+
+  for (size_t i = 0; i < found; ++i) {
+    Serial.println(devices[i].pid,HEX);
+    if (devices[i].pid == LPS22DF_I3C_PID_H) {
+      lpsDynAddr = devices[i].dynAddr;
+      break;
+    }
+  }
+
+  sensor.set_address(lpsDynAddr);
+
+  if (lpsDynAddr == 0U) {
+    Serial.println("Sensor not found failed");
+    while (1) {}
+  }
+
+  if (sensor.begin() != LPS22DF_OK) {
+    Serial.println("sensor.begin() failed");
+    while (1) {}
+  }
+
+  if (sensor.Enable() != LPS22DF_OK) {
+    Serial.println("sensor.Enable() failed");
+    while (1) {}
+  }
+
+  Serial.println("LPS22DF ready");
+}
+
+void loop() {
+  float p = 0.0f;
+  float t = 0.0f;
+
+  if (sensor.GetPressure(&p) == LPS22DF_OK && sensor.GetTemperature(&t) == LPS22DF_OK) {
+    Serial.print("P = ");
+    Serial.print(p, 2);
+    Serial.print(" hPa   T = ");
+    Serial.print(t, 1);
+    Serial.println(" C");
+  } else {
+    Serial.println("Read failed");
+  }
+
+  delay(500);
+}

libraries/I3C/examples/LPS22DF/IBI/IBI.ino

@@ -0,0 +1,50 @@
+#include "I3C.h"
+#include "LPS22DFSensor.h"
+
+#define I3C_BUS I3C1Bus
+
+LPS22DFSensor sensor(&I3C_BUS, LPS22DF_I3C_ADD_H, 0x30);
+static volatile bool ibiPending = false;
+
+
+
+void setup() {
+  Serial.begin(115200);
+  while (!Serial) {}
+
+  I3C_BUS.begin(I3C_SDA, I3C_SCL, 1000000U);
+  I3C_BUS.onIbi([](const I3CControllerIbiInfo&, void*) {
+    ibiPending = true;
+  },
+                nullptr);
+
+  sensor.begin();
+  sensor.SetOutputDataRate(10.0f);
+  sensor.ConfigureDataReadyOnI3cIbi();
+  sensor.EnableIbiOnBus();
+  sensor.Enable();
+
+  Serial.println("Waiting for IBI  ...");
+}
+
+void loop() {
+  if (!ibiPending && !I3C_BUS.hasIbi()) {
+    return;
+  }
+
+  ibiPending = false;
+
+  I3CControllerIbiInfo ibi{};
+  if (!I3C_BUS.readIbi(ibi)) {
+    return;
+  }
+
+  float p, t;
+  if (sensor.GetPressure(&p) == LPS22DF_OK && sensor.GetTemperature(&t) == LPS22DF_OK) {
+    Serial.print("  P = ");
+    Serial.print(p, 2);
+    Serial.print(" hPa, T = ");
+    Serial.print(t, 1);
+    Serial.println(" C");
+  }
+}