adp1050.rst

  1.. SPDX-License-Identifier: GPL-2.0
  2
  3Kernel driver adp1050
  4=====================
  5
  6Supported chips:
  7
  8  * Analog Devices ADP1050
  9
 10    Prefix: 'adp1050'
 11
 12    Addresses scanned: I2C 0x70 - 0x77
 13
 14    Datasheet: https://www.analog.com/media/en/technical-documentation/data-sheets/ADP1050.pdf
 15
 16  * Analog Devices ADP1051
 17
 18    Prefix: 'adp1051'
 19
 20    Addresses scanned: I2C 0x70 - 0x77
 21
 22    Datasheet: https://www.analog.com/media/en/technical-documentation/data-sheets/ADP1051.pdf
 23
 24  * Analog Devices ADP1055
 25
 26    Prefix: 'adp1055'
 27
 28    Addresses scanned: I2C 0x4B - 0x77
 29
 30    Datasheet: https://www.analog.com/media/en/technical-documentation/data-sheets/ADP1055.pdf
 31
 32  * Analog Devices LTP8800-1A/-2/-4A
 33
 34    Prefix: 'ltp8800'
 35
 36    Addresses scanned: -
 37
 38    Datasheet: https://www.analog.com/media/en/technical-documentation/data-sheets/LTP8800-1A.pdf
 39         https://www.analog.com/media/en/technical-documentation/data-sheets/LTP8800-2.pdf
 40         https://www.analog.com/media/en/technical-documentation/data-sheets/LTP8800-4A.pdf
 41
 42Authors:
 43
 44  - Radu Sabau <radu.sabau@analog.com>
 45
 46
 47Description
 48-----------
 49
 50This driver supports hardware monitoring for Analog Devices ADP1050, ADP1051,
 51and ADP1055 Digital Controller for Isolated Power Supply with PMBus interface,
 52and the LTP8800 step-down μModule regulators.
 53
 54The ADP1050, ADP1051, and ADP1055 are advanced digital controllers with PMBus™
 55interface targeting high density, high efficiency dc-to-dc power
 56conversion used to monitor system temperatures, voltages and currents. The
 57LTP8800 is a family of step-down μModule regulators that provides microprocessor
 58core voltage from 54V power distribution architecture. Through the PMBus
 59interface, the device can monitor input/output voltages, input current and
 60temperature.
 61
 62Usage Notes
 63-----------
 64
 65This driver does not auto-detect devices. You will have to instantiate
 66the devices explicitly.
 67Please see Documentation/i2c/instantiating-devices.rst for details.
 68
 69Platform data support
 70---------------------
 71
 72The driver supports standard PMBus driver platform data.
 73
 74Sysfs Attributes
 75----------------
 76
 77================= ========================================
 78in1_label         "vin"
 79in1_input         Measured input voltage
 80in1_alarm	  Input voltage alarm
 81in1_crit          Critical maximum input voltage
 82in1_crit_alarm    Input voltage high alarm
 83in1_lcrit         Critical minimum input voltage
 84in1_lcrit_alarm   Input voltage critical low alarm
 85in2_label	  "vout1"
 86in2_input	  Measured output voltage
 87in2_crit	  Critical maximum output voltage
 88in2_crit_alarm    Output voltage high alarm
 89in2_lcrit	  Critical minimum output voltage
 90in2_lcrit_alarm	  Output voltage critical low alarm
 91in2_max           Critical maximum output voltage
 92in2_max_alarm     Output voltage critical max alarm
 93in2_min           Critical minimum output voltage
 94in2_min_alarm     Output voltage critical min alarm
 95curr1_label	  "iin"
 96curr1_input	  Measured input current.
 97curr1_alarm	  Input current alarm
 98curr1_crit        Critical maximum input current
 99curr1_crit_alarm  Input current high alarm
100curr2_label       "iout1"
101curr2_input       Measured output current
102curr2_alarm	  Output current alarm
103curr2_crit        Critical maximum output current
104curr2_crit_alarm  Output current high alarm
105curr2_lcrit       Critical minimum output current
106curr2_lcrit_alarm Output current critical low alarm
107curr2_max         Critical maximum output current
108curr2_max_alarm   Output current critical max alarm
109power1_label      "pout1"
110power1_input      Measured output power
111power1_crit       Critical maximum output power
112power1_crit_alarm Output power high alarm
113temp1_input       Measured temperature
114temp1_crit	  Critical high temperature
115temp1_crit_alarm  Chip temperature critical high alarm
116temp1_max         Critical maximum temperature
117temp1_max_alarm   Temperature critical max alarm
118temp2_input       Measured temperature
119temp2_crit        Critical high temperature
120temp2_crit_alarm  Chip temperature critical high alarm
121temp2_max         Critical maximum temperature
122temp2_max_alarm   Temperature critical max alarm
123================= ========================================