a2bc2540c2
Having a separate romstage is only desirable: - with advanced setups like vboot or normal/fallback - boot medium is slow at startup (some ARM SOCs) - bootblock is limited in size (Intel APL 32K) When this is not the case there is no need for the extra complexity that romstage brings. Including the romstage sources inside the bootblock substantially reduces the total code footprint. Often the resulting code is 10-20k smaller. This is controlled via a Kconfig option. TESTED: works on qemu x86, arm and aarch64 with and without VBOOT. Change-Id: Id68390edc1ba228b121cca89b80c64a92553e284 Signed-off-by: Arthur Heymans <arthur@aheymans.xyz> Reviewed-on: https://review.coreboot.org/c/coreboot/+/55068 Reviewed-by: Julius Werner <jwerner@chromium.org> Tested-by: build bot (Jenkins) <no-reply@coreboot.org> Reviewed-by: Felix Held <felix-coreboot@felixheld.de>
101 lines
2.8 KiB
C
101 lines
2.8 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_SEPARATE_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_OR_BEFORE || 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 */
|