summaryrefslogtreecommitdiff
path: root/doc
AgeCommit message (Collapse)Author
2025-12-14rockchip: rock5b-rk3588: Add support for ROCK 5B+Jonas Karlman
Include FDTs for both ROCK 5B and 5B+ in the FIT and add board selection code to load the 5B+ FDT when the DRAM type is LPDDR5 and ADC channel 5 value is close to 4095. U-Boot 2025.07 (Jul 14 2025 - 21:28:20 +0000) Model: Radxa ROCK 5B+ SoC: RK3588 DRAM: 8 GiB Features tested on a ROCK 5B+ v1.2: - SD-card boot - eMMC boot - SPI flash boot - PCIe/NVMe - Ethernet - USB/TCPM Signed-off-by: Jonas Karlman <[email protected]> Reviewed-by: Kever Yang <[email protected]>
2025-12-14board: theobroma-systems: jaguar_rk3588: explicit UART IOMUXQuentin Schulz
When one attempts to build Tiger and Jaguar from the same directory, because Tiger will set the IOMUX to 2 but Jaguar doesn't reset it, Jaguar will have IOMUX set to 2 if built after Tiger. This isn't an issue if in separate directories or building Tiger after Jaguar because the default if missing from the configuration file is 0. Let's make it explicit that the iomux is 0 for Jaguar. Signed-off-by: Quentin Schulz <[email protected]> Reviewed-by: Kever Yang <[email protected]>
2025-12-14board: theobroma-systems: add instructions for how to use upstream TF-AQuentin Schulz
Upstream TF-A has support for RK3588 since v2.12 so let's document how to use upstream TF-A instead of the prebuilt binary blob from Rockchip if one wants to do that. Signed-off-by: Quentin Schulz <[email protected]> Reviewed-by: Kever Yang <[email protected]>
2025-12-14board: theobroma-systems: update instructions for newer Rockchip rkbinQuentin Schulz
The instructions are regularly out of date because the generated or prebuilt binaries are updated and the filename doesn't match our instructions anymore. Additionally, since commit 55a95caaef15 ("tools: ddrbin_tool: add ddrbin_tool.py and update to v1.21 20241211") end of October 2024, ddrbin_tool doesn't exist anymore and has been replaced by ddrbin_tool.py python script (which currently isn't an executable) so let's update these instructions as well. Signed-off-by: Quentin Schulz <[email protected]> Reviewed-by: Kever Yang <[email protected]>
2025-12-12doc: board: ti: k3: Fix a couple small typosAndrew Davis
s/Uenv.txt/uEnv.txt s/then/than Signed-off-by: Andrew Davis <[email protected]> Reviewed-by: Bryan Brattlof <[email protected]>
2025-12-12doc: board: ti: Add J742S2 supportUdit Kumar
J742S2 SOC is derivative of J784S4, most of build infra of j784s4 is used to build u-boot for J742S2 EVM board. Add guide users on how to build for that board. Signed-off-by: Udit Kumar <[email protected]> Reviewed-by: Mattijs Korpershoek <[email protected]>
2025-12-11doc: board: amlogic: add u-boot-spl documentationFerass El Hafidi
Add building and usage instructions for SPL. Reviewed-by: Neil Armstrong <[email protected]> Signed-off-by: Ferass El Hafidi <[email protected]> Link: https://patch.msgid.link/[email protected] Signed-off-by: Neil Armstrong <[email protected]>
2025-12-08Merge tag 'v2026.01-rc4' into nextTom Rini
Prepare v2026.01-rc4
2025-12-08Prepare v2026.01-rc4v2026.01-rc4Tom Rini
Signed-off-by: Tom Rini <[email protected]>
2025-12-08doc: Update urllib3 version for buildingTom Rini
The GitHub dependabot tool has reported two "high" priority bugs, CVE-2025-66418 and CVE-2025-66471, with this package. Update to the patched version. Reported-by: GitHub dependabot Acked-by: Heinrich Schuchardt <[email protected]> Signed-off-by: Tom Rini <[email protected]>
2025-12-06Merge patch series "test/py: fit: Deduplicate the test"Tom Rini
This series from Marek Vasut <[email protected]> cleans up some of the FIT pytests we have and then extends mkimage to support including the TEE in FIT images when using "-f auto" to create the resulting FIT. Link: https://lore.kernel.org/r/[email protected]
2025-12-06mkimage: Add support for bundling TEE in mkimage -f autoMarek Vasut
Introduce two new parameters to be used with mkimage -f auto to bundle TEE image into fitImage, using auto-generated fitImage. Add -z to specify TEE file name and -Z to specify TEE load and entry point address. This is meant to be used with systems which boot all of TEE, Linux and its DT from a single fitImage, all booted by U-Boot. Example invocation: " $ mkimage -E -A arm -C none -e 0xc0008000 -a 0xc0008000 -f auto \ -d arch/arm/boot/zImage \ -b arch/arm/boot/dts/st/stm32mp135f-dhcor-dhsbc.dtb \ -z ../optee_os/out/arm-plat-stm32mp1/core/tee-raw.bin \ -Z 0xde000000 \ /path/to/output/fitImage " Documentation update and test are also included, the test validates both positive and negative test cases, where fitImage does not include TEE and does include TEE blobs. Acked-by: Quentin Schulz <[email protected]> Signed-off-by: Marek Vasut <[email protected]>
2025-12-06doc: board: verdin-am62p: Fix boot log outputFrancesco Dolcini
Fix boot log output not being rendered correctly, fix it doing the same as done in verdin-am62.rst. Fixes: b8c43968b801 ("board: toradex: add verdin am62p support") Signed-off-by: Francesco Dolcini <[email protected]>
2025-12-06doc: pytest: add missing hook script env varsDavid Lechner
Add the _EXTRA variants of U_BOOT_BUILD_DIR and U_BOOT_RESULT_DIR to the list of environment variables set for hook scripts. These were added in commit 8f2a9fa7d6e7 ("test: Support testing with two board-builds") but were not documented. Signed-off-by: David Lechner <[email protected]>
2025-12-06doc: pytest: fix hook script environment variable namesDavid Lechner
Fix the names of environment variables set for hook scripts. These have a U_BOOT_ prefix, not UBOOT_. Signed-off-by: David Lechner <[email protected]>
2025-12-06doc: add a page for downloading the U-Boot logoHeinrich Schuchardt
Add a page showing the logo with and without text. Signed-off-by: Heinrich Schuchardt <[email protected]>
2025-12-05led: remove support for red LED in legacy APIQuentin Schulz
To the exception of red_led_on in the arm-specific assembly code, all code interacting with the red status LED was guarded by the CONFIG_LED_STATUS_RED symbol, which is enabled in none of the upstream defconfigs. Since the last board which overrode the weak red_led_on function got migrated to the new LED mechanism, there's also no user of the arm-specific assembly code anymore, therefore it can be removed along the other unreachable code sections. Signed-off-by: Quentin Schulz <[email protected]> Reviewed-by: Heiko Schocher <[email protected]>
2025-12-05led: remove support for green status led in legacy APIQuentin Schulz
The last user of it was removed in a previous commit so let's remove its support entirely. Signed-off-by: Quentin Schulz <[email protected]> Reviewed-by: Heiko Schocher <[email protected]>
2025-12-05arm: omap3: remove leftover from CM_T35 support removalQuentin Schulz
Commit 76386d6195a1 ("arm: Remove cm_t35 board") removed support for the board that was built when TARGET_CM_T35 is selected, but removal of the symbol was forgotten, so let's fix this oversight. While at it, update the README for omap3 to remove the last mention of cm_t35. Fixes: 76386d6195a1 ("arm: Remove cm_t35 board") Signed-off-by: Quentin Schulz <[email protected]> Reviewed-by: Tom Rini <[email protected]>
2025-12-05led: remove coloured_LED_init, yellow and blue status LEDs in legacy APIQuentin Schulz
The last user of coloured_LED_init has been recently removed, so we can remove all places it's called and defined as it does nothing now. Nobody makes use of the yellow and blue status LEDs from the legacy API, so let's remove all references to it. Signed-off-by: Quentin Schulz <[email protected]>
2025-12-03Merge patch series "led: remove u-boot,boot-led and u-boot,error-led + add ↵Tom Rini
cmd doc" Quentin Schulz <[email protected]> says: u-boot,boot-led and u-boot,error-led aren't actually handled by some generic code but rather by board or architecture specific code. They also aren't properties that are part of the official dt-binding so they cannot be upstreamed. For u-boot,boot-led, there's actually a proper replacement which is /options/u-boot/boot-led[1] (+ CONFIG_LED_BOOT=y). For Rockchip boards, either nothing (for RK3066, PX30 and RK3399) was using that property or (for RK3188) the code handling it was guarded by symbols that were not enabled in the defconfig. For those, the property and guarded code are removed. For the Sam9x60 Curiosity, it seems that even though the LED is controlled whenever CONFIG_LED is enabled, it isn't enabled by default in the defconfig (but the code was added without modifying the defconfig, explicitly leaving a choice to the user). I decided to keep that feature by simply migrating it to the new API, though I cannot test it as I do not own the device. The STM32 boards will be migrated in the near future once their upstream (kernel) Device Trees gain the new way to specify this (via /options/u-boot/boot-led). I'll let Patrice handle this, see https://lore.kernel.org/u-boot/[email protected]/ and https://lore.kernel.org/u-boot/[email protected]/ After this, only one user of u-boot,boot-led will be left, based on STM32: board/dhelectronics/dh_stm32mp1/board.c. @Patrice, maybe that's something you want to have a look at as well, this seems to be some evaluation kit? The only users of u-boot,error-led are STM32 boards, so I'll leave this to Patrice as well, I do not know what's the way to go for that one. In any case, I would like to not encourage people to use out-of-spec DT properties when there is another option (u-boot,boot-led), so I remove the properties from the dt-binding document from U-Boot. The help text for the blink subcommand of the led command was misleading so this is now fixed. This also moves the content of doc/README.LED into the doc/api/led.rst, while clearly stating one shouldn't be using this anymore. This also gets rid of dt-binding that we already have in dts/upstream. Finally, this adds documentation for the led shell command. [1] https://github.com/devicetree-org/dt-schema/blob/v2025.08/dtschema/schemas/options/u-boot.yaml#L113-L116 Link: https://lore.kernel.org/r/[email protected]
2025-12-03doc: remove u-boot,boot-led and u-boot,error-led from "binding"Quentin Schulz
We're aiming to reduce the amount of U-Boot-specific and out-of-spec Device Tree additions. Those two properties haven't been doing anything for a long time already, except when read by board files manually. This is still the case for STM32 boards but those will be migrated in the near future according to their maintainer. In any case, let's not encourage people to add either of these properties to new or existing Device Trees and remove it from the bindings. Signed-off-by: Quentin Schulz <[email protected]>
2025-12-03doc: dt-bindings: remove duplicates with dts/upstreamQuentin Schulz
doc/device-tree-bindings/leds/leds-bcm6328.txt can be found at dts/upstream/Bindings/leds/leds-bcm6328.yaml. doc/device-tree-bindings/leds/leds-bcm6358.txt can be found at dts/upstream/Bindings/leds/leds-bcm6358.txt. doc/device-tree-bindings/leds/leds-gpio.txt can be found at dts/upstream/Bindings/leds/leds-gpio.yaml. doc/device-tree-bindings/leds/leds-lp5562.txt can be found at dts/upstream/Bindings/leds/leds-lp55xx.yaml. Only two LED dt-bindings are left in U-Boot: leds-bcm6858.txt and leds-pwm.txt. The former is partially supported by dts/upstream/Bindings/leds/leds-bcm63138.yaml but is lacking all optional properties we have listed in "downstream" dt-binding in U-Boot. However, there doesn't seem to exist any user of that compatible. The latter is partially supported by dts/upstream/Bindings/leds/leds-pwm.yaml but is missing the u-boot,default-brightness property, which is used by arch/arm/dts/rk3326-odroid-go2-u-boot.dtsi at the moment. The default-brightness property is probably not what we want here as it defaults to max-brightness if missing. I'm assuming we want a different value for U-Boot (127) and the kernel (255 via max-brightness as a default), which would prevent us from upstreaming this property, which doesn't change the status quo, so let it be for now. Signed-off-by: Quentin Schulz <[email protected]>
2025-12-03doc: cmd: document the led shell commandQuentin Schulz
This adds documentation on how to use the led shell command. Signed-off-by: Quentin Schulz <[email protected]>
2025-12-03doc: move legacy API documented in README.LED to doc/api/led.rstQuentin Schulz
This moves the content of the legacy LED API from doc/READ.LED to doc/api/led.rst, applying minimal cosmetic changes to "nicely" integrate it with the current docs and adding a small introduction to the legacy API section. Signed-off-by: Quentin Schulz <[email protected]>
2025-12-02Merge branch 'master' of https://source.denx.de/u-boot/custodians/u-boot-samsungTom Rini
- Assorted updates
2025-12-02doc: samsung: exynos-mobile: add documentation for exynos7870Kaustabh Chakraborty
Document the image preparation and flashing techniques for Exynos7870-based boards. This is done in a separate file in a sub-directory, which is linked back to the main documentation. Signed-off-by: Kaustabh Chakraborty <[email protected]> Signed-off-by: Minkyu Kang <[email protected]>
2025-12-02board: samsung: add support for Samsung Exynos mobile device boardsKaustabh Chakraborty
Add support for a generic platform which intends to support multiple boards powered by ARMv8 Samsung Exynos SoCs. Some important features include: * Fastboot: This is present to provide an open alternative to Samsung's proprietary Odin protocol. The board file configures certain features for fastboot, such as a dynamically allocated fastboot buffer, and standardized (lowercase) partition aliases. * EFI: Kernel image can be loaded from an EFI partition. This adopts a standard booting process, which multiple OS distributions can rely on. Signed-off-by: Kaustabh Chakraborty <[email protected]> Signed-off-by: Minkyu Kang <[email protected]>
2025-11-29imx: Add support for Kontron i.MX93 OSM-S SoM and BL carrier boardFrieder Schrempf
This adds support for the Kontron Electronics OSM-S i.MX93 SoM and the matching baseboard BL i.MX93. The SoM hardware complies to the Open Standard Module (OSM) 1.1 specification, size S (https://sget.org/standards/osm). Signed-off-by: Frieder Schrempf <[email protected]>
2025-11-29imx: Add support for Kontron i.MX8MP OSM-S SoM and BL carrier boardFrieder Schrempf
This adds support for the Kontron Electronics OSM-S i.MX8MP SoM and the matching baseboard BL i.MX8MP. The SoM hardware complies to the Open Standard Module (OSM) 1.1 specification, size S (https://sget.org/standards/osm). Signed-off-by: Frieder Schrempf <[email protected]>
2025-11-29bsh: add support for imx6ulz_smm_m2dAndrea Calabrese
Add support for imx6ulz_smm_m2d, based on the M2 architecture. Signed-off-by: Andrea Calabrese <[email protected]>
2025-11-24Merge tag 'v2026.01-rc3' into nextTom Rini
Prepare v2026.01-rc3
2025-11-24Prepare v2026.01-rc3v2026.01-rc3Tom Rini
Signed-off-by: Tom Rini <[email protected]>
2025-11-21doc: pytest: fix u-boot-test-flash typoDavid Lechner
Fix typo: `s/u-boot-test-flash1/u-boot-test-flash/`. The correct name of the script doesn't have a "1" in it. Signed-off-by: David Lechner <[email protected]> Reviewed-by: Heinrich Schuchardt <[email protected]>
2025-11-21doc: samsung: Fix PXE doc for E850-96 boardSam Protsenko
As stated in PXELINUX doc [1], the PXE configuration file has to be in the format of "01-MAC-address" for Ethernet connections: The hardware type (using its ARP "htype" code) and address, all in lowercase hexadecimal with dash separators. For example, for an Ethernet (i.e. ARP hardware type "1") with address "88:99:AA:BB:CC:DD", it would search for the filename "01-88-99-aa-bb-cc-dd". Indeed, PXE implementation in U-Boot looks for files like that, as can be seen from this call chain: format_mac_pxe() pxe_mac_path() pxe_get() extlinux_pxe_read_bootflow() Mention the fact that PXE expects the configuration file to be prepended with "01" in the PXE section of E850-96 documentation. While at it, fix some other minor issues in PXE section. [1] https://wiki.syslinux.org/wiki/index.php?title=PXELINUX Signed-off-by: Sam Protsenko <[email protected]>
2025-11-21doc: describe return values of C testsHeinrich Schuchardt
* Enumerate return values of C tests * Reference assertion macros Reviewed-by: Ilias Apalodimas <[email protected]> Reviewed-by: Simon Glass <[email protected]> Signed-off-by: Heinrich Schuchardt <[email protected]>
2025-11-21doc: add include/test/ut.h to HTML documentationHeinrich Schuchardt
The asserts in ut.h are often used. Provide online documentation. Reviewed-by: Ilias Apalodimas <[email protected]> Reviewed-by: Simon Glass <[email protected]> Signed-off-by: Heinrich Schuchardt <[email protected]>
2025-11-21doc: make writing DM test subsection of writing C testHeinrich Schuchardt
A driver model test is just a special case of a C test. Reviewed-by: Ilias Apalodimas <[email protected]> Reviewed-by: Simon Glass <[email protected]> Signed-off-by: Heinrich Schuchardt <[email protected]>
2025-11-21doc: board: ti: am6254atl_sk: fix PRELOADED_BL33_BASEAnshul Dalal
The SPL_TEXT_BASE for AM62x SiP is set as 0x82000000 whereas the documentation states 0x81880000 as the PRELOADED_BL33_BASE value. Both should match to allow TFA to jump to the address where A53 SPL has been loaded. Signed-off-by: Anshul Dalal <[email protected]> Acked-by: Heinrich Schuchardt <[email protected]>
2025-11-21doc: board: ti: k3: Update TI firmware repository URL to GitHubVignesh Raghavendra
Update the TI firmware repository URL from git.ti.com to the GitHub mirror at github.com/TexasInstruments/ti-linux-firmware which is much more reliable. Signed-off-by: Vignesh Raghavendra <[email protected]> Reported-by: Tom Rini <[email protected]> Tested-by: Heinrich Schuchardt <[email protected]>
2025-11-20Merge tag 'interconnect-next-20251120' of ↵Tom Rini
https://source.denx.de/u-boot/custodians/u-boot-snapdragon into next - Qualcomm RPMh cmd_db_read_slave_id() & cmd_db_read_aux_data() - Initial Interconnect implementation + Qualcomm RPMh support
2025-11-20Introduce the Generic System Interconnect SubsystemNeil Armstrong
Let's introduce the Generic System Interconnect subsystem based on the counterpart Linux framework which is used to vote for bandwidth across multiple SoC busses. Documentation for the Linux Generic System Interconnect Subsystem can be found at [1]. Each bus endpoints are materialised as "nodes" which are linked together, and the DT will specify a pair of nodes to enable and set a bandwidth on the route between those endpoints. The hardware resources that provide those nodes and provides the way to vote for the bandwidth are called "providers". The Interconnect uclass code is heavily based on the Linux one, with some small differences: - nodes are allocated as udevices instead of Linux idr_alloc() - tag management is minimal, only normal xlate is supported - getting nodes states at probe is not implemented - providers are probed on demand while the nodes links are traversed - nodes are populated on bind - id management is simplified, static IDs and dynamics IDs can be used - identical consume API as Linux, only implementation differs Fully tested with associated DM test suite. [1] https://docs.kernel.org/driver-api/interconnect.html Link: https://patch.msgid.link/[email protected] Signed-off-by: Neil Armstrong <[email protected]>
2025-11-18cmd/part.c: implement "part name" subcommandRasmus Villemoes
This is a natural buddy to the existing "part number", allowing one to get the partition name for a given partition number. Acked-by: Quentin Schulz <[email protected]> Signed-off-by: Rasmus Villemoes <[email protected]> Acked-by: Quentin Schuloz <[email protected]> Tested-by: Anshul Dalal <[email protected]>
2025-11-17Merge tag 'u-boot-stm32-20251117' of ↵Tom Rini
https://source.denx.de/u-boot/custodians/u-boot-stm CI: https://source.denx.de/u-boot/custodians/u-boot-stm/-/pipelines/28392 dhelectronics: - Move dh_add_item_number_and_serial_to_env() to common code - Read values from M24256 write-lockable page on STM32MP13xx DHCOR - Add MAC address readout from fuses on DH STM32MP1 DHSOM - Keep the reg11 and reg18 regulators always enabled on STM32MP13xx DHCOR. - Fix boot for stm32mp15xx-dhsom. - Fix build of ST DFU virt code on DH STM32MP1 DHSOM - Introduce DH STM32MP13x target. STM32MP2: - Add support for stm32mp257-dk board. - Fix arm, smc-id value for stm32mp23/25. - Fix stm32mp235f-dk boot (add syscon compatible, add txbyteclk). - Add display support: - Introduce LVDS driver. - Add LTDC support. - Add Ethernet support for stm32mp255. STM32MP13: - Add ADC support. - Add power check for stm32mp135f-dk board.
2025-11-17video: stm32: STM32 driver support for LVDSRaphael Gallais-Pou
The LVDS Display Interface Transmitter handles the LVDS protocol: it maps the pixels received from the upstream Pixel-DMA (LTDC) onto the LVDS PHY. The LVDS controller driver supports the following high-level features: • FDP-Link-I and OpenLDI (v0.95) protocols • Single-Link or Dual-Link operation • Single-Display or Double-Display (with the same content duplicated on both) • Flexible Bit-Mapping, including JEIDA and VESA • RGB888 or RGB666 output • Synchronous design, with one input pixel per clock cycle • No resolution limitation. Acked-by: Yannick Fertre <[email protected]> Signed-off-by: Raphael Gallais-Pou <[email protected]>
2025-11-15docker: Correct the linux/arm64 platform stringBin Meng
The Dockerfile is using linux/arm64 without the /v8 suffix. Signed-off-by: Bin Meng <[email protected]> Reviewed-by: Heinrich Schuchardt <[email protected]>
2025-11-15doc: pytest: Complete dependencies list with missing packagesKory Maincent (TI.com)
Add missing dependencies to the pytest usage documentation and correct the device tree compiler package name from 'dtc' to 'device-tree-compiler'. This ensures users have the complete list of dependencies needed to run the pytest test suite without errors. Reviewed-by: Mattijs Korpershoek <[email protected]> Signed-off-by: Kory Maincent (TI.com) <[email protected]> Signed-off-by: Heinrich Schuchardt <[email protected]>
2025-11-10Prepare v2026.01-rc2v2026.01-rc2Tom Rini
Signed-off-by: Tom Rini <[email protected]>
2025-11-07Merge patch series "Add support for TI AM6254atl SiP"Tom Rini
Anshul Dalal <[email protected]> says: This patch series adds support for AM6254atl SiP (or AM62x SiP for short) to U-Boot. The OPN (Orderable Part Number) 'AM6254atl' expands as follows[1]: AM6254atl |||| |||+-- Feature Lookup (L indicates 512MiB of integrated LPDDR4) ||+--- Device Speed Grade (T indicates 1.25GHz on A53 cores) |+---- Silicon PG Revision (A indicates SR 1.0) +----- Core configuration (4 indicates A53's in Quad core config) AM62x SiP provides the existing AM62x SoC with 512MiB of DDR integrated in a single packages. The first 4 patches in the series are cherry-picked from the devicetree-rebasing repository at 'v6.18-rc2-dts'. Link: https://lore.kernel.org/r/[email protected]
2025-11-07ti: add support for AM6254atl SiPAnshul Dalal
TI's AM6254atl (or AM62x SiP for short) provides the existing AM62x SoC with 512MiB of DDR integrated in a single package. This patch adds the necessary U-Boot devie tree files, the required defconfigs along with the documentation for the AM62x SiP EVM. AM62x SiP differs from the already supported AM62x in following ways: - OP-TEE for the AM62x resides from 0x9e800000 to 0xa0000000 which needs to be moved to 0x80080000 to free up space at end of DDR in AM62x SiP with 512MiB of memory. This is required to allow U-Boot to relocate to end of DDR before booting to the kernel. - Changes to the env: 1. splashimage address updated from 0x80200000 to 0x81a00000 2. DFU addresses updated to match updated TEXT_BASE for SPL and U-Boot Signed-off-by: Anshul Dalal <[email protected]>