Kernel driver max34440

MAX34440 계열과 ADPM12160 지원 범위

Guenter Roeck가 작성한 이 PMBus 클라이언트 드라이버는 ADI ADPM12160과 Maxim MAX34440, MAX34441, MAX34446, MAX34451, MAX34460, MAX34461을 지원합니다. 각 모델 접두사는 소문자 모델명이며 주소 자동 검색은 하지 않습니다.

MAX34441은 5채널 전원 관리자와 지능형 팬 컨트롤러, MAX34446은 전원 데이터 로거, MAX34451은 16채널 V/I 모니터와 12채널 시퀀서·마지너입니다. MAX34460은 12채널, MAX34461은 16채널 전압 모니터·시퀀서입니다.

Kernel driver max34440
======================

Supported chips:

  * ADI ADPM12160

    Prefixes: 'adpm12160'

    Addresses scanned: -

    Datasheet: -

  * Maxim MAX34440

    Prefixes: 'max34440'

    Addresses scanned: -

    Datasheet: https://datasheets.maximintegrated.com/en/ds/MAX34440.pdf

  * Maxim MAX34441

    PMBus 5-Channel Power-Supply Manager and Intelligent Fan Controller

    Prefixes: 'max34441'

    Addresses scanned: -

    Datasheet: https://datasheets.maximintegrated.com/en/ds/MAX34441.pdf

  * Maxim MAX34446

    PMBus Power-Supply Data Logger

    Prefixes: 'max34446'

    Addresses scanned: -

    Datasheet: https://datasheets.maximintegrated.com/en/ds/MAX34446.pdf

  * Maxim MAX34451

    PMBus 16-Channel V/I Monitor and 12-Channel Sequencer/Marginer

    Prefixes: 'max34451'

    Addresses scanned: -

    Datasheet: https://datasheets.maximintegrated.com/en/ds/MAX34451.pdf

  * Maxim MAX34460

    PMBus 12-Channel Voltage Monitor & Sequencer

    Prefix: 'max34460'

    Addresses scanned: -

    Datasheet: https://datasheets.maximintegrated.com/en/ds/MAX34460.pdf

  * Maxim MAX34461

    PMBus 16-Channel Voltage Monitor & Sequencer

    Prefix: 'max34461'

    Addresses scanned: -

    Datasheet: https://datasheets.maximintegrated.com/en/ds/MAX34461.pdf

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


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

모델별 감시 기능과 MAX34446 측정 모드

MAX34440은 6채널 전원 관리자, MAX34441은 5채널 전원 관리자와 팬 제어, MAX34446은 전원 데이터 로거를 제공합니다. MAX34451은 GIN 핀 설정에 따라 12채널의 전압 또는 전류를 감시하고, MAX34460은 전압 12채널, MAX34461은 전압 16채널을 감시합니다. ADPM12160은 입력·출력 전압과 전류를 모두 감시합니다.

원문 설명에는 마지막 모델을 `ADPM1260`이라고 적었지만 지원 칩 목록과 접두사는 `ADPM12160`입니다. 이 불일치는 원문 전체에 그대로 보존하며 번역 해설에서는 목록 기준 모델을 사용합니다.

드라이버는 PMBus 코어 클라이언트이고 자동 검출하지 않으므로 장치를 명시적으로 생성해야 합니다. 표준 PMBus 플랫폼 데이터를 지원합니다.

MAX34446에서는 `currX_crit`이 채널의 전압·전류 측정 모드를 결정합니다. 0이면 전압, 양수면 전류 측정입니다. 전력은 채널 1(또는 3)이 전압, 채널 2(또는 4)가 전류로 구성될 때만 활성화됩니다.

This driver supports multiple devices: hardware monitoring for Maxim MAX34440
PMBus 6-Channel Power-Supply Manager, MAX34441 PMBus 5-Channel Power-Supply
Manager and Intelligent Fan Controller, and MAX34446 PMBus Power-Supply Data
Logger; PMBus Voltage Monitor and Sequencers for MAX34451, MAX34460, and
MAX34461; PMBus DC/DC Power Module ADPM12160. The MAX34451 supports monitoring
voltage or current of 12 channels based on GIN pins. The MAX34460 supports 12
voltage channels, and the MAX34461 supports 16 voltage channels. The ADPM1260
also monitors both input and output of voltage and current.

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.

For MAX34446, the value of the currX_crit attribute determines if current or
voltage measurement is enabled for a given channel. Voltage measurement is
enabled if currX_crit is set to 0; current measurement is enabled if the
attribute is set to a positive value. Power measurement is only enabled if
channel 1 (3) is configured for voltage measurement, and channel 2 (4) is
configured for current measurement.


Platform data support
---------------------

The driver supports standard PMBus driver platform data.


Sysfs entries

전압·전류 한계와 경보·이력

한계값은 읽기·쓰기이고 그 밖의 속성은 읽기 전용입니다. `in[1-6]`은 `vout[1-6]` 전압입니다. `READ_VOUT`, `VOUT_UV_WARN_LIMIT`, `VOUT_OV_WARN_LIMIT`, `VOUT_UV_FAULT_LIMIT`, `VOUT_OV_FAULT_LIMIT`에서 현재값과 경고·고장 한계를 얻습니다.

