hc
2023-02-18 84d1d1bed0120e0921c876885ca9006fb9ddf42e
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
* Renesas R-Car USB 2.0 clock selector
 
This file provides information on what the device node for the R-Car USB 2.0
clock selector.
 
If you connect an external clock to the USB_EXTAL pin only, you should set
the clock rate to "usb_extal" node only.
If you connect an oscillator to both the USB_XTAL and USB_EXTAL, this module
is not needed because this is default setting. (Of course, you can set the
clock rates to both "usb_extal" and "usb_xtal" nodes.
 
Case 1: An external clock connects to R-Car SoC
   +----------+   +--- R-Car ---------------------+
   |External  |---|USB_EXTAL ---> all usb channels|
   |clock     |   |USB_XTAL                       |
   +----------+   +-------------------------------+
In this case, we need this driver with "usb_extal" clock.
 
Case 2: An oscillator connects to R-Car SoC
   +----------+   +--- R-Car ---------------------+
   |Oscillator|---|USB_EXTAL -+-> all usb channels|
   |          |---|USB_XTAL --+                   |
   +----------+   +-------------------------------+
In this case, we don't need this selector.
 
Required properties:
- compatible: "renesas,r8a7795-rcar-usb2-clock-sel" if the device is a part of
         an R8A7795 SoC.
         "renesas,r8a7796-rcar-usb2-clock-sel" if the device if a part of
         an R8A7796 SoC.
         "renesas,rcar-gen3-usb2-clock-sel" for a generic R-Car Gen3
         compatible device.
 
         When compatible with the generic version, nodes must list the
         SoC-specific version corresponding to the platform first
         followed by the generic version.
 
- reg: offset and length of the USB 2.0 clock selector register block.
- clocks: A list of phandles and specifier pairs.
- clock-names: Name of the clocks.
 - The functional clock must be "ehci_ohci"
 - The USB_EXTAL clock pin must be "usb_extal"
 - The USB_XTAL clock pin must be "usb_xtal"
- #clock-cells: Must be 0
 
Example (R-Car H3):
 
   usb2_clksel: clock-controller@e6590630 {
       compatible = "renesas,r8a7795-rcar-usb2-clock-sel",
                "renesas,rcar-gen3-usb2-clock-sel";
       reg = <0 0xe6590630 0 0x02>;
       clocks = <&cpg CPG_MOD 703>, <&usb_extal>, <&usb_xtal>;
       clock-names = "ehci_ohci", "usb_extal", "usb_xtal";
       #clock-cells = <0>;
   };