xref: /linux/Documentation/devicetree/bindings/phy/ti,control-phy-otghs.yaml (revision 1fd1dc41724319406b0aff221a352a400b0ddfc5) 
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/phy/ti,control-phy-otghs.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: TI OMAP Control PHY Module
8
9maintainers:
10  - Roger Quadros <rogerq@ti.com>
11
12description:
13  The TI OMAP Control PHY module is a hardware block within the system
14  control module (SCM) of Texas Instruments OMAP SoCs. It provides
15  centralized control over power, configuration, and auxiliary features
16  for multiple on-chip PHYs. This module is essential for proper PHY
17  operation in power-constrained embedded systems.
18
19properties:
20  $nodename:
21    pattern: "^phy@[0-9a-f]+$"
22
23  compatible:
24    enum:
25      - ti,control-phy-otghs
26      - ti,control-phy-pcie
27      - ti,control-phy-pipe3
28      - ti,control-phy-usb2
29      - ti,control-phy-usb2-am437
30      - ti,control-phy-usb2-dra7
31
32  reg:
33    minItems: 1
34    maxItems: 3
35
36  reg-names:
37    minItems: 1
38    maxItems: 3
39    items:
40      enum: [otghs_control, power, pcie_pcs, control_sma]
41
42allOf:
43  - if:
44      properties:
45        compatible:
46          contains:
47            enum:
48              - ti,control-phy-otghs
49    then:
50      properties:
51        reg-names:
52          const: otghs_control
53
54  - if:
55      properties:
56        compatible:
57          contains:
58            enum:
59              - ti,control-phy-pcie
60    then:
61      properties:
62        reg:
63          minItems: 3
64
65        reg-names:
66          items:
67            - const: power
68            - const: pcie_pcs
69            - const: control_sma
70
71  - if:
72      properties:
73        compatible:
74          contains:
75            enum:
76              - ti,control-phy-usb2
77              - ti,control-phy-usb2-dra7
78              - ti,control-phy-usb2-am437
79              - ti,control-phy-pipe3
80    then:
81      properties:
82        reg-names:
83          const: power
84
85required:
86  - reg
87  - compatible
88  - reg-names
89
90unevaluatedProperties: false
91
92examples:
93  - |
94    phy@4a00233c {
95        compatible = "ti,control-phy-otghs";
96        reg = <0x4a00233c 0x4>;
97        reg-names = "otghs_control";
98    };
99...
100