요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
Kernel driver tps40422
======================
Supported chips:
* TI TPS40422
Prefix: 'tps40422'
Addresses scanned: -
Datasheet: https://www.ti.com/lit/gpn/tps40422
Author: Zhu Laiwen <[email protected]>
Description
-----------
This driver supports TI TPS40422 Dual-Output or Two-Phase Synchronous Buck
Controller with PMBus
The driver is a client driver to the core PMBus driver.
Please see Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
Usage Notes
-----------
This driver does not auto-detect devices. You will have to instantiate the
devices explicitly. Please see Documentation/i2c/instantiating-devices.rst for
details.
Platform data support
---------------------
The driver supports standard PMBus driver platform data.
Sysfs entries
-------------
The following attributes are supported.
======================= =======================================================
in[1-2]_label "vout[1-2]"
in[1-2]_input Measured voltage. From READ_VOUT register.
in[1-2]_alarm voltage alarm.
curr[1-2]_input Measured current. From READ_IOUT register.
curr[1-2]_label "iout[1-2]"
curr1_max Maximum current. From IOUT_OC_WARN_LIMIT register.
curr1_crit Critical maximum current. From IOUT_OC_FAULT_LIMIT
register.
curr1_max_alarm Current high alarm. From IOUT_OC_WARN_LIMIT status.
curr1_crit_alarm Current critical high alarm. From IOUT_OC_FAULT status.
curr2_alarm Current high alarm. From IOUT_OC_WARNING status.
temp1_input Measured temperature. From READ_TEMPERATURE_2 register
on page 0.
temp1_max Maximum temperature. From OT_WARN_LIMIT register.
temp1_crit Critical high temperature. From OT_FAULT_LIMIT register.
temp1_max_alarm Chip temperature high alarm. Set by comparing
READ_TEMPERATURE_2 on page 0 with OT_WARN_LIMIT if
TEMP_OT_WARNING status is set.
temp1_crit_alarm Chip temperature critical high alarm. Set by comparing
READ_TEMPERATURE_2 on page 0 with OT_FAULT_LIMIT if
TEMP_OT_FAULT status is set.
temp2_input Measured temperature. From READ_TEMPERATURE_2 register
on page 1.
temp2_alarm Chip temperature alarm on page 1.
======================= =======================================================
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
PMBus 클라이언트와 장치 생성
1-40`tps40422` 드라이버는 TI TPS40422를 지원하며 자동 검색 주소는 없습니다. 작성자는 Zhu Laiwen입니다.
TPS40422는 PMBus를 사용하는 듀얼 출력 또는 2상 동기식 벅 컨트롤러입니다. 이 드라이버는 핵심 PMBus 드라이버의 클라이언트이며 자세한 내용은 `Documentation/hwmon/pmbus.rst`를 참조하십시오.
드라이버는 장치를 자동 탐지하지 않으므로 명시적으로 생성해야 합니다. 방법은 `Documentation/i2c/instantiating-devices.rst`를 참조하십시오.
표준 PMBus 드라이버 플랫폼 데이터를 지원합니다.
드라이버 구조와 장치 생성 요구사항입니다.
명시적 I2C 생성 후 PMBus 코어에 연결합니다.
Kernel driver tps40422
======================
Supported chips:
* TI TPS40422
Prefix: 'tps40422'
Addresses scanned: -
Datasheet: https://www.ti.com/lit/gpn/tps40422
Author: Zhu Laiwen <[email protected]>
Description
-----------
This driver supports TI TPS40422 Dual-Output or Two-Phase Synchronous Buck
Controller with PMBus
The driver is a client driver to the core PMBus driver.
Please see Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
Usage Notes
-----------
This driver does not auto-detect devices. You will have to instantiate the
devices explicitly. Please see Documentation/i2c/instantiating-devices.rst for
details.
Platform data support
---------------------
The driver supports standard PMBus driver platform data.
전압·전류·온도 sysfs 항목
41-73출력 전압은 `in[1-2]_label`에 `vout1`·`vout2`를 표시하고 `in[1-2]_input`으로 `READ_VOUT` 측정값, `in[1-2]_alarm`으로 전압 경보를 제공합니다.
출력 전류는 `curr[1-2]_input`으로 `READ_IOUT` 측정값, `curr[1-2]_label`로 `iout1`·`iout2`를 제공합니다. `curr1_max`는 `IOUT_OC_WARN_LIMIT`, `curr1_crit`은 `IOUT_OC_FAULT_LIMIT`에서 읽습니다. `curr1_max_alarm`은 warning 상태, `curr1_crit_alarm`은 fault 상태이며 `curr2_alarm`은 `IOUT_OC_WARNING` 상태의 고전류 경보입니다.
`temp1_input`은 페이지 0의 `READ_TEMPERATURE_2`, `temp1_max`는 `OT_WARN_LIMIT`, `temp1_crit`은 `OT_FAULT_LIMIT`에서 읽습니다. `temp1_max_alarm`은 `TEMP_OT_WARNING` 상태일 때 페이지 0 측정값과 warning 한계를 비교해 설정하고, `temp1_crit_alarm`은 `TEMP_OT_FAULT` 상태일 때 fault 한계와 비교해 설정합니다.
`temp2_input`은 페이지 1의 `READ_TEMPERATURE_2`이고 `temp2_alarm`은 페이지 1의 칩 온도 경보입니다.
원문의 ASCII 표를 PMBus 레지스터·페이지와 함께 재구성했습니다.
두 PMBus 페이지의 전력단 상태를 분리해 노출합니다.
Sysfs entries
-------------
The following attributes are supported.
======================= =======================================================
in[1-2]_label "vout[1-2]"
in[1-2]_input Measured voltage. From READ_VOUT register.
in[1-2]_alarm voltage alarm.
curr[1-2]_input Measured current. From READ_IOUT register.
curr[1-2]_label "iout[1-2]"
curr1_max Maximum current. From IOUT_OC_WARN_LIMIT register.
curr1_crit Critical maximum current. From IOUT_OC_FAULT_LIMIT
register.
curr1_max_alarm Current high alarm. From IOUT_OC_WARN_LIMIT status.
curr1_crit_alarm Current critical high alarm. From IOUT_OC_FAULT status.
curr2_alarm Current high alarm. From IOUT_OC_WARNING status.
temp1_input Measured temperature. From READ_TEMPERATURE_2 register
on page 0.
temp1_max Maximum temperature. From OT_WARN_LIMIT register.
temp1_crit Critical high temperature. From OT_FAULT_LIMIT register.
temp1_max_alarm Chip temperature high alarm. Set by comparing
READ_TEMPERATURE_2 on page 0 with OT_WARN_LIMIT if
TEMP_OT_WARNING status is set.
temp1_crit_alarm Chip temperature critical high alarm. Set by comparing
READ_TEMPERATURE_2 on page 0 with OT_FAULT_LIMIT if
TEMP_OT_FAULT status is set.
temp2_input Measured temperature. From READ_TEMPERATURE_2 register
on page 1.
temp2_alarm Chip temperature alarm on page 1.
======================= =======================================================
요약·해설
tps40422.rst:1-73TPS40422는 명시적으로 생성하는 PMBus 클라이언트로 두 출력 페이지의 전압·전류·온도와 한계·경보를 제공합니다.
원문 분량과 핵심 기능을 요약합니다.
장치 초기화부터 측정·보호 상태 제공까지의 순서입니다.