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.
373 config DEBUG_UART_BASE
374 hex "Base address of UART"
375 depends on DEBUG_UART
376 default 0 if DEBUG_UART_SANDBOX
378 This is the base address of your UART for memory-mapped UARTs.
380 A default should be provided by your board, but if not you will need
381 to use the correct value here.
383 config DEBUG_UART_CLOCK
384 int "UART input clock"
385 depends on DEBUG_UART
386 default 0 if DEBUG_UART_SANDBOX
388 The UART input clock determines the speed of the internal UART
389 circuitry. The baud rate is derived from this by dividing the input
392 A default should be provided by your board, but if not you will need
393 to use the correct value here.
395 config DEBUG_UART_SHIFT
396 int "UART register shift"
397 depends on DEBUG_UART
398 default 0 if DEBUG_UART
400 Some UARTs (notably ns16550) support different register layouts
401 where the registers are spaced either as bytes, words or some other
402 value. Use this value to specify the shift to use, where 0=byte
403 registers, 2=32-bit word registers, etc.
405 config DEBUG_UART_BOARD_INIT
406 bool "Enable board-specific debug UART init"
407 depends on DEBUG_UART
409 Some boards need to set things up before the debug UART can be used.
410 On these boards a call to debug_uart_init() is insufficient. When
411 this option is enabled, the function board_debug_uart_init() will
412 be called when debug_uart_init() is called. You can put any code
413 here that is needed to set up the UART ready for use, such as set
414 pin multiplexing or enable clocks.
416 config DEBUG_UART_ANNOUNCE
417 bool "Show a message when the debug UART starts up"
418 depends on DEBUG_UART
420 Enable this option to show a message when the debug UART is ready
421 for use. You will see a message like "<debug_uart> " as soon as
422 U-Boot has the UART ready for use (i.e. your code calls
423 debug_uart_init()). This can be useful just as a check that
424 everything is working.
426 config DEBUG_UART_SKIP_INIT
427 bool "Skip UART initialization"
429 Select this if the UART you want to use for debug output is already
430 initialized by the time U-Boot starts its execution.
432 config ALTERA_JTAG_UART
433 bool "Altera JTAG UART support"
436 Select this to enable an JTAG UART for Altera devices.The JTAG UART
437 core implements a method to communicate serial character streams
438 between a host PC and a Qsys system on an Altera FPGA. Please find
439 details on the "Embedded Peripherals IP User Guide" of Altera.
441 config ALTERA_JTAG_UART_BYPASS
442 bool "Bypass output when no connection"
443 depends on ALTERA_JTAG_UART
445 Bypass console output and keep going even if there is no JTAG
446 terminal connection with the host. The console output will resume
447 once the JTAG terminal is connected. Without the bypass, the console
448 output will wait forever until a JTAG terminal is connected. If you
452 bool "Altera UART support"
455 Select this to enable an UART for Altera devices. Please find
456 details on the "Embedded Peripherals IP User Guide" of Altera.
459 bool "QCA/Atheros ar933x UART support"
460 depends on DM_SERIAL && SOC_AR933X
462 Select this to enable UART support for QCA/Atheros ar933x
463 devices. This driver uses driver model and requires a device
464 tree binding to operate, please refer to the document at
465 doc/device-tree-bindings/serial/qca,ar9330-uart.txt.
468 bool "ARC UART support"
471 Select this to enable support for ARC UART now typically
472 only used in Synopsys DesignWare ARC simulators like nSIM.
475 bool "Atmel USART support"
477 Select this to enable USART support for Atmel SoCs. It can be
478 configured in the device tree, and input clock frequency can
479 be got from the clk node.
481 config BCM283X_MU_SERIAL
482 bool "Support for BCM283x Mini-UART"
483 depends on DM_SERIAL && ARCH_BCM283X
486 Select this to enable Mini-UART support on BCM283X family of SoCs.
488 config BCM283X_PL011_SERIAL
489 bool "Support for BCM283x PL011 UART"
490 depends on PL01X_SERIAL && ARCH_BCM283X
493 Select this to enable an overriding PL011 driver for BCM283X SoCs
494 that supports automatic disable, so that it only gets used when
495 the UART is actually muxed.
497 config BCM6345_SERIAL
498 bool "Support for BCM6345 UART"
499 depends on DM_SERIAL && ARCH_BMIPS
501 Select this to enable UART on BCM6345 SoCs.
503 config FSL_LINFLEXUART
504 bool "Freescale Linflex UART support"
507 Select this to enable the Linflex serial module found on some
508 NXP SoCs like S32V234.
511 bool "Freescale LPUART support"
513 Select this to enable a Low Power UART for Freescale VF610 and
514 QorIQ Layerscape devices.
516 config MVEBU_A3700_UART
517 bool "UART support for Armada 3700"
520 Choose this option to add support for UART driver on the Marvell
521 Armada 3700 SoC. The base address is configured via DT.
524 bool "IMX serial port support"
525 depends on MX5 || MX6
527 If you have a machine based on a Motorola IMX CPU you
528 can enable its onboard serial port by enabling this option.
530 config NULLDEV_SERIAL
531 bool "Null serial device"
533 Select this to enable null serial device support. A null serial
534 device merely acts as a placeholder for a serial device and does
535 nothing for all it's operation.
538 bool "Support for Microchip PIC32 on-chip UART"
539 depends on DM_SERIAL && MACH_PIC32
542 Support for the UART found on Microchip PIC32 SoC's.
545 bool "NS16550 UART or compatible"
547 Support NS16550 UART or compatible. This can be enabled in the
548 device tree with the correct input clock frequency. If the input
549 clock frequency is not defined in the device tree, the macro
550 CONFIG_SYS_NS16550_CLK defined in a legacy board header file will
551 be used. It can be a constant or a function to get clock, eg,
554 config INTEL_MID_SERIAL
555 bool "Intel MID platform UART support"
556 depends on DM_SERIAL && OF_CONTROL
560 Select this to enable a UART for Intel MID platforms.
561 This uses the ns16550 driver as a library.
564 bool "ARM PL010 driver"
565 depends on !DM_SERIAL
567 Select this to enable a UART for platforms using PL010.
570 bool "ARM PL011 driver"
571 depends on !DM_SERIAL
573 Select this to enable a UART for platforms using PL011.
576 bool "ARM PL010 and PL011 driver"
579 Select this to enable a UART for platforms using PL010 or PL011.
581 config ROCKCHIP_SERIAL
582 bool "Rockchip on-chip UART support"
583 depends on DM_SERIAL && SPL_OF_PLATDATA
585 Select this to enable a debug UART for Rockchip devices when using
586 CONFIG_SPL_OF_PLATDATA (i.e. a compiled-in device tree replacemenmt).
587 This uses the ns16550 driver, converting the platdata from of-platdata
588 to the ns16550 format.
590 config SANDBOX_SERIAL
591 bool "Sandbox UART support"
594 Select this to enable a seral UART for sandbox. This is required to
595 operate correctly, otherwise you will see no serial output from
596 sandbox. The emulated UART will display to the console and console
597 input will be fed into the UART. This allows you to interact with
600 The operation of the console is controlled by the -t command-line
601 flag. In raw mode, U-Boot sees all characters from the terminal
602 before they are processed, including Ctrl-C. In cooked mode, Ctrl-C
603 is processed by the terminal, and terminates U-Boot. Valid options
606 -t raw-with-sigs Raw mode, Ctrl-C will terminate U-Boot
607 -t raw Raw mode, Ctrl-C is processed by U-Boot
608 -t cooked Cooked mode, Ctrl-C terminates
611 bool "Renesas SCIF UART support"
612 depends on SH || ARCH_RMOBILE
614 Select this to enable Renesas SCIF UART. To operate serial ports
615 on systems with RCar or SH SoCs, say Y to this option. If unsure,
618 config UNIPHIER_SERIAL
619 bool "Support for UniPhier on-chip UART"
620 depends on ARCH_UNIPHIER
623 If you have a UniPhier based board and want to use the on-chip
624 serial ports, say Y to this option. If unsure, say N.
626 config XILINX_UARTLITE
627 bool "Xilinx Uarlite support"
628 depends on DM_SERIAL && (MICROBLAZE || ARCH_ZYNQ || ARCH_ZYNQMP || 4xx)
630 If you have a Xilinx based board and want to use the uartlite
631 serial ports, say Y to this option. If unsure, say N.
634 bool "Support for Amlogic Meson UART"
635 depends on DM_SERIAL && ARCH_MESON
637 If you have an Amlogic Meson based board and want to use the on-chip
638 serial ports, say Y to this option. If unsure, say N.
641 bool "Qualcomm on-chip UART"
644 Support Data Mover UART used on Qualcomm Snapdragon SoCs.
645 It should support all Qualcomm devices with UARTDM version 1.4,
646 for example APQ8016 and MSM8916.
647 Single baudrate is supported in current implementation (115200).
650 bool "Support for OMAP specific UART"
652 default y if (ARCH_OMAP2PLUS || ARCH_K3)
655 If you have an TI based SoC and want to use the on-chip serial
656 port, say Y to this option. If unsure say N.
659 bool "Actions Semi OWL UART"
660 depends on DM_SERIAL && ARCH_OWL
662 If you have a Actions Semi OWL based board and want to use the on-chip
663 serial port, say Y to this option. If unsure, say N.
664 Single baudrate is supported in current implementation (115200).
667 bool "PXA serial port support"
669 If you have a machine based on a Marvell XScale PXA2xx CPU you
670 can enable its onboard serial ports by enabling this option.
672 config STI_ASC_SERIAL
673 bool "STMicroelectronics on-chip UART"
674 depends on DM_SERIAL && ARCH_STI
676 Select this to enable Asynchronous Serial Controller available
677 on STiH410 SoC. This is a basic implementation, it supports
678 following baudrate 9600, 19200, 38400, 57600 and 115200.
681 bool "STMicroelectronics STM32 SoCs on-chip UART"
682 depends on DM_SERIAL && (STM32F4 || STM32F7 || STM32H7 || ARCH_STM32MP)
684 If you have a machine based on a STM32 F4, F7, H7 or MP1 SOC
685 you can enable its onboard serial ports, say Y to this option.
689 bool "Cadence (Xilinx Zynq) UART support"
690 depends on DM_SERIAL && (MICROBLAZE || ARCH_ZYNQ || ARCH_ZYNQMP || ARCH_ZYNQMP_R5)
692 This driver supports the Cadence UART. It is found e.g. in Xilinx
696 bool "Console driver for MPC8XX"
701 prompt "Console port"
702 default 8xx_CONS_SMC1
703 depends on MPC8XX_CONS
705 Depending on board, select one serial port
706 (CONFIG_8xx_CONS_SMC1 or CONFIG_8xx_CONS_SMC2)
716 config SYS_SMC_RXBUFLEN
717 int "Console Rx buffer length"
718 depends on MPC8XX_CONS
721 With CONFIG_SYS_SMC_RXBUFLEN it is possible to define
722 the maximum receive buffer length for the SMC.
723 This option is actual only for 8xx possible.
724 If using CONFIG_SYS_SMC_RXBUFLEN also CONFIG_SYS_MAXIDLE
725 must be defined, to setup the maximum idle timeout for
729 int "maximum idle timeout"
730 depends on MPC8XX_CONS
733 config SYS_BRGCLK_PRESCALE
734 int "BRG Clock Prescale"
735 depends on MPC8XX_CONS
740 depends on MPC8XX_CONS
745 depends on MPC8XX_CONS