• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1STMicroelectronics STM32 SPI Controller
2
3The STM32 SPI controller is used to communicate with external devices using
4the Serial Peripheral Interface. It supports full-duplex, half-duplex and
5simplex synchronous serial communication with external devices. It supports
6from 4 to 32-bit data size. Although it can be configured as master or slave,
7only master is supported by the driver.
8
9Required properties:
10- compatible: Must be "st,stm32h7-spi".
11- reg: Offset and length of the device's register set.
12- interrupts: Must contain the interrupt id.
13- clocks: Must contain an entry for spiclk (which feeds the internal clock
14	  generator).
15- #address-cells:  Number of cells required to define a chip select address.
16- #size-cells: Should be zero.
17
18Optional properties:
19- resets: Must contain the phandle to the reset controller.
20- A pinctrl state named "default" may be defined to set pins in mode of
21  operation for SPI transfer.
22- dmas: DMA specifiers for tx and rx dma. DMA fifo mode must be used. See the
23  STM32 DMA bindings, Documentation/devicetree/bindings/dma/stm32-dma.txt.
24- dma-names: DMA request names should include "tx" and "rx" if present.
25- cs-gpios: list of GPIO chip selects. See the SPI bus bindings,
26  Documentation/devicetree/bindings/spi/spi-bus.txt
27
28
29Child nodes represent devices on the SPI bus
30  See ../spi/spi-bus.txt
31
32Optional properties:
33- st,spi-midi-ns: (Master Inter-Data Idleness) minimum time delay in
34		  nanoseconds inserted between two consecutive data frames.
35
36
37Example:
38	spi2: spi@40003800 {
39		#address-cells = <1>;
40		#size-cells = <0>;
41		compatible = "st,stm32h7-spi";
42		reg = <0x40003800 0x400>;
43		interrupts = <36>;
44		clocks = <&rcc SPI2_CK>;
45		resets = <&rcc 1166>;
46		dmas = <&dmamux1 0 39 0x400 0x01>,
47		       <&dmamux1 1 40 0x400 0x01>;
48		dma-names = "rx", "tx";
49		pinctrl-0 = <&spi2_pins_b>;
50		pinctrl-names = "default";
51		cs-gpios = <&gpioa 11 0>;
52
53		aardvark@0 {
54			compatible = "totalphase,aardvark";
55			reg = <0>;
56			spi-max-frequency = <4000000>;
57			st,spi-midi-ns = <4000>;
58		};
59	};
60