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

Linux 6.18.37 · Hardware Monitoring

Kernel driver ucd9200

UCD9200 다중 레일·다중 위상 PWM 컨트롤러의 입력·출력 텔레메트리와 활성 레일별 속성을 설명합니다.

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

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

1. 요약·해설

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

요약·해설

ucd9200.rst:1-124

UCD9200 계열은 비절연 DC/DC용 디지털 PWM 컨트롤러로 입력과 활성 출력 레일의 전압·전류·전력·온도를 PMBus로 제공합니다.

문서 개요
항목값
SourceDocumentation/hwmon/ucd9200.rst
분량124 source lines
지원 칩7
출력 속성활성 레일별

원문 분량과 핵심 기능을 요약합니다.

동작 흐름
장치 명시적 생성활성 레일 확인입력 텔레메트리 측정출력별 측정조건부 온도·팬 속성 생성

장치 초기화부터 측정·상태 제공까지의 순서입니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 Kernel driver ucd9200
2 =====================
3
4 Supported chips:
5
6 * TI UCD9220, UCD9222, UCD9224, UCD9240, UCD9244, UCD9246, and UCD9248
7
8 Prefixes: 'ucd9220', 'ucd9222', 'ucd9224', 'ucd9240', 'ucd9244', 'ucd9246',
9 'ucd9248'
10
11 Addresses scanned: -
12
13 Datasheets:
14
15 - http://focus.ti.com/lit/ds/symlink/ucd9220.pdf
16 - http://focus.ti.com/lit/ds/symlink/ucd9222.pdf
17 - http://focus.ti.com/lit/ds/symlink/ucd9224.pdf
18 - http://focus.ti.com/lit/ds/symlink/ucd9240.pdf
19 - http://focus.ti.com/lit/ds/symlink/ucd9244.pdf
20 - http://focus.ti.com/lit/ds/symlink/ucd9246.pdf
21 - http://focus.ti.com/lit/ds/symlink/ucd9248.pdf
22
23 Author: Guenter Roeck <[email protected]>
24
25
26 Description
27 -----------
28
29 [From datasheets] UCD9220, UCD9222, UCD9224, UCD9240, UCD9244, UCD9246, and
30 UCD9248 are multi-rail, multi-phase synchronous buck digital PWM controllers
31 designed for non-isolated DC/DC power applications. The devices integrate
32 dedicated circuitry for DC/DC loop management with flash memory and a serial
33 interface to support configuration, monitoring and management.
34
35 This driver is a client driver to the core PMBus driver. Please see
36 Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
37
38
39 Usage Notes
40 -----------
41
42 This driver does not auto-detect devices. You will have to instantiate the
43 devices explicitly. Please see Documentation/i2c/instantiating-devices.rst for
44 details.
45
46
47 Platform data support
48 ---------------------
49
50 The driver supports standard PMBus driver platform data. Please see
51 Documentation/hwmon/pmbus.rst for details.
52
53
54 Sysfs entries
55 -------------
56
57 The following attributes are supported. Limits are read-write; all other
58 attributes are read-only.
59
60 ======================= ========================================================
61 in1_label "vin".
62 in1_input Measured voltage. From READ_VIN register.
63 in1_min Minimum Voltage. From VIN_UV_WARN_LIMIT register.
64 in1_max Maximum voltage. From VIN_OV_WARN_LIMIT register.
65 in1_lcrit Critical minimum Voltage. VIN_UV_FAULT_LIMIT register.
66 in1_crit Critical maximum voltage. From VIN_OV_FAULT_LIMIT
67 register.
68 in1_min_alarm Voltage low alarm. From VIN_UV_WARNING status.
69 in1_max_alarm Voltage high alarm. From VIN_OV_WARNING status.
70 in1_lcrit_alarm Voltage critical low alarm. From VIN_UV_FAULT status.
71 in1_crit_alarm Voltage critical high alarm. From VIN_OV_FAULT status.
72
73 in[2-5]_label "vout[1-4]".
74 in[2-5]_input Measured voltage. From READ_VOUT register.
75 in[2-5]_min Minimum Voltage. From VOUT_UV_WARN_LIMIT register.
76 in[2-5]_max Maximum voltage. From VOUT_OV_WARN_LIMIT register.
77 in[2-5]_lcrit Critical minimum Voltage. VOUT_UV_FAULT_LIMIT register.
78 in[2-5]_crit Critical maximum voltage. From VOUT_OV_FAULT_LIMIT
79 register.
80 in[2-5]_min_alarm Voltage low alarm. From VOLTAGE_UV_WARNING status.
81 in[2-5]_max_alarm Voltage high alarm. From VOLTAGE_OV_WARNING status.
82 in[2-5]_lcrit_alarm Voltage critical low alarm. From VOLTAGE_UV_FAULT
83 status.
84 in[2-5]_crit_alarm Voltage critical high alarm. From VOLTAGE_OV_FAULT
85 status.
86
87 curr1_label "iin".
88 curr1_input Measured current. From READ_IIN register.
89
90 curr[2-5]_label "iout[1-4]".
91 curr[2-5]_input Measured current. From READ_IOUT register.
92 curr[2-5]_max Maximum current. From IOUT_OC_WARN_LIMIT register.
93 curr[2-5]_lcrit Critical minimum output current. From
94 IOUT_UC_FAULT_LIMIT register.
95 curr[2-5]_crit Critical maximum current. From IOUT_OC_FAULT_LIMIT
96 register.
97 curr[2-5]_max_alarm Current high alarm. From IOUT_OC_WARNING status.
98 curr[2-5]_crit_alarm Current critical high alarm. From IOUT_OC_FAULT status.
99
100 power1_input Measured input power. From READ_PIN register.
101 power1_label "pin"
102
103 power[2-5]_input Measured output power. From READ_POUT register.
104 power[2-5]_label "pout[1-4]"
105
106 The number of output voltage, current, and power
107 attribute sets is determined by the number of enabled
108 rails. See chip datasheets for details.
109
110 temp[1-5]_input Measured temperatures. From READ_TEMPERATURE_1 and
111 READ_TEMPERATURE_2 registers.
112 temp1 is the chip internal temperature. temp[2-5] are
113 rail temperatures. temp[2-5] attributes are only
114 created for enabled rails. See chip datasheets for
115 details.
116 temp[1-5]_max Maximum temperature. From OT_WARN_LIMIT register.
117 temp[1-5]_crit Critical high temperature. From OT_FAULT_LIMIT register.
118 temp[1-5]_max_alarm Temperature high alarm.
119 temp[1-5]_crit_alarm Temperature critical high alarm.
120
121 fan1_input Fan RPM. ucd9240 only.
122 fan1_alarm Fan alarm. ucd9240 only.
123 fan1_fault Fan fault. ucd9240 only.
124 ======================= ========================================================
125

