Kernel driver bel-pfe

BEL PFE1100·PFE3000 지원

이 driver는 BEL `PFE1100`을 prefix `pfe1100`, BEL `PFE3000`을 prefix `pfe3000`으로 지원합니다. 자동 검색 주소는 없으며 두 제품의 datasheet URL이 제공됩니다. 저자는 Tao Ren입니다.

PMBus protocol을 지원하는 power supply를 monitoring합니다. PFE1100은 1100 Watt AC-to-DC power-factor-corrected, 즉 PFC power supply입니다. PFE3000은 3000 Watt AC/DC PFC 및 DC-DC power supply입니다. 두 제품의 PMBus Communication Manual은 공개되지 않았습니다.

이 driver는 core PMBus driver의 client driver입니다. PMBus client driver의 자세한 내용은 `Documentation/hwmon/pmbus.rst`를 참고합니다.

Kernel driver bel-pfe
======================

Supported chips:

  * BEL PFE1100

    Prefixes: 'pfe1100'

    Addresses scanned: -

    Datasheet: https://www.belfuse.com/resources/datasheets/powersolutions/ds-bps-pfe1100-12-054xa.pdf

  * BEL PFE3000

    Prefixes: 'pfe3000'

    Addresses scanned: -

    Datasheet: https://www.belfuse.com/resources/datasheets/powersolutions/ds-bps-pfe3000-series.pdf

Author: Tao Ren <rentao.bupt@gmail.com>


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

This driver supports hardware monitoring for below power supply devices
which support PMBus Protocol:

  * BEL PFE1100

    1100 Watt AC to DC power-factor-corrected (PFC) power supply.
    PMBus Communication Manual is not publicly available.

  * BEL PFE3000

    3000 Watt AC/DC power-factor-corrected (PFC) and DC-DC power supply.
    PMBus Communication Manual is not publicly available.

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

명시적 장치 등록과 platform data

Driver는 장치를 auto-detect하지 않으므로 명시적으로 instantiate해야 합니다. 자세한 방법은 `Documentation/i2c/instantiating-devices.rst`를 참고합니다.

예를 들어 I2C bus 1의 주소 `0x20`에 PFE3000이 있으면 `$ modprobe bel-pfe`를 실행하고, `$ echo pfe3000 0x20 > /sys/bus/i2c/devices/i2c-1/new_device`로 장치를 생성합니다.

Driver는 standard PMBus driver platform data를 지원합니다.

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.

Example: the following will load the driver for an PFE3000 at address 0x20
on I2C bus #1::

        $ modprobe bel-pfe
        $ echo pfe3000 0x20 > /sys/bus/i2c/devices/i2c-1/new_device


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

The driver supports standard PMBus driver platform data.

BEL PFE sysfs와 모델별 항목

`curr1_label`은 `iin`, `curr1_input`은 measured input current, `curr1_max`와 `curr1_max_alarm`은 input current maximum과 alarm입니다. `curr[2-3]_label`은 `iout[1-2]`이며 각 output current의 input, maximum, maximum alarm을 제공합니다.

`fan[1-2]_input`은 fan 1·2 speed를 RPM으로 제공합니다. `fan1_target`은 두 fan 모두에 적용할 fan speed reference를 설정합니다.

`in1_label`은 `vin`입니다. `in1_input`, critical maximum과 alarm인 `in1_crit`·`in1_crit_alarm`, critical minimum과 alarm인 `in1_lcrit`·`in1_lcrit_alarm`, maximum과 alarm인 `in1_max`·`in1_max_alarm`을 제공합니다.

`in2_label`은 `vcap`이며 `in2_input`은 hold-up capacitor voltage입니다. `in[3-8]_label`은 `vout[1-3,5-7]`, `in[3-8]_input`은 measured output voltage입니다. `in[3-4]_alarm`은 vout1·vout2 output voltage 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-3]_input`은 measured temperature, `temp[1-3]_alarm`은 temperature alarm입니다. `curr3`, `fan2`, `vout[2-7]`, `vcap`, `pin2`, `pout2`, `temp3` attribute는 PFE3000에만 존재합니다.

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

======================= =======================================================
curr1_label                "iin"
curr1_input                Measured input current
curr1_max               Input current max value
curr1_max_alarm         Input current max alarm

curr[2-3]_label                "iout[1-2]"
curr[2-3]_input                Measured output current
curr[2-3]_max           Output current max value
curr[2-3]_max_alarm     Output current max alarm

fan[1-2]_input          Fan 1 and 2 speed in RPM
fan1_target             Set fan speed reference for both fans

in1_label                "vin"
in1_input                Measured input voltage
in1_crit                Input voltage critical max value
in1_crit_alarm                Input voltage critical max alarm
in1_lcrit               Input voltage critical min value
in1_lcrit_alarm         Input voltage critical min alarm
in1_max                 Input voltage max value
in1_max_alarm           Input voltage max alarm

in2_label               "vcap"
in2_input               Hold up capacitor voltage

in[3-8]_label                "vout[1-3,5-7]"
in[3-8]_input                Measured output voltage
in[3-4]_alarm           vout[1-2] output voltage 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-3]_input                Measured temperature
temp[1-3]_alarm         Temperature alarm
======================= =======================================================

.. note::

    - curr3, fan2, vout[2-7], vcap, pin2, pout2 and temp3 attributes only
      exist for PFE3000.