src/drivers/usb/Kconfig

   1 ## SPDX-License-Identifier: GPL-2.0-only
   2
   3         # Use "select HAVE_USBDEBUG" on southbridges which have Debug Port code.
   4 config HAVE_USBDEBUG
   5         bool
   6         default y if HAVE_USBDEBUG_OPTIONS
   7         default n
   8
   9 # Use "select HAVE_USBDEBUG_OPTIONS" on southbridges with multiple
  10 # EHCI controllers or multiple ports with Debug Port capability
  11 config HAVE_USBDEBUG_OPTIONS
  12         def_bool n
  13
  14 config USBDEBUG
  15         bool "USB 2.0 EHCI debug dongle support"
  16         default n
  17         depends on HAVE_USBDEBUG
  18         help
  19           This option allows you to use a so-called USB EHCI Debug device
  20           (such as the Ajays NET20DC, AMIDebug RX, or a system using the
  21           Linux "EHCI Debug Device gadget" driver found in recent kernel)
  22           to retrieve the coreboot debug messages (instead, or in addition
  23           to, a serial port).
  24
  25           This feature is NOT supported on all chipsets in coreboot!
  26
  27           It also requires a USB2 controller which supports the EHCI
  28           Debug Port capability.
  29
  30           See https://www.coreboot.org/EHCI_Debug_Port for an up-to-date list
  31           of supported controllers.
  32
  33           If unsure, say N.
  34
  35 if USBDEBUG
  36
  37 config USBDEBUG_IN_PRE_RAM
  38         bool "Enable early (pre-RAM) usbdebug"
  39         default y
  40         help
  41            Configuring USB controllers in system-agent binary may cause
  42            problems to usbdebug. Disabling this option delays usbdebug to
  43            be setup on entry to ramstage.
  44
  45            If unsure, say Y.
  46
  47 config USBDEBUG_HCD_INDEX
  48         int
  49         default 0
  50         prompt "Index for EHCI controller to use with usbdebug" if HAVE_USBDEBUG_OPTIONS
  51         help
  52            Some boards have multiple EHCI controllers with possibly only
  53            one having the Debug Port capability on an external USB port.
  54
  55            Mapping of this index to PCI device functions is southbridge
  56            specific and mainboard level Kconfig should already provide
  57            a working default value here.
  58
  59 config USBDEBUG_DEFAULT_PORT
  60         int
  61         default 0
  62         prompt "Default USB port to use as Debug Port" if HAVE_USBDEBUG_OPTIONS
  63         help
  64           Selects which physical USB port usbdebug dongle is connected to.
  65           Setting of 0 means to scan possible ports starting from 1.
  66
  67           Intel platforms have hardwired the debug port location and this
  68           setting makes no difference there.
  69
  70           Hence, if you select the correct port here, you can speed up
  71           your boot time. Which USB port number refers to which actual
  72           port on your mainboard (potentially also USB pin headers on
  73           your mainboard) is highly board-specific, and you'll likely
  74           have to find out by trial-and-error.
  75
  76 choice
  77         prompt "Type of dongle"
  78         default USBDEBUG_DONGLE_STD
  79
  80 config USBDEBUG_DONGLE_STD
  81         bool "USB gadget driver or Net20DC"
  82         help
  83           Net20DC, BeagleBone Black, Raspberry Pi Zero W
  84
  85 config USBDEBUG_DONGLE_BEAGLEBONE
  86         bool "BeagleBone (not BeagleBone Black)"
  87         help
  88           Use this to configure the USB hub on BeagleBone board.
  89           Do NOT select this for the BeagleBone Black.
  90
  91 config USBDEBUG_DONGLE_FTDI_FT232H
  92         bool "FTDI FT232H UART"
  93         help
  94           Use this with FT232H usb-to-uart. Configuration is hard-coded
  95           to use 8n1, no flow control.
  96
  97 config USBDEBUG_DONGLE_WCH_CH347
  98         bool "WCH CH347 UART"
  99         help
 100           Use this with CH347 usb-to-uart. Configuration is hard-coded
 101           to use 8n1, no flow control. For compatibility across modes
 102           0, 1, and 3, only UART 1 is supported. The UART in mode 2 is
 103           not currently supported.
 104
 105 endchoice
 106
 107 config USBDEBUG_DONGLE_FTDI_FT232H_BAUD
 108         int "FTDI FT232H baud rate"
 109         default 115200
 110         depends on USBDEBUG_DONGLE_FTDI_FT232H
 111         help
 112           Select baud rate for FT232H in the range 733..12,000,000. Make
 113           sure that your receiving side supports the same setting and your
 114           connection works with it. Multiples of 115,200 seem to be a good
 115           choice, and EHCI debug usually can't saturate more than 576,000.
 116
 117 config USBDEBUG_DONGLE_WCH_CH347_BAUD
 118         int "WCH CH347 baud rate"
 119         default 115200
 120         depends on USBDEBUG_DONGLE_WCH_CH347
 121         help
 122           Select baud rate for CH347 in the range 1200..9,000,000. Make
 123           sure that your receiving side supports the same setting and your
 124           connection works with it. Multiples of 115,200 seem to be a good
 125           choice, and EHCI debug usually can't saturate more than 576,000.
 126
 127 config USBDEBUG_OPTIONAL_HUB_PORT
 128         int
 129         default 2 if USBDEBUG_DONGLE_BEAGLEBONE
 130         default 0
 131
 132 endif # USBDEBUG