mirror of
https://github.com/espressif/esp-idf.git
synced 2025-09-10 17:01:07 +00:00
cb4d90186f
Introduce a new HAL API `usb_dwc_hal_set_fifo_config()` that allows advanced users to manually configure RX, Non-Periodic TX, and Periodic TX FIFO sizes. This offers fine-grained control beyond the previous bias-based sizing approach. The HAL function no longer returns `esp_err_t`, and internal validations are enforced via `HAL_ASSERT()`. Responsibility for input validation has been moved to the HCD layer. FIFO configuration must be applied before any USB pipes are created or activated. This feature is intended for use during `usb_host_install()`. If no custom FIFO configuration is provided (i.e., all values are zero), the driver falls back to a bias-based default layout based on Kconfig settings (`CONFIG_USB_HOST_HW_BUFFER_BIAS_*`). Bias resolution is done inside `hcd_port_init()`. The `port_obj_t` structure has been extended with a `fifo_config` field, which stores the configuration to allow re-application after a USB port reset. Obsolete FIFO bias enums (`usb_hal_fifo_bias_t`, `hcd_port_fifo_bias_t`) and related APIs (`hcd_port_set_fifo_bias()`) have been removed in favor of the new structure-based mechanism. The HCD initialization and port reset flow has been updated to use the explicit FIFO configuration. USB Host maintainer documentation (`maintainers.md`) has been updated accordingly. Test cases were updated to remove the usage of removed bias API and now rely on default or custom FIFO configuration.
| Supported Targets | Linux |
|---|
Description
This directory contains test code for USB Host layer of USB Host stack. Namely:
- USB Host public API calls to install and uninstall the USB Host driver with partially mocked USB Host stack to test Linux build and Cmock run for this partial Mock
- Mocked are all layers of the USB Host stack below the USB Host layer, which is used as a real component
Tests are written using Catch2 test framework, use CMock, so you must install Ruby on your machine to run them.
This test directory uses freertos as real component
Build
Tests build regularly like an idf project. Currently only working on Linux machines.
idf.py --preview set-target linux
idf.py build
Run
The build produces an executable in the build folder.
Just run:
idf.py monitor
or run the executable directly:
./build/host_test_usb_host_layer.elf