1 /* SPDX-License-Identifier: GPL-2.0+ */
2 /*
3 * (C) Copyright 2000-2009
4 * Wolfgang Denk, DENX Software Engineering, wd@denx.de.
5 */
6
7 #ifndef __CONSOLE_H
8 #define __CONSOLE_H
9
10 #include <stdbool.h>
11 #include <stdio_dev.h>
12 #include <linux/errno.h>
13
14 extern char console_buffer[];
15
16 /* common/console.c */
17 int console_init_f(void); /* Before relocation; uses the serial stuff */
18 int console_init_r(void); /* After relocation; uses the console stuff */
19 int console_start(int file, struct stdio_dev *sdev); /* Start a console device */
20 void console_stop(int file, struct stdio_dev *sdev); /* Stop a console device */
21 int console_assign(int file, const char *devname); /* Assign the console */
22 int ctrlc(void);
23 int had_ctrlc(void); /* have we had a Control-C since last clear? */
24 void clear_ctrlc(void); /* clear the Control-C condition */
25 int disable_ctrlc(int); /* 1 to disable, 0 to enable Control-C detect */
26 int confirm_yesno(void); /* 1 if input is "y", "Y", "yes" or "YES" */
27
28 /**
29 * console_search_dev() - search for stdio device with given flags and name
30 * @flags: device flags as per input/output/system
31 * @name: device name
32 *
33 * Iterates over registered STDIO devices and match them with given @flags
34 * and @name.
35 *
36 * Return: pointer to the &struct stdio_dev if found, or NULL otherwise
37 */
38 struct stdio_dev *console_search_dev(int flags, const char *name);
39
40 #ifdef CONFIG_CONSOLE_RECORD
41 /**
42 * console_record_init() - set up the console recording buffers
43 *
44 * This should be called as soon as malloc() is available so that the maximum
45 * amount of console output can be recorded.
46 *
47 * Return: 0 if OK, -ENOMEM if out of memory
48 */
49 int console_record_init(void);
50
51 /**
52 * console_record_reset() - reset the console recording buffers
53 *
54 * Removes any data in the buffers
55 */
56 void console_record_reset(void);
57
58 /**
59 * console_record_reset_enable() - reset and enable the console buffers
60 *
61 * This should be called to enable the console buffer.
62 *
63 * Return: 0 (always)
64 */
65 int console_record_reset_enable(void);
66
67 /**
68 * console_record_readline() - Read a line from the console output
69 *
70 * This reads the next available line from the console output previously
71 * recorded.
72 *
73 * @str: Place to put string
74 * @maxlen: Maximum length of @str including nul terminator
75 * Return: length of string returned, or -ENOSPC if the console buffer was
76 * overflowed by the output
77 */
78 int console_record_readline(char *str, int maxlen);
79
80 /**
81 * console_record_avail() - Get the number of available bytes in console output
82 *
83 * Return: available bytes (0 if empty)
84 */
85 int console_record_avail(void);
86
87 /**
88 * console_in_puts() - Write a string to the console input buffer
89 *
90 * This writes the given string to the console_in buffer which will then be
91 * returned if a function calls e.g. `getc()`
92 *
93 * @str: the string to write
94 * Return: the number of bytes added
95 */
96 int console_in_puts(const char *str);
97 #else
console_record_init(void)98 static inline int console_record_init(void)
99 {
100 /* Always succeed, since it is not enabled */
101
102 return 0;
103 }
104
console_record_reset(void)105 static inline void console_record_reset(void)
106 {
107 /* Nothing to do here */
108 }
109
console_record_reset_enable(void)110 static inline int console_record_reset_enable(void)
111 {
112 /* Cannot enable it as it is not supported */
113 return -ENOSYS;
114 }
115
console_record_readline(char * str,int maxlen)116 static inline int console_record_readline(char *str, int maxlen)
117 {
118 /* Nothing to read */
119 return 0;
120 }
121
console_record_avail(void)122 static inline int console_record_avail(void)
123 {
124 /* There is never anything available */
125 return 0;
126 }
127
console_in_puts(const char * str)128 static inline int console_in_puts(const char *str)
129 {
130 /* There is never anything written */
131 return 0;
132 }
133
134 #endif /* !CONFIG_CONSOLE_RECORD */
135
136 /**
137 * console_announce_r() - print a U-Boot console on non-serial consoles
138 *
139 * When U-Boot starts up with a display it generally does not announce itself
140 * on the display. The banner is instead emitted on the UART before relocation.
141 * This function prints a banner on devices which (we assume) did not receive
142 * it before relocation.
143 *
144 * Return: 0 (meaning no errors)
145 */
146 int console_announce_r(void);
147
148 /**
149 * console_puts_select_stderr() - Output a string to selected console devices
150 *
151 * This writes to stderr only. It is useful for outputting errors
152 *
153 * @serial_only: true to output only to serial, false to output to everything
154 * else
155 * @s: String to output
156 */
157 void console_puts_select_stderr(bool serial_only, const char *s);
158
159 /*
160 * CONSOLE multiplexing.
161 */
162 #ifdef CONFIG_CONSOLE_MUX
163 #include <iomux.h>
164 #endif
165
166 #endif
167