Skip to contentSkip to conversation

Add support for Agilex3 SoCFPGA board

PATCH Superseded [email protected] 3 participants 8 messages Nov 10, 2025 – Nov 11, 2025 Device tree bindings

v1 of 4 Superseded Latest is v4 →

lore
Share & tools
lore
#0 lore raw

cover Add support for Agilex3 SoCFPGA board

From: Niravkumar L Rabara <[email protected]>

Agilex3 SoCFPGA development kit is a low cost and small form factor development kit similar to Agilex5 013b board.
Agilex3 SoCFPGA is derived from Agilex5 SoCFPGA, with the main difference being the number of CPU cores — Agilex3 has 2 cores compared to 4 in Agilex5.

https://www.altera.com/products/devkit/a1jui000005pw9bmas/agilex-3-fpga-and-soc-c-series-development-kit

This series includes:
- The addition of the Agilex3 compatible in DT bindings.
- The initial board device tree support for the Agilex3 SoCFPGA.

Note:
The patch 2 depends on the series: "Add iommu supports"
https://lore.kernel.org/all/[email protected]/

Patch series "Add iommu supports" is applied to socfpga maintainer's tree
https://git.kernel.org/pub/scm/linux/kernel/git/dinguyen/linux.git/log/?h=socfpga_dts_for_v6.19

Niravkumar L Rabara (2):
dt-bindings: intel: Add Agilex3 SoCFPGA board
arm64: dts: socfpga: add Agilex3 board

 .../bindings/arm/intel,socfpga.yaml           |   5 +
 arch/arm64/boot/dts/intel/Makefile            |   1 +
 .../boot/dts/intel/socfpga_agilex3_socdk.dts  | 130 ++++++++++++++++++
 3 files changed, 136 insertions(+)
 create mode 100644 arch/arm64/boot/dts/intel/socfpga_agilex3_socdk.dts
Signature · 1 line
2.25.1
#1 lore raw

PATCH 1/2 dt-bindings: intel: Add Agilex3 SoCFPGA board

From: Niravkumar L Rabara <[email protected]>

Add compatible for Agilex3 SoCFPGA board.

---
 Documentation/devicetree/bindings/arm/intel,socfpga.yaml | 5 +++++
 1 file changed, 5 insertions(+)
Documentation/devicetree/bindings/arm/intel,socfpga.yaml +5 -0
index cf7a91dfec8a..e706c4eff019 100644
@@ -21,6 +21,11 @@ properties:
               - intel,socfpga-agilex-n6000
               - intel,socfpga-agilex-socdk
           - const: intel,socfpga-agilex
+      - description: Agilex3 boards
+        items:
+          - enum:
+              - intel,socfpga-agilex3-socdk
+          - const: intel,socfpga-agilex5
       - description: Agilex5 boards
         items:
           - enum:
Signature · 1 line
2.25.1
#2 lore raw

Re: [PATCH 1/2] dt-bindings: intel: Add Agilex3 SoCFPGA board

Quoted 14 lines · On 10/11/2025 07:47, [email protected] wrote:

From: Niravkumar L Rabara <[email protected]>

Add compatible for Agilex3 SoCFPGA board.

---
 Documentation/devicetree/bindings/arm/intel,socfpga.yaml | 5 +++++
 1 file changed, 5 insertions(+)
Documentation/devicetree/bindings/arm/intel,socfpga.yaml +0 -0
index cf7a91dfec8a..e706c4eff019 100644

Documentation/devicetree/bindings/arm/intel,socfpga.yaml properties: · line 24

Quoted 4 lines
Documentation/devicetree/bindings/arm/intel,socfpga.yaml +1 -0
@@ -21,6 +21,11 @@ properties:
               - intel,socfpga-agilex-n6000
               - intel,socfpga-agilex-socdk
           - const: intel,socfpga-agilex
+      - description: Agilex3 boards

Agilex3?

Documentation/devicetree/bindings/arm/intel,socfpga.yaml properties: · line 28

Quoted 4 lines
Documentation/devicetree/bindings/arm/intel,socfpga.yaml +4 -0
+        items:
+          - enum:
+              - intel,socfpga-agilex3-socdk
+          - const: intel,socfpga-agilex5

