Kernel driver adm1275

ADM1075부터 ADM1276까지

이 드라이버는 여러 Analog Devices Hot-Swap Controller와 Digital Power Monitor를 지원합니다. `ADM1075`의 prefix는 `adm1075`, `ADM1272`는 `adm1272`, `ADM1273`은 `adm1273`, `ADM1275`는 `adm1275`, `ADM1276`은 `adm1276`입니다.

이 다섯 모델은 자동 검색 주소가 지정되어 있지 않아 `Addresses scanned: -`로 표시됩니다. ADM1075, ADM1272, ADM1275, ADM1276 데이터시트 URL은 문서에 기재되어 있고 ADM1273 데이터시트는 아직 공개되지 않았습니다.

Kernel driver adm1275
=====================

Supported chips:

  * Analog Devices ADM1075

    Prefix: 'adm1075'

    Addresses scanned: -

    Datasheet: www.analog.com/static/imported-files/data_sheets/ADM1075.pdf

  * Analog Devices ADM1272

    Prefix: 'adm1272'

    Addresses scanned: -

    Datasheet: www.analog.com/static/imported-files/data_sheets/ADM1272.pdf

  * Analog Devices ADM1273

    Prefix: 'adm1273'

    Addresses scanned: -

    Datasheet: Not yet publicly available

  * Analog Devices ADM1275

    Prefix: 'adm1275'

    Addresses scanned: -

    Datasheet: www.analog.com/static/imported-files/data_sheets/ADM1275.pdf

  * Analog Devices ADM1276

    Prefix: 'adm1276'

    Addresses scanned: -

ADM1278부터 SQ24905C까지

나머지 Analog Devices 모델은 `ADM1278` prefix `adm1278`, `ADM1281` prefix `adm1281`, `ADM1293` 및 `ADM1294` prefix `adm1293`, `adm1294`입니다. 이 모델들도 자동 검색 주소가 없으며 각 데이터시트 URL이 제공됩니다.

Silergy `SQ24905C`도 지원합니다. 이 칩의 prefix는 `mc09c`이고 자동 검색 주소는 없으며 Silergy 다운로드 URL이 제공됩니다.

드라이버 저자는 Guenter Roeck이며 연락처는 `linux@roeck-us.net`입니다.

    Datasheet: www.analog.com/static/imported-files/data_sheets/ADM1276.pdf

  * Analog Devices ADM1278

    Prefix: 'adm1278'

    Addresses scanned: -

    Datasheet: www.analog.com/static/imported-files/data_sheets/ADM1278.pdf

  * Analog Devices ADM1281

    Prefix: 'adm1281'

    Addresses scanned: -

    Datasheet: https://www.analog.com/media/en/technical-documentation/data-sheets/adm1281.pdf

  * Analog Devices ADM1293/ADM1294

    Prefix: 'adm1293', 'adm1294'

    Addresses scanned: -

    Datasheet: https://www.analog.com/media/en/technical-documentation/data-sheets/ADM1293_1294.pdf

  * Silergy SQ24905C

    Prefix: 'mc09c'

    Addresses scanned: -

    Datasheet: https://www.silergy.com/download/downloadFile?id=5669&type=product&ftype=note

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

Hot-Swap, PMBus와 사용 조건

이 드라이버는 ADM1075, ADM1272, ADM1273, ADM1275, ADM1276, ADM1278, ADM1281, ADM1293, ADM1294 및 SQ24905C Hot-Swap Controller와 Digital Power Monitor의 hardware monitoring을 지원합니다.

이 칩들은 전원이 켜진 backplane에서 circuit board를 제거하거나 삽입할 수 있게 하는 hot-swap controller입니다. 통합 12-bit analog-to-digital converter, 즉 ADC를 통해 전류와 전압을 readback하며 PMBus interface로 접근합니다.

드라이버는 core PMBus driver의 client입니다. PMBus client driver에 관한 자세한 내용은 `Documentation/hwmon/pmbus.rst`를 참조합니다.

장치를 자동 검색하지 않으므로 사용자가 명시적으로 instantiate해야 합니다. 등록 방법은 `Documentation/i2c/instantiating-devices.rst`를 참조합니다.

ADM1075는 다른 많은 PMBus 장치와 달리 내부 전압 또는 전류 scaling을 지원하지 않습니다. 보고되는 전압, 전류와 전력은 raw measurement이므로 일반적으로 외부에서 scale해야 합니다.

Shunt 값은 micro-ohm 단위로 device tree에서 compile time에 설정할 수 있습니다. Device tree를 사용한다면 binding은 `Documentation/devicetree/bindings/hwmon/adi,adm1275.yaml`을 참조합니다.

드라이버는 표준 PMBus driver platform data도 지원합니다. 자세한 내용은 다시 `Documentation/hwmon/pmbus.rst`에 있습니다.

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

This driver supports hardware monitoring for Analog Devices ADM1075, ADM1272,
ADM1273, ADM1275, ADM1276, ADM1278, ADM1281, ADM1293, ADM1294, and SQ24905C
Hot-Swap Controller and Digital Power Monitors.

