Kernel improvements (#485)

* **New Features**
  * Added public accessors for querying module/device start and ready state.

* **Refactor**
  * Internal state moved to opaque internal objects; module/device/driver initializers now explicitly initialize internal pointers.
  * Lifecycle handling updated to construct/destruct internal state and use accessors.

* **Tests**
  * Tests updated to use public accessors and explicit construct/destruct lifecycle calls.

* **Chores**
  * Test build/include paths and small metadata updated.

Buildscripts/DevicetreeCompiler/source/generator.py

@@ -134,6 +134,7 @@ def write_device_structs(file, device: Device, parent_device: Device, bindings:
     file.write(f"\t.name = \"{device.node_name}\",\n") # Use original name
     file.write(f"\t.config = &{config_variable_name},\n")
     file.write(f"\t.parent = {parent_value},\n")
+    file.write("\t.internal = NULL\n")
     file.write("};\n\n")
     # Child devices
     for child_device in device.devices:

Devices/btt-panda-touch/Source/module.cpp

@@ -17,7 +17,8 @@ struct Module device_module = {
     .name = "btt-panda-touch",
     .start = start,
     .stop = stop,
-    .symbols = nullptr
+    .symbols = nullptr,
+    .internal = nullptr
 };
 
 }

Devices/cyd-2432s024c/Source/module.cpp

@@ -17,7 +17,8 @@ struct Module device_module = {
     .name = "cyd-2432s024c",
     .start = start,
     .stop = stop,
-    .symbols = nullptr
+    .symbols = nullptr,
+    .internal = nullptr
 };
 
 }

Devices/cyd-2432s028r/Source/module.cpp

@@ -17,7 +17,8 @@ struct Module device_module = {
     .name = "cyd-2432s028r",
     .start = start,
     .stop = stop,
-    .symbols = nullptr
+    .symbols = nullptr,
+    .internal = nullptr
 };
 
 }

Devices/cyd-2432s028rv3/Source/module.cpp

@@ -17,7 +17,8 @@ struct Module device_module = {
     .name = "cyd-2432s028rv3",
     .start = start,
     .stop = stop,
-    .symbols = nullptr
+    .symbols = nullptr,
+    .internal = nullptr
 };
 
 }

Devices/cyd-2432s032c/Source/module.cpp

@@ -17,7 +17,8 @@ struct Module device_module = {
     .name = "cyd-2432s032c",
     .start = start,
     .stop = stop,
-    .symbols = nullptr
+    .symbols = nullptr,
+    .internal = nullptr
 };
 
 }

Devices/cyd-4848s040c/Source/module.cpp

@@ -17,7 +17,8 @@ struct Module device_module = {
     .name = "cyd-4848s040c",
     .start = start,
     .stop = stop,
-    .symbols = nullptr
+    .symbols = nullptr,
+    .internal = nullptr
 };
 
 }

Devices/cyd-8048s043c/Source/module.cpp

@@ -17,7 +17,8 @@ struct Module device_module = {
     .name = "cyd-8048s043c",
     .start = start,
     .stop = stop,
-    .symbols = nullptr
+    .symbols = nullptr,
+    .internal = nullptr
 };
 
 }

Devices/cyd-e32r28t/Source/module.cpp

@@ -17,7 +17,8 @@ struct Module device_module = {
     .name = "cyd-e32r28t",
     .start = start,
     .stop = stop,
-    .symbols = nullptr
+    .symbols = nullptr,
+    .internal = nullptr
 };
 
 }

Devices/cyd-e32r32p/Source/module.cpp

@@ -17,7 +17,8 @@ struct Module device_module = {
     .name = "cyd-e32r32p",
     .start = start,
     .stop = stop,
-    .symbols = nullptr
+    .symbols = nullptr,
+    .internal = nullptr
 };
 
 }

Devices/elecrow-crowpanel-advance-35/Source/module.cpp

@@ -17,7 +17,8 @@ struct Module device_module = {
     .name = "elecrow-crowpanel-advance-35",
     .start = start,
     .stop = stop,
-    .symbols = nullptr
+    .symbols = nullptr,
+    .internal = nullptr
 };
 
 }

Devices/elecrow-crowpanel-advance-50/Source/module.cpp

@@ -17,7 +17,8 @@ struct Module device_module = {
     .name = "elecrow-crowpanel-advance-50",
     .start = start,
     .stop = stop,
-    .symbols = nullptr
+    .symbols = nullptr,
+    .internal = nullptr
 };
 
 }

Devices/elecrow-crowpanel-basic-28/Source/module.cpp

@@ -17,7 +17,8 @@ struct Module device_module = {
     .name = "elecrow-crowpanel-basic-28",
     .start = start,
     .stop = stop,
-    .symbols = nullptr
+    .symbols = nullptr,
+    .internal = nullptr
 };
 
 }

Devices/elecrow-crowpanel-basic-35/Source/module.cpp

@@ -17,7 +17,8 @@ struct Module device_module = {
     .name = "elecrow-crowpanel-basic-35",
     .start = start,
     .stop = stop,
-    .symbols = nullptr
+    .symbols = nullptr,
+    .internal = nullptr
 };
 
 }

Devices/elecrow-crowpanel-basic-50/Source/module.cpp

@@ -17,7 +17,8 @@ struct Module device_module = {
     .name = "elecrow-crowpanel-basic-50",
     .start = start,
     .stop = stop,
-    .symbols = nullptr
+    .symbols = nullptr,
+    .internal = nullptr
 };
 
 }

Devices/generic-esp32/Source/module.cpp

@@ -17,7 +17,8 @@ struct Module device_module = {
     .name = "generic-esp32",
     .start = start,
     .stop = stop,
-    .symbols = nullptr
+    .symbols = nullptr,
+    .internal = nullptr
 };
 
 }

Devices/generic-esp32c6/Source/module.cpp

@@ -17,7 +17,8 @@ struct Module device_module = {
     .name = "generic-esp32c6",
     .start = start,
     .stop = stop,
-    .symbols = nullptr
+    .symbols = nullptr,
+    .internal = nullptr
 };
 
 }

Devices/generic-esp32p4/Source/module.cpp

@@ -17,7 +17,8 @@ struct Module device_module = {
     .name = "generic-esp32p4",
     .start = start,
     .stop = stop,
-    .symbols = nullptr
+    .symbols = nullptr,
+    .internal = nullptr
 };
 
 }

Devices/generic-esp32s3/Source/module.cpp

@@ -17,7 +17,8 @@ struct Module device_module = {
     .name = "generic-esp32s3",
     .start = start,
     .stop = stop,
-    .symbols = nullptr
+    .symbols = nullptr,
+    .internal = nullptr
 };
 
 }

Devices/guition-jc1060p470ciwy/Source/module.cpp

@@ -17,7 +17,8 @@ struct Module device_module = {
     .name = "guition-jc1060p470ciwy",
     .start = start,
     .stop = stop,
-    .symbols = nullptr
+    .symbols = nullptr,
+    .internal = nullptr
 };
 
 }

Devices/guition-jc2432w328c/Source/module.cpp

@@ -17,7 +17,8 @@ struct Module device_module = {
     .name = "guition-jc2432w328c",
     .start = start,
     .stop = stop,
-    .symbols = nullptr
+    .symbols = nullptr,
+    .internal = nullptr
 };
 
 }

