xref: /linux/Documentation/devicetree/bindings/i2c/st,sti-i2c.yaml (revision 9a87ffc99ec8eb8d35eed7c4f816d75f5cc9662e)
1*b3de755dSAlain Volmat# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2*b3de755dSAlain Volmat%YAML 1.2
3*b3de755dSAlain Volmat---
4*b3de755dSAlain Volmat$id: http://devicetree.org/schemas/i2c/st,sti-i2c.yaml#
5*b3de755dSAlain Volmat$schema: http://devicetree.org/meta-schemas/core.yaml#
6*b3de755dSAlain Volmat
7*b3de755dSAlain Volmattitle: I2C controller embedded in STMicroelectronics STi platform
8*b3de755dSAlain Volmat
9*b3de755dSAlain Volmatmaintainers:
10*b3de755dSAlain Volmat  - Patrice Chotard <patrice.chotard@foss.st.com>
11*b3de755dSAlain Volmat
12*b3de755dSAlain VolmatallOf:
13*b3de755dSAlain Volmat  - $ref: /schemas/i2c/i2c-controller.yaml#
14*b3de755dSAlain Volmat
15*b3de755dSAlain Volmatproperties:
16*b3de755dSAlain Volmat  compatible:
17*b3de755dSAlain Volmat    enum:
18*b3de755dSAlain Volmat      - st,comms-ssc-i2c
19*b3de755dSAlain Volmat      - st,comms-ssc4-i2c
20*b3de755dSAlain Volmat
21*b3de755dSAlain Volmat  reg:
22*b3de755dSAlain Volmat    maxItems: 1
23*b3de755dSAlain Volmat
24*b3de755dSAlain Volmat  interrupts:
25*b3de755dSAlain Volmat    maxItems: 1
26*b3de755dSAlain Volmat
27*b3de755dSAlain Volmat  clocks:
28*b3de755dSAlain Volmat    maxItems: 1
29*b3de755dSAlain Volmat
30*b3de755dSAlain Volmat  clock-names:
31*b3de755dSAlain Volmat    maxItems: 1
32*b3de755dSAlain Volmat
33*b3de755dSAlain Volmat  clock-frequency:
34*b3de755dSAlain Volmat    enum: [ 100000, 400000 ]
35*b3de755dSAlain Volmat    default: 100000
36*b3de755dSAlain Volmat
37*b3de755dSAlain Volmat  st,i2c-min-scl-pulse-width-us:
38*b3de755dSAlain Volmat    description:
39*b3de755dSAlain Volmat      The minimum valid SCL pulse width that is allowed through the
40*b3de755dSAlain Volmat      deglitch circuit. In units of us.
41*b3de755dSAlain Volmat
42*b3de755dSAlain Volmat  st,i2c-min-sda-pulse-width-us:
43*b3de755dSAlain Volmat    description:
44*b3de755dSAlain Volmat      The minimum valid SDA pulse width that is allowed through the
45*b3de755dSAlain Volmat      deglitch circuit. In units of us.
46*b3de755dSAlain Volmat
47*b3de755dSAlain Volmatrequired:
48*b3de755dSAlain Volmat  - compatible
49*b3de755dSAlain Volmat  - reg
50*b3de755dSAlain Volmat  - interrupts
51*b3de755dSAlain Volmat  - clocks
52*b3de755dSAlain Volmat  - clock-names
53*b3de755dSAlain Volmat
54*b3de755dSAlain VolmatunevaluatedProperties: false
55*b3de755dSAlain Volmat
56*b3de755dSAlain Volmatexamples:
57*b3de755dSAlain Volmat  - |
58*b3de755dSAlain Volmat    #include <dt-bindings/interrupt-controller/arm-gic.h>
59*b3de755dSAlain Volmat    #include <dt-bindings/clock/stih407-clks.h>
60*b3de755dSAlain Volmat    i2c@fed40000 {
61*b3de755dSAlain Volmat        compatible = "st,comms-ssc4-i2c";
62*b3de755dSAlain Volmat        reg = <0xfed40000 0x110>;
63*b3de755dSAlain Volmat        interrupts =  <GIC_SPI 187 IRQ_TYPE_LEVEL_HIGH>;
64*b3de755dSAlain Volmat        clocks = <&clk_s_a0_ls CLK_ICN_REG>;
65*b3de755dSAlain Volmat        clock-names = "ssc";
66*b3de755dSAlain Volmat        clock-frequency = <400000>;
67*b3de755dSAlain Volmat        pinctrl-names = "default";
68*b3de755dSAlain Volmat        pinctrl-0 = <&pinctrl_i2c0_default>;
69*b3de755dSAlain Volmat        st,i2c-min-scl-pulse-width-us = <0>;
70*b3de755dSAlain Volmat        st,i2c-min-sda-pulse-width-us = <5>;
71*b3de755dSAlain Volmat    };
72