← Documents Documentation/hwmon/ina238.rst GitHub 원문 ↗

Linux 6.18.37 · Hardware Monitoring

Kernel driver ina238

INA228·237·238·700·780과 SQ52206의 shunt·전력·온도·에너지 감시 기능입니다.

Source pathDocumentation/hwmon/ina238.rst
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.

1. 요약·해설

원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.

요약·해설

ina238.rst:1-109

공통 shunt 측정과 임계 경보를 제공하고 변형에 따라 에너지, 내장 shunt, peak power 기능을 추가합니다.

문서 개요
항목값
SourceDocumentation/hwmon/ina238.rst
분량109 source lines
주소I2C 0x40-0x4f
변형6 supported chips

원문 분량과 핵심 기능입니다.

측정 흐름
변형 식별Shunt 값 설정전압·전류·전력 변환에너지·peak power 확인

장치 설정에서 hwmon 값까지의 핵심 순서입니다.

2. 영어 원문 전체

번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.

원문 전체 펼치기
1 .. SPDX-License-Identifier: GPL-2.0-only
2
3 Kernel driver ina238
4 ====================
5
6 Supported chips:
7
8 * Texas Instruments INA228
9
10 Prefix: 'ina228'
11
12 Addresses: I2C 0x40 - 0x4f
13
14 Datasheet:
15 https://www.ti.com/lit/gpn/ina228
16
17 * Texas Instruments INA237
18
19 Prefix: 'ina237'
20
21 Addresses: I2C 0x40 - 0x4f
22
23 Datasheet:
24 https://www.ti.com/lit/gpn/ina237
25
26 * Texas Instruments INA238
27
28 Prefix: 'ina238'
29
30 Addresses: I2C 0x40 - 0x4f
31
32 Datasheet:
33 https://www.ti.com/lit/gpn/ina238
34
35 * Texas Instruments INA700
36
37 Datasheet:
38 https://www.ti.com/product/ina700
39
40 * Texas Instruments INA780
41
42 Datasheet:
43 https://www.ti.com/product/ina780a
44
45 * Silergy SQ52206
46
47 Prefix: 'SQ52206'
48
49 Addresses: I2C 0x40 - 0x4f
50
51 Author: Nathan Rossi <nathan.rossi@digi.com>
52
53 Description
54 -----------
55
56 The INA238 is a current shunt, power and temperature monitor with an I2C
57 interface. It includes a number of programmable functions including alerts,
58 conversion rate, sample averaging and selectable shunt voltage accuracy.
59
60 The shunt value in micro-ohms can be set via device properties, either from
61 platform code or from device tree data. Please refer to
62 Documentation/devicetree/bindings/hwmon/ti,ina2xx.yaml for bindings if
63 device tree is used.
64
65 INA237 is a functionally equivalent variant of INA238 with slightly
66 different accuracy. INA228 is another variant of INA238 with higher ADC
67 resolution. This chip also reports the energy.
68
69 INA700 and INA780 are variants of the chip series with built-in shunt resistor.
70 They also report the energy.
71
72 SQ52206 is a mostly compatible chip from Sylergy. It reports the energy
73 as well as the peak power consumption.
74
75 Sysfs entries
76 -------------
77
78 ======================= =======================================================
79 in0_input Shunt voltage (mV)
80 in0_min Minimum shunt voltage threshold (mV)
81 in0_min_alarm Minimum shunt voltage alarm
82 in0_max Maximum shunt voltage threshold (mV)
83 in0_max_alarm Maximum shunt voltage alarm
84
85 in1_input Bus voltage (mV)
86 in1_min Minimum bus voltage threshold (mV)
87 in1_min_alarm Minimum shunt voltage alarm
88 in1_max Maximum bus voltage threshold (mV)
89 in1_max_alarm Maximum shunt voltage alarm
90
91 power1_input Power measurement (uW)
92 power1_max Maximum power threshold (uW)
93 power1_max_alarm Maximum power alarm
94 power1_input_highest Peak Power (uW)
95 (SQ52206 only)
96
97 curr1_input Current measurement (mA)
98 curr1_min Minimum current threshold (mA)
99 curr1_min_alarm Minimum current alarm
100 curr1_max Maximum current threshold (mA)
101 curr1_max_alarm Maximum current alarm
102
103 energy1_input Energy measurement (uJ)
104 (SQ52206, INA237, and INA780 only)
105
106 temp1_input Die temperature measurement (mC)
107 temp1_max Maximum die temperature threshold (mC)
108 temp1_max_alarm Maximum die temperature alarm
109 ======================= =======================================================
110

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.