3. 한국어 전문 번역

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

지원 컨트롤러

1-25

이 드라이버는 TI UCD9220, UCD9222, UCD9224, UCD9240, UCD9244, UCD9246, UCD9248을 지원합니다. 각 소문자 칩 이름이 접두사로 사용됩니다.

자동으로 스캔하는 주소는 없습니다. 원문은 각 칩의 TI 데이터시트 링크를 제공하며 작성자는 Guenter Roeck입니다.

UCD9200 계열 지원표
칩접두사
UCD9220`ucd9220`
UCD9222`ucd9222`
UCD9224`ucd9224`
UCD9240`ucd9240`
UCD9244/UCD9246/UCD9248`ucd9244` / `ucd9246` / `ucd9248`

지원 칩과 접두사를 정리합니다.

UCD9200 변형 선택
장치 명시적 생성칩 이름과 접두사 확인출력 레일 수 확인센서 페이지 구성PMBus hwmon 등록

명시한 칩 이름으로 PMBus 구성을 선택합니다.

Kernel driver ucd9200
=====================

Supported chips:

  * TI UCD9220, UCD9222, UCD9224, UCD9240, UCD9244, UCD9246, and UCD9248

    Prefixes: 'ucd9220', 'ucd9222', 'ucd9224', 'ucd9240', 'ucd9244', 'ucd9246',
    'ucd9248'

    Addresses scanned: -

    Datasheets:

        - http://focus.ti.com/lit/ds/symlink/ucd9220.pdf
        - http://focus.ti.com/lit/ds/symlink/ucd9222.pdf
        - http://focus.ti.com/lit/ds/symlink/ucd9224.pdf
        - http://focus.ti.com/lit/ds/symlink/ucd9240.pdf
        - http://focus.ti.com/lit/ds/symlink/ucd9244.pdf
        - http://focus.ti.com/lit/ds/symlink/ucd9246.pdf
        - http://focus.ti.com/lit/ds/symlink/ucd9248.pdf

Author: Guenter Roeck <[email protected]>

디지털 PWM과 사용 방법

26-53

UCD9220, UCD9222, UCD9224, UCD9240, UCD9244, UCD9246, UCD9248은 비절연 DC/DC 전원용 다중 레일·다중 위상 동기식 강압 디지털 PWM 컨트롤러입니다.

이 장치들은 DC/DC 루프 관리 전용 회로와 플래시 메모리, 직렬 인터페이스를 통합해 구성·감시·관리를 지원합니다.

