요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
.. SPDX-License-Identifier: GPL-2.0-or-later
Kernel driver isl28022
======================
Supported chips:
* Renesas ISL28022
Prefix: 'isl28022'
Addresses scanned: none
Datasheet: Publicly available at the Renesas website
https://www.renesas.com/us/en/www/doc/datasheet/isl28022.pdf
Author:
Carsten Spieß <mail@carsten-spiess.de>
Description
-----------
The ISL28022 is a power monitor with I2C interface. The device monitors
voltage, current via shunt resistor and calculated power.
Usage Notes
-----------
This driver does not auto-detect devices. You will have to instantiate the
device explicitly. Please see Documentation/i2c/instantiating-devices.rst for
details.
The shunt value in micro-ohms, shunt voltage range and averaging can be set
with device properties.
Please refer to the Documentation/devicetree/bindings/hwmon/renesas,isl28022.yaml
for bindings if the device tree is used.
The driver supports only shunt and bus continuous ADC mode at 15bit resolution.
Averaging can be set from 1 to 128 samples (power of 2) on both channels.
Shunt voltage range of 40, 80, 160 or 320mV is allowed
The bus voltage range is 60V fixed.
Sysfs entries
-------------
The following attributes are supported. All attributes are read-only.
======================= =======================================================
in0_input bus voltage (milli Volt)
in1_input shunt voltage (milli Volt)
curr1_input current (milli Ampere)
power1_input power (micro Watt)
======================= =======================================================
Debugfs entries
---------------
The following attributes are supported. All attributes are read-only.
======================= =======================================================
shunt_voltage shunt voltage (micro Volt)
======================= =======================================================
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
ISL28022 지원 장치와 자료
1-20이 문서는 GPL-2.0-or-later 라이선스의 `isl28022` 커널 드라이버를 설명합니다. 지원 칩은 Renesas ISL28022이고 드라이버 접두사는 `isl28022`입니다. 주소 자동 검색은 하지 않습니다.
데이터시트는 문서에 적힌 Renesas 공개 링크에서 확인할 수 있으며 작성자는 Carsten Spieß입니다. 전류 계산에 션트 저항값이 직접 쓰이므로 데이터시트와 보드 회로의 션트 사양을 함께 확인해야 합니다.
장치 등록과 계산에 필요한 기본 정보입니다.
하드웨어 값과 소프트웨어 속성을 연결합니다.
.. SPDX-License-Identifier: GPL-2.0-or-later
Kernel driver isl28022
======================
Supported chips:
* Renesas ISL28022
Prefix: 'isl28022'
Addresses scanned: none
Datasheet: Publicly available at the Renesas website
https://www.renesas.com/us/en/www/doc/datasheet/isl28022.pdf
Author:
Carsten Spieß <mail@carsten-spiess.de>
전력 측정과 ADC 구성
21-43ISL28022는 I2C 인터페이스를 갖춘 전력 모니터입니다. 버스 전압과 션트 저항 양단의 전압을 측정하고, 션트 전압과 저항값으로 전류를 계산한 뒤 전압과 전류에서 전력을 계산합니다.
드라이버는 장치를 자동 감지하지 않으므로 명시적으로 인스턴스화해야 합니다. 자세한 등록 방법은 `Documentation/i2c/instantiating-devices.rst`를 참고합니다.
마이크로옴 단위 션트 저항값, 션트 전압 범위, 평균화 설정은 device properties로 지정할 수 있습니다. 장치 트리를 사용하면 `Documentation/devicetree/bindings/hwmon/renesas,isl28022.yaml` 바인딩을 따라야 합니다.
드라이버는 15비트 분해능의 션트·버스 연속 ADC 모드만 지원합니다. 두 채널 모두 1개부터 128개까지 2의 거듭제곱 개수로 평균화할 수 있습니다. 션트 전압 범위는 40, 80, 160, 320mV 중 하나이고 버스 전압 범위는 60V로 고정됩니다.
드라이버가 지원하는 ADC와 보드별 속성입니다.
센서 입력에서 전류와 전력을 계산하는 관계입니다.
Description
-----------
The ISL28022 is a power monitor with I2C interface. The device monitors
voltage, current via shunt resistor and calculated power.
Usage Notes
-----------
This driver does not auto-detect devices. You will have to instantiate the
device explicitly. Please see Documentation/i2c/instantiating-devices.rst for
details.
The shunt value in micro-ohms, shunt voltage range and averaging can be set
with device properties.
Please refer to the Documentation/devicetree/bindings/hwmon/renesas,isl28022.yaml
for bindings if the device tree is used.
The driver supports only shunt and bus continuous ADC mode at 15bit resolution.
Averaging can be set from 1 to 128 samples (power of 2) on both channels.
Shunt voltage range of 40, 80, 160 or 320mV is allowed
The bus voltage range is 60V fixed.
ISL28022 sysfs와 debugfs 항목
44-64아래 sysfs 속성은 모두 읽기 전용입니다. `in0_input`은 밀리볼트 단위 버스 전압, `in1_input`은 밀리볼트 단위 션트 전압을 제공합니다. `curr1_input`은 밀리암페어 단위 전류, `power1_input`은 마이크로와트 단위 전력을 제공합니다.
debugfs의 `shunt_voltage`도 읽기 전용이며 션트 전압을 마이크로볼트 단위로 제공합니다. 같은 물리량을 sysfs에서는 밀리볼트, debugfs에서는 마이크로볼트로 표현하므로 단위를 혼동하지 않아야 합니다.
파일 위치별 물리량과 단위를 원문대로 정리했습니다.
단위를 확인하면서 버스와 션트 측정값을 읽습니다.
Sysfs entries
-------------
The following attributes are supported. All attributes are read-only.
======================= =======================================================
in0_input bus voltage (milli Volt)
in1_input shunt voltage (milli Volt)
curr1_input current (milli Ampere)
power1_input power (micro Watt)
======================= =======================================================
Debugfs entries
---------------
The following attributes are supported. All attributes are read-only.
======================= =======================================================
shunt_voltage shunt voltage (micro Volt)
======================= =======================================================
요약·해설
isl28022.rst:1-64ISL28022는 버스 전압과 션트 전압을 연속 변환해 전류와 전력을 계산하고 sysfs와 debugfs에 읽기 전용으로 제공합니다.
원문 분량과 핵심 인터페이스입니다.
장치 등록에서 측정값 게시까지의 핵심 순서입니다.