xref: /freebsd/sys/contrib/device-tree/Bindings/usb/mediatek,musb.yaml (revision c9ccf3a32da427475985b85d7df023ccfb138c27) 
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2# Copyright (c) 2020 MediaTek
3%YAML 1.2
4---
5$id: http://devicetree.org/schemas/usb/mediatek,musb.yaml#
6$schema: http://devicetree.org/meta-schemas/core.yaml#
7
8title: MediaTek MUSB DRD/OTG Controller Device Tree Bindings
9
10maintainers:
11  - Min Guo <min.guo@mediatek.com>
12
13properties:
14  $nodename:
15    pattern: '^usb@[0-9a-f]+$'
16
17  compatible:
18    items:
19      - enum:
20          - mediatek,mt8516-musb
21          - mediatek,mt2701-musb
22          - mediatek,mt7623-musb
23      - const: mediatek,mtk-musb
24
25  reg:
26    maxItems: 1
27
28  interrupts:
29    maxItems: 1
30
31  interrupt-names:
32    items:
33      - const: mc
34
35  clocks:
36    items:
37      - description: The main/core clock
38      - description: The system bus clock
39      - description: The 48Mhz clock
40
41  clock-names:
42    items:
43      - const: main
44      - const: mcu
45      - const: univpll
46
47  phys:
48    maxItems: 1
49
50  usb-role-switch:
51    $ref: /schemas/types.yaml#/definitions/flag
52    description: Support role switch. See usb/generic.txt
53    type: boolean
54
55  dr_mode:
56    enum:
57      - host
58      - otg
59      - peripheral
60
61  power-domains:
62    description: A phandle to USB power domain node to control USB's MTCMOS
63    maxItems: 1
64
65  connector:
66    $ref: /schemas/connector/usb-connector.yaml#
67    description: Connector for dual role switch
68    type: object
69
70dependencies:
71  usb-role-switch: [ 'connector' ]
72  connector: [ 'usb-role-switch' ]
73
74required:
75  - compatible
76  - reg
77  - interrupts
78  - interrupt-names
79  - phys
80  - clocks
81  - clock-names
82
83additionalProperties: false
84
85examples:
86  - |
87    #include <dt-bindings/clock/mt2701-clk.h>
88    #include <dt-bindings/gpio/gpio.h>
89    #include <dt-bindings/interrupt-controller/arm-gic.h>
90    #include <dt-bindings/interrupt-controller/irq.h>
91    #include <dt-bindings/phy/phy.h>
92    #include <dt-bindings/power/mt2701-power.h>
93
94    usb@11200000 {
95        compatible = "mediatek,mt2701-musb", "mediatek,mtk-musb";
96        reg = <0x11200000 0x1000>;
97        interrupts = <GIC_SPI 32 IRQ_TYPE_LEVEL_LOW>;
98        interrupt-names = "mc";
99        phys = <&u2port2 PHY_TYPE_USB2>;
100        dr_mode = "otg";
101        clocks = <&pericfg CLK_PERI_USB0>,
102                 <&pericfg CLK_PERI_USB0_MCU>,
103                 <&pericfg CLK_PERI_USB_SLV>;
104        clock-names = "main","mcu","univpll";
105        power-domains = <&scpsys MT2701_POWER_DOMAIN_IFR_MSC>;
106        usb-role-switch;
107
108        connector {
109            compatible = "gpio-usb-b-connector", "usb-b-connector";
110            type = "micro";
111            id-gpios = <&pio 44 GPIO_ACTIVE_HIGH>;
112            vbus-supply = <&usb_vbus>;
113        };
114    };
115...
116