요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
.. SPDX-License-Identifier: GPL-2.0-only
3
Kernel driver ina238
4
====================
6
Supported chips:
8
* Texas Instruments INA228
10
Prefix: 'ina228'
12
Addresses: I2C 0x40 - 0x4f
14
Datasheet:
15
https://www.ti.com/lit/gpn/ina228
17
* Texas Instruments INA237
19
Prefix: 'ina237'
21
Addresses: I2C 0x40 - 0x4f
23
Datasheet:
24
https://www.ti.com/lit/gpn/ina237
26
* Texas Instruments INA238
28
Prefix: 'ina238'
30
Addresses: I2C 0x40 - 0x4f
32
Datasheet:
33
https://www.ti.com/lit/gpn/ina238
35
* Texas Instruments INA700
37
Datasheet:
38
https://www.ti.com/product/ina700
40
* Texas Instruments INA780
42
Datasheet:
43
https://www.ti.com/product/ina780a
45
* Silergy SQ52206
47
Prefix: 'SQ52206'
49
Addresses: I2C 0x40 - 0x4f
51
Author: Nathan Rossi <[email protected]>
53
Description
54
-----------
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.
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.
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.
69
INA700 and INA780 are variants of the chip series with built-in shunt resistor.
70
They also report the energy.
72
SQ52206 is a mostly compatible chip from Sylergy. It reports the energy
73
as well as the peak power consumption.
75
Sysfs entries
76
-------------
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
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
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)
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
103
energy1_input Energy measurement (uJ)
104
(SQ52206, INA237, and INA780 only)
106
temp1_input Die temperature measurement (mC)
107
temp1_max Maximum die temperature threshold (mC)
108
temp1_max_alarm Maximum die temperature alarm
109
======================= =======================================================
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
INA238 계열 지원 칩과 주소
1-51GPL-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은 원문에 데이터시트 링크만 명시되어 있습니다.
칩접두사주소
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 <[email protected]>전류 shunt 감시 기능과 변형별 차이
52-74INA238은 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과 비교한 기능 차이를 정리했습니다.
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-109Shunt 전압 `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 온도, 최대 임계값, 최대 온도 경보입니다.
센서군속성단위·조건
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
센서군별 측정값, 임계값, 변형 제한을 정리했습니다.
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
======================= =======================================================
요약·해설
ina238.rst:1-109공통 shunt 측정과 임계 경보를 제공하고 변형에 따라 에너지, 내장 shunt, peak power 기능을 추가합니다.
원문 분량과 핵심 기능입니다.
장치 설정에서 hwmon 값까지의 핵심 순서입니다.