Kernel driver pim4328

지원 Flex 전력 인터페이스 모듈

GPL-2.0 `pim4328` 드라이버는 Flex PIM4328과 호환 디지털 전력 인터페이스 모듈을 지원하며 Erik Rosen이 작성했습니다.

PIM4328은 `pim4328` 또는 `bmr455` 접두사를 사용합니다. PIM4820은 `pim4820`, PIM4006·PIM4106·PIM4206·PIM4306·PIM4406은 각각 대응하는 `pim4x06` 접두사를 사용합니다. 어느 모델도 주소를 자동 검색하지 않습니다.

각 제품군의 데이터시트 링크가 원문에 제공됩니다. 드라이버는 PMBus 코어의 클라이언트이며 PMBus 클라이언트 드라이버의 일반 구조는 `Documentation/hwmon/pmbus.rst`와 `Documentation/hwmon/pmbus-core.rst`에서 설명합니다.

.. SPDX-License-Identifier: GPL-2.0

Kernel driver pim4328
=====================

Supported chips:

  * Flex PIM4328

    Prefix: 'pim4328', 'bmr455'

    Addresses scanned: -

    Datasheet:

https://flexpowermodules.com/resources/fpm-techspec-pim4328

  * Flex PIM4820

    Prefixes: 'pim4820'

    Addresses scanned: -

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

  * Flex PIM4006, PIM4106, PIM4206, PIM4306, PIM4406

    Prefixes: 'pim4006', 'pim4106', 'pim4206', 'pim4306', 'pim4406'

    Addresses scanned: -

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

Author: Erik Rosen <erik.rosen@metormote.com>


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

This driver supports hardware monitoring for Flex PIM4328 and
compatible digital power interface modules.

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.

명시적 생성과 플랫폼 데이터

이 드라이버는 장치를 자동 감지하지 않습니다. 실제 버스와 주소를 알고 있어야 하며, `Documentation/i2c/instantiating-devices.rst`의 방법에 따라 장치를 명시적으로 생성해야 합니다.

표준 PMBus 드라이버 플랫폼 데이터를 지원하므로 보드별 플래그와 레귤레이터 초기화 정보를 PMBus 코어에 전달할 수 있습니다.

아래 sysfs 속성은 모두 읽기 전용입니다.

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.


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

The driver supports standard PMBus driver platform data.


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

The following attributes are supported. All attributes are read-only.

입력·출력 전압과 전류·온도

`in1_label`은 `vin`, `in1_input`은 측정 입력 전압, `in1_alarm`은 입력 전압 경보를 제공합니다.

PIM4328과 PIM4X06에서 `in2_label`은 `vin.0`이고 입력 A 전압을, `in3_label`은 `vin.1`이고 입력 B 전압을 제공합니다. PIM4328의 `in4_label`은 `vcap`이며 홀드업 커패시터 전압을 측정합니다.

PIM4X06에서 `curr1_label`은 `iin.0`이고 입력 A 전류를, `curr2_label`은 `iin.1`이고 입력 B 전류를 측정합니다.

출력 전류 라벨은 `iout1`입니다. `currX_input`은 측정 출력 전류, `currX_alarm`은 출력 전류 경보입니다. X는 PIM4820에서 1이고 다른 모델에서는 3입니다.

`temp1_input`은 측정 온도, `temp1_alarm`은 고온 경보를 제공합니다.

======================= ========================================================
in1_label                "vin"
in1_input                Measured input voltage.
in1_alarm                Input voltage alarm.

in2_label                "vin.0"
in2_input                Measured input voltage on input A.

                        PIM4328 and PIM4X06

in3_label                "vin.1"
in3_input                Measured input voltage on input B.

                        PIM4328 and PIM4X06

in4_label                "vcap"
in4_input                Measured voltage on holdup capacitor.

                        PIM4328

curr1_label                "iin.0"
curr1_input                Measured input current on input A.

                        PIM4X06

curr2_label                "iin.1"
curr2_input                Measured input current on input B.

                        PIM4X06

currX_label                "iout1"
currX_input                Measured output current.
currX_alarm                Output current alarm.

                        X is 1 for PIM4820, 3 otherwise.

temp1_input                Measured temperature.
temp1_alarm                High temperature alarm.
======================= ========================================================