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