^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) Kernel driver adm1275
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2) =====================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 3)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4) Supported chips:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6) * Analog Devices ADM1075
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8) Prefix: 'adm1075'
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) Addresses scanned: -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12) Datasheet: www.analog.com/static/imported-files/data_sheets/ADM1075.pdf
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) * Analog Devices ADM1272
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) Prefix: 'adm1272'
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) Addresses scanned: -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) Datasheet: www.analog.com/static/imported-files/data_sheets/ADM1272.pdf
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) * Analog Devices ADM1275
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) Prefix: 'adm1275'
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) Addresses scanned: -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28) Datasheet: www.analog.com/static/imported-files/data_sheets/ADM1275.pdf
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30) * Analog Devices ADM1276
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) Prefix: 'adm1276'
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) Addresses scanned: -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) Datasheet: www.analog.com/static/imported-files/data_sheets/ADM1276.pdf
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) * Analog Devices ADM1278
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) Prefix: 'adm1278'
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) Addresses scanned: -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) Datasheet: www.analog.com/static/imported-files/data_sheets/ADM1278.pdf
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) * Analog Devices ADM1293/ADM1294
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) Prefix: 'adm1293', 'adm1294'
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50) Addresses scanned: -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52) Datasheet: https://www.analog.com/media/en/technical-documentation/data-sheets/ADM1293_1294.pdf
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54) Author: Guenter Roeck <linux@roeck-us.net>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57) Description
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58) -----------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60) This driver supports hardware monitoring for Analog Devices ADM1075, ADM1272,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61) ADM1275, ADM1276, ADM1278, ADM1293, and ADM1294 Hot-Swap Controller and
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 62) Digital Power Monitors.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 63)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 64) ADM1075, ADM1272, ADM1275, ADM1276, ADM1278, ADM1293, and ADM1294 are hot-swap
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 65) controllers that allow a circuit board to be removed from or inserted into
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 66) a live backplane. They also feature current and voltage readback via an
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 67) integrated 12 bit analog-to-digital converter (ADC), accessed using a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 68) PMBus interface.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 69)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 70) The driver is a client driver to the core PMBus driver. Please see
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 71) Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 72)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 73)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 74) Usage Notes
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 75) -----------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 76)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 77) This driver does not auto-detect devices. You will have to instantiate the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 78) devices explicitly. Please see Documentation/i2c/instantiating-devices.rst for
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 79) details.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 80)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 81) The ADM1075, unlike many other PMBus devices, does not support internal voltage
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 82) or current scaling. Reported voltages, currents, and power are raw measurements,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 83) and will typically have to be scaled.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 84)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 85) The shunt value in micro-ohms can be set via device tree at compile-time. Please
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 86) refer to the Documentation/devicetree/bindings/hwmon/adm1275.txt for bindings
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 87) if the device tree is used.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 88)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 89) Platform data support
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 90) ---------------------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 91)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 92) The driver supports standard PMBus driver platform data. Please see
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 93) Documentation/hwmon/pmbus.rst for details.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 94)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 95)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 96) Sysfs entries
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 97) -------------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 98)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 99) The following attributes are supported. Limits are read-write, history reset
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 100) attributes are write-only, all other attributes are read-only.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 101)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 102) ======================= =======================================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 103) inX_label "vin1" or "vout1" depending on chip variant and
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 104) configuration. On ADM1075, ADM1293, and ADM1294,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 105) vout1 reports the voltage on the VAUX pin.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 106) inX_input Measured voltage.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 107) inX_min Minimum Voltage.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 108) inX_max Maximum voltage.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 109) inX_min_alarm Voltage low alarm.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 110) inX_max_alarm Voltage high alarm.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 111) inX_highest Historical maximum voltage.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 112) inX_reset_history Write any value to reset history.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 113)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 114) curr1_label "iout1"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 115) curr1_input Measured current.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 116) curr1_max Maximum current.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 117) curr1_max_alarm Current high alarm.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 118) curr1_lcrit Critical minimum current. Depending on the chip
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 119) configuration, either curr1_lcrit or curr1_crit is
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 120) supported, but not both.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 121) curr1_lcrit_alarm Critical current low alarm.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 122) curr1_crit Critical maximum current. Depending on the chip
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 123) configuration, either curr1_lcrit or curr1_crit is
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 124) supported, but not both.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 125) curr1_crit_alarm Critical current high alarm.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 126) curr1_highest Historical maximum current.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 127) curr1_reset_history Write any value to reset history.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 128)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 129) power1_label "pin1"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 130) power1_input Input power.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 131) power1_input_lowest Lowest observed input power. ADM1293 and ADM1294 only.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 132) power1_input_highest Highest observed input power.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 133) power1_reset_history Write any value to reset history.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 134)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 135) Power attributes are supported on ADM1075, ADM1272,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 136) ADM1276, ADM1293, and ADM1294.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 137)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 138) temp1_input Chip temperature.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 139) temp1_max Maximum chip temperature.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 140) temp1_max_alarm Temperature alarm.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 141) temp1_crit Critical chip temperature.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 142) temp1_crit_alarm Critical temperature high alarm.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 143) temp1_highest Highest observed temperature.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 144) temp1_reset_history Write any value to reset history.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 145)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 146) Temperature attributes are supported on ADM1272 and
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 147) ADM1278.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 148) ======================= =======================================================
Orange Pi5 kernel
Deprecated Linux kernel 5.10.110 for OrangePi 5/5B/5+ boards
3 Commits
0 Branches
0 Tags