Certain chipsets don't have a memory-mapped boot media so their code execution for stages prior to DRAM initialization is backed by SRAM or cache-as-ram. The postcar stage/phase handles the cache-as-ram situation where in order to tear down cache-as-ram one needs to be executing out of a backing store that isn't transient. By current definition, cache-as-ram is volatile and tearing it down leads to its contents disappearing. Therefore provide a shim layer, postcar, that's loaded into memory and executed which does 2 things: 1. Tears down cache-as-ram with a chipset helper function. 2. Loads and runs ramstage. Because those 2 things are executed out of ram there's no issue of the code's backing store while executing the code that tears down cache-as-ram. The current implementation makes no assumption regarding cacheability of the DRAM itself. If the chipset code wishes to cache DRAM for loading of the postcar stage/phase then it's also up to the chipset to handle any coherency issues pertaining to cache-as-ram destruction. Change-Id: Ia58efdadd0b48f20cfe7de2f49ab462306c3a19b Signed-off-by: Aaron Durbin <adurbin@chromium.org> Reviewed-on: https://review.coreboot.org/14140 Tested-by: build bot (Jenkins) Reviewed-by: Patrick Georgi <pgeorgi@google.com> Reviewed-by: Furquan Shaikh <furquan@google.com>
81 lines
2.4 KiB
C
81 lines
2.4 KiB
C
/*
|
|
* This file is part of the coreboot project.
|
|
*
|
|
* Copyright (C) 2003 Eric Biederman
|
|
*
|
|
* This program is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation; version 2 of the License.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*/
|
|
|
|
#ifndef CONSOLE_CONSOLE_H_
|
|
#define CONSOLE_CONSOLE_H_
|
|
|
|
#include <stdint.h>
|
|
#include <rules.h>
|
|
#include <console/post_codes.h>
|
|
#include <commonlib/loglevel.h>
|
|
|
|
#ifndef __ROMCC__
|
|
struct console_driver {
|
|
void (*init)(int);
|
|
void (*tx_byte)(int, unsigned char byte);
|
|
void (*tx_flush)(int);
|
|
unsigned char (*rx_byte)(int);
|
|
int (*tst_byte)(void);
|
|
};
|
|
|
|
void post_code(u8 value);
|
|
#if CONFIG_CMOS_POST_EXTRA
|
|
void post_log_extra(u32 value);
|
|
struct device;
|
|
void post_log_path(struct device *dev);
|
|
void post_log_clear(void);
|
|
#else
|
|
#define post_log_extra(x) do {} while (0)
|
|
#define post_log_path(x) do {} while (0)
|
|
#define post_log_clear() do {} while (0)
|
|
#endif
|
|
/* this function is weak and can be overridden by a mainboard function. */
|
|
void mainboard_post(u8 value);
|
|
void __attribute__ ((noreturn)) die(const char *msg);
|
|
|
|
#define __CONSOLE_ENABLE__ \
|
|
((ENV_BOOTBLOCK && CONFIG_BOOTBLOCK_CONSOLE) || \
|
|
ENV_VERSTAGE || ENV_ROMSTAGE || ENV_RAMSTAGE || ENV_POSTCAR || \
|
|
(ENV_SMM && CONFIG_DEBUG_SMI))
|
|
|
|
#if __CONSOLE_ENABLE__
|
|
void console_init(void);
|
|
int console_log_level(int msg_level);
|
|
int do_printk(int msg_level, const char *fmt, ...) __attribute__((format(printf, 2, 3)));
|
|
void do_putchar(unsigned char byte);
|
|
|
|
#define printk(LEVEL, fmt, args...) \
|
|
do { do_printk(LEVEL, fmt, ##args); } while(0)
|
|
|
|
#else
|
|
static inline void console_init(void) {}
|
|
static inline int console_log_level(int msg_level) { return 0; }
|
|
static inline void printk(int LEVEL, const char *fmt, ...) {}
|
|
static inline void do_putchar(unsigned char byte) {}
|
|
#endif
|
|
|
|
#if CONFIG_CHROMEOS
|
|
/* FIXME: Collision of varargs with AMD headers without guard. */
|
|
#include <console/vtxprintf.h>
|
|
#if __CONSOLE_ENABLE__
|
|
void do_printk_va_list(int msg_level, const char *fmt, va_list args);
|
|
#else
|
|
static inline void do_printk_va_list(int l, const char *fmt, va_list args) {}
|
|
#endif
|
|
#endif
|
|
|
|
#endif /* !__ROMCC__ */
|
|
|
|
#endif /* CONSOLE_CONSOLE_H_ */
|