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

# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/i2c/st,sti-i2c.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: I2C controller embedded in STMicroelectronics STi platform

maintainers:
  - Patrice Chotard <patrice.chotard@foss.st.com>

allOf:
  - $ref: /schemas/i2c/i2c-controller.yaml#

properties:
  compatible:
    enum:
      - st,comms-ssc-i2c
      - st,comms-ssc4-i2c

  reg:
    maxItems: 1

  interrupts:
    maxItems: 1

  clocks:
    maxItems: 1

  clock-names:
    maxItems: 1

  clock-frequency:
    enum: [ 100000, 400000 ]
    default: 100000

  st,i2c-min-scl-pulse-width-us:
    description:
      The minimum valid SCL pulse width that is allowed through the
      deglitch circuit. In units of us.

  st,i2c-min-sda-pulse-width-us:
    description:
      The minimum valid SDA pulse width that is allowed through the
      deglitch circuit. In units of us.

required:
  - compatible
  - reg
  - interrupts
  - clocks
  - clock-names

unevaluatedProperties: false

examples:
  - |
    #include <dt-bindings/interrupt-controller/arm-gic.h>
    #include <dt-bindings/clock/stih407-clks.h>
    i2c@fed40000 {
        compatible = "st,comms-ssc4-i2c";
        reg = <0xfed40000 0x110>;
        interrupts =  <GIC_SPI 187 IRQ_TYPE_LEVEL_HIGH>;
        clocks = <&clk_s_a0_ls CLK_ICN_REG>;
        clock-names = "ssc";
        clock-frequency = <400000>;
        pinctrl-names = "default";
        pinctrl-0 = <&pinctrl_i2c0_default>;
        st,i2c-min-scl-pulse-width-us = <0>;
        st,i2c-min-sda-pulse-width-us = <5>;
    };