mirror of
https://github.com/AsahiLinux/u-boot
synced 2024-12-01 08:59:33 +00:00
ba1fa2abde
The main issue the driver addresses is that a USB hub needs to be
powered before it can be discovered. This is often solved by using
"regulator-always-on".
This driver is inspired by the Linux v6.1 driver. It only enables (or
disables) the hub vdd (3v3) supply, so it can be enumerated.
Scanning of the device tree is done in a similar manner to the sandbox,
by the usb-uclass. DT part looks like:
&usbh_ehci {
...
#address-cells = <1>;
#size-cells = <0>;
hub@1 {
compatible = "usb424,2514";
reg = <1>;
vdd-supply = <&v3v3>;
};
};
When the bus gets probed, the driver is automatically probed/removed from
the bus tree, as an example on stm32:
STM32MP> usb start
starting USB...
STM32MP> dm tree
Class Index Probed Driver Name
-----------------------------------------------------------
usb 0 [ + ] ehci_generic | |-- usb@5800d000
usb_hub 0 [ + ] usb_onboard_hub | | `-- hub@1
usb_hub 1 [ + ] usb_hub | | `-- usb_hub
STM32MP> usb tree
USB device tree:
1 Hub (480 Mb/s, 0mA)
| u-boot EHCI Host Controller
|
+-2 Hub (480 Mb/s, 2mA)
Signed-off-by: Fabrice Gasnier <fabrice.gasnier@foss.st.com>
Reviewed-by: Patrice Chotard <patrice.chotard@foss.st.com>
Reviewed-by: Patrick Delaunay <patrick.delaunay@foss.st.com>
152 lines
4.2 KiB
Text
152 lines
4.2 KiB
Text
menuconfig USB
|
|
bool "USB support"
|
|
---help---
|
|
Universal Serial Bus (USB) is a specification for a serial bus
|
|
subsystem which offers higher speeds and more features than the
|
|
traditional PC serial port. The bus supplies power to peripherals
|
|
and allows for hot swapping. Up to 127 USB peripherals can be
|
|
connected to a single USB host in a tree structure.
|
|
|
|
The USB host is the root of the tree, the peripherals are the
|
|
leaves and the inner nodes are special USB devices called hubs.
|
|
Most PCs now have USB host ports, used to connect peripherals
|
|
such as scanners, keyboards, mice, modems, cameras, disks,
|
|
flash memory, network links, and printers to the PC.
|
|
|
|
Say Y here if your device has an USB port, either host, peripheral or
|
|
dual-role.
|
|
|
|
For an USB host port, you then need to say Y to at least one of the
|
|
Host Controller Driver (HCD) options below. Choose a USB 1.1
|
|
controller, such as "UHCI HCD support" or "OHCI HCD support",
|
|
and "EHCI HCD (USB 2.0) support" except for older systems that
|
|
do not have USB 2.0 support. It doesn't normally hurt to select
|
|
them all if you are not certain.
|
|
|
|
If your system has a device-side USB port, used in the peripheral
|
|
side of the USB protocol, see the "USB Gadget" framework instead.
|
|
|
|
After choosing your HCD, then select drivers for the USB peripherals
|
|
you'll be using. You may want to check out the information provided
|
|
in <file:Documentation/usb/> and especially the links given in
|
|
<file:Documentation/usb/usb-help.txt>.
|
|
|
|
if USB
|
|
|
|
config DM_USB
|
|
bool
|
|
depends on DM && OF_CONTROL
|
|
help
|
|
Enable driver model for USB. The USB interface is then implemented
|
|
by the USB uclass. Multiple USB controllers of different types
|
|
(XHCI, EHCI, OHCI) can be attached and used. The 'usb' command works
|
|
as normal.
|
|
|
|
Much of the code is shared but with this option enabled the USB
|
|
uclass takes care of device enumeration. USB devices can be
|
|
declared with the U_BOOT_USB_DEVICE() macro and will be
|
|
automatically probed when found on the bus.
|
|
|
|
config SPL_DM_USB
|
|
bool "Enable driver model for USB host mode in SPL"
|
|
depends on SPL_DM && DM_USB
|
|
default n if ARCH_MVEBU
|
|
default y
|
|
|
|
config DM_USB_GADGET
|
|
bool "Enable driver model for USB Gadget"
|
|
depends on DM_USB
|
|
help
|
|
Enable driver model for USB Gadget (Peripheral
|
|
mode)
|
|
|
|
config SPL_DM_USB_GADGET
|
|
bool "Enable driver model for USB Gadget in SPL"
|
|
depends on SPL_DM_USB
|
|
help
|
|
Enable driver model for USB Gadget in SPL
|
|
(Peripheral mode)
|
|
|
|
source "drivers/usb/host/Kconfig"
|
|
|
|
source "drivers/usb/isp1760/Kconfig"
|
|
|
|
source "drivers/usb/cdns3/Kconfig"
|
|
|
|
source "drivers/usb/dwc3/Kconfig"
|
|
|
|
source "drivers/usb/mtu3/Kconfig"
|
|
|
|
source "drivers/usb/musb/Kconfig"
|
|
|
|
source "drivers/usb/musb-new/Kconfig"
|
|
|
|
source "drivers/usb/emul/Kconfig"
|
|
|
|
source "drivers/usb/phy/Kconfig"
|
|
|
|
source "drivers/usb/ulpi/Kconfig"
|
|
|
|
if USB_HOST
|
|
|
|
comment "USB peripherals"
|
|
|
|
config USB_STORAGE
|
|
bool "USB Mass Storage support"
|
|
---help---
|
|
Say Y here if you want to connect USB mass storage devices to your
|
|
board's USB port.
|
|
|
|
config USB_KEYBOARD
|
|
bool "USB Keyboard support"
|
|
select DM_KEYBOARD if DM_USB
|
|
select SYS_STDIO_DEREGISTER
|
|
---help---
|
|
Say Y here if you want to use a USB keyboard for U-Boot command line
|
|
input.
|
|
|
|
config USB_ONBOARD_HUB
|
|
bool "Onboard USB hub support"
|
|
depends on DM_USB
|
|
---help---
|
|
Say Y here if you want to support discrete onboard USB hubs that
|
|
don't require an additional control bus for initialization, but
|
|
need some non-trivial form of initialization, such as enabling a
|
|
power regulator. An example for such a hub is the Microchip
|
|
USB2514B.
|
|
|
|
if USB_KEYBOARD
|
|
|
|
config USB_KEYBOARD_FN_KEYS
|
|
bool "USB keyboard function key support"
|
|
help
|
|
Say Y here if you want support for keys F1 - F12, INS, HOME, DELETE,
|
|
END, PAGE UP, and PAGE DOWN.
|
|
|
|
choice
|
|
prompt "USB keyboard polling"
|
|
default SYS_USB_EVENT_POLL_VIA_INT_QUEUE if ARCH_SUNXI
|
|
default SYS_USB_EVENT_POLL
|
|
---help---
|
|
Enable a polling mechanism for USB keyboard.
|
|
|
|
config SYS_USB_EVENT_POLL
|
|
bool "Interrupt polling"
|
|
|
|
config SYS_USB_EVENT_POLL_VIA_INT_QUEUE
|
|
bool "Poll via interrupt queue"
|
|
|
|
config SYS_USB_EVENT_POLL_VIA_CONTROL_EP
|
|
bool "Poll via control EP"
|
|
|
|
endchoice
|
|
|
|
endif
|
|
|
|
source "drivers/usb/eth/Kconfig"
|
|
|
|
endif
|
|
|
|
source "drivers/usb/gadget/Kconfig"
|
|
|
|
endif
|