diff mbox series

[v4,3/6] dt-bindings: net: dwmac: add compatible for Agilex5

Message ID 20250205-v6-12-topic-socfpga-agilex5-v4-3-ebf070e2075f@pengutronix.de (mailing list archive)
State Changes Requested
Delegated to: Netdev Maintainers
Headers show
Series ARM64: dts: intel: agilex5: add nodes and new board | expand

Checks

Context Check Description
netdev/tree_selection success Not a local patch

Commit Message

Steffen Trumtrar Feb. 5, 2025, 3:32 p.m. UTC
The Agilex5 SoCs have three Synopsys DWXGMAC-compatible ethernet
IP-cores.

Add a SoC-specific front compatible to the binding.

Signed-off-by: Steffen Trumtrar <s.trumtrar@pengutronix.de>
---
 Documentation/devicetree/bindings/net/socfpga-dwmac.yaml | 7 +++++++
 1 file changed, 7 insertions(+)

Comments

Krzysztof Kozlowski Feb. 10, 2025, 10:23 a.m. UTC | #1
On Wed, Feb 05, 2025 at 04:32:24PM +0100, Steffen Trumtrar wrote:
> The Agilex5 SoCs have three Synopsys DWXGMAC-compatible ethernet
> IP-cores.
> 
> Add a SoC-specific front compatible to the binding.
> 
> Signed-off-by: Steffen Trumtrar <s.trumtrar@pengutronix.de>
> ---
>  Documentation/devicetree/bindings/net/socfpga-dwmac.yaml | 7 +++++++
>  1 file changed, 7 insertions(+)
> 
> diff --git a/Documentation/devicetree/bindings/net/socfpga-dwmac.yaml b/Documentation/devicetree/bindings/net/socfpga-dwmac.yaml
> index 2568dd90f4555485f18912b5352f191824bb918c..31c163bf1b59e14216d1fb4b4b9aaa747e1b19e2 100644
> --- a/Documentation/devicetree/bindings/net/socfpga-dwmac.yaml
> +++ b/Documentation/devicetree/bindings/net/socfpga-dwmac.yaml
> @@ -21,6 +21,7 @@ select:
>          enum:
>            - altr,socfpga-stmmac # For Cyclone5/Arria5 SoCs
>            - altr,socfpga-stmmac-a10-s10 # For Arria10/Agilex/Stratix10 SoCs
> +          - altr,socfpga-stmmac-agilex5 # For Agilex5 SoCs
>    required:
>      - compatible
>  
> @@ -45,6 +46,12 @@ properties:
>                - altr,socfpga-stmmac-a10-s10
>            - const: snps,dwmac-3.74a
>            - const: snps,dwmac
> +      - items:
> +          - enum:
> +              - altr,socfpga-stmmac-agilex5
> +          - const: altr,socfpga-stmmac-a10-s10
> +          - const: snps,dwxgmac-2.10

No, don't grow this pattern. a10-s10 *MUST* be one specific device, so
it cannot be compatible with 3.72, 3.74 and 2.10 in the same time.

I understand that old DTS was here wrong, that ship has failed, but
don't grow it. All your compatibles must be specific, which means they
must represent one logical choice. You claim now that a10-s10 covers now
three entirely different devices.

Best regards,
Krzysztof
diff mbox series

Patch

diff --git a/Documentation/devicetree/bindings/net/socfpga-dwmac.yaml b/Documentation/devicetree/bindings/net/socfpga-dwmac.yaml
index 2568dd90f4555485f18912b5352f191824bb918c..31c163bf1b59e14216d1fb4b4b9aaa747e1b19e2 100644
--- a/Documentation/devicetree/bindings/net/socfpga-dwmac.yaml
+++ b/Documentation/devicetree/bindings/net/socfpga-dwmac.yaml
@@ -21,6 +21,7 @@  select:
         enum:
           - altr,socfpga-stmmac # For Cyclone5/Arria5 SoCs
           - altr,socfpga-stmmac-a10-s10 # For Arria10/Agilex/Stratix10 SoCs
+          - altr,socfpga-stmmac-agilex5 # For Agilex5 SoCs
   required:
     - compatible
 
@@ -45,6 +46,12 @@  properties:
               - altr,socfpga-stmmac-a10-s10
           - const: snps,dwmac-3.74a
           - const: snps,dwmac
+      - items:
+          - enum:
+              - altr,socfpga-stmmac-agilex5
+          - const: altr,socfpga-stmmac-a10-s10
+          - const: snps,dwxgmac-2.10
+          - const: snps,dwxgmac
 
   altr,sysmgr-syscon:
     $ref: /schemas/types.yaml#/definitions/phandle-array