From a52aff81a8493e6fde727a24d7f0528e8dfcdf0d Mon Sep 17 00:00:00 2001 From: Darian Leung Date: Wed, 21 Dec 2022 04:27:04 +0800 Subject: [PATCH] usb_host: Add maintainer's notes (Introduction and DWC_OTG Controller) This commit adds some parts of the USB Host Stack's maintainers notes (specifically "Introduction" and "DWC_OTG Controller" chapters). --- docs/_static/usb_host/dwc-otg-operation.png | Bin 0 -> 62017 bytes .../usb_host/dwc-otg-scatter-gather.png | Bin 0 -> 42495 bytes docs/_static/usb_host/stack-overview.png | Bin 0 -> 23571 bytes docs/conf_common.py | 2 + .../en/api-reference/peripherals/usb_host.rst | 17 +- .../usb_host/usb_host_notes_dwc_otg.rst | 197 ++++++++++++++++++ .../usb_host/usb_host_notes_index.rst | 54 +++++ .../usb_host/usb_host_notes_dwc_otg.rst | 1 + .../usb_host/usb_host_notes_index.rst | 1 + 9 files changed, 270 insertions(+), 2 deletions(-) create mode 100644 docs/_static/usb_host/dwc-otg-operation.png create mode 100644 docs/_static/usb_host/dwc-otg-scatter-gather.png create mode 100644 docs/_static/usb_host/stack-overview.png create mode 100644 docs/en/api-reference/peripherals/usb_host/usb_host_notes_dwc_otg.rst create mode 100644 docs/en/api-reference/peripherals/usb_host/usb_host_notes_index.rst create mode 100644 docs/zh_CN/api-reference/peripherals/usb_host/usb_host_notes_dwc_otg.rst create mode 100644 docs/zh_CN/api-reference/peripherals/usb_host/usb_host_notes_index.rst diff --git a/docs/_static/usb_host/dwc-otg-operation.png b/docs/_static/usb_host/dwc-otg-operation.png new file mode 100644 index 0000000000000000000000000000000000000000..505335745bdf2795bb963c007c81a7a4f73cd5ad GIT binary patch literal 62017 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

% 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 literal 0 HcmV?d00001 diff --git a/docs/_static/usb_host/stack-overview.png b/docs/_static/usb_host/stack-overview.png new file mode 100644 index 0000000000000000000000000000000000000000..0558d8388b1604e91a1098996c4a688eaa56560c GIT binary patch literal 23571 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 (i.e., breaking changes are permitted). + +.. figure:: ../../../../_static/usb_host/stack-overview.png + :align: center + :alt: Diagram of Host Stack Layers + :figclass: align-center + +This document is split into the following sections: + +.. toctree:: + :maxdepth: 1 + + usb_host_notes_dwc_otg + +Todo: + +- USB Host Maintainers Notes (Design) +- USB Host Maintainers Notes (Architecture) +- USB Host Maintainers Notes (HAL & LL) +- USB Host Maintainers Notes (HCD) +- USB Host Maintainers Notes (USBH) +- USB Host Maintainers Notes (Hub) +- USB Host Maintainers Notes (USB Host Library) + +.. -------------------------------------------------- Introduction ----------------------------------------------------- + +Introduction +------------ + +The ESP-IDF USB Host Stack allows the {IDF_TARGET_NAME} to operate as a USB Host. Operating as a USB Host allows the {IDF_TARGET_NAME} to communicate with a wide range of USB devices. However, most USB Host Stack implementations do not run on embedded hardware (i.e., runs on PCs and smartphones), thus have comparatively more resources (i.e., memory and CPU speed). + +The implementation of the ESP-IDF USB Host Stack (henceforth referred to as the Host Stack) takes into account the embedded nature of the {IDF_TARGET_NAME} which is reflected in various aspects of the Host Stack's design. + +Features & Limitations +^^^^^^^^^^^^^^^^^^^^^^ + +**The Host Stack currently supports the following notable features:** + +- Support FS (Full Speed) and LS (Low Speed) devices +- Support all transfer types (Control, Bulk, Isochronous, and Interrupt) +- Automatically enumerates connected devices +- Allows multiple class drivers (i.e., Clients of the USB Host Library) to run simultaneously and share the same device (i.e., composite devices). + +**The Host Stack currently has the following notable limitations:** + +- No HS (High Speed) support +- No Hub support (currently only supports a single device) + diff --git a/docs/zh_CN/api-reference/peripherals/usb_host/usb_host_notes_dwc_otg.rst b/docs/zh_CN/api-reference/peripherals/usb_host/usb_host_notes_dwc_otg.rst new file mode 100644 index 0000000000..82e4134653 --- /dev/null +++ b/docs/zh_CN/api-reference/peripherals/usb_host/usb_host_notes_dwc_otg.rst @@ -0,0 +1 @@ +.. include:: ../../../../en/api-reference/peripherals/usb_host/usb_host_notes_dwc_otg.rst \ No newline at end of file diff --git a/docs/zh_CN/api-reference/peripherals/usb_host/usb_host_notes_index.rst b/docs/zh_CN/api-reference/peripherals/usb_host/usb_host_notes_index.rst new file mode 100644 index 0000000000..4423f1fe2d --- /dev/null +++ b/docs/zh_CN/api-reference/peripherals/usb_host/usb_host_notes_index.rst @@ -0,0 +1 @@ +.. include:: ../../../../en/api-reference/peripherals/usb_host/usb_host_notes_index.rst \ No newline at end of file