Devices/guition-jc3248w535c/Source/module.cpp

@@ -17,7 +17,8 @@ struct Module device_module = {
     .name = "guition-jc3248w535c",
     .start = start,
     .stop = stop,
-    .symbols = nullptr
+    .symbols = nullptr,
+    .internal = nullptr
 };
 
 }

Devices/guition-jc8048w550c/Source/module.cpp

@@ -17,7 +17,8 @@ struct Module device_module = {
     .name = "guition-jc8048w550c",
     .start = start,
     .stop = stop,
-    .symbols = nullptr
+    .symbols = nullptr,
+    .internal = nullptr
 };
 
 }

Devices/heltec-wifi-lora-32-v3/Source/module.cpp

@@ -17,7 +17,8 @@ struct Module device_module = {
     .name = "heltec-wifi-lora-32-v3",
     .start = start,
     .stop = stop,
-    .symbols = nullptr
+    .symbols = nullptr,
+    .internal = nullptr
 };
 
 }

Devices/lilygo-tdeck/Source/module.cpp

@@ -17,7 +17,8 @@ struct Module device_module = {
     .name = "lilygo-tdeck",
     .start = start,
     .stop = stop,
-    .symbols = nullptr
+    .symbols = nullptr,
+    .internal = nullptr
 };
 
 }

Devices/lilygo-tdisplay-s3/Source/module.cpp

@@ -17,7 +17,8 @@ struct Module device_module = {
     .name = "lilygo-tdisplay-s3",
     .start = start,
     .stop = stop,
-    .symbols = nullptr
+    .symbols = nullptr,
+    .internal = nullptr
 };
 
 }

Devices/lilygo-tdisplay/Source/module.cpp

@@ -17,7 +17,8 @@ struct Module device_module = {
     .name = "lilygo-tdisplay",
     .start = start,
     .stop = stop,
-    .symbols = nullptr
+    .symbols = nullptr,
+    .internal = nullptr
 };
 
 }

Devices/lilygo-tdongle-s3/Source/module.cpp

@@ -17,7 +17,8 @@ struct Module device_module = {
     .name = "lilygo-tdongle-s3",
     .start = start,
     .stop = stop,
-    .symbols = nullptr
+    .symbols = nullptr,
+    .internal = nullptr
 };
 
 }

Devices/lilygo-tlora-pager/Source/drivers/TloraPager.cpp

@@ -24,7 +24,7 @@ Driver tlora_pager_driver = {
     .api = nullptr,
     .device_type = nullptr,
     .owner = &device_module,
-    .driver_private = nullptr
+    .internal = nullptr
 };
 
 }

Devices/lilygo-tlora-pager/Source/module.cpp

@@ -25,7 +25,8 @@ struct Module device_module = {
     .name = "lilygo-tlora-pager",
     .start = start,
     .stop = stop,
-    .symbols = nullptr
+    .symbols = nullptr,
+    .internal = nullptr
 };
 
 }

Devices/m5stack-cardputer-adv/Source/module.cpp

@@ -17,7 +17,8 @@ struct Module device_module = {
     .name = "m5stack-cardputer-adv",
     .start = start,
     .stop = stop,
-    .symbols = nullptr
+    .symbols = nullptr,
+    .internal = nullptr
 };
 
 }

Devices/m5stack-cardputer/Source/module.cpp

@@ -17,7 +17,8 @@ struct Module device_module = {
     .name = "m5stack-cardputer",
     .start = start,
     .stop = stop,
-    .symbols = nullptr
+    .symbols = nullptr,
+    .internal = nullptr
 };
 
 }

Devices/m5stack-core2/Source/module.cpp

@@ -17,7 +17,8 @@ struct Module device_module = {
     .name = "m5stack-core2",
     .start = start,
     .stop = stop,
-    .symbols = nullptr
+    .symbols = nullptr,
+    .internal = nullptr
 };
 
 }

Devices/m5stack-cores3/Source/module.cpp

@@ -17,7 +17,8 @@ struct Module device_module = {
     .name = "m5stack-cores3",
     .start = start,
     .stop = stop,
-    .symbols = nullptr
+    .symbols = nullptr,
+    .internal = nullptr
 };
 
 }

Devices/m5stack-cores3/m5stack,cores3.dts

@@ -55,8 +55,8 @@
 		scl-pullup;
 	};
 
-	// TODO: Enable speaker via I2C: https://github.com/m5stack/M5Unified/blob/a6256725481f1bc366655fa48cf03b6095e30ad1/src/M5Unified.cpp#L417
-	// TODO: Enable microphone via I2C: https://github.com/m5stack/M5Unified/blob/a6256725481f1bc366655fa48cf03b6095e30ad1/src/M5Unified.cpp#L616
+	// TODO: Enable speaker via ES7210 I2C: https://github.com/m5stack/M5Unified/blob/a6256725481f1bc366655fa48cf03b6095e30ad1/src/M5Unified.cpp#L417
+	// TODO: Enable microphone via ES7210 I2C: https://github.com/m5stack/M5Unified/blob/a6256725481f1bc366655fa48cf03b6095e30ad1/src/M5Unified.cpp#L616
 	i2s0 {
 		// Note: M5Unified sets the following for speaker: magnification = 2, oversampling = 1
 		// Note: M5Unified sets the following for microphone: magnification = 4

Devices/m5stack-papers3/Source/module.cpp

@@ -17,7 +17,8 @@ struct Module device_module = {
     .name = "m5stack-papers3",
     .start = start,
     .stop = stop,
-    .symbols = nullptr
+    .symbols = nullptr,
+    .internal = nullptr
 };
 
 }

Devices/m5stack-stickc-plus/Source/module.cpp

@@ -17,7 +17,8 @@ struct Module device_module = {
     .name = "m5stack-stickc-plus",
     .start = start,
     .stop = stop,
-    .symbols = nullptr
+    .symbols = nullptr,
+    .internal = nullptr
 };
 
 }

Devices/m5stack-stickc-plus2/Source/module.cpp

@@ -17,7 +17,8 @@ struct Module device_module = {
     .name = "m5stack-stickc-plus2",
     .start = start,
     .stop = stop,
-    .symbols = nullptr
+    .symbols = nullptr,
+    .internal = nullptr
 };
 
 }

Devices/m5stack-tab5/Source/module.cpp

@@ -17,7 +17,8 @@ struct Module device_module = {
     .name = "m5stack-tab5",
     .start = start,
     .stop = stop,
-    .symbols = nullptr
+    .symbols = nullptr,
+    .internal = nullptr
 };
 
 }

Devices/simulator/Source/module.cpp

@@ -17,7 +17,8 @@ struct Module device_module = {
     .name = "simulator",
     .start = start,
     .stop = stop,
-    .symbols = nullptr
+    .symbols = nullptr,
+    .internal = nullptr
 };
 
 }

Devices/unphone/Source/module.cpp

@@ -17,7 +17,8 @@ struct Module device_module = {
     .name = "unphone",
     .start = start,
     .stop = stop,
-    .symbols = nullptr
+    .symbols = nullptr,
+    .internal = nullptr
 };
 
 }

Devices/waveshare-esp32-s3-geek/Source/module.cpp

