Kernel driver ina3221

INA3221 3채널 high-side 모니터

`ina3221` 드라이버는 Texas Instruments INA3221을 지원합니다. I2C 주소 범위는 `0x40`부터 `0x43`, 접두사는 `ina3221`이며 데이터시트는 TI 웹사이트에서 공개됩니다. 작성자는 Andrew F. Davis입니다.

INA3221은 최대 세 개의 직류 전원 공급 장치 high side에서 전압, 전류, 전력을 감시합니다. Shunt 전압 강하와 전원 전압을 측정하고 변환 시간과 평균을 프로그래밍할 수 있습니다. 전류와 전력은 이 측정값을 사용해 호스트에서 계산합니다.

Kernel driver ina3221
=====================

Supported chips:

  * Texas Instruments INA3221

    Prefix: 'ina3221'

    Addresses: I2C 0x40 - 0x43

    Datasheet: Publicly available at the Texas Instruments website

               https://www.ti.com/

Author: Andrew F. Davis <afd@ti.com>

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

The Texas Instruments INA3221 monitors voltage, current, and power on the high
side of up to three D.C. power supplies. The INA3221 monitors both shunt drop
and supply voltage, with programmable conversion times and averaging, current
and power are calculated host-side from these.

채널별 전압·전류와 합산 경보

채널 1~3에는 레이블 `in[123]_label`, 활성화 제어 `in[123]_enable`, mV 단위 bus 전압 `in[123]_input`, mA 단위 전류 `curr[123]_input`, uOhm 단위 shunt 저항 `shunt[123]_resistor`가 있습니다.

각 채널의 `curr[123]_crit`는 전류가 값을 넘을 때 critical 경보를 발생시키고 `curr[123]_crit_alarm`이 초과 상태를 나타냅니다. `curr[123]_max`는 평균 전류가 값을 넘을 때 warning 경보를 발생시키며 `curr[123]_max_alarm`이 그 상태를 나타냅니다.

`in[456]_input`은 채널 1·2·3의 shunt 전압을 각각 uV로 제공합니다. `in7_input`과 `in7_label`은 shunt 전압 합계와 레이블입니다. `curr4_input`은 세 전류 측정값 합계지만 모든 채널의 shunt 저항값이 같을 때만 사용할 수 있습니다.

`curr4_crit`와 `curr4_crit_alarm`은 합산 전류의 critical 한계와 초과 경보입니다. 이 합산 임계 기능도 모든 채널이 같은 shunt 저항값을 사용할 때만 유효합니다.

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

======================= =======================================================
in[123]_label           Voltage channel labels
in[123]_enable          Voltage channel enable controls
in[123]_input           Bus voltage(mV) channels
curr[123]_input         Current(mA) measurement channels
shunt[123]_resistor     Shunt resistance(uOhm) channels
curr[123]_crit          Critical alert current(mA) setting, activates the
                        corresponding alarm when the respective current
                        is above this value
curr[123]_crit_alarm    Critical alert current limit exceeded
curr[123]_max           Warning alert current(mA) setting, activates the
                        corresponding alarm when the respective current
                        average is above this value.
curr[123]_max_alarm     Warning alert current limit exceeded
in[456]_input           Shunt voltage(uV) for channels 1, 2, and 3 respectively
in7_input               Sum of shunt voltage(uV) channels
in7_label               Channel label for sum of shunt voltage
curr4_input             Sum of current(mA) measurement channels,
                        (only available when all channels use the same resistor
                        value for their shunt resistors)
curr4_crit              Critical alert current(mA) setting for sum of current
                        measurements, activates the corresponding alarm
                        when the respective current is above this value
                        (only effective when all channels use the same resistor
                        value for their shunt resistors)
curr4_crit_alarm        Critical alert current limit exceeded for sum of
                        current measurements.

샘플 평균과 update_interval 계산

`samples`는 평균 모드에서 사용하는 샘플 수입니다. 지원값은 `1, 4, 16, 64, 128, 256, 512, 1024`입니다.

`update_interval`은 millisecond 단위 데이터 변환 시간이며 `update_interval = C x S x (BC + SC)`로 계산합니다. `C`는 활성 채널 수, `S`는 샘플 수, `BC`는 millisecond 단위 bus 전압 변환 시간, `SC`는 millisecond 단위 shunt 전압 변환 시간입니다.

이 설정은 bus 전압과 shunt 전압 변환 시간 양쪽에 영향을 줍니다. `update_interval`을 0ms로 설정하면 `BC`와 `SC`가 모두 최소 변환 시간인 140us로 설정됩니다.

samples                 Number of samples using in the averaging mode.

                        Supports the list of number of samples:

                          1, 4, 16, 64, 128, 256, 512, 1024

update_interval         Data conversion time in millisecond, following:

                          update_interval = C x S x (BC + SC)

                          * C:        number of enabled channels
                          * S:        number of samples
                          * BC:        bus-voltage conversion time in millisecond
                          * SC:        shunt-voltage conversion time in millisecond

                        Affects both Bus- and Shunt-voltage conversion time.
                        Note that setting update_interval to 0ms sets both BC
                        and SC to 140 us (minimum conversion time).
======================= =======================================================