Or Agilex5? Decide. Cannot be both.

Documentation/devicetree/bindings/arm/intel,socfpga.yaml properties: · line 30

Quoted 2 lines
Documentation/devicetree/bindings/arm/intel,socfpga.yaml +0 -0
       - description: Agilex5 boards>          items:
           - enum:

Best regards,
Krzysztof

#3 lore raw

Re: [PATCH 1/2] dt-bindings: intel: Add Agilex3 SoCFPGA board

Quoted 11 lines · Krzysztof Kozlowski
Quoted 10 lines · On 10/11/2025 07:47, [email protected] wrote:

From: Niravkumar L Rabara <[email protected]>

Add compatible for Agilex3 SoCFPGA board.

---
  Documentation/devicetree/bindings/arm/intel,socfpga.yaml | 5 +++++
  1 file changed, 5 insertions(+)
Quoted 12 lines

Documentation/devicetree/bindings/arm/intel,socfpga.yaml properties: · line 24

Quoted 9 lines
Documentation/devicetree/bindings/arm/intel,socfpga.yaml +1 -0
index cf7a91dfec8a..e706c4eff019 100644
@@ -21,6 +21,11 @@ properties:
                - intel,socfpga-agilex-n6000
                - intel,socfpga-agilex-socdk
            - const: intel,socfpga-agilex
+      - description: Agilex3 boards

Agilex3?

From what I understand, the Agilex3 is the same chip as the Agilex5, minus 2 CPU cores. So I recommended to Nirav, just to add the binding in the Agilex5 context.

Quoted 7 lines

Documentation/devicetree/bindings/arm/intel,socfpga.yaml properties: · line 28

Quoted 4 lines
Documentation/devicetree/bindings/arm/intel,socfpga.yaml +4 -0
+        items:
+          - enum:
+              - intel,socfpga-agilex3-socdk
+          - const: intel,socfpga-agilex5

Or Agilex5? Decide. Cannot be both.

From the explanation above, could we document the agilex3 socdk this way?

Thanks,
Dinh

#4 lore raw

Re: [PATCH 1/2] dt-bindings: intel: Add Agilex3 SoCFPGA board

Quoted 27 lines · Dinh Nguyen
Quoted 11 lines · Krzysztof Kozlowski
Quoted 10 lines · On 10/11/2025 07:47, [email protected] wrote:

From: Niravkumar L Rabara <[email protected]>

Add compatible for Agilex3 SoCFPGA board.

---
  Documentation/devicetree/bindings/arm/intel,socfpga.yaml | 5 +++++
  1 file changed, 5 insertions(+)
Quoted 12 lines

Documentation/devicetree/bindings/arm/intel,socfpga.yaml properties: · line 24

Quoted 9 lines
Documentation/devicetree/bindings/arm/intel,socfpga.yaml +1 -0
index cf7a91dfec8a..e706c4eff019 100644
@@ -21,6 +21,11 @@ properties:
                - intel,socfpga-agilex-n6000
                - intel,socfpga-agilex-socdk
            - const: intel,socfpga-agilex
+      - description: Agilex3 boards

Agilex3?

Quoted 3 lines

From what I understand, the Agilex3 is the same chip as the Agilex5,
minus 2 CPU cores. So I recommended to Nirav, just to add the binding in the Agilex5 context.

If that is not the same die, then probably should have still agilex3 compatible (you still can have fallback).

Quoted 6 lines
Quoted 6 lines
Quoted 5 lines
Documentation/devicetree/bindings/arm/intel,socfpga.yaml +4 -0
+        items:
+          - enum:
+              - intel,socfpga-agilex3-socdk
+          - const: intel,socfpga-agilex5
Quoted 6 lines
Quoted 2 lines

Or Agilex5? Decide. Cannot be both.

From the explanation above, could we document the agilex3 socdk this way?

Thanks,
Dinh

Best regards,
Krzysztof

#5 lore raw

PATCH 2/2 arm64: dts: socfpga: add Agilex3 board

In reply to [email protected]

From: Niravkumar L Rabara <[email protected]>

Agilex3 SoCFPGA development kit is a small form factor board similar to Agilex5 013b board.
Agilex3 SoCFPGA is derived from Agilex5 SoCFPGA, with the main difference of CPU cores — Agilex3 has 2 cores compared to 4 in Agilex5.