@@ -17,7 +17,8 @@ struct Module device_module = {
     .name = "waveshare-esp32-s3-geek",
     .start = start,
     .stop = stop,
-    .symbols = nullptr
+    .symbols = nullptr,
+    .internal = nullptr
 };
 
 }

Devices/waveshare-s3-lcd-13/Source/module.cpp

@@ -17,7 +17,8 @@ struct Module device_module = {
     .name = "waveshare-s3-lcd-13",
     .start = start,
     .stop = stop,
-    .symbols = nullptr
+    .symbols = nullptr,
+    .internal = nullptr
 };
 
 }

Devices/waveshare-s3-touch-lcd-128/Source/module.cpp

@@ -17,7 +17,8 @@ struct Module device_module = {
     .name = "waveshare-s3-touch-lcd-128",
     .start = start,
     .stop = stop,
-    .symbols = nullptr
+    .symbols = nullptr,
+    .internal = nullptr
 };
 
 }

Devices/waveshare-s3-touch-lcd-147/Source/module.cpp

@@ -17,7 +17,8 @@ struct Module device_module = {
     .name = "waveshare-s3-touch-lcd-147",
     .start = start,
     .stop = stop,
-    .symbols = nullptr
+    .symbols = nullptr,
+    .internal = nullptr
 };
 
 }

Devices/waveshare-s3-touch-lcd-43/Source/module.cpp

@@ -17,7 +17,8 @@ struct Module device_module = {
     .name = "waveshare-s3-touch-lcd-43",
     .start = start,
     .stop = stop,
-    .symbols = nullptr
+    .symbols = nullptr,
+    .internal = nullptr
 };
 
 }

Devices/wireless-tag-wt32-sc01-plus/Source/module.cpp

@@ -17,7 +17,8 @@ struct Module device_module = {
     .name = "wireless-tag-wt32-sc01-plus",
     .start = start,
     .stop = stop,
-    .symbols = nullptr
+    .symbols = nullptr,
+    .internal = nullptr
 };
 
 }

Modules/hal-device-module/Source/drivers/hal_device.cpp

@@ -14,7 +14,7 @@ struct HalDevicePrivate {
     std::shared_ptr<tt::hal::Device> halDevice;
 };
 
-#define GET_DATA(device) ((struct HalDevicePrivate*)device->internal.driver_data)
+#define GET_DATA(device) ((HalDevicePrivate*)device_get_driver_data(device))
 
 static enum HalDeviceType getHalDeviceType(tt::hal::Device::Type type) {
     switch (type) {
@@ -94,7 +94,9 @@ void hal_device_set_device(::Device* kernelDevice, std::shared_ptr<Device> halDe
 
 static error_t start(Device* device) {
     LOG_I(TAG, "start %s", device->name);
-    device->internal.driver_data = new HalDevicePrivate();
+    auto hal_device_data = new(std::nothrow) HalDevicePrivate();
+    if (hal_device_data == nullptr) return ERROR_OUT_OF_MEMORY;
+    device_set_driver_data(device, hal_device_data);
     return ERROR_NONE;
 }
 
@@ -120,7 +122,7 @@ Driver hal_device_driver = {
     .api = nullptr,
     .device_type = &HAL_DEVICE_TYPE,
     .owner = &hal_device_module,
-    .driver_private = nullptr
+    .internal = nullptr
 };
 
 }

Modules/hal-device-module/Source/module.cpp

@@ -25,7 +25,8 @@ struct Module hal_device_module = {
     .name = "hal-device",
     .start = start,
     .stop = stop,
-    .symbols = nullptr
+    .symbols = nullptr,
+    .internal = nullptr
 };
 
 }

Modules/lvgl-module/Source/module.c

@@ -64,5 +64,6 @@ struct Module lvgl_module = {
     .name = "lvgl",
     .start = start,
     .stop = stop,
-    .symbols = (const struct ModuleSymbol*)lvgl_module_symbols
+    .symbols = (const struct ModuleSymbol*)lvgl_module_symbols,
+    .internal = NULL
 };

Platforms/PlatformEsp32/Source/drivers/esp32_gpio.cpp

@@ -123,7 +123,7 @@ Driver esp32_gpio_driver = {
     .api =  (void*)&esp32_gpio_api,
     .device_type = &GPIO_CONTROLLER_TYPE,
     .owner = &platform_module,
-    .driver_private = nullptr
+    .internal = nullptr
 };
 
 } // extern "C"

Platforms/PlatformEsp32/Source/drivers/esp32_i2c.cpp

@@ -25,7 +25,7 @@ struct InternalData {
 };
 
 #define GET_CONFIG(device) ((Esp32I2cConfig*)device->config)
-#define GET_DATA(device) ((InternalData*)device->internal.driver_data)
+#define GET_DATA(device) ((InternalData*)device_get_driver_data(device))
 
 #define lock(data) mutex_lock(&data->mutex);
 #define unlock(data) mutex_unlock(&data->mutex);
@@ -216,7 +216,7 @@ Driver esp32_i2c_driver = {
     .api = (void*)&esp32_i2c_api,
     .device_type = &I2C_CONTROLLER_TYPE,
     .owner = &platform_module,
-    .driver_private = nullptr
+    .internal = nullptr
 };
 
 } // extern "C"

Platforms/PlatformEsp32/Source/drivers/esp32_i2s.cpp

@@ -31,7 +31,7 @@ struct InternalData {
 };
 
 #define GET_CONFIG(device) ((Esp32I2sConfig*)device->config)
-#define GET_DATA(device) ((InternalData*)device->internal.driver_data)
+#define GET_DATA(device) ((InternalData*)device_get_driver_data(device))
 
 #define lock(data) mutex_lock(&data->mutex);
 #define unlock(data) mutex_unlock(&data->mutex);
@@ -236,7 +236,7 @@ Driver esp32_i2s_driver = {
     .api = (void*)&esp32_i2s_api,
     .device_type = &I2S_CONTROLLER_TYPE,
     .owner = &platform_module,
-    .driver_private = nullptr
+    .internal = nullptr
 };
 
 } // extern "C"

Platforms/PlatformEsp32/Source/module.cpp

@@ -31,7 +31,8 @@ struct Module platform_module = {
     .name = "platform-esp32",
     .start = start,
     .stop = stop,
-    .symbols = nullptr
+    .symbols = nullptr,
+    .internal = nullptr
 };
 
 }

Platforms/PlatformPosix/Source/module.cpp

@@ -18,7 +18,8 @@ struct Module platform_module = {
     .name = "platform-posix",
     .start = start,
     .stop = stop,
-    .symbols = nullptr
+    .symbols = nullptr,
+    .internal = nullptr
 };
 
 }

TactilityKernel/Include/tactility/concurrent/mutex.h

