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

Linux 6.18.37 · Hardware Monitoring

Kernel driver max16064

MAX16064 쿼드 PMBus 컨트롤러의 4개 출력 전압 경고·오류 한계와 최고 이력입니다.

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

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

1. 요약·해설

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

요약·해설

max16064.rst:1-75

4개 vout 채널의 warning·fault 한계와 알람을 PMBus 레지스터에 대응시키고 전압·온도 최고 이력을 관리합니다.

문서 개요
항목값
SourceDocumentation/hwmon/max16064.rst
분량75 source lines
출력4개
이력전압·온도 highest

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

운영 흐름
장치 생성vout1-4 읽기warning·fault 확인최고 이력 기록이력 초기화

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

2. 영어 원문 전체

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

원문 전체 펼치기
1 Kernel driver max16064
2 ======================
3
4 Supported chips:
5
6 * Maxim MAX16064
7
8 Prefix: 'max16064'
9
10 Addresses scanned: -
11
12 Datasheet: http://datasheets.maxim-ic.com/en/ds/MAX16064.pdf
13
14 Author: Guenter Roeck <linux@roeck-us.net>
15
16
17 Description
18 -----------
19
20 This driver supports hardware monitoring for Maxim MAX16064 Quad Power-Supply
21 Controller with Active-Voltage Output Control and PMBus Interface.
22
23 The driver is a client driver to the core PMBus driver.
24 Please see Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
25
26
27 Usage Notes
28 -----------
29
30 This driver does not auto-detect devices. You will have to instantiate the
31 devices explicitly. Please see Documentation/i2c/instantiating-devices.rst for
32 details.
33
34
35 Platform data support
36 ---------------------
37
38 The driver supports standard PMBus driver platform data.
39
40
41 Sysfs entries
42 -------------
43
44 The following attributes are supported. Limits are read-write; all other
45 attributes are read-only.
46
47 ======================= ========================================================
48 in[1-4]_label "vout[1-4]"
49 in[1-4]_input Measured voltage. From READ_VOUT register.
50 in[1-4]_min Minimum Voltage. From VOUT_UV_WARN_LIMIT register.
51 in[1-4]_max Maximum voltage. From VOUT_OV_WARN_LIMIT register.
52 in[1-4]_lcrit Critical minimum Voltage. VOUT_UV_FAULT_LIMIT register.
53 in[1-4]_crit Critical maximum voltage. From VOUT_OV_FAULT_LIMIT
54 register.
55 in[1-4]_min_alarm Voltage low alarm. From VOLTAGE_UV_WARNING status.
56 in[1-4]_max_alarm Voltage high alarm. From VOLTAGE_OV_WARNING status.
57 in[1-4]_lcrit_alarm Voltage critical low alarm. From VOLTAGE_UV_FAULT
58 status.
59 in[1-4]_crit_alarm Voltage critical high alarm. From VOLTAGE_OV_FAULT
60 status.
61 in[1-4]_highest Historical maximum voltage.
62 in[1-4]_reset_history Write any value to reset history.
63
64 temp1_input Measured temperature. From READ_TEMPERATURE_1 register.
65 temp1_max Maximum temperature. From OT_WARN_LIMIT register.
66 temp1_crit Critical high temperature. From OT_FAULT_LIMIT register.
67 temp1_max_alarm Chip temperature high alarm. Set by comparing
68 READ_TEMPERATURE_1 with OT_WARN_LIMIT if TEMP_OT_WARNING
69 status is set.
70 temp1_crit_alarm Chip temperature critical high alarm. Set by comparing
71 READ_TEMPERATURE_1 with OT_FAULT_LIMIT if TEMP_OT_FAULT
72 status is set.
73 temp1_highest Historical maximum temperature.
74 temp1_reset_history Write any value to reset history.
75 ======================= ========================================================
76

3. 한국어 전문 번역

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

4채널 능동 전압 제어 PMBus 컨트롤러

1-39

MAX16064는 능동 출력 전압 제어와 PMBus 인터페이스를 갖춘 쿼드 전원 공급 컨트롤러입니다. 접두사는 `max16064`, 저자는 Guenter Roeck이며 주소 자동 탐색은 없습니다.

드라이버는 PMBus 코어의 클라이언트이고 `Documentation/hwmon/pmbus.rst`의 공통 동작을 따릅니다. 장치는 자동 감지하지 않아 명시적으로 생성해야 하며 표준 PMBus 플랫폼 데이터를 지원합니다.

MAX16064 기본 정보
항목값
출력 채널4개
접두사max16064
인터페이스PMBus
자동 탐색없음
플랫폼 데이터표준 PMBus

4개 출력 전압을 PMBus로 감시·제어합니다.

