2 # Serial device configuration
11 Select a default baudrate, where "default" has a driver-specific
12 meaning of either setting the baudrate for the early debug UART
13 in the SPL stage (most drivers) or for choosing a default baudrate
14 in the absence of an environment setting (serial_mxc.c).
16 config REQUIRE_SERIAL_CONSOLE
17 bool "Require a serial port for console"
18 # Running without a serial console is not supported by the
23 Require a serial port for the console, and panic if none is found
24 during serial port initialization (default y). Set this to n on
25 boards which have no debug serial port whatsoever.
27 config SPECIFY_CONSOLE_INDEX
28 bool "Specify the port number used for console"
29 default y if !DM_SERIAL || (SPL && !SPL_DM_SERIAL) || \
30 (TPL && !TPL_DM_SERIAL)
32 In various cases, we need to specify which of the UART devices that
33 a board or SoC has available are to be used for the console device
37 bool "Provide a serial driver"
41 In very space-constrained devices even the full UART driver is too
42 large. In this case the debug UART can still be used in some cases.
43 This option enables the full UART in U-Boot, so if is it disabled,
44 the full UART driver will be omitted, thus saving space.
46 config SPL_SERIAL_PRESENT
47 bool "Provide a serial driver in SPL"
51 In very space-constrained devices even the full UART driver is too
52 large. In this case the debug UART can still be used in some cases.
53 This option enables the full UART in SPL, so if is it disabled,
54 the full UART driver will be omitted, thus saving space.
56 config TPL_SERIAL_PRESENT
57 bool "Provide a serial driver in TPL"
61 In very space-constrained devices even the full UART driver is too
62 large. In this case the debug UART can still be used in some cases.
63 This option enables the full UART in TPL, so if is it disabled,
64 the full UART driver will be omitted, thus saving space.
66 # Logic to allow us to use the imply keyword to set what the default port
67 # should be. The default is otherwise 1.
87 int "UART used for console"
88 depends on SPECIFY_CONSOLE_INDEX
90 default 0 if CONS_INDEX_0
91 default 2 if CONS_INDEX_2
92 default 3 if CONS_INDEX_3
93 default 4 if CONS_INDEX_4
94 default 5 if CONS_INDEX_5
95 default 6 if CONS_INDEX_6
98 Set this to match the UART number of the serial console.
101 bool "Enable Driver Model for serial drivers"
104 Enable driver model for serial. This replaces
105 drivers/serial/serial.c with the serial uclass, which
106 implements serial_putc() etc. The uclass interface is
107 defined in include/serial.h.
109 config SERIAL_RX_BUFFER
110 bool "Enable RX buffer for serial input"
113 Enable RX buffer support for the serial driver. This enables
114 pasting longer strings, even when the RX FIFO of the UART is
115 not big enough (e.g. 16 bytes on the normal NS16550).
117 config SERIAL_RX_BUFFER_SIZE
119 depends on SERIAL_RX_BUFFER
122 The size of the RX buffer (needs to be power of 2)
124 config SERIAL_SEARCH_ALL
125 bool "Search for serial devices after default one failed"
128 The serial subsystem only searches for a single serial device
129 that was instantiated, but does not check whether it was probed
130 correctly. With this option set, we make successful probing
131 mandatory and search for fallback serial devices if the default
132 device does not work.
137 bool "Enable Driver Model for serial drivers in SPL"
138 depends on DM_SERIAL && SPL_DM
141 Enable driver model for serial in SPL. This replaces
142 drivers/serial/serial.c with the serial uclass, which
143 implements serial_putc() etc. The uclass interface is
144 defined in include/serial.h.
147 bool "Enable Driver Model for serial drivers in TPL"
149 default y if TPL && DM_SERIAL
151 Enable driver model for serial in TPL. This replaces
152 drivers/serial/serial.c with the serial uclass, which
153 implements serial_putc() etc. The uclass interface is
154 defined in include/serial.h.
157 bool "Enable an early debug UART for debugging"
159 The debug UART is intended for use very early in U-Boot to debug
160 problems when an ICE or other debug mechanism is not available.
162 To use it you should:
163 - Make sure your UART supports this interface
164 - Enable CONFIG_DEBUG_UART
165 - Enable the CONFIG for your UART to tell it to provide this interface
166 (e.g. CONFIG_DEBUG_UART_NS16550)
167 - Define the required settings as needed (see below)
168 - Call debug_uart_init() before use
169 - Call debug_uart_putc() to output a character
171 Depending on your platform it may be possible to use this UART before
172 a stack is available.
174 If your UART does not support this interface you can probably add
175 support quite easily. Remember that you cannot use driver model and
176 it is preferred to use no stack.
178 You must not use this UART once driver model is working and the
179 serial drivers are up and running (done in serial_init()). Otherwise
180 the drivers may conflict and you will get strange output.
183 prompt "Select which UART will provide the debug UART"
184 depends on DEBUG_UART
185 default DEBUG_UART_NS16550
187 config DEBUG_UART_ALTERA_JTAGUART
188 bool "Altera JTAG UART"
190 Select this to enable a debug UART using the altera_jtag_uart driver.
191 You will need to provide parameters to make this work. The driver will
192 be available until the real driver model serial is running.
194 config DEBUG_UART_ALTERA_UART
197 Select this to enable a debug UART using the altera_uart driver.
198 You will need to provide parameters to make this work. The driver will
199 be available until the real driver model serial is running.
201 config DEBUG_UART_AR933X
202 bool "QCA/Atheros ar933x"
203 depends on AR933X_UART
205 Select this to enable a debug UART using the ar933x uart driver.
206 You will need to provide parameters to make this work. The
207 driver will be available until the real driver model serial is
210 config DEBUG_ARC_SERIAL
212 depends on ARC_SERIAL
214 Select this to enable a debug UART using the ARC UART driver.
215 You will need to provide parameters to make this work. The
216 driver will be available until the real driver model serial is
219 config DEBUG_UART_ATMEL
222 Select this to enable a debug UART using the atmel usart driver. You
223 will need to provide parameters to make this work. The driver will
224 be available until the real driver-model serial is running.
226 config DEBUG_UART_BCM6345
228 depends on BCM6345_SERIAL
230 Select this to enable a debug UART on BCM6345 SoCs. You
231 will need to provide parameters to make this work. The driver will
232 be available until the real driver model serial is running.
234 config DEBUG_UART_NS16550
237 Select this to enable a debug UART using the ns16550 driver. You
238 will need to provide parameters to make this work. The driver will
239 be available until the real driver model serial is running.
241 config DEBUG_EFI_CONSOLE
245 Select this to enable a debug console which calls back to EFI to
246 output to the console. This can be useful for early debugging of
247 U-Boot when running on top of EFI (Extensive Firmware Interface).
248 This is a type of BIOS used by PCs.
250 config DEBUG_UART_S5P
253 Select this to enable a debug UART using the serial_s5p driver. You
254 will need to provide parameters to make this work. The driver will
255 be available until the real driver-model serial is running.
257 config DEBUG_UART_MESON
259 depends on MESON_SERIAL
261 Select this to enable a debug UART using the serial_meson driver. You
262 will need to provide parameters to make this work. The driver will
263 be available until the real driver-model serial is running.
265 config DEBUG_UART_UARTLITE
266 bool "Xilinx Uartlite"
268 Select this to enable a debug UART using the serial_uartlite driver.
269 You will need to provide parameters to make this work. The driver will
270 be available until the real driver-model serial is running.
272 config DEBUG_UART_ARM_DCC
275 Select this to enable a debug UART using the ARM JTAG DCC port.
276 The DCC port can be used for very early debugging and doesn't require
277 any additional setting like address/baudrate/clock. On systems without
278 any serial interface this is the easiest way how to get console.
279 Every ARM core has own DCC port which is the part of debug interface.
280 This port is available at least on ARMv6, ARMv7, ARMv8 and XScale
283 config DEBUG_MVEBU_A3700_UART
284 bool "Marvell Armada 3700"
286 Select this to enable a debug UART using the serial_mvebu driver. You
287 will need to provide parameters to make this work. The driver will
288 be available until the real driver-model serial is running.
290 config DEBUG_UART_ZYNQ
293 Select this to enable a debug UART using the serial_zynq driver. You
294 will need to provide parameters to make this work. The driver will
295 be available until the real driver-model serial is running.
297 config DEBUG_UART_APBUART
299 bool "Gaisler APBUART"
301 Select this to enable a debug UART using the serial_leon3 driver. You
302 will need to provide parameters to make this work. The driver will
303 be available until the real driver model serial is running.
305 config DEBUG_UART_PL010
308 Select this to enable a debug UART using the pl01x driver with the
309 PL010 UART type. You will need to provide parameters to make this
310 work. The driver will be available until the real driver model
313 config DEBUG_UART_PL011
316 Select this to enable a debug UART using the pl01x driver with the
317 PL011 UART type. You will need to provide parameters to make this
318 work. The driver will be available until the real driver model
321 config DEBUG_UART_PIC32
322 bool "Microchip PIC32"
323 depends on PIC32_SERIAL
325 Select this to enable a debug UART using the serial_pic32 driver. You
326 will need to provide parameters to make this work. The driver will
327 be available until the real driver model serial is running.
329 config DEBUG_UART_MXC
330 bool "IMX Serial port"
333 Select this to enable a debug UART using the serial_mxc driver. You
334 will need to provide parameters to make this work. The driver will
335 be available until the real driver model serial is running.
337 config DEBUG_UART_SANDBOX
339 depends on SANDBOX_SERIAL
341 Select this to enable the debug UART using the sandbox driver. This
342 provides basic serial output from the console without needing to
343 start up driver model. The driver will be available until the real
344 driver model serial is running.
346 config DEBUG_UART_STM32
347 bool "STMicroelectronics STM32"
348 depends on STM32_SERIAL
350 Select this to enable a debug UART using the serial_stm32 driver
351 You will need to provide parameters to make this work.
352 The driver will be available until the real driver model
355 config DEBUG_UART_UNIPHIER
356 bool "UniPhier on-chip UART"
357 depends on ARCH_UNIPHIER
359 Select this to enable a debug UART using the UniPhier on-chip UART.
360 You will need to provide DEBUG_UART_BASE to make this work. The
361 driver will be available until the real driver-model serial is
364 config DEBUG_UART_OMAP
367 Select this to enable a debug UART using the omap ns16550 driver.
368 You will need to provide parameters to make this work. The driver
369 will be available until the real driver model serial is running.
371 config DEBUG_UART_MTK
372 bool "MediaTek High-speed UART"
373 depends on MTK_SERIAL
375 Select this to enable a debug UART using the MediaTek High-speed
377 You will need to provide parameters to make this work. The
378 driver will be available until the real driver model serial is
383 config DEBUG_UART_BASE
384 hex "Base address of UART"
385 depends on DEBUG_UART
386 default 0 if DEBUG_UART_SANDBOX
388 This is the base address of your UART for memory-mapped UARTs.
390 A default should be provided by your board, but if not you will need
391 to use the correct value here.
393 config DEBUG_UART_CLOCK
394 int "UART input clock"
395 depends on DEBUG_UART
396 default 0 if DEBUG_UART_SANDBOX
398 The UART input clock determines the speed of the internal UART
399 circuitry. The baud rate is derived from this by dividing the input
402 A default should be provided by your board, but if not you will need
403 to use the correct value here.
405 config DEBUG_UART_SHIFT
406 int "UART register shift"
407 depends on DEBUG_UART
408 default 0 if DEBUG_UART
410 Some UARTs (notably ns16550) support different register layouts
411 where the registers are spaced either as bytes, words or some other
412 value. Use this value to specify the shift to use, where 0=byte
413 registers, 2=32-bit word registers, etc.
415 config DEBUG_UART_BOARD_INIT
416 bool "Enable board-specific debug UART init"
417 depends on DEBUG_UART
419 Some boards need to set things up before the debug UART can be used.
420 On these boards a call to debug_uart_init() is insufficient. When
421 this option is enabled, the function board_debug_uart_init() will
422 be called when debug_uart_init() is called. You can put any code
423 here that is needed to set up the UART ready for use, such as set
424 pin multiplexing or enable clocks.
426 config DEBUG_UART_ANNOUNCE
427 bool "Show a message when the debug UART starts up"
428 depends on DEBUG_UART
430 Enable this option to show a message when the debug UART is ready
431 for use. You will see a message like "<debug_uart> " as soon as
432 U-Boot has the UART ready for use (i.e. your code calls
433 debug_uart_init()). This can be useful just as a check that
434 everything is working.
436 config DEBUG_UART_SKIP_INIT
437 bool "Skip UART initialization"
439 Select this if the UART you want to use for debug output is already
440 initialized by the time U-Boot starts its execution.
442 config ALTERA_JTAG_UART
443 bool "Altera JTAG UART support"
446 Select this to enable an JTAG UART for Altera devices.The JTAG UART
447 core implements a method to communicate serial character streams
448 between a host PC and a Qsys system on an Altera FPGA. Please find
449 details on the "Embedded Peripherals IP User Guide" of Altera.
451 config ALTERA_JTAG_UART_BYPASS
452 bool "Bypass output when no connection"
453 depends on ALTERA_JTAG_UART
455 Bypass console output and keep going even if there is no JTAG
456 terminal connection with the host. The console output will resume
457 once the JTAG terminal is connected. Without the bypass, the console
458 output will wait forever until a JTAG terminal is connected. If you
462 bool "Altera UART support"
465 Select this to enable an UART for Altera devices. Please find
466 details on the "Embedded Peripherals IP User Guide" of Altera.
469 bool "QCA/Atheros ar933x UART support"
470 depends on DM_SERIAL && SOC_AR933X
472 Select this to enable UART support for QCA/Atheros ar933x
473 devices. This driver uses driver model and requires a device
474 tree binding to operate, please refer to the document at
475 doc/device-tree-bindings/serial/qca,ar9330-uart.txt.
478 bool "ARC UART support"
481 Select this to enable support for ARC UART now typically
482 only used in Synopsys DesignWare ARC simulators like nSIM.
485 bool "Atmel USART support"
487 Select this to enable USART support for Atmel SoCs. It can be
488 configured in the device tree, and input clock frequency can
489 be got from the clk node.
491 config BCM283X_MU_SERIAL
492 bool "Support for BCM283x Mini-UART"
493 depends on DM_SERIAL && ARCH_BCM283X
496 Select this to enable Mini-UART support on BCM283X family of SoCs.
498 config BCM283X_PL011_SERIAL
499 bool "Support for BCM283x PL011 UART"
500 depends on PL01X_SERIAL && ARCH_BCM283X
503 Select this to enable an overriding PL011 driver for BCM283X SoCs
504 that supports automatic disable, so that it only gets used when
505 the UART is actually muxed.
507 config BCM6345_SERIAL
508 bool "Support for BCM6345 UART"
509 depends on DM_SERIAL && ARCH_BMIPS
511 Select this to enable UART on BCM6345 SoCs.
513 config BCM6858_SERIAL
514 bool "Support for BCM6858 UART"
515 depends on DM_SERIAL && ARCH_BCM6858
517 Select this to enable UART on BCM6358 SoCs.
519 config FSL_LINFLEXUART
520 bool "Freescale Linflex UART support"
523 Select this to enable the Linflex serial module found on some
524 NXP SoCs like S32V234.
527 bool "Freescale LPUART support"
529 Select this to enable a Low Power UART for Freescale VF610 and
530 QorIQ Layerscape devices.
532 config MVEBU_A3700_UART
533 bool "UART support for Armada 3700"
536 Choose this option to add support for UART driver on the Marvell
537 Armada 3700 SoC. The base address is configured via DT.
540 bool "IMX serial port support"
541 depends on MX5 || MX6
543 If you have a machine based on a Motorola IMX CPU you
544 can enable its onboard serial port by enabling this option.
546 config NULLDEV_SERIAL
547 bool "Null serial device"
549 Select this to enable null serial device support. A null serial
550 device merely acts as a placeholder for a serial device and does
551 nothing for all it's operation.
554 bool "Support for Microchip PIC32 on-chip UART"
555 depends on DM_SERIAL && MACH_PIC32
558 Support for the UART found on Microchip PIC32 SoC's.
561 bool "NS16550 UART or compatible"
563 Support NS16550 UART or compatible. This can be enabled in the
564 device tree with the correct input clock frequency. If the input
565 clock frequency is not defined in the device tree, the macro
566 CONFIG_SYS_NS16550_CLK defined in a legacy board header file will
567 be used. It can be a constant or a function to get clock, eg,
570 config INTEL_MID_SERIAL
571 bool "Intel MID platform UART support"
572 depends on DM_SERIAL && OF_CONTROL
576 Select this to enable a UART for Intel MID platforms.
577 This uses the ns16550 driver as a library.
580 bool "ARM PL010 driver"
581 depends on !DM_SERIAL
583 Select this to enable a UART for platforms using PL010.
586 bool "ARM PL011 driver"
587 depends on !DM_SERIAL
589 Select this to enable a UART for platforms using PL011.
592 bool "ARM PL010 and PL011 driver"
595 Select this to enable a UART for platforms using PL010 or PL011.
597 config ROCKCHIP_SERIAL
598 bool "Rockchip on-chip UART support"
599 depends on DM_SERIAL && SPL_OF_PLATDATA
601 Select this to enable a debug UART for Rockchip devices when using
602 CONFIG_SPL_OF_PLATDATA (i.e. a compiled-in device tree replacemenmt).
603 This uses the ns16550 driver, converting the platdata from of-platdata
604 to the ns16550 format.
606 config SANDBOX_SERIAL
607 bool "Sandbox UART support"
610 Select this to enable a seral UART for sandbox. This is required to
611 operate correctly, otherwise you will see no serial output from
612 sandbox. The emulated UART will display to the console and console
613 input will be fed into the UART. This allows you to interact with
616 The operation of the console is controlled by the -t command-line
617 flag. In raw mode, U-Boot sees all characters from the terminal
618 before they are processed, including Ctrl-C. In cooked mode, Ctrl-C
619 is processed by the terminal, and terminates U-Boot. Valid options
622 -t raw-with-sigs Raw mode, Ctrl-C will terminate U-Boot
623 -t raw Raw mode, Ctrl-C is processed by U-Boot
624 -t cooked Cooked mode, Ctrl-C terminates
627 bool "Renesas SCIF UART support"
628 depends on SH || ARCH_RMOBILE
630 Select this to enable Renesas SCIF UART. To operate serial ports
631 on systems with RCar or SH SoCs, say Y to this option. If unsure,
634 config UNIPHIER_SERIAL
635 bool "Support for UniPhier on-chip UART"
636 depends on ARCH_UNIPHIER
639 If you have a UniPhier based board and want to use the on-chip
640 serial ports, say Y to this option. If unsure, say N.
642 config XILINX_UARTLITE
643 bool "Xilinx Uarlite support"
644 depends on DM_SERIAL && (MICROBLAZE || ARCH_ZYNQ || ARCH_ZYNQMP || 4xx)
646 If you have a Xilinx based board and want to use the uartlite
647 serial ports, say Y to this option. If unsure, say N.
650 bool "Support for Amlogic Meson UART"
651 depends on DM_SERIAL && ARCH_MESON
653 If you have an Amlogic Meson based board and want to use the on-chip
654 serial ports, say Y to this option. If unsure, say N.
657 bool "Qualcomm on-chip UART"
660 Support Data Mover UART used on Qualcomm Snapdragon SoCs.
661 It should support all Qualcomm devices with UARTDM version 1.4,
662 for example APQ8016 and MSM8916.
663 Single baudrate is supported in current implementation (115200).
666 bool "Support for OMAP specific UART"
668 default y if (ARCH_OMAP2PLUS || ARCH_K3)
671 If you have an TI based SoC and want to use the on-chip serial
672 port, say Y to this option. If unsure say N.
675 bool "Actions Semi OWL UART"
676 depends on DM_SERIAL && ARCH_OWL
678 If you have a Actions Semi OWL based board and want to use the on-chip
679 serial port, say Y to this option. If unsure, say N.
680 Single baudrate is supported in current implementation (115200).
683 bool "PXA serial port support"
685 If you have a machine based on a Marvell XScale PXA2xx CPU you
686 can enable its onboard serial ports by enabling this option.
688 config STI_ASC_SERIAL
689 bool "STMicroelectronics on-chip UART"
690 depends on DM_SERIAL && ARCH_STI
692 Select this to enable Asynchronous Serial Controller available
693 on STiH410 SoC. This is a basic implementation, it supports
694 following baudrate 9600, 19200, 38400, 57600 and 115200.
697 bool "STMicroelectronics STM32 SoCs on-chip UART"
698 depends on DM_SERIAL && (STM32F4 || STM32F7 || STM32H7 || ARCH_STM32MP)
700 If you have a machine based on a STM32 F4, F7, H7 or MP1 SOC
701 you can enable its onboard serial ports, say Y to this option.
705 bool "Cadence (Xilinx Zynq) UART support"
706 depends on DM_SERIAL && (MICROBLAZE || ARCH_ZYNQ || ARCH_ZYNQMP || ARCH_ZYNQMP_R5)
708 This driver supports the Cadence UART. It is found e.g. in Xilinx
712 bool "MediaTek High-speed UART support"
715 Select this to enable UART support for MediaTek High-speed UART
716 devices. This driver uses driver model and requires a device
717 tree binding to operate.
718 The High-speed UART is compatible with the ns16550a UART and have
719 its own high-speed registers.
722 bool "Console driver for MPC8XX"
727 prompt "Console port"
728 default 8xx_CONS_SMC1
729 depends on MPC8XX_CONS
731 Depending on board, select one serial port
732 (CONFIG_8xx_CONS_SMC1 or CONFIG_8xx_CONS_SMC2)
742 config SYS_SMC_RXBUFLEN
743 int "Console Rx buffer length"
744 depends on MPC8XX_CONS
747 With CONFIG_SYS_SMC_RXBUFLEN it is possible to define
748 the maximum receive buffer length for the SMC.
749 This option is actual only for 8xx possible.
750 If using CONFIG_SYS_SMC_RXBUFLEN also CONFIG_SYS_MAXIDLE
751 must be defined, to setup the maximum idle timeout for
755 int "maximum idle timeout"
756 depends on MPC8XX_CONS
759 config SYS_BRGCLK_PRESCALE
760 int "BRG Clock Prescale"
761 depends on MPC8XX_CONS
766 depends on MPC8XX_CONS
771 depends on MPC8XX_CONS