mirror of
https://github.com/espressif/esp-idf.git
synced 2025-11-04 06:11:06 +00:00
193 lines
8.6 KiB
Plaintext
193 lines
8.6 KiB
Plaintext
menu "USB-OTG"
|
|
depends on SOC_USB_OTG_SUPPORTED
|
|
|
|
config USB_HOST_CONTROL_TRANSFER_MAX_SIZE
|
|
int "Largest size (in bytes) of transfers to/from default endpoints"
|
|
default 256
|
|
help
|
|
Each USB device attached is allocated a dedicated buffer for its OUT/IN transfers to/from the device's
|
|
control endpoint. The maximum size of that buffer is determined by this option. The limited size of the
|
|
transfer buffer have the following implications:
|
|
- The maximum length of control transfers is limited
|
|
- Device's with configuration descriptors larger than this limit cannot be supported
|
|
|
|
choice USB_HOST_HW_BUFFER_BIAS
|
|
prompt "Hardware FIFO size biasing"
|
|
default USB_HOST_HW_BUFFER_BIAS_BALANCED
|
|
help
|
|
The underlying hardware has size adjustable FIFOs to cache USB packets on reception (IN) or for
|
|
transmission (OUT). The size of these FIFOs will affect the largest MPS (maximum packet size) and the
|
|
maximum number of packets that can be cached at any one time. The hardware contains the following
|
|
FIFOS: RX (for all IN packets), Non-periodic TX (for Bulk and Control OUT packets), and Periodic TX
|
|
(for Interrupt and Isochronous OUT packets). This configuration option allows biasing the FIFO sizes
|
|
towards a particular use case, which may be necessary for devices that have endpoints with large MPS.
|
|
The MPS limits for each biasing are listed below:
|
|
|
|
Balanced:
|
|
- IN (all transfer types), 408 bytes
|
|
- OUT non-periodic (Bulk/Control), 192 bytes (i.e., 3 x 64 byte packets)
|
|
- OUT periodic (Interrupt/Isochronous), 192 bytes
|
|
|
|
Bias IN:
|
|
- IN (all transfer types), 600 bytes
|
|
- OUT non-periodic (Bulk/Control), 64 bytes (i.e., 1 x 64 byte packets)
|
|
- OUT periodic (Interrupt/Isochronous), 128 bytes
|
|
|
|
Bias Periodic OUT:
|
|
- IN (all transfer types), 128 bytes
|
|
- OUT non-periodic (Bulk/Control), 64 bytes (i.e., 1 x 64 byte packets)
|
|
- OUT periodic (Interrupt/Isochronous), 600 bytes
|
|
|
|
config USB_HOST_HW_BUFFER_BIAS_BALANCED
|
|
bool "Balanced"
|
|
config USB_HOST_HW_BUFFER_BIAS_IN
|
|
bool "Bias IN"
|
|
config USB_HOST_HW_BUFFER_BIAS_PERIODIC_OUT
|
|
bool "Periodic OUT"
|
|
endchoice
|
|
|
|
menu "Hub Driver Configuration"
|
|
|
|
menu "Root Port configuration"
|
|
|
|
config USB_HOST_DEBOUNCE_DELAY_MS
|
|
int "Debounce delay in ms"
|
|
default 250
|
|
help
|
|
On connection of a USB device, the USB 2.0 specification requires
|
|
a "debounce interval with a minimum duration of 100ms" to allow the connection to stabilize
|
|
(see USB 2.0 chapter 7.1.7.3 for more details).
|
|
During the debounce interval, no new connection/disconnection events are registered.
|
|
|
|
The default value is set to 250 ms to be safe.
|
|
|
|
config USB_HOST_RESET_HOLD_MS
|
|
int "Reset hold in ms"
|
|
default 30
|
|
help
|
|
The reset signaling can be generated on any Hub or Host Controller port by request from
|
|
the USB System Software. The USB 2.0 specification requires that "the reset signaling must
|
|
be driven for a minimum of 10ms" (see USB 2.0 chapter 7.1.7.5 for more details).
|
|
After the reset, the hub port will transition to the Enabled state (refer to Section 11.5).
|
|
|
|
The default value is set to 30 ms to be safe.
|
|
|
|
config USB_HOST_RESET_RECOVERY_MS
|
|
int "Reset recovery delay in ms"
|
|
default 30
|
|
help
|
|
After a port stops driving the reset signal, the USB 2.0 specification requires that
|
|
the "USB System Software guarantees a minimum of 10 ms for reset recovery" before the
|
|
attached device is expected to respond to data transfers (see USB 2.0 chapter 7.1.7.3 for
|
|
more details).
|
|
The device may ignore any data transfers during the recovery interval.
|
|
|
|
The default value is set to 30 ms to be safe.
|
|
|
|
|
|
config USB_HOST_SET_ADDR_RECOVERY_MS
|
|
int "SetAddress() recovery time in ms"
|
|
default 10
|
|
help
|
|
"After successful completion of the Status stage, the device is allowed a SetAddress()
|
|
recovery interval of 2 ms. At the end of this interval, the device must be able to accept
|
|
Setup packets addressed to the new address. Also, at the end of the recovery interval, the
|
|
device must not respond to tokens sent to the old address (unless, of course, the old and new
|
|
address is the same)." See USB 2.0 chapter 9.2.6.3 for more details.
|
|
|
|
The default value is set to 10 ms to be safe.
|
|
|
|
endmenu #Root Hub configuration
|
|
|
|
config USB_HOST_HUBS_SUPPORTED
|
|
bool "Support Hubs"
|
|
default n
|
|
help
|
|
Enables support of external Hubs.
|
|
|
|
config USB_HOST_HUB_MULTI_LEVEL
|
|
depends on USB_HOST_HUBS_SUPPORTED
|
|
bool "Support multiple Hubs"
|
|
default y
|
|
help
|
|
Enables support for connecting multiple Hubs simultaneously.
|
|
|
|
menu "Downstream Port configuration"
|
|
depends on USB_HOST_HUBS_SUPPORTED
|
|
|
|
config USB_HOST_EXT_PORT_SUPPORT_LS
|
|
depends on IDF_EXPERIMENTAL_FEATURES
|
|
bool "Support LS"
|
|
default n
|
|
help
|
|
Enables support of Low-speed devices, connected through the external Hub.
|
|
|
|
config USB_HOST_EXT_PORT_RESET_ATTEMPTS
|
|
depends on IDF_EXPERIMENTAL_FEATURES
|
|
# Invisible config option
|
|
# Todo: IDF-11283
|
|
int
|
|
default 1
|
|
help
|
|
Amount of attempts to reset the device.
|
|
|
|
The default value is 1.
|
|
|
|
config USB_HOST_EXT_PORT_RESET_RECOVERY_DELAY_MS
|
|
int "Reset recovery delay in ms"
|
|
default 30
|
|
help
|
|
After a port stops driving the reset signal, the USB 2.0 specification requires that
|
|
the "USB System Software guarantees a minimum of 10 ms for reset recovery" before the
|
|
attached device is expected to respond to data transfers (see USB 2.0 chapter 7.1.7.3 for
|
|
more details).
|
|
The device may ignore any data transfers during the recovery interval.
|
|
|
|
The default value is set to 30 ms to be safe.
|
|
|
|
config USB_HOST_EXT_PORT_CUSTOM_POWER_ON_DELAY_ENABLE
|
|
bool "Custom bPwrOn2PwrGood value"
|
|
default n
|
|
help
|
|
Enables the possibility to configure custom time for the power-on sequence on a port
|
|
until power is good on that port.
|
|
|
|
When enabled, applies the custom PwrOn2PwrGood delay.
|
|
When disabled, applies the PwrOn2PwrGood value from the Hub Descriptor.
|
|
|
|
config USB_HOST_EXT_PORT_CUSTOM_POWER_ON_DELAY_MS
|
|
depends on USB_HOST_EXT_PORT_CUSTOM_POWER_ON_DELAY_ENABLE
|
|
int "PwrOn2PwrGood delay in ms"
|
|
default 100
|
|
range 0 5000
|
|
help
|
|
Custom value of delay from the time the power-on sequence begins on a port
|
|
until power is good on that port.
|
|
Value 0 is used for a hub with no power switches.
|
|
|
|
The default value is 100 ms.
|
|
|
|
endmenu #Downstream Port configuration
|
|
|
|
endmenu #Hub Driver Configuration
|
|
|
|
config USB_HOST_ENABLE_ENUM_FILTER_CALLBACK
|
|
bool "Enable enumeration filter callback"
|
|
default n
|
|
help
|
|
The enumeration filter callback is called before enumeration of each newly attached device.
|
|
This callback allows users to control whether a device should be enumerated, and what configuration
|
|
number to use when enumerating a device.
|
|
|
|
If enabled, the enumeration filter callback can be set via 'usb_host_config_t' when calling
|
|
'usb_host_install()'.
|
|
|
|
# Hidden or compatibility options
|
|
config USB_OTG_SUPPORTED
|
|
# Invisible config kept for compatibility
|
|
# Todo: Remove in v6.0 (IDF-8936)
|
|
bool
|
|
default y
|
|
|
|
endmenu #USB-OTG
|