linux/Documentation/devicetree/bindings/clock/sunxi.txt
<<
>>
Prefs
   1Device Tree Clock bindings for arch-sunxi
   2
   3This binding uses the common clock binding[1].
   4
   5[1] Documentation/devicetree/bindings/clock/clock-bindings.txt
   6
   7Required properties:
   8- compatible : shall be one of the following:
   9        "allwinner,sun4i-osc-clk" - for a gatable oscillator
  10        "allwinner,sun4i-pll1-clk" - for the main PLL clock
  11        "allwinner,sun4i-cpu-clk" - for the CPU multiplexer clock
  12        "allwinner,sun4i-axi-clk" - for the AXI clock
  13        "allwinner,sun4i-axi-gates-clk" - for the AXI gates
  14        "allwinner,sun4i-ahb-clk" - for the AHB clock
  15        "allwinner,sun4i-ahb-gates-clk" - for the AHB gates
  16        "allwinner,sun4i-apb0-clk" - for the APB0 clock
  17        "allwinner,sun4i-apb0-gates-clk" - for the APB0 gates
  18        "allwinner,sun4i-apb1-clk" - for the APB1 clock
  19        "allwinner,sun4i-apb1-mux-clk" - for the APB1 clock muxing
  20        "allwinner,sun4i-apb1-gates-clk" - for the APB1 gates
  21
  22Required properties for all clocks:
  23- reg : shall be the control register address for the clock.
  24- clocks : shall be the input parent clock(s) phandle for the clock
  25- #clock-cells : from common clock binding; shall be set to 0 except for
  26        "allwinner,sun4i-*-gates-clk" where it shall be set to 1
  27
  28Additionally, "allwinner,sun4i-*-gates-clk" clocks require:
  29- clock-output-names : the corresponding gate names that the clock controls
  30
  31For example:
  32
  33osc24M: osc24M@01c20050 {
  34        #clock-cells = <0>;
  35        compatible = "allwinner,sun4i-osc-clk";
  36        reg = <0x01c20050 0x4>;
  37        clocks = <&osc24M_fixed>;
  38};
  39
  40pll1: pll1@01c20000 {
  41        #clock-cells = <0>;
  42        compatible = "allwinner,sun4i-pll1-clk";
  43        reg = <0x01c20000 0x4>;
  44        clocks = <&osc24M>;
  45};
  46
  47cpu: cpu@01c20054 {
  48        #clock-cells = <0>;
  49        compatible = "allwinner,sun4i-cpu-clk";
  50        reg = <0x01c20054 0x4>;
  51        clocks = <&osc32k>, <&osc24M>, <&pll1>;
  52};
  53
  54
  55
  56Gate clock outputs
  57
  58The "allwinner,sun4i-*-gates-clk" clocks provide several gatable outputs;
  59their corresponding offsets as present on sun4i are listed below. Note that
  60some of these gates are not present on sun5i.
  61
  62  * AXI gates ("allwinner,sun4i-axi-gates-clk")
  63
  64    DRAM                                                                0
  65
  66  * AHB gates ("allwinner,sun4i-ahb-gates-clk")
  67
  68    USB0                                                                0
  69    EHCI0                                                               1
  70    OHCI0                                                               2*
  71    EHCI1                                                               3
  72    OHCI1                                                               4*
  73    SS                                                                  5
  74    DMA                                                                 6
  75    BIST                                                                7
  76    MMC0                                                                8
  77    MMC1                                                                9
  78    MMC2                                                                10
  79    MMC3                                                                11
  80    MS                                                                  12**
  81    NAND                                                                13
  82    SDRAM                                                               14
  83
  84    ACE                                                                 16
  85    EMAC                                                                17
  86    TS                                                                  18
  87
  88    SPI0                                                                20
  89    SPI1                                                                21
  90    SPI2                                                                22
  91    SPI3                                                                23
  92    PATA                                                                24
  93    SATA                                                                25**
  94    GPS                                                                 26*
  95
  96    VE                                                                  32
  97    TVD                                                                 33
  98    TVE0                                                                34
  99    TVE1                                                                35
 100    LCD0                                                                36
 101    LCD1                                                                37
 102
 103    CSI0                                                                40
 104    CSI1                                                                41
 105
 106    HDMI                                                                43
 107    DE_BE0                                                              44
 108    DE_BE1                                                              45
 109    DE_FE0                                                              46
 110    DE_FE1                                                              47
 111
 112    MP                                                                  50
 113
 114    MALI400                                                             52
 115
 116  * APB0 gates ("allwinner,sun4i-apb0-gates-clk")
 117
 118    CODEC                                                               0
 119    SPDIF                                                               1*
 120    AC97                                                                2
 121    IIS                                                                 3
 122
 123    PIO                                                                 5
 124    IR0                                                                 6
 125    IR1                                                                 7
 126
 127    KEYPAD                                                              10
 128
 129  * APB1 gates ("allwinner,sun4i-apb1-gates-clk")
 130
 131    I2C0                                                                0
 132    I2C1                                                                1
 133    I2C2                                                                2
 134
 135    CAN                                                                 4
 136    SCR                                                                 5
 137    PS20                                                                6
 138    PS21                                                                7
 139
 140    UART0                                                               16
 141    UART1                                                               17
 142    UART2                                                               18
 143    UART3                                                               19
 144    UART4                                                               20
 145    UART5                                                               21
 146    UART6                                                               22
 147    UART7                                                               23
 148
 149Notation:
 150 [*]:  The datasheet didn't mention these, but they are present on AW code
 151 [**]: The datasheet had this marked as "NC" but they are used on AW code
 152