Kernel driver isl68137

지원 칩: ISL68137 및 ISL682xx 계열

`isl68137` 커널 드라이버가 지원하는 첫 번째 장치군입니다. 모든 항목의 주소 검색 값은 `-`이므로 드라이버가 버스에서 장치를 자동 탐색하지 않습니다. 보드가 제공하는 I2C 주소와 아래 접두사를 사용해 장치를 명시해야 합니다.

ISL68137 데이터시트는 문서에 표시된 Renesas 공개 링크에서 확인할 수 있습니다. ISL68220부터 ISL68239까지의 데이터시트는 2020년 8월 제품 출시 이후 Renesas 웹사이트에서 공개적으로 제공된다고 원문이 설명합니다.

Kernel driver isl68137
======================

Supported chips:

  * Renesas ISL68137

    Prefix: 'isl68137'

    Addresses scanned: -

    Datasheet:

      Publicly available at the Renesas website
      https://www.renesas.com/us/en/www/doc/datasheet/isl68137.pdf

  * Renesas ISL68220

    Prefix: 'isl68220'

    Addresses scanned: -

    Datasheet:

      Publicly available (after August 2020 launch) at the Renesas website

  * Renesas ISL68221

    Prefix: 'isl68221'

    Addresses scanned: -

    Datasheet:

      Publicly available (after August 2020 launch) at the Renesas website

  * Renesas ISL68222

    Prefix: 'isl68222'

    Addresses scanned: -

    Datasheet:

      Publicly available (after August 2020 launch) at the Renesas website

  * Renesas ISL68223

    Prefix: 'isl68223'

    Addresses scanned: -

    Datasheet:

      Publicly available (after August 2020 launch) at the Renesas website

  * Renesas ISL68224

    Prefix: 'isl68224'

    Addresses scanned: -

    Datasheet:

      Publicly available (after August 2020 launch) at the Renesas website

  * Renesas ISL68225

    Prefix: 'isl68225'

    Addresses scanned: -

    Datasheet:

      Publicly available (after August 2020 launch) at the Renesas website

  * Renesas ISL68226

    Prefix: 'isl68226'

    Addresses scanned: -

    Datasheet:

      Publicly available (after August 2020 launch) at the Renesas website

  * Renesas ISL68227

    Prefix: 'isl68227'

    Addresses scanned: -

    Datasheet:

      Publicly available (after August 2020 launch) at the Renesas website

  * Renesas ISL68229

    Prefix: 'isl68229'

    Addresses scanned: -

    Datasheet:

      Publicly available (after August 2020 launch) at the Renesas website

  * Renesas ISL68233

    Prefix: 'isl68233'

    Addresses scanned: -

    Datasheet:

      Publicly available (after August 2020 launch) at the Renesas website

  * Renesas ISL68239

    Prefix: 'isl68239'

    Addresses scanned: -

    Datasheet:

      Publicly available (after August 2020 launch) at the Renesas website

지원 칩: ISL6922x·ISL6924x 계열

두 번째 장치군은 ISL69222부터 ISL69248까지의 디지털 다상 전압 레귤레이터입니다. 각 칩의 접두사는 칩 이름을 소문자로 쓴 값이며, 이 장치들도 주소를 자동 검색하지 않습니다.