ADM1075, ADM1272, ADM1273, ADM1275, ADM1276, ADM1278, ADM1281, ADM1293,
ADM1294 and SQ24905C are hot-swap controllers that allow a circuit board to be
removed from or inserted into a live backplane. They also feature current and
voltage readback via an integrated 12 bit analog-to-digital converter (ADC),
accessed using a PMBus interface.

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.

The ADM1075, unlike many other PMBus devices, does not support internal voltage
or current scaling. Reported voltages, currents, and power are raw measurements,
and will typically have to be scaled.

The shunt value in micro-ohms can be set via device tree at compile-time. Please
refer to the Documentation/devicetree/bindings/hwmon/adi,adm1275.yaml for bindings
if the device tree is used.

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

The driver supports standard PMBus driver platform data. Please see
Documentation/hwmon/pmbus.rst for details.

전압과 전류 sysfs

지원 attribute 가운데 limit는 read-write, history reset은 write-only이며 그 밖의 attribute는 모두 read-only입니다.

`inX_label`은 chip variant와 configuration에 따라 `vin1` 또는 `vout1`입니다. ADM1075, ADM1293, ADM1294에서 `vout1`은 VAUX pin의 전압을 보고합니다. `inX_input`은 측정 전압, `inX_min`과 `inX_max`는 최소 및 최대 전압이며 `inX_min_alarm`, `inX_max_alarm`은 각각 low 및 high alarm입니다. `inX_highest`는 과거 최대 전압이고 `inX_reset_history`에 아무 값이나 쓰면 이력을 초기화합니다.

전류 label `curr1_label`은 `iout1`입니다. `curr1_input`은 측정 전류, `curr1_max`는 최대 전류, `curr1_max_alarm`은 high alarm입니다.

Chip configuration에 따라 critical minimum인 `curr1_lcrit`과 critical maximum인 `curr1_crit` 중 하나만 지원하며 둘을 동시에 지원하지 않습니다. 각각 low 또는 high critical alarm인 `curr1_lcrit_alarm`, `curr1_crit_alarm`과 연결됩니다. `curr1_highest`는 과거 최대 전류이고 `curr1_reset_history`에 아무 값이나 쓰면 이력을 초기화합니다.

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

The following attributes are supported. Limits are read-write, history reset
attributes are write-only, all other attributes are read-only.

======================= =======================================================
inX_label                "vin1" or "vout1" depending on chip variant and
                        configuration. On ADM1075, ADM1293, and ADM1294,
                        vout1 reports the voltage on the VAUX pin.
inX_input                Measured voltage.
inX_min                        Minimum Voltage.
inX_max                        Maximum voltage.
inX_min_alarm                Voltage low alarm.
inX_max_alarm                Voltage high alarm.
inX_highest                Historical maximum voltage.
inX_reset_history        Write any value to reset history.

curr1_label                "iout1"
curr1_input                Measured current.
curr1_max                Maximum current.
curr1_max_alarm                Current high alarm.
curr1_lcrit                Critical minimum current. Depending on the chip
                        configuration, either curr1_lcrit or curr1_crit is
                        supported, but not both.
curr1_lcrit_alarm        Critical current low alarm.
curr1_crit                Critical maximum current. Depending on the chip
                        configuration, either curr1_lcrit or curr1_crit is
                        supported, but not both.
curr1_crit_alarm        Critical current high alarm.
curr1_highest                Historical maximum current.
curr1_reset_history        Write any value to reset history.

전력과 온도 sysfs

`power1_label`은 `pin1`, `power1_input`은 input power입니다. `power1_input_lowest`는 관찰된 최저 input power이며 ADM1293과 ADM1294에서만 지원합니다. `power1_input_highest`는 관찰된 최고 input power이고 `power1_reset_history`에 아무 값이나 쓰면 이력을 초기화합니다.

Power attribute 전체는 ADM1075, ADM1272, ADM1273, ADM1276, ADM1293 및 ADM1294에서 지원합니다.

`temp1_input`은 chip temperature, `temp1_max`는 최대 chip temperature, `temp1_max_alarm`은 temperature alarm입니다. `temp1_crit`은 critical chip temperature이고 `temp1_crit_alarm`은 critical high alarm입니다. `temp1_highest`는 관찰된 최고 온도이며 `temp1_reset_history`로 이력을 초기화합니다.

Temperature attribute는 ADM1272, ADM1273, ADM1278, ADM1281 및 SQ24905C에서 지원합니다.

power1_label                "pin1"
power1_input                Input power.
power1_input_lowest        Lowest observed input power. ADM1293 and ADM1294 only.
power1_input_highest        Highest observed input power.
power1_reset_history        Write any value to reset history.

                        Power attributes are supported on ADM1075, ADM1272,
                        ADM1273, ADM1276, ADM1293, and ADM1294.

temp1_input                Chip temperature.
temp1_max                Maximum chip temperature.
temp1_max_alarm                Temperature alarm.
temp1_crit                Critical chip temperature.
temp1_crit_alarm        Critical temperature high alarm.
temp1_highest                Highest observed temperature.
temp1_reset_history        Write any value to reset history.

                        Temperature attributes are supported on ADM1272,
                        ADM1273, ADM1278, ADM1281 and SQ24905C.
======================= =======================================================