Kernel driver zl6100

지원 ZL 계열 디지털 컨트롤러

이 드라이버는 Renesas/Intersil/Zilker Labs의 ZL2004, ZL2005, ZL2006, ZL2008, ZL2105, ZL2106, ZL6100, ZL6105, ZL8802, ZL9101M, ZL9117M과 호환 장치를 지원합니다. 각 장치의 접두사는 아래 표와 같고 자동 검색 주소는 지정하지 않습니다.

ZL2004, ZL2005, ZL2006, ZL2008, ZL2105, ZL2106, ZL6100, ZL6105는 Renesas 웹사이트의 공개 PDF 데이터시트 주소를 제공합니다. ZL8802, ZL9101M, ZL9117M도 Renesas 데이터시트 페이지를 제공합니다.

Kernel driver zl6100
====================

Supported chips:

  * Renesas / Intersil / Zilker Labs ZL2004

    Prefix: 'zl2004'

    Addresses scanned: -

    Datasheet: https://www.renesas.com/us/en/document/dst/zl2004-datasheet.pdf

  * Renesas / Intersil / Zilker Labs ZL2005

    Prefix: 'zl2005'

    Addresses scanned: -

    Datasheet: https://www.renesas.com/us/en/document/dst/zl2005-datasheet.pdf

  * Renesas / Intersil / Zilker Labs ZL2006

    Prefix: 'zl2006'

    Addresses scanned: -

    Datasheet: https://www.renesas.com/us/en/document/dst/zl2006-datasheet.pdf

  * Renesas / Intersil / Zilker Labs ZL2008

    Prefix: 'zl2008'

    Addresses scanned: -

    Datasheet: https://www.renesas.com/us/en/document/dst/zl2008-datasheet.pdf

  * Renesas / Intersil / Zilker Labs ZL2105

    Prefix: 'zl2105'

    Addresses scanned: -

    Datasheet: https://www.renesas.com/us/en/document/dst/zl2105-datasheet.pdf

  * Renesas / Intersil / Zilker Labs ZL2106

    Prefix: 'zl2106'

    Addresses scanned: -

    Datasheet: https://www.renesas.com/us/en/document/dst/zl2106-datasheet.pdf

  * Renesas / Intersil / Zilker Labs ZL6100

    Prefix: 'zl6100'

    Addresses scanned: -

    Datasheet: https://www.renesas.com/us/en/document/dst/zl6100-datasheet.pdf

  * Renesas / Intersil / Zilker Labs ZL6105

    Prefix: 'zl6105'

    Addresses scanned: -

    Datasheet: https://www.renesas.com/us/en/document/dst/zl6105-datasheet.pdf

  * Renesas / Intersil / Zilker Labs ZL8802

    Prefix: 'zl8802'

    Addresses scanned: -

    Datasheet: https://www.renesas.com/us/en/document/dst/zl8802-datasheet

  * Renesas / Intersil / Zilker Labs ZL9101M

    Prefix: 'zl9101'

    Addresses scanned: -

    Datasheet: https://www.renesas.com/us/en/document/dst/zl9101m-datasheet

  * Renesas / Intersil / Zilker Labs ZL9117M

ZLS·Flex 호환 장치와 드라이버 구조

ZLS1003과 ZLS4009의 접두사는 각각 `zls1003`, `zls4009`이며 데이터시트는 공개되지 않았습니다.

Flex 호환 장치는 BMR450·BMR451, BMR462·BMR463·BMR464, BMR465·BMR467, BMR466, BMR469입니다. 접두사는 모델명을 소문자로 쓴 `bmr450`, `bmr451`, `bmr462`, `bmr463`, `bmr464`, `bmr465`, `bmr467`, `bmr466`, `bmr469`이며 원문은 각 Flex Power Modules 기술 사양 주소를 제시합니다.

작성자는 Guenter Roeck입니다.

