coreboot/util
Filip Gołaś f4271cad0a ifdtool: Add set top swap size PCH strap subcommand
Top-Block Swap mode of Intel PCH allows to swap the boot block with
another location placed directly below it by redirecting the memory
accesses.

The range of the addresses to be redirected is configured using the Top
Swap Block Size (or BOOT_BLOCK_SIZE) PCH strap using 3 bits to encode
one of 8 sizes:
    64 KB, 128 KB, 256 KB, 512 KB, 1 MB, 2 MB, 4 MB or 8 MB.

The source and target ranges depend on the configured size, eg:
- 64 KB  - FFFF_0000h - FFFF_FFFFh -> FFFE_0000h - FFFE_FFFFh
- 128 KB - FFFE_0000h - FFFF_FFFFh -> FFFC_0000h - FFFD_FFFFh
- 8 MB   - FF80_0000h - FFFF_FFFFh -> FF00_0000h - FF7F_FFFFh

Only supporting Alder Lake-P and Alder Lake-N for now.

Needed for the bootblock redundancy feature suggested at
https://mail.coreboot.org/archives/list/coreboot@coreboot.org/thread/C6JN2PB7K7D67EG7OIKB6BBERZU5YV35/

TEST=check using xxd, MFIT tool, ensure VP6670 boots
Test details:
xxd:
  ./util/ifdtool/ifdtool -p adl -T 0x10000 vp66xx_fd.bin && \
  xxd vp66xx_fd.bin > vp66xx.hex && \
  xxd vp66xx_fd.bin.new > vp66xx_fd.new.hex && \
  diff -au vp66xx_fd.hex vp66xx_fd.new.hex

File vp66xx_fd.bin is 4096 bytes
Writing new image to vp66xx_fd.bin.new

