1d5a57e4eSNeil Armstrong# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause) 2d5a57e4eSNeil Armstrong# Copyright 2019 BayLibre, SAS 3d5a57e4eSNeil Armstrong%YAML 1.2 4d5a57e4eSNeil Armstrong--- 5d5a57e4eSNeil Armstrong$id: "http://devicetree.org/schemas/net/amlogic,meson-dwmac.yaml#" 6d5a57e4eSNeil Armstrong$schema: "http://devicetree.org/meta-schemas/core.yaml#" 7d5a57e4eSNeil Armstrong 8d5a57e4eSNeil Armstrongtitle: Amlogic Meson DWMAC Ethernet controller 9d5a57e4eSNeil Armstrong 10d5a57e4eSNeil Armstrongmaintainers: 11d5a57e4eSNeil Armstrong - Neil Armstrong <narmstrong@baylibre.com> 12d5a57e4eSNeil Armstrong - Martin Blumenstingl <martin.blumenstingl@googlemail.com> 13d5a57e4eSNeil Armstrong 14d5a57e4eSNeil Armstrong# We need a select here so we don't match all nodes with 'snps,dwmac' 15d5a57e4eSNeil Armstrongselect: 16d5a57e4eSNeil Armstrong properties: 17d5a57e4eSNeil Armstrong compatible: 18d5a57e4eSNeil Armstrong contains: 19d5a57e4eSNeil Armstrong enum: 20d5a57e4eSNeil Armstrong - amlogic,meson6-dwmac 21d5a57e4eSNeil Armstrong - amlogic,meson8b-dwmac 22d5a57e4eSNeil Armstrong - amlogic,meson8m2-dwmac 23d5a57e4eSNeil Armstrong - amlogic,meson-gxbb-dwmac 24d5a57e4eSNeil Armstrong - amlogic,meson-axg-dwmac 25d5a57e4eSNeil Armstrong required: 26d5a57e4eSNeil Armstrong - compatible 27d5a57e4eSNeil Armstrong 28d5a57e4eSNeil ArmstrongallOf: 29d5a57e4eSNeil Armstrong - $ref: "snps,dwmac.yaml#" 30d5a57e4eSNeil Armstrong - if: 31d5a57e4eSNeil Armstrong properties: 32d5a57e4eSNeil Armstrong compatible: 33d5a57e4eSNeil Armstrong contains: 34d5a57e4eSNeil Armstrong enum: 35d5a57e4eSNeil Armstrong - amlogic,meson8b-dwmac 36d5a57e4eSNeil Armstrong - amlogic,meson8m2-dwmac 37d5a57e4eSNeil Armstrong - amlogic,meson-gxbb-dwmac 38d5a57e4eSNeil Armstrong - amlogic,meson-axg-dwmac 39d5a57e4eSNeil Armstrong 40d5a57e4eSNeil Armstrong then: 41d5a57e4eSNeil Armstrong properties: 42d5a57e4eSNeil Armstrong clocks: 43d5a57e4eSNeil Armstrong items: 44d5a57e4eSNeil Armstrong - description: GMAC main clock 45d5a57e4eSNeil Armstrong - description: First parent clock of the internal mux 46d5a57e4eSNeil Armstrong - description: Second parent clock of the internal mux 47d5a57e4eSNeil Armstrong 48d5a57e4eSNeil Armstrong clock-names: 49d5a57e4eSNeil Armstrong minItems: 3 50d5a57e4eSNeil Armstrong maxItems: 3 51d5a57e4eSNeil Armstrong items: 52d5a57e4eSNeil Armstrong - const: stmmaceth 53d5a57e4eSNeil Armstrong - const: clkin0 54d5a57e4eSNeil Armstrong - const: clkin1 55d5a57e4eSNeil Armstrong 56d5a57e4eSNeil Armstrong amlogic,tx-delay-ns: 57d5a57e4eSNeil Armstrong $ref: /schemas/types.yaml#definitions/uint32 58d5a57e4eSNeil Armstrong description: 59d5a57e4eSNeil Armstrong The internal RGMII TX clock delay (provided by this driver) in 60d5a57e4eSNeil Armstrong nanoseconds. Allowed values are 0ns, 2ns, 4ns, 6ns. 61d5a57e4eSNeil Armstrong When phy-mode is set to "rgmii" then the TX delay should be 62d5a57e4eSNeil Armstrong explicitly configured. When not configured a fallback of 2ns is 63d5a57e4eSNeil Armstrong used. When the phy-mode is set to either "rgmii-id" or "rgmii-txid" 64d5a57e4eSNeil Armstrong the TX clock delay is already provided by the PHY. In that case 65d5a57e4eSNeil Armstrong this property should be set to 0ns (which disables the TX clock 66d5a57e4eSNeil Armstrong delay in the MAC to prevent the clock from going off because both 67d5a57e4eSNeil Armstrong PHY and MAC are adding a delay). 68d5a57e4eSNeil Armstrong Any configuration is ignored when the phy-mode is set to "rmii". 69d5a57e4eSNeil Armstrong 707af4c845SMartin Blumenstingl amlogic,rx-delay-ns: 717af4c845SMartin Blumenstingl enum: 727af4c845SMartin Blumenstingl - 0 737af4c845SMartin Blumenstingl - 2 747af4c845SMartin Blumenstingl default: 0 757af4c845SMartin Blumenstingl description: 767af4c845SMartin Blumenstingl The internal RGMII RX clock delay (provided by this IP block) in 777af4c845SMartin Blumenstingl nanoseconds. When phy-mode is set to "rgmii" then the RX delay 787af4c845SMartin Blumenstingl should be explicitly configured. When the phy-mode is set to 797af4c845SMartin Blumenstingl either "rgmii-id" or "rgmii-rxid" the RX clock delay is already 807af4c845SMartin Blumenstingl provided by the PHY. Any configuration is ignored when the 817af4c845SMartin Blumenstingl phy-mode is set to "rmii". 827af4c845SMartin Blumenstingl 83d5a57e4eSNeil Armstrongproperties: 84d5a57e4eSNeil Armstrong compatible: 85d5a57e4eSNeil Armstrong additionalItems: true 86d5a57e4eSNeil Armstrong maxItems: 3 87d5a57e4eSNeil Armstrong items: 88d5a57e4eSNeil Armstrong - enum: 89d5a57e4eSNeil Armstrong - amlogic,meson6-dwmac 90d5a57e4eSNeil Armstrong - amlogic,meson8b-dwmac 91d5a57e4eSNeil Armstrong - amlogic,meson8m2-dwmac 92d5a57e4eSNeil Armstrong - amlogic,meson-gxbb-dwmac 93d5a57e4eSNeil Armstrong - amlogic,meson-axg-dwmac 94d5a57e4eSNeil Armstrong contains: 95d5a57e4eSNeil Armstrong enum: 96d5a57e4eSNeil Armstrong - snps,dwmac-3.70a 97d5a57e4eSNeil Armstrong - snps,dwmac 98d5a57e4eSNeil Armstrong 99d5a57e4eSNeil Armstrong reg: 100d5a57e4eSNeil Armstrong items: 101d5a57e4eSNeil Armstrong - description: 102d5a57e4eSNeil Armstrong The first register range should be the one of the DWMAC controller 103d5a57e4eSNeil Armstrong - description: 104d5a57e4eSNeil Armstrong The second range is is for the Amlogic specific configuration 105d5a57e4eSNeil Armstrong (for example the PRG_ETHERNET register range on Meson8b and newer) 106d5a57e4eSNeil Armstrong 107d5a57e4eSNeil Armstrongrequired: 108d5a57e4eSNeil Armstrong - compatible 109d5a57e4eSNeil Armstrong - reg 110d5a57e4eSNeil Armstrong - interrupts 111d5a57e4eSNeil Armstrong - interrupt-names 112d5a57e4eSNeil Armstrong - clocks 113d5a57e4eSNeil Armstrong - clock-names 114d5a57e4eSNeil Armstrong - phy-mode 115d5a57e4eSNeil Armstrong 116d5a57e4eSNeil Armstrongexamples: 117d5a57e4eSNeil Armstrong - | 118d5a57e4eSNeil Armstrong ethmac: ethernet@c9410000 { 119d5a57e4eSNeil Armstrong compatible = "amlogic,meson-gxbb-dwmac", "snps,dwmac"; 120d5a57e4eSNeil Armstrong reg = <0xc9410000 0x10000>, <0xc8834540 0x8>; 121d5a57e4eSNeil Armstrong interrupts = <8>; 122d5a57e4eSNeil Armstrong interrupt-names = "macirq"; 123d5a57e4eSNeil Armstrong clocks = <&clk_eth>, <&clkc_fclk_div2>, <&clk_mpll2>; 124d5a57e4eSNeil Armstrong clock-names = "stmmaceth", "clkin0", "clkin1"; 125d5a57e4eSNeil Armstrong phy-mode = "rgmii"; 126d5a57e4eSNeil Armstrong }; 127