adm1275.rst 4.4 KB

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