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