refactor(esp_tinyusb): runtime_config test applicaton, multitask access test

roma-jam · roma-jam · commit c0e3d669d8ac · 2025-11-17T12:06:46.000+01:00
- Fixed concurrent access to the nb_of_success var from several tasks
- Changed the logic of getting notification from the worker thread to sem_done
- Added the test case for uninstall the tinyusb driver via several tasks
- Added README.md
diff --git a/device/esp_tinyusb/test_apps/runtime_config/README.md b/device/esp_tinyusb/test_apps/runtime_config/README.md
@@ -0,0 +1,42 @@
+| Supported Targets | ESP32-H4 | ESP32-P4 | ESP32-S2 | ESP32-S3 |
+| ----------------- | -------- | -------- | -------- | -------- |
+
+# Espressif's Additions to TinyUSB - Runtime Configuration Test Application
+
+This directory contains Unity tests that validate Espressif-specific integration of TinyUSB.
+
+The tests focus on:
+
+- TinyUSB configuration helpers (default macros, per-port config).
+- USB Device descriptors (FS/HS, string descriptors, edge cases).
+- USB peripheral / PHY configuration for full-speed and high-speed.
+- TinyUSB task configuration (CPU pinning, invalid parameters).
+- Multitask access to the TinyUSB driver (concurrent installs).
+
+The test prints a numbered menu, for example:
+
+```
+(1) "Config: Default macros arguments" [runtime_config][default]
+(2) "Config: Full-speed (High-speed)" [runtime_config][full_speed]
+...
+```
+
+You can run all tests by running `pytest` or select individual ones by name and number.
+
+## Tags
+
+Each test is tagged with categories and modes:
+
+### Categories
+
+- [runtime_config] – Tests focusing on `tinyusb_config_t` and runtime configuration.
+- [periph] – Tests that directly exercise the USB peripheral (USB OTG 1.1 or USB OTG 2.0).
+- [task] – Tests related to the dedicated TinyUSB task configuration.
+
+### Speed / Mode
+
+- [default] – Generic, target-agnostic.
+- [full_speed] – Tests specific to USB OTG 1.1 / Full-speed port.
+- [high_speed] – Tests specific to USB OTG 2.0 / High-speed port.
+
+These tags can be used by test runners / CI to select or filter tests.
diff --git a/device/esp_tinyusb/test_apps/runtime_config/main/test_multitask_access.c b/device/esp_tinyusb/test_apps/runtime_config/main/test_multitask_access.c
@@ -29,28 +29,74 @@
 
 #define MULTIPLE_THREADS_TASKS_NUM 5
 
-static int nb_of_success = 0;
+static SemaphoreHandle_t sem_done = NULL;
+TaskHandle_t test_task_handles[MULTIPLE_THREADS_TASKS_NUM];
+
+// Unlocked spinlock, ready to use
+static portMUX_TYPE _spinlock = portMUX_INITIALIZER_UNLOCKED;
+static volatile int nb_of_success = 0;
 
 static void test_task_install(void *arg)
 {
-    TaskHandle_t parent_task_handle = (TaskHandle_t)arg;
-
+    (void) arg;
     // Install TinyUSB driver
     tinyusb_config_t tusb_cfg = TINYUSB_DEFAULT_CONFIG(test_device_event_handler);
     tusb_cfg.phy.skip_setup = true; // Skip phy setup to allow multiple tasks to install the driver
 
+    // Wait to be started by main thread
+    ulTaskNotifyTake(pdTRUE, portMAX_DELAY);
+
     if (tinyusb_driver_install(&tusb_cfg) == ESP_OK) {
         test_device_wait();
         TEST_ASSERT_EQUAL(ESP_OK, tinyusb_driver_uninstall());
+        taskENTER_CRITICAL(&_spinlock);
+        nb_of_success++;
+        taskEXIT_CRITICAL(&_spinlock);
+    }
+
+    // Notify the parent task that the task completed the job
+    xSemaphoreGive(sem_done);
+    // Delete task
+    vTaskDelete(NULL);
+}
+
+
+static void test_task_uninstall(void *arg)
+{
+    // Wait to be started by main thread
+    ulTaskNotifyTake(pdTRUE, portMAX_DELAY);
+
+    if (tinyusb_driver_uninstall() == ESP_OK) {
+        taskENTER_CRITICAL(&_spinlock);
         nb_of_success++;
+        taskEXIT_CRITICAL(&_spinlock);
     }
 
     // Notify the parent task that the task completed the job
-    xTaskNotifyGive(parent_task_handle);
+    xSemaphoreGive(sem_done);
     // Delete task
     vTaskDelete(NULL);
 }
 
