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

dt-bindings: phy: Convert marvell,armada-380-comphy to DT schema

Convert the Marvell Armada 38x combo PHY binding to DT schema format.
It's a straight forward conversion.

Signed-off-by: Rob Herring (Arm) <robh@kernel.org>
Reviewed-by: Andrew Lunn <andrew@lunn.ch>
Link: https://lore.kernel.org/r/20250607212541.742427-1-robh@kernel.org
Signed-off-by: Vinod Koul <vkoul@kernel.org>

authored by

Rob Herring (Arm) and committed by
Vinod Koul
a5aa0461 222bb02e

+83 -48
+83
Documentation/devicetree/bindings/phy/marvell,armada-380-comphy.yaml
··· 1 + # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) 2 + %YAML 1.2 3 + --- 4 + $id: http://devicetree.org/schemas/phy/marvell,armada-380-comphy.yaml# 5 + $schema: http://devicetree.org/meta-schemas/core.yaml# 6 + 7 + title: Marvell Armada 38x COMPHY controller 8 + 9 + maintainers: 10 + - Andrew Lunn <andrew@lunn.ch> 11 + - Gregory Clement <gregory.clement@bootlin.com> 12 + 13 + description: 14 + This comphy controller can be found on Marvell Armada 38x. It provides a 15 + number of shared PHYs used by various interfaces (network, sata, usb, 16 + PCIe...). 17 + 18 + properties: 19 + compatible: 20 + items: 21 + - const: marvell,armada-380-comphy 22 + 23 + reg: 24 + items: 25 + - description: COMPHY register location and length 26 + - description: Configuration register location and length 27 + 28 + reg-names: 29 + items: 30 + - const: comphy 31 + - const: conf 32 + 33 + '#address-cells': 34 + const: 1 35 + 36 + '#size-cells': 37 + const: 0 38 + 39 + patternProperties: 40 + '^phy@[0-5]$': 41 + description: A COMPHY lane 42 + type: object 43 + additionalProperties: false 44 + 45 + properties: 46 + reg: 47 + maximum: 1 48 + 49 + '#phy-cells': 50 + description: Input port index for the PHY lane 51 + const: 1 52 + 53 + required: 54 + - reg 55 + - '#phy-cells' 56 + 57 + required: 58 + - compatible 59 + - reg 60 + - '#address-cells' 61 + - '#size-cells' 62 + 63 + additionalProperties: false 64 + 65 + examples: 66 + - | 67 + comphy: phy@18300 { 68 + compatible = "marvell,armada-380-comphy"; 69 + reg = <0x18300 0x100>, <0x18460 4>; 70 + reg-names = "comphy", "conf"; 71 + #address-cells = <1>; 72 + #size-cells = <0>; 73 + 74 + cpm_comphy0: phy@0 { 75 + reg = <0>; 76 + #phy-cells = <1>; 77 + }; 78 + 79 + cpm_comphy1: phy@1 { 80 + reg = <1>; 81 + #phy-cells = <1>; 82 + }; 83 + };
-48
Documentation/devicetree/bindings/phy/phy-armada38x-comphy.txt
··· 1 - mvebu armada 38x comphy driver 2 - ------------------------------ 3 - 4 - This comphy controller can be found on Marvell Armada 38x. It provides a 5 - number of shared PHYs used by various interfaces (network, sata, usb, 6 - PCIe...). 7 - 8 - Required properties: 9 - 10 - - compatible: should be "marvell,armada-380-comphy" 11 - - reg: should contain the comphy register location and length. 12 - - #address-cells: should be 1. 13 - - #size-cells: should be 0. 14 - 15 - Optional properties: 16 - 17 - - reg-names: must be "comphy" as the first name, and "conf". 18 - - reg: must contain the comphy register location and length as the first 19 - pair, followed by an optional configuration register address and 20 - length pair. 21 - 22 - A sub-node is required for each comphy lane provided by the comphy. 23 - 24 - Required properties (child nodes): 25 - 26 - - reg: comphy lane number. 27 - - #phy-cells : from the generic phy bindings, must be 1. Defines the 28 - input port to use for a given comphy lane. 29 - 30 - Example: 31 - 32 - comphy: phy@18300 { 33 - compatible = "marvell,armada-380-comphy"; 34 - reg-names = "comphy", "conf"; 35 - reg = <0x18300 0x100>, <0x18460 4>; 36 - #address-cells = <1>; 37 - #size-cells = <0>; 38 - 39 - cpm_comphy0: phy@0 { 40 - reg = <0>; 41 - #phy-cells = <1>; 42 - }; 43 - 44 - cpm_comphy1: phy@1 { 45 - reg = <1>; 46 - #phy-cells = <1>; 47 - }; 48 - };