xref: /freebsd/sys/contrib/device-tree/Bindings/iio/adc/adi,ad7280a.yaml (revision a64729f5077d77e13b9497cb33ecb3c82e606ee8)
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