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

Linux 6.18.37 · Hardware Monitoring

Kernel driver tps53679

TPS536xx 다상 강압 변환기의 변형별 전압·온도·전력·전류와 상별 텔레메트리를 설명합니다.

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

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

1. 요약·해설

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

요약·해설

tps53679.rst:1-195

TPS53679 계열은 최대 2개 출력과 채널당 최대 8상을 제공하며 변형별 채널 수와 상별 전류 텔레메트리가 다릅니다.

문서 개요
항목값
SourceDocumentation/hwmon/tps53679.rst
분량195 source lines
지원 칩7
상채널당 최대 8

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

동작 흐름
장치 명시적 생성변형 판별전압·온도 채널 구성전력·전류 매핑상별 텔레메트리 제공

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

2. 영어 원문 전체

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

원문 전체 펼치기
1 Kernel driver tps53679
2 ======================
3
4 Supported chips:
5
6 * Texas Instruments TPS53647
7
8 Prefix: 'tps53647'
9
10 Addresses scanned: -
11
12 Datasheet: https://www.ti.com/lit/gpn/tps53647
13
14 * Texas Instruments TPS53667
15
16 Prefix: 'tps53667'
17
18 Addresses scanned: -
19
20 Datasheet: https://www.ti.com/lit/gpn/TPS53667
21
22 * Texas Instruments TPS53676
23
24 Prefix: 'tps53676'
25
26 Addresses scanned: -
27
28 Datasheet: https://www.ti.com/lit/gpn/TPS53676
29
30 * Texas Instruments TPS53679
31
32 Prefix: 'tps53679'
33
34 Addresses scanned: -
35
36 Datasheet: https://www.ti.com/lit/gpn/TPS53679 (short version)
37
38 * Texas Instruments TPS53681
39
40 Prefix: 'tps53681'
41
42 Addresses scanned: -
43
44 Datasheet: https://www.ti.com/lit/gpn/TPS53681
45
46 * Texas Instruments TPS53685
47
48 Prefix: 'tps53685'
49
50 Addresses scanned: -
51
52 Datasheet: https://www.ti.com/lit/gpn/TPS53685
53
54 * Texas Instruments TPS53688
55
56 Prefix: 'tps53688'
57
58 Addresses scanned: -
59
60 Datasheet: Available under NDA
61
62
63 Authors:
64 Vadim Pasternak <[email protected]>
65 Guenter Roeck <[email protected]>
66
67
68 Description
69 -----------
70
71 Chips in this series are multi-phase step-down converters with one or two
72 output channels and up to 8 phases per channel.
73
74
75 Usage Notes
76 -----------
77
78 This driver does not probe for PMBus devices. You will have to instantiate
79 devices explicitly.
80
81 Example: the following commands will load the driver for an TPS53681 at address
82 0x60 on I2C bus #1::
83
84 # modprobe tps53679
85 # echo tps53681 0x60 > /sys/bus/i2c/devices/i2c-1/new_device
86
87
88 Sysfs attributes
89 ----------------
90
91 ======================= ========================================================
92 in1_label "vin"
93
94 in1_input Measured input voltage.
95
96 in1_lcrit Critical minimum input voltage
97
98 TPS53679, TPS53681, TPS53688 only.
99
100 in1_lcrit_alarm Input voltage critical low alarm.
101
102 TPS53679, TPS53681, TPS53688 only.
103
104 in1_crit Critical maximum input voltage.
105
106 in1_crit_alarm Input voltage critical high alarm.
107
108 in[N]_label "vout[1-2]"
109
110 - TPS53647, TPS53667: N=2
111 - TPS53679, TPS53588: N=2,3
112
113 in[N]_input Measured output voltage.
114
115 in[N]_lcrit Critical minimum input voltage.
116
117 TPS53679, TPS53681, TPS53688 only.
118
119 in[N]_lcrit_alarm Critical minimum voltage alarm.
120
121 TPS53679, TPS53681, TPS53688 only.
122
123 in[N]_alarm Output voltage alarm.
124
125 TPS53647, TPS53667 only.
126
127 in[N]_crit Critical maximum output voltage.
128
129 TPS53679, TPS53681, TPS53688 only.
130
131 in[N]_crit_alarm Output voltage critical high alarm.
132
133 TPS53679, TPS53681, TPS53688 only.
134
135 temp[N]_input Measured temperature.
136
137 - TPS53647, TPS53667: N=1
138 - TPS53679, TPS53681, TPS53588: N=1,2
139
140 temp[N]_max Maximum temperature.
141
142 temp[N]_crit Critical high temperature.
143
144 temp[N]_max_alarm Temperature high alarm.
145
146 temp[N]_crit_alarm Temperature critical high alarm.
147
148 power1_label "pin".
149
150 power1_input Measured input power.
151
152 power[N]_label "pout[1-2]".
153
154 - TPS53647, TPS53667: N=2
155 - TPS53676, TPS53679, TPS53681, TPS53588: N=2,3
156
157 power[N]_input Measured output power.
158
159 curr1_label "iin".
160
161 curr1_input Measured input current.
162
163 curr1_max Maximum input current.
164
165 curr1_max_alarm Input current high alarm.
166
167 curr1_crit Critical input current.
168
169 curr1_crit_alarm Input current critical alarm.
170
171 curr[N]_label "iout[1-2]" or "iout1.[0-5]".
172
173 The first digit is the output channel, the second
174 digit is the phase within the channel. Per-phase
175 telemetry supported on TPS53676 and TPS53681 only.
176
177 - TPS53647, TPS53667: N=2
178 - TPS53679, TPS53588: N=2,3
179 - TPS53676: N=2-8
180 - TPS53681: N=2-9
181
182 curr[N]_input Measured output current.
183
184 curr[N]_max Maximum output current.
185
186 curr[N]_crit Critical high output current.
187
188 curr[N]_max_alarm Output current high alarm.
189
190 curr[N]_crit_alarm Output current critical high alarm.
191
192 Limit and alarm attributes are only available for
193 non-phase telemetry (iout1, iout2).
194
195 ======================= ========================================================
196

