1 # SPDX-License-Identifier: (GPL-2.0-only OR BS 1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2 %YAML 1.2 2 %YAML 1.2
3 --- 3 ---
4 $id: http://devicetree.org/schemas/spi/st,stm3 4 $id: http://devicetree.org/schemas/spi/st,stm32-spi.yaml#
5 $schema: http://devicetree.org/meta-schemas/co 5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6 6
7 title: STMicroelectronics STM32 SPI Controller 7 title: STMicroelectronics STM32 SPI Controller
8 8
9 description: | 9 description: |
10 The STM32 SPI controller is used to communic 10 The STM32 SPI controller is used to communicate with external devices using
11 the Serial Peripheral Interface. It supports 11 the Serial Peripheral Interface. It supports full-duplex, half-duplex and
12 simplex synchronous serial communication wit 12 simplex synchronous serial communication with external devices. It supports
13 from 4 to 32-bit data size. 13 from 4 to 32-bit data size.
14 14
15 maintainers: 15 maintainers:
16 - Erwan Leray <erwan.leray@foss.st.com> 16 - Erwan Leray <erwan.leray@foss.st.com>
17 - Fabrice Gasnier <fabrice.gasnier@foss.st.co 17 - Fabrice Gasnier <fabrice.gasnier@foss.st.com>
18 18
19 allOf: 19 allOf:
20 - $ref: spi-controller.yaml# 20 - $ref: spi-controller.yaml#
21 21
22 properties: 22 properties:
23 compatible: 23 compatible:
24 enum: 24 enum:
25 - st,stm32f4-spi 25 - st,stm32f4-spi
26 - st,stm32f7-spi 26 - st,stm32f7-spi
27 - st,stm32h7-spi 27 - st,stm32h7-spi
28 - st,stm32mp25-spi 28 - st,stm32mp25-spi
29 29
30 reg: 30 reg:
31 maxItems: 1 31 maxItems: 1
32 32
33 clocks: 33 clocks:
34 maxItems: 1 34 maxItems: 1
35 35
36 interrupts: 36 interrupts:
37 maxItems: 1 37 maxItems: 1
38 38
39 resets: 39 resets:
40 maxItems: 1 40 maxItems: 1
41 41
42 dmas: 42 dmas:
43 description: | 43 description: |
44 DMA specifiers for tx and rx dma. DMA fi 44 DMA specifiers for tx and rx dma. DMA fifo mode must be used. See
45 the STM32 DMA controllers bindings Docum 45 the STM32 DMA controllers bindings Documentation/devicetree/bindings/dma/stm32/*.yaml.
46 items: 46 items:
47 - description: rx DMA channel 47 - description: rx DMA channel
48 - description: tx DMA channel 48 - description: tx DMA channel
49 49
50 dma-names: 50 dma-names:
51 items: 51 items:
52 - const: rx 52 - const: rx
53 - const: tx 53 - const: tx
54 54
55 access-controllers: 55 access-controllers:
56 minItems: 1 56 minItems: 1
57 maxItems: 2 57 maxItems: 2
58 58
59 required: 59 required:
60 - compatible 60 - compatible
61 - reg 61 - reg
62 - clocks 62 - clocks
63 - interrupts 63 - interrupts
64 64
65 unevaluatedProperties: false 65 unevaluatedProperties: false
66 66
67 examples: 67 examples:
68 - | 68 - |
69 #include <dt-bindings/interrupt-controller 69 #include <dt-bindings/interrupt-controller/arm-gic.h>
70 #include <dt-bindings/clock/stm32mp1-clks. 70 #include <dt-bindings/clock/stm32mp1-clks.h>
71 #include <dt-bindings/reset/stm32mp1-reset 71 #include <dt-bindings/reset/stm32mp1-resets.h>
72 spi@4000b000 { 72 spi@4000b000 {
73 #address-cells = <1>; 73 #address-cells = <1>;
74 #size-cells = <0>; 74 #size-cells = <0>;
75 compatible = "st,stm32h7-spi"; 75 compatible = "st,stm32h7-spi";
76 reg = <0x4000b000 0x400>; 76 reg = <0x4000b000 0x400>;
77 interrupts = <GIC_SPI 36 IRQ_TYPE_LEVE 77 interrupts = <GIC_SPI 36 IRQ_TYPE_LEVEL_HIGH>;
78 clocks = <&rcc SPI2_K>; 78 clocks = <&rcc SPI2_K>;
79 resets = <&rcc SPI2_R>; 79 resets = <&rcc SPI2_R>;
80 dmas = <&dmamux1 0 39 0x400 0x05>, 80 dmas = <&dmamux1 0 39 0x400 0x05>,
81 <&dmamux1 1 40 0x400 0x05>; 81 <&dmamux1 1 40 0x400 0x05>;
82 dma-names = "rx", "tx"; 82 dma-names = "rx", "tx";
83 cs-gpios = <&gpioa 11 0>; 83 cs-gpios = <&gpioa 11 0>;
84 }; 84 };
85 85
86 ... 86 ...
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.