---
Note:
This patch depends on the series: "Add iommu supports"
https://lore.kernel.org/all/[email protected]/

Patch series "Add iommu supports" is applied to socfpga maintainer's tree
https://git.kernel.org/pub/scm/linux/kernel/git/dinguyen/linux.git/log/?h=socfpga_dts_for_v6.19

 arch/arm64/boot/dts/intel/Makefile            |   1 +
 .../boot/dts/intel/socfpga_agilex3_socdk.dts  | 130 ++++++++++++++++++
 2 files changed, 131 insertions(+)
 create mode 100644 arch/arm64/boot/dts/intel/socfpga_agilex3_socdk.dts
arch/arm64/boot/dts/intel/Makefile +1 -0
index 391d5cbe50b3..a117268267ee 100644
@@ -2,6 +2,7 @@
 dtb-$(CONFIG_ARCH_INTEL_SOCFPGA) += socfpga_agilex_n6000.dtb \
 				socfpga_agilex_socdk.dtb \
 				socfpga_agilex_socdk_nand.dtb \
+				socfpga_agilex3_socdk.dtb \
 				socfpga_agilex5_socdk.dtb \
 				socfpga_agilex5_socdk_013b.dtb \
 				socfpga_agilex5_socdk_nand.dtb \
arch/arm64/boot/dts/intel/socfpga_agilex3_socdk.dts new file +130 -0

130 lines not on this page · raw message

Signature · 1 line
2.25.1
#6 lore raw

Re: [PATCH 2/2] arm64: dts: socfpga: add Agilex3 board

Quoted 62 lines · On 11/10/25 00:47, [email protected] wrote:

From: Niravkumar L Rabara <[email protected]>

Agilex3 SoCFPGA development kit is a small form factor board similar to Agilex5 013b board.
Agilex3 SoCFPGA is derived from Agilex5 SoCFPGA, with the main difference of CPU cores — Agilex3 has 2 cores compared to 4 in Agilex5.

---
Note:
This patch depends on the series: "Add iommu supports"
https://lore.kernel.org/all/[email protected]/

Patch series "Add iommu supports" is applied to socfpga maintainer's tree
https://git.kernel.org/pub/scm/linux/kernel/git/dinguyen/linux.git/log/?h=socfpga_dts_for_v6.19

  arch/arm64/boot/dts/intel/Makefile            |   1 +
  .../boot/dts/intel/socfpga_agilex3_socdk.dts  | 130 ++++++++++++++++++
  2 files changed, 131 insertions(+)

create mode 100644 arch/arm64/boot/dts/intel/socfpga_agilex3_socdk.dts

arch/arm64/boot/dts/intel/Makefile +1 -0
index 391d5cbe50b3..a117268267ee 100644
@@ -2,6 +2,7 @@
  dtb-$(CONFIG_ARCH_INTEL_SOCFPGA) += socfpga_agilex_n6000.dtb \
  				socfpga_agilex_socdk.dtb \
  				socfpga_agilex_socdk_nand.dtb \
+				socfpga_agilex3_socdk.dtb \
  				socfpga_agilex5_socdk.dtb \
  				socfpga_agilex5_socdk_013b.dtb \
  				socfpga_agilex5_socdk_nand.dtb \
