September 2025 - Concept

[PATCH 0/5] api: Deprecate the API
by Simon Glass 05 Sep '25

05 Sep '25

From: Simon Glass <sjg(a)chromium.org> The existing U-Boot API is quite old and doesn't support driver model. Adding new functions is a manual process and no one has attempted this in the 10 years that driver model has been present. Undertaking such a task would be laborious and would require continued effort to maintain. A better approach would be to create a library containing all of U-Boot, then have the API be generated by a script from a list of functions. This would allow for a more flexible and maintainable interface. In preparation for this new direction, this series renames the existing API components to clearly mark them as legacy: - Rename api/ to legacy_api/ - Rename examples/api/ to examples/legacy_api/ - Rename include/api.h and include/api_public.h to include/legacy_api*.h - Rename API_BUILD to LEGACY_API_BUILD - Rename CONFIG_API to CONFIG_LEGACY_API - Rename api_init() to legacy_api_init() This provides a clean namespace for implementing the new library-based API approach while maintaining backward compatibility for existing users of the legacy interface. This series also sets a deadline for removal of the legacy API. Simon Glass (5): api: Rename legacy API files and examples api: Rename the api/ directory Kconfig: Rename API to LEGACY_API api: Rename api_init() to legacy_api_init() doc: api: Add a migration deadline Kconfig | 2 +- Makefile | 2 +- common/board_r.c | 6 ++--- doc/develop/driver-model/migration.rst | 12 ++++++++++ examples/Makefile | 2 +- examples/{api => legacy_api}/.gitignore | 0 examples/{api => legacy_api}/Makefile | 8 +++---- examples/{api => legacy_api}/crt0.S | 0 examples/{api => legacy_api}/demo.c | 2 +- examples/{api => legacy_api}/glue.c | 2 +- examples/{api => legacy_api}/glue.h | 0 examples/{api => legacy_api}/libgenwrap.c | 2 +- include/{api.h => legacy_api.h} | 10 +++++---- include/{api_public.h => legacy_api_public.h} | 6 ++--- include/net-common.h | 2 +- include/net-legacy.h | 2 +- {api => legacy_api}/Kconfig | 22 +++++++++++-------- {api => legacy_api}/Makefile | 0 {api => legacy_api}/README | 2 +- {api => legacy_api}/api.c | 4 ++-- {api => legacy_api}/api_display.c | 2 +- {api => legacy_api}/api_net.c | 2 +- {api => legacy_api}/api_platform-arm.c | 2 +- {api => legacy_api}/api_platform-mips.c | 2 +- {api => legacy_api}/api_platform-powerpc.c | 2 +- {api => legacy_api}/api_private.h | 2 +- {api => legacy_api}/api_storage.c | 2 +- lib/Makefile | 2 +- lib/vsprintf.c | 6 ++--- net/lwip/net-lwip.c | 4 ++-- net/net.c | 4 ++-- test/common/print.c | 2 +- test/lib/unicode.c | 2 +- 33 files changed, 69 insertions(+), 51 deletions(-) rename examples/{api => legacy_api}/.gitignore (100%) rename examples/{api => legacy_api}/Makefile (87%) rename examples/{api => legacy_api}/crt0.S (100%) rename examples/{api => legacy_api}/demo.c (99%) rename examples/{api => legacy_api}/glue.c (99%) rename examples/{api => legacy_api}/glue.h (100%) rename examples/{api => legacy_api}/libgenwrap.c (96%) rename include/{api.h => legacy_api.h} (63%) rename include/{api_public.h => legacy_api_public.h} (96%) rename {api => legacy_api}/Kconfig (62%) rename {api => legacy_api}/Makefile (100%) rename {api => legacy_api}/README (98%) rename {api => legacy_api}/api.c (99%) rename {api => legacy_api}/api_display.c (94%) rename {api => legacy_api}/api_net.c (98%) rename {api => legacy_api}/api_platform-arm.c (96%) rename {api => legacy_api}/api_platform-mips.c (95%) rename {api => legacy_api}/api_platform-powerpc.c (97%) rename {api => legacy_api}/api_private.h (97%) rename {api => legacy_api}/api_storage.c (99%) -- 2.43.0 base-commit: a417edcb4a4d6453eb97489dfc1707fbce45dd38 branch: ulic

1 5

[PATCH 00/18] ulib: Introduce building U-Boot as a shared library
by Simon Glass 04 Sep '25

04 Sep '25

