coreboot-kgpe-d16/util
Karthikeyan Ramasubramanian d7a5d9e9da util/amdfwtool: Add ability to split hash table
Hash table containing hashes of all signed PSP binaries is compiled at
build time and installed into the concerned CBFS. During boot, PSP
verstage reads the hash table binary and passes it to PSP bootloader.
PSP bootloader in turn uses the hash table to verify the signed PSP
binaries. Currently the hashes for all the signed PSP binaries are
compiled into one hash table. On upcoming platforms with more number of
signed PSP binaries, PSP bootloader does not have resources to handle
one monolithic hash table. Instead PSP bootloader recommends splitting
them into smaller hash tables (currently limited to 3 hash tables).

Update amdfwtool tool to support splitting hash tables. This is done by
adding an optional hash table id to the entries in the amdfw.cfg file.
By default, one hash table binary is always compiled and it's name is of
the format ${signed_rom}.hash. If an entry has a hash table id defined,
then this utility will compile a separate hash table binary whose name
is of the format ${signed_rom}.${N}.hash where N is the hash table id.

BUG=b:277292697
TEST=Build Skyrim BIOS image and boot to OS. Ensure that the hash table
is identical with and without this change. Perform suspend/resume
cycles, warm/cold reset cycles for 50 iterations each.
TEST=Artificially inject hash table id against some entries in
amdfw.cfg and ensure that the concerned hash table binaries are getting
compiled.

Change-Id: I7ef338d67695a34c33b5c166924832939f381191
Signed-off-by: Karthikeyan Ramasubramanian <kramasub@google.com>
Reviewed-on: https://review.coreboot.org/c/coreboot/+/75188
Tested-by: build bot (Jenkins) <no-reply@coreboot.org>
Reviewed-by: Raul Rangel <rrangel@chromium.org>
2023-06-02 22:19:44 +00:00
..
abuild util/abuild: Add flags to allow abuild to skip boards 2023-02-07 23:33:39 +00:00
acpi
amdfwtool util/amdfwtool: Add ability to split hash table 2023-06-02 22:19:44 +00:00
amdtools
apcb util/apcb/apcb_v3_edit: Add support for LP5X SDRAM 2022-08-25 00:49:52 +00:00
archive util: Add SPDX license headers to Makefiles 2022-11-22 12:47:09 +00:00
autoport ec/lenovo/pmh7/chip.h: Use 'bool' instead of 'int' 2023-04-08 03:36:07 +00:00
bincfg util: Add SPDX license headers to Makefiles 2022-11-22 12:47:09 +00:00
board_status
bucts util: Add SPDX license headers to Makefiles 2022-11-22 12:47:09 +00:00
cavium
cbfstool util: Use common ARRAY_SIZE define 2023-05-22 19:24:27 +00:00
cbmem util: Use common ARRAY_SIZE define 2023-05-22 19:24:27 +00:00
chromeos util/chromeos: Add EC header update utility 2023-05-16 16:34:17 +00:00
coreboot-configurator util/coreboot-configurator: Update the README 2022-10-07 22:06:06 +00:00
crossgcc util/crossgcc: Update nasm from 2.15.05 to 2.16.01 2023-05-29 21:06:41 +00:00
docker util/docker: Split coreboot-sdk test into its own docker image 2023-06-02 22:12:27 +00:00
dtd_parser
ectool util/ectool/Makefile: improve cross-compilation support 2022-12-09 11:05:27 +00:00
exynos
find_usbdebug
futility util: Add SPDX license headers to Makefiles 2022-11-22 12:47:09 +00:00
fuzz-tests util: Add SPDX license headers to Makefiles 2022-11-22 12:47:09 +00:00
genbuild_h util/genbuild_h: Only use version tags in expected format 2022-12-17 20:37:22 +00:00
gitconfig commit-msg: Match the Signed-off-by line with name and mail address 2023-05-26 21:16:32 +00:00
goswid@bdd55e4202 Add SBOM (Software Bill of Materials) Generation 2022-08-22 14:48:46 +00:00
ifdtool util/ifdtool: Add support for Intel 800 series chipset 2023-05-27 04:01:45 +00:00
intelmetool util: Use common ARRAY_SIZE define 2023-05-22 19:24:27 +00:00
intelp2m util: Add SPDX license headers to Makefiles 2022-11-22 12:47:09 +00:00
inteltool util/inteltool: Add ADL-S device identifications 2023-05-11 13:05:45 +00:00
intelvbttool
ipqheader
kbc1126 util: Add SPDX license headers to Makefiles 2022-11-22 12:47:09 +00:00
kconfig util/kconfig: Fix default value getter for integer options 2023-05-22 12:34:50 +00:00
lint tree: Replace `egrep` with `grep -E` 2023-04-06 19:54:44 +00:00
liveiso util/liveiso: Move NixOS configs to subdirectory 2023-03-17 19:27:31 +00:00
mainboard mb/google/rex: add variant gpio tables for variant creation 2023-04-13 17:40:26 +00:00
marvell util: Use common ARRAY_SIZE define 2023-05-22 19:24:27 +00:00
me_cleaner
mma
msrtool util: Add SPDX license headers to Makefiles 2022-11-22 12:47:09 +00:00
mtkheader
nixshell util/nixshell/toolchain: Update GNAT to version 12 2022-08-18 17:03:10 +00:00
nvidia util: Add SPDX license headers to Makefiles 2022-11-22 12:47:09 +00:00
nvramtool
pmh7tool
post util: Add SPDX license headers to Makefiles 2022-11-22 12:47:09 +00:00
qemu
qualcomm
release util/release: Update build-release script 2023-02-15 13:08:45 +00:00
riscv
rockchip
sconfig lib/version: Move board identification strings 2023-04-22 16:20:49 +00:00
scripts util/scripts/show_platforms.sh: Fix reStructuredText table output 2023-05-11 16:53:23 +00:00
showdevicetree
spd_tools util/spd_tools: Add support for Phoenix platform 2023-04-05 10:01:15 +00:00
spdtool
spkmodem_recv
superiotool util: Use common ARRAY_SIZE define 2023-05-22 19:24:27 +00:00
supermicro util: Add SPDX license headers to Makefiles 2022-11-22 12:47:09 +00:00
testing util/testing: Allow scanbuild test to be skipped 2023-02-08 19:15:40 +00:00
uio_usbdebug
util_readme
vboot_list
vgabios
x86
xcompile libpayload;arch,cpu/x86: drop USE_MARCH_586 Kconfig option 2023-05-27 00:29:02 +00:00
README.md

