GNU Linux-libre 6.1.90-gnu
[releases.git] / Documentation / devicetree / bindings / i2c / apple,i2c.yaml
1 # SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
2 %YAML 1.2
3 ---
4 $id: "http://devicetree.org/schemas/i2c/apple,i2c.yaml#"
5 $schema: "http://devicetree.org/meta-schemas/core.yaml#"
6
7 title: Apple/PASemi I2C controller
8
9 maintainers:
10   - Sven Peter <sven@svenpeter.dev>
11
12 description: |
13   Apple SoCs such as the M1 come with a I2C controller based on the one found
14   in machines with P. A. Semi's PWRficient processors.
15   The bus is used to communicate with e.g. USB PD chips or the speaker
16   amp.
17
18 allOf:
19   - $ref: /schemas/i2c/i2c-controller.yaml#
20
21 properties:
22   compatible:
23     items:
24       - enum:
25           - apple,t8103-i2c
26           - apple,t6000-i2c
27       - const: apple,i2c
28
29   reg:
30     maxItems: 1
31
32   clocks:
33     items:
34       - description: I2C bus reference clock
35
36   interrupts:
37     maxItems: 1
38
39   clock-frequency:
40     description: |
41       Desired I2C bus clock frequency in Hz. If not specified, 100 kHz will be
42       used. This frequency is generated by dividing the reference clock.
43       Allowed values are between ref_clk/(16*4) and ref_clk/(16*255).
44
45   power-domains:
46     maxItems: 1
47
48 required:
49   - compatible
50   - reg
51   - clocks
52   - interrupts
53
54 unevaluatedProperties: false
55
56 examples:
57   - |
58     i2c@35010000 {
59       compatible = "apple,t8103-i2c", "apple,i2c";
60       reg = <0x35010000 0x4000>;
61       interrupt-parent = <&aic>;
62       interrupts = <0 627 4>;
63       clocks = <&ref_clk>;
64       #address-cells = <1>;
65       #size-cells = <0>;
66     };