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

Linux 6.18.37 · Hardware Monitoring

Kernel driver max8688

MAX8688 PMBus 전원 컨트롤러의 출력 전압·전류·온도 한계와 최고 이력입니다.

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

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

1. 요약·해설

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

요약·해설

max8688.rst:1-85

PMBus 레지스터에서 단일 출력 전원과 칩 온도를 읽고 warning·fault 및 최고 이력을 관리합니다.

문서 개요
항목값
SourceDocumentation/hwmon/max8688.rst
분량85 source lines
전압·전류vout1·iout1
이력highest + reset

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

운영 흐름
장치 생성PMBus 연결현재값 읽기경보 확인이력 초기화

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

2. 영어 원문 전체

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

원문 전체 펼치기
1 Kernel driver max8688
2 =====================
3
4 Supported chips:
5
6 * Maxim MAX8688
7
8 Prefix: 'max8688'
9
10 Addresses scanned: -
11
12 Datasheet: http://datasheets.maxim-ic.com/en/ds/MAX8688.pdf
13
14 Author: Guenter Roeck <[email protected]>
15
16
17 Description
18 -----------
19
20 This driver supports hardware monitoring for Maxim MAX8688 Digital Power-Supply
21 Controller/Monitor with PMBus Interface.
22
23 The driver is a client driver to the core PMBus driver. Please see
24 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 in1_label "vout1"
49 in1_input Measured voltage. From READ_VOUT register.
50 in1_min Minimum Voltage. From VOUT_UV_WARN_LIMIT register.
51 in1_max Maximum voltage. From VOUT_OV_WARN_LIMIT register.
52 in1_lcrit Critical minimum Voltage. VOUT_UV_FAULT_LIMIT register.
53 in1_crit Critical maximum voltage. From VOUT_OV_FAULT_LIMIT
54 register.
55 in1_min_alarm Voltage low alarm. From VOLTAGE_UV_WARNING status.
56 in1_max_alarm Voltage high alarm. From VOLTAGE_OV_WARNING status.
57 in1_lcrit_alarm Voltage critical low alarm. From VOLTAGE_UV_FAULT
58 status.
59 in1_crit_alarm Voltage critical high alarm. From VOLTAGE_OV_FAULT
60 status.
61 in1_highest Historical maximum voltage.
62 in1_reset_history Write any value to reset history.
63
64 curr1_label "iout1"
65 curr1_input Measured current. From READ_IOUT register.
66 curr1_max Maximum current. From IOUT_OC_WARN_LIMIT register.
67 curr1_crit Critical maximum current. From IOUT_OC_FAULT_LIMIT
68 register.
69 curr1_max_alarm Current high alarm. From IOUT_OC_WARN_LIMIT register.
70 curr1_crit_alarm Current critical high alarm. From IOUT_OC_FAULT status.
71 curr1_highest Historical maximum current.
72 curr1_reset_history Write any value to reset history.
73
74 temp1_input Measured temperature. From READ_TEMPERATURE_1 register.
75 temp1_max Maximum temperature. From OT_WARN_LIMIT register.
76 temp1_crit Critical high temperature. From OT_FAULT_LIMIT register.
77 temp1_max_alarm Chip temperature high alarm. Set by comparing
78 READ_TEMPERATURE_1 with OT_WARN_LIMIT if TEMP_OT_WARNING
79 status is set.
80 temp1_crit_alarm Chip temperature critical high alarm. Set by comparing
81 READ_TEMPERATURE_1 with OT_FAULT_LIMIT if TEMP_OT_FAULT
82 status is set.
83 temp1_highest Historical maximum temperature.
84 temp1_reset_history Write any value to reset history.
85 ======================= ========================================================
86

3. 한국어 전문 번역

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

MAX8688 디지털 전원 컨트롤러 PMBus 연결

1-36

Guenter Roeck가 작성한 이 드라이버는 PMBus 인터페이스가 있는 Maxim MAX8688 디지털 전원 컨트롤러·모니터를 지원합니다. 접두사는 `max8688`이고 주소 자동 검색은 하지 않습니다.

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

MAX8688 기본 구성
항목값
모델MAX8688
접두사max8688
인터페이스PMBus
자동 검색없음
플랫폼 데이터표준 PMBus