INA238 계열 지원 칩과 주소

1-51

GPL-2.0-only 라이선스의 이 드라이버는 Texas Instruments INA228, INA237, INA238, INA700, INA780과 Silergy SQ52206을 지원합니다. 작성자는 Nathan Rossi입니다.

INA228·INA237·INA238과 SQ52206은 I2C 주소 `0x40`부터 `0x4f`를 사용하며 접두사는 각각 `ina228`, `ina237`, `ina238`, `SQ52206`입니다. INA700과 INA780은 원문에 데이터시트 링크만 명시되어 있습니다.

INA238 계열
칩접두사주소
Texas Instruments INA228ina228I2C 0x40-0x4f
Texas Instruments INA237ina237I2C 0x40-0x4f
Texas Instruments INA238ina238I2C 0x40-0x4f
Texas Instruments INA700원문 미기재원문 미기재
Texas Instruments INA780원문 미기재원문 미기재
Silergy SQ52206SQ52206I2C 0x40-0x4f

원문의 지원 칩, 접두사, 주소 정보를 그대로 구분했습니다.

계열 장치 식별
칩 모델 확인I2C 주소 또는 플랫폼 정보 확인모델 접두사 선택공통 INA238 계열 드라이버 probe변형별 기능 활성화

호환 칩과 버스 정보를 확인해 공통 드라이버에 연결합니다.

.. SPDX-License-Identifier: GPL-2.0-only

Kernel driver ina238
====================

Supported chips:

  * Texas Instruments INA228

    Prefix: 'ina228'

    Addresses: I2C 0x40 - 0x4f

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

  * Texas Instruments INA237

    Prefix: 'ina237'

    Addresses: I2C 0x40 - 0x4f

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

  * Texas Instruments INA238

    Prefix: 'ina238'

    Addresses: I2C 0x40 - 0x4f

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

  * Texas Instruments INA700

    Datasheet:
        https://www.ti.com/product/ina700

  * Texas Instruments INA780

    Datasheet:
        https://www.ti.com/product/ina780a

  * Silergy SQ52206

    Prefix: 'SQ52206'

    Addresses: I2C 0x40 - 0x4f

Author: Nathan Rossi <nathan.rossi@digi.com>

전류 shunt 감시 기능과 변형별 차이

52-74

INA238은 I2C 인터페이스를 가진 전류 shunt, 전력, 온도 모니터입니다. 경보, 변환률, 샘플 평균, 선택 가능한 shunt 전압 정확도 등 여러 기능을 프로그래밍할 수 있습니다.

Micro-ohms 단위 shunt 값은 플랫폼 코드나 장치 트리 데이터의 장치 속성으로 설정할 수 있습니다. 장치 트리를 사용할 때는 `Documentation/devicetree/bindings/hwmon/ti,ina2xx.yaml`을 따라야 합니다.

INA237은 정확도가 약간 다른 INA238의 기능적 동등 변형입니다. INA228은 ADC 해상도가 더 높은 변형이며 에너지도 보고합니다. INA700과 INA780은 shunt 저항을 내장한 계열 변형이고 역시 에너지를 보고합니다. Silergy SQ52206은 대부분 호환되며 에너지와 peak power consumption을 함께 보고합니다.

변형별 특징
변형특징
INA238전류 shunt·전력·온도, 경보·변환률·평균·정확도 설정
INA237기능적으로 동등, 정확도 차이
INA228더 높은 ADC 해상도, 에너지 보고
INA700Shunt 저항 내장, 에너지 보고
INA780Shunt 저항 내장, 에너지 보고
SQ52206대부분 호환, 에너지와 peak power 보고

기본 INA238과 비교한 기능 차이를 정리했습니다.

Shunt 측정 구성
Micro-ohm shunt 값 지정변환률과 평균 설정Shunt 전압 정확도 선택전류·전력·온도 변환지원 변형은 에너지·peak power 추가

