Documentation/devicetree/bindings/i2c/renesas,rmobile-iic.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/renesas,rmobile-iic.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: Renesas R-Mobile I2C Bus Interface (IIC)
   8
   9 maintainers:
  10   - Wolfram Sang <wsa+renesas@sang-engineering.com>
  11
  12 properties:
  13   compatible:
  14     oneOf:
  15       - items:
  16           - enum:
  17               - renesas,iic-r8a73a4      # R-Mobile APE6
  18               - renesas,iic-r8a7740      # R-Mobile A1
  19               - renesas,iic-sh73a0       # SH-Mobile AG5
  20           - const: renesas,rmobile-iic   # Generic
  21
  22       - items:
  23           - enum:
  24               - renesas,iic-r8a7742      # RZ/G1H
  25               - renesas,iic-r8a7743      # RZ/G1M
  26               - renesas,iic-r8a7744      # RZ/G1N
  27               - renesas,iic-r8a7745      # RZ/G1E
  28               - renesas,iic-r8a7790      # R-Car H2
  29               - renesas,iic-r8a7791      # R-Car M2-W
  30               - renesas,iic-r8a7792      # R-Car V2H
  31               - renesas,iic-r8a7793      # R-Car M2-N
  32               - renesas,iic-r8a7794      # R-Car E2
  33           - const: renesas,rcar-gen2-iic # R-Car Gen2 and RZ/G1
  34           - const: renesas,rmobile-iic   # Generic
  35
  36       - items:
  37           - enum:
  38               - renesas,iic-r8a774a1     # RZ/G2M
  39               - renesas,iic-r8a774b1     # RZ/G2N
  40               - renesas,iic-r8a774c0     # RZ/G2E
  41               - renesas,iic-r8a774e1     # RZ/G2H
  42               - renesas,iic-r8a7795      # R-Car H3
  43               - renesas,iic-r8a7796      # R-Car M3-W
  44               - renesas,iic-r8a77961     # R-Car M3-W+
  45               - renesas,iic-r8a77965     # R-Car M3-N
  46               - renesas,iic-r8a77990     # R-Car E3
  47           - const: renesas,rcar-gen3-iic # R-Car Gen3 and RZ/G2
  48           - const: renesas,rmobile-iic   # Generic
  49
  50   reg:
  51     maxItems: 1
  52
  53   interrupts: true
  54
  55   clock-frequency:
  56     description:
  57       Desired I2C bus clock frequency in Hz. The absence of this property
  58       indicates the default frequency 100 kHz.
  59
  60   clocks:
  61     maxItems: 1
  62
  63   power-domains:
  64     maxItems: 1
  65
  66   resets:
  67     maxItems: 1
  68
  69   dmas:
  70     minItems: 2
  71     maxItems: 4
  72     description:
  73       Must contain a list of pairs of references to DMA specifiers, one for
  74       transmission, and one for reception.
  75
  76   dma-names:
  77     minItems: 2
  78     maxItems: 4
  79     items:
  80       enum:
  81         - tx
  82         - rx
  83
  84 required:
  85   - compatible
  86   - reg
  87   - interrupts
  88   - clocks
  89   - power-domains
  90   - '#address-cells'
  91   - '#size-cells'
  92
  93 allOf:
  94   - $ref: /schemas/i2c/i2c-controller.yaml#
  95
  96   - if:
  97       properties:
  98         compatible:
  99           contains:
 100             enum:
 101               - renesas,iic-r8a7740
 102               - renesas,iic-sh73a0
 103     then:
 104       properties:
 105         interrupts:
 106           items:
 107             - description: Arbitration Lost Interrupt (ALI)
 108             - description: Non-acknowledge Detection Interrupt (TACKI)
 109             - description: Wait Interrupt (WAITI)
 110             - description: Data Transmit Enable interrupt (DTEI)
 111     else:
 112       properties:
 113         interrupts:
 114           items:
 115             - description: Single combined interrupt
 116
 117   - if:
 118       properties:
 119         compatible:
 120           contains:
 121             enum:
 122               - renesas,rcar-gen2-iic
 123               - renesas,rcar-gen3-iic
 124     then:
 125       required:
 126         - resets
 127
 128 unevaluatedProperties: false
 129
 130 examples:
 131   - |
 132     #include <dt-bindings/clock/r8a7790-cpg-mssr.h>
 133     #include <dt-bindings/interrupt-controller/arm-gic.h>
 134     #include <dt-bindings/power/r8a7790-sysc.h>
 135
 136     iic0: i2c@e6500000 {
 137             compatible = "renesas,iic-r8a7790", "renesas,rcar-gen2-iic",
 138                          "renesas,rmobile-iic";
 139             reg = <0xe6500000 0x425>;
 140             interrupts = <GIC_SPI 174 IRQ_TYPE_LEVEL_HIGH>;
 141             clocks = <&cpg CPG_MOD 318>;
 142             clock-frequency = <400000>;
 143             dmas = <&dmac0 0x61>, <&dmac0 0x62>, <&dmac1 0x61>, <&dmac1 0x62>;
 144             dma-names = "tx", "rx", "tx", "rx";
 145             power-domains = <&sysc R8A7790_PD_ALWAYS_ON>;
 146             resets = <&cpg 318>;
 147             #address-cells = <1>;
 148             #size-cells = <0>;
 149     };