+// USB PHY
+
+static usb_phy_handle_t test_init_phy(void)
+{
+    usb_phy_handle_t phy_hdl = NULL;
+    usb_phy_config_t phy_conf = {
+        .controller = USB_PHY_CTRL_OTG,
+        .target = USB_PHY_TARGET_INT,
+        .otg_mode = USB_OTG_MODE_DEVICE,
+    };
+    TEST_ASSERT_EQUAL_MESSAGE(ESP_OK, usb_new_phy(&phy_conf, &phy_hdl), "Unable to install USB PHY ");
+    return phy_hdl;
+}
+
+static void test_deinit_phy(usb_phy_handle_t phy_hdl)
+{
+    TEST_ASSERT_EQUAL_MESSAGE(ESP_OK, usb_del_phy(phy_hdl), "Unable to delete USB PHY ");
+}
+
 // ============================= Tests =========================================
 
 /**
@@ -61,34 +107,82 @@ static void test_task_install(void *arg)
  */
 TEST_CASE("Multitask: Install", "[runtime_config][full_speed][high_speed]")
 {
-    usb_phy_handle_t phy_hdl = NULL;
-    // Install the PHY externally
-    usb_phy_config_t phy_conf = {
-        .controller = USB_PHY_CTRL_OTG,
-        .target = USB_PHY_TARGET_INT,
-        .otg_mode = USB_OTG_MODE_DEVICE,
-    };
-    TEST_ASSERT_EQUAL_MESSAGE(ESP_OK, usb_new_phy(&phy_conf, &phy_hdl), "Unable to install USB PHY ");
+    usb_phy_handle_t phy_hdl = test_init_phy();
+
+    // Create counting semaphore to wait for all tasks to complete
+    sem_done = xSemaphoreCreateCounting(MULTIPLE_THREADS_TASKS_NUM, 0);;
+    TEST_ASSERT_NOT_NULL(sem_done);
 
+    // No task are running yet
     nb_of_success = 0;
+
     // Create tasks that will start the driver
     for (int i = 0; i < MULTIPLE_THREADS_TASKS_NUM; i++) {
-        TEST_ASSERT_EQUAL(pdTRUE, xTaskCreate(test_task_install,
+        TEST_ASSERT_EQUAL(pdPASS, xTaskCreate(test_task_install,
                                               "InstallTask",
                                               4096,
-                                              (void *) xTaskGetCurrentTaskHandle(),
+                                              NULL,
                                               4 + i,
-                                              NULL));
+                                              &test_task_handles[i]));
+    }
+
+    // Start all tasks
+    for (int i = 0; i < MULTIPLE_THREADS_TASKS_NUM; i++) {
+        xTaskNotifyGive(test_task_handles[i]);
+    }
+
+    // Wait for all tasks to complete
+    for (int i = 0; i < MULTIPLE_THREADS_TASKS_NUM; i++) {
+        TEST_ASSERT_EQUAL_MESSAGE(pdTRUE, xSemaphoreTake(sem_done, pdMS_TO_TICKS(5000)), "Not all tasks completed in time");
     }
 
-    // Wait until all tasks are finished
-    vTaskDelay(pdMS_TO_TICKS(5000));
-    // Check if all tasks finished, we should get all notification from the tasks
-    TEST_ASSERT_EQUAL_MESSAGE(MULTIPLE_THREADS_TASKS_NUM, ulTaskNotifyTake(pdTRUE, pdMS_TO_TICKS(5000)), "Not all tasks finished");
     // There should be only one task that was able to install the driver
     TEST_ASSERT_EQUAL_MESSAGE(1, nb_of_success, "Only one task should be able to install the driver");
     // Clean-up
-    TEST_ASSERT_EQUAL_MESSAGE(ESP_OK, usb_del_phy(phy_hdl), "Unable to delete PHY");
+    test_deinit_phy(phy_hdl);
+    vSemaphoreDelete(sem_done);
 }
 
+TEST_CASE("Multitask: Uninstall", "[runtime_config][full_speed][high_speed]")
+{
+    usb_phy_handle_t phy_hdl = test_init_phy();
+    // Create counting semaphore to wait for all tasks to complete
+    sem_done = xSemaphoreCreateCounting(MULTIPLE_THREADS_TASKS_NUM, 0);
+    TEST_ASSERT_NOT_NULL(sem_done);
+
+    // No task are running yet
+    nb_of_success = 0;
+
+    // Install the driver once
+    tinyusb_config_t tusb_cfg = TINYUSB_DEFAULT_CONFIG(test_device_event_handler);
+    tusb_cfg.phy.skip_setup = true; // Skip phy setup to allow multiple tasks
+    TEST_ASSERT_EQUAL_MESSAGE(ESP_OK, tinyusb_driver_install(&tusb_cfg), "Unable to install TinyUSB driver ");
+    // Create tasks that will uninstall the driver
+    for (int i = 0; i < MULTIPLE_THREADS_TASKS_NUM; i++) {
+        TEST_ASSERT_EQUAL(pdPASS, xTaskCreate(test_task_uninstall,
+                                              "UninstallTask",
+                                              4096,
+                                              NULL,
+                                              4 + i,
+                                              &test_task_handles[i]));
+    }
+
+    // Start all tasks
+    for (int i = 0; i < MULTIPLE_THREADS_TASKS_NUM; i++) {
+        xTaskNotifyGive(test_task_handles[i]);
+    }
+    // Wait for all tasks to complete
+    for (int i = 0; i < MULTIPLE_THREADS_TASKS_NUM; i++) {
+        TEST_ASSERT_EQUAL_MESSAGE(pdTRUE, xSemaphoreTake(sem_done, pdMS_TO_TICKS(5000)), "Not all tasks completed in time");
+    }
+
+    // There should be only one task that was able to uninstall the driver
+    TEST_ASSERT_EQUAL_MESSAGE(1, nb_of_success, "Only one task should be able to uninstall the driver");
+
+    // Clean-up
+    test_deinit_phy(phy_hdl);
+    vSemaphoreDelete(sem_done);
+}
+
+
 #endif // SOC_USB_OTG_SUPPORTED
