/* 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 */