coreboot/Documentation/drivers
Sean Rhodes 817394f12c Makefile.mk: generate EDK2 update capsule
Generate a signed UEFI capsule from the final coreboot ROM image using
EDK2 BaseTools.

When using an EDK2 payload and enabling DRIVERS_EFI_UPDATE_CAPSULES and
DRIVERS_EFI_GENERATE_CAPSULE, the build produces build/coreboot.cap once
the ROM is finalised (after all files were added to CBFS). The capsule
can also be generated explicitly with `make capsule`.

Move the capsule generation and certificate preparation into
payloads/external/edk2/Makefile, including generating the trusted root
certificate PCD include via BinToPcd.

Support capsule flows with an embedded FmpDxe driver by optionally
embedding FmpDxe.efi into generated capsules, and wiring the
embedded-driver Kconfig options through to the EDK2 payload build and
capsule generation.

Always set PersistAcrossReset on the capsule. Make InitiateReset
configurable (default off) because Linux rejects capsules with
InitiateReset when writing via /dev/efi_capsule_loader.

Use CONFIG_DRIVERS_EFI_MAIN_FW_VERSION for GenerateCapsule
--fw-version, but fall back to parsing a leading <major>.<minor> from
CONFIG_LOCALVERSION when it is left at 0. If
CONFIG_DRIVERS_EFI_MAIN_FW_LSV is 0, use the resolved firmware version.

Document capsule generation and embedded driver configuration.

Corresponding edk2 patches can be found at:
https://github.com/tianocore/edk2/pull/12053

Change-Id: I5f56b894d40ddb49f3158bb72f0143d0ebe9c34c
Signed-off-by: Sean Rhodes <sean@starlabs.systems>
Reviewed-on: https://review.coreboot.org/c/coreboot/+/90862
Reviewed-by: Sergii Dmytruk <sergii.dmytruk@3mdeb.com>
Tested-by: build bot (Jenkins) <no-reply@coreboot.org>
2026-03-16 19:51:14 +00:00
..
acpi_fan_control.md Documentation/drivers: Add ACPI five-level fan control documentation 2025-11-05 23:18:19 +00:00
cbfs_smbios.md Documentation/drivers/cbfs_smbios.md: Describe CBFS serial number 2022-10-17 13:58:23 +00:00
cfr.md Fix up CFR's open issues 2024-12-30 21:27:36 +00:00
cfr_internal.md drivers/option/cfr: Remove old sm_object from constructor 2025-11-15 15:27:32 +00:00
dptf.md Documentation/drivers: ensure pages have only one top-level heading 2022-09-23 14:07:43 +00:00
dt_entries.md Documentation: Add wake source info to device tree documentation 2022-12-13 18:50:54 +00:00
efi_capsule_generation.md Makefile.mk: generate EDK2 update capsule 2026-03-16 19:51:14 +00:00
index.md Makefile.mk: generate EDK2 update capsule 2026-03-16 19:51:14 +00:00
ipmi_bt.md drivers/ipmi: add Block Transfer (BT) interface 2025-10-16 12:16:43 +00:00
ipmi_kcs.md drivers/ipmi: prepare for adding more interfaces 2022-10-02 22:01:50 +00:00
retimer.md Documentation/drivers: ensure pages have only one top-level heading 2022-09-23 14:07:43 +00:00
smmstore.md Documentation/drivers/smmstore: Fix dead link 2025-01-10 08:41:19 +00:00
smmstorev2.md drivers/smmstore: Support 64-bit MMIO addresses 2025-05-08 22:28:16 +00:00
soundwire.md device/mipi: Move to drivers/mipi 2021-08-26 15:18:45 +00:00