xref: /freebsd/sys/contrib/device-tree/Bindings/phy/allwinner,sun8i-r40-usb-phy.yaml (revision c66ec88fed842fbaad62c30d510644ceb7bd2d71) 
1# SPDX-License-Identifier: GPL-2.0
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/phy/allwinner,sun8i-r40-usb-phy.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Allwinner R40 USB PHY Device Tree Bindings
8
9maintainers:
10  - Chen-Yu Tsai <wens@csie.org>
11  - Maxime Ripard <mripard@kernel.org>
12
13properties:
14  "#phy-cells":
15    const: 1
16
17  compatible:
18    const: allwinner,sun8i-r40-usb-phy
19
20  reg:
21    items:
22      - description: PHY Control registers
23      - description: PHY PMU0 registers
24      - description: PHY PMU1 registers
25      - description: PHY PMU2 registers
26
27  reg-names:
28    items:
29      - const: phy_ctrl
30      - const: pmu0
31      - const: pmu1
32      - const: pmu2
33
34  clocks:
35    items:
36      - description: USB OTG PHY bus clock
37      - description: USB Host 0 PHY bus clock
38      - description: USB Host 1 PHY bus clock
39
40  clock-names:
41    items:
42      - const: usb0_phy
43      - const: usb1_phy
44      - const: usb2_phy
45
46  resets:
47    items:
48      - description: USB OTG reset
49      - description: USB Host 1 Controller reset
50      - description: USB Host 2 Controller reset
51
52  reset-names:
53    items:
54      - const: usb0_reset
55      - const: usb1_reset
56      - const: usb2_reset
57
58  usb0_id_det-gpios:
59    description: GPIO to the USB OTG ID pin
60
61  usb0_vbus_det-gpios:
62    description: GPIO to the USB OTG VBUS detect pin
63
64  usb0_vbus_power-supply:
65    description: Power supply to detect the USB OTG VBUS
66
67  usb0_vbus-supply:
68    description: Regulator controlling USB OTG VBUS
69
70  usb1_vbus-supply:
71    description: Regulator controlling USB1 Host controller
72
73  usb2_vbus-supply:
74    description: Regulator controlling USB2 Host controller
75
76required:
77  - "#phy-cells"
78  - compatible
79  - clocks
80  - clock-names
81  - reg
82  - reg-names
83  - resets
84  - reset-names
85
86additionalProperties: false
87
88examples:
89  - |
90    #include <dt-bindings/gpio/gpio.h>
91    #include <dt-bindings/clock/sun8i-r40-ccu.h>
92    #include <dt-bindings/reset/sun8i-r40-ccu.h>
93
94    phy@1c13400 {
95        #phy-cells = <1>;
96        compatible = "allwinner,sun8i-r40-usb-phy";
97        reg = <0x01c13400 0x14>,
98              <0x01c14800 0x4>,
99              <0x01c19800 0x4>,
100              <0x01c1c800 0x4>;
101        reg-names = "phy_ctrl",
102                    "pmu0",
103                    "pmu1",
104                    "pmu2";
105        clocks = <&ccu CLK_USB_PHY0>,
106                 <&ccu CLK_USB_PHY1>,
107                 <&ccu CLK_USB_PHY2>;
108        clock-names = "usb0_phy",
109                      "usb1_phy",
110                      "usb2_phy";
111        resets = <&ccu RST_USB_PHY0>,
112                 <&ccu RST_USB_PHY1>,
113                 <&ccu RST_USB_PHY2>;
114        reset-names = "usb0_reset",
115                      "usb1_reset",
116                      "usb2_reset";
117        usb1_vbus-supply = <&reg_vcc5v0>;
118        usb2_vbus-supply = <&reg_vcc5v0>;
119    };
120