Kernel driver ltc4286

LTC4286/LTC4287 PMBus 디지털 전력 모니터

GPL-2.0-or-later 문서의 드라이버는 Analog Devices LTC4286과 LTC4287을 각각 `ltc4286`, `ltc4287` 접두사로 지원합니다. 주소 자동 탐색은 없고 저자는 Delphine CC Chiu입니다.

두 칩은 라이브 백플레인에서 회로 보드를 삽입·제거하는 Hot-Swap 컨트롤러이자 디지털 전력 모니터입니다. 내장 12비트 ADC가 전류와 전압을 읽고 PMBus 인터페이스로 접근합니다.

드라이버는 PMBus 코어의 클라이언트이며 자세한 내용은 `Documentation/hwmon/pmbus.rst`를 따릅니다. 장치는 `Documentation/i2c/instantiating-devices.rst` 방식으로 명시적으로 생성해야 합니다.

분로 저항값은 마이크로옴 단위로 장치 트리에서 컴파일 시 설정할 수 있으며 바인딩은 `Documentation/devicetree/bindings/hwmon/lltc,ltc4286.yaml`입니다. 표준 PMBus 플랫폼 데이터도 지원합니다.

.. SPDX-License-Identifier: GPL-2.0-or-later

Kernel driver ltc4286
=====================

Supported chips:

  * Analog Devices LTC4286

    Prefix: 'ltc4286'

    Addresses scanned: -

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

  * Analog Devices LTC4287

    Prefix: 'ltc4287'

    Addresses scanned: -

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

Author: Delphine CC Chiu <Delphine_CC_Chiu@Wiwynn.com>


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

This driver supports hardware monitoring for Analog Devices LTC4286
and LTC4287 Hot-Swap Controller and Digital Power Monitors.

LTC4286 and LTC4287 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 shunt value in micro-ohms can be set via device tree at compile-time. Please
refer to the Documentation/devicetree/bindings/hwmon/lltc,ltc4286.yaml for bindings
if the device tree is used.


Platform data support

입력·출력·전력·온도 한계와 알람

한계는 읽고 쓸 수 있고 이력 reset 속성은 쓰기 전용이며 나머지는 읽기 전용입니다. `in1`은 `vin`, `in2`는 `vout1`로 각각 측정 전압, 알람, 최소·최대 한계를 제공합니다.

`curr1`은 `iout1` 출력 전류의 현재값, 알람, 최대 한계입니다. `power1`은 `pin` 입력 전력의 현재값, 알람, 최대 한계입니다. 원문의 `Maximum poewr` 오탈자는 영어 원문에 그대로 보존하고 한국어에서는 최대 전력으로 옮깁니다.

`temp1`은 칩 온도로 현재값, 최소·최대·임계 온도, 온도 알람을 제공합니다.

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

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


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

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

======================= =======================================================
in1_label                "vin"
in1_input                Measured voltage.
in1_alarm                Input voltage alarm.
in1_min                 Minimum input voltage.
in1_max                 Maximum input voltage.

in2_label                "vout1"
in2_input                Measured voltage.
in2_alarm                Output voltage alarm.
in2_min                 Minimum output voltage.
in2_max                 Maximum output voltage.

curr1_label                "iout1"
curr1_input                Measured current.
curr1_alarm                Output current alarm.
curr1_max                Maximum current.

power1_label                "pin"
power1_input                Input power.
power1_alarm                Input power alarm.
power1_max                Maximum poewr.

temp1_input                Chip temperature.
temp1_min                Minimum chip temperature.
temp1_max                Maximum chip temperature.
temp1_crit                Critical chip temperature.
temp1_alarm                Chip temperature alarm.
======================= =======================================================