dt-binding: phy: convert ti,omap-usb2 to YAML

# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)

%YAML 1.2

---

$id: http://devicetree.org/schemas/phy/ti,omap-usb2.yaml#

$schema: http://devicetree.org/meta-schemas/core.yaml#

title: OMAP USB2 PHY

maintainers:

 - Kishon Vijay Abraham I <kishon@ti.com>

 - Roger Quadros <rogerq@ti.com>

properties:

  compatible:

    oneOf:

      - items:

        - enum:

          - ti,dra7x-usb2

          - ti,dra7x-usb2-phy2

          - ti,am654-usb2

        - enum:

          - ti,omap-usb2

      - items:

        - const: ti,am437x-usb2

      - items:

        - const: ti,omap-usb2

  reg:

    maxItems: 1

  "#phy-cells":

    const: 0

  clocks:

    minItems: 1

    items:

      - description: wakeup clock

      - description: reference clock

  clock-names:

    minItems: 1

    items:

      - const: wkupclk

      - const: refclk

  syscon-phy-power:

    $ref: /schemas/types.yaml#definitions/phandle-array

    description:

      phandle/offset pair. Phandle to the system control module and

      register offset to power on/off the PHY.

  ctrl-module:

    $ref: /schemas/types.yaml#definitions/phandle

    description:

      (deprecated) phandle of the control module used by PHY driver

      to power on the PHY. Use syscon-phy-power instead.

required:

  - compatible

  - reg

  - "#phy-cells"

  - clocks

  - clock-names

examples:

  - |

    usb0_phy: phy@4100000 {

      compatible = "ti,am654-usb2", "ti,omap-usb2";

      reg = <0x4100000 0x54>;

      syscon-phy-power = <&scm_conf 0x4000>;

      clocks = <&k3_clks 151 0>, <&k3_clks 151 1>;

      clock-names = "wkupclk", "refclk";

      #phy-cells = <0>;

    };

        reg-names = "otghs_control";

};

OMAP USB2 PHY

Required properties:

 - compatible: Should be "ti,omap-usb2"

	       Should be "ti,dra7x-usb2" for the 1st instance of USB2 PHY on

	       DRA7x

	       Should be "ti,dra7x-usb2-phy2" for the 2nd instance of USB2 PHY

	       in DRA7x

	       Should be "ti,am654-usb2" for the USB2 PHYs on AM654.

 - reg : Address and length of the register set for the device.

 - #phy-cells: determine the number of cells that should be given in the

   phandle while referencing this phy.

 - clocks: a list of phandles and clock-specifier pairs, one for each entry in

   clock-names.

 - clock-names: should include:

   * "wkupclk" - wakeup clock.

   * "refclk" - reference clock (optional).

Deprecated properties:

 - ctrl-module : phandle of the control module used by PHY driver to power on

   the PHY.

Recommended properies:

- syscon-phy-power : phandle/offset pair. Phandle to the system control

  module and the register offset to power on/off the PHY.

This is usually a subnode of ocp2scp to which it is connected.

usb2phy@4a0ad080 {

	compatible = "ti,omap-usb2";

	reg = <0x4a0ad080 0x58>;

	ctrl-module = <&omap_control_usb>;

	#phy-cells = <0>;

	clocks = <&usb_phy_cm_clk32k>, <&usb_otg_ss_refclk960m>;

	clock-names = "wkupclk", "refclk";

};

TI PIPE3 PHY

Required properties: