dt-bindings: net: convert socfpga-dwmac.txt to DT schema
Subsystems (2)
PATCH v2 1/1 dt-bindings: net: convert socfpga-dwmac.txt to DT schema
Convert the socfpga-dwmac.txt to yaml.
Signed-off-by Dinh Nguyen <[email protected]>
---
v2: Add allOf to include the base dmac yaml
fix Rob Herring's dt_binding_check warnings
--- .../bindings/net/altr,dwmac-socfpga.yaml | 162 ++++++++++++++++++ .../devicetree/bindings/net/socfpga-dwmac.txt | 57 ------ 2 files changed, 162 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 +162 -0
@@ -0,0 +1,162 @@ +# 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: + additionalItems: true + maxItems: 3 + items: + - enum: + - altr,socfpga-stmmac + - altr,socfpga-stmmac-a10-s10 + contains: + enum: + - snps,dwmac-3.74a + - snps,dwmac-3.70a + - snps,dwmac + + reg: + items: + - description: Base DWMAC registers + + iommus: + minItems: 1 + maxItems: 2 + + clocks: + minItems: 1 + items: + - description: MAC host clock + - description: MAC timer clock + + clock-names: + minItems: 1 + maxItems: 2 + contains: + enum: + - stmmaceth + - ptp_ref + + resets: + minItems: 1 + items: + - description: GMAC stmmaceth reset + - description: AHB reset + + reset-names: + oneOf: + - items: + - enum: [stmmaceth, ahb] + - items: + - const: stmmaceth + - const: ahb + + interrupts: + items: + - description: DWAC interrupt + + interrupt-names: + items: + - const: macirq + + mac-address: true + + phy-mode: + maxItems: 1 + items: + enum: + - rgmii + - gmii + - mii + + tx-fifo-depth: + $ref: /schemas/types.yaml#/definitions/uint32 + description: DWMAC Tx fifo depth(Stratix10, Agilex) + + rx-fifo-depth: + $ref: /schemas/types.yaml#/definitions/uint32 + description: DWMAC Rx fifo depth(Stratix10, Agilex) + + snps,multicast-filter-bins: + $ref: /schemas/types.yaml#/definitions/uint32 + description: + Number of multicast filter hash bins supported by this device + instance + + 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 + +additionalProperties: false + +examples: + - | + soc { + #address-cells = <1>; + #size-cells = <1>; + + 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