Tom Rini | 83d290c | 2018-05-06 17:58:06 -0400 | [diff] [blame] | 1 | // SPDX-License-Identifier: GPL-2.0+ |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 2 | /* |
| 3 | * (C) Copyright 2000 |
| 4 | * Paolo Scaffardi, AIRVENT SAM s.p.a - RIMINI(ITALY), arsenio@tin.it |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 5 | */ |
| 6 | |
| 7 | #include <common.h> |
Simon Glass | 24b852a | 2015-11-08 23:47:45 -0700 | [diff] [blame] | 8 | #include <console.h> |
Simon Glass | d6ea530 | 2015-06-23 15:38:33 -0600 | [diff] [blame] | 9 | #include <debug_uart.h> |
Simon Glass | 7b3c4c3 | 2017-07-27 09:31:04 -0600 | [diff] [blame] | 10 | #include <dm.h> |
Simon Glass | 9fb625c | 2019-08-01 09:46:51 -0600 | [diff] [blame] | 11 | #include <env.h> |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 12 | #include <stdarg.h> |
Jeroen Hofstee | 482f469 | 2014-10-08 22:57:48 +0200 | [diff] [blame] | 13 | #include <iomux.h> |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 14 | #include <malloc.h> |
Simon Glass | 4e6bafa | 2017-06-15 21:37:52 -0600 | [diff] [blame] | 15 | #include <mapmem.h> |
Simon Glass | 91b136c | 2013-11-10 10:27:01 -0700 | [diff] [blame] | 16 | #include <os.h> |
Joe Hershberger | 849d5d9 | 2012-12-11 22:16:29 -0600 | [diff] [blame] | 17 | #include <serial.h> |
Jean-Christophe PLAGNIOL-VILLARD | 52cb4d4 | 2009-05-16 12:14:54 +0200 | [diff] [blame] | 18 | #include <stdio_dev.h> |
wdenk | 27b207f | 2003-07-24 23:38:38 +0000 | [diff] [blame] | 19 | #include <exports.h> |
Simon Glass | f3998fd | 2019-08-02 09:44:25 -0600 | [diff] [blame] | 20 | #include <env_internal.h> |
Andreas J. Reichel | 6440746 | 2016-07-13 12:56:51 +0200 | [diff] [blame] | 21 | #include <watchdog.h> |
Simon Glass | 401d1c4 | 2020-10-30 21:38:53 -0600 | [diff] [blame] | 22 | #include <asm/global_data.h> |
Simon Glass | c05ed00 | 2020-05-10 11:40:11 -0600 | [diff] [blame] | 23 | #include <linux/delay.h> |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 24 | |
Wolfgang Denk | d87080b | 2006-03-31 18:32:53 +0200 | [diff] [blame] | 25 | DECLARE_GLOBAL_DATA_PTR; |
| 26 | |
Joe Hershberger | 849d5d9 | 2012-12-11 22:16:29 -0600 | [diff] [blame] | 27 | static int on_console(const char *name, const char *value, enum env_op op, |
| 28 | int flags) |
| 29 | { |
| 30 | int console = -1; |
| 31 | |
| 32 | /* Check for console redirection */ |
| 33 | if (strcmp(name, "stdin") == 0) |
| 34 | console = stdin; |
| 35 | else if (strcmp(name, "stdout") == 0) |
| 36 | console = stdout; |
| 37 | else if (strcmp(name, "stderr") == 0) |
| 38 | console = stderr; |
| 39 | |
| 40 | /* if not actually setting a console variable, we don't care */ |
| 41 | if (console == -1 || (gd->flags & GD_FLG_DEVINIT) == 0) |
| 42 | return 0; |
| 43 | |
| 44 | switch (op) { |
| 45 | case env_op_create: |
| 46 | case env_op_overwrite: |
| 47 | |
Patrick Delaunay | c04f856 | 2020-12-18 12:46:43 +0100 | [diff] [blame] | 48 | if (CONFIG_IS_ENABLED(CONSOLE_MUX)) { |
| 49 | if (iomux_doenv(console, value)) |
| 50 | return 1; |
| 51 | } else { |
| 52 | /* Try assigning specified device */ |
| 53 | if (console_assign(console, value) < 0) |
| 54 | return 1; |
| 55 | } |
| 56 | |
Joe Hershberger | 849d5d9 | 2012-12-11 22:16:29 -0600 | [diff] [blame] | 57 | return 0; |
| 58 | |
| 59 | case env_op_delete: |
| 60 | if ((flags & H_FORCE) == 0) |
| 61 | printf("Can't delete \"%s\"\n", name); |
| 62 | return 1; |
| 63 | |
| 64 | default: |
| 65 | return 0; |
| 66 | } |
| 67 | } |
| 68 | U_BOOT_ENV_CALLBACK(console, on_console); |
| 69 | |
Joe Hershberger | e080d54 | 2012-12-11 22:16:30 -0600 | [diff] [blame] | 70 | #ifdef CONFIG_SILENT_CONSOLE |
| 71 | static int on_silent(const char *name, const char *value, enum env_op op, |
| 72 | int flags) |
| 73 | { |
Patrick Delaunay | c04f856 | 2020-12-18 12:46:43 +0100 | [diff] [blame] | 74 | if (!CONFIG_IS_ENABLED(SILENT_CONSOLE_UPDATE_ON_SET)) |
| 75 | if (flags & H_INTERACTIVE) |
| 76 | return 0; |
| 77 | |
| 78 | if (!CONFIG_IS_ENABLED(SILENT_CONSOLE_UPDATE_ON_RELOC)) |
| 79 | if ((flags & H_INTERACTIVE) == 0) |
| 80 | return 0; |
Joe Hershberger | e080d54 | 2012-12-11 22:16:30 -0600 | [diff] [blame] | 81 | |
| 82 | if (value != NULL) |
| 83 | gd->flags |= GD_FLG_SILENT; |
| 84 | else |
| 85 | gd->flags &= ~GD_FLG_SILENT; |
| 86 | |
| 87 | return 0; |
| 88 | } |
| 89 | U_BOOT_ENV_CALLBACK(silent, on_silent); |
| 90 | #endif |
| 91 | |
Patrick Delaunay | 1e99371 | 2020-12-18 12:46:45 +0100 | [diff] [blame] | 92 | #ifdef CONFIG_CONSOLE_RECORD |
| 93 | /* helper function: access to gd->console_out and gd->console_in */ |
| 94 | static void console_record_putc(const char c) |
| 95 | { |
| 96 | if (!(gd->flags & GD_FLG_RECORD)) |
| 97 | return; |
Simon Glass | c1a2bb4 | 2021-05-08 06:59:56 -0600 | [diff] [blame] | 98 | if (gd->console_out.start && |
| 99 | !membuff_putbyte((struct membuff *)&gd->console_out, c)) |
| 100 | gd->flags |= GD_FLG_RECORD_OVF; |
Patrick Delaunay | 1e99371 | 2020-12-18 12:46:45 +0100 | [diff] [blame] | 101 | } |
| 102 | |
| 103 | static void console_record_puts(const char *s) |
| 104 | { |
| 105 | if (!(gd->flags & GD_FLG_RECORD)) |
| 106 | return; |
Simon Glass | c1a2bb4 | 2021-05-08 06:59:56 -0600 | [diff] [blame] | 107 | if (gd->console_out.start) { |
| 108 | int len = strlen(s); |
| 109 | |
| 110 | if (membuff_put((struct membuff *)&gd->console_out, s, len) != |
| 111 | len) |
| 112 | gd->flags |= GD_FLG_RECORD_OVF; |
| 113 | } |
Patrick Delaunay | 1e99371 | 2020-12-18 12:46:45 +0100 | [diff] [blame] | 114 | } |
| 115 | |
| 116 | static int console_record_getc(void) |
| 117 | { |
| 118 | if (!(gd->flags & GD_FLG_RECORD)) |
| 119 | return -1; |
| 120 | if (!gd->console_in.start) |
| 121 | return -1; |
| 122 | |
| 123 | return membuff_getbyte((struct membuff *)&gd->console_in); |
| 124 | } |
| 125 | |
| 126 | static int console_record_tstc(void) |
| 127 | { |
| 128 | if (!(gd->flags & GD_FLG_RECORD)) |
| 129 | return 0; |
| 130 | if (gd->console_in.start) { |
| 131 | if (membuff_peekbyte((struct membuff *)&gd->console_in) != -1) |
| 132 | return 1; |
| 133 | } |
| 134 | return 0; |
| 135 | } |
| 136 | #else |
| 137 | static void console_record_putc(char c) |
| 138 | { |
| 139 | } |
| 140 | |
| 141 | static void console_record_puts(const char *s) |
| 142 | { |
| 143 | } |
| 144 | |
| 145 | static int console_record_getc(void) |
| 146 | { |
| 147 | return -1; |
| 148 | } |
| 149 | |
| 150 | static int console_record_tstc(void) |
| 151 | { |
| 152 | return 0; |
| 153 | } |
| 154 | #endif |
| 155 | |
Simon Glass | b026542 | 2017-01-16 07:03:26 -0700 | [diff] [blame] | 156 | #if CONFIG_IS_ENABLED(SYS_CONSOLE_IS_IN_ENV) |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 157 | /* |
| 158 | * if overwrite_console returns 1, the stdin, stderr and stdout |
| 159 | * are switched to the serial port, else the settings in the |
| 160 | * environment are used |
| 161 | */ |
Jean-Christophe PLAGNIOL-VILLARD | 6d0f6bc | 2008-10-16 15:01:15 +0200 | [diff] [blame] | 162 | #ifdef CONFIG_SYS_CONSOLE_OVERWRITE_ROUTINE |
Jean-Christophe PLAGNIOL-VILLARD | ec6f149 | 2009-02-01 17:07:51 +0100 | [diff] [blame] | 163 | extern int overwrite_console(void); |
| 164 | #define OVERWRITE_CONSOLE overwrite_console() |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 165 | #else |
wdenk | 83e40ba | 2005-03-31 18:42:15 +0000 | [diff] [blame] | 166 | #define OVERWRITE_CONSOLE 0 |
Jean-Christophe PLAGNIOL-VILLARD | 6d0f6bc | 2008-10-16 15:01:15 +0200 | [diff] [blame] | 167 | #endif /* CONFIG_SYS_CONSOLE_OVERWRITE_ROUTINE */ |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 168 | |
Simon Glass | b026542 | 2017-01-16 07:03:26 -0700 | [diff] [blame] | 169 | #endif /* CONFIG_IS_ENABLED(SYS_CONSOLE_IS_IN_ENV) */ |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 170 | |
Jean-Christophe PLAGNIOL-VILLARD | 52cb4d4 | 2009-05-16 12:14:54 +0200 | [diff] [blame] | 171 | static int console_setfile(int file, struct stdio_dev * dev) |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 172 | { |
| 173 | int error = 0; |
| 174 | |
| 175 | if (dev == NULL) |
| 176 | return -1; |
| 177 | |
| 178 | switch (file) { |
| 179 | case stdin: |
| 180 | case stdout: |
| 181 | case stderr: |
Andy Shevchenko | 41f668b | 2020-12-21 14:30:00 +0200 | [diff] [blame] | 182 | error = console_start(file, dev); |
| 183 | if (error) |
| 184 | break; |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 185 | |
| 186 | /* Assign the new device (leaving the existing one started) */ |
| 187 | stdio_devices[file] = dev; |
| 188 | |
| 189 | /* |
| 190 | * Update monitor functions |
| 191 | * (to use the console stuff by other applications) |
| 192 | */ |
| 193 | switch (file) { |
| 194 | case stdin: |
Heinrich Schuchardt | c670aee | 2020-10-07 18:11:48 +0200 | [diff] [blame] | 195 | gd->jt->getc = getchar; |
Martin Dorwig | 49cad54 | 2015-01-26 15:22:54 -0700 | [diff] [blame] | 196 | gd->jt->tstc = tstc; |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 197 | break; |
| 198 | case stdout: |
Martin Dorwig | 49cad54 | 2015-01-26 15:22:54 -0700 | [diff] [blame] | 199 | gd->jt->putc = putc; |
| 200 | gd->jt->puts = puts; |
| 201 | gd->jt->printf = printf; |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 202 | break; |
| 203 | } |
| 204 | break; |
| 205 | |
| 206 | default: /* Invalid file ID */ |
| 207 | error = -1; |
| 208 | } |
| 209 | return error; |
| 210 | } |
| 211 | |
Simon Glass | 42f9f91 | 2017-07-27 09:31:03 -0600 | [diff] [blame] | 212 | /** |
| 213 | * console_dev_is_serial() - Check if a stdio device is a serial device |
| 214 | * |
| 215 | * @sdev: Device to check |
Simon Glass | 7b3c4c3 | 2017-07-27 09:31:04 -0600 | [diff] [blame] | 216 | * @return true if this device is in the serial uclass (or for pre-driver-model, |
| 217 | * whether it is called "serial". |
Simon Glass | 42f9f91 | 2017-07-27 09:31:03 -0600 | [diff] [blame] | 218 | */ |
| 219 | static bool console_dev_is_serial(struct stdio_dev *sdev) |
| 220 | { |
| 221 | bool is_serial; |
| 222 | |
Patrick Delaunay | c04f856 | 2020-12-18 12:46:43 +0100 | [diff] [blame] | 223 | if (IS_ENABLED(CONFIG_DM_SERIAL) && (sdev->flags & DEV_FLAGS_DM)) { |
Simon Glass | 7b3c4c3 | 2017-07-27 09:31:04 -0600 | [diff] [blame] | 224 | struct udevice *dev = sdev->priv; |
| 225 | |
| 226 | is_serial = device_get_uclass_id(dev) == UCLASS_SERIAL; |
Patrick Delaunay | c04f856 | 2020-12-18 12:46:43 +0100 | [diff] [blame] | 227 | } else { |
| 228 | is_serial = !strcmp(sdev->name, "serial"); |
| 229 | } |
Simon Glass | 42f9f91 | 2017-07-27 09:31:03 -0600 | [diff] [blame] | 230 | |
| 231 | return is_serial; |
| 232 | } |
| 233 | |
Simon Glass | b026542 | 2017-01-16 07:03:26 -0700 | [diff] [blame] | 234 | #if CONFIG_IS_ENABLED(CONSOLE_MUX) |
Gary Jennejohn | 16a28ef | 2008-11-06 15:04:23 +0100 | [diff] [blame] | 235 | /** Console I/O multiplexing *******************************************/ |
| 236 | |
Patrick Delaunay | a17b38c | 2020-12-18 12:46:46 +0100 | [diff] [blame] | 237 | /* tstcdev: save the last stdio device with pending characters, with tstc != 0 */ |
Jean-Christophe PLAGNIOL-VILLARD | 52cb4d4 | 2009-05-16 12:14:54 +0200 | [diff] [blame] | 238 | static struct stdio_dev *tstcdev; |
| 239 | struct stdio_dev **console_devices[MAX_FILES]; |
Gary Jennejohn | 16a28ef | 2008-11-06 15:04:23 +0100 | [diff] [blame] | 240 | int cd_count[MAX_FILES]; |
| 241 | |
Andy Shevchenko | 09d8f07 | 2021-02-11 17:09:39 +0200 | [diff] [blame] | 242 | static void console_devices_set(int file, struct stdio_dev *dev) |
Patrick Delaunay | 45375ad | 2020-12-18 12:46:44 +0100 | [diff] [blame] | 243 | { |
| 244 | console_devices[file][0] = dev; |
Andy Shevchenko | 20a7d35 | 2021-02-11 17:09:38 +0200 | [diff] [blame] | 245 | cd_count[file] = 1; |
Patrick Delaunay | 45375ad | 2020-12-18 12:46:44 +0100 | [diff] [blame] | 246 | } |
| 247 | |
Andy Shevchenko | 95aaf40 | 2020-12-21 14:30:01 +0200 | [diff] [blame] | 248 | /** |
| 249 | * console_needs_start_stop() - check if we need to start or stop the STDIO device |
| 250 | * @file: STDIO file |
| 251 | * @sdev: STDIO device in question |
| 252 | * |
| 253 | * This function checks if we need to start or stop the stdio device used for |
| 254 | * a console. For IOMUX case it simply enforces one time start and one time |
| 255 | * stop of the device independently of how many STDIO files are using it. In |
| 256 | * other words, we start console once before first STDIO device wants it and |
| 257 | * stop after the last is gone. |
| 258 | */ |
| 259 | static bool console_needs_start_stop(int file, struct stdio_dev *sdev) |
| 260 | { |
Andy Shevchenko | b672c16 | 2021-02-11 17:09:41 +0200 | [diff] [blame] | 261 | int i; |
Andy Shevchenko | 95aaf40 | 2020-12-21 14:30:01 +0200 | [diff] [blame] | 262 | |
| 263 | for (i = 0; i < ARRAY_SIZE(cd_count); i++) { |
| 264 | if (i == file) |
| 265 | continue; |
| 266 | |
Andy Shevchenko | b672c16 | 2021-02-11 17:09:41 +0200 | [diff] [blame] | 267 | if (iomux_match_device(console_devices[i], cd_count[i], sdev) >= 0) |
| 268 | return false; |
Andy Shevchenko | 95aaf40 | 2020-12-21 14:30:01 +0200 | [diff] [blame] | 269 | } |
| 270 | return true; |
| 271 | } |
| 272 | |
Gary Jennejohn | 16a28ef | 2008-11-06 15:04:23 +0100 | [diff] [blame] | 273 | /* |
Heinrich Schuchardt | c670aee | 2020-10-07 18:11:48 +0200 | [diff] [blame] | 274 | * This depends on tstc() always being called before getchar(). |
Gary Jennejohn | 16a28ef | 2008-11-06 15:04:23 +0100 | [diff] [blame] | 275 | * This is guaranteed to be true because this routine is called |
| 276 | * only from fgetc() which assures it. |
| 277 | * No attempt is made to demultiplex multiple input sources. |
| 278 | */ |
Jean-Christophe PLAGNIOL-VILLARD | 5f03201 | 2009-02-01 17:07:52 +0100 | [diff] [blame] | 279 | static int console_getc(int file) |
Gary Jennejohn | 16a28ef | 2008-11-06 15:04:23 +0100 | [diff] [blame] | 280 | { |
| 281 | unsigned char ret; |
| 282 | |
| 283 | /* This is never called with testcdev == NULL */ |
Simon Glass | 709ea54 | 2014-07-23 06:54:59 -0600 | [diff] [blame] | 284 | ret = tstcdev->getc(tstcdev); |
Gary Jennejohn | 16a28ef | 2008-11-06 15:04:23 +0100 | [diff] [blame] | 285 | tstcdev = NULL; |
| 286 | return ret; |
| 287 | } |
| 288 | |
Patrick Delaunay | a17b38c | 2020-12-18 12:46:46 +0100 | [diff] [blame] | 289 | /* Upper layer may have already called tstc(): check the saved result */ |
| 290 | static bool console_has_tstc(void) |
| 291 | { |
| 292 | return !!tstcdev; |
| 293 | } |
| 294 | |
Jean-Christophe PLAGNIOL-VILLARD | 5f03201 | 2009-02-01 17:07:52 +0100 | [diff] [blame] | 295 | static int console_tstc(int file) |
Gary Jennejohn | 16a28ef | 2008-11-06 15:04:23 +0100 | [diff] [blame] | 296 | { |
| 297 | int i, ret; |
Jean-Christophe PLAGNIOL-VILLARD | 52cb4d4 | 2009-05-16 12:14:54 +0200 | [diff] [blame] | 298 | struct stdio_dev *dev; |
Joe Hershberger | b2f58d8 | 2018-07-02 20:06:48 -0500 | [diff] [blame] | 299 | int prev; |
Gary Jennejohn | 16a28ef | 2008-11-06 15:04:23 +0100 | [diff] [blame] | 300 | |
Joe Hershberger | b2f58d8 | 2018-07-02 20:06:48 -0500 | [diff] [blame] | 301 | prev = disable_ctrlc(1); |
Andy Shevchenko | 400797c | 2021-02-11 17:09:42 +0200 | [diff] [blame] | 302 | for_each_console_dev(i, file, dev) { |
Gary Jennejohn | 16a28ef | 2008-11-06 15:04:23 +0100 | [diff] [blame] | 303 | if (dev->tstc != NULL) { |
Simon Glass | 709ea54 | 2014-07-23 06:54:59 -0600 | [diff] [blame] | 304 | ret = dev->tstc(dev); |
Gary Jennejohn | 16a28ef | 2008-11-06 15:04:23 +0100 | [diff] [blame] | 305 | if (ret > 0) { |
| 306 | tstcdev = dev; |
Joe Hershberger | b2f58d8 | 2018-07-02 20:06:48 -0500 | [diff] [blame] | 307 | disable_ctrlc(prev); |
Gary Jennejohn | 16a28ef | 2008-11-06 15:04:23 +0100 | [diff] [blame] | 308 | return ret; |
| 309 | } |
| 310 | } |
| 311 | } |
Joe Hershberger | b2f58d8 | 2018-07-02 20:06:48 -0500 | [diff] [blame] | 312 | disable_ctrlc(prev); |
Gary Jennejohn | 16a28ef | 2008-11-06 15:04:23 +0100 | [diff] [blame] | 313 | |
| 314 | return 0; |
| 315 | } |
| 316 | |
Jean-Christophe PLAGNIOL-VILLARD | 5f03201 | 2009-02-01 17:07:52 +0100 | [diff] [blame] | 317 | static void console_putc(int file, const char c) |
Gary Jennejohn | 16a28ef | 2008-11-06 15:04:23 +0100 | [diff] [blame] | 318 | { |
| 319 | int i; |
Jean-Christophe PLAGNIOL-VILLARD | 52cb4d4 | 2009-05-16 12:14:54 +0200 | [diff] [blame] | 320 | struct stdio_dev *dev; |
Gary Jennejohn | 16a28ef | 2008-11-06 15:04:23 +0100 | [diff] [blame] | 321 | |
Andy Shevchenko | 400797c | 2021-02-11 17:09:42 +0200 | [diff] [blame] | 322 | for_each_console_dev(i, file, dev) { |
Gary Jennejohn | 16a28ef | 2008-11-06 15:04:23 +0100 | [diff] [blame] | 323 | if (dev->putc != NULL) |
Simon Glass | 709ea54 | 2014-07-23 06:54:59 -0600 | [diff] [blame] | 324 | dev->putc(dev, c); |
Gary Jennejohn | 16a28ef | 2008-11-06 15:04:23 +0100 | [diff] [blame] | 325 | } |
| 326 | } |
| 327 | |
Simon Glass | 493a4c8 | 2020-07-02 21:12:13 -0600 | [diff] [blame] | 328 | /** |
| 329 | * console_puts_select() - Output a string to all console devices |
| 330 | * |
| 331 | * @file: File number to output to (e,g, stdout, see stdio.h) |
| 332 | * @serial_only: true to output only to serial, false to output to everything |
| 333 | * else |
| 334 | * @s: String to output |
| 335 | */ |
| 336 | static void console_puts_select(int file, bool serial_only, const char *s) |
Siarhei Siamashka | 2766966 | 2015-01-08 09:02:31 +0200 | [diff] [blame] | 337 | { |
| 338 | int i; |
| 339 | struct stdio_dev *dev; |
| 340 | |
Andy Shevchenko | 400797c | 2021-02-11 17:09:42 +0200 | [diff] [blame] | 341 | for_each_console_dev(i, file, dev) { |
| 342 | bool is_serial = console_dev_is_serial(dev); |
Simon Glass | 493a4c8 | 2020-07-02 21:12:13 -0600 | [diff] [blame] | 343 | |
Simon Glass | 493a4c8 | 2020-07-02 21:12:13 -0600 | [diff] [blame] | 344 | if (dev->puts && serial_only == is_serial) |
Hans de Goede | a8552c7 | 2015-05-05 13:13:36 +0200 | [diff] [blame] | 345 | dev->puts(dev, s); |
Siarhei Siamashka | 2766966 | 2015-01-08 09:02:31 +0200 | [diff] [blame] | 346 | } |
| 347 | } |
Siarhei Siamashka | 2766966 | 2015-01-08 09:02:31 +0200 | [diff] [blame] | 348 | |
Simon Glass | 493a4c8 | 2020-07-02 21:12:13 -0600 | [diff] [blame] | 349 | void console_puts_select_stderr(bool serial_only, const char *s) |
| 350 | { |
| 351 | console_puts_select(stderr, serial_only, s); |
| 352 | } |
| 353 | |
Jean-Christophe PLAGNIOL-VILLARD | 5f03201 | 2009-02-01 17:07:52 +0100 | [diff] [blame] | 354 | static void console_puts(int file, const char *s) |
Gary Jennejohn | 16a28ef | 2008-11-06 15:04:23 +0100 | [diff] [blame] | 355 | { |
| 356 | int i; |
Jean-Christophe PLAGNIOL-VILLARD | 52cb4d4 | 2009-05-16 12:14:54 +0200 | [diff] [blame] | 357 | struct stdio_dev *dev; |
Gary Jennejohn | 16a28ef | 2008-11-06 15:04:23 +0100 | [diff] [blame] | 358 | |
Andy Shevchenko | 400797c | 2021-02-11 17:09:42 +0200 | [diff] [blame] | 359 | for_each_console_dev(i, file, dev) { |
Gary Jennejohn | 16a28ef | 2008-11-06 15:04:23 +0100 | [diff] [blame] | 360 | if (dev->puts != NULL) |
Simon Glass | 709ea54 | 2014-07-23 06:54:59 -0600 | [diff] [blame] | 361 | dev->puts(dev, s); |
Gary Jennejohn | 16a28ef | 2008-11-06 15:04:23 +0100 | [diff] [blame] | 362 | } |
| 363 | } |
Jean-Christophe PLAGNIOL-VILLARD | 5f03201 | 2009-02-01 17:07:52 +0100 | [diff] [blame] | 364 | |
Tom Rini | 5e63c96 | 2019-10-30 09:18:43 -0400 | [diff] [blame] | 365 | #if CONFIG_IS_ENABLED(SYS_CONSOLE_IS_IN_ENV) |
Jean-Christophe PLAGNIOL-VILLARD | 52cb4d4 | 2009-05-16 12:14:54 +0200 | [diff] [blame] | 366 | static inline void console_doenv(int file, struct stdio_dev *dev) |
Jean-Christophe PLAGNIOL-VILLARD | 5f03201 | 2009-02-01 17:07:52 +0100 | [diff] [blame] | 367 | { |
| 368 | iomux_doenv(file, dev->name); |
| 369 | } |
Tom Rini | 5e63c96 | 2019-10-30 09:18:43 -0400 | [diff] [blame] | 370 | #endif |
Jean-Christophe PLAGNIOL-VILLARD | 5f03201 | 2009-02-01 17:07:52 +0100 | [diff] [blame] | 371 | #else |
Patrick Delaunay | 45375ad | 2020-12-18 12:46:44 +0100 | [diff] [blame] | 372 | |
Andy Shevchenko | 09d8f07 | 2021-02-11 17:09:39 +0200 | [diff] [blame] | 373 | static void console_devices_set(int file, struct stdio_dev *dev) |
Patrick Delaunay | 45375ad | 2020-12-18 12:46:44 +0100 | [diff] [blame] | 374 | { |
| 375 | } |
| 376 | |
Andy Shevchenko | 95aaf40 | 2020-12-21 14:30:01 +0200 | [diff] [blame] | 377 | static inline bool console_needs_start_stop(int file, struct stdio_dev *sdev) |
| 378 | { |
| 379 | return true; |
| 380 | } |
| 381 | |
Jean-Christophe PLAGNIOL-VILLARD | 5f03201 | 2009-02-01 17:07:52 +0100 | [diff] [blame] | 382 | static inline int console_getc(int file) |
| 383 | { |
Simon Glass | 709ea54 | 2014-07-23 06:54:59 -0600 | [diff] [blame] | 384 | return stdio_devices[file]->getc(stdio_devices[file]); |
Jean-Christophe PLAGNIOL-VILLARD | 5f03201 | 2009-02-01 17:07:52 +0100 | [diff] [blame] | 385 | } |
| 386 | |
Patrick Delaunay | a17b38c | 2020-12-18 12:46:46 +0100 | [diff] [blame] | 387 | static bool console_has_tstc(void) |
| 388 | { |
| 389 | return false; |
| 390 | } |
| 391 | |
Jean-Christophe PLAGNIOL-VILLARD | 5f03201 | 2009-02-01 17:07:52 +0100 | [diff] [blame] | 392 | static inline int console_tstc(int file) |
| 393 | { |
Simon Glass | 709ea54 | 2014-07-23 06:54:59 -0600 | [diff] [blame] | 394 | return stdio_devices[file]->tstc(stdio_devices[file]); |
Jean-Christophe PLAGNIOL-VILLARD | 5f03201 | 2009-02-01 17:07:52 +0100 | [diff] [blame] | 395 | } |
| 396 | |
| 397 | static inline void console_putc(int file, const char c) |
| 398 | { |
Simon Glass | 709ea54 | 2014-07-23 06:54:59 -0600 | [diff] [blame] | 399 | stdio_devices[file]->putc(stdio_devices[file], c); |
Jean-Christophe PLAGNIOL-VILLARD | 5f03201 | 2009-02-01 17:07:52 +0100 | [diff] [blame] | 400 | } |
| 401 | |
Simon Glass | 493a4c8 | 2020-07-02 21:12:13 -0600 | [diff] [blame] | 402 | void console_puts_select(int file, bool serial_only, const char *s) |
Siarhei Siamashka | 2766966 | 2015-01-08 09:02:31 +0200 | [diff] [blame] | 403 | { |
Simon Glass | 493a4c8 | 2020-07-02 21:12:13 -0600 | [diff] [blame] | 404 | if (serial_only == console_dev_is_serial(stdio_devices[file])) |
Hans de Goede | a8552c7 | 2015-05-05 13:13:36 +0200 | [diff] [blame] | 405 | stdio_devices[file]->puts(stdio_devices[file], s); |
Siarhei Siamashka | 2766966 | 2015-01-08 09:02:31 +0200 | [diff] [blame] | 406 | } |
Siarhei Siamashka | 2766966 | 2015-01-08 09:02:31 +0200 | [diff] [blame] | 407 | |
Jean-Christophe PLAGNIOL-VILLARD | 5f03201 | 2009-02-01 17:07:52 +0100 | [diff] [blame] | 408 | static inline void console_puts(int file, const char *s) |
| 409 | { |
Simon Glass | 709ea54 | 2014-07-23 06:54:59 -0600 | [diff] [blame] | 410 | stdio_devices[file]->puts(stdio_devices[file], s); |
Jean-Christophe PLAGNIOL-VILLARD | 5f03201 | 2009-02-01 17:07:52 +0100 | [diff] [blame] | 411 | } |
| 412 | |
Tom Rini | 5e63c96 | 2019-10-30 09:18:43 -0400 | [diff] [blame] | 413 | #if CONFIG_IS_ENABLED(SYS_CONSOLE_IS_IN_ENV) |
Jean-Christophe PLAGNIOL-VILLARD | 52cb4d4 | 2009-05-16 12:14:54 +0200 | [diff] [blame] | 414 | static inline void console_doenv(int file, struct stdio_dev *dev) |
Jean-Christophe PLAGNIOL-VILLARD | 5f03201 | 2009-02-01 17:07:52 +0100 | [diff] [blame] | 415 | { |
| 416 | console_setfile(file, dev); |
| 417 | } |
Tom Rini | 5e63c96 | 2019-10-30 09:18:43 -0400 | [diff] [blame] | 418 | #endif |
Simon Glass | b026542 | 2017-01-16 07:03:26 -0700 | [diff] [blame] | 419 | #endif /* CONIFIG_IS_ENABLED(CONSOLE_MUX) */ |
Gary Jennejohn | 16a28ef | 2008-11-06 15:04:23 +0100 | [diff] [blame] | 420 | |
Andy Shevchenko | 09d8f07 | 2021-02-11 17:09:39 +0200 | [diff] [blame] | 421 | static void __maybe_unused console_setfile_and_devices(int file, struct stdio_dev *dev) |
| 422 | { |
| 423 | console_setfile(file, dev); |
| 424 | console_devices_set(file, dev); |
| 425 | } |
| 426 | |
Andy Shevchenko | 41f668b | 2020-12-21 14:30:00 +0200 | [diff] [blame] | 427 | int console_start(int file, struct stdio_dev *sdev) |
| 428 | { |
| 429 | int error; |
| 430 | |
Andy Shevchenko | 95aaf40 | 2020-12-21 14:30:01 +0200 | [diff] [blame] | 431 | if (!console_needs_start_stop(file, sdev)) |
| 432 | return 0; |
| 433 | |
Andy Shevchenko | 41f668b | 2020-12-21 14:30:00 +0200 | [diff] [blame] | 434 | /* Start new device */ |
| 435 | if (sdev->start) { |
| 436 | error = sdev->start(sdev); |
| 437 | /* If it's not started don't use it */ |
| 438 | if (error < 0) |
| 439 | return error; |
| 440 | } |
| 441 | return 0; |
| 442 | } |
| 443 | |
| 444 | void console_stop(int file, struct stdio_dev *sdev) |
| 445 | { |
Andy Shevchenko | 95aaf40 | 2020-12-21 14:30:01 +0200 | [diff] [blame] | 446 | if (!console_needs_start_stop(file, sdev)) |
| 447 | return; |
| 448 | |
Andy Shevchenko | 41f668b | 2020-12-21 14:30:00 +0200 | [diff] [blame] | 449 | if (sdev->stop) |
| 450 | sdev->stop(sdev); |
| 451 | } |
| 452 | |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 453 | /** U-Boot INITIAL CONSOLE-NOT COMPATIBLE FUNCTIONS *************************/ |
| 454 | |
Wolfgang Denk | d9c2725 | 2010-06-20 17:14:14 +0200 | [diff] [blame] | 455 | int serial_printf(const char *fmt, ...) |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 456 | { |
| 457 | va_list args; |
| 458 | uint i; |
Jean-Christophe PLAGNIOL-VILLARD | 6d0f6bc | 2008-10-16 15:01:15 +0200 | [diff] [blame] | 459 | char printbuffer[CONFIG_SYS_PBSIZE]; |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 460 | |
Jean-Christophe PLAGNIOL-VILLARD | ec6f149 | 2009-02-01 17:07:51 +0100 | [diff] [blame] | 461 | va_start(args, fmt); |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 462 | |
| 463 | /* For this to work, printbuffer must be larger than |
| 464 | * anything we ever want to print. |
| 465 | */ |
Sonny Rao | 068af6f | 2011-10-10 09:22:31 +0000 | [diff] [blame] | 466 | i = vscnprintf(printbuffer, sizeof(printbuffer), fmt, args); |
Jean-Christophe PLAGNIOL-VILLARD | ec6f149 | 2009-02-01 17:07:51 +0100 | [diff] [blame] | 467 | va_end(args); |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 468 | |
Jean-Christophe PLAGNIOL-VILLARD | ec6f149 | 2009-02-01 17:07:51 +0100 | [diff] [blame] | 469 | serial_puts(printbuffer); |
Wolfgang Denk | d9c2725 | 2010-06-20 17:14:14 +0200 | [diff] [blame] | 470 | return i; |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 471 | } |
| 472 | |
Jean-Christophe PLAGNIOL-VILLARD | ec6f149 | 2009-02-01 17:07:51 +0100 | [diff] [blame] | 473 | int fgetc(int file) |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 474 | { |
Gary Jennejohn | 16a28ef | 2008-11-06 15:04:23 +0100 | [diff] [blame] | 475 | if (file < MAX_FILES) { |
Gary Jennejohn | 16a28ef | 2008-11-06 15:04:23 +0100 | [diff] [blame] | 476 | /* |
| 477 | * Effectively poll for input wherever it may be available. |
| 478 | */ |
| 479 | for (;;) { |
Andreas J. Reichel | 6440746 | 2016-07-13 12:56:51 +0200 | [diff] [blame] | 480 | WATCHDOG_RESET(); |
Patrick Delaunay | a17b38c | 2020-12-18 12:46:46 +0100 | [diff] [blame] | 481 | if (CONFIG_IS_ENABLED(CONSOLE_MUX)) { |
| 482 | /* |
| 483 | * Upper layer may have already called tstc() so |
| 484 | * check for that first. |
| 485 | */ |
| 486 | if (console_has_tstc()) |
| 487 | return console_getc(file); |
| 488 | console_tstc(file); |
| 489 | } else { |
| 490 | if (console_tstc(file)) |
| 491 | return console_getc(file); |
| 492 | } |
| 493 | |
Gary Jennejohn | 16a28ef | 2008-11-06 15:04:23 +0100 | [diff] [blame] | 494 | /* |
| 495 | * If the watchdog must be rate-limited then it should |
| 496 | * already be handled in board-specific code. |
| 497 | */ |
Patrick Delaunay | c04f856 | 2020-12-18 12:46:43 +0100 | [diff] [blame] | 498 | if (IS_ENABLED(CONFIG_WATCHDOG)) |
| 499 | udelay(1); |
Gary Jennejohn | 16a28ef | 2008-11-06 15:04:23 +0100 | [diff] [blame] | 500 | } |
Gary Jennejohn | 16a28ef | 2008-11-06 15:04:23 +0100 | [diff] [blame] | 501 | } |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 502 | |
| 503 | return -1; |
| 504 | } |
| 505 | |
Jean-Christophe PLAGNIOL-VILLARD | ec6f149 | 2009-02-01 17:07:51 +0100 | [diff] [blame] | 506 | int ftstc(int file) |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 507 | { |
| 508 | if (file < MAX_FILES) |
Jean-Christophe PLAGNIOL-VILLARD | 5f03201 | 2009-02-01 17:07:52 +0100 | [diff] [blame] | 509 | return console_tstc(file); |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 510 | |
| 511 | return -1; |
| 512 | } |
| 513 | |
Jean-Christophe PLAGNIOL-VILLARD | ec6f149 | 2009-02-01 17:07:51 +0100 | [diff] [blame] | 514 | void fputc(int file, const char c) |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 515 | { |
| 516 | if (file < MAX_FILES) |
Jean-Christophe PLAGNIOL-VILLARD | 5f03201 | 2009-02-01 17:07:52 +0100 | [diff] [blame] | 517 | console_putc(file, c); |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 518 | } |
| 519 | |
Jean-Christophe PLAGNIOL-VILLARD | ec6f149 | 2009-02-01 17:07:51 +0100 | [diff] [blame] | 520 | void fputs(int file, const char *s) |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 521 | { |
| 522 | if (file < MAX_FILES) |
Jean-Christophe PLAGNIOL-VILLARD | 5f03201 | 2009-02-01 17:07:52 +0100 | [diff] [blame] | 523 | console_puts(file, s); |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 524 | } |
| 525 | |
Wolfgang Denk | d9c2725 | 2010-06-20 17:14:14 +0200 | [diff] [blame] | 526 | int fprintf(int file, const char *fmt, ...) |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 527 | { |
| 528 | va_list args; |
| 529 | uint i; |
Jean-Christophe PLAGNIOL-VILLARD | 6d0f6bc | 2008-10-16 15:01:15 +0200 | [diff] [blame] | 530 | char printbuffer[CONFIG_SYS_PBSIZE]; |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 531 | |
Jean-Christophe PLAGNIOL-VILLARD | ec6f149 | 2009-02-01 17:07:51 +0100 | [diff] [blame] | 532 | va_start(args, fmt); |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 533 | |
| 534 | /* For this to work, printbuffer must be larger than |
| 535 | * anything we ever want to print. |
| 536 | */ |
Sonny Rao | 068af6f | 2011-10-10 09:22:31 +0000 | [diff] [blame] | 537 | i = vscnprintf(printbuffer, sizeof(printbuffer), fmt, args); |
Jean-Christophe PLAGNIOL-VILLARD | ec6f149 | 2009-02-01 17:07:51 +0100 | [diff] [blame] | 538 | va_end(args); |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 539 | |
| 540 | /* Send to desired file */ |
Jean-Christophe PLAGNIOL-VILLARD | ec6f149 | 2009-02-01 17:07:51 +0100 | [diff] [blame] | 541 | fputs(file, printbuffer); |
Wolfgang Denk | d9c2725 | 2010-06-20 17:14:14 +0200 | [diff] [blame] | 542 | return i; |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 543 | } |
| 544 | |
| 545 | /** U-Boot INITIAL CONSOLE-COMPATIBLE FUNCTION *****************************/ |
| 546 | |
Heinrich Schuchardt | c670aee | 2020-10-07 18:11:48 +0200 | [diff] [blame] | 547 | int getchar(void) |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 548 | { |
Patrick Delaunay | 1e99371 | 2020-12-18 12:46:45 +0100 | [diff] [blame] | 549 | int ch; |
| 550 | |
Patrick Delaunay | c04f856 | 2020-12-18 12:46:43 +0100 | [diff] [blame] | 551 | if (IS_ENABLED(CONFIG_DISABLE_CONSOLE) && (gd->flags & GD_FLG_DISABLE_CONSOLE)) |
Mark Jackson | f5c3ba7 | 2008-08-25 19:21:30 +0100 | [diff] [blame] | 552 | return 0; |
Mark Jackson | f5c3ba7 | 2008-08-25 19:21:30 +0100 | [diff] [blame] | 553 | |
Graeme Russ | e3e454c | 2011-08-29 02:14:05 +0000 | [diff] [blame] | 554 | if (!gd->have_console) |
| 555 | return 0; |
| 556 | |
Patrick Delaunay | 1e99371 | 2020-12-18 12:46:45 +0100 | [diff] [blame] | 557 | ch = console_record_getc(); |
| 558 | if (ch != -1) |
| 559 | return ch; |
Simon Glass | 9854a87 | 2015-11-08 23:47:48 -0700 | [diff] [blame] | 560 | |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 561 | if (gd->flags & GD_FLG_DEVINIT) { |
| 562 | /* Get from the standard input */ |
Jean-Christophe PLAGNIOL-VILLARD | ec6f149 | 2009-02-01 17:07:51 +0100 | [diff] [blame] | 563 | return fgetc(stdin); |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 564 | } |
| 565 | |
| 566 | /* Send directly to the handler */ |
Jean-Christophe PLAGNIOL-VILLARD | ec6f149 | 2009-02-01 17:07:51 +0100 | [diff] [blame] | 567 | return serial_getc(); |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 568 | } |
| 569 | |
Jean-Christophe PLAGNIOL-VILLARD | ec6f149 | 2009-02-01 17:07:51 +0100 | [diff] [blame] | 570 | int tstc(void) |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 571 | { |
Patrick Delaunay | c04f856 | 2020-12-18 12:46:43 +0100 | [diff] [blame] | 572 | if (IS_ENABLED(CONFIG_DISABLE_CONSOLE) && (gd->flags & GD_FLG_DISABLE_CONSOLE)) |
Mark Jackson | f5c3ba7 | 2008-08-25 19:21:30 +0100 | [diff] [blame] | 573 | return 0; |
Mark Jackson | f5c3ba7 | 2008-08-25 19:21:30 +0100 | [diff] [blame] | 574 | |
Graeme Russ | e3e454c | 2011-08-29 02:14:05 +0000 | [diff] [blame] | 575 | if (!gd->have_console) |
| 576 | return 0; |
Patrick Delaunay | 1e99371 | 2020-12-18 12:46:45 +0100 | [diff] [blame] | 577 | |
| 578 | if (console_record_tstc()) |
| 579 | return 1; |
| 580 | |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 581 | if (gd->flags & GD_FLG_DEVINIT) { |
| 582 | /* Test the standard input */ |
Jean-Christophe PLAGNIOL-VILLARD | ec6f149 | 2009-02-01 17:07:51 +0100 | [diff] [blame] | 583 | return ftstc(stdin); |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 584 | } |
| 585 | |
| 586 | /* Send directly to the handler */ |
Jean-Christophe PLAGNIOL-VILLARD | ec6f149 | 2009-02-01 17:07:51 +0100 | [diff] [blame] | 587 | return serial_tstc(); |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 588 | } |
| 589 | |
Siarhei Siamashka | 2766966 | 2015-01-08 09:02:31 +0200 | [diff] [blame] | 590 | #define PRE_CONSOLE_FLUSHPOINT1_SERIAL 0 |
| 591 | #define PRE_CONSOLE_FLUSHPOINT2_EVERYTHING_BUT_SERIAL 1 |
| 592 | |
Simon Glass | 8f92558 | 2016-10-17 20:12:36 -0600 | [diff] [blame] | 593 | #if CONFIG_IS_ENABLED(PRE_CONSOLE_BUFFER) |
Graeme Russ | 9558b48 | 2011-09-01 00:48:27 +0000 | [diff] [blame] | 594 | #define CIRC_BUF_IDX(idx) ((idx) % (unsigned long)CONFIG_PRE_CON_BUF_SZ) |
| 595 | |
| 596 | static void pre_console_putc(const char c) |
| 597 | { |
Simon Glass | 4e6bafa | 2017-06-15 21:37:52 -0600 | [diff] [blame] | 598 | char *buffer; |
| 599 | |
| 600 | buffer = map_sysmem(CONFIG_PRE_CON_BUF_ADDR, CONFIG_PRE_CON_BUF_SZ); |
Graeme Russ | 9558b48 | 2011-09-01 00:48:27 +0000 | [diff] [blame] | 601 | |
| 602 | buffer[CIRC_BUF_IDX(gd->precon_buf_idx++)] = c; |
Simon Glass | 4e6bafa | 2017-06-15 21:37:52 -0600 | [diff] [blame] | 603 | |
| 604 | unmap_sysmem(buffer); |
Graeme Russ | 9558b48 | 2011-09-01 00:48:27 +0000 | [diff] [blame] | 605 | } |
| 606 | |
Soeren Moch | be135cc | 2017-11-04 16:14:09 +0100 | [diff] [blame] | 607 | static void pre_console_puts(const char *s) |
| 608 | { |
| 609 | while (*s) |
| 610 | pre_console_putc(*s++); |
| 611 | } |
| 612 | |
Siarhei Siamashka | 2766966 | 2015-01-08 09:02:31 +0200 | [diff] [blame] | 613 | static void print_pre_console_buffer(int flushpoint) |
Graeme Russ | 9558b48 | 2011-09-01 00:48:27 +0000 | [diff] [blame] | 614 | { |
Hans de Goede | a8552c7 | 2015-05-05 13:13:36 +0200 | [diff] [blame] | 615 | unsigned long in = 0, out = 0; |
Hans de Goede | a8552c7 | 2015-05-05 13:13:36 +0200 | [diff] [blame] | 616 | char buf_out[CONFIG_PRE_CON_BUF_SZ + 1]; |
Simon Glass | 4e6bafa | 2017-06-15 21:37:52 -0600 | [diff] [blame] | 617 | char *buf_in; |
Graeme Russ | 9558b48 | 2011-09-01 00:48:27 +0000 | [diff] [blame] | 618 | |
Patrick Delaunay | c04f856 | 2020-12-18 12:46:43 +0100 | [diff] [blame] | 619 | if (IS_ENABLED(CONFIG_SILENT_CONSOLE) && (gd->flags & GD_FLG_SILENT)) |
Patrick Delaunay | 13551b9 | 2019-08-02 14:58:10 +0200 | [diff] [blame] | 620 | return; |
Patrick Delaunay | 13551b9 | 2019-08-02 14:58:10 +0200 | [diff] [blame] | 621 | |
Simon Glass | 4e6bafa | 2017-06-15 21:37:52 -0600 | [diff] [blame] | 622 | buf_in = map_sysmem(CONFIG_PRE_CON_BUF_ADDR, CONFIG_PRE_CON_BUF_SZ); |
Graeme Russ | 9558b48 | 2011-09-01 00:48:27 +0000 | [diff] [blame] | 623 | if (gd->precon_buf_idx > CONFIG_PRE_CON_BUF_SZ) |
Hans de Goede | a8552c7 | 2015-05-05 13:13:36 +0200 | [diff] [blame] | 624 | in = gd->precon_buf_idx - CONFIG_PRE_CON_BUF_SZ; |
Graeme Russ | 9558b48 | 2011-09-01 00:48:27 +0000 | [diff] [blame] | 625 | |
Hans de Goede | a8552c7 | 2015-05-05 13:13:36 +0200 | [diff] [blame] | 626 | while (in < gd->precon_buf_idx) |
| 627 | buf_out[out++] = buf_in[CIRC_BUF_IDX(in++)]; |
Simon Glass | 4e6bafa | 2017-06-15 21:37:52 -0600 | [diff] [blame] | 628 | unmap_sysmem(buf_in); |
Hans de Goede | a8552c7 | 2015-05-05 13:13:36 +0200 | [diff] [blame] | 629 | |
| 630 | buf_out[out] = 0; |
| 631 | |
| 632 | switch (flushpoint) { |
| 633 | case PRE_CONSOLE_FLUSHPOINT1_SERIAL: |
| 634 | puts(buf_out); |
| 635 | break; |
| 636 | case PRE_CONSOLE_FLUSHPOINT2_EVERYTHING_BUT_SERIAL: |
Simon Glass | 493a4c8 | 2020-07-02 21:12:13 -0600 | [diff] [blame] | 637 | console_puts_select(stdout, false, buf_out); |
Hans de Goede | a8552c7 | 2015-05-05 13:13:36 +0200 | [diff] [blame] | 638 | break; |
| 639 | } |
Graeme Russ | 9558b48 | 2011-09-01 00:48:27 +0000 | [diff] [blame] | 640 | } |
| 641 | #else |
| 642 | static inline void pre_console_putc(const char c) {} |
Soeren Moch | be135cc | 2017-11-04 16:14:09 +0100 | [diff] [blame] | 643 | static inline void pre_console_puts(const char *s) {} |
Siarhei Siamashka | 2766966 | 2015-01-08 09:02:31 +0200 | [diff] [blame] | 644 | static inline void print_pre_console_buffer(int flushpoint) {} |
Graeme Russ | 9558b48 | 2011-09-01 00:48:27 +0000 | [diff] [blame] | 645 | #endif |
| 646 | |
Jean-Christophe PLAGNIOL-VILLARD | ec6f149 | 2009-02-01 17:07:51 +0100 | [diff] [blame] | 647 | void putc(const char c) |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 648 | { |
Patrick Delaunay | 93cdb52 | 2020-11-27 11:20:56 +0100 | [diff] [blame] | 649 | if (!gd) |
| 650 | return; |
Patrick Delaunay | 1e99371 | 2020-12-18 12:46:45 +0100 | [diff] [blame] | 651 | |
| 652 | console_record_putc(c); |
| 653 | |
Simon Glass | 64e9b4f | 2017-12-04 13:48:19 -0700 | [diff] [blame] | 654 | /* sandbox can send characters to stdout before it has a console */ |
Patrick Delaunay | c04f856 | 2020-12-18 12:46:43 +0100 | [diff] [blame] | 655 | if (IS_ENABLED(CONFIG_SANDBOX) && !(gd->flags & GD_FLG_SERIAL_READY)) { |
Simon Glass | 64e9b4f | 2017-12-04 13:48:19 -0700 | [diff] [blame] | 656 | os_putc(c); |
| 657 | return; |
| 658 | } |
Patrick Delaunay | c04f856 | 2020-12-18 12:46:43 +0100 | [diff] [blame] | 659 | |
Simon Glass | d6ea530 | 2015-06-23 15:38:33 -0600 | [diff] [blame] | 660 | /* if we don't have a console yet, use the debug UART */ |
Patrick Delaunay | c04f856 | 2020-12-18 12:46:43 +0100 | [diff] [blame] | 661 | if (IS_ENABLED(CONFIG_DEBUG_UART) && !(gd->flags & GD_FLG_SERIAL_READY)) { |
Simon Glass | d6ea530 | 2015-06-23 15:38:33 -0600 | [diff] [blame] | 662 | printch(c); |
| 663 | return; |
| 664 | } |
Patrick Delaunay | c04f856 | 2020-12-18 12:46:43 +0100 | [diff] [blame] | 665 | |
| 666 | if (IS_ENABLED(CONFIG_SILENT_CONSOLE) && (gd->flags & GD_FLG_SILENT)) { |
Patrick Delaunay | 13551b9 | 2019-08-02 14:58:10 +0200 | [diff] [blame] | 667 | if (!(gd->flags & GD_FLG_DEVINIT)) |
| 668 | pre_console_putc(c); |
wdenk | f6e20fc | 2004-02-08 19:38:38 +0000 | [diff] [blame] | 669 | return; |
Patrick Delaunay | 13551b9 | 2019-08-02 14:58:10 +0200 | [diff] [blame] | 670 | } |
wdenk | a6cccae | 2004-02-06 21:48:22 +0000 | [diff] [blame] | 671 | |
Patrick Delaunay | c04f856 | 2020-12-18 12:46:43 +0100 | [diff] [blame] | 672 | if (IS_ENABLED(CONFIG_DISABLE_CONSOLE) && (gd->flags & GD_FLG_DISABLE_CONSOLE)) |
Mark Jackson | f5c3ba7 | 2008-08-25 19:21:30 +0100 | [diff] [blame] | 673 | return; |
Mark Jackson | f5c3ba7 | 2008-08-25 19:21:30 +0100 | [diff] [blame] | 674 | |
Graeme Russ | e3e454c | 2011-08-29 02:14:05 +0000 | [diff] [blame] | 675 | if (!gd->have_console) |
Graeme Russ | 9558b48 | 2011-09-01 00:48:27 +0000 | [diff] [blame] | 676 | return pre_console_putc(c); |
Graeme Russ | e3e454c | 2011-08-29 02:14:05 +0000 | [diff] [blame] | 677 | |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 678 | if (gd->flags & GD_FLG_DEVINIT) { |
| 679 | /* Send to the standard output */ |
Jean-Christophe PLAGNIOL-VILLARD | ec6f149 | 2009-02-01 17:07:51 +0100 | [diff] [blame] | 680 | fputc(stdout, c); |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 681 | } else { |
| 682 | /* Send directly to the handler */ |
Siarhei Siamashka | 2766966 | 2015-01-08 09:02:31 +0200 | [diff] [blame] | 683 | pre_console_putc(c); |
Jean-Christophe PLAGNIOL-VILLARD | ec6f149 | 2009-02-01 17:07:51 +0100 | [diff] [blame] | 684 | serial_putc(c); |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 685 | } |
| 686 | } |
| 687 | |
Jean-Christophe PLAGNIOL-VILLARD | ec6f149 | 2009-02-01 17:07:51 +0100 | [diff] [blame] | 688 | void puts(const char *s) |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 689 | { |
Patrick Delaunay | 93cdb52 | 2020-11-27 11:20:56 +0100 | [diff] [blame] | 690 | if (!gd) |
| 691 | return; |
Patrick Delaunay | 1e99371 | 2020-12-18 12:46:45 +0100 | [diff] [blame] | 692 | |
| 693 | console_record_puts(s); |
| 694 | |
Simon Glass | 36bcea6 | 2018-11-15 18:44:04 -0700 | [diff] [blame] | 695 | /* sandbox can send characters to stdout before it has a console */ |
Patrick Delaunay | c04f856 | 2020-12-18 12:46:43 +0100 | [diff] [blame] | 696 | if (IS_ENABLED(CONFIG_SANDBOX) && !(gd->flags & GD_FLG_SERIAL_READY)) { |
Simon Glass | 36bcea6 | 2018-11-15 18:44:04 -0700 | [diff] [blame] | 697 | os_puts(s); |
| 698 | return; |
| 699 | } |
Patrick Delaunay | c04f856 | 2020-12-18 12:46:43 +0100 | [diff] [blame] | 700 | |
| 701 | if (IS_ENABLED(CONFIG_DEBUG_UART) && !(gd->flags & GD_FLG_SERIAL_READY)) { |
Soeren Moch | be135cc | 2017-11-04 16:14:09 +0100 | [diff] [blame] | 702 | while (*s) { |
| 703 | int ch = *s++; |
| 704 | |
| 705 | printch(ch); |
| 706 | } |
| 707 | return; |
| 708 | } |
Patrick Delaunay | c04f856 | 2020-12-18 12:46:43 +0100 | [diff] [blame] | 709 | |
| 710 | if (IS_ENABLED(CONFIG_SILENT_CONSOLE) && (gd->flags & GD_FLG_SILENT)) { |
Patrick Delaunay | 13551b9 | 2019-08-02 14:58:10 +0200 | [diff] [blame] | 711 | if (!(gd->flags & GD_FLG_DEVINIT)) |
| 712 | pre_console_puts(s); |
Soeren Moch | be135cc | 2017-11-04 16:14:09 +0100 | [diff] [blame] | 713 | return; |
Patrick Delaunay | 13551b9 | 2019-08-02 14:58:10 +0200 | [diff] [blame] | 714 | } |
Soeren Moch | be135cc | 2017-11-04 16:14:09 +0100 | [diff] [blame] | 715 | |
Patrick Delaunay | c04f856 | 2020-12-18 12:46:43 +0100 | [diff] [blame] | 716 | if (IS_ENABLED(CONFIG_DISABLE_CONSOLE) && (gd->flags & GD_FLG_DISABLE_CONSOLE)) |
Soeren Moch | be135cc | 2017-11-04 16:14:09 +0100 | [diff] [blame] | 717 | return; |
Soeren Moch | be135cc | 2017-11-04 16:14:09 +0100 | [diff] [blame] | 718 | |
| 719 | if (!gd->have_console) |
| 720 | return pre_console_puts(s); |
| 721 | |
| 722 | if (gd->flags & GD_FLG_DEVINIT) { |
| 723 | /* Send to the standard output */ |
| 724 | fputs(stdout, s); |
| 725 | } else { |
| 726 | /* Send directly to the handler */ |
| 727 | pre_console_puts(s); |
| 728 | serial_puts(s); |
| 729 | } |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 730 | } |
| 731 | |
Simon Glass | 9854a87 | 2015-11-08 23:47:48 -0700 | [diff] [blame] | 732 | #ifdef CONFIG_CONSOLE_RECORD |
| 733 | int console_record_init(void) |
| 734 | { |
| 735 | int ret; |
| 736 | |
Heinrich Schuchardt | a3a9e04 | 2020-02-12 18:23:49 +0100 | [diff] [blame] | 737 | ret = membuff_new((struct membuff *)&gd->console_out, |
| 738 | CONFIG_CONSOLE_RECORD_OUT_SIZE); |
Simon Glass | 9854a87 | 2015-11-08 23:47:48 -0700 | [diff] [blame] | 739 | if (ret) |
| 740 | return ret; |
Heinrich Schuchardt | a3a9e04 | 2020-02-12 18:23:49 +0100 | [diff] [blame] | 741 | ret = membuff_new((struct membuff *)&gd->console_in, |
| 742 | CONFIG_CONSOLE_RECORD_IN_SIZE); |
Simon Glass | 9854a87 | 2015-11-08 23:47:48 -0700 | [diff] [blame] | 743 | |
| 744 | return ret; |
| 745 | } |
| 746 | |
| 747 | void console_record_reset(void) |
| 748 | { |
Heinrich Schuchardt | a3a9e04 | 2020-02-12 18:23:49 +0100 | [diff] [blame] | 749 | membuff_purge((struct membuff *)&gd->console_out); |
| 750 | membuff_purge((struct membuff *)&gd->console_in); |
Simon Glass | c1a2bb4 | 2021-05-08 06:59:56 -0600 | [diff] [blame] | 751 | gd->flags &= ~GD_FLG_RECORD_OVF; |
Simon Glass | 9854a87 | 2015-11-08 23:47:48 -0700 | [diff] [blame] | 752 | } |
| 753 | |
Simon Glass | bd34715 | 2020-07-28 19:41:11 -0600 | [diff] [blame] | 754 | int console_record_reset_enable(void) |
Simon Glass | 9854a87 | 2015-11-08 23:47:48 -0700 | [diff] [blame] | 755 | { |
| 756 | console_record_reset(); |
| 757 | gd->flags |= GD_FLG_RECORD; |
Simon Glass | bd34715 | 2020-07-28 19:41:11 -0600 | [diff] [blame] | 758 | |
| 759 | return 0; |
Simon Glass | 9854a87 | 2015-11-08 23:47:48 -0700 | [diff] [blame] | 760 | } |
Simon Glass | b612312 | 2020-01-27 08:49:54 -0700 | [diff] [blame] | 761 | |
| 762 | int console_record_readline(char *str, int maxlen) |
| 763 | { |
Simon Glass | c1a2bb4 | 2021-05-08 06:59:56 -0600 | [diff] [blame] | 764 | if (gd->flags & GD_FLG_RECORD_OVF) |
| 765 | return -ENOSPC; |
| 766 | |
Heinrich Schuchardt | a3a9e04 | 2020-02-12 18:23:49 +0100 | [diff] [blame] | 767 | return membuff_readline((struct membuff *)&gd->console_out, str, |
| 768 | maxlen, ' '); |
Simon Glass | b612312 | 2020-01-27 08:49:54 -0700 | [diff] [blame] | 769 | } |
| 770 | |
| 771 | int console_record_avail(void) |
| 772 | { |
Heinrich Schuchardt | a3a9e04 | 2020-02-12 18:23:49 +0100 | [diff] [blame] | 773 | return membuff_avail((struct membuff *)&gd->console_out); |
Simon Glass | b612312 | 2020-01-27 08:49:54 -0700 | [diff] [blame] | 774 | } |
| 775 | |
Steffen Jaeckel | 25c8b9f | 2021-07-08 15:57:40 +0200 | [diff] [blame] | 776 | int console_in_puts(const char *str) |
| 777 | { |
| 778 | return membuff_put((struct membuff *)&gd->console_in, str, strlen(str)); |
| 779 | } |
| 780 | |
Simon Glass | 9854a87 | 2015-11-08 23:47:48 -0700 | [diff] [blame] | 781 | #endif |
| 782 | |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 783 | /* test if ctrl-c was pressed */ |
| 784 | static int ctrlc_disabled = 0; /* see disable_ctrl() */ |
| 785 | static int ctrlc_was_pressed = 0; |
Jean-Christophe PLAGNIOL-VILLARD | ec6f149 | 2009-02-01 17:07:51 +0100 | [diff] [blame] | 786 | int ctrlc(void) |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 787 | { |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 788 | if (!ctrlc_disabled && gd->have_console) { |
Jean-Christophe PLAGNIOL-VILLARD | ec6f149 | 2009-02-01 17:07:51 +0100 | [diff] [blame] | 789 | if (tstc()) { |
Heinrich Schuchardt | c670aee | 2020-10-07 18:11:48 +0200 | [diff] [blame] | 790 | switch (getchar()) { |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 791 | case 0x03: /* ^C - Control C */ |
| 792 | ctrlc_was_pressed = 1; |
| 793 | return 1; |
| 794 | default: |
| 795 | break; |
| 796 | } |
| 797 | } |
| 798 | } |
Simon Glass | 8969ea3 | 2014-09-14 12:40:15 -0600 | [diff] [blame] | 799 | |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 800 | return 0; |
| 801 | } |
Pierre Aubert | a5dffa4 | 2014-04-24 10:30:07 +0200 | [diff] [blame] | 802 | /* Reads user's confirmation. |
| 803 | Returns 1 if user's input is "y", "Y", "yes" or "YES" |
| 804 | */ |
| 805 | int confirm_yesno(void) |
| 806 | { |
| 807 | int i; |
| 808 | char str_input[5]; |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 809 | |
Pierre Aubert | a5dffa4 | 2014-04-24 10:30:07 +0200 | [diff] [blame] | 810 | /* Flush input */ |
| 811 | while (tstc()) |
Heinrich Schuchardt | c670aee | 2020-10-07 18:11:48 +0200 | [diff] [blame] | 812 | getchar(); |
Pierre Aubert | a5dffa4 | 2014-04-24 10:30:07 +0200 | [diff] [blame] | 813 | i = 0; |
| 814 | while (i < sizeof(str_input)) { |
Heinrich Schuchardt | c670aee | 2020-10-07 18:11:48 +0200 | [diff] [blame] | 815 | str_input[i] = getchar(); |
Pierre Aubert | a5dffa4 | 2014-04-24 10:30:07 +0200 | [diff] [blame] | 816 | putc(str_input[i]); |
| 817 | if (str_input[i] == '\r') |
| 818 | break; |
| 819 | i++; |
| 820 | } |
| 821 | putc('\n'); |
| 822 | if (strncmp(str_input, "y\r", 2) == 0 || |
| 823 | strncmp(str_input, "Y\r", 2) == 0 || |
| 824 | strncmp(str_input, "yes\r", 4) == 0 || |
| 825 | strncmp(str_input, "YES\r", 4) == 0) |
| 826 | return 1; |
| 827 | return 0; |
| 828 | } |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 829 | /* pass 1 to disable ctrlc() checking, 0 to enable. |
| 830 | * returns previous state |
| 831 | */ |
Jean-Christophe PLAGNIOL-VILLARD | ec6f149 | 2009-02-01 17:07:51 +0100 | [diff] [blame] | 832 | int disable_ctrlc(int disable) |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 833 | { |
| 834 | int prev = ctrlc_disabled; /* save previous state */ |
| 835 | |
| 836 | ctrlc_disabled = disable; |
| 837 | return prev; |
| 838 | } |
| 839 | |
| 840 | int had_ctrlc (void) |
| 841 | { |
| 842 | return ctrlc_was_pressed; |
| 843 | } |
| 844 | |
Jean-Christophe PLAGNIOL-VILLARD | ec6f149 | 2009-02-01 17:07:51 +0100 | [diff] [blame] | 845 | void clear_ctrlc(void) |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 846 | { |
| 847 | ctrlc_was_pressed = 0; |
| 848 | } |
| 849 | |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 850 | /** U-Boot INIT FUNCTIONS *************************************************/ |
| 851 | |
Andy Shevchenko | 3232487 | 2020-12-21 14:30:03 +0200 | [diff] [blame] | 852 | struct stdio_dev *console_search_dev(int flags, const char *name) |
Jean-Christophe PLAGNIOL-VILLARD | c1de7a6 | 2008-08-31 04:24:55 +0200 | [diff] [blame] | 853 | { |
Jean-Christophe PLAGNIOL-VILLARD | 52cb4d4 | 2009-05-16 12:14:54 +0200 | [diff] [blame] | 854 | struct stdio_dev *dev; |
Jean-Christophe PLAGNIOL-VILLARD | c1de7a6 | 2008-08-31 04:24:55 +0200 | [diff] [blame] | 855 | |
Jean-Christophe PLAGNIOL-VILLARD | 52cb4d4 | 2009-05-16 12:14:54 +0200 | [diff] [blame] | 856 | dev = stdio_get_by_name(name); |
Simon Glass | a2931b3 | 2016-02-06 14:31:37 -0700 | [diff] [blame] | 857 | #ifdef CONFIG_VIDCONSOLE_AS_LCD |
Patrick Delaunay | 27b5b9e | 2020-07-01 14:56:10 +0200 | [diff] [blame] | 858 | if (!dev && !strcmp(name, CONFIG_VIDCONSOLE_AS_NAME)) |
Simon Glass | a2931b3 | 2016-02-06 14:31:37 -0700 | [diff] [blame] | 859 | dev = stdio_get_by_name("vidconsole"); |
| 860 | #endif |
Jean-Christophe PLAGNIOL-VILLARD | c1de7a6 | 2008-08-31 04:24:55 +0200 | [diff] [blame] | 861 | |
Jean-Christophe PLAGNIOL-VILLARD | ec6f149 | 2009-02-01 17:07:51 +0100 | [diff] [blame] | 862 | if (dev && (dev->flags & flags)) |
Jean-Christophe PLAGNIOL-VILLARD | c1de7a6 | 2008-08-31 04:24:55 +0200 | [diff] [blame] | 863 | return dev; |
| 864 | |
| 865 | return NULL; |
| 866 | } |
| 867 | |
Mike Frysinger | d7be305 | 2010-10-20 07:18:03 -0400 | [diff] [blame] | 868 | int console_assign(int file, const char *devname) |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 869 | { |
Jean-Christophe PLAGNIOL-VILLARD | c1de7a6 | 2008-08-31 04:24:55 +0200 | [diff] [blame] | 870 | int flag; |
Jean-Christophe PLAGNIOL-VILLARD | 52cb4d4 | 2009-05-16 12:14:54 +0200 | [diff] [blame] | 871 | struct stdio_dev *dev; |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 872 | |
| 873 | /* Check for valid file */ |
Andy Shevchenko | 7b9ca3f | 2021-02-11 17:09:37 +0200 | [diff] [blame] | 874 | flag = stdio_file_to_flags(file); |
| 875 | if (flag < 0) |
| 876 | return flag; |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 877 | |
| 878 | /* Check for valid device name */ |
| 879 | |
Andy Shevchenko | 3232487 | 2020-12-21 14:30:03 +0200 | [diff] [blame] | 880 | dev = console_search_dev(flag, devname); |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 881 | |
Jean-Christophe PLAGNIOL-VILLARD | ec6f149 | 2009-02-01 17:07:51 +0100 | [diff] [blame] | 882 | if (dev) |
| 883 | return console_setfile(file, dev); |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 884 | |
| 885 | return -1; |
| 886 | } |
| 887 | |
Patrick Delaunay | 13551b9 | 2019-08-02 14:58:10 +0200 | [diff] [blame] | 888 | /* return true if the 'silent' flag is removed */ |
| 889 | static bool console_update_silent(void) |
Chris Packham | 43e0a3d | 2016-09-23 15:59:43 +1200 | [diff] [blame] | 890 | { |
Patrick Delaunay | c04f856 | 2020-12-18 12:46:43 +0100 | [diff] [blame] | 891 | unsigned long flags = gd->flags; |
| 892 | |
| 893 | if (!IS_ENABLED(CONFIG_SILENT_CONSOLE)) |
| 894 | return false; |
| 895 | |
Patrick Delaunay | 13551b9 | 2019-08-02 14:58:10 +0200 | [diff] [blame] | 896 | if (env_get("silent")) { |
Chris Packham | 43e0a3d | 2016-09-23 15:59:43 +1200 | [diff] [blame] | 897 | gd->flags |= GD_FLG_SILENT; |
Patrick Delaunay | c04f856 | 2020-12-18 12:46:43 +0100 | [diff] [blame] | 898 | return false; |
Patrick Delaunay | 13551b9 | 2019-08-02 14:58:10 +0200 | [diff] [blame] | 899 | } |
Patrick Delaunay | 13551b9 | 2019-08-02 14:58:10 +0200 | [diff] [blame] | 900 | |
Patrick Delaunay | c04f856 | 2020-12-18 12:46:43 +0100 | [diff] [blame] | 901 | gd->flags &= ~GD_FLG_SILENT; |
| 902 | |
| 903 | return !!(flags & GD_FLG_SILENT); |
Chris Packham | 43e0a3d | 2016-09-23 15:59:43 +1200 | [diff] [blame] | 904 | } |
| 905 | |
Simon Glass | b089538 | 2017-06-15 21:37:50 -0600 | [diff] [blame] | 906 | int console_announce_r(void) |
| 907 | { |
| 908 | #if !CONFIG_IS_ENABLED(PRE_CONSOLE_BUFFER) |
| 909 | char buf[DISPLAY_OPTIONS_BANNER_LENGTH]; |
| 910 | |
| 911 | display_options_get_banner(false, buf, sizeof(buf)); |
| 912 | |
Simon Glass | 493a4c8 | 2020-07-02 21:12:13 -0600 | [diff] [blame] | 913 | console_puts_select(stdout, false, buf); |
Simon Glass | b089538 | 2017-06-15 21:37:50 -0600 | [diff] [blame] | 914 | #endif |
| 915 | |
| 916 | return 0; |
| 917 | } |
| 918 | |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 919 | /* Called before relocation - use serial functions */ |
Jean-Christophe PLAGNIOL-VILLARD | ec6f149 | 2009-02-01 17:07:51 +0100 | [diff] [blame] | 920 | int console_init_f(void) |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 921 | { |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 922 | gd->have_console = 1; |
wdenk | f72da34 | 2003-10-10 10:05:42 +0000 | [diff] [blame] | 923 | |
Chris Packham | 43e0a3d | 2016-09-23 15:59:43 +1200 | [diff] [blame] | 924 | console_update_silent(); |
wdenk | f72da34 | 2003-10-10 10:05:42 +0000 | [diff] [blame] | 925 | |
Siarhei Siamashka | 2766966 | 2015-01-08 09:02:31 +0200 | [diff] [blame] | 926 | print_pre_console_buffer(PRE_CONSOLE_FLUSHPOINT1_SERIAL); |
Graeme Russ | 9558b48 | 2011-09-01 00:48:27 +0000 | [diff] [blame] | 927 | |
Jean-Christophe PLAGNIOL-VILLARD | ec6f149 | 2009-02-01 17:07:51 +0100 | [diff] [blame] | 928 | return 0; |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 929 | } |
| 930 | |
Jean-Christophe PLAGNIOL-VILLARD | 7e3be7c | 2009-05-16 12:14:55 +0200 | [diff] [blame] | 931 | void stdio_print_current_devices(void) |
| 932 | { |
Jean-Christophe PLAGNIOL-VILLARD | 7e3be7c | 2009-05-16 12:14:55 +0200 | [diff] [blame] | 933 | /* Print information */ |
| 934 | puts("In: "); |
| 935 | if (stdio_devices[stdin] == NULL) { |
| 936 | puts("No input devices available!\n"); |
| 937 | } else { |
| 938 | printf ("%s\n", stdio_devices[stdin]->name); |
| 939 | } |
| 940 | |
| 941 | puts("Out: "); |
| 942 | if (stdio_devices[stdout] == NULL) { |
| 943 | puts("No output devices available!\n"); |
| 944 | } else { |
| 945 | printf ("%s\n", stdio_devices[stdout]->name); |
| 946 | } |
| 947 | |
| 948 | puts("Err: "); |
| 949 | if (stdio_devices[stderr] == NULL) { |
| 950 | puts("No error devices available!\n"); |
| 951 | } else { |
| 952 | printf ("%s\n", stdio_devices[stderr]->name); |
| 953 | } |
Jean-Christophe PLAGNIOL-VILLARD | 7e3be7c | 2009-05-16 12:14:55 +0200 | [diff] [blame] | 954 | } |
| 955 | |
Simon Glass | b026542 | 2017-01-16 07:03:26 -0700 | [diff] [blame] | 956 | #if CONFIG_IS_ENABLED(SYS_CONSOLE_IS_IN_ENV) |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 957 | /* Called after the relocation - use desired console functions */ |
Jean-Christophe PLAGNIOL-VILLARD | ec6f149 | 2009-02-01 17:07:51 +0100 | [diff] [blame] | 958 | int console_init_r(void) |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 959 | { |
| 960 | char *stdinname, *stdoutname, *stderrname; |
Jean-Christophe PLAGNIOL-VILLARD | 52cb4d4 | 2009-05-16 12:14:54 +0200 | [diff] [blame] | 961 | struct stdio_dev *inputdev = NULL, *outputdev = NULL, *errdev = NULL; |
wdenk | 6e59238 | 2004-04-18 17:39:38 +0000 | [diff] [blame] | 962 | int i; |
Gary Jennejohn | 16a28ef | 2008-11-06 15:04:23 +0100 | [diff] [blame] | 963 | int iomux_err = 0; |
Patrick Delaunay | 13551b9 | 2019-08-02 14:58:10 +0200 | [diff] [blame] | 964 | int flushpoint; |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 965 | |
Patrick Delaunay | bf46be7 | 2019-08-02 14:58:09 +0200 | [diff] [blame] | 966 | /* update silent for env loaded from flash (initr_env) */ |
Patrick Delaunay | 13551b9 | 2019-08-02 14:58:10 +0200 | [diff] [blame] | 967 | if (console_update_silent()) |
| 968 | flushpoint = PRE_CONSOLE_FLUSHPOINT1_SERIAL; |
| 969 | else |
| 970 | flushpoint = PRE_CONSOLE_FLUSHPOINT2_EVERYTHING_BUT_SERIAL; |
Patrick Delaunay | bf46be7 | 2019-08-02 14:58:09 +0200 | [diff] [blame] | 971 | |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 972 | /* set default handlers at first */ |
Martin Dorwig | 49cad54 | 2015-01-26 15:22:54 -0700 | [diff] [blame] | 973 | gd->jt->getc = serial_getc; |
| 974 | gd->jt->tstc = serial_tstc; |
| 975 | gd->jt->putc = serial_putc; |
| 976 | gd->jt->puts = serial_puts; |
| 977 | gd->jt->printf = serial_printf; |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 978 | |
| 979 | /* stdin stdout and stderr are in environment */ |
| 980 | /* scan for it */ |
Simon Glass | 00caae6 | 2017-08-03 12:22:12 -0600 | [diff] [blame] | 981 | stdinname = env_get("stdin"); |
| 982 | stdoutname = env_get("stdout"); |
| 983 | stderrname = env_get("stderr"); |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 984 | |
Wolfgang Denk | 53677ef | 2008-05-20 16:00:29 +0200 | [diff] [blame] | 985 | if (OVERWRITE_CONSOLE == 0) { /* if not overwritten by config switch */ |
Andy Shevchenko | 3232487 | 2020-12-21 14:30:03 +0200 | [diff] [blame] | 986 | inputdev = console_search_dev(DEV_FLAGS_INPUT, stdinname); |
| 987 | outputdev = console_search_dev(DEV_FLAGS_OUTPUT, stdoutname); |
| 988 | errdev = console_search_dev(DEV_FLAGS_OUTPUT, stderrname); |
Patrick Delaunay | c04f856 | 2020-12-18 12:46:43 +0100 | [diff] [blame] | 989 | if (CONFIG_IS_ENABLED(CONSOLE_MUX)) { |
| 990 | iomux_err = iomux_doenv(stdin, stdinname); |
| 991 | iomux_err += iomux_doenv(stdout, stdoutname); |
| 992 | iomux_err += iomux_doenv(stderr, stderrname); |
| 993 | if (!iomux_err) |
| 994 | /* Successful, so skip all the code below. */ |
| 995 | goto done; |
| 996 | } |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 997 | } |
| 998 | /* if the devices are overwritten or not found, use default device */ |
| 999 | if (inputdev == NULL) { |
Andy Shevchenko | 3232487 | 2020-12-21 14:30:03 +0200 | [diff] [blame] | 1000 | inputdev = console_search_dev(DEV_FLAGS_INPUT, "serial"); |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 1001 | } |
| 1002 | if (outputdev == NULL) { |
Andy Shevchenko | 3232487 | 2020-12-21 14:30:03 +0200 | [diff] [blame] | 1003 | outputdev = console_search_dev(DEV_FLAGS_OUTPUT, "serial"); |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 1004 | } |
| 1005 | if (errdev == NULL) { |
Andy Shevchenko | 3232487 | 2020-12-21 14:30:03 +0200 | [diff] [blame] | 1006 | errdev = console_search_dev(DEV_FLAGS_OUTPUT, "serial"); |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 1007 | } |
| 1008 | /* Initializes output console first */ |
| 1009 | if (outputdev != NULL) { |
Gary Jennejohn | 16a28ef | 2008-11-06 15:04:23 +0100 | [diff] [blame] | 1010 | /* need to set a console if not done above. */ |
Jean-Christophe PLAGNIOL-VILLARD | 5f03201 | 2009-02-01 17:07:52 +0100 | [diff] [blame] | 1011 | console_doenv(stdout, outputdev); |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 1012 | } |
| 1013 | if (errdev != NULL) { |
Gary Jennejohn | 16a28ef | 2008-11-06 15:04:23 +0100 | [diff] [blame] | 1014 | /* need to set a console if not done above. */ |
Jean-Christophe PLAGNIOL-VILLARD | 5f03201 | 2009-02-01 17:07:52 +0100 | [diff] [blame] | 1015 | console_doenv(stderr, errdev); |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 1016 | } |
| 1017 | if (inputdev != NULL) { |
Gary Jennejohn | 16a28ef | 2008-11-06 15:04:23 +0100 | [diff] [blame] | 1018 | /* need to set a console if not done above. */ |
Jean-Christophe PLAGNIOL-VILLARD | 5f03201 | 2009-02-01 17:07:52 +0100 | [diff] [blame] | 1019 | console_doenv(stdin, inputdev); |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 1020 | } |
| 1021 | |
Gary Jennejohn | 16a28ef | 2008-11-06 15:04:23 +0100 | [diff] [blame] | 1022 | done: |
Gary Jennejohn | 16a28ef | 2008-11-06 15:04:23 +0100 | [diff] [blame] | 1023 | |
Patrick Delaunay | c04f856 | 2020-12-18 12:46:43 +0100 | [diff] [blame] | 1024 | if (!IS_ENABLED(CONFIG_SYS_CONSOLE_INFO_QUIET)) |
| 1025 | stdio_print_current_devices(); |
| 1026 | |
Simon Glass | a2931b3 | 2016-02-06 14:31:37 -0700 | [diff] [blame] | 1027 | #ifdef CONFIG_VIDCONSOLE_AS_LCD |
Patrick Delaunay | 27b5b9e | 2020-07-01 14:56:10 +0200 | [diff] [blame] | 1028 | if (strstr(stdoutname, CONFIG_VIDCONSOLE_AS_NAME)) |
Anatolij Gustschin | 22b897a | 2020-05-23 17:11:20 +0200 | [diff] [blame] | 1029 | printf("Warning: Please change '%s' to 'vidconsole' in stdout/stderr environment vars\n", |
Patrick Delaunay | 27b5b9e | 2020-07-01 14:56:10 +0200 | [diff] [blame] | 1030 | CONFIG_VIDCONSOLE_AS_NAME); |
Simon Glass | a2931b3 | 2016-02-06 14:31:37 -0700 | [diff] [blame] | 1031 | #endif |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 1032 | |
Patrick Delaunay | c04f856 | 2020-12-18 12:46:43 +0100 | [diff] [blame] | 1033 | if (IS_ENABLED(CONFIG_SYS_CONSOLE_ENV_OVERWRITE)) { |
| 1034 | /* set the environment variables (will overwrite previous env settings) */ |
| 1035 | for (i = 0; i < MAX_FILES; i++) |
| 1036 | env_set(stdio_names[i], stdio_devices[i]->name); |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 1037 | } |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 1038 | |
Joe Hershberger | c4e0057 | 2012-12-11 22:16:19 -0600 | [diff] [blame] | 1039 | gd->flags |= GD_FLG_DEVINIT; /* device initialization completed */ |
| 1040 | |
Patrick Delaunay | 13551b9 | 2019-08-02 14:58:10 +0200 | [diff] [blame] | 1041 | print_pre_console_buffer(flushpoint); |
Jean-Christophe PLAGNIOL-VILLARD | ec6f149 | 2009-02-01 17:07:51 +0100 | [diff] [blame] | 1042 | return 0; |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 1043 | } |
| 1044 | |
Simon Glass | b026542 | 2017-01-16 07:03:26 -0700 | [diff] [blame] | 1045 | #else /* !CONFIG_IS_ENABLED(SYS_CONSOLE_IS_IN_ENV) */ |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 1046 | |
| 1047 | /* Called after the relocation - use desired console functions */ |
Jean-Christophe PLAGNIOL-VILLARD | ec6f149 | 2009-02-01 17:07:51 +0100 | [diff] [blame] | 1048 | int console_init_r(void) |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 1049 | { |
Jean-Christophe PLAGNIOL-VILLARD | 52cb4d4 | 2009-05-16 12:14:54 +0200 | [diff] [blame] | 1050 | struct stdio_dev *inputdev = NULL, *outputdev = NULL; |
Jean-Christophe PLAGNIOL-VILLARD | c1de7a6 | 2008-08-31 04:24:55 +0200 | [diff] [blame] | 1051 | int i; |
Jean-Christophe PLAGNIOL-VILLARD | 52cb4d4 | 2009-05-16 12:14:54 +0200 | [diff] [blame] | 1052 | struct list_head *list = stdio_get_list(); |
Jean-Christophe PLAGNIOL-VILLARD | c1de7a6 | 2008-08-31 04:24:55 +0200 | [diff] [blame] | 1053 | struct list_head *pos; |
Jean-Christophe PLAGNIOL-VILLARD | 52cb4d4 | 2009-05-16 12:14:54 +0200 | [diff] [blame] | 1054 | struct stdio_dev *dev; |
Patrick Delaunay | 13551b9 | 2019-08-02 14:58:10 +0200 | [diff] [blame] | 1055 | int flushpoint; |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 1056 | |
Patrick Delaunay | bf46be7 | 2019-08-02 14:58:09 +0200 | [diff] [blame] | 1057 | /* update silent for env loaded from flash (initr_env) */ |
Patrick Delaunay | 13551b9 | 2019-08-02 14:58:10 +0200 | [diff] [blame] | 1058 | if (console_update_silent()) |
| 1059 | flushpoint = PRE_CONSOLE_FLUSHPOINT1_SERIAL; |
| 1060 | else |
| 1061 | flushpoint = PRE_CONSOLE_FLUSHPOINT2_EVERYTHING_BUT_SERIAL; |
Chris Packham | 43e0a3d | 2016-09-23 15:59:43 +1200 | [diff] [blame] | 1062 | |
Jean-Christophe PLAGNIOL-VILLARD | ec6f149 | 2009-02-01 17:07:51 +0100 | [diff] [blame] | 1063 | /* |
| 1064 | * suppress all output if splash screen is enabled and we have |
Anatolij Gustschin | a749081 | 2010-03-16 15:29:33 +0100 | [diff] [blame] | 1065 | * a bmp to display. We redirect the output from frame buffer |
| 1066 | * console to serial console in this case or suppress it if |
| 1067 | * "silent" mode was requested. |
Jean-Christophe PLAGNIOL-VILLARD | ec6f149 | 2009-02-01 17:07:51 +0100 | [diff] [blame] | 1068 | */ |
Patrick Delaunay | c04f856 | 2020-12-18 12:46:43 +0100 | [diff] [blame] | 1069 | if (IS_ENABLED(CONFIG_SPLASH_SCREEN) && env_get("splashimage")) { |
Anatolij Gustschin | a749081 | 2010-03-16 15:29:33 +0100 | [diff] [blame] | 1070 | if (!(gd->flags & GD_FLG_SILENT)) |
Andy Shevchenko | 3232487 | 2020-12-21 14:30:03 +0200 | [diff] [blame] | 1071 | outputdev = console_search_dev (DEV_FLAGS_OUTPUT, "serial"); |
Anatolij Gustschin | a749081 | 2010-03-16 15:29:33 +0100 | [diff] [blame] | 1072 | } |
wdenk | f72da34 | 2003-10-10 10:05:42 +0000 | [diff] [blame] | 1073 | |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 1074 | /* Scan devices looking for input and output devices */ |
Jean-Christophe PLAGNIOL-VILLARD | c1de7a6 | 2008-08-31 04:24:55 +0200 | [diff] [blame] | 1075 | list_for_each(pos, list) { |
Jean-Christophe PLAGNIOL-VILLARD | 52cb4d4 | 2009-05-16 12:14:54 +0200 | [diff] [blame] | 1076 | dev = list_entry(pos, struct stdio_dev, list); |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 1077 | |
| 1078 | if ((dev->flags & DEV_FLAGS_INPUT) && (inputdev == NULL)) { |
| 1079 | inputdev = dev; |
| 1080 | } |
| 1081 | if ((dev->flags & DEV_FLAGS_OUTPUT) && (outputdev == NULL)) { |
| 1082 | outputdev = dev; |
| 1083 | } |
Jean-Christophe PLAGNIOL-VILLARD | c1de7a6 | 2008-08-31 04:24:55 +0200 | [diff] [blame] | 1084 | if(inputdev && outputdev) |
| 1085 | break; |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 1086 | } |
| 1087 | |
| 1088 | /* Initializes output console first */ |
| 1089 | if (outputdev != NULL) { |
Andy Shevchenko | 09d8f07 | 2021-02-11 17:09:39 +0200 | [diff] [blame] | 1090 | console_setfile_and_devices(stdout, outputdev); |
| 1091 | console_setfile_and_devices(stderr, outputdev); |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 1092 | } |
| 1093 | |
| 1094 | /* Initializes input console */ |
Andy Shevchenko | 09d8f07 | 2021-02-11 17:09:39 +0200 | [diff] [blame] | 1095 | if (inputdev != NULL) |
| 1096 | console_setfile_and_devices(stdin, inputdev); |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 1097 | |
Patrick Delaunay | c04f856 | 2020-12-18 12:46:43 +0100 | [diff] [blame] | 1098 | if (!IS_ENABLED(CONFIG_SYS_CONSOLE_INFO_QUIET)) |
| 1099 | stdio_print_current_devices(); |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 1100 | |
| 1101 | /* Setting environment variables */ |
Tom Rini | 27b4225 | 2018-05-03 09:12:26 -0400 | [diff] [blame] | 1102 | for (i = 0; i < MAX_FILES; i++) { |
Simon Glass | 382bee5 | 2017-08-03 12:22:09 -0600 | [diff] [blame] | 1103 | env_set(stdio_names[i], stdio_devices[i]->name); |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 1104 | } |
| 1105 | |
Joe Hershberger | c4e0057 | 2012-12-11 22:16:19 -0600 | [diff] [blame] | 1106 | gd->flags |= GD_FLG_DEVINIT; /* device initialization completed */ |
| 1107 | |
Patrick Delaunay | 13551b9 | 2019-08-02 14:58:10 +0200 | [diff] [blame] | 1108 | print_pre_console_buffer(flushpoint); |
Jean-Christophe PLAGNIOL-VILLARD | ec6f149 | 2009-02-01 17:07:51 +0100 | [diff] [blame] | 1109 | return 0; |
wdenk | 47d1a6e | 2002-11-03 00:01:44 +0000 | [diff] [blame] | 1110 | } |
| 1111 | |
Simon Glass | b026542 | 2017-01-16 07:03:26 -0700 | [diff] [blame] | 1112 | #endif /* CONFIG_IS_ENABLED(SYS_CONSOLE_IS_IN_ENV) */ |