--- vp66xx_fd.hex       2025-10-08 12:03:09.527193533 +0200
+++ vp66xx_fd.new.hex   2025-10-08 12:05:08.717108142 +0200
@@ -18,7 +18,7 @@
 00000110: 7f78 0700 0000 0000 1800 0000 0000 1f00  .x..............
 00000120: 0808 1170 0000 0000 0000 7f06 80f8 8107  ...p............
 00000130: 0000 0000 0f00 0000 2222 2222 2202 2222  ........""""".""
-00000140: 0000 0000 0000 0000 0000 ff00 6000 80c8  ............`...
+00000140: 0000 0000 0000 0000 0000 ff00 0000 80c8  ................
 00000150: 4586 0036 0000 0000 0002 5800 0000 4000  E..6......X...@.
 00000160: 0018 0000 0000 0000 0000 0000 0000 0000  ................
 00000170: 0000 0000 0000 0000 54b3 04a0 3000 0140  ........T...0..@

mfittool:
./mfit --gui -decompose protectli_vp66xx_v0.9.2.rom
In the UI:
Flash Settings > BIOS Configuration > Top Swap Block Size
shows the value changing to the expected one, ie.
    -T 0x10000 results in 64kB
    -T 0x20000 results in 128kB
    -T 0x400000 results in 4MB
    etc.

Change-Id: I50e9d4160ee4b60e83567bcd33c9d80d428cf2bb
Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>
Reviewed-on: https://review.coreboot.org/c/coreboot/+/89438
Reviewed-by: Sergii Dmytruk <sergii.dmytruk@3mdeb.com>
Tested-by: build bot (Jenkins) <no-reply@coreboot.org>
2025-10-22 18:48:58 +00:00
..
abuild util/abuild: Add --sequential-boards option 2025-07-16 21:49:43 +00:00
acpi
amdfwtool amdfwtool: Move ISH before PSP L2 2025-10-19 19:41:34 +00:00
amdtools util/amdtools: Add ec_usb_pd_fw 2025-07-17 18:13:16 +00:00
apcb util/apcb: Add apcb edit tool for phoenix 2023-07-06 17:46:08 +00:00
archive util: Add SPDX license headers to Makefiles 2022-11-22 12:47:09 +00:00
autoport util/autoport: Add function to create empty files 2025-05-07 14:50:02 +00:00
bincfg util: Rename Makefiles from .inc to .mk 2024-01-26 12:43:18 +00:00
board_status board_status/getrevision.sh: Ignore non-annotated tags 2025-02-14 17:10:47 +00:00
bucts util: Add SPDX license headers to Makefiles 2022-11-22 12:47:09 +00:00
cavium
cbfstool commonlib/bsd: Add Bluetooth wake source in ELOG event data 2025-09-10 21:39:05 +00:00
cbmem util/cbmem: Change abort() to exit(1) in die() 2025-08-30 13:53:51 +00:00
chromeos util/chromeos/extract_blobs: Add support for command line params 2025-10-09 15:48:57 +00:00
coreboot-configurator util/coreboot-configurator: Don't use old style function definition 2023-08-28 17:07:59 +00:00
crossgcc crossgcc: Upgrade binutils from version 2.44 to 2.45 2025-10-19 20:13:22 +00:00
docker util/docker/jenkins-node: Use the correct branch for encapsulate 2025-09-25 16:05:51 +00:00
dtd_parser
ectool util/ectool/Makefile: improve cross-compilation support 2022-12-09 11:05:27 +00:00
exynos
find_usbdebug util/find_usbdebug: Fix line indented with spaces instead of tabs 2025-01-20 03:23:48 +00:00
futility util: Rename Makefiles from .inc to .mk 2024-01-26 12:43:18 +00:00
fuzz-tests lib/jpeg: Replace decoder with Wuffs' implementation 2023-12-13 16:17:34 +00:00
genbuild_h SBOM: Change makefile to get versions from build.h 2025-07-04 13:17:38 +00:00
gitconfig Switch gitconfig.sh over to use main branch 2023-09-11 06:56:59 +00:00
goswid@567a1c99b0 Update goswid submodule to upstream master 2023-06-12 00:51:50 +00:00
hda-decoder util/hda-decoder: Add feature to print configuration defaults as verbs 2024-10-07 21:10:03 +00:00
ifdtool ifdtool: Add set top swap size PCH strap subcommand 2025-10-22 18:48:58 +00:00
intelmetool util/intelmetool: Print the address in map_physical errors in hex 2024-03-17 19:08:48 +00:00
intelp2m Documentation,util: Run util_readme.sh to regen *.md 2025-04-11 08:17:48 +00:00
inteltool util/inteltool: Add Twin Lake UHD Graphics PCI IDs 2025-10-15 14:03:20 +00:00
intelvbttool util: Use C99 flexible arrays 2023-08-01 12:51:25 +00:00
kbc1126 util: Add SPDX license headers to Makefiles 2022-11-22 12:47:09 +00:00
kconfig util/kconfig: Fix xconfig 2025-09-12 14:05:48 +00:00
lint util/lint: Add a license check exception for .gitkeep files 2025-10-22 17:10:30 +00:00
liveiso util/liveiso/nixos/graphical: Preconfigure some Gnome settings 2024-08-14 15:33:38 +00:00
mainboard tree: Use true false for PcieRpLtrEnable[] 2025-02-03 06:15:03 +00:00
marvell util/marvell/doimage_mv: Update CFLAGS to CFLAGS_doimage 2024-10-14 15:26:38 +00:00
me_cleaner
mec152x util: Add Microchip EC FW tool 2025-07-17 18:13:10 +00:00
mediatek util/mediatek: Add check-pi-img.py 2025-04-14 07:35:00 +00:00
mma util: Drop flashrom -p host alias which equals to -p internal 2023-09-25 14:06:32 +00:00
msrtool util/msrtool: Don't use old style function definition 2023-08-28 17:08:12 +00:00
nixshell util/nixshell: Add a dev shell for i386 arch 2024-03-14 18:15:51 +00:00
nvidia util/nvidia: Use c11 dialect 2024-05-29 08:19:15 +00:00
nvramtool Treewide: Fix incorrect SPDX license strings 2024-02-18 01:55:57 +00:00
pmh7tool util: Allow installing to a build root 2022-07-12 22:11:35 +00:00
post util: Add SPDX license headers to Makefiles 2022-11-22 12:47:09 +00:00
qemu mb/emulation/qemu-riscv: Change to -bios option 2024-03-05 18:57:29 +00:00
qualcomm soc/qc/x1p42100: Support to generate Bootblock as multi ELF 2025-07-02 03:27:49 +00:00
release SBOM: Change makefile to get versions from build.h 2025-07-04 13:17:38 +00:00
riscv util/riscv: Add starfive Image building tool 2025-02-14 17:11:34 +00:00
rockchip
sconfig sconfig: Move (WEAK_)DEV_PTR from device.h to static.h 2024-11-10 10:35:44 +00:00
scripts update_submodules: Fix submodule path handling 2025-06-06 13:26:30 +00:00
smmstoretool util/smmstoretool: Support other block sizes 2025-08-30 13:53:59 +00:00
spd_tools util/spd_tools: Add Intel Panther Lake (PTL) platform 2024-08-09 09:24:18 +00:00
spdtool
spkmodem_recv util: Allow installing to a build root 2022-07-12 22:11:35 +00:00
superiotool util/superiotool: Dump one more NCT6779D register 2025-05-13 14:51:45 +00:00
supermicro util/supermicro: Fix mem leak in get_line_as_int error conditions 2025-07-08 16:18:31 +00:00
testing tree: Replace scan-build by clang-tidy 2025-07-01 01:12:32 +00:00
uio_usbdebug
util_readme util/util_readme: Use HTML comments in generated output 2024-10-27 23:50:57 +00:00
vboot_list
vgabios tree: Drop duplicated <device/{path,resource}.h> 2024-04-12 04:24:20 +00:00
x86
xcompile xcompile: Use Walloc-size GCC option 2025-05-11 20:24:09 +00:00
README.md util/mediatek: Add check-pi-img.py 2025-04-14 07:35:00 +00:00

  • 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/Haswell 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
  • hda-decoder - Dumps decoded HDA default configuration registers into a format which can be used in coreboot's verb table Go
  • ifdtool - Extract and dump Intel Firmware Descriptor information C
  • intelmetool - Dump interesting things about Management Engine even if hidden C
  • intelp2m - Convert the inteltool register dump to gpio.h with GPIO configuration for porting coreboot to your motherboard. Go
  • inteltool - Provides information about the Intel CPU/chipset hardware configuration (register contents, MSRs, etc). C
  • intelvbttool - Parse VBT from VGA BIOS C
  • 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
  • nixos - 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
  • mediatek
    • check-pi-img.py - Check PI_IMG firmware. Python3
    • gen-bl-img.py - Generate MediaTek bootloader header. Python3
  • mma - Memory Margin Analysis automation tests Bash
  • msrtool - Dumps chipset-specific MSR registers. C
  • 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
    • CMM script to debug Qualcomm coreboot environments. CMM 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
  • 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
    • capture_commands.sh - Write all commands from the build to a file. Shell
    • 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_new_user_commits.sh - Finds new gerrit committers 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
    • rm_unused_code - Remove all code not used for a platform from the local git repository for auditing or release Bash
    • show_platforms.sh - Makes a list of platforms in the tree. Does not show variants. Shell
    • ucode_h_to_bin.sh - Microcode conversion tool Bash
    • update_submodules - Check all submodules for updates Bash
  • smmstoretool - Offline SMMSTORE variable modification tool 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