이 구간에 나열된 모든 데이터시트는 2020년 8월 출시 이후 Renesas 웹사이트에서 공개적으로 제공된다고 기록되어 있습니다. 레일 수와 전압 범위는 부품마다 다를 수 있으므로 개별 데이터시트를 확인해야 합니다.

  * Renesas ISL69222

    Prefix: 'isl69222'

    Addresses scanned: -

    Datasheet:

      Publicly available (after August 2020 launch) at the Renesas website

  * Renesas ISL69223

    Prefix: 'isl69223'

    Addresses scanned: -

    Datasheet:

      Publicly available (after August 2020 launch) at the Renesas website

  * Renesas ISL69224

    Prefix: 'isl69224'

    Addresses scanned: -

    Datasheet:

      Publicly available (after August 2020 launch) at the Renesas website

  * Renesas ISL69225

    Prefix: 'isl69225'

    Addresses scanned: -

    Datasheet:

      Publicly available (after August 2020 launch) at the Renesas website

  * Renesas ISL69227

    Prefix: 'isl69227'

    Addresses scanned: -

    Datasheet:

      Publicly available (after August 2020 launch) at the Renesas website

  * Renesas ISL69228

    Prefix: 'isl69228'

    Addresses scanned: -

    Datasheet:

      Publicly available (after August 2020 launch) at the Renesas website

  * Renesas ISL69234

    Prefix: 'isl69234'

    Addresses scanned: -

    Datasheet:

      Publicly available (after August 2020 launch) at the Renesas website

  * Renesas ISL69236

    Prefix: 'isl69236'

    Addresses scanned: -

    Datasheet:

      Publicly available (after August 2020 launch) at the Renesas website

  * Renesas ISL69239

    Prefix: 'isl69239'

    Addresses scanned: -

    Datasheet:

      Publicly available (after August 2020 launch) at the Renesas website

  * Renesas ISL69242

    Prefix: 'isl69242'

    Addresses scanned: -

    Datasheet:

      Publicly available (after August 2020 launch) at the Renesas website

  * Renesas ISL69243

    Prefix: 'isl69243'

    Addresses scanned: -

    Datasheet:

      Publicly available (after August 2020 launch) at the Renesas website

  * Renesas ISL69247

    Prefix: 'isl69247'

    Addresses scanned: -

    Datasheet:

      Publicly available (after August 2020 launch) at the Renesas website

  * Renesas ISL69248

    Prefix: 'isl69248'

    Addresses scanned: -

    Datasheet:

      Publicly available (after August 2020 launch) at the Renesas website

지원 칩: ISL6925x·ISL6926x·RAA 계열

세 번째 장치군에는 ISL69254, ISL69255, ISL69256, ISL69259, ISL69260, ISL69268, ISL69269, ISL69298과 RAA228000 계열 및 RAA22900x 계열이 포함됩니다. 모든 장치의 주소 검색 값은 `-`입니다.

대부분의 데이터시트는 2020년 8월 출시 이후 Renesas 웹사이트에서 공개적으로 제공됩니다. 예외적으로 RAA228244와 RAA228246 데이터시트는 Renesas에 요청하고 비밀유지계약(NDA)을 체결해야 제공됩니다.

  * Renesas ISL69254

    Prefix: 'isl69254'

    Addresses scanned: -

    Datasheet:

      Publicly available (after August 2020 launch) at the Renesas website

  * Renesas ISL69255

    Prefix: 'isl69255'

    Addresses scanned: -

    Datasheet:

      Publicly available (after August 2020 launch) at the Renesas website

  * Renesas ISL69256

    Prefix: 'isl69256'

    Addresses scanned: -

    Datasheet:

      Publicly available (after August 2020 launch) at the Renesas website

  * Renesas ISL69259

    Prefix: 'isl69259'

    Addresses scanned: -

    Datasheet:

      Publicly available (after August 2020 launch) at the Renesas website

  * Renesas ISL69260

    Prefix: 'isl69260'

    Addresses scanned: -

    Datasheet:

      Publicly available (after August 2020 launch) at the Renesas website

  * Renesas ISL69268

    Prefix: 'isl69268'

    Addresses scanned: -

    Datasheet:

      Publicly available (after August 2020 launch) at the Renesas website

  * Renesas ISL69269

    Prefix: 'isl69269'

    Addresses scanned: -

    Datasheet:

      Publicly available (after August 2020 launch) at the Renesas website

  * Renesas ISL69298

    Prefix: 'isl69298'

    Addresses scanned: -

    Datasheet:

      Publicly available (after August 2020 launch) at the Renesas website

  * Renesas RAA228000

    Prefix: 'raa228000'

    Addresses scanned: -

    Datasheet:

      Publicly available (after August 2020 launch) at the Renesas website

  * Renesas RAA228004

    Prefix: 'raa228004'

    Addresses scanned: -

    Datasheet:

      Publicly available (after August 2020 launch) at the Renesas website

  * Renesas RAA228006

    Prefix: 'raa228006'

    Addresses scanned: -

    Datasheet:

      Publicly available (after August 2020 launch) at the Renesas website

  * Renesas RAA228228

    Prefix: 'raa228228'

    Addresses scanned: -

    Datasheet:

      Publicly available (after August 2020 launch) at the Renesas website

  * Renesas RAA228244

    Prefix: 'raa228244'

    Addresses scanned: -

    Datasheet:

      Provided by Renesas upon request and NDA

  * Renesas RAA228246

    Prefix: 'raa228246'

    Addresses scanned: -

    Datasheet:

      Provided by Renesas upon request and NDA

  * Renesas RAA229001

    Prefix: 'raa229001'

    Addresses scanned: -

    Datasheet:

      Publicly available (after August 2020 launch) at the Renesas website

  * Renesas RAA229004

    Prefix: 'raa229004'

    Addresses scanned: -

    Datasheet:

      Publicly available (after August 2020 launch) at the Renesas website

