0001 # SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
0002 %YAML 1.2
0003 ---
0004 $id: http://devicetree.org/schemas/iio/adc/adi,ad7280a.yaml#
0005 $schema: http://devicetree.org/meta-schemas/core.yaml#
0006
0007 title: Analog Devices AD7280a Lithium Ion Battery Monitoring System
0008
0009 maintainers:
0010 - Michael Hennerich <michael.hennerich@analog.com>
0011 - Jonathan Cameron <jic23@kernel.org>
0012
0013 description: |
0014 Bindings for the Analog Devices AD7280a Battery Monitoring System.
0015 Used in devices such as hybrid electric cars, battery backup and power tools.
0016 Multiple chips can be daisy chained and accessed via a single SPI interface.
0017 Data sheet found here:
0018 https://www.analog.com/media/en/technical-documentation/data-sheets/AD7280A.pdf
0019
0020 properties:
0021 compatible:
0022 const: adi,ad7280a
0023
0024 reg:
0025 maxItems: 1
0026
0027 interrupts:
0028 description: IRQ line for the ADC
0029 maxItems: 1
0030
0031 spi-max-frequency: true
0032
0033 adi,voltage-alert-last-chan:
0034 $ref: /schemas/types.yaml#/definitions/uint32
0035 description:
0036 Allows limiting of scope of which channels are considered for voltage
0037 alerts, typically because not all are wired to anything. Only applies to
0038 last device in the daisy chain.
0039 default: 5
0040 enum: [3, 4, 5]
0041
0042 adi,acquisition-time-ns:
0043 description:
0044 Additional time may be needed to charge the sampling capacitors depending
0045 on external writing.
0046 default: 400
0047 enum: [400, 800, 1200, 1600]
0048
0049 adi,thermistor-termination:
0050 type: boolean
0051 description:
0052 Enable the thermistor termination function.
0053
0054 required:
0055 - compatible
0056 - reg
0057
0058 additionalProperties: false
0059
0060 examples:
0061 - |
0062 spi {
0063 #address-cells = <1>;
0064 #size-cells = <0>;
0065
0066 adc@0 {
0067 compatible = "adi,ad7280a";
0068 reg = <0>;
0069 spi-max-frequency = <700000>;
0070 interrupt-parent = <&gpio>;
0071 interrupts = <25 2>;
0072 adi,thermistor-termination;
0073 adi,acquisition-time-ns = <800>;
0074 adi,voltage-alert-last-chan = <5>;
0075 };
0076 };
0077 ...
