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 # Logic to allow us to use the imply keyword to set what the default port
57 # should be. The default is otherwise 1.
77 int "UART used for console"
78 depends on SPECIFY_CONSOLE_INDEX
80 default 0 if CONS_INDEX_0
81 default 2 if CONS_INDEX_2
82 default 3 if CONS_INDEX_3
83 default 4 if CONS_INDEX_4
84 default 5 if CONS_INDEX_5
85 default 6 if CONS_INDEX_6
88 Set this to match the UART number of the serial console.
91 bool "Enable Driver Model for serial drivers"
94 Enable driver model for serial. This replaces
95 drivers/serial/serial.c with the serial uclass, which
96 implements serial_putc() etc. The uclass interface is
97 defined in include/serial.h.
99 config SERIAL_RX_BUFFER
100 bool "Enable RX buffer for serial input"
103 Enable RX buffer support for the serial driver. This enables
104 pasting longer strings, even when the RX FIFO of the UART is
105 not big enough (e.g. 16 bytes on the normal NS16550).
107 config SERIAL_RX_BUFFER_SIZE
109 depends on SERIAL_RX_BUFFER
112 The size of the RX buffer (needs to be power of 2)
114 config SERIAL_SEARCH_ALL
115 bool "Search for serial devices after default one failed"
118 The serial subsystem only searches for a single serial device
119 that was instantiated, but does not check whether it was probed
120 correctly. With this option set, we make successful probing
121 mandatory and search for fallback serial devices if the default
122 device does not work.
127 bool "Enable Driver Model for serial drivers in SPL"
128 depends on DM_SERIAL && SPL_DM
131 Enable driver model for serial in SPL. This replaces
132 drivers/serial/serial.c with the serial uclass, which
133 implements serial_putc() etc. The uclass interface is
134 defined in include/serial.h.
137 bool "Enable Driver Model for serial drivers in TPL"
139 default y if TPL && DM_SERIAL
141 Enable driver model for serial in TPL. 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 an early debug UART for debugging"
149 The debug UART is intended for use very early in U-Boot to debug
150 problems when an ICE or other debug mechanism is not available.
152 To use it you should:
153 - Make sure your UART supports this interface
154 - Enable CONFIG_DEBUG_UART
155 - Enable the CONFIG for your UART to tell it to provide this interface
156 (e.g. CONFIG_DEBUG_UART_NS16550)
157 - Define the required settings as needed (see below)
158 - Call debug_uart_init() before use
159 - Call debug_uart_putc() to output a character
161 Depending on your platform it may be possible to use this UART before
162 a stack is available.
164 If your UART does not support this interface you can probably add
165 support quite easily. Remember that you cannot use driver model and
166 it is preferred to use no stack.
168 You must not use this UART once driver model is working and the
169 serial drivers are up and running (done in serial_init()). Otherwise
170 the drivers may conflict and you will get strange output.
173 prompt "Select which UART will provide the debug UART"
174 depends on DEBUG_UART
175 default DEBUG_UART_NS16550
177 config DEBUG_UART_ALTERA_JTAGUART
178 bool "Altera JTAG UART"
180 Select this to enable a debug UART using the altera_jtag_uart driver.
181 You will need to provide parameters to make this work. The driver will
182 be available until the real driver model serial is running.
184 config DEBUG_UART_ALTERA_UART
187 Select this to enable a debug UART using the altera_uart driver.
188 You will need to provide parameters to make this work. The driver will
189 be available until the real driver model serial is running.
191 config DEBUG_UART_AR933X
192 bool "QCA/Atheros ar933x"
193 depends on AR933X_UART
195 Select this to enable a debug UART using the ar933x uart driver.
196 You will need to provide parameters to make this work. The
197 driver will be available until the real driver model serial is
200 config DEBUG_UART_ATMEL
203 Select this to enable a debug UART using the atmel usart driver. You
204 will need to provide parameters to make this work. The driver will
205 be available until the real driver-model serial is running.
207 config DEBUG_UART_BCM6345
209 depends on BCM6345_SERIAL
211 Select this to enable a debug UART on BCM6345 SoCs. You
212 will need to provide parameters to make this work. The driver will
213 be available until the real driver model serial is running.
215 config DEBUG_UART_NS16550
218 Select this to enable a debug UART using the ns16550 driver. You
219 will need to provide parameters to make this work. The driver will
220 be available until the real driver model serial is running.
222 config DEBUG_EFI_CONSOLE
226 Select this to enable a debug console which calls back to EFI to
227 output to the console. This can be useful for early debugging of
228 U-Boot when running on top of EFI (Extensive Firmware Interface).
229 This is a type of BIOS used by PCs.
231 config DEBUG_UART_S5P
234 Select this to enable a debug UART using the serial_s5p driver. You
235 will need to provide parameters to make this work. The driver will
236 be available until the real driver-model serial is running.
238 config DEBUG_UART_MESON
240 depends on MESON_SERIAL
242 Select this to enable a debug UART using the serial_meson driver. You
243 will need to provide parameters to make this work. The driver will
244 be available until the real driver-model serial is running.
246 config DEBUG_UART_UARTLITE
247 bool "Xilinx Uartlite"
249 Select this to enable a debug UART using the serial_uartlite driver.
250 You will need to provide parameters to make this work. The driver will
251 be available until the real driver-model serial is running.
253 config DEBUG_UART_ARM_DCC
256 Select this to enable a debug UART using the ARM JTAG DCC port.
257 The DCC port can be used for very early debugging and doesn't require
258 any additional setting like address/baudrate/clock. On systems without
259 any serial interface this is the easiest way how to get console.
260 Every ARM core has own DCC port which is the part of debug interface.
261 This port is available at least on ARMv6, ARMv7, ARMv8 and XScale
264 config DEBUG_MVEBU_A3700_UART
265 bool "Marvell Armada 3700"
267 Select this to enable a debug UART using the serial_mvebu driver. You
268 will need to provide parameters to make this work. The driver will
269 be available until the real driver-model serial is running.
271 config DEBUG_UART_ZYNQ
274 Select this to enable a debug UART using the serial_zynq driver. You
275 will need to provide parameters to make this work. The driver will
276 be available until the real driver-model serial is running.
278 config DEBUG_UART_APBUART
280 bool "Gaisler APBUART"
282 Select this to enable a debug UART using the serial_leon3 driver. You
283 will need to provide parameters to make this work. The driver will
284 be available until the real driver model serial is running.
286 config DEBUG_UART_PL010
289 Select this to enable a debug UART using the pl01x driver with the
290 PL010 UART type. You will need to provide parameters to make this
291 work. The driver will be available until the real driver model
294 config DEBUG_UART_PL011
297 Select this to enable a debug UART using the pl01x driver with the
298 PL011 UART type. You will need to provide parameters to make this
299 work. The driver will be available until the real driver model
302 config DEBUG_UART_PIC32
303 bool "Microchip PIC32"
304 depends on PIC32_SERIAL
306 Select this to enable a debug UART using the serial_pic32 driver. You
307 will need to provide parameters to make this work. The driver will
308 be available until the real driver model serial is running.
310 config DEBUG_UART_MXC
311 bool "IMX Serial port"
314 Select this to enable a debug UART using the serial_mxc driver. You
315 will need to provide parameters to make this work. The driver will
316 be available until the real driver model serial is running.
318 config DEBUG_UART_UNIPHIER
319 bool "UniPhier on-chip UART"
320 depends on ARCH_UNIPHIER
322 Select this to enable a debug UART using the UniPhier on-chip UART.
323 You will need to provide DEBUG_UART_BASE to make this work. The
324 driver will be available until the real driver-model serial is
327 config DEBUG_UART_OMAP
330 Select this to enable a debug UART using the omap ns16550 driver.
331 You will need to provide parameters to make this work. The driver
332 will be available until the real driver model serial is running.
336 config DEBUG_UART_BASE
337 hex "Base address of UART"
338 depends on DEBUG_UART
340 This is the base address of your UART for memory-mapped UARTs.
342 A default should be provided by your board, but if not you will need
343 to use the correct value here.
345 config DEBUG_UART_CLOCK
346 int "UART input clock"
347 depends on DEBUG_UART
349 The UART input clock determines the speed of the internal UART
350 circuitry. The baud rate is derived from this by dividing the input
353 A default should be provided by your board, but if not you will need
354 to use the correct value here.
356 config DEBUG_UART_SHIFT
357 int "UART register shift"
358 depends on DEBUG_UART
359 default 0 if DEBUG_UART
361 Some UARTs (notably ns16550) support different register layouts
362 where the registers are spaced either as bytes, words or some other
363 value. Use this value to specify the shift to use, where 0=byte
364 registers, 2=32-bit word registers, etc.
366 config DEBUG_UART_BOARD_INIT
367 bool "Enable board-specific debug UART init"
368 depends on DEBUG_UART
370 Some boards need to set things up before the debug UART can be used.
371 On these boards a call to debug_uart_init() is insufficient. When
372 this option is enabled, the function board_debug_uart_init() will
373 be called when debug_uart_init() is called. You can put any code
374 here that is needed to set up the UART ready for use, such as set
375 pin multiplexing or enable clocks.
377 config DEBUG_UART_ANNOUNCE
378 bool "Show a message when the debug UART starts up"
379 depends on DEBUG_UART
381 Enable this option to show a message when the debug UART is ready
382 for use. You will see a message like "<debug_uart> " as soon as
383 U-Boot has the UART ready for use (i.e. your code calls
384 debug_uart_init()). This can be useful just as a check that
385 everything is working.
387 config DEBUG_UART_SKIP_INIT
388 bool "Skip UART initialization"
390 Select this if the UART you want to use for debug output is already
391 initialized by the time U-Boot starts its execution.
393 config ALTERA_JTAG_UART
394 bool "Altera JTAG UART support"
397 Select this to enable an JTAG UART for Altera devices.The JTAG UART
398 core implements a method to communicate serial character streams
399 between a host PC and a Qsys system on an Altera FPGA. Please find
400 details on the "Embedded Peripherals IP User Guide" of Altera.
402 config ALTERA_JTAG_UART_BYPASS
403 bool "Bypass output when no connection"
404 depends on ALTERA_JTAG_UART
406 Bypass console output and keep going even if there is no JTAG
407 terminal connection with the host. The console output will resume
408 once the JTAG terminal is connected. Without the bypass, the console
409 output will wait forever until a JTAG terminal is connected. If you
413 bool "Altera UART support"
416 Select this to enable an UART for Altera devices. Please find
417 details on the "Embedded Peripherals IP User Guide" of Altera.
420 bool "QCA/Atheros ar933x UART support"
421 depends on DM_SERIAL && SOC_AR933X
423 Select this to enable UART support for QCA/Atheros ar933x
424 devices. This driver uses driver model and requires a device
425 tree binding to operate, please refer to the document at
426 doc/device-tree-bindings/serial/qca,ar9330-uart.txt.
429 bool "Atmel USART support"
431 Select this to enable USART support for Atmel SoCs. It can be
432 configured in the device tree, and input clock frequency can
433 be got from the clk node.
435 config BCM283X_MU_SERIAL
436 bool "Support for BCM283x Mini-UART"
437 depends on DM_SERIAL && ARCH_BCM283X
440 Select this to enable Mini-UART support on BCM283X family of SoCs.
442 config BCM283X_PL011_SERIAL
443 bool "Support for BCM283x PL011 UART"
444 depends on PL01X_SERIAL && ARCH_BCM283X
447 Select this to enable an overriding PL011 driver for BCM283X SoCs
448 that supports automatic disable, so that it only gets used when
449 the UART is actually muxed.
451 config BCM6345_SERIAL
452 bool "Support for BCM6345 UART"
453 depends on DM_SERIAL && ARCH_BMIPS
455 Select this to enable UART on BCM6345 SoCs.
458 bool "Freescale LPUART support"
460 Select this to enable a Low Power UART for Freescale VF610 and
461 QorIQ Layerscape devices.
463 config MVEBU_A3700_UART
464 bool "UART support for Armada 3700"
467 Choose this option to add support for UART driver on the Marvell
468 Armada 3700 SoC. The base address is configured via DT.
471 bool "IMX serial port support"
472 depends on MX5 || MX6
474 If you have a machine based on a Motorola IMX CPU you
475 can enable its onboard serial port by enabling this option.
477 config NULLDEV_SERIAL
478 bool "Null serial device"
480 Select this to enable null serial device support. A null serial
481 device merely acts as a placeholder for a serial device and does
482 nothing for all it's operation.
485 bool "Support for Microchip PIC32 on-chip UART"
486 depends on DM_SERIAL && MACH_PIC32
489 Support for the UART found on Microchip PIC32 SoC's.
492 bool "NS16550 UART or compatible"
494 Support NS16550 UART or compatible. This can be enabled in the
495 device tree with the correct input clock frequency. If the input
496 clock frequency is not defined in the device tree, the macro
497 CONFIG_SYS_NS16550_CLK defined in a legacy board header file will
498 be used. It can be a constant or a function to get clock, eg,
501 config INTEL_MID_SERIAL
502 bool "Intel MID platform UART support"
503 depends on DM_SERIAL && OF_CONTROL
507 Select this to enable a UART for Intel MID platforms.
508 This uses the ns16550 driver as a library.
511 bool "ARM PL010 driver"
512 depends on !DM_SERIAL
514 Select this to enable a UART for platforms using PL010.
517 bool "ARM PL011 driver"
518 depends on !DM_SERIAL
520 Select this to enable a UART for platforms using PL011.
523 bool "ARM PL010 and PL011 driver"
526 Select this to enable a UART for platforms using PL010 or PL011.
528 config ROCKCHIP_SERIAL
529 bool "Rockchip on-chip UART support"
530 depends on DM_SERIAL && SPL_OF_PLATDATA
532 Select this to enable a debug UART for Rockchip devices when using
533 CONFIG_SPL_OF_PLATDATA (i.e. a compiled-in device tree replacemenmt).
534 This uses the ns16550 driver, converting the platdata from of-platdata
535 to the ns16550 format.
537 config SANDBOX_SERIAL
538 bool "Sandbox UART support"
541 Select this to enable a seral UART for sandbox. This is required to
542 operate correctly, otherwise you will see no serial output from
543 sandbox. The emulated UART will display to the console and console
544 input will be fed into the UART. This allows you to interact with
547 The operation of the console is controlled by the -t command-line
548 flag. In raw mode, U-Boot sees all characters from the terminal
549 before they are processed, including Ctrl-C. In cooked mode, Ctrl-C
550 is processed by the terminal, and terminates U-Boot. Valid options
553 -t raw-with-sigs Raw mode, Ctrl-C will terminate U-Boot
554 -t raw Raw mode, Ctrl-C is processed by U-Boot
555 -t cooked Cooked mode, Ctrl-C terminates
558 bool "Renesas SCIF UART support"
559 depends on SH || ARCH_RMOBILE
561 Select this to enable Renesas SCIF UART. To operate serial ports
562 on systems with RCar or SH SoCs, say Y to this option. If unsure,
565 config UNIPHIER_SERIAL
566 bool "Support for UniPhier on-chip UART"
567 depends on ARCH_UNIPHIER
570 If you have a UniPhier based board and want to use the on-chip
571 serial ports, say Y to this option. If unsure, say N.
573 config XILINX_UARTLITE
574 bool "Xilinx Uarlite support"
575 depends on DM_SERIAL && (MICROBLAZE || ARCH_ZYNQ || ARCH_ZYNQMP || 4xx)
577 If you have a Xilinx based board and want to use the uartlite
578 serial ports, say Y to this option. If unsure, say N.
581 bool "Support for Amlogic Meson UART"
582 depends on DM_SERIAL && ARCH_MESON
584 If you have an Amlogic Meson based board and want to use the on-chip
585 serial ports, say Y to this option. If unsure, say N.
588 bool "Qualcomm on-chip UART"
591 Support Data Mover UART used on Qualcomm Snapdragon SoCs.
592 It should support all Qualcomm devices with UARTDM version 1.4,
593 for example APQ8016 and MSM8916.
594 Single baudrate is supported in current implementation (115200).
597 bool "PXA serial port support"
599 If you have a machine based on a Marvell XScale PXA2xx CPU you
600 can enable its onboard serial ports by enabling this option.
602 config STI_ASC_SERIAL
603 bool "STMicroelectronics on-chip UART"
604 depends on DM_SERIAL && ARCH_STI
606 Select this to enable Asynchronous Serial Controller available
607 on STiH410 SoC. This is a basic implementation, it supports
608 following baudrate 9600, 19200, 38400, 57600 and 115200.
611 bool "STMicroelectronics STM32 SoCs on-chip UART"
612 depends on DM_SERIAL && (STM32F4 || STM32F7 || STM32H7 || ARCH_STM32MP)
614 If you have a machine based on a STM32 F4, F7, H7 or MP1 SOC
615 you can enable its onboard serial ports, say Y to this option.
619 bool "Cadence (Xilinx Zynq) UART support"
620 depends on DM_SERIAL && (MICROBLAZE || ARCH_ZYNQ || ARCH_ZYNQMP)
622 This driver supports the Cadence UART. It is found e.g. in Xilinx
626 bool "Console driver for MPC8XX"
631 prompt "Console port"
632 default 8xx_CONS_SMC1
633 depends on MPC8XX_CONS
635 Depending on board, select one serial port
636 (CONFIG_8xx_CONS_SMC1 or CONFIG_8xx_CONS_SMC2)
646 config SYS_SMC_RXBUFLEN
647 int "Console Rx buffer length"
648 depends on MPC8XX_CONS
651 With CONFIG_SYS_SMC_RXBUFLEN it is possible to define
652 the maximum receive buffer length for the SMC.
653 This option is actual only for 8xx possible.
654 If using CONFIG_SYS_SMC_RXBUFLEN also CONFIG_SYS_MAXIDLE
655 must be defined, to setup the maximum idle timeout for
659 int "maximum idle timeout"
660 depends on MPC8XX_CONS
663 config SYS_BRGCLK_PRESCALE
664 int "BRG Clock Prescale"
665 depends on MPC8XX_CONS
670 depends on MPC8XX_CONS
675 depends on MPC8XX_CONS