3. 한국어 전문 번역

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

지원 칩과 작성자

1-67

`tps53679` 드라이버는 Texas Instruments TPS53647, TPS53667, TPS53676, TPS53679, TPS53681, TPS53685, TPS53688을 지원합니다. 자동 검색 주소는 없습니다.

접두사는 각 칩 이름의 소문자 형태입니다. TPS53679 데이터시트 링크는 짧은 버전이고 TPS53688 데이터시트는 NDA로 제공됩니다.

작성자는 Vadim Pasternak와 Guenter Roeck입니다.

TPS53679 계열 지원
칩접두사데이터시트
TPS53647tps53647공개
TPS53667tps53667공개
TPS53676tps53676공개
TPS53679tps53679공개, short version
TPS53681tps53681공개
TPS53685tps53685공개
TPS53688tps53688NDA

7개 변형의 접두사와 데이터시트 상태입니다.

TPS53679 계열 식별
지원 칩 이름으로 I2C 장치 생성`tps53679` 모듈 결합변형 ID 확인출력 채널·상 수 결정변형별 hwmon 속성 구성

명시적으로 생성한 PMBus 장치의 변형을 판별합니다.

Kernel driver tps53679
======================

Supported chips:

  * Texas Instruments TPS53647

    Prefix: 'tps53647'

    Addresses scanned: -

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

  * Texas Instruments TPS53667

    Prefix: 'tps53667'

    Addresses scanned: -

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

  * Texas Instruments TPS53676

    Prefix: 'tps53676'

    Addresses scanned: -

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

  * Texas Instruments TPS53679

    Prefix: 'tps53679'

    Addresses scanned: -

    Datasheet: https://www.ti.com/lit/gpn/TPS53679 (short version)

  * Texas Instruments TPS53681

    Prefix: 'tps53681'

    Addresses scanned: -

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

  * Texas Instruments TPS53685

    Prefix: 'tps53685'

    Addresses scanned: -

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

  * Texas Instruments TPS53688

    Prefix: 'tps53688'

    Addresses scanned: -

    Datasheet: Available under NDA


Authors:
        Vadim Pasternak <[email protected]>
        Guenter Roeck <[email protected]>

다상 변환기와 명시적 생성

68-87

이 계열 칩은 출력 채널 하나 또는 두 개를 갖고 채널당 최대 8상을 지원하는 다상 강압 변환기입니다.

드라이버는 PMBus 장치를 탐색하지 않으므로 명시적으로 생성해야 합니다. 예시는 I2C 버스 1의 주소 `0x60`에 있는 TPS53681을 위해 모듈을 적재하고 `new_device`에 장치 이름과 주소를 쓰는 방법입니다.

