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_SIFIVE
349 Select this to enable a debug UART using the serial_sifive driver. You
350 will need to provide parameters to make this work. The driver will
351 be available until the real driver-model serial is running.
353 config DEBUG_UART_STM32
354 bool "STMicroelectronics STM32"
355 depends on STM32_SERIAL
357 Select this to enable a debug UART using the serial_stm32 driver
358 You will need to provide parameters to make this work.
359 The driver will be available until the real driver model
362 config DEBUG_UART_UNIPHIER
363 bool "UniPhier on-chip UART"
364 depends on ARCH_UNIPHIER
366 Select this to enable a debug UART using the UniPhier on-chip UART.
367 You will need to provide DEBUG_UART_BASE to make this work. The
368 driver will be available until the real driver-model serial is
371 config DEBUG_UART_OMAP
374 Select this to enable a debug UART using the omap ns16550 driver.
375 You will need to provide parameters to make this work. The driver
376 will be available until the real driver model serial is running.
378 config DEBUG_UART_MTK
379 bool "MediaTek High-speed UART"
380 depends on MTK_SERIAL
382 Select this to enable a debug UART using the MediaTek High-speed
384 You will need to provide parameters to make this work. The
385 driver will be available until the real driver model serial is
390 config DEBUG_UART_BASE
391 hex "Base address of UART"
392 depends on DEBUG_UART
393 default 0 if DEBUG_UART_SANDBOX
395 This is the base address of your UART for memory-mapped UARTs.
397 A default should be provided by your board, but if not you will need
398 to use the correct value here.
400 config DEBUG_UART_CLOCK
401 int "UART input clock"
402 depends on DEBUG_UART
403 default 0 if DEBUG_UART_SANDBOX
405 The UART input clock determines the speed of the internal UART
406 circuitry. The baud rate is derived from this by dividing the input
409 A default should be provided by your board, but if not you will need
410 to use the correct value here.
412 config DEBUG_UART_SHIFT
413 int "UART register shift"
414 depends on DEBUG_UART
415 default 0 if DEBUG_UART
417 Some UARTs (notably ns16550) support different register layouts
418 where the registers are spaced either as bytes, words or some other
419 value. Use this value to specify the shift to use, where 0=byte
420 registers, 2=32-bit word registers, etc.
422 config DEBUG_UART_BOARD_INIT
423 bool "Enable board-specific debug UART init"
424 depends on DEBUG_UART
426 Some boards need to set things up before the debug UART can be used.
427 On these boards a call to debug_uart_init() is insufficient. When
428 this option is enabled, the function board_debug_uart_init() will
429 be called when debug_uart_init() is called. You can put any code
430 here that is needed to set up the UART ready for use, such as set
431 pin multiplexing or enable clocks.
433 config DEBUG_UART_ANNOUNCE
434 bool "Show a message when the debug UART starts up"
435 depends on DEBUG_UART
437 Enable this option to show a message when the debug UART is ready
438 for use. You will see a message like "<debug_uart> " as soon as
439 U-Boot has the UART ready for use (i.e. your code calls
440 debug_uart_init()). This can be useful just as a check that
441 everything is working.
443 config DEBUG_UART_SKIP_INIT
444 bool "Skip UART initialization"
446 Select this if the UART you want to use for debug output is already
447 initialized by the time U-Boot starts its execution.
449 config ALTERA_JTAG_UART
450 bool "Altera JTAG UART support"
453 Select this to enable an JTAG UART for Altera devices.The JTAG UART
454 core implements a method to communicate serial character streams
455 between a host PC and a Qsys system on an Altera FPGA. Please find
456 details on the "Embedded Peripherals IP User Guide" of Altera.
458 config ALTERA_JTAG_UART_BYPASS
459 bool "Bypass output when no connection"
460 depends on ALTERA_JTAG_UART
462 Bypass console output and keep going even if there is no JTAG
463 terminal connection with the host. The console output will resume
464 once the JTAG terminal is connected. Without the bypass, the console
465 output will wait forever until a JTAG terminal is connected. If you
469 bool "Altera UART support"
472 Select this to enable an UART for Altera devices. Please find
473 details on the "Embedded Peripherals IP User Guide" of Altera.
476 bool "QCA/Atheros ar933x UART support"
477 depends on DM_SERIAL && SOC_AR933X
479 Select this to enable UART support for QCA/Atheros ar933x
480 devices. This driver uses driver model and requires a device
481 tree binding to operate, please refer to the document at
482 doc/device-tree-bindings/serial/qca,ar9330-uart.txt.
485 bool "ARC UART support"
488 Select this to enable support for ARC UART now typically
489 only used in Synopsys DesignWare ARC simulators like nSIM.
492 bool "Atmel USART support"
494 Select this to enable USART support for Atmel SoCs. It can be
495 configured in the device tree, and input clock frequency can
496 be got from the clk node.
498 config BCM283X_MU_SERIAL
499 bool "Support for BCM283x Mini-UART"
500 depends on DM_SERIAL && ARCH_BCM283X
503 Select this to enable Mini-UART support on BCM283X family of SoCs.
505 config BCM283X_PL011_SERIAL
506 bool "Support for BCM283x PL011 UART"
507 depends on PL01X_SERIAL && ARCH_BCM283X
510 Select this to enable an overriding PL011 driver for BCM283X SoCs
511 that supports automatic disable, so that it only gets used when
512 the UART is actually muxed.
514 config BCM6345_SERIAL
515 bool "Support for BCM6345 UART"
518 Select this to enable UART on BCM6345 SoCs.
520 config FSL_LINFLEXUART
521 bool "Freescale Linflex UART support"
524 Select this to enable the Linflex serial module found on some
525 NXP SoCs like S32V234.
528 bool "Freescale LPUART support"
530 Select this to enable a Low Power UART for Freescale VF610 and
531 QorIQ Layerscape devices.
533 config MVEBU_A3700_UART
534 bool "UART support for Armada 3700"
537 Choose this option to add support for UART driver on the Marvell
538 Armada 3700 SoC. The base address is configured via DT.
541 bool "IMX serial port support"
542 depends on MX5 || MX6
544 If you have a machine based on a Motorola IMX CPU you
545 can enable its onboard serial port by enabling this option.
547 config NULLDEV_SERIAL
548 bool "Null serial device"
550 Select this to enable null serial device support. A null serial
551 device merely acts as a placeholder for a serial device and does
552 nothing for all it's operation.
555 bool "Support for Microchip PIC32 on-chip UART"
556 depends on DM_SERIAL && MACH_PIC32
559 Support for the UART found on Microchip PIC32 SoC's.
562 bool "NS16550 UART or compatible"
564 Support NS16550 UART or compatible. This can be enabled in the
565 device tree with the correct input clock frequency. If the input
566 clock frequency is not defined in the device tree, the macro
567 CONFIG_SYS_NS16550_CLK defined in a legacy board header file will
568 be used. It can be a constant or a function to get clock, eg,
571 config INTEL_MID_SERIAL
572 bool "Intel MID platform UART support"
573 depends on DM_SERIAL && OF_CONTROL
577 Select this to enable a UART for Intel MID platforms.
578 This uses the ns16550 driver as a library.
581 bool "ARM PL010 driver"
582 depends on !DM_SERIAL
584 Select this to enable a UART for platforms using PL010.
587 bool "ARM PL011 driver"
588 depends on !DM_SERIAL
590 Select this to enable a UART for platforms using PL011.
593 bool "ARM PL010 and PL011 driver"
596 Select this to enable a UART for platforms using PL010 or PL011.
598 config ROCKCHIP_SERIAL
599 bool "Rockchip on-chip UART support"
600 depends on DM_SERIAL && SPL_OF_PLATDATA
602 Select this to enable a debug UART for Rockchip devices when using
603 CONFIG_SPL_OF_PLATDATA (i.e. a compiled-in device tree replacemenmt).
604 This uses the ns16550 driver, converting the platdata from of-platdata
605 to the ns16550 format.
607 config SANDBOX_SERIAL
608 bool "Sandbox UART support"
611 Select this to enable a seral UART for sandbox. This is required to
612 operate correctly, otherwise you will see no serial output from
613 sandbox. The emulated UART will display to the console and console
614 input will be fed into the UART. This allows you to interact with
617 The operation of the console is controlled by the -t command-line
618 flag. In raw mode, U-Boot sees all characters from the terminal
619 before they are processed, including Ctrl-C. In cooked mode, Ctrl-C
620 is processed by the terminal, and terminates U-Boot. Valid options
623 -t raw-with-sigs Raw mode, Ctrl-C will terminate U-Boot
624 -t raw Raw mode, Ctrl-C is processed by U-Boot
625 -t cooked Cooked mode, Ctrl-C terminates
628 bool "Renesas SCIF UART support"
629 depends on SH || ARCH_RMOBILE
631 Select this to enable Renesas SCIF UART. To operate serial ports
632 on systems with RCar or SH SoCs, say Y to this option. If unsure,
635 config UNIPHIER_SERIAL
636 bool "Support for UniPhier on-chip UART"
637 depends on ARCH_UNIPHIER
640 If you have a UniPhier based board and want to use the on-chip
641 serial ports, say Y to this option. If unsure, say N.
643 config XILINX_UARTLITE
644 bool "Xilinx Uarlite support"
645 depends on DM_SERIAL && (MICROBLAZE || ARCH_ZYNQ || ARCH_ZYNQMP || 4xx)
647 If you have a Xilinx based board and want to use the uartlite
648 serial ports, say Y to this option. If unsure, say N.
651 bool "Support for Amlogic Meson UART"
652 depends on DM_SERIAL && ARCH_MESON
654 If you have an Amlogic Meson based board and want to use the on-chip
655 serial ports, say Y to this option. If unsure, say N.
658 bool "Qualcomm on-chip UART"
661 Support Data Mover UART used on Qualcomm Snapdragon SoCs.
662 It should support all Qualcomm devices with UARTDM version 1.4,
663 for example APQ8016 and MSM8916.
664 Single baudrate is supported in current implementation (115200).
667 bool "Support for OMAP specific UART"
669 default y if (ARCH_OMAP2PLUS || ARCH_K3)
672 If you have an TI based SoC and want to use the on-chip serial
673 port, say Y to this option. If unsure say N.
676 bool "Actions Semi OWL UART"
677 depends on DM_SERIAL && ARCH_OWL
679 If you have a Actions Semi OWL based board and want to use the on-chip
680 serial port, say Y to this option. If unsure, say N.
681 Single baudrate is supported in current implementation (115200).
684 bool "PXA serial port support"
686 If you have a machine based on a Marvell XScale PXA2xx CPU you
687 can enable its onboard serial ports by enabling this option.
690 bool "SiFive UART support"
693 This driver supports the SiFive UART. If unsure say N.
695 config STI_ASC_SERIAL
696 bool "STMicroelectronics on-chip UART"
697 depends on DM_SERIAL && ARCH_STI
699 Select this to enable Asynchronous Serial Controller available
700 on STiH410 SoC. This is a basic implementation, it supports
701 following baudrate 9600, 19200, 38400, 57600 and 115200.
704 bool "STMicroelectronics STM32 SoCs on-chip UART"
705 depends on DM_SERIAL && (STM32F4 || STM32F7 || STM32H7 || ARCH_STM32MP)
707 If you have a machine based on a STM32 F4, F7, H7 or MP1 SOC
708 you can enable its onboard serial ports, say Y to this option.
712 bool "Cadence (Xilinx Zynq) UART support"
713 depends on DM_SERIAL && (MICROBLAZE || ARCH_ZYNQ || ARCH_ZYNQMP || ARCH_ZYNQMP_R5)
715 This driver supports the Cadence UART. It is found e.g. in Xilinx
719 bool "MediaTek High-speed UART support"
722 Select this to enable UART support for MediaTek High-speed UART
723 devices. This driver uses driver model and requires a device
724 tree binding to operate.
725 The High-speed UART is compatible with the ns16550a UART and have
726 its own high-speed registers.
729 bool "Console driver for MPC8XX"
734 prompt "Console port"
735 default 8xx_CONS_SMC1
736 depends on MPC8XX_CONS
738 Depending on board, select one serial port
739 (CONFIG_8xx_CONS_SMC1 or CONFIG_8xx_CONS_SMC2)
749 config SYS_SMC_RXBUFLEN
750 int "Console Rx buffer length"
751 depends on MPC8XX_CONS
754 With CONFIG_SYS_SMC_RXBUFLEN it is possible to define
755 the maximum receive buffer length for the SMC.
756 This option is actual only for 8xx possible.
757 If using CONFIG_SYS_SMC_RXBUFLEN also CONFIG_SYS_MAXIDLE
758 must be defined, to setup the maximum idle timeout for
762 int "maximum idle timeout"
763 depends on MPC8XX_CONS
766 config SYS_BRGCLK_PRESCALE
767 int "BRG Clock Prescale"
768 depends on MPC8XX_CONS
773 depends on MPC8XX_CONS
778 depends on MPC8XX_CONS