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

Linux 6.18.37 · Hardware Monitoring

Kernel driver max15301

MAX15301/MAX15303 PMBus 컨트롤러의 I2C 접근 지연과 임계 전압·전류·위상 최고 온도 감시입니다.

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

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

1. 요약·해설

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

요약·해설

max15301.rst:1-95

I2C 접근 간격을 delay로 조정하며 vin·vout1·iout1의 임계값과 모든 위상 중 최고 온도를 감시합니다.

문서 개요
항목값
SourceDocumentation/hwmon/max15301.rst
분량95 source lines
delay 기본값100 us
delay 범위0-65,535 us

원문 분량과 핵심 인터페이스입니다.

운영 흐름
장치 생성delay 설정임계 전압·전류 확인위상 최고 온도 감시

장치 등록부터 측정·경보 처리까지의 순서입니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 .. SPDX-License-Identifier: GPL-2.0
2
3 Kernel driver max15301
4 ======================
5
6 Supported chips:
7
8 * Maxim MAX15301
9
10 Prefix: 'max15301', 'bmr461'
11
12 Addresses scanned: -
13
14 Datasheet: https://datasheets.maximintegrated.com/en/ds/MAX15301.pdf
15
16 * Maxim MAX15303
17
18 Prefix: 'max15303'
19
20 Addresses scanned: -
21
22 Datasheet: https://www.analog.com/media/en/technical-documentation/data-sheets/max15303.pdf
23
24 Author: Erik Rosen <erik.rosen@metormote.com>
25
26
27 Description
28 -----------
29
30 This driver supports hardware monitoring for Maxim MAX15301 controller chip and
31 compatible modules.
32
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.
36
37
38 Usage Notes
39 -----------
40
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.
44
45
46 Platform data support
47 ---------------------
48
49 The driver supports standard PMBus driver platform data.
50
51
52 Module parameters
53 -----------------
54
55 delay
56 -----
57
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.
62
63
64 Sysfs entries
65 -------------
66
67 The following attributes are supported. Limits are read-write; all other
68 attributes are read-only.
69
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.
77
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.
84
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.
89
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 ======================= ========================================================
96

3. 한국어 전문 번역

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

MAX15301/MAX15303 PMBus 등록과 접근 지연

1-56

GPL-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 사이 값을 지정할 수 있습니다.

MAX15301 계열 구성
항목값
MAX15301max15301 / bmr461
MAX15303max15303
자동 탐색없음
delay 기본값100 us
delay 범위0-65,535 microseconds

장치 접두사와 버스 접근 간격입니다.

MAX15301 연결
칩 모델과 접두사 선택장치 명시적 생성필요하면 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 <erik.rosen@metormote.com>


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`은 임계 최대 한계와 임계 고온 알람입니다.

MAX15301 sysfs
그룹레이블한계·알람
in1vinlcrit / crit / lcrit_alarm / crit_alarm
in2vout1lcrit / crit / lcrit_alarm / crit_alarm
curr1iout1crit / crit_alarm
temp1전체 위상 최고 온도max / crit / max_alarm / crit_alarm

입력·출력과 위상 최고 온도의 임계 상태입니다.

MAX15301 임계 감시
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.
======================= ========================================================