# modprobe tps53679
# echo tps53681 0x60 > /sys/bus/i2c/devices/i2c-1/new_device
TPS53681 생성 예
항목값
모듈tps53679
장치 변형tps53681
I2C 버스1
주소0x60
생성 파일/sys/bus/i2c/devices/i2c-1/new_device

원문의 명령이 지정하는 구성 요소입니다.

명시적 PMBus 생성
`modprobe tps53679` 실행I2C 버스 번호 확인`new_device`에 칩 이름·주소 쓰기PMBus 클라이언트 생성hwmon 속성 확인

자동 탐지 없이 드라이버를 결합하는 순서입니다.

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

Chips in this series are multi-phase step-down converters with one or two
output channels and up to 8 phases per channel.


Usage Notes
-----------

This driver does not probe for PMBus devices. You will have to instantiate
devices explicitly.

Example: the following commands will load the driver for an TPS53681 at address
0x60 on I2C bus #1::

        # modprobe tps53679
        # echo tps53681 0x60 > /sys/bus/i2c/devices/i2c-1/new_device

입력·출력 전압과 온도

88-146

`in1_label`은 `vin`, `in1_input`은 입력 전압입니다. `in1_lcrit`과 `in1_lcrit_alarm`은 TPS53679, TPS53681, TPS53688에서만 제공하는 임계 최소 입력 전압과 저전압 경보입니다. `in1_crit`과 `in1_crit_alarm`은 임계 최대 입력 전압과 고전압 경보입니다.

`in[N]_label`은 `vout1`~`vout2`입니다. 원문은 TPS53647·TPS53667에 `N=2`, TPS53679·TPS53588에 `N=2,3`을 지정합니다. 지원 목록의 칩명은 TPS53688이지만 속성 표의 `TPS53588` 표기를 원문 그대로 보존합니다. `in[N]_input`은 출력 전압입니다.

`in[N]_lcrit`, `_lcrit_alarm`, `_crit`, `_crit_alarm`은 TPS53679, TPS53681, TPS53688에서만 제공하는 임계 최소·최대 출력 전압과 경보입니다. `in[N]_alarm`은 TPS53647과 TPS53667에서만 제공하는 출력 전압 경보입니다.

`temp[N]_input`은 온도입니다. TPS53647·TPS53667은 `N=1`, TPS53679·TPS53681·원문 표기의 TPS53588은 `N=1,2`입니다. `temp[N]_max`, `_crit`, `_max_alarm`, `_crit_alarm`은 최대·임계 온도와 각 경보입니다.

TPS53679 전압·온도 속성
속성의미지원 변형·N
`in1_input`입력 전압 `vin`전체
`in1_lcrit` / `_alarm`임계 최소 입력·경보TPS53679/681/688
`in1_crit` / `_alarm`임계 최대 입력·경보전체
`in[N]_input`출력 전압 `vout[1-2]`N=2 또는 2,3
`in[N]_lcrit` / `_alarm`임계 최소 출력·경보TPS53679/681/688
`in[N]_alarm`일반 출력 전압 경보TPS53647/667
`in[N]_crit` / `_alarm`임계 최대 출력·경보TPS53679/681/688
`temp[N]_input`온도N=1 또는 1,2
`temp[N]_max` / `_crit`최대·임계 온도온도 채널
`temp[N]_max_alarm` / `_crit_alarm`고온·임계 고온 경보온도 채널

변형별 채널과 임계 속성 가용성을 정리했습니다.

변형별 전압 속성 선택
칩 변형 판별입력·출력 채널 수 결정TPS53647/667이면 일반 vout alarm 제공TPS53679/681/688이면 lcrit·crit 제공온도 채널 수와 경보 속성 등록

칩 세대에 따라 일반 경보 또는 임계 한계를 고릅니다.

Sysfs attributes
----------------

======================= ========================================================
in1_label                "vin"

in1_input                Measured input voltage.

in1_lcrit                Critical minimum input voltage

                        TPS53679, TPS53681, TPS53688 only.

in1_lcrit_alarm                Input voltage critical low alarm.

                        TPS53679, TPS53681, TPS53688 only.

in1_crit                Critical maximum input voltage.

in1_crit_alarm                Input voltage critical high alarm.

in[N]_label                "vout[1-2]"

                        - TPS53647, TPS53667: N=2
                        - TPS53679, TPS53588: N=2,3

in[N]_input                Measured output voltage.

in[N]_lcrit                Critical minimum input voltage.

                        TPS53679, TPS53681, TPS53688 only.

in[N]_lcrit_alarm        Critical minimum voltage alarm.

                        TPS53679, TPS53681, TPS53688 only.

