Merge tag 'trace-3.18' of git://git.kernel.org/pub/scm/linux/kernel/git/rostedt/linux...
[sfrench/cifs-2.6.git] / Documentation / devicetree / bindings / spi / spi-rspi.txt
1 Device tree configuration for Renesas RSPI/QSPI driver
2
3 Required properties:
4 - compatible       : For Renesas Serial Peripheral Interface on legacy SH:
5                      "renesas,rspi-<soctype>", "renesas,rspi" as fallback.
6                      For Renesas Serial Peripheral Interface on RZ/A1H:
7                      "renesas,rspi-<soctype>", "renesas,rspi-rz" as fallback.
8                      For Quad Serial Peripheral Interface on R-Car Gen2:
9                      "renesas,qspi-<soctype>", "renesas,qspi" as fallback.
10                      Examples with soctypes are:
11                         - "renesas,rspi-sh7757" (SH)
12                         - "renesas,rspi-r7s72100" (RZ/A1H)
13                         - "renesas,qspi-r8a7790" (R-Car H2)
14                         - "renesas,qspi-r8a7791" (R-Car M2-W)
15                         - "renesas,qspi-r8a7792" (R-Car V2H)
16                         - "renesas,qspi-r8a7793" (R-Car M2-N)
17                         - "renesas,qspi-r8a7794" (R-Car E2)
18 - reg              : Address start and address range size of the device
19 - interrupts       : A list of interrupt-specifiers, one for each entry in
20                      interrupt-names.
21                      If interrupt-names is not present, an interrupt specifier
22                      for a single muxed interrupt.
23 - interrupt-names  : A list of interrupt names. Should contain (if present):
24                        - "error" for SPEI,
25                        - "rx" for SPRI,
26                        - "tx" to SPTI,
27                        - "mux" for a single muxed interrupt.
28 - interrupt-parent : The phandle for the interrupt controller that
29                      services interrupts for this device.
30 - num-cs           : Number of chip selects. Some RSPI cores have more than 1.
31 - #address-cells   : Must be <1>
32 - #size-cells      : Must be <0>
33
34 Optional properties:
35 - clocks           : Must contain a reference to the functional clock.
36 - dmas             : Must contain a list of two references to DMA specifiers,
37                      one for transmission, and one for reception.
38 - dma-names        : Must contain a list of two DMA names, "tx" and "rx".
39
40 Pinctrl properties might be needed, too.  See
41 Documentation/devicetree/bindings/pinctrl/renesas,*.
42
43 Examples:
44
45         spi0: spi@e800c800 {
46                 compatible = "renesas,rspi-r7s72100", "renesas,rspi-rz";
47                 reg = <0xe800c800 0x24>;
48                 interrupts = <0 238 IRQ_TYPE_LEVEL_HIGH>,
49                              <0 239 IRQ_TYPE_LEVEL_HIGH>,
50                              <0 240 IRQ_TYPE_LEVEL_HIGH>;
51                 interrupt-names = "error", "rx", "tx";
52                 interrupt-parent = <&gic>;
53                 num-cs = <1>;
54                 #address-cells = <1>;
55                 #size-cells = <0>;
56         };
57
58         spi: spi@e6b10000 {
59                 compatible = "renesas,qspi-r8a7791", "renesas,qspi";
60                 reg = <0 0xe6b10000 0 0x2c>;
61                 interrupt-parent = <&gic>;
62                 interrupts = <0 184 IRQ_TYPE_LEVEL_HIGH>;
63                 clocks = <&mstp9_clks R8A7791_CLK_QSPI_MOD>;
64                 num-cs = <1>;
65                 #address-cells = <1>;
66                 #size-cells = <0>;
67                 dmas = <&dmac0 0x17>, <&dmac0 0x18>;
68                 dma-names = "tx", "rx";
69         };