Commit a5aa0461 authored by Rob Herring (Arm)'s avatar Rob Herring (Arm) Committed by Vinod Koul
Browse files

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: default avatarRob Herring (Arm) <robh@kernel.org>
Reviewed-by: default avatarAndrew Lunn <andrew@lunn.ch>
Link: https://lore.kernel.org/r/20250607212541.742427-1-robh@kernel.org


Signed-off-by: default avatarVinod Koul <vkoul@kernel.org>
parent 222bb02e
Loading
Loading
Loading
Loading
+83 −0
Original line number Diff line number Diff line
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/phy/marvell,armada-380-comphy.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Marvell Armada 38x COMPHY controller

maintainers:
  - Andrew Lunn <andrew@lunn.ch>
  - Gregory Clement <gregory.clement@bootlin.com>

description:
  This comphy controller can be found on Marvell Armada 38x. It provides a
  number of shared PHYs used by various interfaces (network, sata, usb,
  PCIe...).

properties:
  compatible:
    items:
      - const: marvell,armada-380-comphy

  reg:
    items:
      - description: COMPHY register location and length
      - description: Configuration register location and length

  reg-names:
    items:
      - const: comphy
      - const: conf

  '#address-cells':
    const: 1

  '#size-cells':
    const: 0

patternProperties:
  '^phy@[0-5]$':
    description: A COMPHY lane
    type: object
    additionalProperties: false

    properties:
      reg:
        maximum: 1

      '#phy-cells':
        description: Input port index for the PHY lane
        const: 1

    required:
      - reg
      - '#phy-cells'

required:
  - compatible
  - reg
  - '#address-cells'
  - '#size-cells'

additionalProperties: false

examples:
  - |
    comphy: phy@18300 {
        compatible = "marvell,armada-380-comphy";
        reg = <0x18300 0x100>, <0x18460 4>;
        reg-names = "comphy", "conf";
        #address-cells = <1>;
        #size-cells = <0>;

        cpm_comphy0: phy@0 {
            reg = <0>;
            #phy-cells = <1>;
        };

        cpm_comphy1: phy@1 {
            reg = <1>;
            #phy-cells = <1>;
        };
    };
+0 −48
Original line number Diff line number Diff line
mvebu armada 38x comphy driver
------------------------------

This comphy controller can be found on Marvell Armada 38x. It provides a
number of shared PHYs used by various interfaces (network, sata, usb,
PCIe...).

Required properties:

- compatible: should be "marvell,armada-380-comphy"
- reg: should contain the comphy register location and length.
- #address-cells: should be 1.
- #size-cells: should be 0.

Optional properties:

- reg-names: must be "comphy" as the first name, and "conf".
- reg: must contain the comphy register location and length as the first
    pair, followed by an optional configuration register address and
    length pair.

A sub-node is required for each comphy lane provided by the comphy.

Required properties (child nodes):

- reg: comphy lane number.
- #phy-cells : from the generic phy bindings, must be 1. Defines the
               input port to use for a given comphy lane.

Example:

	comphy: phy@18300 {
		compatible = "marvell,armada-380-comphy";
		reg-names = "comphy", "conf";
		reg = <0x18300 0x100>, <0x18460 4>;
		#address-cells = <1>;
		#size-cells = <0>;

		cpm_comphy0: phy@0 {
			reg = <0>;
			#phy-cells = <1>;
		};

		cpm_comphy1: phy@1 {
			reg = <1>;
			#phy-cells = <1>;
		};
	};