I2S driver implementation (#480)

* **New Features**
  * ESP32 I2S controller support: runtime-configurable digital audio I/O with read/write/set/get operations and multiple formats.

* **Board Support**
  * LilyGO T-Deck device tree entry added to enable I2S peripheral pin configuration.

* **Documentation**
  * New/updated bindings and descriptors for I2S, I2C, GPIO, and root nodes.

* **Other**
  * Added GPIO "no pin" sentinel and exposed I2S controller API symbols.

TactilityKernel/Source/drivers/gpio_controller.cpp

@@ -32,6 +32,6 @@ error_t gpio_controller_get_pin_count(struct Device* device, uint32_t* count) {
     return GPIO_DRIVER_API(driver)->get_pin_count(device, count);
 }
 
-const struct DeviceType GPIO_CONTROLLER_TYPE { 0 };
+extern const struct DeviceType GPIO_CONTROLLER_TYPE { 0 };
 
 }

TactilityKernel/Source/drivers/i2c_controller.cpp

@@ -49,6 +49,6 @@ error_t i2c_controller_has_device_at_address(Device* device, uint8_t address, Ti
     return I2C_DRIVER_API(driver)->write(device, address, message, 2, timeout);
 }
 
-const struct DeviceType I2C_CONTROLLER_TYPE { 0 };
+extern const struct DeviceType I2C_CONTROLLER_TYPE { 0 };
 
 }

TactilityKernel/Source/drivers/i2s_controller.cpp

@@ -0,0 +1,37 @@
+// SPDX-License-Identifier: Apache-2.0
+#include <tactility/drivers/i2s_controller.h>
+#include <tactility/error.h>
+#include <tactility/device.h>
+
+#define I2S_DRIVER_API(driver) ((struct I2sControllerApi*)driver->api)
+
+extern "C" {
+
+error_t i2s_controller_read(Device* device, void* data, size_t dataSize, size_t* bytesRead, TickType_t timeout) {
+    const auto* driver = device_get_driver(device);
+    return I2S_DRIVER_API(driver)->read(device, data, dataSize, bytesRead, timeout);
+}
+
+error_t i2s_controller_write(Device* device, const void* data, size_t dataSize, size_t* bytesWritten, TickType_t timeout) {
+    const auto* driver = device_get_driver(device);
+    return I2S_DRIVER_API(driver)->write(device, data, dataSize, bytesWritten, timeout);
+}
+
+error_t i2s_controller_set_config(Device* device, const struct I2sConfig* config) {
+    const auto* driver = device_get_driver(device);
+    return I2S_DRIVER_API(driver)->set_config(device, config);
+}
+
+error_t i2s_controller_get_config(Device* device, struct I2sConfig* config) {
+    const auto* driver = device_get_driver(device);
+    return I2S_DRIVER_API(driver)->get_config(device, config);
+}
+
+error_t i2s_controller_reset(struct Device* device) {
+    const auto* driver = device_get_driver(device);
+    return I2S_DRIVER_API(driver)->reset(device);
+}
+
+extern const struct DeviceType I2S_CONTROLLER_TYPE { 0 };
+
+}

TactilityKernel/Source/kernel_symbols.c

@@ -1,6 +1,7 @@
 #include <tactility/device.h>
 #include <tactility/driver.h>
 #include <tactility/drivers/i2c_controller.h>
+#include <tactility/drivers/i2s_controller.h>
 #include <tactility/drivers/gpio_controller.h>
 #include <tactility/concurrent/dispatcher.h>
 #include <tactility/concurrent/event_group.h>
@@ -58,6 +59,7 @@ const struct ModuleSymbol KERNEL_SYMBOLS[] = {
     DEFINE_MODULE_SYMBOL(gpio_controller_set_options),
     DEFINE_MODULE_SYMBOL(gpio_controller_get_options),
     DEFINE_MODULE_SYMBOL(gpio_controller_get_pin_count),
+    DEFINE_MODULE_SYMBOL(GPIO_CONTROLLER_TYPE),
     // drivers/i2c_controller
     DEFINE_MODULE_SYMBOL(i2c_controller_read),
     DEFINE_MODULE_SYMBOL(i2c_controller_write),
@@ -66,6 +68,14 @@ const struct ModuleSymbol KERNEL_SYMBOLS[] = {
     DEFINE_MODULE_SYMBOL(i2c_controller_write_register),
     DEFINE_MODULE_SYMBOL(i2c_controller_write_register_array),
     DEFINE_MODULE_SYMBOL(i2c_controller_has_device_at_address),
+    DEFINE_MODULE_SYMBOL(I2C_CONTROLLER_TYPE),
+    // drivers/i2s_controller
+    DEFINE_MODULE_SYMBOL(i2s_controller_read),
+    DEFINE_MODULE_SYMBOL(i2s_controller_write),
+    DEFINE_MODULE_SYMBOL(i2s_controller_set_config),
+    DEFINE_MODULE_SYMBOL(i2s_controller_get_config),
+    DEFINE_MODULE_SYMBOL(i2s_controller_reset),
+    DEFINE_MODULE_SYMBOL(I2S_CONTROLLER_TYPE),
     // concurrent/dispatcher
     DEFINE_MODULE_SYMBOL(dispatcher_alloc),
     DEFINE_MODULE_SYMBOL(dispatcher_free),