arch/arm64/boot/dts/intel/socfpga_agilex3_socdk.dts new file +23 -0
new file mode 100644
index 000000000000..3280bdd49faa
@@ -0,0 +1,130 @@
+// SPDX-License-Identifier: GPL-2.0-only
+/*
+ * Copyright (C) 2025, Altera Corporation
+ */
+#include "socfpga_agilex5.dtsi"
+
+/ {
+	model = "SoCFPGA Agilex3 SoCDK";
+	compatible = "intel,socfpga-agilex3-socdk", "intel,socfpga-agilex5";
+
+	aliases {
+		serial0 = &uart0;
+		ethernet2 = &gmac2;
+	};
+
+	chosen {
+		stdout-path = "serial0:115200n8";
+	};
+
+	leds {
+		compatible = "gpio-leds";
+
+		led0 {

arch/arm64/boot/dts/intel/socfpga_agilex3_socdk.dts line 33

Quoted 10 lines
arch/arm64/boot/dts/intel/socfpga_agilex3_socdk.dts new file +10 -0
+			label = "hps_led0";
+			gpios = <&porta 1 GPIO_ACTIVE_HIGH>;
+		};
+
+		led1 {
+			label = "hps_led1";
+			gpios = <&porta 12 GPIO_ACTIVE_HIGH>;
+		};
+
+	};

You need the :

 cpus {
        /delete-node/ cpu@2;
        /delete-node/ cpu@3;
    };

Dinh

#7 lore raw

Re: [PATCH 2/2] arm64: dts: socfpga: add Agilex3 board

Quoted 78 lines · Dinh Nguyen
Quoted 62 lines · On 11/10/25 00:47, [email protected] wrote:

From: Niravkumar L Rabara <[email protected]>

Agilex3 SoCFPGA development kit is a small form factor board similar to Agilex5 013b board.
Agilex3 SoCFPGA is derived from Agilex5 SoCFPGA, with the main difference of CPU cores — Agilex3 has 2 cores compared to 4 in Agilex5.

---
Note:
This patch depends on the series: "Add iommu supports"
https://lore.kernel.org/all/ [email protected]/

Patch series "Add iommu supports" is applied to socfpga maintainer's tree
https://git.kernel.org/pub/scm/linux/kernel/git/dinguyen/linux.git/ log/?h=socfpga_dts_for_v6.19

  arch/arm64/boot/dts/intel/Makefile            |   1 + .../boot/dts/intel/socfpga_agilex3_socdk.dts  | 130 ++++++++++++++++++

  2 files changed, 131 insertions(+)

  create mode 100644 arch/arm64/boot/dts/intel/socfpga_agilex3_socdk.dts

arch/arm64/boot/dts/intel/Makefile +1 -0
index 391d5cbe50b3..a117268267ee 100644
@@ -2,6 +2,7 @@
   dtb-$(CONFIG_ARCH_INTEL_SOCFPGA) += socfpga_agilex_n6000.dtb \
                   socfpga_agilex_socdk.dtb \
                   socfpga_agilex_socdk_nand.dtb \
+                socfpga_agilex3_socdk.dtb \
                   socfpga_agilex5_socdk.dtb \
                   socfpga_agilex5_socdk_013b.dtb \
                   socfpga_agilex5_socdk_nand.dtb \
arch/arm64/boot/dts/intel/socfpga_agilex3_socdk.dts new file +23 -0
new file mode 100644
index 000000000000..3280bdd49faa
@@ -0,0 +1,130 @@
+// SPDX-License-Identifier: GPL-2.0-only
+/*
+ * Copyright (C) 2025, Altera Corporation
+ */
+#include "socfpga_agilex5.dtsi"
+
+/ {
+    model = "SoCFPGA Agilex3 SoCDK";
+    compatible = "intel,socfpga-agilex3-socdk", "intel,socfpga-agilex5";
+
+    aliases {
+        serial0 = &uart0;
+        ethernet2 = &gmac2;
+    };
+
+    chosen {
+        stdout-path = "serial0:115200n8";
+    };
+
+    leds {
+        compatible = "gpio-leds";
+
+        led0 {

arch/arm64/boot/dts/intel/socfpga_agilex3_socdk.dts line 33

Quoted 10 lines
arch/arm64/boot/dts/intel/socfpga_agilex3_socdk.dts new file +10 -0
+            label = "hps_led0";
+            gpios = <&porta 1 GPIO_ACTIVE_HIGH>;
+        };
+
+        led1 {
+            label = "hps_led1";
+            gpios = <&porta 12 GPIO_ACTIVE_HIGH>;
+        };
+
+    };

You need the :

Quoted 7 lines

 cpus {
        /delete-node/ cpu@2;
        /delete-node/ cpu@3;
    };

Dinh

I tried this way Dinh, but it doesn't work in dts, compile gives error.
/delete-node/ cpu@2;
/delete-node/ cpu@3;
works correctly.

Anyway I will send v2 patch with a socfpga_agilex3.dtsi for Agilex3 silicon which include "socfpga_agilex5.dtsi" and delete the cpu2 and cpu3 in dtsi file instead of dts.

Thanks,
Nirav