blob: f9ed2e569c9ba930aa3a4e17c572dceaf8ec3b04 [file] [log] [blame]
Achin Gupta4f6ad662013-10-25 09:08:21 +01001/*
Dan Handley6fa89a22018-02-27 16:03:58 +00002 * Copyright (c) 2013-2018, ARM Limited and Contributors. All rights reserved.
Achin Gupta4f6ad662013-10-25 09:08:21 +01003 *
dp-armfa3cf0b2017-05-03 09:38:09 +01004 * SPDX-License-Identifier: BSD-3-Clause
Achin Gupta4f6ad662013-10-25 09:08:21 +01005 */
6
7#ifndef __CONSOLE_H__
8#define __CONSOLE_H__
9
Julius Werner94f89072017-07-31 18:15:11 -070010#include <utils_def.h>
Juan Castillo7f1f0622014-09-09 09:49:23 +010011
Julius Werner94f89072017-07-31 18:15:11 -070012#define CONSOLE_T_NEXT (U(0) * REGSZ)
13#define CONSOLE_T_FLAGS (U(1) * REGSZ)
14#define CONSOLE_T_PUTC (U(2) * REGSZ)
15#define CONSOLE_T_GETC (U(3) * REGSZ)
16#define CONSOLE_T_FLUSH (U(4) * REGSZ)
17#define CONSOLE_T_DRVDATA (U(5) * REGSZ)
18
Antonio Nino Diaz23ede6a2018-06-19 09:29:36 +010019#define CONSOLE_FLAG_BOOT (U(1) << 0)
20#define CONSOLE_FLAG_RUNTIME (U(1) << 1)
21#define CONSOLE_FLAG_CRASH (U(1) << 2)
Julius Werner94f89072017-07-31 18:15:11 -070022/* Bits 3 to 7 reserved for additional scopes in future expansion. */
23#define CONSOLE_FLAG_SCOPE_MASK ((U(1) << 8) - 1)
24/* Bits 8 to 31 reserved for non-scope use in future expansion. */
25
26/* Returned by getc callbacks when receive FIFO is empty. */
27#define ERROR_NO_PENDING_CHAR (-1)
28/* Returned by console_xxx() if no registered console implements xxx. */
29#define ERROR_NO_VALID_CONSOLE (-128)
30
31#ifndef __ASSEMBLY__
32
33#include <types.h>
34
35typedef struct console {
36 struct console *next;
Daniel Boulby99e4a482018-05-16 16:04:35 +010037 /*
38 * Only the low 32 bits are used. The type is u_register_t to align the
39 * fields of the struct to 64 bits in AArch64 and 32 bits in AArch32
40 */
Julius Werner94f89072017-07-31 18:15:11 -070041 u_register_t flags;
Daniel Boulby9516df22018-06-07 14:15:15 +010042 int (*const putc)(int character, struct console *console);
43 int (*const getc)(struct console *console);
44 int (*const flush)(struct console *console);
Julius Werner94f89072017-07-31 18:15:11 -070045 /* Additional private driver data may follow here. */
46} console_t;
Daniel Boulby99e4a482018-05-16 16:04:35 +010047#include <console_assertions.h> /* offset macro assertions for console_t */
Julius Werner94f89072017-07-31 18:15:11 -070048
49/*
50 * NOTE: There is no publicly accessible console_register() function. Consoles
51 * are registered by directly calling the register function of a specific
52 * implementation, e.g. console_16550_register() from <uart_16550.h>. Consoles
53 * registered that way can be unregistered/reconfigured with below functions.
54 */
55/* Remove a single console_t instance from the console list. */
56int console_unregister(console_t *console);
Antonio Nino Diaz4f31ad52018-04-30 20:14:07 +010057/* Returns 1 if this console is already registered, 0 if not */
58int console_is_registered(console_t *console);
59/*
60 * Set scope mask of a console that determines in what states it is active.
61 * By default they are registered with (CONSOLE_FLAG_BOOT|CONSOLE_FLAG_CRASH).
62 */
Julius Werner94f89072017-07-31 18:15:11 -070063void console_set_scope(console_t *console, unsigned int scope);
64
65/* Switch to a new global console state (CONSOLE_FLAG_BOOT/RUNTIME/CRASH). */
66void console_switch_state(unsigned int new_state);
67/* Output a character on all consoles registered for the current state. */
Achin Gupta4f6ad662013-10-25 09:08:21 +010068int console_putc(int c);
Julius Werner94f89072017-07-31 18:15:11 -070069/* Read a character (blocking) from any console registered for current state. */
Achin Gupta4f6ad662013-10-25 09:08:21 +010070int console_getc(void);
Julius Werner94f89072017-07-31 18:15:11 -070071/* Flush all consoles registered for the current state. */
Antonio Nino Diaz8377ae42017-02-06 16:03:41 +000072int console_flush(void);
Achin Gupta4f6ad662013-10-25 09:08:21 +010073
Julius Werner94f89072017-07-31 18:15:11 -070074#if !MULTI_CONSOLE_API
Dan Handley6fa89a22018-02-27 16:03:58 +000075/* REMOVED on AArch64 -- use console_<driver>_register() instead! */
Julius Werner94f89072017-07-31 18:15:11 -070076int console_init(uintptr_t base_addr,
Dan Handley6fa89a22018-02-27 16:03:58 +000077 unsigned int uart_clk, unsigned int baud_rate);
78void console_uninit(void);
Julius Werner94f89072017-07-31 18:15:11 -070079#endif
80
81#endif /* __ASSEMBLY__ */
82
Achin Gupta4f6ad662013-10-25 09:08:21 +010083#endif /* __CONSOLE_H__ */
84