blob: 2fcc40a2314ba70e58bed22800735756249153dc [file] [log] [blame]
# Copyright (c) 2021 Leonard Pollak
# SPDX-License-Identifier: Apache-2.0
description: Texas Instruments Bidirectional Current/Power Sensor
compatible: "ti,ina219"
include: [sensor-device.yaml, i2c-device.yaml]
properties:
lsb-microamp:
type: int
required: true
description: |
Current LSB in microAmpere
Current LSB = max expected current [A] / 2^15
example: 100 -> ~3A
shunt-milliohm:
type: int
required: true
description: |
Value of the shunt resistor in milliOhm
brng:
type: int
default: 1
description: |
Bus Voltage Range
0 = 16 V FSR
1 = 32 V FSR
The default of 32V is the power-on reset value of the device.
Should the expected bus voltage be below 16V set this to 0.
enum:
- 0
- 1
pg:
type: int
default: 3
description: |
Programmable Gain
0 = 1 -> ±40 mV
1 = /2 -> ±80 mV
2 = /4 -> ±160 mV
3 = /8 -> ±320 mV
The default of ±320 mV is the power-on reset value of the device.
In case the expected voltage drop across the shunt resistor is lower
one can adjust this to get more accurate readings.
enum:
- 0
- 1
- 2
- 3
badc:
type: int
default: 3
description: |
Bus ADC configuration
0 = 9 bit -> 84 µs
1 = 10 bit -> 148 µs
2 = 11 bit -> 276 µs
3 = 12 bit -> 532 µs
9 = 12 bit - 2 sample averaging -> 1.06 ms
10 = 12 bit - 4 sample averaging -> 2.13 ms
11 = 12 bit - 8 sample averaging -> 4.26 ms
12 = 12 bit - 16 sample averaging -> 8.51 ms
13 = 12 bit - 32 sample averaging -> 17.02 ms
14 = 12 bit - 64 sample averaging -> 34.05 ms
15 = 12 bit - 128 sample averaging -> 68.10 ms
The default of 12 bit is the power-on reset value of the device.
Lowering the resolution of the ADC gives less accurate readings but
cuts down on conversion times.
Averaging over multiple samples gives more stable readings but adds
to overall conversion time.
enum:
- 0
- 1
- 2
- 3
- 9
- 10
- 11
- 12
- 13
- 14
- 15
sadc:
type: int
default: 3
description: |
Shunt ADC configuration
0 = 9 bit -> 84 µs
1 = 10 bit -> 148 µs
2 = 11 bit -> 276 µs
3 = 12 bit -> 532 µs
9 = 12 bit - 2 sample averaging -> 1.06 ms
10 = 12 bit - 4 sample averaging -> 2.13 ms
11 = 12 bit - 8 sample averaging -> 4.26 ms
12 = 12 bit - 16 sample averaging -> 8.51 ms
13 = 12 bit - 32 sample averaging -> 17.02 ms
14 = 12 bit - 64 sample averaging -> 34.05 ms
15 = 12 bit - 128 sample averaging -> 68.10 ms
The default of 12 bit is the power-on reset value of the device.
Lowering the resolution of the ADC gives less accurate readings but
cuts down on conversion times.
Averaging over multiple samples gives more stable readings but adds
to overall conversion time.
enum:
- 0
- 1
- 2
- 3
- 9
- 10
- 11
- 12
- 13
- 14
- 15