드라이버는 Renesas/Intersil/Zilker Labs ZL6100 및 호환 디지털 DC-DC 컨트롤러의 하드웨어 모니터링을 지원합니다. PMBus 코어 드라이버의 클라이언트 드라이버이며 자세한 내용은 `Documentation/hwmon/pmbus.rst`와 원문 표기 `Documentation.hwmon/pmbus-core`를 참조합니다.

    Prefix: 'zl9117'

    Addresses scanned: -

    Datasheet: https://www.renesas.com/us/en/document/dst/zl9117m-datasheet

  * Renesas / Intersil / Zilker Labs ZLS1003, ZLS4009

    Prefix: 'zls1003', zls4009

    Addresses scanned: -

    Datasheet: Not published

  * Flex BMR450, BMR451

    Prefix: 'bmr450', 'bmr451'

    Addresses scanned: -

    Datasheet:

https://flexpowermodules.com/resources/fpm-techspec-bmr450-digital-pol-regulators-20a

  * Flex BMR462, BMR463, BMR464

    Prefixes: 'bmr462', 'bmr463', 'bmr464'

    Addresses scanned: -

    Datasheet: https://flexpowermodules.com/resources/fpm-techspec-bmr462

  * Flex BMR465, BMR467

    Prefixes: 'bmr465', 'bmr467'

    Addresses scanned: -

    Datasheet: https://flexpowermodules.com/resources/fpm-techspec-bmr465-digital-pol

  * Flex BMR466

    Prefixes: 'bmr466'

    Addresses scanned: -

    Datasheet: https://flexpowermodules.com/resources/fpm-techspec-bmr466-8x12

  * Flex BMR469

    Prefixes: 'bmr469'

    Addresses scanned: -

    Datasheet: https://flexpowermodules.com/resources/fpm-techspec-bmr4696001

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


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

This driver supports hardware monitoring for Renesas / Intersil / Zilker Labs
ZL6100 and compatible digital DC-DC controllers.

The driver is a client driver to the core PMBus driver. Please see
Documentation/hwmon/pmbus.rst and Documentation.hwmon/pmbus-core for details
on PMBus client drivers.


Usage Notes

명시적 생성, 위험 레지스터와 접근 지연

이 드라이버는 장치를 자동 감지하지 않습니다. 사용자가 장치를 명시적으로 생성해야 하며 자세한 방법은 `Documentation/i2c/instantiating-devices.rst`를 참조합니다.

경고: `i2cdump`로 칩 레지스터에 접근하면 안 됩니다. 구성 데이터를 저장·복원하는 명령 레지스터 `0x11`, `0x12`, `0x15`, `0x16`, `0xf4`에는 어떤 `i2ctools` 명령도 사용하면 안 됩니다. 지원 칩은 읽기를 포함한 모든 접근을 해당 명령 실행 요청으로 해석합니다. 쓰기 접근이 보호되지 않았다면 전원 손실, 보드 재설정, Flash 손상이 발생할 수 있고 최악에는 보드를 사용할 수 없게 만들 수 있습니다.

드라이버는 표준 PMBus 드라이버 플랫폼 데이터를 지원합니다.

Renesas/Intersil/Zilker Labs DC-DC 컨트롤러는 I2C 버스 접근 사이에 최소 간격이 필요합니다. Intersil에 따르면 최소 2ms이지만 시험에서는 1ms도 충분했고 문제가 없었습니다. 이 문제는 현재 지원하는 모든 칩에 영향을 주는 것으로 알려져 있습니다.

수동으로 덮어쓰기 위해 쓰기 가능한 모듈 매개변수 `delay`를 제공하며 접근 간격을 0~65,535마이크로초로 설정할 수 있습니다.

-----------

This driver does not auto-detect devices. You will have to instantiate the
devices explicitly. Please see Documentation/i2c/instantiating-devices.rst for
details.

.. warning::

  Do not access chip registers using the i2cdump command, and do not use
  any of the i2ctools commands on a command register used to save and restore
  configuration data (0x11, 0x12, 0x15, 0x16, and 0xf4). The chips supported by
  this driver interpret any access to those command registers (including read
  commands) as request to execute the command in question. Unless write accesses
  to those registers are protected, this may result in power loss, board resets,
  and/or Flash corruption. Worst case, your board may turn into a brick.


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

The driver supports standard PMBus driver platform data.


Module parameters
-----------------

delay
-----

