summaryrefslogtreecommitdiffstats
path: root/Documentation/devicetree/bindings/spi/spi-rspi.txt
blob: f9929aceeaccbef13107a39166983e129a913a10 (plain)
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
56
57
58
59
60
61
62
63
64
65
66
Device tree configuration for Renesas RSPI/QSPI driver

Required properties:
- compatible       : For Renesas Serial Peripheral Interface on legacy SH:
		     "renesas,rspi-<soctype>", "renesas,rspi" as fallback.
		     For Renesas Serial Peripheral Interface on RZ/A1H:
		     "renesas,rspi-<soctype>", "renesas,rspi-rz" as fallback.
		     For Quad Serial Peripheral Interface on R-Car Gen2:
		     "renesas,qspi-<soctype>", "renesas,qspi" as fallback.
		     Examples with soctypes are:
		        - "renesas,rspi-sh7757" (SH)
			- "renesas,rspi-r7s72100" (RZ/A1H)
			- "renesas,qspi-r8a7790" (R-Car H2)
			- "renesas,qspi-r8a7791" (R-Car M2)
- reg              : Address start and address range size of the device
- interrupts       : A list of interrupt-specifiers, one for each entry in
		     interrupt-names.
		     If interrupt-names is not present, an interrupt specifier
		     for a single muxed interrupt.
- interrupt-names  : A list of interrupt names. Should contain (if present):
		       - "error" for SPEI,
		       - "rx" for SPRI,
		       - "tx" to SPTI,
		       - "mux" for a single muxed interrupt.
- interrupt-parent : The phandle for the interrupt controller that
		     services interrupts for this device.
- num-cs	   : Number of chip selects. Some RSPI cores have more than 1.
- #address-cells   : Must be <1>
- #size-cells      : Must be <0>

Optional properties:
- clocks           : Must contain a reference to the functional clock.
- dmas             : Must contain a list of two references to DMA specifiers,
		     one for transmission, and one for reception.
- dma-names        : Must contain a list of two DMA names, "tx" and "rx".

Pinctrl properties might be needed, too.  See
Documentation/devicetree/bindings/pinctrl/renesas,*.

Examples:

	spi0: spi@e800c800 {
		compatible = "renesas,rspi-r7s72100", "renesas,rspi-rz";
		reg = <0xe800c800 0x24>;
		interrupts = <0 238 IRQ_TYPE_LEVEL_HIGH>,
			     <0 239 IRQ_TYPE_LEVEL_HIGH>,
			     <0 240 IRQ_TYPE_LEVEL_HIGH>;
		interrupt-names = "error", "rx", "tx";
		interrupt-parent = <&gic>;
		num-cs = <1>;
		#address-cells = <1>;
		#size-cells = <0>;
	};

	spi: spi@e6b10000 {
		compatible = "renesas,qspi-r8a7791", "renesas,qspi";
		reg = <0 0xe6b10000 0 0x2c>;
		interrupt-parent = <&gic>;
		interrupts = <0 184 IRQ_TYPE_LEVEL_HIGH>;
		clocks = <&mstp9_clks R8A7791_CLK_QSPI_MOD>;
		num-cs = <1>;
		#address-cells = <1>;
		#size-cells = <0>;
		dmas = <&dmac0 0x17>, <&dmac0 0x18>;
		dma-names = "tx", "rx";
	};