2 * Copyright (c) 2014 The Chromium OS Authors.
4 * SPDX-License-Identifier: GPL-2.0+
9 #include <environment.h>
13 #include <stdio_dev.h>
16 #include <dm/device-internal.h>
17 #include <dm/of_access.h>
19 DECLARE_GLOBAL_DATA_PTR;
22 * Table with supported baudrates (defined in config_xyz.h)
24 static const unsigned long baudrate_table[] = CONFIG_SYS_BAUDRATE_TABLE;
26 #if !CONFIG_VAL(SYS_MALLOC_F_LEN)
27 #error "Serial is required before relocation - define CONFIG_$(SPL_)SYS_MALLOC_F_LEN to make this work"
30 static int serial_check_stdout(const void *blob, struct udevice **devp)
34 /* Check for a chosen console */
35 node = fdtdec_get_chosen_node(blob, "stdout-path");
37 const char *str, *p, *name;
40 * Deal with things like
41 * stdout-path = "serial0:115200n8";
43 * We need to look up the alias and then follow it to the
46 str = fdtdec_get_chosen_prop(blob, "stdout-path");
49 name = fdt_get_alias_namelen(blob, str,
50 p ? p - str : strlen(str));
52 node = fdt_path_offset(blob, name);
56 node = fdt_path_offset(blob, "console");
57 if (!uclass_get_device_by_of_offset(UCLASS_SERIAL, node, devp))
61 * If the console is not marked to be bound before relocation, bind it
64 if (node > 0 && !lists_bind_fdt(gd->dm_root, offset_to_ofnode(node),
66 if (!device_probe(*devp))
73 static void serial_find_console_or_panic(void)
75 const void *blob = gd->fdt_blob;
77 #ifdef CONFIG_SERIAL_SEARCH_ALL
81 if (CONFIG_IS_ENABLED(OF_PLATDATA)) {
82 uclass_first_device(UCLASS_SERIAL, &dev);
84 gd->cur_serial_dev = dev;
87 } else if (CONFIG_IS_ENABLED(OF_CONTROL) && blob) {
88 /* Live tree has support for stdout */
89 if (of_live_active()) {
90 struct device_node *np = of_get_stdout();
92 if (np && !uclass_get_device_by_ofnode(UCLASS_SERIAL,
93 np_to_ofnode(np), &dev)) {
94 gd->cur_serial_dev = dev;
98 if (!serial_check_stdout(blob, &dev)) {
99 gd->cur_serial_dev = dev;
104 if (!SPL_BUILD || !CONFIG_IS_ENABLED(OF_CONTROL) || !blob) {
106 * Try to use CONFIG_CONS_INDEX if available (it is numbered
109 * Failing that, get the device with sequence number 0, or in
110 * extremis just the first working serial device we can find.
111 * But we insist on having a console (even if it is silent).
113 #ifdef CONFIG_CONS_INDEX
114 #define INDEX (CONFIG_CONS_INDEX - 1)
119 #ifdef CONFIG_SERIAL_SEARCH_ALL
120 if (!uclass_get_device_by_seq(UCLASS_SERIAL, INDEX, &dev) ||
121 !uclass_get_device(UCLASS_SERIAL, INDEX, &dev)) {
122 if (dev->flags & DM_FLAG_ACTIVATED) {
123 gd->cur_serial_dev = dev;
128 /* Search for any working device */
129 for (ret = uclass_first_device_check(UCLASS_SERIAL, &dev);
131 ret = uclass_next_device_check(&dev)) {
133 /* Device did succeed probing */
134 gd->cur_serial_dev = dev;
139 if (!uclass_get_device_by_seq(UCLASS_SERIAL, INDEX, &dev) ||
140 !uclass_get_device(UCLASS_SERIAL, INDEX, &dev) ||
141 (!uclass_first_device(UCLASS_SERIAL, &dev) && dev)) {
142 gd->cur_serial_dev = dev;
150 #ifdef CONFIG_REQUIRE_SERIAL_CONSOLE
151 panic_str("No serial driver found");
155 /* Called prior to relocation */
156 int serial_init(void)
158 serial_find_console_or_panic();
159 gd->flags |= GD_FLG_SERIAL_READY;
164 /* Called after relocation */
165 void serial_initialize(void)
170 static void _serial_putc(struct udevice *dev, char ch)
172 struct dm_serial_ops *ops = serial_get_ops(dev);
176 _serial_putc(dev, '\r');
179 err = ops->putc(dev, ch);
180 } while (err == -EAGAIN);
183 static void _serial_puts(struct udevice *dev, const char *str)
186 _serial_putc(dev, *str++);
189 static int __serial_getc(struct udevice *dev)
191 struct dm_serial_ops *ops = serial_get_ops(dev);
195 err = ops->getc(dev);
198 } while (err == -EAGAIN);
200 return err >= 0 ? err : 0;
203 static int __serial_tstc(struct udevice *dev)
205 struct dm_serial_ops *ops = serial_get_ops(dev);
208 return ops->pending(dev, true);
213 #if CONFIG_IS_ENABLED(SERIAL_RX_BUFFER)
214 static int _serial_tstc(struct udevice *dev)
216 struct serial_dev_priv *upriv = dev_get_uclass_priv(dev);
218 /* Read all available chars into the RX buffer */
219 while (__serial_tstc(dev)) {
220 upriv->buf[upriv->wr_ptr++] = __serial_getc(dev);
221 upriv->wr_ptr %= CONFIG_SERIAL_RX_BUFFER_SIZE;
224 return upriv->rd_ptr != upriv->wr_ptr ? 1 : 0;
227 static int _serial_getc(struct udevice *dev)
229 struct serial_dev_priv *upriv = dev_get_uclass_priv(dev);
232 val = upriv->buf[upriv->rd_ptr++];
233 upriv->rd_ptr %= CONFIG_SERIAL_RX_BUFFER_SIZE;
238 #else /* CONFIG_IS_ENABLED(SERIAL_RX_BUFFER) */
240 static int _serial_getc(struct udevice *dev)
242 return __serial_getc(dev);
245 static int _serial_tstc(struct udevice *dev)
247 return __serial_tstc(dev);
249 #endif /* CONFIG_IS_ENABLED(SERIAL_RX_BUFFER) */
251 void serial_putc(char ch)
253 if (gd->cur_serial_dev)
254 _serial_putc(gd->cur_serial_dev, ch);
257 void serial_puts(const char *str)
259 if (gd->cur_serial_dev)
260 _serial_puts(gd->cur_serial_dev, str);
263 int serial_getc(void)
265 if (!gd->cur_serial_dev)
268 return _serial_getc(gd->cur_serial_dev);
271 int serial_tstc(void)
273 if (!gd->cur_serial_dev)
276 return _serial_tstc(gd->cur_serial_dev);
279 void serial_setbrg(void)
281 struct dm_serial_ops *ops;
283 if (!gd->cur_serial_dev)
286 ops = serial_get_ops(gd->cur_serial_dev);
288 ops->setbrg(gd->cur_serial_dev, gd->baudrate);
291 void serial_stdio_init(void)
295 #if defined(CONFIG_DM_STDIO)
297 #if CONFIG_IS_ENABLED(SERIAL_PRESENT)
298 static void serial_stub_putc(struct stdio_dev *sdev, const char ch)
300 _serial_putc(sdev->priv, ch);
304 static void serial_stub_puts(struct stdio_dev *sdev, const char *str)
306 _serial_puts(sdev->priv, str);
309 static int serial_stub_getc(struct stdio_dev *sdev)
311 return _serial_getc(sdev->priv);
314 static int serial_stub_tstc(struct stdio_dev *sdev)
316 return _serial_tstc(sdev->priv);
321 * on_baudrate() - Update the actual baudrate when the env var changes
323 * This will check for a valid baudrate and only apply it if valid.
325 static int on_baudrate(const char *name, const char *value, enum env_op op,
333 case env_op_overwrite:
335 * Switch to new baudrate if new baudrate is supported
337 baudrate = simple_strtoul(value, NULL, 10);
339 /* Not actually changing */
340 if (gd->baudrate == baudrate)
343 for (i = 0; i < ARRAY_SIZE(baudrate_table); ++i) {
344 if (baudrate == baudrate_table[i])
347 if (i == ARRAY_SIZE(baudrate_table)) {
348 if ((flags & H_FORCE) == 0)
349 printf("## Baudrate %d bps not supported\n",
353 if ((flags & H_INTERACTIVE) != 0) {
354 printf("## Switch baudrate to %d bps and press ENTER ...\n",
359 gd->baudrate = baudrate;
365 if ((flags & H_INTERACTIVE) != 0)
373 printf("## Baudrate may not be deleted\n");
379 U_BOOT_ENV_CALLBACK(baudrate, on_baudrate);
381 #if CONFIG_IS_ENABLED(SERIAL_PRESENT)
382 static int serial_post_probe(struct udevice *dev)
384 struct dm_serial_ops *ops = serial_get_ops(dev);
385 #ifdef CONFIG_DM_STDIO
386 struct serial_dev_priv *upriv = dev_get_uclass_priv(dev);
387 struct stdio_dev sdev;
391 #if defined(CONFIG_NEEDS_MANUAL_RELOC)
393 ops->setbrg += gd->reloc_off;
395 ops->getc += gd->reloc_off;
397 ops->putc += gd->reloc_off;
399 ops->pending += gd->reloc_off;
401 ops->clear += gd->reloc_off;
402 #if CONFIG_POST & CONFIG_SYS_POST_UART
404 ops->loop += gd->reloc_off
407 /* Set the baud rate */
409 ret = ops->setbrg(dev, gd->baudrate);
414 #ifdef CONFIG_DM_STDIO
415 if (!(gd->flags & GD_FLG_RELOC))
417 memset(&sdev, '\0', sizeof(sdev));
419 strncpy(sdev.name, dev->name, sizeof(sdev.name));
420 sdev.flags = DEV_FLAGS_OUTPUT | DEV_FLAGS_INPUT | DEV_FLAGS_DM;
422 sdev.putc = serial_stub_putc;
423 sdev.puts = serial_stub_puts;
424 sdev.getc = serial_stub_getc;
425 sdev.tstc = serial_stub_tstc;
427 #if CONFIG_IS_ENABLED(SERIAL_RX_BUFFER)
428 /* Allocate the RX buffer */
429 upriv->buf = malloc(CONFIG_SERIAL_RX_BUFFER_SIZE);
432 stdio_register_dev(&sdev, &upriv->sdev);
437 static int serial_pre_remove(struct udevice *dev)
439 #if CONFIG_IS_ENABLED(SYS_STDIO_DEREGISTER)
440 struct serial_dev_priv *upriv = dev_get_uclass_priv(dev);
442 if (stdio_deregister_dev(upriv->sdev, true))
449 UCLASS_DRIVER(serial) = {
452 .flags = DM_UC_FLAG_SEQ_ALIAS,
453 .post_probe = serial_post_probe,
454 .pre_remove = serial_pre_remove,
455 .per_device_auto_alloc_size = sizeof(struct serial_dev_priv),