드라이버 구조, 레일 구성, AVS 운용

작성자는 Maxim Sloyko, Robert Lippert, Patrick Venture, Grant Peltier입니다. 드라이버는 Renesas ISL68137과 2세대 Renesas 디지털 다상 전압 레귤레이터 전체, 즉 `raa_dmpvr2` 계열을 지원합니다.

ISL68137은 AVSBus 인터페이스를 갖춘 디지털 출력 7상 구성 가능 PWM 컨트롤러입니다. 2세대 장치는 단일 레일 장치용 `1rail`, 이중 레일용 `2rail`, 3레일용 `3rail`, 고전압 단일 레일용 `hv`의 네 구성으로 분류됩니다. 세부 사양은 각 데이터시트를 확인해야 합니다.

드라이버는 PMBus 장치를 탐색하지 않으므로 장치를 명시적으로 인스턴스화해야 합니다. ISL68137의 AVS 동작 모드는 런타임에 활성화하거나 비활성화해야 하며, 일반 PMBus sysfs 속성 외에 각 레일의 AVS 상태를 제어하는 전용 속성을 제공합니다.

2세대 Renesas 디지털 다상 전압 레귤레이터는 일반 PMBus sysfs 속성만 지원합니다. 즉 `avs(0|1)_enable` 제어는 ISL68137에만 해당하고 `raa_dmpvr2` 장치에는 적용되지 않습니다.

Authors:
      - Maxim Sloyko <maxims@google.com>
      - Robert Lippert <rlippert@google.com>
      - Patrick Venture <venture@google.com>
      - Grant Peltier <grant.peltier.jg@renesas.com>

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

This driver supports the Renesas ISL68137 and all 2nd generation Renesas
digital multiphase voltage regulators (raa_dmpvr2). The ISL68137 is a digital
output 7-phase configurable PWM controller with an AVSBus interface. 2nd
generation devices are grouped into 4 distinct configurations: '1rail' for
single-rail devices, '2rail' for dual-rail devices, '3rail' for 3-rail devices,
and 'hv' for high voltage single-rail devices. Consult the individual datasheets
for more information.

Usage Notes
-----------

This driver does not probe for PMBus devices. You will have to instantiate
devices explicitly.

The ISL68137 AVS operation mode must be enabled/disabled at runtime.

Beyond the normal sysfs pmbus attributes, the driver exposes a control attribute
for the ISL68137.

For 2nd generation Renesas digital multiphase voltage regulators, only the
normal sysfs pmbus attributes are supported.

ISL68137 전용 sysfs 속성

`avs(0|1)_enable`은 각 레일의 AVS 상태를 제어합니다. `curr1`은 `iin` 입력 전류 채널이며 측정값, 임계 최대 전류, 임계 상한 경보를 제공합니다. `curr[2-3]`은 `iout[1-2]` 두 출력 전류 채널로 동일한 측정·임계·경보 속성을 제공합니다.

`in1`은 `vin` 입력 전압이며 측정값과 임계 최소·최대 전압, 각각의 critical low·high 경보를 제공합니다. `in[2-3]`은 `vout[1-2]` 출력 전압이며 각 출력마다 같은 임계 최소·최대와 경보를 제공합니다.

`power1`은 `pin` 입력 전력, 측정값, 입력 전력 상한 경보를 제공합니다. `power[2-3]`은 `pout[1-2]` 출력 전력 측정값입니다. `temp[1-3]`은 세 온도 채널의 측정값, 임계 고온과 경보, 일반 최대 온도와 고온 경보를 제공합니다.

ISL68137 sysfs attributes
-------------------------

======================= ====================================
avs(0|1)_enable                Controls the AVS state of each rail.

curr1_label                "iin"
curr1_input                Measured input current
curr1_crit                Critical maximum current
curr1_crit_alarm        Current critical high alarm

curr[2-3]_label                "iout[1-2]"
curr[2-3]_input                Measured output current
curr[2-3]_crit                Critical maximum current
curr[2-3]_crit_alarm        Current critical high alarm

