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@foss.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   - |
 116     #include <dt-bindings/mfd/stm32f7-rcc.h>
 117     #include <dt-bindings/clock/stm32fx-clock.h>
 118     //Example 2 (with st,stm32f7-i2c compatible)
 119       i2c@40005800 {
 120           compatible = "st,stm32f7-i2c";
 121           #address-cells = <1>;
 122           #size-cells = <0>;
 123           reg = <0x40005800 0x400>;
 124           interrupts = <31>,
 125                        <32>;
 126           resets = <&rcc STM32F7_APB1_RESET(I2C1)>;
 127           clocks = <&rcc 1 CLK_I2C1>;
 128       };
 129
 130   - |
 131     #include <dt-bindings/mfd/stm32f7-rcc.h>
 132     #include <dt-bindings/clock/stm32fx-clock.h>
 133     //Example 3 (with st,stm32mp15-i2c compatible on stm32mp)
 134     #include <dt-bindings/interrupt-controller/arm-gic.h>
 135     #include <dt-bindings/clock/stm32mp1-clks.h>
 136     #include <dt-bindings/reset/stm32mp1-resets.h>
 137       i2c@40013000 {
 138           compatible = "st,stm32mp15-i2c";
 139           #address-cells = <1>;
 140           #size-cells = <0>;
 141           reg = <0x40013000 0x400>;
 142           interrupts = <GIC_SPI 33 IRQ_TYPE_LEVEL_HIGH>,
 143                        <GIC_SPI 34 IRQ_TYPE_LEVEL_HIGH>;
 144           clocks = <&rcc I2C2_K>;
 145           resets = <&rcc I2C2_R>;
 146           i2c-scl-rising-time-ns = <185>;
 147           i2c-scl-falling-time-ns = <20>;
 148           st,syscfg-fmp = <&syscfg 0x4 0x2>;
 149       };
 150 ...