Documentation/devicetree/bindings/hwmon/ti,ina2xx.yaml

Source file repositories/reference/linux-study-clean/Documentation/devicetree/bindings/hwmon/ti,ina2xx.yaml

File Facts

System
Linux kernel
Corpus path
Documentation/devicetree/bindings/hwmon/ti,ina2xx.yaml
Extension
.yaml
Size
4727 bytes
Lines
176
Domain
Support Tooling And Documentation
Bucket
Documentation
Inferred role
Support Tooling And Documentation: configuration, schema, or hardware description
Status
atlas-only

Why This File Exists

Repository support layer: documentation, build tooling, samples, user-space helper tools, generated initramfs support, licenses, and validation utilities.

Dependency Surface

Detected Declarations

Annotated Snippet

# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/hwmon/ti,ina2xx.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Texas Instruments INA209 family of power/voltage monitors

maintainers:
  - Krzysztof Kozlowski <krzk@kernel.org>

description: |
  The INA209 is a high-side current shunt and power monitor with
  an I2C interface.

  Datasheets:
    https://www.ti.com/product/INA209

properties:
  compatible:
    enum:
      - silergy,sq52206
      - silergy,sy24655
      - ti,ina209
      - ti,ina219
      - ti,ina220
      - ti,ina226
      - ti,ina228
      - ti,ina230
      - ti,ina231
      - ti,ina233
      - ti,ina234
      - ti,ina237
      - ti,ina238
      - ti,ina260
      - ti,ina700
      - ti,ina780

  reg:
    maxItems: 1

  "#io-channel-cells":
    const: 1

  shunt-resistor:
    description:
      Shunt resistor value in micro-Ohm.
    $ref: /schemas/types.yaml#/definitions/uint32

  ti,shunt-gain:
    description: |
      Programmable gain divisor for the shunt voltage accuracy and range. This
      property only applies to devices that have configurable PGA/ADCRANGE. The
      gain value is used configure the gain and to convert the shunt voltage,
      current and power register values when reading measurements from the
      device.

      For devices that have a configurable PGA (e.g. INA209, INA219, INA220),
      the gain value maps directly with the PG bits of the config register.

      For devices that have ADCRANGE configuration (e.g. INA238) a shunt-gain
      value of 1 maps to ADCRANGE=1 where no gain divisor is applied to the
      shunt voltage, and a value of 4 maps to ADCRANGE=0 such that a wider
      voltage range is used.

      For SQ52206,the shunt-gain value 1 mapps to ADCRANGE=10/11, the value 2
      mapps to ADCRANGE=01, and the value 4 mapps to ADCRANGE=00.

      The default value is device dependent, and is defined by the reset value
      of PGA/ADCRANGE in the respective configuration registers.

Annotation

Implementation Notes