요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
.. SPDX-License-Identifier: GPL-2.0
3
Kernel driver max15301
4
======================
6
Supported chips:
8
* Maxim MAX15301
10
Prefix: 'max15301', 'bmr461'
12
Addresses scanned: -
14
Datasheet: https://datasheets.maximintegrated.com/en/ds/MAX15301.pdf
16
* Maxim MAX15303
18
Prefix: 'max15303'
20
Addresses scanned: -
22
Datasheet: https://www.analog.com/media/en/technical-documentation/data-sheets/max15303.pdf
24
Author: Erik Rosen <[email protected]>
27
Description
28
-----------
30
This driver supports hardware monitoring for Maxim MAX15301 controller chip and
31
compatible modules.
33
The driver is a client driver to the core PMBus driver. Please see
34
Documentation/hwmon/pmbus.rst and Documentation.hwmon/pmbus-core for details
35
on PMBus client drivers.
38
Usage Notes
39
-----------
41
This driver does not auto-detect devices. You will have to instantiate the
42
devices explicitly. Please see Documentation/i2c/instantiating-devices.rst for
43
details.
46
Platform data support
47
---------------------
49
The driver supports standard PMBus driver platform data.
52
Module parameters
53
-----------------
55
delay
56
-----
58
The controller requires a minimum interval between I2C bus accesses.
59
The default interval is set to 100 us. For manual override, the driver
60
provides a writeable module parameter, 'delay', which can be used to
61
set the interval to a value between 0 and 65,535 microseconds.
64
Sysfs entries
65
-------------
67
The following attributes are supported. Limits are read-write; all other
68
attributes are read-only.
70
======================= ========================================================
71
in1_label "vin"
72
in1_input Measured input voltage.
73
in1_lcrit Critical minimum input voltage.
74
in1_crit Critical maximum input voltage.
75
in1_lcrit_alarm Input voltage critical low alarm.
76
in1_crit_alarm Input voltage critical high alarm.
78
in2_label "vout1"
79
in2_input Measured output voltage.
80
in2_lcrit Critical minimum output Voltage.
81
in2_crit Critical maximum output voltage.
82
in2_lcrit_alarm Critical output voltage critical low alarm.
83
in2_crit_alarm Critical output voltage critical high alarm.
85
curr1_label "iout1"
86
curr1_input Measured output current.
87
curr1_crit Critical maximum output current.
88
curr1_crit_alarm Output current critical high alarm.
90
temp1_input Measured maximum temperature of all phases.
91
temp1_max Maximum temperature limit.
92
temp1_max_alarm High temperature alarm.
93
temp1_crit Critical maximum temperature limit.
94
temp1_crit_alarm Critical maximum temperature alarm.
95
======================= ========================================================
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
MAX15301/MAX15303 PMBus 등록과 접근 지연
1-56GPL-2.0 문서의 드라이버는 Maxim MAX15301과 호환 모듈, MAX15303을 지원합니다. MAX15301은 `max15301` 또는 `bmr461`, MAX15303은 `max15303` 접두사를 사용하며 저자는 Erik Rosen입니다.
드라이버는 PMBus 코어의 클라이언트입니다. 자세한 내용은 원문에 적힌 `Documentation/hwmon/pmbus.rst`와 `Documentation.hwmon/pmbus-core`를 따르며 장치는 자동 탐색하지 않으므로 `Documentation/i2c/instantiating-devices.rst` 방식으로 명시적으로 생성해야 합니다. 표준 PMBus 플랫폼 데이터도 지원합니다.
컨트롤러는 I2C 버스 접근 사이에 최소 간격이 필요합니다. 기본 간격은 100 us이고 쓰기 가능한 모듈 매개변수 `delay`로 0-65,535 microseconds 사이 값을 지정할 수 있습니다.
항목값
MAX15301max15301 / bmr461
MAX15303max15303
자동 탐색없음
delay 기본값100 us
delay 범위0-65,535 microseconds
장치 접두사와 버스 접근 간격입니다.
칩 모델과 접두사 선택→장치 명시적 생성→필요하면 delay 조정→PMBus 코어와 결합→전압·전류·온도 감시
필요한 I2C 간격을 적용해 PMBus 클라이언트를 생성합니다.
.. SPDX-License-Identifier: GPL-2.0
Kernel driver max15301
======================
Supported chips:
* Maxim MAX15301
Prefix: 'max15301', 'bmr461'
Addresses scanned: -
Datasheet: https://datasheets.maximintegrated.com/en/ds/MAX15301.pdf
* Maxim MAX15303
Prefix: 'max15303'
Addresses scanned: -
Datasheet: https://www.analog.com/media/en/technical-documentation/data-sheets/max15303.pdf
Author: Erik Rosen <[email protected]>
Description
-----------
This driver supports hardware monitoring for Maxim MAX15301 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.
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.
Module parameters
-----------------
delay
-----임계 전압·전류와 전체 위상 최고 온도
57-95한계는 읽고 쓸 수 있고 나머지는 읽기 전용입니다. `in1`은 `vin` 입력 전압으로 현재값, 임계 최저·최고 한계와 임계 저·과전압 알람을 제공합니다. `in2`는 `vout1` 출력 전압에 같은 임계 한계와 알람 구조를 제공합니다.
`curr1`은 `iout1` 출력 전류의 현재값, 임계 최대 전류, 임계 과전류 알람입니다.
`temp1_input`은 모든 위상 중 가장 높은 측정 온도입니다. `temp1_max`와 `temp1_max_alarm`은 최대 한계와 고온 알람, `temp1_crit`과 `temp1_crit_alarm`은 임계 최대 한계와 임계 고온 알람입니다.
그룹레이블한계·알람
in1vinlcrit / crit / lcrit_alarm / crit_alarm
in2vout1lcrit / crit / lcrit_alarm / crit_alarm
curr1iout1crit / crit_alarm
temp1전체 위상 최고 온도max / crit / max_alarm / crit_alarm
입력·출력과 위상 최고 온도의 임계 상태입니다.
vin과 vout1 읽기→임계 저·과전압 알람 확인→iout1 임계 과전류 확인→모든 위상 최고 온도 읽기→고온·임계 고온 알람 기록
전압·전류·온도 임계값을 단계별로 확인합니다.
The controller requires a minimum interval between I2C bus accesses.
The default interval is set to 100 us. For manual override, the driver
provides a writeable module parameter, 'delay', which can be used to
set the interval to a value between 0 and 65,535 microseconds.
Sysfs entries
-------------
The following attributes are supported. 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_crit Critical maximum output current.
curr1_crit_alarm Output current 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.
======================= ========================================================
요약·해설
max15301.rst:1-95I2C 접근 간격을 delay로 조정하며 vin·vout1·iout1의 임계값과 모든 위상 중 최고 온도를 감시합니다.
원문 분량과 핵심 인터페이스입니다.
장치 등록부터 측정·경보 처리까지의 순서입니다.