드라이버는 PMBus 코어의 클라이언트이며 `Documentation/hwmon/pmbus.rst`의 공통 규칙을 따릅니다. 자동 탐지는 하지 않으므로 `Documentation/i2c/instantiating-devices.rst`에 따라 장치를 명시적으로 생성해야 합니다. 표준 PMBus 드라이버 플랫폼 데이터도 지원합니다.

UCD9200 기능 구성
영역기능
전력 변환다중 레일·다중 위상 동기식 buck
대상비절연 DC/DC 전원
통합 기능루프 관리 회로, 플래시, 직렬 인터페이스
드라이버PMBus 코어 클라이언트
검색자동 탐지 없음, 명시적 생성

컨트롤러의 목적과 소프트웨어 연결을 요약합니다.

UCD9200 사용 흐름
보드에서 I2C 장치 선언표준 PMBus 플랫폼 데이터 전달칩별 레일 구성 읽기측정·한계·상태 레지스터 연결hwmon 속성 생성

설정된 장치를 PMBus hwmon 인터페이스로 연결합니다.

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

[From datasheets] UCD9220, UCD9222, UCD9224, UCD9240, UCD9244, UCD9246, and
UCD9248 are multi-rail, multi-phase synchronous buck digital PWM controllers
designed for non-isolated DC/DC power applications. The devices integrate
dedicated circuitry for DC/DC loop management with flash memory and a serial
interface to support configuration, monitoring and management.

This 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. Please see
Documentation/hwmon/pmbus.rst for details.

입출력 전압 속성

54-99

지원 속성 가운데 한계는 읽기·쓰기가 가능하며, 그 밖의 속성은 읽기 전용입니다. `in1_label`은 `vin`, `in1_input`은 `READ_VIN`의 입력 전압입니다.

입력 전압의 경고 최소·최대는 `VIN_UV_WARN_LIMIT`, `VIN_OV_WARN_LIMIT`, 임계 최소·최대는 `VIN_UV_FAULT_LIMIT`, `VIN_OV_FAULT_LIMIT`에서 옵니다. 저전압·과전압 warning과 fault 상태는 각 alarm 파일로 표시됩니다.

`in[2-5]_label`은 `vout[1-4]`이고 측정값은 `READ_VOUT`입니다. 출력 전압의 경고·fault 한계는 `VOUT_UV_WARN_LIMIT`, `VOUT_OV_WARN_LIMIT`, `VOUT_UV_FAULT_LIMIT`, `VOUT_OV_FAULT_LIMIT`에서 읽으며 대응 warning·fault alarm을 제공합니다.

UCD9200 전압 매핑
sysfs라벨측정/한계 원천
`in1_*``vin``READ_VIN`, `VIN_*_LIMIT`
`in[2-5]_input``vout[1-4]``READ_VOUT`
`in[2-5]_min/max`출력 경고 한계`VOUT_UV/OV_WARN_LIMIT`
`in[2-5]_lcrit/crit`출력 fault 한계`VOUT_UV/OV_FAULT_LIMIT`
`*_alarm`warning/fault 상태`VOLTAGE_*` 상태

입력과 출력 레일의 sysfs 인덱스를 구분합니다.

전압 상태 보고
`READ_VIN`으로 입력 전압 읽기VIN 경고·fault 한계 연결활성 레일별 `READ_VOUT` 읽기VOUT 경고·fault 상태 평가`in1`과 `in[2-5]` 속성 제공

입력과 활성 출력 레일을 별도 인덱스로 노출합니다.

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

The following attributes are supported. Limits are read-write; all other
attributes are read-only.

======================= ========================================================
in1_label                "vin".
in1_input                Measured voltage. From READ_VIN register.
in1_min                        Minimum Voltage. From VIN_UV_WARN_LIMIT register.
in1_max                        Maximum voltage. From VIN_OV_WARN_LIMIT register.
in1_lcrit                Critical minimum Voltage. VIN_UV_FAULT_LIMIT register.
in1_crit                Critical maximum voltage. From VIN_OV_FAULT_LIMIT
                        register.
in1_min_alarm                Voltage low alarm. From VIN_UV_WARNING status.
in1_max_alarm                Voltage high alarm. From VIN_OV_WARNING status.
in1_lcrit_alarm                Voltage critical low alarm. From VIN_UV_FAULT status.
in1_crit_alarm                Voltage critical high alarm. From VIN_OV_FAULT status.

in[2-5]_label                "vout[1-4]".
in[2-5]_input                Measured voltage. From READ_VOUT register.
in[2-5]_min                Minimum Voltage. From VOUT_UV_WARN_LIMIT register.
in[2-5]_max                Maximum voltage. From VOUT_OV_WARN_LIMIT register.
in[2-5]_lcrit                Critical minimum Voltage. VOUT_UV_FAULT_LIMIT register.
in[2-5]_crit                Critical maximum voltage. From VOUT_OV_FAULT_LIMIT
                        register.