From: Simon Glass <sjg(a)chromium.org> U-Boot is currently built as a monolithic binary. While there is an API of sorts, allowing U-Boot to be called from another program, it is not widely used. In some cases it is useful to write a separate program which is in control of the boot process, but uses U-Boot to implement some of the functionality. Some examples are: - Creating a main program written in a different language, such as Rust or Python - For Python specifically, an interface on top of U-Boot would permit direct execution of sandbox tests - For Rust specifically, it could make it feasible to progressively rewrite U-Boot in Rust, if that were desirable - For testing, it would permit tests to be in control of execution, rather than being embedded within U-Boot itself This series begins the progress of supporting U-Boot as a shared library. At this point the functionality is very limited: - it targets sandbox only - the test program simply starts U-Boot and boots to a prompt Future work will build on this meagre foundation. Simon Glass (18): doc: Add fuzzing build documentation board_r: Drop MMC init from the startup sequence sandbox: Avoid mon_len being larger than available RAM sandbox: Move PCI functions to separate header file sandbox: Move main.h contents into u-boot-sandbox header sandbox: Split main() into separate file sandbox: Extract init code into sandbox_init() ulib: Add an option to build U-Boot as a library ulib: Support building U-Boot as a shared library ulib: Create a test program for the shared library ulib: Add linker script for shared library build ulib: efi: Disable relocation or runtime-services ulib: Enable building the ulib test program ulib: Implement GD_FLG_ULIB for library-usage mode ulib: Drop the initial banner for the library ulib: Drop DRAM announcements for the library ulib: Allow dropping NAND init from the startup sequence ulib: Drop dm stats for the library Kconfig | 9 + Makefile | 31 ++- arch/sandbox/cpu/Makefile | 7 +- arch/sandbox/cpu/fuzz.c | 81 ++++++++ arch/sandbox/cpu/main.c | 11 ++ arch/sandbox/cpu/mem.c | 1 + arch/sandbox/cpu/os.c | 76 +------- arch/sandbox/cpu/start.c | 26 ++- arch/sandbox/cpu/u-boot-lib.lds | 88 +++++++++ arch/sandbox/include/asm/main.h | 18 -- arch/sandbox/include/asm/sandbox_pci.h | 61 ++++++ arch/sandbox/include/asm/u-boot-sandbox.h | 76 ++++---- common/board_f.c | 24 ++- common/board_r.c | 17 +- configs/tools-only_defconfig | 1 + doc/build/fuzz.rst | 219 ++++++++++++++++++++++ doc/build/index.rst | 1 + drivers/pci/pci-emul-uclass.c | 3 +- include/asm-generic/global_data.h | 12 ++ lib/display_options.c | 15 +- lib/efi_loader/efi_runtime.c | 4 + test/dm/pci.c | 1 + test/ulib/Makefile | 12 ++ test/ulib/ulib_test.c | 37 ++++ 24 files changed, 658 insertions(+), 173 deletions(-) create mode 100644 arch/sandbox/cpu/fuzz.c create mode 100644 arch/sandbox/cpu/main.c create mode 100644 arch/sandbox/cpu/u-boot-lib.lds delete mode 100644 arch/sandbox/include/asm/main.h create mode 100644 arch/sandbox/include/asm/sandbox_pci.h create mode 100644 doc/build/fuzz.rst create mode 100644 test/ulib/Makefile create mode 100644 test/ulib/ulib_test.c -- 2.43.0 base-commit: 9bdc48e838ab200854c37fdb770fdd2abdeacc83 branch: ulib

1 18

[PATCH 00/25] Selection of devicetree using CHIDs
by Simon Glass 03 Sep '25

03 Sep '25