README.md

  • abuild - coreboot autobuild script builds coreboot images for all available targets. bash
  • acpi - Walk through all ACPI tables with their addresses. bash
  • amdfwtool - Create AMD Firmware combination C
  • amdtools Various tools for AMD processors
    • update_efs_spi_speed - Change SPI speed in binary. Bash
    • Tools to compare extended K8 memory settings.
    • k8-compare-pci-space.pl - Shows differences between values in PCI space and the default value. Perl
    • k8-interpret-extended-memory-settings.pl - Shows differences between memory controller values and the default value. Perl
    • k8-read-mem-settings.sh - Makes data files understood by the k8-interpret-extended-memory-settings script. Bash
    • parse-bkdg.pl - Make bkdg.data file used by above scripts. Perl
    • example_input - Sample input for the above scripts. Text
  • apcb - AMD PSP Control Block tools
    • apcb_edit.py - This tool allows patching an existing APCB binary with specific SPDs and GPIO selection pins. Python3
    • apcb_v3_edit.py - This tool allows patching an existing APCB v3 binary with up to 16 specific SPDs. Python3
  • archive - Concatenate files and create an archive C
  • autoport - Automated porting coreboot to Sandy Bridge/Ivy Bridge platforms Go
  • bincfg - Compiler/Decompiler for data blobs with specs Lex Yacc
  • board_status - Tools to collect logs and upload them to the board status repository Bash Go
  • bucts - A tool to manipulate the BUC.TS bit on Intel targets. C
  • cavium - Devicetree_convert Tool to convert a DTB to a static C file Python
  • cbfstool
    • cbfstool - For manipulating CBFS file C
    • fmaptool - Converts plaintext fmd files into fmap blobs C
    • rmodtool - Creates rmodules C
    • ifwitool - For manipulating IFWI C
  • cbmem - CBMEM parser to read e.g. timestamps and console log C
  • chromeos - These scripts can be used to access ChromeOS resources, for example to extract System Agent reference code and other blobs (e.g. mrc.bin, refcode, VGA option roms) from a ChromeOS recovery image. C
  • crossgcc - A cross toolchain builder for -elf toolchains (ie. no libc support) Bash
  • docker - Dockerfiles for coreboot-sdk, coreboot-jenkins-node, coreboot.org-status and docs.coreboot.org Make
  • dtd_parser - DTD structure parser Python2
  • ectool - Dumps the RAM of a laptop's Embedded/Environmental Controller (EC). C
  • exynos - Computes and fills Exynos ROM checksum (for BL1 or BL2). Python3
  • find_usbdebug - Help find USB debug ports Bash
  • futility - Firmware utility for signing ChromeOS images Make
  • fuzz-tests - Create test cases that crash the jpeg code. C
  • genbuild_h - Generate build system definitions Shell
  • gitconfig - Initialize git repository submodules install git hooks Bash
  • ifdtool - Extract and dump Intel Firmware Descriptor information C
  • intelmetool - Dump interesting things about Management Engine even if hidden C
  • intelp2m - convert the configuration DW0/1 registers value from an inteltool dump to coreboot macros. go
  • inteltool - Provides information about the Intel CPU/chipset hardware configuration (register contents, MSRs, etc). C
  • intelvbttool - Parse VBT from VGA BIOS C
  • ipqheader
    • createxbl.py - Concatenates XBL segments into one ELF image Python
    • ipqheader.py - Returns a packed MBN header image with the specified base and size Python
    • mbncat.py - Generate ipq8064 uber SBL Python
    • mbn_tools.py - Contains all MBN Utilities for image generation Python
  • kbc1126 - Tools used to dump the two blobs from the factory firmware of many HP laptops with 8051-based SMSC KBC1098/KBC1126 embedded controller and insert them to the firmware image. C
  • kconfig - Build system Make
  • lint - Source linter and linting rules Shell
  • liveiso - A script and NixOS configuration files to create an ISO image for testing purposes and for working on firmware. Bash
  • mainboard - mainboard specific scripts
    • google - Directory for google mainboard specific scripts
  • marvell - Add U-Boot boot loader for Marvell ARMADA38X C
  • me_cleaner - Tool for partial deblobbing of Intel ME/TXE firmware images Python
  • mma - Memory Margin Analysis automation tests Bash
  • msrtool - Dumps chipset-specific MSR registers. C
  • mtkheader - Generate MediaTek bootload header. Python3
  • nvidia - nvidia blob parsers
  • nvramtool - Reads and writes coreboot parameters and displaying information from the coreboot table in CMOS/NVRAM. C
  • pmh7tool - Dumps, reads and writes PMH7 registers on Lenovo ThinkPads. PMH7 is used for switching on and off the power of some devices on the board such as dGPU. C
  • post - Userspace utility that can be used to test POST cards. C
  • qemu - Makefile & comprehensive default config for QEMU Q35 emulation Make
  • qualcomm - CMM script to debug Qualcomm coreboot environments. CMM
  • release - Generate coreboot release Bash
  • riscv
    • make-spike-elf.sh - Converts a flat file into an ELF, that can be passed to SPIKE, the RISC-V reference emulator.Bash
    • sifive-gpt.py - Wraps the bootblock in a GPT partition for SiFive's bootrom. Python3
  • rockchip - Generate Rockchip idblock bootloader. Python3
  • sconfig - coreboot device tree compiler Lex Yacc
  • scripts
    • config - Manipulate options in a .config file from the command line Bash
    • cross-repo-cherrypick - Pull in patches from another tree from a gerrit repository. Shell
    • decode_spd.sh - Decodes Serial Presence Detect (SPD) files into various human readable formats. Bash
    • dts-to-fmd.sh -Converts a depthcharge fmap.dts into an fmaptool compatible .fmd format Bash
    • find-unused-kconfig-symbols.sh - Points out Kconfig variables that may be unused. There are some false positives, but it serves as a starting point Shell
    • gerrit-rebase - Applies all commits that from-branch has over to-branch, based on a common ancestor and gerrit meta-data Bash
    • get_maintainer.pl - Print selected MAINTAINERS information for the files modified in a patch or for a file Perl
    • maintainers.go - Build subsystem Maintainers Go
    • no-fsf-addresses.sh - Removes various FSF addresses from license headers Shell
    • parse-maintainers.pl - Script to alphabetize MAINTAINERS file Perl
    • ucode_h_to_bin.sh - Microcode conversion tool Bash
    • update_submodules - Check all submodules for updates Bash
  • showdevicetree - Compile and dump the device tree C
  • spdtool - Dumps SPD ROMs from a given blob to separate files using known patterns and reserved bits. Useful for analysing firmware that holds SPDs on boards that have soldered down DRAM. python
  • spkmodem_recv - Decode spkmodem signals C
  • superiotool - A user-space utility to detect Super I/O of a mainboard and provide detailed information about the register contents of the Super I/O. C
  • supermicro - Tools for supermicro platforms
    • smcbiosinfo - Generates SMC biosinfo for BMC BIOS updates C
  • testing - coreboot test targets Make
  • uio_usbdebug - Debug coreboot's usbdebug driver inside a running operating system (only Linux at this time). C
  • util_readme - Creates README.md of description files in ./util subdirectories Bash
  • vboot_list - Tools to generate a list of vboot enabled devices to the documentation Bash
  • vgabios - emulated vga driver for qemu C
  • x86 - Generates 32-bit PAE page tables based on a CSV input file. Go
  • xcompile - Cross compile setup Bash