in[N]_alarm                Output voltage alarm.

                        TPS53647, TPS53667 only.

in[N]_crit                Critical maximum output voltage.

                        TPS53679, TPS53681, TPS53688 only.

in[N]_crit_alarm        Output voltage critical high alarm.

                        TPS53679, TPS53681, TPS53688 only.

temp[N]_input                Measured temperature.

                        - TPS53647, TPS53667: N=1
                        - TPS53679, TPS53681, TPS53588: N=1,2

temp[N]_max                Maximum temperature.

temp[N]_crit                Critical high temperature.

temp[N]_max_alarm        Temperature high alarm.

temp[N]_crit_alarm        Temperature critical high alarm.

전력·전류와 상별 텔레메트리

147-195

`power1_label`은 `pin`, `power1_input`은 입력 전력입니다. `power[N]_label`은 `pout1`~`pout2`이고 `power[N]_input`은 출력 전력입니다. TPS53647·TPS53667은 `N=2`, TPS53676·TPS53679·TPS53681·원문 표기의 TPS53588은 `N=2,3`입니다.

`curr1_label`은 `iin`, `curr1_input`은 입력 전류입니다. `curr1_max`, `_max_alarm`, `_crit`, `_crit_alarm`은 입력 전류 최대·임계 한계와 경보입니다.

`curr[N]_label`은 `iout1`~`iout2` 또는 `iout1.0`~`iout1.5`입니다. 첫 번째 숫자는 출력 채널, 두 번째 숫자는 채널 안의 상입니다. 상별 텔레메트리는 TPS53676과 TPS53681에서만 지원합니다.

전류 인덱스는 TPS53647·TPS53667에서 `N=2`, TPS53679·원문 표기의 TPS53588에서 `N=2,3`, TPS53676에서 `N=2~8`, TPS53681에서 `N=2~9`입니다.

`curr[N]_input`, `_max`, `_crit`, `_max_alarm`, `_crit_alarm`은 출력 전류와 한계·경보입니다. 한계·경보 속성은 상별이 아닌 `iout1`, `iout2` 텔레메트리에만 제공됩니다.

TPS53679 전력·전류 매핑
속성·변형인덱스기능
`power1_input`1입력 전력 `pin`
`power[N]_input` TPS53647/667N=2출력 전력
`power[N]_input` TPS53676/679/681/원문 53588N=2,3출력 전력
`curr1_input`1입력 전류 `iin`
`curr[N]_input` TPS53647/667N=2출력 전류
`curr[N]_input` TPS53679/원문 53588N=2,3출력 전류
`curr[N]_input` TPS53676N=2~8출력·상별 전류
`curr[N]_input` TPS53681N=2~9출력·상별 전류
`curr[N]` 한계·경보iout1·iout2만상별 텔레메트리에는 없음

출력 채널과 상별 전류 인덱스를 구분했습니다.

상별 전류 해석
`ioutX.Y` 레이블 읽기X를 출력 채널로 해석Y를 채널 내부 상으로 해석TPS53676/681에서 상별 값 제공한계·경보는 비상별 iout 채널에만 적용

복합 레이블에서 출력 채널과 상을 분리합니다.


power1_label                "pin".

power1_input                Measured input power.

power[N]_label                "pout[1-2]".

                        - TPS53647, TPS53667: N=2
                        - TPS53676, TPS53679, TPS53681, TPS53588: N=2,3

power[N]_input                Measured output power.

curr1_label                "iin".

curr1_input                Measured input current.

curr1_max                Maximum input current.

curr1_max_alarm                Input current high alarm.

curr1_crit                Critical input current.

curr1_crit_alarm        Input current critical alarm.

curr[N]_label                "iout[1-2]" or "iout1.[0-5]".

                        The first digit is the output channel, the second
                        digit is the phase within the channel. Per-phase
                        telemetry supported on TPS53676 and TPS53681 only.

                        - TPS53647, TPS53667: N=2
                        - TPS53679, TPS53588: N=2,3
                        - TPS53676: N=2-8
                        - TPS53681: N=2-9

curr[N]_input                Measured output current.

curr[N]_max                Maximum output current.

curr[N]_crit                Critical high output current.

curr[N]_max_alarm        Output current high alarm.

curr[N]_crit_alarm        Output current critical high alarm.

                        Limit and alarm attributes are only available for
                        non-phase telemetry (iout1, iout2).

======================= ========================================================