전압 low/high 경보는 `VOLTAGE_UV_WARNING`과 `VOLTAGE_OV_WARNING`, 임계 low/high 경보는 `VOLTAGE_UV_FAULT`와 `VOLTAGE_OV_FAULT` 상태에서 옵니다. `lowest`, `highest`, `reset_history`는 최소·최대 이력과 초기화를 제공합니다. MAX34446은 in1-4만, ADPM12160은 in1·in2만 지원하며 레이블은 `vin1`, `vout1`입니다.

`curr[1-6]`은 `iout[1-6]` 전류이며 `READ_IOUT`, `IOUT_OC_WARN_LIMIT`, `IOUT_OC_FAULT_LIMIT`과 경고·고장 상태를 사용합니다. MAX34446/MAX34451의 curr1-4에는 평균 이력이 있고, 모든 지원 채널은 최고값과 이력 초기화를 제공합니다.

in6와 curr6은 MAX34440에만 있습니다. MAX34446은 curr1-4만 지원합니다. ADPM12160은 curr1이 `iin1`, curr2-6이 `iout1-5`입니다.

-------------

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

In
~~

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

.. note::

    - MAX34446 only supports in[1-4].
    - ADPM12160 only supports in[1-2]. Label is "vin1" and "vout1" respectively.

Curr
~~~~

======================= ========================================================
curr[1-6]_label                "iout[1-6]".
curr[1-6]_input                Measured current. From READ_IOUT register.
curr[1-6]_max                Maximum current. From IOUT_OC_WARN_LIMIT register.
curr[1-6]_crit                Critical maximum current. From IOUT_OC_FAULT_LIMIT
                        register.
curr[1-6]_max_alarm        Current high alarm. From IOUT_OC_WARNING status.
curr[1-6]_crit_alarm        Current critical high alarm. From IOUT_OC_FAULT status.
curr[1-4]_average        Historical average current (MAX34446/34451 only).
curr[1-6]_highest        Historical maximum current.
curr[1-6]_reset_history        Write any value to reset history.
======================= ========================================================

.. note::

    - in6 and curr6 attributes only exist for MAX34440.
    - MAX34446 only supports curr[1-4].
    - For ADPM12160, curr[1] is "iin1" and curr[2-6] are "iout[1-5].

전력·온도 채널과 모델별 제한

`power1`과 `power3`은 각각 `pout1`, `pout3`이며 측정 전력, 과거 평균, 과거 최고값을 제공합니다. 전력 속성은 MAX34446에만 있습니다.

`temp[1-8]_input`은 `READ_TEMPERATURE_1` 기반 온도입니다. temp1은 내부 칩, temp2-5는 원격 I2C 온도 센서입니다. MAX34441의 temp6은 원격 열 다이오드, MAX34440의 temp6-8은 원격 I2C 센서입니다.

온도 속성은 `OT_WARN_LIMIT` 최대값, `OT_FAULT_LIMIT` 임계 고온값, high·critical-high 경보, 평균·최고 이력과 초기화를 제공합니다. 평균 이력은 MAX34446에만 있습니다.

temp7·temp8은 MAX34440에만 있고 MAX34446은 temp1-3, ADPM12160은 temp1만 지원합니다. MAX34451은 GIN 구성에 따른 in1-16 또는 curr1-16과 temp1-5, MAX34460은 in1-12와 temp1-5, MAX34461은 in1-16과 temp1-5를 제공합니다.

Power
~~~~~

======================= ========================================================
power[1,3]_label        "pout[1,3]"
power[1,3]_input        Measured power.
power[1,3]_average        Historical average power.
power[1,3]_highest        Historical maximum power.
======================= ========================================================

.. note:: Power attributes only exist for MAX34446.

Temp
~~~~

======================= ========================================================
temp[1-8]_input                Measured temperatures. From READ_TEMPERATURE_1 register.
                        temp1 is the chip's internal temperature. temp2..temp5
                        are remote I2C temperature sensors. For MAX34441, temp6
                        is a remote thermal-diode sensor. For MAX34440, temp6..8
                        are remote I2C temperature sensors.
temp[1-8]_max                Maximum temperature. From OT_WARN_LIMIT register.
temp[1-8]_crit                Critical high temperature. From OT_FAULT_LIMIT register.
temp[1-8]_max_alarm        Temperature high alarm.
temp[1-8]_crit_alarm        Temperature critical high alarm.
temp[1-8]_average        Historical average temperature (MAX34446 only).
temp[1-8]_highest        Historical maximum temperature.
temp[1-8]_reset_history        Write any value to reset history.
======================= ========================================================


.. note::
   - temp7 and temp8 attributes only exist for MAX34440.
   - MAX34446 only supports temp[1-3].
   - ADPM12160 only supports temp[1].


.. note::

   - MAX34451 supports attribute groups in[1-16] (or curr[1-16] based on
     input pins) and temp[1-5].
   - MAX34460 supports attribute groups in[1-12] and temp[1-5].
   - MAX34461 supports attribute groups in[1-16] and temp[1-5].