From: Simon Glass <sjg(a)chromium.org> This series implements support for Microsoft's Computer Hardware Identifier (CHID) specification in U-Boot. CHIDs provide a standardised way to identify hardware configurations using SMBIOS data, enabling automatic selection of appropriate device tree overlays and drivers when the firmware itself lacks support for devicetree. The CHID system generates UUIDs from various combinations of hardware information (manufacturer, product name, BIOS version, etc.) creating a hierarchy from most to least specific. This allows U-Boot to automatically select the correct devicetree compatible-string for the hardware on which it running. This series includes: * Core CHID Infrastructure: - UUID v5 generation with Microsoft's CHID namespace - Support for all 15 CHID variants (HardwareID-00 through HardwareID-14) - SMBIOS data extraction and processing * Devicetree Integration: - hwids_to_dtsi.py script to convert CHID files to devicetree .dtsi - Automatic inclusion of the .dtsi into the board'' devicetree - Runtime compatible-string-selection based on hardware CHIDs * chid command: - chid show - show current hardware information and generated CHIDs - chid list - list all supported CHID variants and generated UUIDs - chid variants - show information about CHID variant restrictions - chid compat - select the compatible string for current hardware * ARM/EFI Support: - CHID mappings for a selection of ARM-based Windows devices - Support for Qualcomm Snapdragon platforms (MSM8998, SC7180, SC8180X, SC8280XP, SDM850, X1E series) * Testing: - Sandbox tests using mock SMBIOS data - CI integration for hwids_to_dtsi validation - Validation against Microsoft's ComputerHardwareIds.exe output Documentation is provided for this new subsystem and associated commands. Simon Glass (25): lib: Rename gen_v5_guid() to indicate it is little-endian uuid: Refactor v5 GUID generation into BE and LE variants smbios: Correct logic in smbios_get_header() smbios: Update smbios_get_header() to return a void * smbios: Expand the documentation smbios: Provide a sandbox test smbios: Improve comments for entry-point structures smbios: Add comments for smbios_type1 (System Information) smbios: Add docs for the main types test: Add more SMBIOS data to sandbox efi: arm: Provide CHIDs for the app efi: arm: Provide a mapping from CHIDs to compatible chid: Create a basic CHID header and smbios interface chid: Provide a command to access chid features uuid: Add a constant for the length of a UUID chid: Support calculating values for each variant chid: Add subcommand for dealing with variants chid: Provide some developer docs scripts: Add a tool to convert CHIDs to devicetree CI: Plumb in the hwids_to_dtsi tests sandbox: Provide hwid files for testing Makefile: Integrate CHID files into the build chid: Implement selection of the compatible string chid: doc: Describe how the CHID feature works cmd: chid: Add 'compat' subcommand to find compatible string .gitlab-ci.yml | 3 +- arch/sandbox/dts/test.dts | 24 + board/coreboot/coreboot/sysinfo.c | 31 +- .../efi/efi-arm_app/hwids/compatible.hwidmap | 45 + .../hwids/msm8998-lenovo-miix-630-81f1.txt | 33 + .../efi-arm_app/hwids/sc7180-acer-aspire1.txt | 32 + .../hwids/sc8180x-lenovo-flex-5g-81xe.txt | 32 + .../hwids/sc8180x-lenovo-flex-5g-82ak.txt | 33 + .../hwids/sc8280xp-huawei-gaokun3.txt | 38 + .../sc8280xp-lenovo-thinkpad-x13s-21bx.txt | 33 + .../sc8280xp-lenovo-thinkpad-x13s-21by.txt | 32 + .../hwids/sc8280xp-microsoft-blackrock.txt | 32 + .../sc8280xp-microsoft-surface-pro-9-5G.txt | 32 + .../hwids/sdm850-lenovo-yoga-c630.txt | 32 + .../efi/efi-arm_app/hwids/x1e001de-devkit.txt | 30 + .../x1e78100-lenovo-thinkpad-t14s-21n1.txt | 38 + .../x1e78100-lenovo-thinkpad-t14s-21n2.txt | 37 + .../hwids/x1e80100-asus-vivobook-s15.txt | 38 + .../hwids/x1e80100-asus-zenbook-a14.txt | 37 + board/efi/efi-arm_app/hwids/x1e80100-crd.txt | 34 + .../x1e80100-dell-inspiron-14-plus-7441.txt | 37 + .../hwids/x1e80100-dell-latitude-7455.txt | 33 + .../hwids/x1e80100-dell-xps13-9345.txt | 32 + .../hwids/x1e80100-hp-omnibook-x14.txt | 33 + .../hwids/x1e80100-lenovo-yoga-slim7x.txt | 32 + .../hwids/x1e80100-microsoft-denali.txt | 37 + .../hwids/x1e80100-microsoft-romulus13.txt | 37 + .../hwids/x1e80100-microsoft-romulus15.txt | 37 + .../hwids/x1p42100-asus-vivobook-s15.txt | 37 + .../hwids/x1p42100-asus-zenbook-a14.txt | 37 + .../hwids/x1p42100-hp-omnibook-x14.txt | 33 + .../hwids/x1p42100-lenovo-ideapad-5-2in1.txt | 37 + .../x1p42100-microsoft-surface-pro-12in.txt | 37 + .../hwids/x1p64100-acer-swift-sf14-11.txt | 37 + board/sandbox/hwids/compatible.hwidmap | 12 + board/sandbox/hwids/test-device-1.txt | 22 + board/sandbox/hwids/test-device-2.txt | 19 + cmd/Kconfig | 10 + cmd/Makefile | 1 + cmd/chid.c | 160 ++++ cmd/smbios.c | 4 +- doc/develop/chid.rst | 338 ++++++++ doc/develop/index.rst | 1 + doc/develop/smbios.rst | 65 ++ doc/usage/cmd/chid.rst | 114 +++ doc/usage/cmd/smbios.rst | 3 +- doc/usage/index.rst | 2 + doc/usage/smbios.rst | 180 ++++ include/chid.h | 230 +++++ include/smbios.h | 239 +++++- include/u-boot/uuid.h | 16 +- lib/Kconfig | 9 + lib/Makefile | 2 + lib/chid.c | 515 ++++++++++++ lib/efi_loader/efi_firmware.c | 8 +- lib/smbios-parser.c | 15 +- lib/uuid.c | 30 +- scripts/Makefile.lib | 21 + scripts/hwids_to_dtsi.py | 795 ++++++++++++++++++ test/cmd/Makefile | 2 + test/cmd/chid.c | 125 +++ test/cmd/smbios.c | 137 +++ test/lib/Makefile | 1 + test/lib/chid.c | 392 +++++++++ test/lib/uuid.c | 10 +- test/py/tests/test_smbios.py | 2 +- test/run | 1 + test/scripts/test_hwids_to_dtsi.py | 306 +++++++ tools/mkeficapsule.c | 7 +- 69 files changed, 4867 insertions(+), 69 deletions(-) create mode 100644 board/efi/efi-arm_app/hwids/compatible.hwidmap create mode 100644 board/efi/efi-arm_app/hwids/msm8998-lenovo-miix-630-81f1.txt create mode 100644 board/efi/efi-arm_app/hwids/sc7180-acer-aspire1.txt create mode 100644 board/efi/efi-arm_app/hwids/sc8180x-lenovo-flex-5g-81xe.txt create mode 100644 board/efi/efi-arm_app/hwids/sc8180x-lenovo-flex-5g-82ak.txt create mode 100644 board/efi/efi-arm_app/hwids/sc8280xp-huawei-gaokun3.txt create mode 100644 board/efi/efi-arm_app/hwids/sc8280xp-lenovo-thinkpad-x13s-21bx.txt create mode 100644 board/efi/efi-arm_app/hwids/sc8280xp-lenovo-thinkpad-x13s-21by.txt create mode 100644 board/efi/efi-arm_app/hwids/sc8280xp-microsoft-blackrock.txt create mode 100644 board/efi/efi-arm_app/hwids/sc8280xp-microsoft-surface-pro-9-5G.txt create mode 100644 board/efi/efi-arm_app/hwids/sdm850-lenovo-yoga-c630.txt create mode 100644 board/efi/efi-arm_app/hwids/x1e001de-devkit.txt create mode 100644 board/efi/efi-arm_app/hwids/x1e78100-lenovo-thinkpad-t14s-21n1.txt create mode 100644 board/efi/efi-arm_app/hwids/x1e78100-lenovo-thinkpad-t14s-21n2.txt create mode 100644 board/efi/efi-arm_app/hwids/x1e80100-asus-vivobook-s15.txt create mode 100644 board/efi/efi-arm_app/hwids/x1e80100-asus-zenbook-a14.txt create mode 100644 board/efi/efi-arm_app/hwids/x1e80100-crd.txt create mode 100644 board/efi/efi-arm_app/hwids/x1e80100-dell-inspiron-14-plus-7441.txt create mode 100644 board/efi/efi-arm_app/hwids/x1e80100-dell-latitude-7455.txt create mode 100644 board/efi/efi-arm_app/hwids/x1e80100-dell-xps13-9345.txt create mode 100644 board/efi/efi-arm_app/hwids/x1e80100-hp-omnibook-x14.txt create mode 100644 board/efi/efi-arm_app/hwids/x1e80100-lenovo-yoga-slim7x.txt create mode 100644 board/efi/efi-arm_app/hwids/x1e80100-microsoft-denali.txt create mode 100644 board/efi/efi-arm_app/hwids/x1e80100-microsoft-romulus13.txt create mode 100644 board/efi/efi-arm_app/hwids/x1e80100-microsoft-romulus15.txt create mode 100644 board/efi/efi-arm_app/hwids/x1p42100-asus-vivobook-s15.txt create mode 100644 board/efi/efi-arm_app/hwids/x1p42100-asus-zenbook-a14.txt create mode 100644 board/efi/efi-arm_app/hwids/x1p42100-hp-omnibook-x14.txt create mode 100644 board/efi/efi-arm_app/hwids/x1p42100-lenovo-ideapad-5-2in1.txt create mode 100644 board/efi/efi-arm_app/hwids/x1p42100-microsoft-surface-pro-12in.txt create mode 100644 board/efi/efi-arm_app/hwids/x1p64100-acer-swift-sf14-11.txt create mode 100644 board/sandbox/hwids/compatible.hwidmap create mode 100644 board/sandbox/hwids/test-device-1.txt create mode 100644 board/sandbox/hwids/test-device-2.txt create mode 100644 cmd/chid.c create mode 100644 doc/develop/chid.rst create mode 100644 doc/usage/cmd/chid.rst create mode 100644 doc/usage/smbios.rst create mode 100644 include/chid.h create mode 100644 lib/chid.c create mode 100755 scripts/hwids_to_dtsi.py create mode 100644 test/cmd/chid.c create mode 100644 test/cmd/smbios.c create mode 100644 test/lib/chid.c create mode 100644 test/scripts/test_hwids_to_dtsi.py -- 2.43.0 base-commit: f74db7258ca9d09a7bc658acced6531793a015d5 branch: apd

