realtek,rtl9301-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/realtek,rtl9301-i2c.yaml#
  5$schema: http://devicetree.org/meta-schemas/core.yaml#
  6
  7title: Realtek RTL I2C Controller
  8
  9maintainers:
 10  - Chris Packham <chris.packham@alliedtelesis.co.nz>
 11
 12description:
 13  RTL9300 SoCs have two I2C controllers. Each of these has an SCL line (which
 14  if not-used for SCL can be a GPIO). There are 8 common SDA lines that can be
 15  assigned to either I2C controller.
 16  RTL9310 SoCs have equal capabilities but support 12 common SDA lines which
 17  can be assigned to either I2C controller.
 18
 19properties:
 20  compatible:
 21    oneOf:
 22      - items:
 23          - enum:
 24              - realtek,rtl9302b-i2c
 25              - realtek,rtl9302c-i2c
 26              - realtek,rtl9303-i2c
 27          - const: realtek,rtl9301-i2c
 28      - items:
 29          - enum:
 30              - realtek,rtl9311-i2c
 31              - realtek,rtl9312-i2c
 32              - realtek,rtl9313-i2c
 33          - const: realtek,rtl9310-i2c
 34      - enum:
 35          - realtek,rtl9301-i2c
 36          - realtek,rtl9310-i2c
 37
 38  reg:
 39    items:
 40      - description: Register offset and size of this I2C controller.
 41
 42  "#address-cells":
 43    const: 1
 44
 45  "#size-cells":
 46    const: 0
 47
 48  realtek,scl:
 49    $ref: /schemas/types.yaml#/definitions/uint32
 50    description:
 51      The SCL line number of this I2C controller.
 52    enum: [ 0, 1 ]
 53
 54patternProperties:
 55  '^i2c@[0-9ab]$':
 56    $ref: /schemas/i2c/i2c-controller.yaml
 57    unevaluatedProperties: false
 58
 59    properties:
 60      reg:
 61        description: The SDA line number associated with the I2C bus.
 62        maxItems: 1
 63
 64    required:
 65      - reg
 66
 67allOf:
 68  - if:
 69      properties:
 70        compatible:
 71          contains:
 72            const: realtek,rtl9310-i2c
 73    then:
 74      required:
 75        - realtek,scl
 76  - if:
 77      properties:
 78        compatible:
 79          contains:
 80            const: realtek,rtl9301-i2c
 81    then:
 82      patternProperties:
 83        '^i2c@[89ab]$': false
 84
 85required:
 86  - compatible
 87  - reg
 88
 89additionalProperties: false
 90
 91examples:
 92  - |
 93    i2c@36c {
 94      compatible = "realtek,rtl9301-i2c";
 95      reg = <0x36c 0x14>;
 96      #address-cells = <1>;
 97      #size-cells = <0>;
 98
 99      i2c@2 {
100        reg = <2>;
101        #address-cells = <1>;
102        #size-cells = <0>;
103      };
104    };