1# Copyright 2024 NXP
2# SPDX-License-Identifier: Apache-2.0
3
4description: |
5    TI INA226 Bidirectional Current and Power Monitor.
6    The <zephyr/dt-bindings/sensor/ina226.h> file should be included in the
7    DeviceTree as it provides macros that can be used for initializing the
8    configuration registers.
9
10compatible: "ti,ina226"
11
12include: [sensor-device.yaml, i2c-device.yaml]
13
14properties:
15  avg-count:
16    type: int
17    description: |
18      Number of samples to average (applies to all inputs).
19      Default is the power-on reset value.
20    default: 1
21    enum: [1, 4, 16, 64, 128, 256, 512, 1024]
22
23  vbus-conversion-time-us:
24    type: int
25    description: |
26      Vbus conversion time in microseconds.
27      Default is the power-on reset value.
28    default: 1100
29    enum: [140, 204, 332, 588, 1100, 2116, 4156, 8244]
30
31  vshunt-conversion-time-us:
32    type: int
33    description: |
34      Vshunt conversion time in microseconds.
35      Default is the power-on reset value.
36    default: 1100
37    enum: [140, 204, 332, 588, 1100, 2116, 4156, 8244]
38
39  operating-mode:
40    type: string
41    description: |
42      Selects mode of operation.
43      Default is the power-on reset value.
44    default: "Shunt and Bus, Continuous"
45    enum:
46      - "Power-Down (or Shutdown)"
47      - "Shunt Voltage, Triggered"
48      - "Bus Voltage, Triggered"
49      - "Shunt and Bus, Triggered"
50      - "Power-Down (or Shutdown)"
51      - "Shunt Voltage, Continuous"
52      - "Bus Voltage, Continuous"
53      - "Shunt and Bus, Continuous"
54
55  current-lsb-microamps:
56    type: int
57    required: true
58    description: |
59      Current LSB value in microAmpere.
60      This value gives the measurement resolution for current measurement.
61      Formula: current-lsb [μA] = maximum expected current [μA] / 2^15
62      Higher resolution means lower range of current measurement, vice versa.
63
64      For example, if maximum expected current is 15 [A]:
65        then, current-lsb [μA] = 15000000 [μA] / 2^15 ~= 457.763 [μA].
66
67      Note: rounded values may be used for convenience, e.g. 500uA/LSB.
68
69  rshunt-micro-ohms:
70    type: int
71    required: true
72    description: |
73      Shunt resistor value in micro-ohms.
74