1 // SPDX-License-Identifier: GPL-2.0+
4 * Paolo Scaffardi, AIRVENT SAM s.p.a - RIMINI(ITALY), arsenio@tin.it
9 #include <debug_uart.h>
17 #include <stdio_dev.h>
19 #include <environment.h>
22 DECLARE_GLOBAL_DATA_PTR
;
24 static int on_console(const char *name
, const char *value
, enum env_op op
,
29 /* Check for console redirection */
30 if (strcmp(name
, "stdin") == 0)
32 else if (strcmp(name
, "stdout") == 0)
34 else if (strcmp(name
, "stderr") == 0)
37 /* if not actually setting a console variable, we don't care */
38 if (console
== -1 || (gd
->flags
& GD_FLG_DEVINIT
) == 0)
43 case env_op_overwrite
:
45 #if CONFIG_IS_ENABLED(CONSOLE_MUX)
46 if (iomux_doenv(console
, value
))
49 /* Try assigning specified device */
50 if (console_assign(console
, value
) < 0)
56 if ((flags
& H_FORCE
) == 0)
57 printf("Can't delete \"%s\"\n", name
);
64 U_BOOT_ENV_CALLBACK(console
, on_console
);
66 #ifdef CONFIG_SILENT_CONSOLE
67 static int on_silent(const char *name
, const char *value
, enum env_op op
,
70 #if !CONFIG_IS_ENABLED(SILENT_CONSOLE_UPDATE_ON_SET)
71 if (flags
& H_INTERACTIVE
)
74 #if !CONFIG_IS_ENABLED(SILENT_CONSOLE_UPDATE_ON_RELOC)
75 if ((flags
& H_INTERACTIVE
) == 0)
80 gd
->flags
|= GD_FLG_SILENT
;
82 gd
->flags
&= ~GD_FLG_SILENT
;
86 U_BOOT_ENV_CALLBACK(silent
, on_silent
);
89 #if CONFIG_IS_ENABLED(SYS_CONSOLE_IS_IN_ENV)
91 * if overwrite_console returns 1, the stdin, stderr and stdout
92 * are switched to the serial port, else the settings in the
93 * environment are used
95 #ifdef CONFIG_SYS_CONSOLE_OVERWRITE_ROUTINE
96 extern int overwrite_console(void);
97 #define OVERWRITE_CONSOLE overwrite_console()
99 #define OVERWRITE_CONSOLE 0
100 #endif /* CONFIG_SYS_CONSOLE_OVERWRITE_ROUTINE */
102 #endif /* CONFIG_IS_ENABLED(SYS_CONSOLE_IS_IN_ENV) */
104 static int console_setfile(int file
, struct stdio_dev
* dev
)
115 /* Start new device */
117 error
= dev
->start(dev
);
118 /* If it's not started dont use it */
123 /* Assign the new device (leaving the existing one started) */
124 stdio_devices
[file
] = dev
;
127 * Update monitor functions
128 * (to use the console stuff by other applications)
138 gd
->jt
->printf
= printf
;
143 default: /* Invalid file ID */
150 * console_dev_is_serial() - Check if a stdio device is a serial device
152 * @sdev: Device to check
153 * @return true if this device is in the serial uclass (or for pre-driver-model,
154 * whether it is called "serial".
156 static bool console_dev_is_serial(struct stdio_dev
*sdev
)
160 #ifdef CONFIG_DM_SERIAL
161 if (sdev
->flags
& DEV_FLAGS_DM
) {
162 struct udevice
*dev
= sdev
->priv
;
164 is_serial
= device_get_uclass_id(dev
) == UCLASS_SERIAL
;
167 is_serial
= !strcmp(sdev
->name
, "serial");
172 #if CONFIG_IS_ENABLED(CONSOLE_MUX)
173 /** Console I/O multiplexing *******************************************/
175 static struct stdio_dev
*tstcdev
;
176 struct stdio_dev
**console_devices
[MAX_FILES
];
177 int cd_count
[MAX_FILES
];
180 * This depends on tstc() always being called before getc().
181 * This is guaranteed to be true because this routine is called
182 * only from fgetc() which assures it.
183 * No attempt is made to demultiplex multiple input sources.
185 static int console_getc(int file
)
189 /* This is never called with testcdev == NULL */
190 ret
= tstcdev
->getc(tstcdev
);
195 static int console_tstc(int file
)
198 struct stdio_dev
*dev
;
201 prev
= disable_ctrlc(1);
202 for (i
= 0; i
< cd_count
[file
]; i
++) {
203 dev
= console_devices
[file
][i
];
204 if (dev
->tstc
!= NULL
) {
205 ret
= dev
->tstc(dev
);
218 static void console_putc(int file
, const char c
)
221 struct stdio_dev
*dev
;
223 for (i
= 0; i
< cd_count
[file
]; i
++) {
224 dev
= console_devices
[file
][i
];
225 if (dev
->putc
!= NULL
)
230 static void console_puts_noserial(int file
, const char *s
)
233 struct stdio_dev
*dev
;
235 for (i
= 0; i
< cd_count
[file
]; i
++) {
236 dev
= console_devices
[file
][i
];
237 if (dev
->puts
!= NULL
&& !console_dev_is_serial(dev
))
242 static void console_puts(int file
, const char *s
)
245 struct stdio_dev
*dev
;
247 for (i
= 0; i
< cd_count
[file
]; i
++) {
248 dev
= console_devices
[file
][i
];
249 if (dev
->puts
!= NULL
)
254 static inline void console_doenv(int file
, struct stdio_dev
*dev
)
256 iomux_doenv(file
, dev
->name
);
259 static inline int console_getc(int file
)
261 return stdio_devices
[file
]->getc(stdio_devices
[file
]);
264 static inline int console_tstc(int file
)
266 return stdio_devices
[file
]->tstc(stdio_devices
[file
]);
269 static inline void console_putc(int file
, const char c
)
271 stdio_devices
[file
]->putc(stdio_devices
[file
], c
);
274 static inline void console_puts_noserial(int file
, const char *s
)
276 if (!console_dev_is_serial(stdio_devices
[file
]))
277 stdio_devices
[file
]->puts(stdio_devices
[file
], s
);
280 static inline void console_puts(int file
, const char *s
)
282 stdio_devices
[file
]->puts(stdio_devices
[file
], s
);
285 static inline void console_doenv(int file
, struct stdio_dev
*dev
)
287 console_setfile(file
, dev
);
289 #endif /* CONIFIG_IS_ENABLED(CONSOLE_MUX) */
291 /** U-Boot INITIAL CONSOLE-NOT COMPATIBLE FUNCTIONS *************************/
293 int serial_printf(const char *fmt
, ...)
297 char printbuffer
[CONFIG_SYS_PBSIZE
];
301 /* For this to work, printbuffer must be larger than
302 * anything we ever want to print.
304 i
= vscnprintf(printbuffer
, sizeof(printbuffer
), fmt
, args
);
307 serial_puts(printbuffer
);
313 if (file
< MAX_FILES
) {
315 * Effectively poll for input wherever it may be available.
319 #if CONFIG_IS_ENABLED(CONSOLE_MUX)
321 * Upper layer may have already called tstc() so
322 * check for that first.
325 return console_getc(file
);
328 if (console_tstc(file
))
329 return console_getc(file
);
331 #ifdef CONFIG_WATCHDOG
333 * If the watchdog must be rate-limited then it should
334 * already be handled in board-specific code.
346 if (file
< MAX_FILES
)
347 return console_tstc(file
);
352 void fputc(int file
, const char c
)
354 if (file
< MAX_FILES
)
355 console_putc(file
, c
);
358 void fputs(int file
, const char *s
)
360 if (file
< MAX_FILES
)
361 console_puts(file
, s
);
364 int fprintf(int file
, const char *fmt
, ...)
368 char printbuffer
[CONFIG_SYS_PBSIZE
];
372 /* For this to work, printbuffer must be larger than
373 * anything we ever want to print.
375 i
= vscnprintf(printbuffer
, sizeof(printbuffer
), fmt
, args
);
378 /* Send to desired file */
379 fputs(file
, printbuffer
);
383 /** U-Boot INITIAL CONSOLE-COMPATIBLE FUNCTION *****************************/
387 #ifdef CONFIG_DISABLE_CONSOLE
388 if (gd
->flags
& GD_FLG_DISABLE_CONSOLE
)
392 if (!gd
->have_console
)
395 #ifdef CONFIG_CONSOLE_RECORD
396 if (gd
->console_in
.start
) {
399 ch
= membuff_getbyte(&gd
->console_in
);
404 if (gd
->flags
& GD_FLG_DEVINIT
) {
405 /* Get from the standard input */
409 /* Send directly to the handler */
410 return serial_getc();
415 #ifdef CONFIG_DISABLE_CONSOLE
416 if (gd
->flags
& GD_FLG_DISABLE_CONSOLE
)
420 if (!gd
->have_console
)
422 #ifdef CONFIG_CONSOLE_RECORD
423 if (gd
->console_in
.start
) {
424 if (membuff_peekbyte(&gd
->console_in
) != -1)
428 if (gd
->flags
& GD_FLG_DEVINIT
) {
429 /* Test the standard input */
433 /* Send directly to the handler */
434 return serial_tstc();
437 #define PRE_CONSOLE_FLUSHPOINT1_SERIAL 0
438 #define PRE_CONSOLE_FLUSHPOINT2_EVERYTHING_BUT_SERIAL 1
440 #if CONFIG_IS_ENABLED(PRE_CONSOLE_BUFFER)
441 #define CIRC_BUF_IDX(idx) ((idx) % (unsigned long)CONFIG_PRE_CON_BUF_SZ)
443 static void pre_console_putc(const char c
)
447 buffer
= map_sysmem(CONFIG_PRE_CON_BUF_ADDR
, CONFIG_PRE_CON_BUF_SZ
);
449 buffer
[CIRC_BUF_IDX(gd
->precon_buf_idx
++)] = c
;
451 unmap_sysmem(buffer
);
454 static void pre_console_puts(const char *s
)
457 pre_console_putc(*s
++);
460 static void print_pre_console_buffer(int flushpoint
)
462 unsigned long in
= 0, out
= 0;
463 char buf_out
[CONFIG_PRE_CON_BUF_SZ
+ 1];
466 buf_in
= map_sysmem(CONFIG_PRE_CON_BUF_ADDR
, CONFIG_PRE_CON_BUF_SZ
);
467 if (gd
->precon_buf_idx
> CONFIG_PRE_CON_BUF_SZ
)
468 in
= gd
->precon_buf_idx
- CONFIG_PRE_CON_BUF_SZ
;
470 while (in
< gd
->precon_buf_idx
)
471 buf_out
[out
++] = buf_in
[CIRC_BUF_IDX(in
++)];
472 unmap_sysmem(buf_in
);
476 switch (flushpoint
) {
477 case PRE_CONSOLE_FLUSHPOINT1_SERIAL
:
480 case PRE_CONSOLE_FLUSHPOINT2_EVERYTHING_BUT_SERIAL
:
481 console_puts_noserial(stdout
, buf_out
);
486 static inline void pre_console_putc(const char c
) {}
487 static inline void pre_console_puts(const char *s
) {}
488 static inline void print_pre_console_buffer(int flushpoint
) {}
491 void putc(const char c
)
493 #ifdef CONFIG_SANDBOX
494 /* sandbox can send characters to stdout before it has a console */
495 if (!gd
|| !(gd
->flags
& GD_FLG_SERIAL_READY
)) {
500 #ifdef CONFIG_DEBUG_UART
501 /* if we don't have a console yet, use the debug UART */
502 if (!gd
|| !(gd
->flags
& GD_FLG_SERIAL_READY
)) {
509 #ifdef CONFIG_CONSOLE_RECORD
510 if ((gd
->flags
& GD_FLG_RECORD
) && gd
->console_out
.start
)
511 membuff_putbyte(&gd
->console_out
, c
);
513 #ifdef CONFIG_SILENT_CONSOLE
514 if (gd
->flags
& GD_FLG_SILENT
)
518 #ifdef CONFIG_DISABLE_CONSOLE
519 if (gd
->flags
& GD_FLG_DISABLE_CONSOLE
)
523 if (!gd
->have_console
)
524 return pre_console_putc(c
);
526 if (gd
->flags
& GD_FLG_DEVINIT
) {
527 /* Send to the standard output */
530 /* Send directly to the handler */
536 void puts(const char *s
)
538 #ifdef CONFIG_SANDBOX
539 /* sandbox can send characters to stdout before it has a console */
540 if (!gd
|| !(gd
->flags
& GD_FLG_SERIAL_READY
)) {
545 #ifdef CONFIG_DEBUG_UART
546 if (!gd
|| !(gd
->flags
& GD_FLG_SERIAL_READY
)) {
557 #ifdef CONFIG_CONSOLE_RECORD
558 if ((gd
->flags
& GD_FLG_RECORD
) && gd
->console_out
.start
)
559 membuff_put(&gd
->console_out
, s
, strlen(s
));
561 #ifdef CONFIG_SILENT_CONSOLE
562 if (gd
->flags
& GD_FLG_SILENT
)
566 #ifdef CONFIG_DISABLE_CONSOLE
567 if (gd
->flags
& GD_FLG_DISABLE_CONSOLE
)
571 if (!gd
->have_console
)
572 return pre_console_puts(s
);
574 if (gd
->flags
& GD_FLG_DEVINIT
) {
575 /* Send to the standard output */
578 /* Send directly to the handler */
584 #ifdef CONFIG_CONSOLE_RECORD
585 int console_record_init(void)
589 ret
= membuff_new(&gd
->console_out
, CONFIG_CONSOLE_RECORD_OUT_SIZE
);
592 ret
= membuff_new(&gd
->console_in
, CONFIG_CONSOLE_RECORD_IN_SIZE
);
597 void console_record_reset(void)
599 membuff_purge(&gd
->console_out
);
600 membuff_purge(&gd
->console_in
);
603 void console_record_reset_enable(void)
605 console_record_reset();
606 gd
->flags
|= GD_FLG_RECORD
;
610 /* test if ctrl-c was pressed */
611 static int ctrlc_disabled
= 0; /* see disable_ctrl() */
612 static int ctrlc_was_pressed
= 0;
615 if (!ctrlc_disabled
&& gd
->have_console
) {
618 case 0x03: /* ^C - Control C */
619 ctrlc_was_pressed
= 1;
629 /* Reads user's confirmation.
630 Returns 1 if user's input is "y", "Y", "yes" or "YES"
632 int confirm_yesno(void)
641 while (i
< sizeof(str_input
)) {
642 str_input
[i
] = getc();
644 if (str_input
[i
] == '\r')
649 if (strncmp(str_input
, "y\r", 2) == 0 ||
650 strncmp(str_input
, "Y\r", 2) == 0 ||
651 strncmp(str_input
, "yes\r", 4) == 0 ||
652 strncmp(str_input
, "YES\r", 4) == 0)
656 /* pass 1 to disable ctrlc() checking, 0 to enable.
657 * returns previous state
659 int disable_ctrlc(int disable
)
661 int prev
= ctrlc_disabled
; /* save previous state */
663 ctrlc_disabled
= disable
;
669 return ctrlc_was_pressed
;
672 void clear_ctrlc(void)
674 ctrlc_was_pressed
= 0;
677 /** U-Boot INIT FUNCTIONS *************************************************/
679 struct stdio_dev
*search_device(int flags
, const char *name
)
681 struct stdio_dev
*dev
;
683 dev
= stdio_get_by_name(name
);
684 #ifdef CONFIG_VIDCONSOLE_AS_LCD
685 if (!dev
&& !strcmp(name
, "lcd"))
686 dev
= stdio_get_by_name("vidconsole");
689 if (dev
&& (dev
->flags
& flags
))
695 int console_assign(int file
, const char *devname
)
698 struct stdio_dev
*dev
;
700 /* Check for valid file */
703 flag
= DEV_FLAGS_INPUT
;
707 flag
= DEV_FLAGS_OUTPUT
;
713 /* Check for valid device name */
715 dev
= search_device(flag
, devname
);
718 return console_setfile(file
, dev
);
723 static void console_update_silent(void)
725 #ifdef CONFIG_SILENT_CONSOLE
726 if (env_get("silent") != NULL
)
727 gd
->flags
|= GD_FLG_SILENT
;
729 gd
->flags
&= ~GD_FLG_SILENT
;
733 int console_announce_r(void)
735 #if !CONFIG_IS_ENABLED(PRE_CONSOLE_BUFFER)
736 char buf
[DISPLAY_OPTIONS_BANNER_LENGTH
];
738 display_options_get_banner(false, buf
, sizeof(buf
));
740 console_puts_noserial(stdout
, buf
);
746 /* Called before relocation - use serial functions */
747 int console_init_f(void)
749 gd
->have_console
= 1;
751 console_update_silent();
753 print_pre_console_buffer(PRE_CONSOLE_FLUSHPOINT1_SERIAL
);
758 void stdio_print_current_devices(void)
760 /* Print information */
762 if (stdio_devices
[stdin
] == NULL
) {
763 puts("No input devices available!\n");
765 printf ("%s\n", stdio_devices
[stdin
]->name
);
769 if (stdio_devices
[stdout
] == NULL
) {
770 puts("No output devices available!\n");
772 printf ("%s\n", stdio_devices
[stdout
]->name
);
776 if (stdio_devices
[stderr
] == NULL
) {
777 puts("No error devices available!\n");
779 printf ("%s\n", stdio_devices
[stderr
]->name
);
783 #if CONFIG_IS_ENABLED(SYS_CONSOLE_IS_IN_ENV)
784 /* Called after the relocation - use desired console functions */
785 int console_init_r(void)
787 char *stdinname
, *stdoutname
, *stderrname
;
788 struct stdio_dev
*inputdev
= NULL
, *outputdev
= NULL
, *errdev
= NULL
;
789 #ifdef CONFIG_SYS_CONSOLE_ENV_OVERWRITE
791 #endif /* CONFIG_SYS_CONSOLE_ENV_OVERWRITE */
792 #if CONFIG_IS_ENABLED(CONSOLE_MUX)
796 /* set default handlers at first */
797 gd
->jt
->getc
= serial_getc
;
798 gd
->jt
->tstc
= serial_tstc
;
799 gd
->jt
->putc
= serial_putc
;
800 gd
->jt
->puts
= serial_puts
;
801 gd
->jt
->printf
= serial_printf
;
803 /* stdin stdout and stderr are in environment */
805 stdinname
= env_get("stdin");
806 stdoutname
= env_get("stdout");
807 stderrname
= env_get("stderr");
809 if (OVERWRITE_CONSOLE
== 0) { /* if not overwritten by config switch */
810 inputdev
= search_device(DEV_FLAGS_INPUT
, stdinname
);
811 outputdev
= search_device(DEV_FLAGS_OUTPUT
, stdoutname
);
812 errdev
= search_device(DEV_FLAGS_OUTPUT
, stderrname
);
813 #if CONFIG_IS_ENABLED(CONSOLE_MUX)
814 iomux_err
= iomux_doenv(stdin
, stdinname
);
815 iomux_err
+= iomux_doenv(stdout
, stdoutname
);
816 iomux_err
+= iomux_doenv(stderr
, stderrname
);
818 /* Successful, so skip all the code below. */
822 /* if the devices are overwritten or not found, use default device */
823 if (inputdev
== NULL
) {
824 inputdev
= search_device(DEV_FLAGS_INPUT
, "serial");
826 if (outputdev
== NULL
) {
827 outputdev
= search_device(DEV_FLAGS_OUTPUT
, "serial");
829 if (errdev
== NULL
) {
830 errdev
= search_device(DEV_FLAGS_OUTPUT
, "serial");
832 /* Initializes output console first */
833 if (outputdev
!= NULL
) {
834 /* need to set a console if not done above. */
835 console_doenv(stdout
, outputdev
);
837 if (errdev
!= NULL
) {
838 /* need to set a console if not done above. */
839 console_doenv(stderr
, errdev
);
841 if (inputdev
!= NULL
) {
842 /* need to set a console if not done above. */
843 console_doenv(stdin
, inputdev
);
846 #if CONFIG_IS_ENABLED(CONSOLE_MUX)
850 #ifndef CONFIG_SYS_CONSOLE_INFO_QUIET
851 stdio_print_current_devices();
852 #endif /* CONFIG_SYS_CONSOLE_INFO_QUIET */
853 #ifdef CONFIG_VIDCONSOLE_AS_LCD
854 if (strstr(stdoutname
, "lcd"))
855 printf("Warning: Please change 'lcd' to 'vidconsole' in stdout/stderr environment vars\n");
858 #ifdef CONFIG_SYS_CONSOLE_ENV_OVERWRITE
859 /* set the environment variables (will overwrite previous env settings) */
860 for (i
= 0; i
< MAX_FILES
; i
++) {
861 env_set(stdio_names
[i
], stdio_devices
[i
]->name
);
863 #endif /* CONFIG_SYS_CONSOLE_ENV_OVERWRITE */
865 gd
->flags
|= GD_FLG_DEVINIT
; /* device initialization completed */
868 /* If nothing usable installed, use only the initial console */
869 if ((stdio_devices
[stdin
] == NULL
) && (stdio_devices
[stdout
] == NULL
))
872 print_pre_console_buffer(PRE_CONSOLE_FLUSHPOINT2_EVERYTHING_BUT_SERIAL
);
876 #else /* !CONFIG_IS_ENABLED(SYS_CONSOLE_IS_IN_ENV) */
878 /* Called after the relocation - use desired console functions */
879 int console_init_r(void)
881 struct stdio_dev
*inputdev
= NULL
, *outputdev
= NULL
;
883 struct list_head
*list
= stdio_get_list();
884 struct list_head
*pos
;
885 struct stdio_dev
*dev
;
887 console_update_silent();
889 #ifdef CONFIG_SPLASH_SCREEN
891 * suppress all output if splash screen is enabled and we have
892 * a bmp to display. We redirect the output from frame buffer
893 * console to serial console in this case or suppress it if
894 * "silent" mode was requested.
896 if (env_get("splashimage") != NULL
) {
897 if (!(gd
->flags
& GD_FLG_SILENT
))
898 outputdev
= search_device (DEV_FLAGS_OUTPUT
, "serial");
902 /* Scan devices looking for input and output devices */
903 list_for_each(pos
, list
) {
904 dev
= list_entry(pos
, struct stdio_dev
, list
);
906 if ((dev
->flags
& DEV_FLAGS_INPUT
) && (inputdev
== NULL
)) {
909 if ((dev
->flags
& DEV_FLAGS_OUTPUT
) && (outputdev
== NULL
)) {
912 if(inputdev
&& outputdev
)
916 /* Initializes output console first */
917 if (outputdev
!= NULL
) {
918 console_setfile(stdout
, outputdev
);
919 console_setfile(stderr
, outputdev
);
920 #if CONFIG_IS_ENABLED(CONSOLE_MUX)
921 console_devices
[stdout
][0] = outputdev
;
922 console_devices
[stderr
][0] = outputdev
;
926 /* Initializes input console */
927 if (inputdev
!= NULL
) {
928 console_setfile(stdin
, inputdev
);
929 #if CONFIG_IS_ENABLED(CONSOLE_MUX)
930 console_devices
[stdin
][0] = inputdev
;
934 #ifndef CONFIG_SYS_CONSOLE_INFO_QUIET
935 stdio_print_current_devices();
936 #endif /* CONFIG_SYS_CONSOLE_INFO_QUIET */
938 /* Setting environment variables */
939 for (i
= 0; i
< MAX_FILES
; i
++) {
940 env_set(stdio_names
[i
], stdio_devices
[i
]->name
);
943 gd
->flags
|= GD_FLG_DEVINIT
; /* device initialization completed */
946 /* If nothing usable installed, use only the initial console */
947 if ((stdio_devices
[stdin
] == NULL
) && (stdio_devices
[stdout
] == NULL
))
950 print_pre_console_buffer(PRE_CONSOLE_FLUSHPOINT2_EVERYTHING_BUT_SERIAL
);
954 #endif /* CONFIG_IS_ENABLED(SYS_CONSOLE_IS_IN_ENV) */