@@ -18,12 +18,10 @@ struct Mutex {
 };
 
 inline static void mutex_construct(struct Mutex* mutex) {
-    assert(mutex->handle == NULL);
     mutex->handle = xSemaphoreCreateMutex();
 }
 
 inline static void mutex_destruct(struct Mutex* mutex) {
-    assert(mutex->handle != NULL);
     vPortAssertIfInISR();
     vSemaphoreDelete(mutex->handle);
     mutex->handle = NULL;

TactilityKernel/Include/tactility/device.h

@@ -16,39 +16,30 @@ extern "C" {
 #endif
 
 struct Driver;
-struct DevicePrivate;
+struct DeviceInternal;
 
 /** Enables discovering devices of the same type */
 struct DeviceType {
-    /* Placeholder because empty structs have a different size with C vs C++ compilers */
-    uint8_t _;
+    const char* name;
 };
 
 /** Represents a piece of hardware */
 struct Device {
     /** The name of the device. Valid characters: a-z a-Z 0-9 - _ . */
     const char* name;
+
     /** The configuration data for the device's driver */
     const void* config;
+
     /** The parent device that this device belongs to. Can be NULL, but only the root device should have a NULL parent. */
     struct Device* parent;
-    /** Internal data */
-    struct {
-        /** Address of the API exposed by the device instance. */
-        struct Driver* driver;
-        /** The driver data for this device (e.g. a mutex) */
-        void* driver_data;
-        /** The mutex for device operations */
-        struct Mutex mutex;
-        /** The device state */
-        struct {
-            int start_result;
-            bool started : 1;
-            bool added : 1;
-        } state;
-        /** Private data */
-        struct DevicePrivate* device_private;
-    } internal;
+
+    /**
+     * Internal state managed by the kernel.
+     * Device implementers should initialize this to NULL.
+     * Do not access or modify directly; use device_* functions.
+     */
+    struct DeviceInternal* internal;
 };
 
 /**

TactilityKernel/Include/tactility/driver.h

@@ -12,7 +12,7 @@ extern "C" {
 struct Device;
 struct DeviceType;
 struct Module;
-struct DriverPrivate;
+struct DriverInternal;
 
 struct Driver {
     /** The driver name */
@@ -29,8 +29,12 @@ struct Driver {
     const struct DeviceType* device_type;
     /** The module that owns this driver. When it is NULL, the system owns the driver and it cannot be removed from registration. */
     const struct Module* owner;
-    /** Internal data */
-    struct DriverPrivate* driver_private;
+    /**
+     * Internal state managed by the kernel.
+     * Driver implementers should initialize this to NULL.
+     * Do not access or modify directly; use driver_* functions.
+     */
+    struct DriverInternal* internal;
 };
 
 /**

TactilityKernel/Include/tactility/module.h

@@ -25,6 +25,8 @@ struct ModuleSymbol {
     const void* symbol;
 };
 
+struct ModuleInternal;
+
 /**
  * A module is a collection of drivers or other functionality that can be loaded and unloaded at runtime.
  */
@@ -36,7 +38,6 @@ struct Module {
      * Desirable format "platform-esp32", "lilygo-tdeck", etc.
      */
     const char* name;
-
     /**
      * A function to initialize the module.
      * Should never be NULL.
@@ -44,24 +45,24 @@ struct Module {
      * @return ERROR_NONE if successful
      */
     error_t (*start)(void);
-
     /**
      * Deinitializes the module.
      * Should never be NULL.
      * @return ERROR_NONE if successful
      */
     error_t (*stop)(void);
-
     /**
      * A list of symbols exported by the module.
      * Should be terminated by MODULE_SYMBOL_TERMINATOR.
      * Can be a NULL value.
      */
     const struct ModuleSymbol* symbols;
-
-    struct {
-        bool started;
-    } internal;
+    /**
+     * Internal state managed by the kernel.
+     * Module implementers should initialize this to NULL.
+     * Do not access or modify directly; use module_* functions.
+     */
+    struct ModuleInternal* internal;
 };
 
 /**

TactilityKernel/Source/device.cpp

@@ -13,8 +13,21 @@
 
 #define TAG "device"
 
-struct DevicePrivate {
-    std::vector<Device*> children;
+struct DeviceInternal {
+    /** Address of the API exposed by the device instance. */
+    struct Driver* driver = nullptr;
+    /** The driver data for this device (e.g. a mutex) */
+    void* driver_data = nullptr;
+    /** The mutex for device operations */
+    struct Mutex mutex {};
+    /** The device state */
+    struct {
+        int start_result = 0;
+        bool started : 1 = false;
+        bool added : 1 = false;
+    } state;
+    /** Attached child devices */
+    std::vector<Device*> children {};
 };
 
 struct DeviceLedger {
@@ -42,47 +55,55 @@ extern "C" {
 #define ledger_lock() mutex_lock(&ledger.mutex)
 #define ledger_unlock() mutex_unlock(&ledger.mutex)
 
-#define get_device_private(device) static_cast<DevicePrivate*>(device->internal.device_private)
+#define lock_internal(internal) mutex_lock(&internal->mutex)
+#define unlock_internal(internal) mutex_unlock(&internal->mutex)
 
 error_t device_construct(Device* device) {
-    device->internal.device_private = new(std::nothrow) DevicePrivate;
-    if (device->internal.device_private == nullptr) {
+    device->internal = new(std::nothrow) DeviceInternal;
+    if (device->internal == nullptr) {
         return ERROR_OUT_OF_MEMORY;
     }
     LOG_D(TAG, "construct %s", device->name);
-    mutex_construct(&device->internal.mutex);
+    mutex_construct(&device->internal->mutex);
     return ERROR_NONE;
 }
 
 error_t device_destruct(Device* device) {
-    if (device->internal.state.started || device->internal.state.added) {
+    lock_internal(device->internal);
+
+    auto* internal = device->internal;
+
+    if (internal->state.started || internal->state.added) {
+        unlock_internal(device->internal);
         return ERROR_INVALID_STATE;
     }
-    if (!get_device_private(device)->children.empty()) {
+    if (!internal->children.empty()) {
+        unlock_internal(device->internal);
         return ERROR_INVALID_STATE;
     }
     LOG_D(TAG, "destruct %s", device->name);
-    mutex_destruct(&device->internal.mutex);
-    delete get_device_private(device);
-    device->internal.device_private = nullptr;
+
+    device->internal = nullptr;
+    mutex_unlock(&internal->mutex);
+    delete internal;
+
     return ERROR_NONE;
 }
 
 /** Add a child to the list of children */
 static void device_add_child(struct Device* device, struct Device* child) {
     device_lock(device);
-    assert(device->internal.state.added);
-    get_device_private(device)->children.push_back(child);
+    check(device->internal->state.added);
+    device->internal->children.push_back(child);
     device_unlock(device);
 }
 
 /** Remove a child from the list of children */
 static void device_remove_child(struct Device* device, struct Device* child) {
     device_lock(device);
-    auto* parent_data = get_device_private(device);
-    const auto iterator = std::ranges::find(parent_data->children, child);
-    if (iterator != parent_data->children.end()) {
-        parent_data->children.erase(iterator);
+    const auto iterator = std::ranges::find(device->internal->children, child);
+    if (iterator != device->internal->children.end()) {
+        device->internal->children.erase(iterator);
     }
     device_unlock(device);
 }
@@ -91,7 +112,7 @@ error_t device_add(Device* device) {
     LOG_D(TAG, "add %s", device->name);
 
     // Already added
-    if (device->internal.state.started || device->internal.state.added) {
+    if (device->internal->state.started || device->internal->state.added) {
         return ERROR_INVALID_STATE;
     }
 
@@ -106,14 +127,14 @@ error_t device_add(Device* device) {
         device_add_child(parent, device);
     }
 
-    device->internal.state.added = true;
+    device->internal->state.added = true;
     return ERROR_NONE;
 }
 
 error_t device_remove(Device* device) {
     LOG_D(TAG, "remove %s", device->name);
 
-    if (device->internal.state.started || !device->internal.state.added) {
+    if (device->internal->state.started || !device->internal->state.added) {
         return ERROR_INVALID_STATE;
     }
 
@@ -132,7 +153,7 @@ error_t device_remove(Device* device) {
     ledger.devices.erase(iterator);
     ledger_unlock();
 
-    device->internal.state.added = false;
+    device->internal->state.added = false;
     return ERROR_NONE;
 
 failed_ledger_lookup:
@@ -147,41 +168,41 @@ failed_ledger_lookup:
 
 error_t device_start(Device* device) {
     LOG_I(TAG, "start %s", device->name);
-    if (!device->internal.state.added) {
+    if (!device->internal->state.added) {
         return ERROR_INVALID_STATE;
     }
 
-    if (device->internal.driver == nullptr) {
+    if (device->internal->driver == nullptr) {
         return ERROR_INVALID_STATE;
     }
 
     // Already started
-    if (device->internal.state.started) {
+    if (device->internal->state.started) {
         return ERROR_NONE;
     }
 
-    error_t bind_error = driver_bind(device->internal.driver, device);
-    device->internal.state.started = (bind_error == ERROR_NONE);
-    device->internal.state.start_result = bind_error;
+    error_t bind_error = driver_bind(device->internal->driver, device);
+    device->internal->state.started = (bind_error == ERROR_NONE);
+    device->internal->state.start_result = bind_error;
     return bind_error == ERROR_NONE ? ERROR_NONE : ERROR_RESOURCE;
 }
 
 error_t device_stop(struct Device* device) {
     LOG_I(TAG, "stop %s", device->name);
-    if (!device->internal.state.added) {
+    if (!device->internal->state.added) {
         return ERROR_INVALID_STATE;
     }
 
-    if (!device->internal.state.started) {
+    if (!device->internal->state.started) {
         return ERROR_NONE;
     }
 
-    if (driver_unbind(device->internal.driver, device) != ERROR_NONE) {
+    if (driver_unbind(device->internal->driver, device) != ERROR_NONE) {
         return ERROR_RESOURCE;
     }
 
-    device->internal.state.started = false;
-    device->internal.state.start_result = 0;
+    device->internal->state.started = false;
+    device->internal->state.start_result = 0;
     return ERROR_NONE;
 }
 
@@ -236,7 +257,7 @@ on_construct_add_error:
 }
 
 void device_set_parent(Device* device, Device* parent) {
-    assert(!device->internal.state.started);
+    assert(!device->internal->state.started);
     device->parent = parent;
 }
 
@@ -245,43 +266,43 @@ Device* device_get_parent(struct Device* device) {
 }
 
 void device_set_driver(struct Device* device, struct Driver* driver) {
-    device->internal.driver = driver;
+    device->internal->driver = driver;
 }
 
 struct Driver* device_get_driver(struct Device* device) {
-    return device->internal.driver;
+    return device->internal->driver;
 }
 
 bool device_is_ready(const struct Device* device) {
-    return device->internal.state.started;
+    return device->internal->state.started;
 }
 
 void device_set_driver_data(struct Device* device, void* driver_data) {
-    device->internal.driver_data = driver_data;
+    device->internal->driver_data = driver_data;
 }
 
 void* device_get_driver_data(struct Device* device) {
-    return device->internal.driver_data;
+    return device->internal->driver_data;
 }
 
 bool device_is_added(const struct Device* device) {
-    return device->internal.state.added;
+    return device->internal->state.added;
 }
 
 void device_lock(struct Device* device) {
-    mutex_lock(&device->internal.mutex);
+    mutex_lock(&device->internal->mutex);
 }
 
 bool device_try_lock(struct Device* device) {
-    return mutex_try_lock(&device->internal.mutex);
+    return mutex_try_lock(&device->internal->mutex);
 }
 
 void device_unlock(struct Device* device) {
-    mutex_unlock(&device->internal.mutex);
+    mutex_unlock(&device->internal->mutex);
 }
 
 const struct DeviceType* device_get_type(struct Device* device) {
-    return device->internal.driver ? device->internal.driver->device_type : NULL;
+    return device->internal->driver ? device->internal->driver->device_type : NULL;
 }
 
 void device_for_each(void* callback_context, bool(*on_device)(Device* device, void* context)) {
@@ -295,8 +316,7 @@ void device_for_each(void* callback_context, bool(*on_device)(Device* device, vo
 }
 
 void device_for_each_child(Device* device, void* callbackContext, bool(*on_device)(struct Device* device, void* context)) {
-    auto* data = get_device_private(device);
-    for (auto* child_device : data->children) {
+    for (auto* child_device : device->internal->children) {
         if (!on_device(child_device, callbackContext)) {
             break;
         }
@@ -306,7 +326,7 @@ void device_for_each_child(Device* device, void* callbackContext, bool(*on_devic
 void device_for_each_of_type(const DeviceType* type, void* callbackContext, bool(*on_device)(Device* device, void* context)) {
     ledger_lock();
     for (auto* device : ledger.devices) {
-        auto* driver = device->internal.driver;
+        auto* driver = device->internal->driver;
         if (driver != nullptr) {
             if (driver->device_type == type) {
                 if (!on_device(device, callbackContext)) {

TactilityKernel/Source/driver.cpp

@@ -12,23 +12,14 @@
 
 #define TAG "driver"
 
-struct DriverPrivate {
-    Mutex mutex { 0 };
+struct DriverInternal {
     int use_count = 0;
     bool destroying = false;
-
-    DriverPrivate() {
-        mutex_construct(&mutex);
-    }
-
-    ~DriverPrivate() {
-        mutex_destruct(&mutex);
-    }
 };
 
 struct DriverLedger {
     std::vector<Driver*> drivers;
-    Mutex mutex { 0 };
+    Mutex mutex {};
 
     DriverLedger() { mutex_construct(&mutex); }
     ~DriverLedger() { mutex_destruct(&mutex); }
@@ -37,43 +28,32 @@ struct DriverLedger {
     void unlock() { mutex_unlock(&mutex); }
 };
 
-static DriverLedger& get_ledger() {
-    static DriverLedger ledger;
-    return ledger;
-}
-
-#define ledger get_ledger()
-
-#define get_driver_private(driver) static_cast<DriverPrivate*>(driver->driver_private)
-#define driver_lock(driver) mutex_lock(&get_driver_private(driver)->mutex);
-#define driver_unlock(driver) mutex_unlock(&get_driver_private(driver)->mutex);
+static DriverLedger ledger;
 
 extern "C" {
 
 error_t driver_construct(Driver* driver) {
-    driver->driver_private = new(std::nothrow) DriverPrivate;
-    if (driver->driver_private == nullptr) {
+    driver->internal = new(std::nothrow) DriverInternal;
+    if (driver->internal == nullptr) {
         return ERROR_OUT_OF_MEMORY;
     }
     return ERROR_NONE;
 }
 
 error_t driver_destruct(Driver* driver) {
-    driver_lock(driver);
-    // No module means the system owns it and it cannot be destroyed
+    auto* internal = driver->internal;
+
     if (driver->owner == nullptr) {
-        driver_unlock(driver);
         return ERROR_NOT_ALLOWED;
     }
-    if (get_driver_private(driver)->use_count != 0 || get_driver_private(driver)->destroying) {
-        driver_unlock(driver);
+    if (internal->use_count != 0 || internal->destroying) {
         return ERROR_INVALID_STATE;
     }
-    get_driver_private(driver)->destroying = true;
+    internal->destroying = true;
 
-    driver_unlock(driver);
-    delete get_driver_private(driver);
-    driver->driver_private = nullptr;
+    // Nullify internal reference before deletion to prevent use-after-free
+    driver->internal = nullptr;
+    delete internal;
 
     return ERROR_NONE;
 }
@@ -143,10 +123,8 @@ Driver* driver_find_compatible(const char* compatible) {
 }
 
 error_t driver_bind(Driver* driver, Device* device) {
-    driver_lock(driver);
-
     error_t error = ERROR_NONE;
-    if (get_driver_private(driver)->destroying || !device_is_added(device)) {
+    if (driver->internal->destroying || !device_is_added(device)) {
         error = ERROR_INVALID_STATE;
         goto error;
     }
@@ -158,23 +136,18 @@ error_t driver_bind(Driver* driver, Device* device) {
         }
     }
 
-    get_driver_private(driver)->use_count++;
-    driver_unlock(driver);
+    driver->internal->use_count++;
 
     LOG_I(TAG, "bound %s to %s", driver->name, device->name);
     return ERROR_NONE;
 
 error:
-
-    driver_unlock(driver);
     return error;
 }
 
 error_t driver_unbind(Driver* driver, Device* device) {
-    driver_lock(driver);
-
     error_t error = ERROR_NONE;
-    if (get_driver_private(driver)->destroying || !device_is_added(device)) {
+    if (driver->internal->destroying || !device_is_added(device)) {
         error = ERROR_INVALID_STATE;
         goto error;
     }
@@ -186,16 +159,13 @@ error_t driver_unbind(Driver* driver, Device* device) {
         }
     }
 
-    get_driver_private(driver)->use_count--;
-    driver_unlock(driver);
+    driver->internal->use_count--;
 
     LOG_I(TAG, "unbound %s from %s", driver->name, device->name);
 
     return ERROR_NONE;
 
 error:
-
-    driver_unlock(driver);
     return error;
 }
 

TactilityKernel/Source/drivers/gpio_controller.cpp

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

TactilityKernel/Source/drivers/i2c_controller.cpp

@@ -49,6 +49,8 @@ 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);
 }
 
-extern const struct DeviceType I2C_CONTROLLER_TYPE { 0 };
+extern const struct DeviceType I2C_CONTROLLER_TYPE {
+    .name = "i2c-controller"
+};
 
 }

TactilityKernel/Source/drivers/i2s_controller.cpp

@@ -32,6 +32,8 @@ error_t i2s_controller_reset(struct Device* device) {
     return I2S_DRIVER_API(driver)->reset(device);
 }
 
-extern const struct DeviceType I2S_CONTROLLER_TYPE { 0 };
+extern const struct DeviceType I2S_CONTROLLER_TYPE {
+    .name = "i2s-controller"
+};
 
 }

TactilityKernel/Source/kernel_init.cpp

@@ -23,7 +23,8 @@ struct Module root_module = {
     .name = "kernel",
     .start = start,
     .stop = stop,
-    .symbols = (const struct ModuleSymbol*)KERNEL_SYMBOLS
+    .symbols = (const struct ModuleSymbol*)KERNEL_SYMBOLS,
+    .internal = nullptr
 };
 
 error_t kernel_init(struct Module* platform_module, struct Module* device_module, struct CompatibleDevice devicetree_devices[]) {

TactilityKernel/Source/module.cpp

@@ -1,14 +1,19 @@
-#include <vector>
-#include <string.h>
+#include <cstring>
 #include <algorithm>
+#include <new>
 #include <tactility/concurrent/mutex.h>
 #include <tactility/module.h>
+#include <vector>
 
 #define TAG "module"
 
+struct ModuleInternal {
+    bool started = false;
+};
+
 struct ModuleLedger {
     std::vector<struct Module*> modules;
-    struct Mutex mutex = { 0 };
+    struct Mutex mutex {};
 
     ModuleLedger() { mutex_construct(&mutex); }
     ~ModuleLedger() { mutex_destruct(&mutex); }
@@ -19,11 +24,14 @@ static ModuleLedger ledger;
 extern "C" {
 
 error_t module_construct(struct Module* module) {
-    module->internal.started = false;
+    module->internal = new (std::nothrow) ModuleInternal();
+    if (module->internal == nullptr) return ERROR_OUT_OF_MEMORY;
     return ERROR_NONE;
 }
 
 error_t module_destruct(struct Module* module) {
+    delete static_cast<ModuleInternal*>(module->internal);
+    module->internal = nullptr;
     return ERROR_NONE;
 }
 
@@ -44,28 +52,30 @@ error_t module_remove(struct Module* module) {
 error_t module_start(struct Module* module) {
     LOG_I(TAG, "start %s", module->name);
 
-    if (module->internal.started) return ERROR_NONE;
+    auto* internal = static_cast<ModuleInternal*>(module->internal);
+    if (internal->started) return ERROR_NONE;
 
     error_t error = module->start();
-    module->internal.started = (error == ERROR_NONE);
+    internal->started = (error == ERROR_NONE);
     return error;
 }
 
 bool module_is_started(struct Module* module) {
-    return module->internal.started;
+    return static_cast<ModuleInternal*>(module->internal)->started;
 }
 
 error_t module_stop(struct Module* module) {
     LOG_I(TAG, "stop %s", module->name);
 
-    if (!module->internal.started) return ERROR_NONE;
+    auto* internal = static_cast<ModuleInternal*>(module->internal);
+    if (!internal->started) return ERROR_NONE;
 
     error_t error = module->stop();
     if (error != ERROR_NONE) {
         return error;
     }
 
-    module->internal.started = false;
+    internal->started = false;
     return error;
 }
 
@@ -106,4 +116,3 @@ bool module_resolve_symbol_global(const char* symbol_name, uintptr_t* symbol_add
 }
 
 }
-

Tests/CMakeLists.txt

@@ -1,6 +1,6 @@
 project(tests)
 
-set(DOCTESTINC ${PROJECT_SOURCE_DIR}/Include)
+set(DOCTESTINC ${PROJECT_SOURCE_DIR}/Doctest/Include)
 
 enable_testing()
 add_subdirectory(TactilityCore)

Tests/Tactility/CMakeLists.txt

@@ -4,16 +4,12 @@ enable_language(C CXX ASM)
 
 set(CMAKE_CXX_COMPILER g++)
 
-file(GLOB_RECURSE TEST_SOURCES ${PROJECT_SOURCE_DIR}/*.cpp)
+file(GLOB_RECURSE TEST_SOURCES ${PROJECT_SOURCE_DIR}/Source/*.cpp)
 add_executable(TactilityTests EXCLUDE_FROM_ALL ${TEST_SOURCES})
 
-target_include_directories(TactilityTests PRIVATE
-    ${DOCTESTINC}
-)
+target_include_directories(TactilityTests PRIVATE ${DOCTESTINC})
 
-add_test(NAME TactilityTests
-    COMMAND TactilityTests
-)
+add_test(NAME TactilityTests COMMAND TactilityTests)
 
 target_link_libraries(TactilityTests PRIVATE
     Tactility

Tests/Tactility/Source/PropertiesFileTest.cpp

@@ -1,7 +1,7 @@
-#include "../TactilityCore/TestFile.h"
-#include "doctest.h"
+#include "../../TactilityCore/Source/TestFile.h"
+#include "../../Tactility/Include/Tactility/file/PropertiesFile.h"
 
-#include <../../Tactility/Include/Tactility/file/PropertiesFile.h>
+#include "doctest.h"
 
 using namespace tt;
 

Tests/TactilityCore/CMakeLists.txt

@@ -4,16 +4,12 @@ enable_language(C CXX ASM)
 
 set(CMAKE_CXX_COMPILER g++)
 
-file(GLOB_RECURSE TEST_SOURCES ${PROJECT_SOURCE_DIR}/*.cpp)
+file(GLOB_RECURSE TEST_SOURCES ${PROJECT_SOURCE_DIR}/Source/*.cpp)
 add_executable(TactilityCoreTests EXCLUDE_FROM_ALL ${TEST_SOURCES})
 
-target_include_directories(TactilityCoreTests PRIVATE
-    ${DOCTESTINC}
-)
+target_include_directories(TactilityCoreTests PRIVATE ${DOCTESTINC})
 
-add_test(NAME TactilityCoreTests
-    COMMAND TactilityCoreTests
-)
+add_test(NAME TactilityCoreTests COMMAND TactilityCoreTests)
 
 target_link_libraries(TactilityCoreTests PUBLIC
     TactilityCore

Tests/TactilityFreeRtos/CMakeLists.txt

@@ -4,16 +4,12 @@ enable_language(C CXX ASM)
 
 set(CMAKE_CXX_COMPILER g++)
 
-file(GLOB_RECURSE TEST_SOURCES ${PROJECT_SOURCE_DIR}/*.cpp)
+file(GLOB_RECURSE TEST_SOURCES ${PROJECT_SOURCE_DIR}/Source/*.cpp)
 add_executable(TactilityFreeRtosTests EXCLUDE_FROM_ALL ${TEST_SOURCES})
 
-target_include_directories(TactilityFreeRtosTests PRIVATE
-    ${DOCTESTINC}
-)
+target_include_directories(TactilityFreeRtosTests PRIVATE ${DOCTESTINC})
 
-add_test(NAME TactilityFreeRtosTests
-    COMMAND TactilityFreeRtosTests
-)
+add_test(NAME TactilityFreeRtosTests COMMAND TactilityFreeRtosTests)
 
 target_link_libraries(TactilityFreeRtosTests PUBLIC
     TactilityFreeRtos

Tests/TactilityKernel/CMakeLists.txt

@@ -4,7 +4,7 @@ enable_language(C CXX ASM)
 
 set(CMAKE_CXX_COMPILER g++)
 
-file(GLOB_RECURSE TEST_SOURCES ${PROJECT_SOURCE_DIR}/*.cpp)
+file(GLOB_RECURSE TEST_SOURCES ${PROJECT_SOURCE_DIR}/Source/*.cpp)
 add_executable(TactilityKernelTests EXCLUDE_FROM_ALL ${TEST_SOURCES})
 
 target_include_directories(TactilityKernelTests PRIVATE ${DOCTESTINC})

Tests/TactilityKernel/Source/DeviceTest.cpp

@@ -12,30 +12,26 @@ static Module module = {
     .stop = nullptr
 };
 
-TEST_CASE("device_construct and device_destruct should set and unset the correct fields") {
+TEST_CASE("device_construct and device_destruct should set and unset the internal field") {
     Device device = { 0 };
 
     error_t error = device_construct(&device);
     CHECK_EQ(error, ERROR_NONE);
 
-    CHECK_NE(device.internal.device_private, nullptr);
-    CHECK_NE(device.internal.mutex.handle, nullptr);
+    CHECK_NE(device.internal, nullptr);
 
     CHECK_EQ(device_destruct(&device), ERROR_NONE);
 
-    CHECK_EQ(device.internal.device_private, nullptr);
-    CHECK_EQ(device.internal.mutex.handle, nullptr);
-
-    Device comparison_device = { 0 };
-    comparison_device.internal.device_private = device.internal.device_private;
-    comparison_device.internal.mutex.handle = device.internal.mutex.handle;
-
-    // Check that no other data was set
-    CHECK_EQ(memcmp(&device, &comparison_device, sizeof(Device)), 0);
+    CHECK_EQ(device.internal, nullptr);
 }
 
 TEST_CASE("device_add should add the device to the list of all devices") {
-    Device device = { 0 };
+    Device device = {
+        .name = "device",
+        .config = nullptr,
+        .parent = nullptr,
+        .internal = nullptr
+    };
     CHECK_EQ(device_construct(&device), ERROR_NONE);
     CHECK_EQ(device_add(&device), ERROR_NONE);
 
@@ -55,12 +51,18 @@ TEST_CASE("device_add should add the device to the list of all devices") {
 }
 
 TEST_CASE("device_add should add the device to its parent") {
-    Device parent = { 0 };
+    Device parent = {
+        .name = "parent",
+        .config = nullptr,
+        .parent = nullptr,
+        .internal = nullptr
+    };
 
     Device child = {
-        .name = nullptr,
+        .name = "child",
         .config = nullptr,
-        .parent = &parent
+        .parent = &parent,
+        .internal = nullptr
     };
 
     CHECK_EQ(device_construct(&parent), ERROR_NONE);
@@ -88,19 +90,31 @@ TEST_CASE("device_add should add the device to its parent") {
 }
 
 TEST_CASE("device_add should set the state to 'added'") {
-    Device device = { 0 };
+    Device device = {
+        .name = "device",
+        .config = nullptr,
+        .parent = nullptr,
+        .internal = nullptr
+    };
+
     CHECK_EQ(device_construct(&device), ERROR_NONE);
 
-    CHECK_EQ(device.internal.state.added, false);
+    CHECK_EQ(device_is_added(&device), false);
     CHECK_EQ(device_add(&device), ERROR_NONE);
-    CHECK_EQ(device.internal.state.added, true);
+    CHECK_EQ(device_is_added(&device), true);
 
     CHECK_EQ(device_remove(&device), ERROR_NONE);
     CHECK_EQ(device_destruct(&device), ERROR_NONE);
 }
 
 TEST_CASE("device_remove should remove it from the list of all devices") {
-    Device device = { 0 };
+    Device device = {
+        .name = "device",
+        .config = nullptr,
+        .parent = nullptr,
+        .internal = nullptr
+    };
+
     CHECK_EQ(device_construct(&device), ERROR_NONE);
     CHECK_EQ(device_add(&device), ERROR_NONE);
     CHECK_EQ(device_remove(&device), ERROR_NONE);
@@ -119,12 +133,18 @@ TEST_CASE("device_remove should remove it from the list of all devices") {
 }
 
 TEST_CASE("device_remove should remove the device from its parent") {
-    Device parent = { 0 };
+    Device parent = {
+        .name = "parent",
+        .config = nullptr,
+        .parent = nullptr,
+        .internal = nullptr
+    };
 
     Device child = {
-        .name = nullptr,
+        .name = "child",
         .config = nullptr,
-        .parent = &parent
+        .parent = &parent,
+        .internal = nullptr
     };
 
     CHECK_EQ(device_construct(&parent), ERROR_NONE);
@@ -151,13 +171,19 @@ TEST_CASE("device_remove should remove the device from its parent") {
 }
 
 TEST_CASE("device_remove should clear the state 'added'") {
-    Device device = { 0 };
+    Device device = {
+        .name = "device",
+        .config = nullptr,
+        .parent = nullptr,
+        .internal = nullptr
+    };
+
     CHECK_EQ(device_construct(&device), ERROR_NONE);
 
     CHECK_EQ(device_add(&device), ERROR_NONE);
-    CHECK_EQ(device.internal.state.added, true);
+    CHECK_EQ(device_is_added(&device), true);
     CHECK_EQ(device_remove(&device), ERROR_NONE);
-    CHECK_EQ(device.internal.state.added, false);
+    CHECK_EQ(device_is_added(&device), false);
 
     CHECK_EQ(device_destruct(&device), ERROR_NONE);
 }
@@ -172,7 +198,7 @@ TEST_CASE("device_is_ready should return true only when it is started") {
         .api = nullptr,
         .device_type = nullptr,
         .owner = &module,
-        .driver_private = nullptr
+        .internal = nullptr
     };
 
     Device device = { 0 };
@@ -180,17 +206,17 @@ TEST_CASE("device_is_ready should return true only when it is started") {
     CHECK_EQ(driver_construct_add(&driver), ERROR_NONE);
     CHECK_EQ(device_construct(&device), ERROR_NONE);
 
-    CHECK_EQ(device.internal.state.started, false);
+    CHECK_EQ(device_is_ready(&device), false);
     device_set_driver(&device, &driver);
-    CHECK_EQ(device.internal.state.started, false);
+    CHECK_EQ(device_is_ready(&device), false);
     CHECK_EQ(device_add(&device), ERROR_NONE);
-    CHECK_EQ(device.internal.state.started, false);
+    CHECK_EQ(device_is_ready(&device), false);
     CHECK_EQ(device_start(&device), ERROR_NONE);
-    CHECK_EQ(device.internal.state.started, true);
+    CHECK_EQ(device_is_ready(&device), true);
     CHECK_EQ(device_stop(&device), ERROR_NONE);
-    CHECK_EQ(device.internal.state.started, false);
+    CHECK_EQ(device_is_ready(&device), false);
     CHECK_EQ(device_remove(&device), ERROR_NONE);
-    CHECK_EQ(device.internal.state.started, false);
+    CHECK_EQ(device_is_ready(&device), false);
 
     CHECK_EQ(device_destruct(&device), ERROR_NONE);
     CHECK_EQ(driver_remove_destruct(&driver), ERROR_NONE);

Tests/TactilityKernel/Source/DriverIntegrationTest.cpp

@@ -38,7 +38,7 @@ static Driver integration_driver = {
     .api = nullptr,
     .device_type = nullptr,
     .owner = &module,
-    .driver_private = nullptr,
+    .internal = nullptr,
 };
 
 TEST_CASE("driver with with start success and stop success should start and stop a device") {

Tests/TactilityKernel/Source/DriverTest.cpp

@@ -15,10 +15,10 @@ TEST_CASE("driver_construct and driver_destruct should set and unset the correct
 
     CHECK_EQ(driver_construct(&driver), ERROR_NONE);
     CHECK_EQ(driver_add(&driver), ERROR_NONE);
-    CHECK_NE(driver.driver_private, nullptr);
+    CHECK_NE(driver.internal, nullptr);
     CHECK_EQ(driver_remove(&driver), ERROR_NONE);
     CHECK_EQ(driver_destruct(&driver), ERROR_NONE);
-    CHECK_EQ(driver.driver_private, nullptr);
+    CHECK_EQ(driver.internal, nullptr);
 }
 
 TEST_CASE("a driver without a module should not be destructible") {
@@ -40,7 +40,7 @@ TEST_CASE("driver_is_compatible should return true if a compatible value is foun
         .api = nullptr,
         .device_type = nullptr,
         .owner = &module,
-        .driver_private = nullptr
+        .internal = nullptr
     };
     CHECK_EQ(driver_is_compatible(&driver, "test_compatible"), true);
     CHECK_EQ(driver_is_compatible(&driver, "nope"), false);
@@ -57,7 +57,7 @@ TEST_CASE("driver_find should only find a compatible driver when the driver was
         .api = nullptr,
         .device_type = nullptr,
         .owner = &module,
-        .driver_private = nullptr
+        .internal = nullptr
     };
 
     Driver* found_driver = driver_find_compatible("test_compatible");

Tests/TactilityKernel/Source/ModuleTest.cpp

@@ -23,12 +23,12 @@ TEST_CASE("Module construction and destruction") {
         .start = test_start,
         .stop = test_stop,
         .symbols = nullptr,
-        .internal = {.started = false}
+        .internal = nullptr
     };
 
     // Test successful construction
     CHECK_EQ(module_construct(&module), ERROR_NONE);
-    CHECK_EQ(module.internal.started, false);
+    CHECK_EQ(module_is_started(&module), false);
 
     // Test successful destruction
     CHECK_EQ(module_destruct(&module), ERROR_NONE);
@@ -40,7 +40,7 @@ TEST_CASE("Module registration") {
         .start = test_start,
         .stop = test_stop,
         .symbols = nullptr,
-        .internal = {.started = false}
+        .internal = nullptr
     };
 
     // module_add should succeed
@@ -61,9 +61,11 @@ TEST_CASE("Module lifecycle") {
         .start = test_start,
         .stop = test_stop,
         .symbols = nullptr,
-        .internal = {.started = false}
+        .internal = nullptr
     };
 
+    CHECK_EQ(module_construct(&module), ERROR_NONE);
+
     // 1. Successful start (no parent required anymore)
     CHECK_EQ(module_start(&module), ERROR_NONE);
     CHECK_EQ(module_is_started(&module), true);
@@ -104,6 +106,8 @@ TEST_CASE("Module lifecycle") {
     // Clean up: fix stop result so we can stop it
     test_stop_result = ERROR_NONE;
     CHECK_EQ(module_stop(&module), ERROR_NONE);
+
+    CHECK_EQ(module_destruct(&module), ERROR_NONE);
 }
 
 TEST_CASE("Global symbol resolution") {
@@ -117,9 +121,11 @@ TEST_CASE("Global symbol resolution") {
         .start = test_start,
         .stop = test_stop,
         .symbols = test_symbols,
-        .internal = {.started = false}
+        .internal = nullptr
     };
 
+    REQUIRE_EQ(module_construct(&module), ERROR_NONE);
+
     uintptr_t addr;
     // Should fail as it is not added or started
     CHECK_EQ(module_resolve_symbol_global("symbol_test_function", &addr), false);
@@ -128,8 +134,8 @@ TEST_CASE("Global symbol resolution") {
     REQUIRE_EQ(module_start(&module), ERROR_NONE);
     // Still fails as symbols are null
     CHECK_EQ(module_resolve_symbol_global("symbol_test_function", &addr), true);
-
     // Cleanup
     CHECK_EQ(module_remove(&module), ERROR_NONE);
+
     CHECK_EQ(module_destruct(&module), ERROR_NONE);
 }