1 #ifndef CONSOLE_CONSOLE_H_
2 #define CONSOLE_CONSOLE_H_
5 #include <console/loglevel.h>
8 void console_init(void);
9 void post_code(u8 value);
10 void __attribute__ ((noreturn)) die(const char *msg);
14 void console_tx_byte(unsigned char byte);
15 void console_tx_flush(void);
16 unsigned char console_rx_byte(void);
17 int console_tst_byte(void);
18 #if CONFIG_CONSOLE_VGA == 1
19 void vga_console_init(void);
22 struct console_driver {
24 void (*tx_byte)(unsigned char byte);
25 void (*tx_flush)(void);
26 unsigned char (*rx_byte)(void);
27 int (*tst_byte)(void);
30 #define __console __attribute__((used, __section__ (".rodata.console_drivers")))
32 /* Defined by the linker... */
33 extern struct console_driver console_drivers[];
34 extern struct console_driver econsole_drivers[];
36 extern int console_loglevel;
39 /* Using a global varible can cause problems when we reset the stack
40 * from cache as ram to ram. If we make this a define USE_SHARED_STACK
41 * we could use the same code on all architectures.
43 #define console_loglevel CONFIG_DEFAULT_CONSOLE_LOGLEVEL
47 int do_printk(int msg_level, const char *fmt, ...) __attribute__((format(printf, 2, 3)));
49 #undef WE_CLEANED_UP_ALL_SIDE_EFFECTS
50 /* We saw some strange effects in the past like coreboot crashing while
51 * disabling cache as ram for a maximum console log level of 6 and above while
52 * it worked fine without. In order to catch such issues reliably we are
53 * always doing a function call to do_printk with the full number of arguments.
54 * Our favorite reason to do it this way was:
56 * printk(BIOS_DEBUG, "CAR disabled\n"); // oops, garbage stack pointer
58 * This slightly increases the code size and some unprinted strings will end
59 * up in the final coreboot binary (most of them compressed). If you want to
61 * #define WE_CLEANED_UP_ALL_SIDE_EFFECTS
63 #ifdef WE_CLEANED_UP_ALL_SIDE_EFFECTS
65 #define printk(LEVEL, fmt, args...) \
67 if (CONFIG_MAXIMUM_CONSOLE_LOGLEVEL >= LEVEL) { \
68 do_printk(LEVEL, fmt, ##args); \
74 #define printk(LEVEL, fmt, args...) \
76 if (CONFIG_MAXIMUM_CONSOLE_LOGLEVEL >= LEVEL) { \
77 do_printk(LEVEL, fmt, ##args); \
79 do_printk(BIOS_NEVER, fmt, ##args); \
84 #define print_emerg(STR) printk(BIOS_EMERG, "%s", (STR))
85 #define print_alert(STR) printk(BIOS_ALERT, "%s", (STR))
86 #define print_crit(STR) printk(BIOS_CRIT, "%s", (STR))
87 #define print_err(STR) printk(BIOS_ERR, "%s", (STR))
88 #define print_warning(STR) printk(BIOS_WARNING,"%s", (STR))
89 #define print_notice(STR) printk(BIOS_NOTICE, "%s", (STR))
90 #define print_info(STR) printk(BIOS_INFO, "%s", (STR))
91 #define print_debug(STR) printk(BIOS_DEBUG, "%s", (STR))
92 #define print_spew(STR) printk(BIOS_SPEW, "%s", (STR))
94 #define print_emerg_char(CH) printk(BIOS_EMERG, "%c", (CH))
95 #define print_alert_char(CH) printk(BIOS_ALERT, "%c", (CH))
96 #define print_crit_char(CH) printk(BIOS_CRIT, "%c", (CH))
97 #define print_err_char(CH) printk(BIOS_ERR, "%c", (CH))
98 #define print_warning_char(CH) printk(BIOS_WARNING,"%c", (CH))
99 #define print_notice_char(CH) printk(BIOS_NOTICE, "%c", (CH))
100 #define print_info_char(CH) printk(BIOS_INFO, "%c", (CH))
101 #define print_debug_char(CH) printk(BIOS_DEBUG, "%c", (CH))
102 #define print_spew_char(CH) printk(BIOS_SPEW, "%c", (CH))
104 #define print_emerg_hex8(HEX) printk(BIOS_EMERG, "%02x", (HEX))
105 #define print_alert_hex8(HEX) printk(BIOS_ALERT, "%02x", (HEX))
106 #define print_crit_hex8(HEX) printk(BIOS_CRIT, "%02x", (HEX))
107 #define print_err_hex8(HEX) printk(BIOS_ERR, "%02x", (HEX))
108 #define print_warning_hex8(HEX) printk(BIOS_WARNING,"%02x", (HEX))
109 #define print_notice_hex8(HEX) printk(BIOS_NOTICE, "%02x", (HEX))
110 #define print_info_hex8(HEX) printk(BIOS_INFO, "%02x", (HEX))
111 #define print_debug_hex8(HEX) printk(BIOS_DEBUG, "%02x", (HEX))
112 #define print_spew_hex8(HEX) printk(BIOS_SPEW, "%02x", (HEX))
114 #define print_emerg_hex16(HEX) printk(BIOS_EMERG, "%04x", (HEX))
115 #define print_alert_hex16(HEX) printk(BIOS_ALERT, "%04x", (HEX))
116 #define print_crit_hex16(HEX) printk(BIOS_CRIT, "%04x", (HEX))
117 #define print_err_hex16(HEX) printk(BIOS_ERR, "%04x", (HEX))
118 #define print_warning_hex16(HEX) printk(BIOS_WARNING,"%04x", (HEX))
119 #define print_notice_hex16(HEX) printk(BIOS_NOTICE, "%04x", (HEX))
120 #define print_info_hex16(HEX) printk(BIOS_INFO, "%04x", (HEX))
121 #define print_debug_hex16(HEX) printk(BIOS_DEBUG, "%04x", (HEX))
122 #define print_spew_hex16(HEX) printk(BIOS_SPEW, "%04x", (HEX))
124 #define print_emerg_hex32(HEX) printk(BIOS_EMERG, "%08x", (HEX))
125 #define print_alert_hex32(HEX) printk(BIOS_ALERT, "%08x", (HEX))
126 #define print_crit_hex32(HEX) printk(BIOS_CRIT, "%08x", (HEX))
127 #define print_err_hex32(HEX) printk(BIOS_ERR, "%08x", (HEX))
128 #define print_warning_hex32(HEX) printk(BIOS_WARNING,"%08x", (HEX))
129 #define print_notice_hex32(HEX) printk(BIOS_NOTICE, "%08x", (HEX))
130 #define print_info_hex32(HEX) printk(BIOS_INFO, "%08x", (HEX))
131 #define print_debug_hex32(HEX) printk(BIOS_DEBUG, "%08x", (HEX))
132 #define print_spew_hex32(HEX) printk(BIOS_SPEW, "%08x", (HEX))
137 static void __console_tx_byte(unsigned char byte)
142 static void __console_tx_nibble(unsigned nibble)
145 digit = nibble + '0';
149 __console_tx_byte(digit);
152 static void __console_tx_char(int loglevel, unsigned char byte)
154 if (console_loglevel >= loglevel) {
159 static void __console_tx_hex8(int loglevel, unsigned char value)
161 if (console_loglevel >= loglevel) {
162 __console_tx_nibble((value >> 4U) & 0x0fU);
163 __console_tx_nibble(value & 0x0fU);
167 static void __console_tx_hex16(int loglevel, unsigned short value)
169 if (console_loglevel >= loglevel) {
170 __console_tx_nibble((value >> 12U) & 0x0fU);
171 __console_tx_nibble((value >> 8U) & 0x0fU);
172 __console_tx_nibble((value >> 4U) & 0x0fU);
173 __console_tx_nibble(value & 0x0fU);
177 static void __console_tx_hex32(int loglevel, unsigned int value)
179 if (console_loglevel >= loglevel) {
180 __console_tx_nibble((value >> 28U) & 0x0fU);
181 __console_tx_nibble((value >> 24U) & 0x0fU);
182 __console_tx_nibble((value >> 20U) & 0x0fU);
183 __console_tx_nibble((value >> 16U) & 0x0fU);
184 __console_tx_nibble((value >> 12U) & 0x0fU);
185 __console_tx_nibble((value >> 8U) & 0x0fU);
186 __console_tx_nibble((value >> 4U) & 0x0fU);
187 __console_tx_nibble(value & 0x0fU);
191 static void __console_tx_string(int loglevel, const char *str)
193 if (console_loglevel >= loglevel) {
195 while((ch = *str++) != '\0') {
197 __console_tx_byte('\r');
198 __console_tx_byte(ch);
203 #define FUNCTIONS_FOR_PRINT
204 #ifdef FUNCTIONS_FOR_PRINT
205 static void print_emerg_char(unsigned char byte) { __console_tx_char(BIOS_EMERG, byte); }
206 static void print_emerg_hex8(unsigned char value){ __console_tx_hex8(BIOS_EMERG, value); }
207 static void print_emerg_hex16(unsigned short value){ __console_tx_hex16(BIOS_EMERG, value); }
208 static void print_emerg_hex32(unsigned int value) { __console_tx_hex32(BIOS_EMERG, value); }
209 static void print_emerg(const char *str) { __console_tx_string(BIOS_EMERG, str); }
211 static void print_alert_char(unsigned char byte) { __console_tx_char(BIOS_ALERT, byte); }
212 static void print_alert_hex8(unsigned char value) { __console_tx_hex8(BIOS_ALERT, value); }
213 static void print_alert_hex16(unsigned short value){ __console_tx_hex16(BIOS_ALERT, value); }
214 static void print_alert_hex32(unsigned int value) { __console_tx_hex32(BIOS_ALERT, value); }
215 static void print_alert(const char *str) { __console_tx_string(BIOS_ALERT, str); }
217 static void print_crit_char(unsigned char byte) { __console_tx_char(BIOS_CRIT, byte); }
218 static void print_crit_hex8(unsigned char value) { __console_tx_hex8(BIOS_CRIT, value); }
219 static void print_crit_hex16(unsigned short value){ __console_tx_hex16(BIOS_CRIT, value); }
220 static void print_crit_hex32(unsigned int value) { __console_tx_hex32(BIOS_CRIT, value); }
221 static void print_crit(const char *str) { __console_tx_string(BIOS_CRIT, str); }
223 static void print_err_char(unsigned char byte) { __console_tx_char(BIOS_ERR, byte); }
224 static void print_err_hex8(unsigned char value) { __console_tx_hex8(BIOS_ERR, value); }
225 static void print_err_hex16(unsigned short value){ __console_tx_hex16(BIOS_ERR, value); }
226 static void print_err_hex32(unsigned int value) { __console_tx_hex32(BIOS_ERR, value); }
227 static void print_err(const char *str) { __console_tx_string(BIOS_ERR, str); }
229 static void print_warning_char(unsigned char byte) { __console_tx_char(BIOS_WARNING, byte); }
230 static void print_warning_hex8(unsigned char value) { __console_tx_hex8(BIOS_WARNING, value); }
231 static void print_warning_hex16(unsigned short value){ __console_tx_hex16(BIOS_WARNING, value); }
232 static void print_warning_hex32(unsigned int value) { __console_tx_hex32(BIOS_WARNING, value); }
233 static void print_warning(const char *str) { __console_tx_string(BIOS_WARNING, str); }
235 static void print_notice_char(unsigned char byte) { __console_tx_char(BIOS_NOTICE, byte); }
236 static void print_notice_hex8(unsigned char value) { __console_tx_hex8(BIOS_NOTICE, value); }
237 static void print_notice_hex16(unsigned short value){ __console_tx_hex16(BIOS_NOTICE, value); }
238 static void print_notice_hex32(unsigned int value) { __console_tx_hex32(BIOS_NOTICE, value); }
239 static void print_notice(const char *str) { __console_tx_string(BIOS_NOTICE, str); }
241 static void print_info_char(unsigned char byte) { __console_tx_char(BIOS_INFO, byte); }
242 static void print_info_hex8(unsigned char value) { __console_tx_hex8(BIOS_INFO, value); }
243 static void print_info_hex16(unsigned short value){ __console_tx_hex16(BIOS_INFO, value); }
244 static void print_info_hex32(unsigned int value) { __console_tx_hex32(BIOS_INFO, value); }
245 static void print_info(const char *str) { __console_tx_string(BIOS_INFO, str); }
247 static void print_debug_char(unsigned char byte) { __console_tx_char(BIOS_DEBUG, byte); }
248 static void print_debug_hex8(unsigned char value) { __console_tx_hex8(BIOS_DEBUG, value); }
249 static void print_debug_hex16(unsigned short value){ __console_tx_hex16(BIOS_DEBUG, value); }
250 static void print_debug_hex32(unsigned int value) { __console_tx_hex32(BIOS_DEBUG, value); }
251 static void print_debug(const char *str) { __console_tx_string(BIOS_DEBUG, str); }
253 static void print_spew_char(unsigned char byte) { __console_tx_char(BIOS_SPEW, byte); }
254 static void print_spew_hex8(unsigned char value) { __console_tx_hex8(BIOS_SPEW, value); }
255 static void print_spew_hex16(unsigned short value){ __console_tx_hex16(BIOS_SPEW, value); }
256 static void print_spew_hex32(unsigned int value) { __console_tx_hex32(BIOS_SPEW, value); }
257 static void print_spew(const char *str) { __console_tx_string(BIOS_SPEW, str); }
260 #define print_emerg(STR) __console_tx_string(BIOS_EMERG, STR)
261 #define print_alert(STR) __console_tx_string(BIOS_ALERT, STR)
262 #define print_crit(STR) __console_tx_string(BIOS_CRIT, STR)
263 #define print_err(STR) __console_tx_string(BIOS_ERR, STR)
264 #define print_warning(STR) __console_tx_string(BIOS_WARNING, STR)
265 #define print_notice(STR) __console_tx_string(BIOS_NOTICE, STR)
266 #define print_info(STR) __console_tx_string(BIOS_INFO, STR)
267 #define print_debug(STR) __console_tx_string(BIOS_DEBUG, STR)
268 #define print_spew(STR) __console_tx_string(BIOS_SPEW, STR)
270 #define print_emerg_char(CH) __console_tx_char(BIOS_EMERG, CH)
271 #define print_alert_char(CH) __console_tx_char(BIOS_ALERT, CH)
272 #define print_crit_char(CH) __console_tx_char(BIOS_CRIT, CH)
273 #define print_err_char(CH) __console_tx_char(BIOS_ERR, CH)
274 #define print_warning_char(CH) __console_tx_char(BIOS_WARNING, CH)
275 #define print_notice_char(CH) __console_tx_char(BIOS_NOTICE, CH)
276 #define print_info_char(CH) __console_tx_char(BIOS_INFO, CH)
277 #define print_debug_char(CH) __console_tx_char(BIOS_DEBUG, CH)
278 #define print_spew_char(CH) __console_tx_char(BIOS_SPEW, CH)
280 #define print_emerg_hex8(HEX) __console_tx_hex8(BIOS_EMERG, HEX)
281 #define print_alert_hex8(HEX) __console_tx_hex8(BIOS_ALERT, HEX)
282 #define print_crit_hex8(HEX) __console_tx_hex8(BIOS_CRIT, HEX)
283 #define print_err_hex8(HEX) __console_tx_hex8(BIOS_ERR, HEX)
284 #define print_warning_hex8(HEX) __console_tx_hex8(BIOS_WARNING, HEX)
285 #define print_notice_hex8(HEX) __console_tx_hex8(BIOS_NOTICE, HEX)
286 #define print_info_hex8(HEX) __console_tx_hex8(BIOS_INFO, HEX)
287 #define print_debug_hex8(HEX) __console_tx_hex8(BIOS_DEBUG, HEX)
288 #define print_spew_hex8(HEX) __console_tx_hex8(BIOS_SPEW, HEX)
290 #define print_emerg_hex16(HEX) __console_tx_hex16(BIOS_EMERG, HEX)
291 #define print_alert_hex16(HEX) __console_tx_hex16(BIOS_ALERT, HEX)
292 #define print_crit_hex16(HEX) __console_tx_hex16(BIOS_CRIT, HEX)
293 #define print_err_hex16(HEX) __console_tx_hex16(BIOS_ERR, HEX)
294 #define print_warning_hex16(HEX) __console_tx_hex16(BIOS_WARNING, HEX)
295 #define print_notice_hex16(HEX) __console_tx_hex16(BIOS_NOTICE, HEX)
296 #define print_info_hex16(HEX) __console_tx_hex16(BIOS_INFO, HEX)
297 #define print_debug_hex16(HEX) __console_tx_hex16(BIOS_DEBUG, HEX)
298 #define print_spew_hex16(HEX) __console_tx_hex16(BIOS_SPEW, HEX)
300 #define print_emerg_hex32(HEX) __console_tx_hex32(BIOS_EMERG, HEX)
301 #define print_alert_hex32(HEX) __console_tx_hex32(BIOS_ALERT, HEX)
302 #define print_crit_hex32(HEX) __console_tx_hex32(BIOS_CRIT, HEX)
303 #define print_err_hex32(HEX) __console_tx_hex32(BIOS_ERR, HEX)
304 #define print_warning_hex32(HEX) __console_tx_hex32(BIOS_WARNING, HEX)
305 #define print_notice_hex32(HEX) __console_tx_hex32(BIOS_NOTICE, HEX)
306 #define print_info_hex32(HEX) __console_tx_hex32(BIOS_INFO, HEX)
307 #define print_debug_hex32(HEX) __console_tx_hex32(BIOS_DEBUG, HEX)
308 #define print_spew_hex32(HEX) __console_tx_hex32(BIOS_SPEW, HEX)
313 #endif /* CONSOLE_CONSOLE_H_ */