Kernel driver xdpe122

지원 칩, 규격과 값 형식

이 문서는 GPL-2.0 라이선스를 사용합니다. 드라이버는 Infineon XDPE11280, XDPE12254, XDPE12284를 지원하며 접두사는 각각 `xdpe11280`, `xdpe12254`, `xdpe12284`입니다. 작성자는 Vadim Pasternak입니다.

드라이버는 Infineon XDPE112·XDPE122 계열의 듀얼 루프 다상 전압 조정기를 지원합니다. 이 계열에는 XDPE11280, XDPE12284, XDPE12254가 포함됩니다.

장치는 Intel VR13·VR13HC rev 1.3, IMVP8 rev 1.2, IMPVP9 rev 1.3 DC-DC 변환기 규격, Intel SVID rev 1.9 프로토콜, PMBus rev 1.3 인터페이스를 준수합니다.

입력 전압, 입력·출력 전류, 입력·출력 전력과 온도는 linear 형식으로 읽습니다. 출력 전압은 VID 형식을 사용하며 VR12.0 5mV DAC(`0x01`), VR12.5 10mV DAC(`0x02`), IMVP9 5mV DAC(`0x03`), AMD 6.25mV(`0x10`) 모드를 지원합니다.

장치는 텔레메트리용 페이지 2개를 지원합니다.

.. SPDX-License-Identifier: GPL-2.0

Kernel driver xdpe122
=====================

Supported chips:

  * Infineon XDPE11280

    Prefix: 'xdpe11280'

  * Infineon XDPE12254

    Prefix: 'xdpe12254'

  * Infineon XDPE12284

    Prefix: 'xdpe12284'

Authors:

        Vadim Pasternak <vadimp@mellanox.com>

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

This driver implements support for Infineon Multi-phase XDPE112 and XDPE122
family dual loop voltage regulators.
These families include XDPE11280, XDPE12284 and XDPE12254 devices.
The devices from this family compliant with:

- Intel VR13 and VR13HC rev 1.3, IMVP8 rev 1.2 and IMPVP9 rev 1.3 DC-DC
  converter specification.
- Intel SVID rev 1.9. protocol.
- PMBus rev 1.3 interface.

Devices support linear format for reading input voltage, input and output current,
input and output power and temperature.
Device supports VID format for reading output voltage. The below modes are
supported:
- VR12.0 mode, 5-mV DAC - 0x01.
- VR12.5 mode, 10-mV DAC - 0x02.

전류와 전압 속성

전류에는 입력값, 최대·임계 임계값, 최대·임계 경보를 제공합니다. 임계 임계값과 임계 경보는 출력 전류에서만 지원합니다. 인덱스 1·2는 `iin`, 3·4는 `iout`입니다.

전류 sysfs 속성은 `curr[3-4]_crit`, `curr[3-4]_crit_alarm`, `curr[1-4]_input`, `curr[1-4]_label`, `curr[1-4]_max`, `curr[1-4]_max_alarm`입니다.

전압에는 입력값, 임계·낮은 임계 임계값, 임계·낮은 임계 경보를 제공합니다. 인덱스 1·2는 `vin`, 3·4는 `vout`입니다.

원문 전압 속성 표기는 `in[1-4]_crit`, `in[1-4_crit_alarm`, `in[1-4]_input`, `in[1-4_label`, `in[1-4]_lcrit`, `in[1-41_lcrit_alarm`입니다. 닫는 대괄호가 빠지거나 숫자 1이 끼어든 세 표기는 원문의 오탈자를 그대로 보존한 것입니다.

- IMVP9 mode, 5-mV DAC - 0x03.
- AMD mode 6.25mV - 0x10.

Devices support two pages for telemetry.

The driver provides for current: input, maximum and critical thresholds
and maximum and critical alarms. Critical thresholds and critical alarm are
supported only for current output.
The driver exports the following attributes for via the sysfs files, where
indexes 1, 2 are for "iin" and 3, 4 for "iout":

**curr[3-4]_crit**

**curr[3-4]_crit_alarm**

**curr[1-4]_input**

**curr[1-4]_label**

**curr[1-4]_max**

**curr[1-4]_max_alarm**

The driver provides for voltage: input, critical and low critical thresholds
and critical and low critical alarms.
The driver exports the following attributes for via the sysfs files, where
indexes 1, 2 are for "vin" and 3, 4 for "vout":

**in[1-4]_crit**

**in[1-4_crit_alarm**

**in[1-4]_input**

**in[1-4_label**

전력과 온도 속성

전력에는 입력값과 경보를 제공합니다. 전력 경보는 입력 전력에서만 지원합니다. 인덱스 1·2는 `pin`, 3·4는 `pout`입니다.

전력 sysfs 속성은 입력 전력 경보 `power[1-2]_alarm`, 전체 입력값 `power[1-4]_input`, 라벨 `power[1-4]_label`입니다.

온도에는 입력값, 최대·임계 임계값, 최대·임계 경보를 제공합니다. 속성은 `temp[1-2]_crit`, `temp[1-2]_crit_alarm`, `temp[1-2]_input`, `temp[1-2]_max`, `temp[1-2]_max_alarm`입니다.

**in[1-4]_lcrit**

**in[1-41_lcrit_alarm**

The driver provides for power: input and alarms. Power alarm is supported only
for power input.
The driver exports the following attributes for via the sysfs files, where
indexes 1, 2 are for "pin" and 3, 4 for "pout":

**power[1-2]_alarm**

**power[1-4]_input**

**power[1-4]_label**

The driver provides for temperature: input, maximum and critical thresholds
and maximum and critical alarms.
The driver exports the following attributes for via the sysfs files:

**temp[1-2]_crit**

**temp[1-2]_crit_alarm**

**temp[1-2]_input**

**temp[1-2]_max**

**temp[1-2]_max_alarm**