xref: /freebsd/sys/contrib/device-tree/Bindings/phy/allwinner,sun4i-a10-usb-phy.yaml (revision cfd6422a5217410fbd66f7a7a8a64d9d85e61229) 
1# SPDX-License-Identifier: GPL-2.0
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/phy/allwinner,sun4i-a10-usb-phy.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Allwinner A10 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    enum:
19      - allwinner,sun4i-a10-usb-phy
20      - allwinner,sun7i-a20-usb-phy
21
22  reg:
23    items:
24      - description: PHY Control registers
25      - description: PHY PMU1 registers
26      - description: PHY PMU2 registers
27
28  reg-names:
29    items:
30      - const: phy_ctrl
31      - const: pmu1
32      - const: pmu2
33
34  clocks:
35    maxItems: 1
36    description: USB PHY bus clock
37
38  clock-names:
39    const: usb_phy
40
41  resets:
42    items:
43      - description: USB OTG reset
44      - description: USB Host 1 Controller reset
45      - description: USB Host 2 Controller reset
46
47  reset-names:
48    items:
49      - const: usb0_reset
50      - const: usb1_reset
51      - const: usb2_reset
52
53  usb0_id_det-gpios:
54    description: GPIO to the USB OTG ID pin
55
56  usb0_vbus_det-gpios:
57    description: GPIO to the USB OTG VBUS detect pin
58
59  usb0_vbus_power-supply:
60    description: Power supply to detect the USB OTG VBUS
61
62  usb0_vbus-supply:
63    description: Regulator controlling USB OTG VBUS
64
65  usb1_vbus-supply:
66    description: Regulator controlling USB1 Host controller
67
68  usb2_vbus-supply:
69    description: Regulator controlling USB2 Host controller
70
71required:
72  - "#phy-cells"
73  - compatible
74  - clocks
75  - clock-names
76  - reg
77  - reg-names
78  - resets
79  - reset-names
80
81additionalProperties: false
82
83examples:
84  - |
85    #include <dt-bindings/gpio/gpio.h>
86    #include <dt-bindings/clock/sun4i-a10-ccu.h>
87    #include <dt-bindings/reset/sun4i-a10-ccu.h>
88
89    usbphy: phy@1c13400 {
90        #phy-cells = <1>;
91        compatible = "allwinner,sun4i-a10-usb-phy";
92        reg = <0x01c13400 0x10>, <0x01c14800 0x4>, <0x01c1c800 0x4>;
93        reg-names = "phy_ctrl", "pmu1", "pmu2";
94        clocks = <&ccu CLK_USB_PHY>;
95        clock-names = "usb_phy";
96        resets = <&ccu RST_USB_PHY0>,
97                 <&ccu RST_USB_PHY1>,
98                 <&ccu RST_USB_PHY2>;
99        reset-names = "usb0_reset", "usb1_reset", "usb2_reset";
100        usb0_id_det-gpios = <&pio 7 19 GPIO_ACTIVE_HIGH>;
101        usb0_vbus_det-gpios = <&pio 7 22 GPIO_ACTIVE_HIGH>;
102        usb0_vbus-supply = <&reg_usb0_vbus>;
103        usb1_vbus-supply = <&reg_usb1_vbus>;
104        usb2_vbus-supply = <&reg_usb2_vbus>;
105    };
106