summaryrefslogtreecommitdiff
path: root/Documentation/devicetree/bindings/usb/google,lga-dwc3.yaml
blob: 95be84c843f5da0e80ef5ef1ac9193019b5eb2a0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
# Copyright (c) 2025, Google LLC
%YAML 1.2
---
$id: http://devicetree.org/schemas/usb/google,lga-dwc3.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Google Tensor Series G5 (Laguna) DWC3 USB SoC Controller

maintainers:
  - Roy Luo <royluo@google.com>

description:
  Describes the DWC3 USB controller block implemented on Google Tensor SoCs,
  starting with the G5 generation (laguna). Based on Synopsys DWC3 IP, the
  controller features Dual-Role Device single port with hibernation add-on.

properties:
  compatible:
    const: google,lga-dwc3

  reg:
    items:
      - description: Core DWC3 IP registers.

  interrupts:
    items:
      - description: Core DWC3 interrupt.
      - description: High speed power management event for remote wakeup.
      - description: Super speed power management event for remote wakeup.

  interrupt-names:
    items:
      - const: core
      - const: hs_pme
      - const: ss_pme

  clocks:
    items:
      - description: Non-sticky module clock.
      - description: Sticky module clock.

  clock-names:
    items:
      - const: non_sticky
      - const: sticky

  resets:
    items:
      - description: Non-sticky module reset.
      - description: Sticky module reset.
      - description: DRD bus reset.
      - description: Top-level reset.

  reset-names:
    items:
      - const: non_sticky
      - const: sticky
      - const: drd_bus
      - const: top

  power-domains:
    items:
      - description: Power switchable domain, the child of top domain.
          Turning it on puts the controller into full power state,
          turning it off puts the controller into power gated state.
      - description: Top domain, the parent of power switchable domain.
          Turning it on puts the controller into power gated state,
          turning it off completely shuts off the controller.

  power-domain-names:
    items:
      - const: psw
      - const: top

  iommus:
    maxItems: 1

  google,usb-cfg-csr:
    description:
      A phandle to a syscon node used to access the USB configuration
      registers. These registers are the top-level wrapper of the USB
      subsystem and provide control and status for the integrated USB
      controller and USB PHY.
    $ref: /schemas/types.yaml#/definitions/phandle-array
    items:
      - items:
          - description: phandle to the syscon node.
          - description: USB host controller configuration register offset.
          - description: USB custom interrrupts control register offset.

required:
  - compatible
  - reg
  - interrupts
  - interrupt-names
  - clocks
  - clock-names
  - resets
  - reset-names
  - power-domains
  - power-domain-names
  - google,usb-cfg-csr

allOf:
  - $ref: snps,dwc3-common.yaml#

unevaluatedProperties: false

examples:
  - |
    #include <dt-bindings/interrupt-controller/arm-gic.h>
    #include <dt-bindings/interrupt-controller/irq.h>
    soc {
        #address-cells = <2>;
        #size-cells = <2>;

        usb@c400000 {
            compatible = "google,lga-dwc3";
            reg = <0 0x0c400000  0 0xd060>;
            interrupts = <GIC_SPI 580 IRQ_TYPE_LEVEL_HIGH 0>,
                         <GIC_SPI 597 IRQ_TYPE_LEVEL_HIGH 0>,
                         <GIC_SPI 598 IRQ_TYPE_LEVEL_HIGH 0>;
            interrupt-names = "core", "hs_pme", "ss_pme";
            clocks = <&hsion_usbc_non_sticky_clk>,  <&hsion_usbc_sticky_clk>;
            clock-names = "non_sticky", "sticky";
            resets = <&hsion_resets_usbc_non_sticky>, <&hsion_resets_usbc_sticky>,
                     <&hsion_resets_usb_drd_bus>, <&hsion_resets_usb_top>;
            reset-names = "non_sticky", "sticky", "drd_bus", "top";
            power-domains = <&hsio_n_usb_psw>, <&hsio_n_usb>;
            power-domain-names = "psw", "top";
            phys = <&usb_phy 0>;
            phy-names = "usb2-phy";
            snps,quirk-frame-length-adjustment = <0x20>;
            snps,gfladj-refclk-lpm-sel-quirk;
            snps,incr-burst-type-adjustment = <4>;
            google,usb-cfg-csr = <&usb_cfg_csr 0x0 0x20>;
        };
    };
...