summaryrefslogtreecommitdiff
path: root/doc/board
AgeCommit message (Collapse)Author
2026-05-12Merge patch series "Switch Apple silicon boards to upstream device trees"Tom Rini
Janne Grunau <[email protected]> says: The Linux device trees for Apple silicon devices cover now most of the hardware as u-boot's internal device trees for M1 devices. Linux has in addition device trees M2 and M1 and M2 Pro/Max/Ultra devices which were never added in u-boot. The most common use case for u-boot on Apple silicon devices does not use DTBs from u-boot but passes runtime modified device trees from an earlier boot loader (m1n1). This change regresses support for the SPI on M1 and M1 Pro/Max notebooks as SPI keyboard support is not in upstream Linux. This regression is in my opinion acceptable due to the limited use of u-boot's DTBs for these targets. Link: https://lore.kernel.org/r/[email protected]
2026-05-12arm: dts: Switch Apple silicon devices to dts/upstreamJanne Grunau
The device tree on Apple silicon devices is passed from a previous bootloader stage. The bootloader fills in dynamic information so u-boot can not use its own device tree. As documented in doc/board/apple/m1.rst it is possible to build boot bundles (bootloader + device tree + gzipped u-boot binary). These are useful for testing. Instead of using u-boot's own device trees for M1 (t8103) devices use upstream device trees from dts/upstream/src/arm64/apple. The u-boot device trees have not seen updates since 2022. The upstream linux device trees have feature parity for the M1 devices. In addition linux has device trees for M1 Pro/Max/Ultra, M2 and M2 Pro/Max/Ultra devices. Keep t8103-j274 as default device tree to avoid further updates. Signed-off-by: Janne Grunau <[email protected]> Acked-by: Mark Kettenis <[email protected]>
2026-05-12doc: board: apple: Mention M2 and M2 Pro/Max/Ultra SoCsJanne Grunau
These SoCs are supported since 2022/2023 but were never added to the documentation. The devices very similar to the equivalent M1 devices. The biggest difference is that the M2 and M2 Pro/Max based laptops no longer use SPI for the keyboard. Signed-off-by: Janne Grunau <[email protected]> Acked-by: Mark Kettenis <[email protected]>
2026-05-01doc: board: ti: k3: Add fTPM support documentationShiva Tripathi
Add fTPM support documentation including an overview, configuration steps for RPMB provisioning, OP-TEE TA build instructions, and verification procedure. Signed-off-by: Shiva Tripathi <[email protected]>
2026-05-01doc: emulation: qemu-arm: add secure state stepsJohannes Krottmayer
Add build steps for building U-Boot in secure state with TF-A and OP-TEE. It includes the full steps for building OP-TEE and TF-A to use with U-Boot. Also a short description how to invoke QEMU with enabled EL3 and EL2. EL3 (machine option secure=on) is required to run TF-A. Signed-off-by: Johannes Krottmayer <[email protected]> Acked-by: Heinrich Schuchardt <[email protected]> Cc: Tom Rini <[email protected]> Cc: Tuomas Tynkkynen <[email protected]>
2026-04-21imx8mq: Correct signed_hdmi firmware positionPeng Fan
signed_hdmi_imx8m.bin is already signed and has a IVT header. It should not be put in u-boot-spl-mkimage.signed.bin. Move it to head of flash.bin following NXP imx-mkimage. Keeping it in u-boot-spl-mkimage.signed.bin also consumes a lot of TCM space which is not expected. While moving it to head of flash.bin, other changes are required, u-boot.itb is put at sector 768 per defconfig, so u-boot.itb binman offset should be updated and it should be moved out from binman section. Also binman symbol address are updated, so need to subtract u-boot-spl image_pos + CONFIG_SPL_TEXT_BASE to find the correct location of ddr phy firmware. Because there is 1KB padding in HDMI firmware, use 32KB when burning flash.bin to sd card. Signed-off-by: Peng Fan <[email protected]>
2026-04-21board: toradex: add Toradex Verdin iMX95Emanuele Ghidoli
Add support for the Toradex Verdin iMX95. Link: https://www.toradex.com/computer-on-modules/verdin-arm-family/nxp-imx95 Link: https://www.toradex.com/products/carrier-board/verdin-development-board-kit Signed-off-by: Emanuele Ghidoli <[email protected]> Co-developed-by: Ernest Van Hoecke <[email protected]> Signed-off-by: Ernest Van Hoecke <[email protected]> Co-developed-by: Francesco Dolcini <[email protected]> Signed-off-by: Francesco Dolcini <[email protected]> Reviewed-by: Simon Glass <[email protected]>
2026-04-21doc: tqma7: add documentationAlexander Feilke
Add readme for the tqma7 board. Reviewed-by: Peng Fan <[email protected]> Signed-off-by: Alexander Feilke <[email protected]>
2026-04-17doc: board: ti: j784s4_evm: Automate BAR address lookup for PCIe BootSiddharth Vadapalli
When the J784S4-EVM is configured for PCIe Boot, the Bootloaders are to be written to the address specified by particular BARs. The existing documentation hard-codes the address corresponding to the BAR under the assumption that the Root-Complex transferring the Bootloaders is also a J784S4-EVM. The Root-Complex assigns addresses to the BARs depending on the currently available set of free system addresses. Since the free system addresses vary with the Root-Complex being used, instead of hard-coding the BARs, automate the process of identifying the appropriate BAR in the form of a command to be run by the user on the Root-Complex. Signed-off-by: Siddharth Vadapalli <[email protected]>
2026-04-14Merge patch series "serial: goldfish: Add debug uart support"Tom Rini
This series from Daniel Palmer <[email protected]> improves debug UART support on QEMU on M68K by adding debug uart support to the serial driver. Link: https://lore.kernel.org/r/[email protected]
2026-04-14doc: board: virt: m68k: Detail how to use debug uartDaniel Palmer
Add a paragraph to explain how to get the address of the goldfish tty and use it as the debug uart. I think the address is actually fixed right now but it might change in the future. Signed-off-by: Daniel Palmer <[email protected]>
2026-04-06Merge branch 'next'Tom Rini
2026-04-02board: phytec: phycore-imx91-93: Add phyCORE-i.MX91 supportPrimoz Fiser
As the PHYTEC phyCORE-i.MX91 [1] is just another variant of the existing PHYTEC phyCORE-i.MX93 SoM but with i.MX91 SoC populated instead, add it to the existing board-code "phycore_imx93", and rename that board to "phycore_imx91_93" to reflect the dual SoCs support. While at it, also rename and change common files accordingly. This way i.MX91 and i.MX93 SoC variants of the phyCORE SoM share most of the code and documentation without duplication, while maintaining own device-tree and defconfigs for each CPU variant. Supported features: - 1GB LPDDR4 RAM - Debug UART - EEPROM - eMMC - Ethernet - SD-card - USB Product page SoM: [1] https://www.phytec.eu/en/produkte/system-on-modules/phycore-imx-91-93/ Signed-off-by: Primoz Fiser <[email protected]>
2026-03-27doc: board: ti: fix incorrect labels for boot switchesAnshul Dalal
The labels for the boot mode switches were incorreclty documented for some TI boards, this patch fixes them as per the official user guides linked below: AM62x https://www.ti.com/lit/ug/spruj40e/spruj40e.pdf AM62dx https://www.ti.com/lit/ug/sprujg2/sprujg2.pdf AM62ax https://www.ti.com/lit/ug/spruj66b/spruj66b.pdf AM62px https://www.ti.com/lit/ug/spruj40e/spruj40e.pdf AM6254atl https://www.ti.com/lit/ug/spruja1a/spruja1a.pdf Signed-off-by: Anshul Dalal <[email protected]>
2026-03-27doc: board: fix OPTEE args for TI SoCsAnshul Dalal
CFG_WITH_SOFTWARE_PRNG=y was added as an OPTEE argument to workaround some bugs related to TRNG which have been fixed now[1]. Therefore this patch drops the redundant argument from the documentation. [1]: https://github.com/OP-TEE/optee_os/commit/e313f4765fd0478bb66985827441411793433773 Signed-off-by: Anshul Dalal <[email protected]> Acked-by: Francesco Dolcini <[email protected]> # Toradex Verdin AM62
2026-03-27treewide: fix uImage.FIT document pathsDaniel Golle
Commit 488445cefa1 ("doc: Move FIT into its own directory") moved the documentation in doc/uImage.FIT to doc/usage/fit, subsequently all documents and example sources have been converted to reStructuredText. Fix (almost) all of the remaining occurrences of the old path and filenames across the tree. The exception is doc/uImage.FIT/command_syntax_extensions.txt which apparently has been removed entirely, or at least I was unable to locate where that document is now. Signed-off-by: Daniel Golle <[email protected]>
2026-03-20doc: board: tegra: improve documentationSvyatoslav Ryhel
Remove redundant chapters, clarify and reword confusing sections. Signed-off-by: Svyatoslav Ryhel <[email protected]>
2026-03-18Merge tag 'u-boot-imx-next-20260318' of ↵Tom Rini
https://gitlab.denx.de/u-boot/custodians/u-boot-imx into next CI: https://source.denx.de/u-boot/custodians/u-boot-imx/-/pipelines/29557 - Add support for i.MX952. - Add support for XPI1 on imx943_evk.
2026-03-16doc: imx95_evk: Fix the binary nameFabio Estevam
U-Boot produces flash.bin as the final boot image when building for the i.MX95 EVK, but the documentation refers to imx-boot-imx95.bin. Update the instructions to use flash.bin when copying the image to the SD card. Signed-off-by: Fabio Estevam <[email protected]>
2026-03-16doc: imx95_evk: Update Arm GNU toolchain version to 14.2Fabio Estevam
The imx-oei and imx-sm build systems defaults to: TC_VERSION ?= 14.2.rel1 but the documentation still instructs users to download the 13.3 toolchain. This causes the build to fail because the expected directory name does not exist. Update the documentation to reference the 14.2 toolchain to match the build system default. Signed-off-by: Fabio Estevam <[email protected]> Acked-by: Peng Fan <[email protected]>
2026-03-16board: nxp: imx952_evk: Add i.MX952 15x15 lpddr4x board supportPeng Fan
Add support for i.MX952 15x15 lpddr4x board support. Signed-off-by: Peng Fan <[email protected]> Signed-off-by: Ye Li <[email protected]> Signed-off-by: Alice Guo <[email protected]>
2026-03-17doc: board: starfive: jh7110 common update OPENSBI build env referenceE Shattow
Describe build with OpenSBI fw_dynamic.bin path as OPENSBI=<path> on the same line instead of as an export. Also remedy a typo which had the wrong directory path before the filename. Fixes: 8304f3226700 ("doc: board: starfive: update jh7110 common description") Signed-off-by: E Shattow <[email protected]> Reviewed-by: Leo Yu-Chi Liang <[email protected]>
2026-03-17doc: board: starfive: jh7110 common give build output dir by env not argE Shattow
Describe build with output directory as O=<dir> environment variable and not unrelated -O <output sync> command line argument. Fixes: 8304f3226700 ("doc: board: starfive: update jh7110 common description") Signed-off-by: E Shattow <[email protected]> Reviewed-by: Leo Yu-Chi Liang <[email protected]>
2026-03-17doc: board: starfive: Add Xunlong OrangePi RVE Shattow
OrangePi RV is a board that uses the same EEPROM product serial identifier as the StarFive VisionFive 2 1.3b. In fact it is not completely compatible with the StarFive VisionFive 2 1.3b for use with Linux Kernel however it is good enough for use with U-Boot SPL and U-Boot Main. Describe how to set the devicetree search path and, for advanced users, suggest that it is possible to update the EEPROM data with an invented "XOPIRV" identifier for automatic board detection. Signed-off-by: E Shattow <[email protected]> Reviewed-by: Leo Yu-Chi Liang <[email protected]>
2026-03-16Merge patch series "Add PCIe Boot support for TI J784S4 SoC"Tom Rini
Siddharth Vadapalli <[email protected]> says: This series adds PCIe endpoint boot support for the TI J784S4 SoC. Series is based on commit f9ffeec4bdc ("board: toradex: Make A53 get RAM size from DT in K3 boards") of the master branch of U-Boot. PCIe Boot Logs (J784S4-EVM running Linux as Root-Complex transfers bootloaders to another J784S4-EVM configured for PCIe Boot): https://gist.github.com/Siddharth-Vadapalli-at-TI/2d157003818441fe79a139d0dec1058a Link: https://lore.kernel.org/r/[email protected]
2026-03-16docs: board: ti: j784s4_evm: Add PCIe boot documentationHrushikesh Salunke
Add PCIe boot documentation for J784S4-EVM including boot mode switch settings, hardware setup requirements, endpoint configuration details and step-by-step boot procedure. Signed-off-by: Hrushikesh Salunke <[email protected]> [[email protected]: simplified and documented the pcie_boot_util program] Co-developed-by: Siddharth Vadapalli <[email protected]> Signed-off-by: Siddharth Vadapalli <[email protected]> Reviewed-by: Udit Kumar <[email protected]>
2026-03-13Merge patch series "k3_*: Add config fragments for inline ECC and BIST"Tom Rini
Neha Malcom Francis <[email protected]> says: Typically we do not enable these configs by default but would still like to have the option to start building them in our default build flow for testing. Also there is the added advantage of users being able to see what is needed in case they choose to enable these features. Link: https://lore.kernel.org/r/[email protected]
2026-03-13doc: board: ti: Add support for config fragment buildsNeha Malcom Francis
Add sections dedicated to explaining how BIST and inline ECC can be enabled via the config fragments. Signed-off-by: Neha Malcom Francis <[email protected]>
2026-03-10Merge tag 'u-boot-rockchip-20260309' of ↵Tom Rini
https://source.denx.de/u-boot/custodians/u-boot-rockchip into next CI: https://source.denx.de/u-boot/custodians/u-boot-rockchip/-/pipelines/29452 - New SoC support: RK3506, RK3582; - New Board support: RK3528 FriendlyElec NanoPi Zero2; - Other fixes
2026-03-10rockchip: Switch remaining rk3288 boards to upstream devicetreeJohan Jonker
Switch remaining rk3288 boards to upstream devicetree. Signed-off-by: Johan Jonker <[email protected]> Reviewed-by: Kever Yang <[email protected]>
2026-03-10board: rockchip: Add FriendlyElec NanoPi Zero2Jonas Karlman
The NanoPi Zero2 is a small single board computer developed by FriendlyElec, based on the Rockchip RK3528A SoC. Add support for the FriendlyElec NanoPi Zero2 board. Features tested on a FriendlyElec NanoPi Zero2 2407: - SD-card boot - eMMC boot - Ethernet - USB host Signed-off-by: Jonas Karlman <[email protected]> Reviewed-by: Christopher Obbard <[email protected]> Reviewed-by: Quentin Schulz <[email protected]> Reviewed-by: Kever Yang <[email protected]>
2026-03-10rockchip: rk3588s-rock-5c: Add support for ROCK 5C Lite variantJonas Karlman
Add Kconfig option OF_SYSTEM_SETUP=y to support booting ROCK 5C Lite boards with a RK3582 SoC. CPU and GPU cores are failed based on ip-state and policy. Tested on a ROCK 5C Lite v1.1: cpu-code: 35 82 ip-state: 00 80 00 (otp) ip-state: c0 9e 04 (policy) remove cpu-map cluster2 fail gpu fail rkvdec1 fail rkvenc1 fail cpu cpu@600 fail cpu cpu@700 Signed-off-by: Jonas Karlman <[email protected]> Reviewed-by: Quentin Schulz <[email protected]> Reviewed-by: Kever Yang <[email protected]>
2026-03-09Merge tag 'v2026.04-rc4' into nextTom Rini
Prepare v2026.04-rc4
2026-03-09rockchip: rk3588-generic: Enable support for RK3582Jonas Karlman
Add Kconfig option OF_SYSTEM_SETUP=y to support booting boards with a RK3582 SoC. CPU and GPU cores are failed based on ip-state and policy. Tested on a ROCK 5C Lite v1.1: cpu-code: 35 82 ip-state: 10 00 00 (otp) ip-state: 30 9e 04 (policy) remove cpu-map cluster1 rename cpu-map cluster2 fail gpu fail rkvdec1 fail rkvenc1 fail cpu cpu@400 fail cpu cpu@500 and on a Radxa E52C: cpu-code: 35 82 ip-state: 00 04 00 (otp) ip-state: c0 9e 04 (policy) remove cpu-map cluster2 fail gpu fail rkvdec1 fail rkvenc1 fail cpu cpu@600 fail cpu cpu@700 Signed-off-by: Jonas Karlman <[email protected]> Reviewed-by: Quentin Schulz <[email protected]> Reviewed-by: Kever Yang <[email protected]>
2026-02-25Merge branch 'master' of https://source.denx.de/u-boot/custodians/u-boot-samsungTom Rini
- Assorted platform and video driver updates
2026-02-23doc: board: samsung: exynos-mobile: remove requirement of stub device treeKaustabh Chakraborty
Flashing U-Boot for Exynos 7870 requires creating a stub device tree, where certain properties and nodes are defined which are populated by the previous bootloader in the phones. Since these properties are now available in the U-Boot device tree, it's now possible to use the same blob generated by U-Boot in place of the stub, when creating boot images. Update the build documentation to reflect the same. Signed-off-by: Kaustabh Chakraborty <[email protected]> Signed-off-by: Minkyu Kang <[email protected]>
2026-02-23doc: board: samsung: exynos-mobile: use u-boot-nodtb.bin for packaging processKaustabh Chakraborty
U-Boot for this board is programmed to use the external DTB if an internal device tree is not available. This makes it safe to build boot images using the non-DTB U-Boot binary, while taking up less space. Reflect this change in documentation. Signed-off-by: Kaustabh Chakraborty <[email protected]> Signed-off-by: Minkyu Kang <[email protected]>
2026-02-23doc: board: samsung: exynos-mobile: add DEVICE_TREE make flag in buildKaustabh Chakraborty
Since there is only one internal device tree allowed in U-Boot, the DEVICE_TREE flag is required for building images for various devices. Document it in the build guide. Signed-off-by: Kaustabh Chakraborty <[email protected]> Signed-off-by: Minkyu Kang <[email protected]>
2026-02-10Merge patch series "am335x: failsafe bootloader update"Tom Rini
Rasmus Villemoes <[email protected]> says: Make it possible to update the (whole) bootloader on am335x robustly, i.e. so that a power failure or random OOM killing of the update process or other interruptions do not result in a bricked board. The order the trial bits gets set is somewhat odd, but is clearly what happens, and somebody else trying to reverse engineer the ROM code has observed the same thing: See the TracingVectors.ods in https://github.com/sjgallagher2/am335xbootrom . Link: https://lore.kernel.org/r/[email protected]
2026-02-10doc: am335x: document use of CONFIG_SPL_AM33XX_MMCSD_MULTIPLERasmus Villemoes
Document how one can use the CONFIG_SPL_AM33XX_MMCSD_MULTIPLE option to implement a scheme for failsafe updating of the whole bootloader on the am335x. Signed-off-by: Rasmus Villemoes <[email protected]>
2026-02-06imx95_evk: Enable remoteproc for i.MX95 EVKPeng Fan
Select remoteproc related configs for i.MX95 EVK to support manage CM7 using 'rproc' cmd. Update doc to show details on starting CM7 using rproc cmd. Signed-off-by: Peng Fan <[email protected]>
2026-02-02Merge patch series "m68k: Add support for QEMU virt machine"Tom Rini
Kuan-Wei Chiu <[email protected]> says: Add support for the QEMU 'virt' machine on the m68k architecture. The QEMU virt machine models a generic system utilizing Goldfish virtual peripherals and is capable of emulating various classic 68k CPUs. Currently, U-Boot's m68k architecture support focuses on ColdFire variants. This series expands support to include the classic M680x0 architecture, implementing the necessary exception vectors, startup code, and a bootinfo parser compatible with the QEMU interface. Drivers for Goldfish peripherals (TTY, Timer, RTC) and the QEMU Virtual System Controller (sysreset) are also added to enable serial console, timekeeping, and system reset functionality. The implementation has been verified on QEMU targeting the M68040 CPU, confirming successful hardware initialization and boot to the U-Boot command shell. Additionally, the CI configuration was verified locally using gitlab-ci-local "qemu_m68k_virt test.py", resulting in PASS qemu_m68k_virt test.py. Link: https://lore.kernel.org/r/[email protected] [trini: Re-sort MAINTAINERS entries] Signed-off-by: Tom Rini <[email protected]>
2026-02-02board: Add QEMU m68k virt board supportKuan-Wei Chiu
Add support for the QEMU 'virt' machine on the m68k architecture. This board emulates a generic machine based on the Motorola 68040 CPU equipped with Goldfish virtual peripherals. Introduce the necessary board configuration and initialization infrastructure. The implementation includes logic to parse the QEMU bootinfo interface, enabling dynamic detection of system RAM size to adapt to the virtual machine's configuration. Enable the Goldfish TTY driver for serial console output. Additionally, enable Goldfish RTC and timer drivers to support real-time clock functionality and nanosecond-resolution delays. Include comprehensive documentation covering build instructions and usage examples. Signed-off-by: Kuan-Wei Chiu <[email protected]> Tested-by: Daniel Palmer <[email protected]> Reviewed-by: Simon Glass <[email protected]>
2026-02-02Merge patch series "arm: mach-k3: j721s2: Provide a way to obtain boot ↵Tom Rini
device for non SPLs" This series from Dominik Haller <[email protected]> provides a way for TI K3 platforms to determine their boot device outside of SPL and then adds support for the PHYTEC phyCORE-AM68x/TDA4x SoM. Link: https://lore.kernel.org/r/[email protected]
2026-02-02doc: board: phytec: Add phyCORE-AM68x/TDA4xDominik Haller
Add documentation for the PHYTEC phyCORE-AM68x/TDA4x (J721S2 family) SoM. Signed-off-by: Dominik Haller <[email protected]> Reviewed-by: Wadim Egorov <[email protected]>
2026-01-28doc: describe QEMU VGA emulationHeinrich Schuchardt
Describe how the QEMU defconfigs can be used with an emulated GPU. Reviewed-by: Simon Glass <[email protected]> Signed-off-by: Heinrich Schuchardt <[email protected]>
2026-01-20doc: board: starfive: update jh7110 common descriptionE Shattow
Updates to the JH7110 common description: - add detailed overview of JH-7110 SoC and boot process - revise descriptions of deprecated StarFive loader modes - refresh build directions grouped with SPL debug advice - reduce usage instructions into common methods shared by supported boards - cite starfive_visionfive2 board maintainer description of StarFive loader - cite published datasheets for ambient operating temperature data Redundant/deprecated sections of each board doc are dropped accordingly: - deepcomputing fml13v01 - milk-v mars - pine64 star64 (also add inclusion of JH7110 common description) - visionfive2 Signed-off-by: E Shattow <[email protected]>
2026-01-19doc: board: ti: Add AM62D documentationParesh Bhagat
Add info of boot flow and build steps for AM62Dx EVM. Signed-off-by: Paresh Bhagat <[email protected]>
2026-01-19Update links to doc/develop/falcon.rstJ. Neuschäfer
README.falcon was converted to ReST/HTML in 2023. Signed-off-by: J. Neuschäfer <[email protected]> Reviewed-by: Mattijs Korpershoek <[email protected]> Reviewed-by: Heinrich Schuchardt <[email protected]>
2026-01-19doc: describe QEMU networkingHeinrich Schuchardt
Add a chapter about networking to the QEMU board documentation. Describe both different types of networking as well as different emulated NICs. Suggested-by: Manjae Cho <[email protected]> Signed-off-by: Heinrich Schuchardt <[email protected]>