저항값과 변환 설정이 전류·전력 계산으로 이어집니다.


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

The INA238 is a current shunt, power and temperature monitor with an I2C
interface. It includes a number of programmable functions including alerts,
conversion rate, sample averaging and selectable shunt voltage accuracy.

The shunt value in micro-ohms can be set via device properties, either from
platform code or from device tree data. Please refer to
Documentation/devicetree/bindings/hwmon/ti,ina2xx.yaml for bindings if
device tree is used.

INA237 is a functionally equivalent variant of INA238 with slightly
different accuracy. INA228 is another variant of INA238 with higher ADC
resolution. This chip also reports the energy.

INA700 and INA780 are variants of the chip series with built-in shunt resistor.
They also report the energy.

SQ52206 is a mostly compatible chip from Sylergy. It reports the energy
as well as the peak power consumption.

INA238 계열 sysfs 속성

75-109

Shunt 전압 `in0`과 bus 전압 `in1`은 mV 단위 현재값, 최소·최대 임계값, 최소·최대 경보를 제공합니다. 원문 표의 `in1_min_alarm`과 `in1_max_alarm` 설명은 각각 `Minimum shunt voltage alarm`, `Maximum shunt voltage alarm`으로 기재되어 있으며 여기서는 원문 표현을 보존합니다.

전력에는 uW 단위 `power1_input`, 최대 임계값과 경보가 있습니다. `power1_input_highest`는 SQ52206에서만 제공하는 peak power입니다. 전류에는 mA 단위 현재값, 최소·최대 임계값과 경보가 있습니다.

`energy1_input`은 uJ 단위 에너지 측정값이며 원문 sysfs 표에는 SQ52206, INA237, INA780에서만 제공된다고 적혀 있습니다. `temp1_input`, `temp1_max`, `temp1_max_alarm`은 각각 mC 단위 die 온도, 최대 임계값, 최대 온도 경보입니다.

INA238 계열 sysfs
센서군속성단위·조건
Shunt 전압in0_input / in0_min / in0_min_alarm / in0_max / in0_max_alarmmV
Bus 전압in1_input / in1_min / in1_min_alarm / in1_max / in1_max_alarmmV
전력power1_input / power1_max / power1_max_alarmuW
Peak powerpower1_input_highestuW, SQ52206 only
전류curr1_input / curr1_min / curr1_min_alarm / curr1_max / curr1_max_alarmmA
에너지energy1_inputuJ, 원문 표: SQ52206·INA237·INA780 only
Die 온도temp1_input / temp1_max / temp1_max_alarmmC

센서군별 측정값, 임계값, 변형 제한을 정리했습니다.

INA238 경보와 누적값
Shunt·bus 전압 읽기전류·전력 계산최소·최대 임계 경보 평가지원 변형에서 에너지·peak power 읽기Die 온도 경보 확인

현재 측정값을 변형별 임계·에너지 기능과 함께 게시합니다.

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

======================= =======================================================
in0_input                Shunt voltage (mV)
in0_min                        Minimum shunt voltage threshold (mV)
in0_min_alarm                Minimum shunt voltage alarm
in0_max                        Maximum shunt voltage threshold (mV)
in0_max_alarm                Maximum shunt voltage alarm

in1_input                Bus voltage (mV)
in1_min                        Minimum bus voltage threshold (mV)
in1_min_alarm                Minimum shunt voltage alarm
in1_max                        Maximum bus voltage threshold (mV)
in1_max_alarm                Maximum shunt voltage alarm

power1_input                Power measurement (uW)
power1_max                Maximum power threshold (uW)
power1_max_alarm        Maximum power alarm
power1_input_highest        Peak Power (uW)
                                (SQ52206 only)

curr1_input                Current measurement (mA)
curr1_min                Minimum current threshold (mA)
curr1_min_alarm                Minimum current alarm
curr1_max                Maximum current threshold (mA)
curr1_max_alarm                Maximum current alarm

energy1_input                Energy measurement (uJ)
                                (SQ52206, INA237, and INA780 only)

temp1_input                Die temperature measurement (mC)
temp1_max                Maximum die temperature threshold (mC)
temp1_max_alarm                Maximum die temperature alarm
======================= =======================================================