in1_label                "vin"
in1_input                Measured input voltage
in1_lcrit                Critical minimum input voltage
in1_lcrit_alarm                Input voltage critical low alarm
in1_crit                Critical maximum input voltage
in1_crit_alarm                Input voltage critical high alarm

in[2-3]_label                "vout[1-2]"
in[2-3]_input                Measured output voltage
in[2-3]_lcrit                Critical minimum output voltage
in[2-3]_lcrit_alarm        Output voltage critical low alarm
in[2-3]_crit                Critical maximum output voltage
in[2-3]_crit_alarm        Output voltage critical high alarm

power1_label                "pin"
power1_input                Measured input power
power1_alarm                Input power high alarm

power[2-3]_label        "pout[1-2]"
power[2-3]_input        Measured output power

temp[1-3]_input                Measured temperature
temp[1-3]_crit                Critical high temperature
temp[1-3]_crit_alarm        Chip temperature critical high alarm
temp[1-3]_max                Maximum temperature
temp[1-3]_max_alarm        Chip temperature high alarm
======================= ====================================

raa_dmpvr2 1rail·hv sysfs 속성

`raa_dmpvr2_1rail`과 `hv` 구성에서 `curr1`은 `iin` 입력 전류, `curr2`는 `iout` 출력 전류입니다. 두 채널 모두 측정 전류, 임계 최대 전류, 임계 상한 경보를 제공합니다.

`in1`은 `vin` 입력 전압이며 측정값과 임계 최소·최대, 각각의 저전압·고전압 경보를 제공합니다. `in2`는 `vmon` 레이블로 VMON 핀에서 읽은 스케일된 전압입니다. `in3`은 `vout` 출력 전압이며 측정값과 임계 최소·최대 및 해당 경보를 제공합니다.

`power1`은 `pin` 입력 전력과 입력 전력 상한 경보, `power2`는 `pout` 출력 전력입니다. `temp[1-3]`은 세 온도의 측정값, 임계 고온과 경보, 최대 온도와 고온 경보를 제공합니다.

raa_dmpvr2_1rail/hv sysfs attributes
------------------------------------

======================= ==========================================
curr1_label                "iin"
curr1_input                Measured input current
curr1_crit                Critical maximum current
curr1_crit_alarm        Current critical high alarm

curr2_label                "iout"
curr2_input                Measured output current
curr2_crit                Critical maximum current
curr2_crit_alarm        Current critical high alarm

in1_label                "vin"
in1_input                Measured input voltage
in1_lcrit                Critical minimum input voltage
in1_lcrit_alarm                Input voltage critical low alarm
in1_crit                Critical maximum input voltage
in1_crit_alarm                Input voltage critical high alarm

in2_label                "vmon"
in2_input                Scaled VMON voltage read from the VMON pin

in3_label                "vout"
in3_input                Measured output voltage
in3_lcrit                Critical minimum output voltage
in3_lcrit_alarm         Output voltage critical low alarm
in3_crit                Critical maximum output voltage
in3_crit_alarm          Output voltage critical high alarm

power1_label                "pin"
power1_input                Measured input power
power1_alarm                Input power high alarm

power2_label                "pout"
power2_input                Measured output power

temp[1-3]_input                Measured temperature
temp[1-3]_crit                Critical high temperature
temp[1-3]_crit_alarm        Chip temperature critical high alarm
temp[1-3]_max                Maximum temperature
temp[1-3]_max_alarm        Chip temperature high alarm
======================= ==========================================

raa_dmpvr2 2rail sysfs 속성

2레일 구성에서 `curr[1-2]`는 `iin[1-2]` 두 입력 전류 채널이고 `curr[3-4]`는 `iout[1-2]` 두 출력 전류 채널입니다. 모든 전류 채널은 측정값, 임계 최대 전류, 임계 상한 경보를 제공합니다.

공통 입력 전압은 `in1`의 `vin`이며 측정값과 임계 최소·최대 및 해당 경보를 제공합니다. `in2`의 `vmon`은 VMON 핀에서 읽은 스케일된 전압입니다. `in[3-4]`는 `vout[1-2]` 두 출력 전압으로 임계 최소·최대 및 경보를 각각 제공합니다.

`power[1-2]`는 `pin[1-2]` 두 입력 전력과 상한 경보, `power[3-4]`는 `pout[1-2]` 두 출력 전력입니다. `temp[1-5]`는 다섯 온도 채널에 대해 측정값, 임계 고온과 경보, 최대 온도와 고온 경보를 제공합니다.

