# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/iio/adc/ti,ads112c04.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Texas Instruments ADS112C04 ADC

maintainers:
  - Kyle Hsieh <kylehsieh1995@gmail.com>

description:
  The ADS112C04 (16-bit) are precision analog-to-digital converters (ADCs)
  with an I2C interface. They feature a flexible input multiplexer, a
  low-noise programmable gain amplifier (PGA), two programmable excitation
  current sources, a voltage reference, and a precision temperature sensor.

properties:
  compatible:
    enum:
      - ti,ads112c04

  reg:
    maxItems: 1
    description: I2C address of the device.

  interrupts:
    maxItems: 1
    description:
      Data ready (DRDY) interrupt output. DRDY pulses low when a conversion
      result is ready and returns high once the result is latched, so an
      edge trigger should be used.

  "#address-cells":
    const: 1

  "#size-cells":
    const: 0

  reset-gpios:
    maxItems: 1
    description: GPIO connected to the RESET pin. Active low.

  avdd-supply: true
  dvdd-supply: true

  refp-supply: true
  refn-supply: true

  ti,refp-refn-resistor-ohms:
    description: Resistance of the external resistor between REFP and REFN.

patternProperties:
  "^channel@[0-9a-b]$":
    $ref: adc.yaml
    unevaluatedProperties: false
    properties:
      reg:
        items:
          - maximum: 11

      single-channel:
        maximum: 3

      diff-channels:
        items:
          maximum: 3

      excitation-channels:
        maxItems: 2
        items:
          maximum: 5
        description:
          Additionally to AIN0-AIN3, IDAC1/IDAC2 can also be routed to
          REFP0 (4) and REFN0 (5).

      excitation-current-nanoamp:
        enum: [10000, 50000, 100000, 250000, 500000, 1000000, 1500000]

      burn-out-current-nanoamp:
        const: 10000

      reference-sources:
        items:
          - enum: [internal, external, avdd]
        default: [ internal ]

    dependencies:
      excitation-channels: [ excitation-current-nanoamp ]
      excitation-current-nanoamp: [ excitation-channels ]

    oneOf:
      - required: [ single-channel ]
      - required: [ diff-channels ]

required:
  - compatible
  - reg
  - avdd-supply
  - dvdd-supply

dependencies:
  refn-supply: [ refp-supply ]

oneOf:
  - required:
      - refp-supply
  - required:
      - ti,refp-refn-resistor-ohms
  - properties:
      refp-supply: false
      refn-supply: false
      ti,refp-refn-resistor-ohms: false

unevaluatedProperties: false

examples:
  - |
    #include <dt-bindings/interrupt-controller/irq.h>
    #include <dt-bindings/gpio/gpio.h>
    i2c {
        #address-cells = <1>;
        #size-cells = <0>;

        adc@40 {
            compatible = "ti,ads112c04";
            reg = <0x40>;
            interrupt-parent = <&gpio>;
            interrupts = <12 IRQ_TYPE_EDGE_FALLING>;

            reset-gpios = <&gpio 13 GPIO_ACTIVE_LOW>;
            avdd-supply = <&vdd_3v3_reg>;
            dvdd-supply = <&vdd_3v3_reg>;
            refp-supply = <&vref_reg>;

            #address-cells = <1>;
            #size-cells = <0>;

            channel@0 {
                reg = <0>;
                diff-channels = <0>, <1>;
            };

            channel@1 {
                reg = <1>;
                single-channel = <2>;
            };
        };
    };