0ee920bf64
Add a new CONFIG_OVERRIDE_UART_FOR_CONSOLE token to override the index of uart port, platform use a get_uart_for_console routine to decide what index value should be used for console. Signed-off-by: Bryant Ou <Bryant.Ou.Q@gmail.com> Change-Id: I2079bd1e5ffa209553383b6aafe3b8724849ba2a Reviewed-on: https://review.coreboot.org/c/coreboot/+/45405 Tested-by: build bot (Jenkins) <no-reply@coreboot.org> Reviewed-by: Marc Jones <marc@marcjonesconsulting.com> Reviewed-by: Jonathan Zhang <jonzhang@fb.com>
101 lines
2.7 KiB
C
101 lines
2.7 KiB
C
/* SPDX-License-Identifier: GPL-2.0-only */
|
|
|
|
#ifndef CONSOLE_UART_H
|
|
#define CONSOLE_UART_H
|
|
|
|
#include <stdint.h>
|
|
|
|
/* Return the clock frequency UART uses as reference clock for
|
|
* baudrate generator. */
|
|
unsigned int uart_platform_refclk(void);
|
|
|
|
#if CONFIG(UART_OVERRIDE_BAUDRATE)
|
|
/* Return the baudrate, define this in your platform when using the above
|
|
configuration. */
|
|
unsigned int get_uart_baudrate(void);
|
|
#else
|
|
static inline unsigned int get_uart_baudrate(void)
|
|
{
|
|
return CONFIG_TTYS0_BAUD;
|
|
}
|
|
#endif
|
|
|
|
#if CONFIG(OVERRIDE_UART_FOR_CONSOLE)
|
|
/* Return the index of uart port, define this in your platform
|
|
* when need to use variables to override the index.
|
|
*/
|
|
unsigned int get_uart_for_console(void);
|
|
#else
|
|
static inline unsigned int get_uart_for_console(void)
|
|
{
|
|
return CONFIG_UART_FOR_CONSOLE;
|
|
}
|
|
#endif
|
|
|
|
/* Returns the divisor value for a given baudrate.
|
|
* The formula to satisfy is:
|
|
* refclk / divisor = baudrate * oversample
|
|
*/
|
|
unsigned int uart_baudrate_divisor(unsigned int baudrate,
|
|
unsigned int refclk, unsigned int oversample);
|
|
|
|
/* Returns the oversample divisor multiplied by any other divisors that act
|
|
* on the input clock
|
|
*/
|
|
unsigned int uart_input_clock_divider(void);
|
|
|
|
/* Bitbang out one byte on an 8n1 UART through the output function set_tx(). */
|
|
void uart_bitbang_tx_byte(unsigned char data, void (*set_tx)(int line_state));
|
|
|
|
void uart_init(unsigned int idx);
|
|
void uart_tx_byte(unsigned int idx, unsigned char data);
|
|
void uart_tx_flush(unsigned int idx);
|
|
unsigned char uart_rx_byte(unsigned int idx);
|
|
|
|
uintptr_t uart_platform_base(unsigned int idx);
|
|
|
|
static inline void *uart_platform_baseptr(unsigned int idx)
|
|
{
|
|
return (void *)uart_platform_base(idx);
|
|
}
|
|
|
|
void oxford_remap(unsigned int new_base);
|
|
|
|
#define __CONSOLE_SERIAL_ENABLE__ (CONFIG(CONSOLE_SERIAL) && \
|
|
(ENV_BOOTBLOCK || ENV_ROMSTAGE || ENV_RAMSTAGE || ENV_SEPARATE_VERSTAGE \
|
|
|| ENV_POSTCAR || (ENV_SMM && CONFIG(DEBUG_SMI))))
|
|
|
|
#if __CONSOLE_SERIAL_ENABLE__
|
|
static inline void __uart_init(void)
|
|
{
|
|
uart_init(get_uart_for_console());
|
|
}
|
|
static inline void __uart_tx_byte(u8 data)
|
|
{
|
|
uart_tx_byte(get_uart_for_console(), data);
|
|
}
|
|
static inline void __uart_tx_flush(void)
|
|
{
|
|
uart_tx_flush(get_uart_for_console());
|
|
}
|
|
#else
|
|
static inline void __uart_init(void) {}
|
|
static inline void __uart_tx_byte(u8 data) {}
|
|
static inline void __uart_tx_flush(void) {}
|
|
#endif
|
|
|
|
#if CONFIG(GDB_STUB) && (ENV_ROMSTAGE || ENV_RAMSTAGE)
|
|
#define CONF_UART_FOR_GDB CONFIG_UART_FOR_CONSOLE
|
|
static inline void __gdb_hw_init(void) { uart_init(CONF_UART_FOR_GDB); }
|
|
static inline void __gdb_tx_byte(u8 data)
|
|
{
|
|
uart_tx_byte(CONF_UART_FOR_GDB, data);
|
|
}
|
|
static inline void __gdb_tx_flush(void) { uart_tx_flush(CONF_UART_FOR_GDB); }
|
|
static inline u8 __gdb_rx_byte(void)
|
|
{
|
|
return uart_rx_byte(CONF_UART_FOR_GDB);
|
|
}
|
|
#endif
|
|
|
|
#endif /* CONSOLE_UART_H */
|