in[2-5]_min_alarm        Voltage low alarm. From VOLTAGE_UV_WARNING status.
in[2-5]_max_alarm        Voltage high alarm. From VOLTAGE_OV_WARNING status.
in[2-5]_lcrit_alarm        Voltage critical low alarm. From VOLTAGE_UV_FAULT
                        status.
in[2-5]_crit_alarm        Voltage critical high alarm. From VOLTAGE_OV_FAULT
                        status.

curr1_label                "iin".
curr1_input                Measured current. From READ_IIN register.

curr[2-5]_label                "iout[1-4]".
curr[2-5]_input                Measured current. From READ_IOUT register.
curr[2-5]_max                Maximum current. From IOUT_OC_WARN_LIMIT register.
curr[2-5]_lcrit                Critical minimum output current. From
                        IOUT_UC_FAULT_LIMIT register.
curr[2-5]_crit                Critical maximum current. From IOUT_OC_FAULT_LIMIT
                        register.
curr[2-5]_max_alarm        Current high alarm. From IOUT_OC_WARNING status.
curr[2-5]_crit_alarm        Current critical high alarm. From IOUT_OC_FAULT status.

전류·전력·온도·팬

100-124

`curr1_label`은 `iin`, `curr1_input`은 `READ_IIN`에서 읽은 입력 전류입니다. `curr[2-5]`는 `iout[1-4]` 출력 전류이며 `READ_IOUT` 측정값과 `IOUT_OC_WARN_LIMIT`, `IOUT_UC_FAULT_LIMIT`, `IOUT_OC_FAULT_LIMIT`의 한계, 과전류 warning·fault alarm을 제공합니다.

`power1_input`과 라벨 `pin`은 `READ_PIN` 입력 전력입니다. `power[2-5]_input`과 `pout[1-4]` 라벨은 `READ_POUT` 출력 전력입니다. 출력 전압·전류·전력 속성 세트의 수는 활성화된 레일 수에 따라 결정됩니다.

`temp[1-5]_input`은 `READ_TEMPERATURE_1/2`의 측정값입니다. `temp1`은 칩 내부 온도이고 `temp[2-5]`는 레일 온도이므로 활성 레일에만 생성됩니다. `OT_WARN_LIMIT`, `OT_FAULT_LIMIT`의 최대·임계 한계와 고온 경보를 제공합니다.

`fan1_input`, `_alarm`, `_fault`는 UCD9240에서만 사용할 수 있는 팬 RPM·경보·고장 속성입니다.

UCD9200 비전압 센서
영역sysfs원천/조건
입력 전류`curr1_input` (`iin`)`READ_IIN`
출력 전류`curr[2-5]_*` (`iout[1-4]`)`READ_IOUT`, 활성 레일
전력`power1`, `power[2-5]``READ_PIN`, `READ_POUT`
온도`temp1`, `temp[2-5]`내부 온도와 활성 레일 온도
팬`fan1_*`UCD9240 전용

전류·전력·온도·팬의 인덱스와 조건입니다.

활성 레일별 속성 생성
활성 출력 레일 수 읽기레일별 전류·전력 측정내부·레일 온도 구성UCD9240이면 팬 속성 추가조건에 맞는 sysfs 세트 생성

하드웨어에 실제 활성화된 레일만 사용자 공간에 노출합니다.

power1_input                Measured input power. From READ_PIN register.
power1_label                "pin"

power[2-5]_input        Measured output power. From READ_POUT register.
power[2-5]_label        "pout[1-4]"

                        The number of output voltage, current, and power
                        attribute sets is determined by the number of enabled
                        rails. See chip datasheets for details.

temp[1-5]_input                Measured temperatures. From READ_TEMPERATURE_1 and
                        READ_TEMPERATURE_2 registers.
                        temp1 is the chip internal temperature. temp[2-5] are
                        rail temperatures.  temp[2-5] attributes are only
                        created for enabled rails. See chip datasheets for
                        details.
temp[1-5]_max                Maximum temperature. From OT_WARN_LIMIT register.
temp[1-5]_crit                Critical high temperature. From OT_FAULT_LIMIT register.
temp[1-5]_max_alarm        Temperature high alarm.
temp[1-5]_crit_alarm        Temperature critical high alarm.

fan1_input                Fan RPM. ucd9240 only.
fan1_alarm                Fan alarm. ucd9240 only.
fan1_fault                Fan fault. ucd9240 only.
======================= ========================================================