Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

dt-bindings: net: Convert iProc MDIO mux to YAML

Conver the Broadcom iProc MDIO mux Device Tree binding to YAML.

Signed-off-by: Florian Fainelli <f.fainelli@gmail.com>
Link: https://lore.kernel.org/r/20211206180049.2086907-9-f.fainelli@gmail.com
Signed-off-by: Rob Herring <robh@kernel.org>

authored by

Florian Fainelli and committed by
Rob Herring
7675a1dc 1fefc8e7

+80 -62
-62
Documentation/devicetree/bindings/net/brcm,mdio-mux-iproc.txt
··· 1 - Properties for an MDIO bus multiplexer found in Broadcom iProc based SoCs. 2 - 3 - This MDIO bus multiplexer defines buses that could be internal as well as 4 - external to SoCs and could accept MDIO transaction compatible to C-22 or 5 - C-45 Clause. When child bus is selected, one needs to select these two 6 - properties as well to generate desired MDIO transaction on appropriate bus. 7 - 8 - Required properties in addition to the generic multiplexer properties: 9 - 10 - MDIO multiplexer node: 11 - - compatible: brcm,mdio-mux-iproc. 12 - 13 - Every non-ethernet PHY requires a compatible so that it could be probed based 14 - on this compatible string. 15 - 16 - Optional properties: 17 - - clocks: phandle of the core clock which drives the mdio block. 18 - 19 - Additional information regarding generic multiplexer properties can be found 20 - at- Documentation/devicetree/bindings/net/mdio-mux.yaml 21 - 22 - 23 - for example: 24 - mdio_mux_iproc: mdio-mux@66020000 { 25 - compatible = "brcm,mdio-mux-iproc"; 26 - reg = <0x66020000 0x250>; 27 - #address-cells = <1>; 28 - #size-cells = <0>; 29 - 30 - mdio@0 { 31 - reg = <0x0>; 32 - #address-cells = <1>; 33 - #size-cells = <0>; 34 - 35 - pci_phy0: pci-phy@0 { 36 - compatible = "brcm,ns2-pcie-phy"; 37 - reg = <0x0>; 38 - #phy-cells = <0>; 39 - }; 40 - }; 41 - 42 - mdio@7 { 43 - reg = <0x7>; 44 - #address-cells = <1>; 45 - #size-cells = <0>; 46 - 47 - pci_phy1: pci-phy@0 { 48 - compatible = "brcm,ns2-pcie-phy"; 49 - reg = <0x0>; 50 - #phy-cells = <0>; 51 - }; 52 - }; 53 - mdio@10 { 54 - reg = <0x10>; 55 - #address-cells = <1>; 56 - #size-cells = <0>; 57 - 58 - gphy0: eth-phy@10 { 59 - reg = <0x10>; 60 - }; 61 - }; 62 - };
+80
Documentation/devicetree/bindings/net/brcm,mdio-mux-iproc.yaml
··· 1 + # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) 2 + %YAML 1.2 3 + --- 4 + $id: http://devicetree.org/schemas/net/brcm,mdio-mux-iproc.yaml# 5 + $schema: http://devicetree.org/meta-schemas/core.yaml# 6 + 7 + title: MDIO bus multiplexer found in Broadcom iProc based SoCs. 8 + 9 + maintainers: 10 + - Florian Fainelli <f.fainelli@gmail.com> 11 + 12 + description: 13 + This MDIO bus multiplexer defines buses that could be internal as well as 14 + external to SoCs and could accept MDIO transaction compatible to C-22 or 15 + C-45 Clause. When child bus is selected, one needs to select these two 16 + properties as well to generate desired MDIO transaction on appropriate bus. 17 + 18 + allOf: 19 + - $ref: /schemas/net/mdio-mux.yaml# 20 + 21 + properties: 22 + compatible: 23 + const: brcm,mdio-mux-iproc 24 + 25 + reg: 26 + maxItems: 1 27 + 28 + clocks: 29 + maxItems: 1 30 + description: core clock driving the MDIO block 31 + 32 + 33 + required: 34 + - compatible 35 + - reg 36 + 37 + unevaluatedProperties: false 38 + 39 + examples: 40 + - | 41 + mdio_mux_iproc: mdio-mux@66020000 { 42 + compatible = "brcm,mdio-mux-iproc"; 43 + reg = <0x66020000 0x250>; 44 + #address-cells = <1>; 45 + #size-cells = <0>; 46 + 47 + mdio@0 { 48 + reg = <0x0>; 49 + #address-cells = <1>; 50 + #size-cells = <0>; 51 + 52 + pci_phy0: pci-phy@0 { 53 + compatible = "brcm,ns2-pcie-phy"; 54 + reg = <0x0>; 55 + #phy-cells = <0>; 56 + }; 57 + }; 58 + 59 + mdio@7 { 60 + reg = <0x7>; 61 + #address-cells = <1>; 62 + #size-cells = <0>; 63 + 64 + pci_phy1: pci-phy@0 { 65 + compatible = "brcm,ns2-pcie-phy"; 66 + reg = <0x0>; 67 + #phy-cells = <0>; 68 + }; 69 + }; 70 + 71 + mdio@10 { 72 + reg = <0x10>; 73 + #address-cells = <1>; 74 + #size-cells = <0>; 75 + 76 + gphy0: eth-phy@10 { 77 + reg = <0x10>; 78 + }; 79 + }; 80 + };