xref: /freebsd/sys/contrib/device-tree/Bindings/iio/adc/adi,ad7280a.yaml (revision 535af610a4fdace6d50960c0ad9be0597eea7a1b)
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
7title: Analog Devices AD7280a Lithium Ion Battery Monitoring System
8
9maintainers:
10  - Michael Hennerich <michael.hennerich@analog.com>
11  - Jonathan Cameron <jic23@kernel.org>
12
13description: |
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
20properties:
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
52required:
53  - compatible
54  - reg
55
56allOf:
57  - $ref: /schemas/spi/spi-peripheral-props.yaml#
58
59unevaluatedProperties: false
60
61examples:
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...
79