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 - interrupt-parent : The phandle for the interrupt controller that
  32                      services interrupts for this device.
  33 - num-cs           : Number of chip selects. Some RSPI cores have more than 1.
  34 - #address-cells   : Must be <1>
  35 - #size-cells      : Must be <0>
  36
  37 Optional properties:
  38 - clocks           : Must contain a reference to the functional clock.
  39 - dmas             : Must contain a list of two references to DMA specifiers,
  40                      one for transmission, and one for reception.
  41 - dma-names        : Must contain a list of two DMA names, "tx" and "rx".
  42
  43 Pinctrl properties might be needed, too.  See
  44 Documentation/devicetree/bindings/pinctrl/renesas,*.
  45
  46 Examples:
  47
  48         spi0: spi@e800c800 {
  49                 compatible = "renesas,rspi-r7s72100", "renesas,rspi-rz";
  50                 reg = <0xe800c800 0x24>;
  51                 interrupts = <0 238 IRQ_TYPE_LEVEL_HIGH>,
  52                              <0 239 IRQ_TYPE_LEVEL_HIGH>,
  53                              <0 240 IRQ_TYPE_LEVEL_HIGH>;
  54                 interrupt-names = "error", "rx", "tx";
  55                 interrupt-parent = <&gic>;
  56                 num-cs = <1>;
  57                 #address-cells = <1>;
  58                 #size-cells = <0>;
  59         };
  60
  61         spi: spi@e6b10000 {
  62                 compatible = "renesas,qspi-r8a7791", "renesas,qspi";
  63                 reg = <0 0xe6b10000 0 0x2c>;
  64                 interrupt-parent = <&gic>;
  65                 interrupts = <0 184 IRQ_TYPE_LEVEL_HIGH>;
  66                 clocks = <&mstp9_clks R8A7791_CLK_QSPI_MOD>;
  67                 num-cs = <1>;
  68                 #address-cells = <1>;
  69                 #size-cells = <0>;
  70                 dmas = <&dmac0 0x17>, <&dmac0 0x18>;
  71                 dma-names = "tx", "rx";
  72         };