요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
.. SPDX-License-Identifier: GPL-2.0
3
Kernel driver stpddc60
4
======================
6
Supported chips:
8
* ST STPDDC60
10
Prefix: 'stpddc60', 'bmr481'
12
Addresses scanned: -
14
Datasheet: https://flexpowermodules.com/documents/fpm-techspec-bmr481
16
Author: Erik Rosen <erik.rosen@metormote.com>
19
Description
20
-----------
22
This driver supports hardware monitoring for ST STPDDC60 controller chip and
23
compatible modules.
25
The driver is a client driver to the core PMBus driver. Please see
26
Documentation/hwmon/pmbus.rst and Documentation.hwmon/pmbus-core for details
27
on PMBus client drivers.
30
Usage Notes
31
-----------
33
This driver does not auto-detect devices. You will have to instantiate the
34
devices explicitly. Please see Documentation/i2c/instantiating-devices.rst for
35
details.
37
The vout under- and over-voltage limits are set in relation to the commanded
38
output voltage as a positive or negative offset in the interval 50mV to 400mV
39
in 50mV steps. This means that the absolute values of the limits will change
40
when the commanded output voltage changes. Also, care should be taken when
41
writing to those limits since in the worst case the commanded output voltage
42
could change at the same time as the limit is written to, which will lead to
43
unpredictable results.
46
Platform data support
47
---------------------
49
The driver supports standard PMBus driver platform data.
52
Sysfs entries
53
-------------
55
The following attributes are supported. Vin, iout, pout and temp limits
56
are read-write; all other attributes are read-only.
58
======================= ========================================================
59
in1_label "vin"
60
in1_input Measured input voltage.
61
in1_lcrit Critical minimum input voltage.
62
in1_crit Critical maximum input voltage.
63
in1_lcrit_alarm Input voltage critical low alarm.
64
in1_crit_alarm Input voltage critical high alarm.
66
in2_label "vout1"
67
in2_input Measured output voltage.
68
in2_lcrit Critical minimum output voltage.
69
in2_crit Critical maximum output voltage.
70
in2_lcrit_alarm Critical output voltage critical low alarm.
71
in2_crit_alarm Critical output voltage critical high alarm.
73
curr1_label "iout1"
74
curr1_input Measured output current.
75
curr1_max Maximum output current.
76
curr1_max_alarm Output current high alarm.
77
curr1_crit Critical maximum output current.
78
curr1_crit_alarm Output current critical high alarm.
80
power1_label "pout1"
81
power1_input Measured output power.
82
power1_crit Critical maximum output power.
83
power1_crit_alarm Output power critical high alarm.
85
temp1_input Measured maximum temperature of all phases.
86
temp1_max Maximum temperature limit.
87
temp1_max_alarm High temperature alarm.
88
temp1_crit Critical maximum temperature limit.
89
temp1_crit_alarm Critical maximum temperature alarm.
90
======================= ========================================================
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
STPDDC60·BMR481 PMBus 클라이언트
1-29GPL-2.0 `stpddc60` 드라이버는 ST STPDDC60 컨트롤러와 호환 모듈을 지원합니다. 접두사는 `stpddc60`과 `bmr481`이고 주소 자동 검색은 하지 않습니다.
드라이버는 PMBus 코어의 클라이언트입니다. PMBus 클라이언트 구조는 `Documentation/hwmon/pmbus.rst`와 PMBus 코어 문서를 참고합니다. 작성자는 Erik Rosen입니다.
항목값
컨트롤러ST STPDDC60
호환 모듈BMR481
접두사stpddc60, bmr481
자동 검색없음
상위 계층PMBus core client
지원 장치와 PMBus 계층 관계입니다.
STPDDC60·BMR481 모델 확인→I2C 버스·주소 확인→장치 인스턴스 생성→PMBus 코어가 기능 레지스터 탐지→전압·전류·전력·온도 속성 생성
명시적으로 만든 장치를 PMBus 코어 기능과 연결합니다.
.. SPDX-License-Identifier: GPL-2.0
Kernel driver stpddc60
======================
Supported chips:
* ST STPDDC60
Prefix: 'stpddc60', 'bmr481'
Addresses scanned: -
Datasheet: https://flexpowermodules.com/documents/fpm-techspec-bmr481
Author: Erik Rosen <erik.rosen@metormote.com>
Description
-----------
This driver supports hardware monitoring for ST STPDDC60 controller chip and
compatible modules.
The driver is a client driver to the core PMBus driver. Please see
Documentation/hwmon/pmbus.rst and Documentation.hwmon/pmbus-core for details
on PMBus client drivers.
상대 VOUT 한계와 동시 변경 위험
30-50장치는 자동 감지되지 않으므로 사용자가 명시적으로 인스턴스를 만들어야 합니다. 자세한 방법은 `Documentation/i2c/instantiating-devices.rst`를 참고합니다.
출력 전압 저전압·과전압 한계는 명령 출력 전압에 대한 양수 또는 음수 오프셋으로 설정됩니다. 오프셋 범위는 50~400 mV이고 간격은 50 mV입니다.
따라서 명령 출력 전압이 바뀌면 한계의 절대값도 바뀝니다. 한계를 쓰는 동시에 명령 출력 전압이 변경되면 최악의 경우 예측할 수 없는 결과가 생길 수 있으므로 쓰기 시 주의해야 합니다.
드라이버는 표준 PMBus 드라이버 플랫폼 데이터를 지원합니다.
항목값·주의
한계 표현명령 출력 전압 기준 양·음 오프셋
오프셋 범위50~400 mV
간격50 mV
명령 전압 변경한계 절대값도 함께 변경
동시 쓰기 위험예측 불가능한 결과 가능
플랫폼 데이터표준 PMBus 지원
명령 전압 기준 오프셋의 범위와 동시 변경 위험입니다.
현재 명령 출력 전압 확인→전압 변경 작업이 없는지 동기화→50~400 mV 오프셋 선택→50 mV 단계로 한계 기록→변환된 절대 한계 재확인
명령 전압을 안정시킨 뒤 상대 오프셋 한계를 기록합니다.
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.
The vout under- and over-voltage limits are set in relation to the commanded
output voltage as a positive or negative offset in the interval 50mV to 400mV
in 50mV steps. This means that the absolute values of the limits will change
when the commanded output voltage changes. Also, care should be taken when
writing to those limits since in the worst case the commanded output voltage
could change at the same time as the limit is written to, which will lead to
unpredictable results.
Platform data support
---------------------
The driver supports standard PMBus driver platform data.
입력·출력 레일 한계와 경보
51-90Vin, iout, pout, temp 한계는 읽기·쓰기가 가능하고 나머지 속성은 읽기 전용입니다.
`in1_label`은 `vin`이고 입력 전압 측정값, 임계 최소·최대값 `in1_lcrit`, `in1_crit`, 대응하는 낮음·높음 경보를 제공합니다.
`in2_label`은 `vout1`이고 출력 전압 측정값과 임계 최소·최대, 대응 경보를 제공합니다.
`curr1_label`은 `iout1`이며 출력 전류, 최대·임계 최대 한계, 각각의 높음·임계 높음 경보가 있습니다. `power1_label`은 `pout1`이며 출력 전력, 임계 최대 한계와 경보가 있습니다.
`temp1_input`은 모든 위상 중 최대 온도입니다. 최대·임계 최대 온도 한계와 각각의 경보를 제공합니다.
레이블측정값RW 한계경보
vinin1_inputin1_lcrit, in1_critin1_lcrit_alarm, in1_crit_alarm
vout1in2_inputin2_lcrit, in2_critin2_lcrit_alarm, in2_crit_alarm
iout1curr1_inputcurr1_max, curr1_critcurr1_max_alarm, curr1_crit_alarm
pout1power1_inputpower1_critpower1_crit_alarm
최대 위상 온도temp1_inputtemp1_max, temp1_crittemp1_max_alarm, temp1_crit_alarm
레이블별 측정값, 한계, 경보를 묶습니다.
vin·vout1 전압 판독→iout1 출력 전류 판독→pout1 출력 전력 판독→모든 위상 중 최대 온도 판독→각 한계와 alarm 비교
레일별 측정값과 쓰기 가능한 한계, 경보를 함께 확인합니다.
Sysfs entries
-------------
The following attributes are supported. Vin, iout, pout and temp limits
are read-write; all other attributes are read-only.
======================= ========================================================
in1_label "vin"
in1_input Measured input voltage.
in1_lcrit Critical minimum input voltage.
in1_crit Critical maximum input voltage.
in1_lcrit_alarm Input voltage critical low alarm.
in1_crit_alarm Input voltage critical high alarm.
in2_label "vout1"
in2_input Measured output voltage.
in2_lcrit Critical minimum output voltage.
in2_crit Critical maximum output voltage.
in2_lcrit_alarm Critical output voltage critical low alarm.
in2_crit_alarm Critical output voltage critical high alarm.
curr1_label "iout1"
curr1_input Measured output current.
curr1_max Maximum output current.
curr1_max_alarm Output current high alarm.
curr1_crit Critical maximum output current.
curr1_crit_alarm Output current critical high alarm.
power1_label "pout1"
power1_input Measured output power.
power1_crit Critical maximum output power.
power1_crit_alarm Output power critical high alarm.
temp1_input Measured maximum temperature of all phases.
temp1_max Maximum temperature limit.
temp1_max_alarm High temperature alarm.
temp1_crit Critical maximum temperature limit.
temp1_crit_alarm Critical maximum temperature alarm.
======================= ========================================================
요약·해설
stpddc60.rst:1-90명령 출력 전압 기준 50~400 mV 오프셋으로 한계를 설정하고 vin·vout·iout·pout·최대 위상 온도를 감시합니다.
원문 분량과 핵심 구성을 정리합니다.
장치 식별부터 측정·검증까지의 핵심 순서입니다.