Documentation/devicetree/bindings/i2c/ti,omap4-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/ti,omap4-i2c.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: Bindings for I2C controllers on TI's OMAP and K3 SoCs
   8
   9 maintainers:
  10   - Vignesh Raghavendra <vigneshr@ti.com>
  11
  12 properties:
  13   compatible:
  14     oneOf:
  15       - enum:
  16           - ti,omap2420-i2c
  17           - ti,omap2430-i2c
  18           - ti,omap3-i2c
  19           - ti,omap4-i2c
  20       - items:
  21           - enum:
  22               - ti,am4372-i2c
  23               - ti,am64-i2c
  24               - ti,am654-i2c
  25               - ti,j721e-i2c
  26           - const: ti,omap4-i2c
  27
  28   reg:
  29     maxItems: 1
  30
  31   interrupts:
  32     maxItems: 1
  33
  34   clocks:
  35     maxItems: 1
  36
  37   clock-names:
  38     const: fck
  39
  40   clock-frequency: true
  41
  42   power-domains: true
  43
  44   "#address-cells":
  45     const: 1
  46
  47   "#size-cells":
  48     const: 0
  49
  50   ti,hwmods:
  51     description:
  52       Must be "i2c<n>", n being the instance number (1-based).
  53       This property is applicable only on legacy platforms mainly omap2/3
  54       and ti81xx and should not be used on other platforms.
  55     $ref: /schemas/types.yaml#/definitions/string
  56     deprecated: true
  57
  58 # subnode's properties
  59 patternProperties:
  60   "@[0-9a-f]+$":
  61     type: object
  62     description:
  63       Flash device uses the below defined properties in the subnode.
  64
  65 required:
  66   - compatible
  67   - reg
  68   - interrupts
  69
  70 additionalProperties: false
  71
  72 if:
  73   properties:
  74     compatible:
  75       enum:
  76         - ti,omap2420-i2c
  77         - ti,omap2430-i2c
  78         - ti,omap3-i2c
  79         - ti,omap4-i2c
  80
  81 then:
  82   properties:
  83     ti,hwmods:
  84       items:
  85         - pattern: "^i2c([1-9])$"
  86
  87 else:
  88   properties:
  89     ti,hwmods: false
  90
  91 examples:
  92   - |
  93     #include <dt-bindings/interrupt-controller/irq.h>
  94     #include <dt-bindings/interrupt-controller/arm-gic.h>
  95
  96     main_i2c0: i2c@2000000 {
  97             compatible = "ti,j721e-i2c", "ti,omap4-i2c";
  98             reg = <0x2000000 0x100>;
  99             interrupts = <GIC_SPI 200 IRQ_TYPE_LEVEL_HIGH>;
 100             #address-cells = <1>;
 101             #size-cells = <0>;
 102          };