Merge branch 'docs/usb_maintainer_docs_p4' into 'master'

docs(usb/host): Update maintainer docs for ESP32-P4

See merge request espressif/esp-idf!32831
This commit is contained in:
Tomas Rezucha
2024-08-22 22:21:31 +08:00
6 changed files with 91 additions and 48 deletions

View File

@@ -39,7 +39,7 @@ USB 主机维护者注释(架构)
- ``usb_host.h`` ``usb_host.c``
- USB 主机库层是主机协议栈的最低公共 API 层,并呈现 USB 主机客户端的概念。客户端的抽象允许多个 class 驱动程序同时存在(其中每个类大致映射到一个单独的客户端),这也是一种分工机制(其中每个客户端负责各自的处理以及事件处理)。
* - 主机 Class 驱动程序
- 请参阅 `ESP-IDF 额外组件存储库 <https://github.com/espressif/idf-extra-components>`_ 或是 ESP-IDF 中的 USB 主机示例 :example:`peripherals/usb/host`
- 请参阅 `ESP-USB 存储库 <https://github.com/espressif/esp-usb>`_ 或是 ESP-IDF 中的 USB 主机示例 :example:`peripherals/usb/host`
- 主机 Class 驱动程序能实现特定设备类例如CDC、MSC、HID的主机端。每个 class 驱动程序具有特定的公开 API 接口。
层依赖关系

View File

@@ -91,26 +91,51 @@ DMA 引擎负责在 FIFO 和主内存之间复制数据。启用主机模式分
DWC_OTG IP 是可配置的。有关 {IDF_TARGET_NAME} 的 DWC_OTG 的重要主机配置,请参阅下表:
.. list-table:: {IDF_TARGET_NAME} 的 DWC_OTG 配置
:widths: 70 30
:header-rows: 1
.. only:: esp32p4
* - 描述
- 配置
* - 支持 OTG 的主机和设备模式
- ``OTG_MODE = 0``
* - 支持全速 (FS) 和低速 (LS)
- ``OTG_FSPHY_INTERFACE = 1````OTG_HSPHY_INTERFACE = 0``
* - 支持分散/聚集式 DMA 功能的内部 DMA 控制器
- ``OTG_ARCHITECTURE = 2````OTG_EN_DESC_DMA = 1``
* - 支持 FS 集线器但不支持 HS 集线器(即,不支持分割传输)
- ``OTG_SINGLE_POINT = 0``
* - 8 个主机模式通道
- ``OTG_NUM_HOST_CHAN = 8``
* - 支持包括 ISOC 和 INTR OUT 传输在内的所有传输类型
- ``OTG_EN_PERIO_HOST = 1``
* - 动态大小的 1024 字节256 行)数据 FIFO
- ``OTG_DFIFO_DYNAMIC = 1````OTG_DFIFO_DEPTH = 256``
.. list-table:: {IDF_TARGET_NAME} 的 DWC_OTG 配置
:widths: 70 30
:header-rows: 1
* - 描述
- 配置
* - 支持 OTG 的主机和设备模式
- ``OTG_MODE = 0``
* - 支持高速 (HS)、全速 (FS) 和低速 (LS)
- ``OTG_FSPHY_INTERFACE = 2````OTG_HSPHY_INTERFACE = 3``
* - 支持分散/聚集式 DMA 功能的内部 DMA 控制器
- ``OTG_ARCHITECTURE = 2````OTG_EN_DESC_DMA = 1``
* - 支持分割传输
- ``OTG_SINGLE_POINT = 1``
* - 16 个主机模式通道
- ``OTG_NUM_HOST_CHAN = 16``
* - 支持包括 ISOC 和 INTR OUT 传输在内的所有传输类型
- ``OTG_EN_PERIO_HOST = 1``
* - 动态大小的 4096 字节1024 行)数据 FIFO
- ``OTG_DFIFO_DYNAMIC = 1````OTG_DFIFO_DEPTH = 1024``
* - 每个微帧仅支持 4 个周期性和 4 个非周期性事务
- ``OTG_NPERIO_TX_QUEUE_DEPTH = 4````OTG_PERIO_TX_QUEUE_DEPTH = 4``
.. only:: esp32s2 or esp32s3
.. list-table:: {IDF_TARGET_NAME} 的 DWC_OTG 配置
:widths: 70 30
:header-rows: 1
* - 描述
- 配置
* - 支持 OTG 的主机和设备模式
- ``OTG_MODE = 0``
* - 支持全速 (FS) 和低速 (LS)
- ``OTG_FSPHY_INTERFACE = 1````OTG_HSPHY_INTERFACE = 0``
* - 支持分散/聚集式 DMA 功能的内部 DMA 控制器
- ``OTG_ARCHITECTURE = 2````OTG_EN_DESC_DMA = 1``
* - 8 个主机模式通道
- ``OTG_NUM_HOST_CHAN = 8``
* - 支持包括 ISOC 和 INTR OUT 传输在内的所有传输类型
- ``OTG_EN_PERIO_HOST = 1``
* - 动态大小的 1024 字节256 行)数据 FIFO
- ``OTG_DFIFO_DYNAMIC = 1``, ``OTG_DFIFO_DEPTH = 256``
分散/聚集式 DMA 传输
---------------------