157 lines · plain
1Kernel driver adm12752=====================3 4Supported chips:5 6 * Analog Devices ADM10757 8 Prefix: 'adm1075'9 10 Addresses scanned: -11 12 Datasheet: www.analog.com/static/imported-files/data_sheets/ADM1075.pdf13 14 * Analog Devices ADM127215 16 Prefix: 'adm1272'17 18 Addresses scanned: -19 20 Datasheet: www.analog.com/static/imported-files/data_sheets/ADM1272.pdf21 22 * Analog Devices ADM127523 24 Prefix: 'adm1275'25 26 Addresses scanned: -27 28 Datasheet: www.analog.com/static/imported-files/data_sheets/ADM1275.pdf29 30 * Analog Devices ADM127631 32 Prefix: 'adm1276'33 34 Addresses scanned: -35 36 Datasheet: www.analog.com/static/imported-files/data_sheets/ADM1276.pdf37 38 * Analog Devices ADM127839 40 Prefix: 'adm1278'41 42 Addresses scanned: -43 44 Datasheet: www.analog.com/static/imported-files/data_sheets/ADM1278.pdf45 46 * Analog Devices ADM128147 48 Prefix: 'adm1281'49 50 Addresses scanned: -51 52 Datasheet: https://www.analog.com/media/en/technical-documentation/data-sheets/adm1281.pdf53 54 * Analog Devices ADM1293/ADM129455 56 Prefix: 'adm1293', 'adm1294'57 58 Addresses scanned: -59 60 Datasheet: https://www.analog.com/media/en/technical-documentation/data-sheets/ADM1293_1294.pdf61 62Author: Guenter Roeck <linux@roeck-us.net>63 64 65Description66-----------67 68This driver supports hardware monitoring for Analog Devices ADM1075, ADM1272,69ADM1275, ADM1276, ADM1278, ADM1281, ADM1293, and ADM1294 Hot-Swap Controller and70Digital Power Monitors.71 72ADM1075, ADM1272, ADM1275, ADM1276, ADM1278, ADM1281, ADM1293, and ADM1294 are hot-swap73controllers that allow a circuit board to be removed from or inserted into74a live backplane. They also feature current and voltage readback via an75integrated 12 bit analog-to-digital converter (ADC), accessed using a76PMBus interface.77 78The driver is a client driver to the core PMBus driver. Please see79Documentation/hwmon/pmbus.rst for details on PMBus client drivers.80 81 82Usage Notes83-----------84 85This driver does not auto-detect devices. You will have to instantiate the86devices explicitly. Please see Documentation/i2c/instantiating-devices.rst for87details.88 89The ADM1075, unlike many other PMBus devices, does not support internal voltage90or current scaling. Reported voltages, currents, and power are raw measurements,91and will typically have to be scaled.92 93The shunt value in micro-ohms can be set via device tree at compile-time. Please94refer to the Documentation/devicetree/bindings/hwmon/adi,adm1275.yaml for bindings95if the device tree is used.96 97Platform data support98---------------------99 100The driver supports standard PMBus driver platform data. Please see101Documentation/hwmon/pmbus.rst for details.102 103 104Sysfs entries105-------------106 107The following attributes are supported. Limits are read-write, history reset108attributes are write-only, all other attributes are read-only.109 110======================= =======================================================111inX_label "vin1" or "vout1" depending on chip variant and112 configuration. On ADM1075, ADM1293, and ADM1294,113 vout1 reports the voltage on the VAUX pin.114inX_input Measured voltage.115inX_min Minimum Voltage.116inX_max Maximum voltage.117inX_min_alarm Voltage low alarm.118inX_max_alarm Voltage high alarm.119inX_highest Historical maximum voltage.120inX_reset_history Write any value to reset history.121 122curr1_label "iout1"123curr1_input Measured current.124curr1_max Maximum current.125curr1_max_alarm Current high alarm.126curr1_lcrit Critical minimum current. Depending on the chip127 configuration, either curr1_lcrit or curr1_crit is128 supported, but not both.129curr1_lcrit_alarm Critical current low alarm.130curr1_crit Critical maximum current. Depending on the chip131 configuration, either curr1_lcrit or curr1_crit is132 supported, but not both.133curr1_crit_alarm Critical current high alarm.134curr1_highest Historical maximum current.135curr1_reset_history Write any value to reset history.136 137power1_label "pin1"138power1_input Input power.139power1_input_lowest Lowest observed input power. ADM1293 and ADM1294 only.140power1_input_highest Highest observed input power.141power1_reset_history Write any value to reset history.142 143 Power attributes are supported on ADM1075, ADM1272,144 ADM1276, ADM1293, and ADM1294.145 146temp1_input Chip temperature.147temp1_max Maximum chip temperature.148temp1_max_alarm Temperature alarm.149temp1_crit Critical chip temperature.150temp1_crit_alarm Critical temperature high alarm.151temp1_highest Highest observed temperature.152temp1_reset_history Write any value to reset history.153 154 Temperature attributes are supported on ADM1272 and155 ADM1278, and ADM1281.156======================= =======================================================157