0001 Kernel driver adm1275
0002 =====================
0003
0004 Supported chips:
0005
0006 * Analog Devices ADM1075
0007
0008 Prefix: 'adm1075'
0009
0010 Addresses scanned: -
0011
0012 Datasheet: www.analog.com/static/imported-files/data_sheets/ADM1075.pdf
0013
0014 * Analog Devices ADM1272
0015
0016 Prefix: 'adm1272'
0017
0018 Addresses scanned: -
0019
0020 Datasheet: www.analog.com/static/imported-files/data_sheets/ADM1272.pdf
0021
0022 * Analog Devices ADM1275
0023
0024 Prefix: 'adm1275'
0025
0026 Addresses scanned: -
0027
0028 Datasheet: www.analog.com/static/imported-files/data_sheets/ADM1275.pdf
0029
0030 * Analog Devices ADM1276
0031
0032 Prefix: 'adm1276'
0033
0034 Addresses scanned: -
0035
0036 Datasheet: www.analog.com/static/imported-files/data_sheets/ADM1276.pdf
0037
0038 * Analog Devices ADM1278
0039
0040 Prefix: 'adm1278'
0041
0042 Addresses scanned: -
0043
0044 Datasheet: www.analog.com/static/imported-files/data_sheets/ADM1278.pdf
0045
0046 * Analog Devices ADM1293/ADM1294
0047
0048 Prefix: 'adm1293', 'adm1294'
0049
0050 Addresses scanned: -
0051
0052 Datasheet: https://www.analog.com/media/en/technical-documentation/data-sheets/ADM1293_1294.pdf
0053
0054 Author: Guenter Roeck <linux@roeck-us.net>
0055
0056
0057 Description
0058 -----------
0059
0060 This driver supports hardware monitoring for Analog Devices ADM1075, ADM1272,
0061 ADM1275, ADM1276, ADM1278, ADM1293, and ADM1294 Hot-Swap Controller and
0062 Digital Power Monitors.
0063
0064 ADM1075, ADM1272, ADM1275, ADM1276, ADM1278, ADM1293, and ADM1294 are hot-swap
0065 controllers that allow a circuit board to be removed from or inserted into
0066 a live backplane. They also feature current and voltage readback via an
0067 integrated 12 bit analog-to-digital converter (ADC), accessed using a
0068 PMBus interface.
0069
0070 The driver is a client driver to the core PMBus driver. Please see
0071 Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
0072
0073
0074 Usage Notes
0075 -----------
0076
0077 This driver does not auto-detect devices. You will have to instantiate the
0078 devices explicitly. Please see Documentation/i2c/instantiating-devices.rst for
0079 details.
0080
0081 The ADM1075, unlike many other PMBus devices, does not support internal voltage
0082 or current scaling. Reported voltages, currents, and power are raw measurements,
0083 and will typically have to be scaled.
0084
0085 The shunt value in micro-ohms can be set via device tree at compile-time. Please
0086 refer to the Documentation/devicetree/bindings/hwmon/adi,adm1275.yaml for bindings
0087 if the device tree is used.
0088
0089 Platform data support
0090 ---------------------
0091
0092 The driver supports standard PMBus driver platform data. Please see
0093 Documentation/hwmon/pmbus.rst for details.
0094
0095
0096 Sysfs entries
0097 -------------
0098
0099 The following attributes are supported. Limits are read-write, history reset
0100 attributes are write-only, all other attributes are read-only.
0101
0102 ======================= =======================================================
0103 inX_label "vin1" or "vout1" depending on chip variant and
0104 configuration. On ADM1075, ADM1293, and ADM1294,
0105 vout1 reports the voltage on the VAUX pin.
0106 inX_input Measured voltage.
0107 inX_min Minimum Voltage.
0108 inX_max Maximum voltage.
0109 inX_min_alarm Voltage low alarm.
0110 inX_max_alarm Voltage high alarm.
0111 inX_highest Historical maximum voltage.
0112 inX_reset_history Write any value to reset history.
0113
0114 curr1_label "iout1"
0115 curr1_input Measured current.
0116 curr1_max Maximum current.
0117 curr1_max_alarm Current high alarm.
0118 curr1_lcrit Critical minimum current. Depending on the chip
0119 configuration, either curr1_lcrit or curr1_crit is
0120 supported, but not both.
0121 curr1_lcrit_alarm Critical current low alarm.
0122 curr1_crit Critical maximum current. Depending on the chip
0123 configuration, either curr1_lcrit or curr1_crit is
0124 supported, but not both.
0125 curr1_crit_alarm Critical current high alarm.
0126 curr1_highest Historical maximum current.
0127 curr1_reset_history Write any value to reset history.
0128
0129 power1_label "pin1"
0130 power1_input Input power.
0131 power1_input_lowest Lowest observed input power. ADM1293 and ADM1294 only.
0132 power1_input_highest Highest observed input power.
0133 power1_reset_history Write any value to reset history.
0134
0135 Power attributes are supported on ADM1075, ADM1272,
0136 ADM1276, ADM1293, and ADM1294.
0137
0138 temp1_input Chip temperature.
0139 temp1_max Maximum chip temperature.
0140 temp1_max_alarm Temperature alarm.
0141 temp1_crit Critical chip temperature.
0142 temp1_crit_alarm Critical temperature high alarm.
0143 temp1_highest Highest observed temperature.
0144 temp1_reset_history Write any value to reset history.
0145
0146 Temperature attributes are supported on ADM1272 and
0147 ADM1278.
0148 ======================= =======================================================
