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

   1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
   2 %YAML 1.2
   3 ---
   4 $id: http://devicetree.org/schemas/i2c/st,stm32-i2c.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: I2C controller embedded in STMicroelectronics STM32 I2C platform
   8
   9 maintainers:
  10   - Pierre-Yves MORDRET <pierre-yves.mordret@st.com>
  11
  12 allOf:
  13   - $ref: /schemas/i2c/i2c-controller.yaml#
  14   - if:
  15       properties:
  16         compatible:
  17           contains:
  18             enum:
  19               - st,stm32f7-i2c
  20               - st,stm32mp15-i2c
  21     then:
  22       properties:
  23         i2c-scl-rising-time-ns:
  24           default: 25
  25
  26         i2c-scl-falling-time-ns:
  27           default: 10
  28
  29         st,syscfg-fmp:
  30           description: Use to set Fast Mode Plus bit within SYSCFG when
  31                        Fast Mode Plus speed is selected by slave.
  32                        Format is phandle to syscfg / register offset within
  33                        syscfg / register bitmask for FMP bit.
  34           $ref: "/schemas/types.yaml#/definitions/phandle-array"
  35           items:
  36             minItems: 3
  37             maxItems: 3
  38
  39   - if:
  40       properties:
  41         compatible:
  42           contains:
  43             enum:
  44               - st,stm32f4-i2c
  45     then:
  46       properties:
  47         clock-frequency:
  48           enum: [100000, 400000]
  49
  50 properties:
  51   compatible:
  52     enum:
  53       - st,stm32f4-i2c
  54       - st,stm32f7-i2c
  55       - st,stm32mp15-i2c
  56
  57   reg:
  58     maxItems: 1
  59
  60   interrupts:
  61     items:
  62       - description: interrupt ID for I2C event
  63       - description: interrupt ID for I2C error
  64
  65   resets:
  66     maxItems: 1
  67
  68   clocks:
  69     maxItems: 1
  70
  71   dmas:
  72     items:
  73       - description: RX DMA Channel phandle
  74       - description: TX DMA Channel phandle
  75
  76   dma-names:
  77     items:
  78       - const: rx
  79       - const: tx
  80
  81   clock-frequency:
  82     description: Desired I2C bus clock frequency in Hz. If not specified,
  83                  the default 100 kHz frequency will be used.
  84                  For STM32F7, STM32H7 and STM32MP1 SoCs, if timing parameters
  85                  match, the bus clock frequency can be from 1Hz to 1MHz.
  86     default: 100000
  87     minimum: 1
  88     maximum: 1000000
  89
  90 required:
  91   - compatible
  92   - reg
  93   - interrupts
  94   - resets
  95   - clocks
  96
  97 unevaluatedProperties: false
  98
  99 examples:
 100   - |
 101     #include <dt-bindings/mfd/stm32f7-rcc.h>
 102     #include <dt-bindings/clock/stm32fx-clock.h>
 103     //Example 1 (with st,stm32f4-i2c compatible)
 104       i2c@40005400 {
 105           compatible = "st,stm32f4-i2c";
 106           #address-cells = <1>;
 107           #size-cells = <0>;
 108           reg = <0x40005400 0x400>;
 109           interrupts = <31>,
 110                        <32>;
 111           resets = <&rcc 277>;
 112           clocks = <&rcc 0 149>;
 113       };
 114
 115     //Example 2 (with st,stm32f7-i2c compatible)
 116       i2c@40005800 {
 117           compatible = "st,stm32f7-i2c";
 118           #address-cells = <1>;
 119           #size-cells = <0>;
 120           reg = <0x40005800 0x400>;
 121           interrupts = <31>,
 122                        <32>;
 123           resets = <&rcc STM32F7_APB1_RESET(I2C1)>;
 124           clocks = <&rcc 1 CLK_I2C1>;
 125       };
 126
 127     //Example 3 (with st,stm32mp15-i2c compatible on stm32mp)
 128     #include <dt-bindings/interrupt-controller/arm-gic.h>
 129     #include <dt-bindings/clock/stm32mp1-clks.h>
 130     #include <dt-bindings/reset/stm32mp1-resets.h>
 131       i2c@40013000 {
 132           compatible = "st,stm32mp15-i2c";
 133           #address-cells = <1>;
 134           #size-cells = <0>;
 135           reg = <0x40013000 0x400>;
 136           interrupts = <GIC_SPI 33 IRQ_TYPE_LEVEL_HIGH>,
 137                        <GIC_SPI 34 IRQ_TYPE_LEVEL_HIGH>;
 138           clocks = <&rcc I2C2_K>;
 139           resets = <&rcc I2C2_R>;
 140           i2c-scl-rising-time-ns = <185>;
 141           i2c-scl-falling-time-ns = <20>;
 142           st,syscfg-fmp = <&syscfg 0x4 0x2>;
 143       };
 144 ...