1 /* 2 * Copyright (C) 2015, Bin Meng <bmeng.cn@gmail.com> 3 * 4 * SPDX-License-Identifier: GPL-2.0+ 5 */ 6 7 #ifndef _X86_TABLES_H_ 8 #define _X86_TABLES_H_ 9 10 #include <tables_csum.h> 11 12 /* 13 * All x86 tables happen to like the address range from 0xf0000 to 0x100000. 14 * We use 0xf0000 as the starting address to store those tables, including 15 * PIRQ routing table, Multi-Processor table and ACPI table. 16 */ 17 #define ROM_TABLE_ADDR 0xf0000 18 #define ROM_TABLE_END 0xfffff 19 20 #define ROM_TABLE_ALIGN 1024 21 22 /* SeaBIOS expects coreboot tables at address range 0x0000-0x1000 */ 23 #define CB_TABLE_ADDR 0x800 24 25 /** 26 * table_compute_checksum() - Compute a table checksum 27 * 28 * This computes an 8-bit checksum for the configuration table. 29 * All bytes in the configuration table, including checksum itself and 30 * reserved bytes must add up to zero. 31 * 32 * @v: configuration table base address 33 * @len: configuration table size 34 * @return: the 8-bit checksum 35 */ 36 u8 table_compute_checksum(void *v, int len); 37 38 /** 39 * table_fill_string() - Fill a string with pad in the configuration table 40 * 41 * This fills a string in the configuration table. It copies number of bytes 42 * from the source string, and if source string length is shorter than the 43 * required size to copy, pad the table string with the given pad character. 44 * 45 * @dest: where to fill a string 46 * @src: where to copy from 47 * @n: number of bytes to copy 48 * @pad: character to pad the remaining bytes 49 */ 50 void table_fill_string(char *dest, const char *src, size_t n, char pad); 51 52 /** 53 * write_tables() - Write x86 configuration tables 54 * 55 * This writes x86 configuration tables, including PIRQ routing table, 56 * Multi-Processor table and ACPI table. Whether a specific type of 57 * configuration table is written is controlled by a Kconfig option. 58 */ 59 void write_tables(void); 60 61 /** 62 * write_pirq_routing_table() - Write PIRQ routing table 63 * 64 * This writes PIRQ routing table at a given address. 65 * 66 * @start: start address to write PIRQ routing table 67 * @return: end address of PIRQ routing table 68 */ 69 ulong write_pirq_routing_table(ulong start); 70 71 #endif /* _X86_TABLES_H_ */ 72