Quelle  adm1275.rst   Sprache: unbekannt

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: -

    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

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


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

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

ADM1075, ADM1272, ADM1273, ADM1275, ADM1276, ADM1278, ADM1281, ADM1293, and
ADM1294 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 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.

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, and ADM1281.
======================= =======================================================