Renesas/Intersil/Zilker Labs DC-DC controllers require a minimum interval
between I2C bus accesses. According to Intersil, the minimum interval is 2 ms,
though 1 ms appears to be sufficient and has not caused any problems in testing.
The problem is known to affect all currently supported chips. For manual override,
the driver provides a writeable module parameter, 'delay', which can be used
to set the interval to a value between 0 and 65,535 microseconds.


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

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

전압·전류·온도 sysfs 속성

아래 속성을 지원합니다. 한계값은 읽기/쓰기가 가능하고 나머지 속성은 읽기 전용입니다.

`in1_*`는 `vin` 입력 전압의 측정값, 최소·최대·임계 한계와 네 경보를 제공합니다. `in2_*`는 ZL2004의 VMON 또는 ZL9101M·ZL9117M의 VDRV 핀을 나타내며 칩 내부에서 조정되어 핀 전압의 16배를 보고합니다. vmon 속성은 ZL2004, ZL8802, ZL9101M, ZL9117M, ZLS4009에서만 지원합니다.

`inX_*`는 `vout1` 또는 `vout2` 출력 전압을 제공합니다. X는 ZL2004·ZL9101M·ZL9117M에서 3, ZL8802에서 3과 4, 그 밖의 장치에서 2입니다.

`curr1_*` 입력 전류 `iin` 속성은 ZL8802에서만 지원합니다. `currY_*`는 `iout1` 또는 `iout2` 출력 전류이며 Y는 ZL8802에서 2와 3, 그 밖의 장치에서 1입니다.

`temp1`과 `temp2`는 측정 온도, 최소·최대·임계 저온·임계 고온과 각각의 경보를 제공합니다.

======================= ========================================================
in1_label                "vin"
in1_input                Measured input voltage.
in1_min                        Minimum input voltage.
in1_max                        Maximum input voltage.
in1_lcrit                Critical minimum input voltage.
in1_crit                Critical maximum input voltage.
in1_min_alarm                Input voltage low alarm.
in1_max_alarm                Input voltage high alarm.
in1_lcrit_alarm                Input voltage critical low alarm.
in1_crit_alarm                Input voltage critical high alarm.

in2_label                "vmon"
in2_input                Measured voltage on VMON (ZL2004) or VDRV (ZL9101M,
                        ZL9117M) pin. Reported voltage is 16x the voltage on the
                        pin (adjusted internally by the chip).
in2_lcrit                Critical minimum VMON/VDRV Voltage.
in2_crit                Critical maximum VMON/VDRV voltage.
in2_lcrit_alarm                VMON/VDRV voltage critical low alarm.
in2_crit_alarm                VMON/VDRV voltage critical high alarm.

                        vmon attributes are supported on ZL2004, ZL8802,
                        ZL9101M, ZL9117M and ZLS4009 only.

inX_label                "vout[12]"
inX_input                Measured output voltage.
inX_lcrit                Critical minimum output Voltage.
inX_crit                Critical maximum output voltage.
inX_lcrit_alarm                Critical output voltage critical low alarm.
inX_crit_alarm                Critical output voltage critical high alarm.

                        X is 3 for ZL2004, ZL9101M, and ZL9117M,
                        3, 4 for ZL8802 and 2 otherwise.

curr1_label                "iin"
curr1_input                Measured input current.

                        iin attributes are supported on ZL8802 only

currY_label                "iout[12]"
currY_input                Measured output current.
currY_lcrit                Critical minimum output current.
currY_crit                Critical maximum output current.
currY_lcrit_alarm        Output current critical low alarm.
currY_crit_alarm        Output current critical high alarm.

                        Y is 2, 3 for ZL8802, 1 otherwise

temp[12]_input                Measured temperature.
temp[12]_min                Minimum temperature.
temp[12]_max                Maximum temperature.
temp[12]_lcrit                Critical low temperature.
temp[12]_crit                Critical high temperature.
temp[12]_min_alarm        Chip temperature low alarm.
temp[12]_max_alarm        Chip temperature high alarm.
temp[12]_lcrit_alarm        Chip temperature critical low alarm.
temp[12]_crit_alarm        Chip temperature critical high alarm.
======================= ========================================================