MAX16064 등록
I2C 주소 확인max16064 명시적 생성PMBus 코어 연결vout1-4 채널 생성온도·이력 속성 확인

장치를 명시적으로 생성한 뒤 네 출력과 칩 온도를 확인합니다.

Kernel driver max16064
======================

Supported chips:

  * Maxim MAX16064

    Prefix: 'max16064'

    Addresses scanned: -

    Datasheet: http://datasheets.maxim-ic.com/en/ds/MAX16064.pdf

Author: Guenter Roeck <linux@roeck-us.net>


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

This driver supports hardware monitoring for Maxim MAX16064 Quad Power-Supply
Controller with Active-Voltage Output Control and PMBus Interface.

The 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.

4개 출력 전압의 경고·오류·최고 이력

40-75

한계는 읽고 쓸 수 있고 나머지는 읽기 전용입니다. `in[1-4]`는 `vout[1-4]`이며 `READ_VOUT`의 현재값, `VOUT_UV_WARN_LIMIT`/`VOUT_OV_WARN_LIMIT`의 최소·최대 경고 한계, `VOUT_UV_FAULT_LIMIT`/`VOUT_OV_FAULT_LIMIT`의 임계 최저·최고 한계를 제공합니다.

저전압·과전압 경고 알람은 `VOLTAGE_UV_WARNING`과 `VOLTAGE_OV_WARNING`, 임계 저·과전압 알람은 `VOLTAGE_UV_FAULT`와 `VOLTAGE_OV_FAULT` 상태에서 옵니다. `in[1-4]_highest`는 과거 최고 전압이고 `in[1-4]_reset_history`에 아무 값이나 쓰면 이력을 초기화합니다.

`temp1_input`은 `READ_TEMPERATURE_1`, 최대·임계 온도는 `OT_WARN_LIMIT`와 `OT_FAULT_LIMIT`입니다. `TEMP_OT_WARNING`/`TEMP_OT_FAULT` 상태와 측정값 비교로 고온·임계 고온 알람을 정합니다. `temp1_highest`와 `temp1_reset_history`가 온도 이력을 관리합니다.

MAX16064 레지스터 매핑
속성PMBus 원천
inputREAD_VOUT
min / maxVOUT_UV_WARN_LIMIT / VOUT_OV_WARN_LIMIT
lcrit / critVOUT_UV_FAULT_LIMIT / VOUT_OV_FAULT_LIMIT
전압 알람VOLTAGE_UV/OV_WARNING, VOLTAGE_UV/OV_FAULT
temp1READ_TEMPERATURE_1, OT_WARN/FAULT_LIMIT

sysfs 한계와 PMBus 레지스터·상태의 대응입니다.

MAX16064 이력 감시
vout1-4 현재값 읽기경고 한계와 warning 상태 비교임계 한계와 fault 상태 비교전압·온도 highest 기록필요 시 reset_history 실행

네 출력의 경고·오류와 최고 이력을 함께 수집합니다.


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

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

======================= ========================================================
in[1-4]_label                "vout[1-4]"
in[1-4]_input                Measured voltage. From READ_VOUT register.
in[1-4]_min                Minimum Voltage. From VOUT_UV_WARN_LIMIT register.
in[1-4]_max                Maximum voltage. From VOUT_OV_WARN_LIMIT register.
in[1-4]_lcrit                Critical minimum Voltage. VOUT_UV_FAULT_LIMIT register.
in[1-4]_crit                Critical maximum voltage. From VOUT_OV_FAULT_LIMIT
                        register.
in[1-4]_min_alarm        Voltage low alarm. From VOLTAGE_UV_WARNING status.
in[1-4]_max_alarm        Voltage high alarm. From VOLTAGE_OV_WARNING status.
in[1-4]_lcrit_alarm        Voltage critical low alarm. From VOLTAGE_UV_FAULT
                        status.
in[1-4]_crit_alarm        Voltage critical high alarm. From VOLTAGE_OV_FAULT
                        status.
in[1-4]_highest                Historical maximum voltage.
in[1-4]_reset_history        Write any value to reset history.

temp1_input                Measured temperature. From READ_TEMPERATURE_1 register.
temp1_max                Maximum temperature. From OT_WARN_LIMIT register.
temp1_crit                Critical high temperature. From OT_FAULT_LIMIT register.
temp1_max_alarm                Chip temperature high alarm. Set by comparing
                        READ_TEMPERATURE_1 with OT_WARN_LIMIT if TEMP_OT_WARNING
                        status is set.
temp1_crit_alarm        Chip temperature critical high alarm. Set by comparing
                        READ_TEMPERATURE_1 with OT_FAULT_LIMIT if TEMP_OT_FAULT
                        status is set.
temp1_highest                Historical maximum temperature.
temp1_reset_history        Write any value to reset history.
======================= ========================================================