Allow iPXE to coexist with other USB device drivers, by attaching to the EFI_USB_IO_PROTOCOL instances provided by the UEFI platform firmware. The EFI_USB_IO_PROTOCOL is an unsurprisingly badly designed abstraction of a USB device. The poor design choices intrinsic in the UEFI specification prevent efficient operation as a network device, with the result that devices operated using the EFI_USB_IO_PROTOCOL operate approximately two orders of magnitude slower than devices operated using our native EHCI or xHCI host controller drivers. Since the performance is so abysmally slow, and since the underlying problems are due to fundamental architectural mistakes in the UEFI specification, support for the EFI_USB_IO_PROTOCOL host controller driver is left as disabled by default. Users are advised to use the native iPXE host controller drivers instead. Signed-off-by: Michael Brown <mcb30@ipxe.org>
35 lines
663 B
C
35 lines
663 B
C
#ifndef CONFIG_USB_H
|
|
#define CONFIG_USB_H
|
|
|
|
/** @file
|
|
*
|
|
* USB configuration
|
|
*
|
|
*/
|
|
|
|
FILE_LICENCE ( GPL2_OR_LATER_OR_UBDL );
|
|
|
|
#include <config/defaults.h>
|
|
|
|
/*
|
|
* USB host controllers (all enabled by default)
|
|
*
|
|
*/
|
|
//#undef USB_HCD_XHCI /* xHCI USB host controller */
|
|
//#undef USB_HCD_EHCI /* EHCI USB host controller */
|
|
//#undef USB_HCD_UHCI /* UHCI USB host controller */
|
|
//#define USB_HCD_USBIO /* Very slow EFI USB host controller */
|
|
|
|
/*
|
|
* USB peripherals
|
|
*
|
|
*/
|
|
//#undef USB_KEYBOARD /* USB keyboards */
|
|
|
|
#include <config/named.h>
|
|
#include NAMED_CONFIG(usb.h)
|
|
#include <config/local/usb.h>
|
|
#include LOCAL_NAMED_CONFIG(usb.h)
|
|
|
|
#endif /* CONFIG_USB_H */
|