Documentation/devicetree/bindings/spi/st,stm32-spi.yaml

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