단일 출력 전압·전류와 칩 온도를 감시합니다.

MAX8688 등록
장치 주소 확인MAX8688 명시적 생성표준 PMBus 데이터 적용PMBus 코어 연결전압·전류·온도 속성 생성

명시적 생성 후 PMBus 코어와 결합합니다.

Kernel driver max8688
=====================

Supported chips:

  * Maxim MAX8688

    Prefix: 'max8688'

    Addresses scanned: -

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

Author: Guenter Roeck <[email protected]>


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

This driver supports hardware monitoring for Maxim MAX8688 Digital Power-Supply
Controller/Monitor with 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
---------------------

전압·전류·온도 한계·경보와 최고 이력

37-85

한계값은 읽기·쓰기이고 나머지는 읽기 전용입니다. `in1`은 `vout1`이며 `READ_VOUT` 현재값, `VOUT_UV/OV_WARN_LIMIT` 최소·최대, `VOUT_UV/OV_FAULT_LIMIT` 임계 최소·최대값을 제공합니다.

전압 low/high 경보는 `VOLTAGE_UV/OV_WARNING`, 임계 low/high 경보는 `VOLTAGE_UV/OV_FAULT` 상태에서 옵니다. `in1_highest`는 과거 최고 전압이고 `in1_reset_history`에 아무 값이나 쓰면 이력을 초기화합니다.

`curr1`은 `iout1`이며 `READ_IOUT`, `IOUT_OC_WARN_LIMIT`, `IOUT_OC_FAULT_LIMIT`에서 현재·최대·임계 최대 전류를 얻고 high·critical-high 경보를 제공합니다. 최고 전류와 이력 초기화도 지원합니다.

`temp1`은 `READ_TEMPERATURE_1` 온도입니다. `OT_WARN_LIMIT`, `OT_FAULT_LIMIT`을 한계로 사용합니다. `TEMP_OT_WARNING` 또는 `TEMP_OT_FAULT`가 설정되면 실제 온도를 각 한계와 비교해 경보를 정합니다. 최고 온도와 이력 초기화를 제공합니다.

MAX8688 PMBus 매핑
그룹현재값한계·상태이력
in1/vout1READ_VOUTVOUT UV/OV WARN·FAULThighest, reset
curr1/iout1READ_IOUTIOUT OC WARN·FAULThighest, reset
temp1READ_TEMPERATURE_1OT WARN·FAULThighest, reset

세 측정 그룹의 레지스터·경보·이력입니다.

MAX8688 감시 주기
vout1·iout1·temp1 읽기warning 한계 비교fault 한계 비교경보 상태 확인필요 시 최고 이력 초기화

현재값과 상태 비트·한계를 함께 비교합니다.


The driver supports standard PMBus driver platform data.


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

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

======================= ========================================================
in1_label                "vout1"
in1_input                Measured voltage. From READ_VOUT register.
in1_min                        Minimum Voltage. From VOUT_UV_WARN_LIMIT register.
in1_max                        Maximum voltage. From VOUT_OV_WARN_LIMIT register.
in1_lcrit                Critical minimum Voltage. VOUT_UV_FAULT_LIMIT register.
in1_crit                Critical maximum voltage. From VOUT_OV_FAULT_LIMIT
                        register.
in1_min_alarm                Voltage low alarm. From VOLTAGE_UV_WARNING status.
in1_max_alarm                Voltage high alarm. From VOLTAGE_OV_WARNING status.
in1_lcrit_alarm                Voltage critical low alarm. From VOLTAGE_UV_FAULT
                        status.
in1_crit_alarm                Voltage critical high alarm. From VOLTAGE_OV_FAULT
                        status.
in1_highest                Historical maximum voltage.
in1_reset_history        Write any value to reset history.

curr1_label                "iout1"
curr1_input                Measured current. From READ_IOUT register.
curr1_max                Maximum current. From IOUT_OC_WARN_LIMIT register.
curr1_crit                Critical maximum current. From IOUT_OC_FAULT_LIMIT
                        register.
curr1_max_alarm                Current high alarm. From IOUT_OC_WARN_LIMIT register.
curr1_crit_alarm        Current critical high alarm. From IOUT_OC_FAULT status.
curr1_highest                Historical maximum current.
curr1_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.
======================= ========================================================