arm: dts: socfpga: Add Terasic DE-25 Standard Board Support
PATCH v2 1/1 arm: dts: socfpga: Add Terasic DE-25 Standard Board Support
From: Alif Zakuan Yuslaimi <[email protected]>
Add dedicated device tree support for the Terasic DE-25 Standard board, which is based on Agilex5.
Following Terasic's Linux device tree for DE-25 Standard configuration in which UART and board wiring differs from Altera SoCDK boards - enable UART1 instead of UART0, route console through serial0 alias, and expose a single HPS LED on GPIO port B pin 17 (active-low). Enable only the on-board peripherals present on this kit: a single RGMII Ethernet interface on gmac0 with PHY MDIO address 1, gpio1, i2c1, spi0, and usb0. The second GMAC, extra I2C/I3C buses, spi1, usb31, and NAND are left disabled.
MMC retains UHS-I SDR104 mode consistent with the Altera SoCDK reference. QSPI NOR flash uses the SoCDK-style partition layout on the 256 MB device (dedicated u-boot and root regions); the QSPI controller is disabled in the U-Boot SPL device tree so that SD/MMC is the primary boot source. DRAM base/size come from the HW handoff like SoCDK/Nano (no hardcoded memory reg override). gmac0 uses phy-mode rgmii-id to match the DE-25 Nano sibling.
New files added:
- socfpga_agilex5_de25s.dts: Main device tree
- socfpga_agilex5_de25s-u-boot.dtsi: U-Boot specific additions
- configs/socfpga_agilex5_de25s_defconfig: Board configuration
Build system integration:
- Add build target in Makefile for DE25 Standard device tree binary file
---
Changes in v2:
- Drop hardcoded 1 GiB DRAM reg and rely on handoff following DE-25 Nano
- Use rgmii-id instead of rgmii for gmac0, matching DE-25 Nano
--- arch/arm/dts/Makefile | 1 + .../arm/dts/socfpga_agilex5_de25s-u-boot.dtsi | 198 ++++++++++++++++++ arch/arm/dts/socfpga_agilex5_de25s.dts | 157 ++++++++++++++ configs/socfpga_agilex5_de25s_defconfig | 3 + 4 files changed, 359 insertions(+) create mode 100644 arch/arm/dts/socfpga_agilex5_de25s-u-boot.dtsi create mode 100644 arch/arm/dts/socfpga_agilex5_de25s.dts create mode 100644 configs/socfpga_agilex5_de25s_defconfig
arch/arm/dts/Makefile +1 -0
@@ -416,6 +416,7 @@ dtb-$(CONFIG_AM43XX) += am437x-gp-evm.dtb am437x-sk-evm.dtb \ dtb-$(CONFIG_TARGET_THUNDERX_88XX) += thunderx-88xx.dtb dtb-$(CONFIG_ARCH_SOCFPGA) += \ + socfpga_agilex5_de25s.dtb \ socfpga_agilex5_socdk.dtb \ socfpga_agilex5_socdk_emmc.dtb \ socfpga_arria5_secu1.dtb \
arch/arm/dts/socfpga_agilex5_de25s-u-boot.dtsi new file +198 -0
198 lines not on this page · raw message
arch/arm/dts/socfpga_agilex5_de25s.dts new file +157 -0
157 lines not on this page · raw message
configs/socfpga_agilex5_de25s_defconfig new file +3 -0
@@ -0,0 +1,3 @@ +#include <configs/socfpga_agilex5_defconfig> + +CONFIG_DEFAULT_DEVICE_TREE="socfpga_agilex5_de25s"
Signature · 1 line
2.43.7
Hi YUSLAIMI,
arch/arm/dts/socfpga_agilex5_de25s-u-boot.dtsi line 69
Quoted 5 lines · Alif Zakuan Yuslaimi
arch/arm/dts/socfpga_agilex5_de25s-u-boot.dtsi +3
-0@@ -0,0 +67,5 @@ + chosen { + stdout-path = "serial0:115200n8"; + u-boot,spl-boot-order = &mmc,&flash0,&nand,"/memory";
The new U-Boot DT places flash0 in u-boot,spl-boot-order, but then disables its parent qspi node — spl_node_to_boot_device() only maps the flash node after uclass_get_device_by_of_offset(UCLASS_SPI_FLASH, ...) succeeds; with qspi disabled, that entry is skipped.
Please either enable qspi for a functional QSPI fallback, or remove &flash0 from u-boot,spl-boot-order and document that the board is intentionally SD/MMC-only
Quoted 2 lines
arch/arm/dts/socfpga_agilex5_de25s-u-boot.dtsi +2
-0+ }; +};
[...]
arch/arm/dts/socfpga_agilex5_de25s.dts line 3
Quoted 5 lines
arch/arm/dts/socfpga_agilex5_de25s.dts +3
-0@@ -0,0 +1,3 @@ +// SPDX-License-Identifier: GPL-2.0 +/* + * Copyright (C) 2026 Altera Corporation <www.altera.com>
checkpatch reports that MAINTAINERS coverage may need updating for the new board support files — this is a repository-ownership/process warning, not a functional defect
Please add the appropriate DE25 board path and maintainer entry if the board has a distinct maintainer; otherwise acknowledge the warning in the series review
[...]
One functional boot-order contradiction requires correction; checkpatch also reports a MAINTAINERS coverage warning.
Best regards,
Tien Fong