Merge branch 'feat/cdc_host_driver' into 'master'

feat(ioth_cdc): add new component use usb host driver

See merge request ae_group/esp-iot-solution!1117

Author: lijunru-hub

codespell-ignore-list

@@ -18,3 +18,4 @@ uncompressible
 wHeigh
 shoudn't
 definations
+inout

components/usb/iot_usbh_cdc/CHANGELOG.md

@@ -1,5 +1,23 @@
 # ChangeLog
 
+## v1.0.0 - 2024-10-31
+
+### Break Changes:
+
+* Remove the dependency on the `iot_usbh` component and use `usb_host_driver` instead.
+
+### API Break Changes:
+
+* Add `usbh_cdc_create()`
+* Add `usbh_cdc_delete()`
+* Add `usbh_cdc_desc_print()` to print CDC descriptor
+* Rename `usbh_cdc_get_itf_state()` to `usbh_cdc_get_state()`
+* Remove `usbh_cdc_wait_connect()`
+* Remove `usbh_cdc_itf_write_bytes()`
+* Remove `usbh_cdc_get_buffered_data_len()`
+* Remove `usbh_cdc_itf_get_buffered_data_len()`
+* Remove `usbh_cdc_itf_read_bytes()`
+
 ## v0.2.2 - 2023-12-08
 
 * Add doc and example

components/usb/iot_usbh_cdc/CMakeLists.txt

@@ -1,7 +1,8 @@
 idf_component_register(SRC_DIRS "."
-                       INCLUDE_DIRS "include"
-                       REQUIRES iot_usbh
-                       PRIV_REQUIRES esp_ringbuf)
+                       INCLUDE_DIRS "." "include"
+                       PRIV_INCLUDE_DIRS "private_include"
+                       PRIV_REQUIRES esp_ringbuf
+                       REQUIRES usb)
 
 include(package_manager)
 cu_pkg_define_version(${CMAKE_CURRENT_LIST_DIR})

components/usb/iot_usbh_cdc/Kconfig

@@ -1,26 +1,46 @@
 menu "IoT USB Host CDC"
 
-    config CDC_SEND_DTE_ACTIVE
-        bool "Set control line state during init"
-        default n
-    config CDC_BULK_IN_URB_NUM
-        int "cdc bulk in urb number"
-        default 2
+    config USBH_TASK_CORE_ID
+        int "usbh task core_id"
+        default 0
+        range -1 1
         help
-            bulk in urb number, increase to handle heavy traffic
-    config CDC_BULK_OUT_URB_NUM
-        int "cdc bulk out urb number"
-        default 2
+            usb host task to specified core
+
+    config USBH_TASK_BASE_PRIORITY
+        int "usbh task base priority"
+        default 5
         help
-            bulk out urb number, increase to handle heavy traffic
-    config CDC_BULK_IN_URB_BUFFER_SIZE
-        int "cdc bulk in urb buffer size"
+            usb task base priority
+
+    config IN_TRANSFER_BUFFER_SIZE
+        int "usbh IN transfer buffer size"
         default 512
         help
-            buffer size of each bulk in urb, should be multiple of endpoint mps
-    config CDC_BULK_OUT_URB_BUFFER_SIZE
-        int "cdc bulk out urb buffer size"
+            usb host IN transfer buffer size
+
+    config OUT_TRANSFER_BUFFER_SIZE
+        int "usbh OUT transfer buffer size"
         default 512
         help
-            buffer size of each bulk out urb
+            usb host OUT transfer buffer size
+
+    config IN_RINGBUFFER_SIZE
+        int "usbh IN ringbuffer size"
+        default 1024
+        help
+            usb host IN ringbuffer size
+
+    config OUT_RINGBUFFER_SIZE
+        int "usbh OUT ringbuffer size"
+        default 1024
+        help
+            usb host OUT ringbuffer size
+
+    config DEVICE_ADDRESS_LIST_NUM
+        int "usbh device address list num"
+        default 10
+        help
+            usb host device address list num
+
 endmenu

components/usb/iot_usbh_cdc/README.md

@@ -5,7 +5,7 @@ This component implements a simple version of the USB host CDC driver. The API i
 **Features:**
 
 1. Similar API to ESP-IDF UART driver
-2. Support USB CDC device
+2. Support USB CDC device (The notify interface is not supported)
 3. Support USB Vendor device
 4. Support USB CDC multiple interface
 

components/usb/iot_usbh_cdc/idf_component.yml

@@ -1,7 +1,8 @@
-version: "0.2.2"
+version: "1.0.0"
 targets:
   - esp32s2
   - esp32s3
+  - esp32p4
 description: Simple USB Host CDC driver maintained in esp-iot-solution
 url: https://github.com/espressif/esp-iot-solution/tree/master/components/usb/iot_usbh_cdc
 repository: https://github.com/espressif/esp-iot-solution/tree/master/components/usb/iot_usbh_cdc
@@ -10,10 +11,6 @@ issues: https://github.com/espressif/esp-iot-solution/issues
 dependencies:
   idf: ">=4.4.1"
   cmake_utilities: "0.*"
-  iot_usbh:
-    version: "0.*"
-    public: true
-    override_path: "../iot_usbh"
 examples:
   - path: ../../../examples/usb/host/usb_cdc_basic
 sbom: