Kernel driver max16601

VR13 듀얼 출력 레귤레이터와 PMBus 등록

GPL-2.0 문서의 드라이버는 MAX16508, MAX16600, MAX16601, MAX16602를 각각 `max16508`, `max16600`, `max16601`, `max16602` 접두사로 지원합니다. MAX16602를 제외한 세 장치의 데이터시트는 공개되지 않았고 저자는 Guenter Roeck입니다.

MAX16508은 VR13 듀얼 출력 전압 레귤레이터이며 MAX16600/16601/16602는 VR13.HC 듀얼 출력 전압 레귤레이터 칩셋입니다. 드라이버는 PMBus 코어의 클라이언트로 `Documentation/hwmon/pmbus.rst`를 따릅니다.

장치를 자동 감지하지 않으므로 `Documentation/i2c/instantiating-devices.rst` 방식으로 명시적으로 생성해야 하며 표준 PMBus 플랫폼 데이터를 지원합니다.

.. SPDX-License-Identifier: GPL-2.0

Kernel driver max16601
======================

Supported chips:

  * Maxim MAX16508

    Prefix: 'max16508'

    Addresses scanned: -

    Datasheet: Not published

  * Maxim MAX16600

    Prefix: 'max16600'

    Addresses scanned: -

    Datasheet: Not published

  * Maxim MAX16601

    Prefix: 'max16601'

    Addresses scanned: -

    Datasheet: Not published

  * Maxim MAX16602

    Prefix: 'max16602'

    Addresses scanned: -

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

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


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

This driver supports the MAX16508 VR13 Dual-Output Voltage Regulator
as well as the MAX16600, MAX16601, and MAX16602 VR13.HC Dual-Output
Voltage Regulator chipsets.

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

VCORE·VSA와 위상별 동적 전류 채널

`in1`은 `vin1` VCORE 입력 전압, `in2`는 `vout1` VCORE 출력 전압이며 각각 현재값과 전압 알람을 제공합니다. `curr1`은 `iin1` VCORE 입력 전류로 듀티 사이클과 출력 전류에서 유도하며 최대 전류와 고전류 알람이 있습니다.

각 VCORE 위상 P의 입력 전류는 `curr[P+2]`에 `iin1.P`로 나타납니다. `N`은 활성화·실장된 위상 수입니다. 센서 소자에서 얻은 VCORE 입력 전류 `iin2`는 `curr[N+2]`, VSA 입력 전류 `iin3`는 `curr[N+3]`입니다.

VCORE 출력 전류 `iout1`은 `curr[N+4]`이며 임계·최대 한계와 각각의 알람을 제공합니다. 각 VCORE 위상 P 출력 전류 `iout1.P`는 `curr[N+P+5]`입니다.

VSA 출력 전류 `iout3`은 `curr[2*N+5]`입니다. 현재값, 과거 최고값, 이력 초기화, 임계·최대 전류와 알람을 제공합니다. 원문의 reset 설명은 `curr21_highest`로 고정 표기되어 있으며 영어 원문에 그대로 보존합니다.

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

The driver supports standard PMBus driver platform data.


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

The following attributes are supported.

=============================== ===============================================
in1_label                        "vin1"
in1_input                        VCORE input voltage.
in1_alarm                        Input voltage alarm.

in2_label                        "vout1"
in2_input                        VCORE output voltage.
in2_alarm                        Output voltage alarm.

curr1_label                        "iin1"
curr1_input                        VCORE input current, derived from duty cycle
                                and output current.
curr1_max                        Maximum input current.
curr1_max_alarm                        Current high alarm.

curr[P+2]_label                        "iin1.P"
curr[P+2]_input                        VCORE phase P input current.

curr[N+2]_label                        "iin2"
curr[N+2]_input                        VCORE input current, derived from sensor
                                element.
                                'N' is the number of enabled/populated phases.

curr[N+3]_label                        "iin3"
curr[N+3]_input                        VSA input current.

curr[N+4]_label                        "iout1"
curr[N+4]_input                        VCORE output current.
curr[N+4]_crit                        Critical output current.
curr[N+4]_crit_alarm                Output current critical alarm.
curr[N+4]_max                        Maximum output current.
curr[N+4]_max_alarm                Output current high alarm.

curr[N+P+5]_label                "iout1.P"
curr[N+P+5]_input                VCORE phase P output current.

입력·출력 전력과 VCORE·VSA 온도

`power1`은 `pin1`로 듀티 사이클과 출력 전류에서 유도한 입력 전력 및 입력 전력 알람을 제공합니다. `power2`는 `pin2`로 입력 전류 센서에서 유도한 입력 전력이고 `power3`은 `pout` 출력 전력입니다.

`temp1`은 VCORE 온도로 현재값, 임계·최대 한계와 각각의 고온 알람을 제공합니다. `temp2-5`는 `TSENSE_0`부터 `TSENSE_3`까지의 온도입니다.

`temp6`은 VSA 온도로 현재값, 임계·최대 한계와 각각의 임계 고온·고온 알람을 제공합니다.

curr[2*N+5]_label                "iout3"
curr[2*N+5]_input                VSA output current.
curr[2*N+5]_highest                Historical maximum VSA output current.
curr[2*N+5]_reset_history        Write any value to reset curr21_highest.
curr[2*N+5]_crit                Critical output current.
curr[2*N+5]_crit_alarm                Output current critical alarm.
curr[2*N+5]_max                        Maximum output current.
curr[2*N+5]_max_alarm                Output current high alarm.

power1_label                        "pin1"
power1_input                        Input power, derived from duty cycle and output
                                current.
power1_alarm                        Input power alarm.

power2_label                        "pin2"
power2_input                        Input power, derived from input current sensor.

power3_label                        "pout"
power3_input                        Output power.

temp1_input                        VCORE temperature.
temp1_crit                        Critical high temperature.
temp1_crit_alarm                Chip temperature critical high alarm.
temp1_max                        Maximum temperature.
temp1_max_alarm                        Chip temperature high alarm.

temp2_input                        TSENSE_0 temperature
temp3_input                        TSENSE_1 temperature
temp4_input                        TSENSE_2 temperature
temp5_input                        TSENSE_3 temperature

temp6_input                        VSA temperature.
temp6_crit                        Critical high temperature.
temp6_crit_alarm                Chip temperature critical high alarm.
temp6_max                        Maximum temperature.
temp6_max_alarm                        Chip temperature high alarm.
=============================== ===============================================