1 /* SPDX-License-Identifier: BSD-3-Clause */
3 * This file is part of the libpayload project.
5 * Copyright (C) 2008 Advanced Micro Devices, Inc.
8 #ifndef _COREBOOT_TABLES_H
9 #define _COREBOOT_TABLES_H
32 #define CB_TAG_UNUSED 0x0000
33 #define CB_TAG_MEMORY 0x0001
35 struct cb_memory_range {
36 struct cbuint64 start;
42 #define CB_MEM_RESERVED 2
45 #define CB_MEM_UNUSABLE 5
46 #define CB_MEM_VENDOR_RSVD 6
47 #define CB_MEM_TABLE 16
52 struct cb_memory_range map[0];
55 #define CB_TAG_HWRPB 0x0002
63 #define CB_TAG_MAINBOARD 0x0003
73 #define CB_TAG_VERSION 0x0004
74 #define CB_TAG_EXTRA_VERSION 0x0005
75 #define CB_TAG_BUILD 0x0006
76 #define CB_TAG_COMPILE_TIME 0x0007
77 #define CB_TAG_COMPILE_BY 0x0008
78 #define CB_TAG_COMPILE_HOST 0x0009
79 #define CB_TAG_COMPILE_DOMAIN 0x000a
80 #define CB_TAG_COMPILER 0x000b
81 #define CB_TAG_LINKER 0x000c
82 #define CB_TAG_ASSEMBLER 0x000d
90 #define CB_TAG_SERIAL 0x000f
95 #define CB_SERIAL_TYPE_IO_MAPPED 1
96 #define CB_SERIAL_TYPE_MEMORY_MAPPED 2
102 #define CB_TAG_CONSOLE 0x0010
110 #define CB_TAG_CONSOLE_SERIAL8250 0
111 #define CB_TAG_CONSOLE_VGA 1 /* OBSOLETE */
112 #define CB_TAG_CONSOLE_BTEXT 2 /* OBSOLETE */
113 #define CB_TAG_CONSOLE_LOGBUF 3
114 #define CB_TAG_CONSOLE_SROM 4 /* OBSOLETE */
115 #define CB_TAG_CONSOLE_EHCI 5
117 #define CB_TAG_FORWARD 0x0011
125 #define CB_TAG_FRAMEBUFFER 0x0012
127 struct cb_framebuffer {
130 u64 physical_address;
141 u8 reserved_mask_pos;
142 u8 reserved_mask_size;
145 #define CB_TAG_GPIO 0x0013
146 #define GPIO_MAX_NAME_LENGTH 16
152 u8 name[GPIO_MAX_NAME_LENGTH];
159 struct cb_gpio gpios[0];
162 #define CB_TAG_FDT 0x0014
166 uint32_t size; /* size of the entire entry */
167 /* the actual FDT gets placed here */
170 #define CB_TAG_VDAT 0x0015
174 uint32_t size; /* size of the entire entry */
179 #define CB_TAG_TIMESTAMPS 0x0016
180 #define CB_TAG_CBMEM_CONSOLE 0x0017
181 #define CB_TAG_MRC_CACHE 0x0018
183 struct cb_cbmem_tab {
189 #define CB_TAG_VBNV 0x0019
198 #define CB_TAG_CMOS_OPTION_TABLE 0x00c8
200 struct cb_cmos_option_table {
206 #define CB_TAG_OPTION 0x00c9
208 #define CMOS_MAX_NAME_LENGTH 32
210 struct cb_cmos_entries {
217 u8 name[CMOS_MAX_NAME_LENGTH];
220 #define CB_TAG_OPTION_ENUM 0x00ca
221 #define CMOS_MAX_TEXT_LENGTH 32
223 struct cb_cmos_enums {
228 u8 text[CMOS_MAX_TEXT_LENGTH];
231 #define CB_TAG_OPTION_DEFAULTS 0x00cb
232 #define CMOS_IMAGE_BUFFER_SIZE 128
234 struct cb_cmos_defaults {
238 u8 name[CMOS_MAX_NAME_LENGTH];
239 u8 default_set[CMOS_IMAGE_BUFFER_SIZE];
242 #define CB_TAG_OPTION_CHECKSUM 0x00cc
243 #define CHECKSUM_NONE 0
244 #define CHECKSUM_PCBIOS 1
246 struct cb_cmos_checksum {
257 #define MEM_RANGE_COUNT(_rec) \
258 (((_rec)->size - sizeof(*(_rec))) / sizeof((_rec)->map[0]))
260 #define MEM_RANGE_PTR(_rec, _idx) \
261 (((u8 *) (_rec)) + sizeof(*(_rec)) \
262 + (sizeof((_rec)->map[0]) * (_idx)))
264 #define MB_VENDOR_STRING(_mb) \
265 (((unsigned char *) ((_mb)->strings)) + (_mb)->vendor_idx)
267 #define MB_PART_STRING(_mb) \
268 (((unsigned char *) ((_mb)->strings)) + (_mb)->part_number_idx)
270 #define UNPACK_CB64(_in) \
271 ((((u64) _in.hi) << 32) | _in.lo)
273 #define CBMEM_TOC_RESERVED 512
274 #define MAX_CBMEM_ENTRIES 16
275 #define CBMEM_MAGIC 0x434f5245
284 #define CBMEM_ID_FREESPACE 0x46524545
285 #define CBMEM_ID_GDT 0x4c474454
286 #define CBMEM_ID_ACPI 0x41435049
287 #define CBMEM_ID_CBTABLE 0x43425442
288 #define CBMEM_ID_PIRQ 0x49525154
289 #define CBMEM_ID_MPTABLE 0x534d5054
290 #define CBMEM_ID_RESUME 0x5245534d
291 #define CBMEM_ID_RESUME_SCRATCH 0x52455343
292 #define CBMEM_ID_SMBIOS 0x534d4254
293 #define CBMEM_ID_TIMESTAMP 0x54494d45
294 #define CBMEM_ID_MRCDATA 0x4d524344
295 #define CBMEM_ID_CONSOLE 0x434f4e53
296 #define CBMEM_ID_NONE 0x00000000
299 * high_table_reserve() - reserve configuration table in high memory
301 * This reserves configuration table in high memory.
305 int high_table_reserve(void);
308 * high_table_malloc() - allocate configuration table in high memory
310 * This allocates configuration table in high memory.
312 * @bytes: size of configuration table to be allocated
313 * @return: pointer to configuration table in high memory
315 void *high_table_malloc(size_t bytes);
318 * write_coreboot_table() - write coreboot table
320 * This writes coreboot table at a given address.
322 * @addr: start address to write coreboot table
323 * @cfg_tables: pointer to configuration table memory area
325 void write_coreboot_table(u32 addr, struct memory_area *cfg_tables);