Kernel driver ina209

INA209 지원 정보와 측정 기능

`ina209` 커널 드라이버는 Burr-Brown / Texas Instruments INA209를 지원합니다. 주소 자동 검색은 하지 않으며 데이터시트는 TI의 `https://www.ti.com/lit/gpn/ina209`에서 제공됩니다. 저자는 Paul Hays, Ira W. Snyder, Guenter Roeck입니다.

INA209는 직류 전원 공급 장치의 high side에서 전압, 전류, 전력을 감시합니다. 백그라운드에서 측정과 계산을 수행하므로 언제든 읽을 수 있는 값을 제공하며, 표시되는 전류와 전력값의 배율을 조정하는 프로그래밍 가능한 보정 승수를 포함합니다.

Kernel driver ina209
====================

Supported chips:

  * Burr-Brown / Texas Instruments INA209

    Prefix: 'ina209'

    Addresses scanned: -

    Datasheet:
        https://www.ti.com/lit/gpn/ina209

Author:
        - Paul Hays <[email protected]>
        - Ira W. Snyder <[email protected]>
        - Guenter Roeck <[email protected]>


Description
-----------

The TI / Burr-Brown INA209 monitors voltage, current, and power on the high side
of a D.C. power supply. It can perform measurements and calculations in the
background to supply readings at any time. It includes a programmable
calibration multiplier to scale the displayed current and power values.

INA209 sysfs 측정·이력·경보 속성

INA209는 배선과 I2C 버스 양쪽에서 매우 세밀하게 구성할 수 있습니다. 드라이버는 하드웨어 감시 기능 대부분을 sysfs로 내보내지만 칩의 모든 기능을 지원하지는 않습니다.

Shunt 전압 채널 `in0`과 bus 전압 채널 `in1`은 각각 mV 단위 현재값, 과거 최고·최저값, 이력 재설정, 최대·최소 및 임계 최대·최소 경보 한계, 각 한계 초과 경보를 제공합니다.

전력 채널은 uW 단위 현재·과거 최고값, 이력 재설정, 최대·임계 한계와 경보를 제공합니다. 전류 채널은 mA 단위 `curr1_input`을 제공합니다. `update_interval`은 데이터 변환 시간을 정하며 shunt 전압과 bus 전압 결과를 평균할 때 사용하는 샘플 수에 영향을 줍니다.

Sysfs entries
-------------

The INA209 chip is highly configurable both via hardwiring and via
the I2C bus. See the datasheet for details.

This tries to expose most monitoring features of the hardware via
sysfs. It does not support every feature of this chip.

======================= =======================================================
in0_input                shunt voltage (mV)
in0_input_highest        shunt voltage historical maximum reading (mV)
in0_input_lowest        shunt voltage historical minimum reading (mV)
in0_reset_history        reset shunt voltage history
in0_max                        shunt voltage max alarm limit (mV)
in0_min                        shunt voltage min alarm limit (mV)
in0_crit_max                shunt voltage crit max alarm limit (mV)
in0_crit_min                shunt voltage crit min alarm limit (mV)
in0_max_alarm                shunt voltage max alarm limit exceeded
in0_min_alarm                shunt voltage min alarm limit exceeded
in0_crit_max_alarm        shunt voltage crit max alarm limit exceeded
in0_crit_min_alarm        shunt voltage crit min alarm limit exceeded

in1_input                bus voltage (mV)
in1_input_highest        bus voltage historical maximum reading (mV)
in1_input_lowest        bus voltage historical minimum reading (mV)
in1_reset_history        reset bus voltage history
in1_max                        bus voltage max alarm limit (mV)
in1_min                        bus voltage min alarm limit (mV)
in1_crit_max                bus voltage crit max alarm limit (mV)
in1_crit_min                bus voltage crit min alarm limit (mV)
in1_max_alarm                bus voltage max alarm limit exceeded
in1_min_alarm                bus voltage min alarm limit exceeded
in1_crit_max_alarm        bus voltage crit max alarm limit exceeded
in1_crit_min_alarm        bus voltage crit min alarm limit exceeded

power1_input                power measurement (uW)
power1_input_highest        power historical maximum reading (uW)
power1_reset_history        reset power history
power1_max                power max alarm limit (uW)
power1_crit                power crit alarm limit (uW)
power1_max_alarm        power max alarm limit exceeded
power1_crit_alarm        power crit alarm limit exceeded

curr1_input                current measurement (mA)

update_interval                data conversion time; affects number of samples used
                        to average results for shunt and bus voltages.
======================= =======================================================

보정 레지스터와 출력 핀 범위

칩의 전력·전류 레지스터를 사용하려면 보정 레지스터가 올바르게 프로그래밍되어야 합니다. 일반적으로 BIOS가 이를 설정합니다. BIOS 설정이 없다면 플랫폼 데이터로 shunt 저항값을 제공할 수 있으며, 이 드라이버는 그 목적으로 `ina2xx` 드라이버의 플랫폼 데이터를 사용합니다.

플랫폼 데이터가 보정 레지스터 값을 제공하지 않으면 드라이버는 기존 보정 레지스터가 0이 아닌지 확인합니다. 이미 프로그래밍되어 있으면 그 값을 유지하고, 0이면 10 mOhm shunt 저항에 해당하는 기본값을 보정 레지스터에 기록합니다.

출력 핀 프로그래밍은 BIOS에 의존하는 보드 기능입니다. 출력 핀을 켜거나 끄는 것은 하드웨어 모니터링 드라이버의 범위를 벗어나므로 이 드라이버가 제어하지 않습니다.

General Remarks
---------------

The power and current registers in this chip require that the calibration
register is programmed correctly before they are used. Normally this is expected
to be done in the BIOS. In the absence of BIOS programming, the shunt resistor
voltage can be provided using platform data. The driver uses platform data from
the ina2xx driver for this purpose. If calibration register data is not provided
via platform data, the driver checks if the calibration register has been
programmed (ie has a value not equal to zero). If so, this value is retained.
Otherwise, a default value reflecting a shunt resistor value of 10 mOhm is
programmed into the calibration register.


Output Pins
-----------

Output pin programming is a board feature which depends on the BIOS. It is
outside the scope of a hardware monitoring driver to enable or disable output
pins.