dt-bindings: net: convert socfpga-dwmac.txt to DT schema
Subsystems (2)
PATCH v4 1/1 dt-bindings: net: convert socfpga-dwmac.txt to DT schema
Convert the socfpga-dwmac.txt to yaml.
---
v4: remove maxItems for clock-names
v3: Address all of Rob Herring's comments
v2: Add allOf to include the base dmac yaml
fix Rob Herring's dt_binding_check warnings
--- .../bindings/net/altr,dwmac-socfpga.yaml | 138 ++++++++++++++++++ .../devicetree/bindings/net/socfpga-dwmac.txt | 57 -------- 2 files changed, 138 insertions(+), 57 deletions(-) create mode 100644 Documentation/devicetree/bindings/net/altr,dwmac-socfpga.yaml delete mode 100644 Documentation/devicetree/bindings/net/socfpga-dwmac.txt
Documentation/devicetree/bindings/net/altr,dwmac-socfpga.yaml new file +138 -0
@@ -0,0 +1,138 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/net/altr,dwmac-socfpga.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Intel/Altera SoCFPGA DWMAC controller + +maintainers: + - Dinh Nguyen <[email protected]> + +select: + properties: + compatible: + contains: + enum: + - altr,socfpga-stmmac + - altr,socfpga-stmmac-a10-s10 + required: + - compatible + +allOf: + - $ref: snps,dwmac.yaml# + +properties: + compatible: + oneOf: + - items: + - const: altr,socfpga-stmmac + - const: snps,dwmac-3.70a + - const: snps,dwmac + - items: + - const: altr,socfpga-stmmac-a10-s10 + - const: snps,dwmac-3.72a + - const: snps,dwmac + - items: + - const: altr,socfpga-stmmac-a10-s10 + - const: snps,dwmac-3.74a + - const: snps,dwmac + + reg: + maxItems: 1 + + iommus: + minItems: 1 + maxItems: 2 + + clocks: + minItems: 1 + items: + - description: GMAC main clock + - description: PTP clock + + clock-names: + minItems: 1 + items: + - const: stmmaceth + - const: ptp_ref + + resets: + minItems: 1 + items: + - description: GMAC stmmaceth reset + - description: AHB reset + + reset-names: + minItems: 1 + items: + - const: stmmaceth + - const: ahb + + interrupts: + items: + - description: DWMAC interrupt + + interrupt-names: + items: + - const: macirq + + phy-mode: + maxItems: 1 + items: + enum: + - rgmii + - gmii + - mii + + altr,sysmgr-syscon: + $ref: /schemas/types.yaml#/definitions/phandle-array + items: + - items: + - description: phandle to the sysmgr node + - description: register offset that controls the SDMMC clock phase + - description: register shift for the smplsel(drive in) setting + description: + Should be the phandle to the system manager node that + encompasses the glue register, the register offset, and the register shift. + On Cyclone5/Arria5, the register shift represents the PHY mode bits, while + on the Arria10/Stratix10/Agilex platforms, the register shift represents + bit for each emac to enable/disable signals from the FPGA fabric to the + EMAC modules. + + altr,emac-splitter: + $ref: /schemas/types.yaml#/definitions/phandle + description: + Should be the phandle to the emac splitter soft IP node if DWMAC + controller is connected emac splitter. + + altr,sgmii-to-sgmii-converter: + $ref: /schemas/types.yaml#/definitions/phandle + description: + Phandle to the TSE SGMII converter. + +required: + - compatible + - reg + - interrupts + - clocks + - clock-names + - phy-mode + +unevaluatedProperties: false + +examples: + - | + gmac0: ethernet@ff700000 { + compatible = "altr,socfpga-stmmac", "snps,dwmac-3.70a", "snps,dwmac"; + altr,sysmgr-syscon = <&sysmgr 0x60 0>; + reg = <0xff700000 0x2000>; + interrupts = <0 115 4>; + interrupt-names = "macirq"; + mac-address = [00 00 00 00 00 00];/* Filled in by U-Boot */ + clocks = <&emac_0_clk>; + clock-names = "stmmaceth"; + phy-mode = "rgmii"; + tx-fifo-depth = <16384>; + rx-fifo-depth = <16384>; + };
Documentation/devicetree/bindings/net/socfpga-dwmac.txt deleted +0 -57
57 lines not on this page · raw message
Signature · 1 line
2.42.0.411.g813d9a9188
Quoted 8 lines · Dinh Nguyen
Convert the socfpga-dwmac.txt to yaml.
Signed-off-by Dinh Nguyen <[email protected]>---
v4: remove maxItems for clock-names
v3: Address all of Rob Herring's comments
v2: Add allOf to include the base dmac yaml
fix Rob Herring'sdt_binding_checkwarnings
Quoted 7 lines
--- .../bindings/net/altr,dwmac-socfpga.yaml | 138 ++++++++++++++++++ .../devicetree/bindings/net/socfpga-dwmac.txt | 57 -------- 2 files changed, 138 insertions(+), 57 deletions(-) create mode 100644 Documentation/devicetree/bindings/net/altr,dwmac-socfpga.yaml delete mode 100644 Documentation/devicetree/bindings/net/socfpga-dwmac.txt
Rob Herring
maintainerQuoted 18 lines · Rob Herring (Arm)
Quoted 8 lines · Dinh Nguyen
Convert the socfpga-dwmac.txt to yaml.
Signed-off-by Dinh Nguyen <[email protected]>---
v4: remove maxItems for clock-names
v3: Address all of Rob Herring's comments
v2: Add allOf to include the base dmac yaml
fix Rob Herring'sdt_binding_checkwarningsQuoted 7 lines
--- .../bindings/net/altr,dwmac-socfpga.yaml | 138 ++++++++++++++++++ .../devicetree/bindings/net/socfpga-dwmac.txt | 57 -------- 2 files changed, 138 insertions(+), 57 deletions(-) create mode 100644 Documentation/devicetree/bindings/net/altr,dwmac-socfpga.yaml delete mode 100644 Documentation/devicetree/bindings/net/socfpga-dwmac.txt
Quoted 1 line
Reviewed-by Rob Herring (Arm) <[email protected]>
Unreviewed... There's also this conversion[1] which came first and is more complete. Please comment on it.
Rob