Documentation/devicetree/bindings/iio/adc/adi,ad7280a.yaml

   1 # SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
   2 %YAML 1.2
   3 ---
   4 $id: http://devicetree.org/schemas/iio/adc/adi,ad7280a.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: Analog Devices AD7280a Lithium Ion Battery Monitoring System
   8
   9 maintainers:
  10   - Michael Hennerich <michael.hennerich@analog.com>
  11   - Jonathan Cameron <jic23@kernel.org>
  12
  13 description: |
  14   Bindings for the Analog Devices AD7280a Battery Monitoring System.
  15   Used in devices such as hybrid electric cars, battery backup and power tools.
  16   Multiple chips can be daisy chained and accessed via a single SPI interface.
  17   Data sheet found here:
  18     https://www.analog.com/media/en/technical-documentation/data-sheets/AD7280A.pdf
  19
  20 properties:
  21   compatible:
  22     const: adi,ad7280a
  23
  24   reg:
  25     maxItems: 1
  26
  27   interrupts:
  28     description: IRQ line for the ADC
  29     maxItems: 1
  30
  31   adi,voltage-alert-last-chan:
  32     $ref: /schemas/types.yaml#/definitions/uint32
  33     description:
  34       Allows limiting of scope of which channels are considered for voltage
  35       alerts, typically because not all are wired to anything. Only applies to
  36       last device in the daisy chain.
  37     default: 5
  38     enum: [3, 4, 5]
  39
  40   adi,acquisition-time-ns:
  41     description:
  42       Additional time may be needed to charge the sampling capacitors depending
  43       on external writing.
  44     default: 400
  45     enum: [400, 800, 1200, 1600]
  46
  47   adi,thermistor-termination:
  48     type: boolean
  49     description:
  50       Enable the thermistor termination function.
  51
  52 required:
  53   - compatible
  54   - reg
  55
  56 allOf:
  57   - $ref: /schemas/spi/spi-peripheral-props.yaml#
  58
  59 unevaluatedProperties: false
  60
  61 examples:
  62   - |
  63     spi {
  64       #address-cells = <1>;
  65       #size-cells = <0>;
  66
  67       adc@0 {
  68         compatible = "adi,ad7280a";
  69         reg = <0>;
  70         spi-max-frequency = <700000>;
  71         interrupt-parent = <&gpio>;
  72         interrupts = <25 2>;
  73         adi,thermistor-termination;
  74         adi,acquisition-time-ns = <800>;
  75         adi,voltage-alert-last-chan = <5>;
  76       };
  77     };
  78 ...