linux/Documentation/devicetree/bindings/phy/st,stih407-usb2-phy.yaml

# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/phy/st,stih407-usb2-phy.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: STMicroelectronics STiH407 USB PHY controller

maintainers:
  - Patrice Chotard <[email protected]>

description:
  The USB picoPHY device is the PHY for both USB2 and USB3 host controllers
  (when controlling usb2/1.1 devices) available on STiH407 SoC family from
  STMicroelectronics.

properties:
  compatible:
    const: st,stih407-usb2-phy

  st,syscfg:
    description: Phandle to the syscfg bank
    $ref: /schemas/types.yaml#/definitions/phandle-array
    items:
      - items:
          - description: phandle to syscfg
          - description: phyparam register offset
          - description: phyctrl register offset

  resets:
    items:
      - description: Phandle and reset specifier pair for the whole phy.
      - description: Phandle and reset specifier pair for the port.

  reset-names:
    items:
      - const: global
      - const: port

  "#phy-cells":
    const: 0

required:
  - compatible
  - st,syscfg
  - resets
  - reset-names
  - "#phy-cells"

additionalProperties: false

examples:
  - |
    #include <dt-bindings/reset/stih407-resets.h>
    usb-phy {
        compatible = "st,stih407-usb2-phy";
        #phy-cells = <0>;
        st,syscfg = <&syscfg_core 0x100 0xf4>;
        resets = <&softreset STIH407_PICOPHY_SOFTRESET>,
                 <&picophyreset STIH407_PICOPHY0_RESET>;
        reset-names = "global", "port";
    };
...