raa_dmpvr2_2rail sysfs attributes
---------------------------------

======================= ==========================================
curr[1-2]_label                "iin[1-2]"
curr[1-2]_input                Measured input current
curr[1-2]_crit                Critical maximum current
curr[1-2]_crit_alarm        Current critical high alarm

curr[3-4]_label                "iout[1-2]"
curr[3-4]_input                Measured output current
curr[3-4]_crit                Critical maximum current
curr[3-4]_crit_alarm        Current critical high alarm

in1_label                "vin"
in1_input                Measured input voltage
in1_lcrit                Critical minimum input voltage
in1_lcrit_alarm                Input voltage critical low alarm
in1_crit                Critical maximum input voltage
in1_crit_alarm                Input voltage critical high alarm

in2_label                "vmon"
in2_input                Scaled VMON voltage read from the VMON pin

in[3-4]_label                "vout[1-2]"
in[3-4]_input                Measured output voltage
in[3-4]_lcrit                Critical minimum output voltage
in[3-4]_lcrit_alarm        Output voltage critical low alarm
in[3-4]_crit                Critical maximum output voltage
in[3-4]_crit_alarm        Output voltage critical high alarm

power[1-2]_label        "pin[1-2]"
power[1-2]_input        Measured input power
power[1-2]_alarm        Input power high alarm

power[3-4]_label        "pout[1-2]"
power[3-4]_input        Measured output power

temp[1-5]_input                Measured temperature
temp[1-5]_crit                Critical high temperature
temp[1-5]_crit_alarm        Chip temperature critical high alarm
temp[1-5]_max                Maximum temperature
temp[1-5]_max_alarm        Chip temperature high alarm
======================= ==========================================

raa_dmpvr2 3rail sysfs 속성

3레일 구성에서 `curr[1-3]`은 `iin[1-3]` 세 입력 전류 채널이고 `curr[4-6]`은 `iout[1-3]` 세 출력 전류 채널입니다. 모든 채널은 측정 전류, 임계 최대 전류, 임계 상한 경보를 제공합니다.

공통 입력 전압 `in1`의 레이블은 `vin`이며 측정값과 임계 최소·최대 및 각각의 경보를 제공합니다. `in2`의 `vmon`은 VMON 핀에서 읽은 스케일된 전압입니다. `in[3-5]`는 `vout[1-3]` 세 출력 전압과 임계 최소·최대 및 경보입니다.

`power[1-3]`은 `pin[1-3]` 세 입력 전력과 각 입력 전력 상한 경보를 제공합니다. `power[4-6]`은 `pout[1-3]` 세 출력 전력입니다. `temp[1-7]`은 일곱 온도 채널의 측정값, 임계 고온과 경보, 최대 온도와 고온 경보를 제공합니다.

raa_dmpvr2_3rail sysfs attributes
---------------------------------

======================= ==========================================
curr[1-3]_label                "iin[1-3]"
curr[1-3]_input                Measured input current
curr[1-3]_crit                Critical maximum current
curr[1-3]_crit_alarm        Current critical high alarm

curr[4-6]_label                "iout[1-3]"
curr[4-6]_input                Measured output current
curr[4-6]_crit                Critical maximum current
curr[4-6]_crit_alarm        Current critical high alarm

in1_label                "vin"
in1_input                Measured input voltage
in1_lcrit                Critical minimum input voltage
in1_lcrit_alarm                Input voltage critical low alarm
in1_crit                Critical maximum input voltage
in1_crit_alarm                Input voltage critical high alarm

in2_label                "vmon"
in2_input                Scaled VMON voltage read from the VMON pin

in[3-5]_label                "vout[1-3]"
in[3-5]_input                Measured output voltage
in[3-5]_lcrit                Critical minimum output voltage
in[3-5]_lcrit_alarm        Output voltage critical low alarm
in[3-5]_crit                Critical maximum output voltage
in[3-5]_crit_alarm        Output voltage critical high alarm

power[1-3]_label        "pin[1-3]"
power[1-3]_input        Measured input power
power[1-3]_alarm        Input power high alarm

power[4-6]_label        "pout[1-3]"
power[4-6]_input        Measured output power

temp[1-7]_input                Measured temperature
temp[1-7]_crit                Critical high temperature
temp[1-7]_crit_alarm        Chip temperature critical high alarm
temp[1-7]_max                Maximum temperature
temp[1-7]_max_alarm        Chip temperature high alarm
======================= ==========================================