1 25

[PATCH 00/18] efi: Improve integration of the app with a Shim environment
by Simon Glass 02 Sep '25

02 Sep '25

From: Simon Glass <sjg(a)chromium.org> This series collects together various small fixes and improvements which make it easier to use the U-Boot EFI app in a bootflow which includes Shim: - 'Reset' back to the caller (e.g. EDK2) - Machine reset using cold and warm reset - Reset and enter the firmware UI - Shim command now supports persistent debug - Bootmenu shows the real media for each bootflow rather than just 'efi' Simon Glass (18): efi: Correct calculate_paths() when an image is used efi: doc: Mention some EFI commands in the app documentation efi: Allow inclusion of EFI-runtime headers efi: Set the log category throughout lib/efi_client/ efi_loader: Drop unnecessary efi_dp_str() efi: Move loaded-image, fs and device-path GUIDs to common boot: Move obtaining the label into a common file boot: Use the new label finder in bootflow_menu_add() boot: Drop an unwanted blank line in distro_efi_boot() efidebug: doc: Indent the media output correctly efidebug: Support sorting with efidebug memmap efi: doc: Add documentation for about efidebug boot efi: Use the console mux by default with the EFI app shim: Add a flag to make the setting persistent sysreset: Support a hot reset efi: app: Support proper reset options sysreset: Add SYSRESET_TO_FIRMWARE_UI with reset -u support sysreset: Add -c flag for explicit cold reset boot/bootflow.c | 27 +++++ boot/bootflow_menu.c | 7 +- boot/bootmeth_efi.c | 1 - cmd/boot.c | 2 + cmd/bootflow.c | 16 +-- cmd/efidebug.c | 58 +++++++++- cmd/shim.c | 21 +++- doc/develop/uefi/u-boot_on_efi.rst | 9 ++ doc/usage/cmd/efidebug.rst | 171 ++++++++++++++++++++++++++-- doc/usage/cmd/reset.rst | 12 +- doc/usage/cmd/shim.rst | 16 ++- drivers/sysreset/sysreset-uclass.c | 18 ++- drivers/sysreset/sysreset_sandbox.c | 2 + include/bootflow.h | 8 ++ include/efi.h | 11 ++ include/efi_loader.h | 6 - include/sysreset.h | 5 + lib/efi/run.c | 2 +- lib/efi_client/Kconfig | 1 + lib/efi_client/app_run.c | 2 + lib/efi_client/efi.c | 2 + lib/efi_client/efi_app.c | 43 ++++++- lib/efi_client/efi_info.c | 2 + lib/efi_client/efi_vars.c | 2 + lib/efi_client/sdram.c | 2 + lib/efi_client/stub.c | 2 + lib/efi_client/stub_arm64.c | 1 + lib/efi_client/stub_x86.c | 2 + lib/efi_client/sync_dt.c | 2 + test/boot/bootflow.c | 4 +- test/dm/sysreset.c | 4 + 31 files changed, 403 insertions(+), 58 deletions(-) -- 2.43.0 base-commit: 1dd869d9bacb5f9bf6d6075159226dc36c8c7cbb branch: apc

1 18