ltc4286.rst 2.6 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495
  1. .. SPDX-License-Identifier: GPL-2.0-or-later
  2. Kernel driver ltc4286
  3. =====================
  4. Supported chips:
  5. * Analog Devices LTC4286
  6. Prefix: 'ltc4286'
  7. Addresses scanned: -
  8. Datasheet: https://www.analog.com/media/en/technical-documentation/data-sheets/ltc4286.pdf
  9. * Analog Devices LTC4287
  10. Prefix: 'ltc4287'
  11. Addresses scanned: -
  12. Datasheet: https://www.analog.com/media/en/technical-documentation/data-sheets/ltc4287.pdf
  13. Author: Delphine CC Chiu <Delphine_CC_Chiu@Wiwynn.com>
  14. Description
  15. -----------
  16. This driver supports hardware monitoring for Analog Devices LTC4286
  17. and LTC4287 Hot-Swap Controller and Digital Power Monitors.
  18. LTC4286 and LTC4287 are hot-swap controllers that allow a circuit board
  19. to be removed from or inserted into a live backplane. They also feature
  20. current and voltage readback via an integrated 12 bit analog-to-digital
  21. converter (ADC), accessed using a PMBus interface.
  22. The driver is a client driver to the core PMBus driver. Please see
  23. Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
  24. Usage Notes
  25. -----------
  26. This driver does not auto-detect devices. You will have to instantiate the
  27. devices explicitly. Please see Documentation/i2c/instantiating-devices.rst for
  28. details.
  29. The shunt value in micro-ohms can be set via device tree at compile-time. Please
  30. refer to the Documentation/devicetree/bindings/hwmon/lltc,ltc4286.yaml for bindings
  31. if the device tree is used.
  32. Platform data support
  33. ---------------------
  34. The driver supports standard PMBus driver platform data. Please see
  35. Documentation/hwmon/pmbus.rst for details.
  36. Sysfs entries
  37. -------------
  38. The following attributes are supported. Limits are read-write, history reset
  39. attributes are write-only, all other attributes are read-only.
  40. ======================= =======================================================
  41. in1_label "vin"
  42. in1_input Measured voltage.
  43. in1_alarm Input voltage alarm.
  44. in1_min Minimum input voltage.
  45. in1_max Maximum input voltage.
  46. in2_label "vout1"
  47. in2_input Measured voltage.
  48. in2_alarm Output voltage alarm.
  49. in2_min Minimum output voltage.
  50. in2_max Maximum output voltage.
  51. curr1_label "iout1"
  52. curr1_input Measured current.
  53. curr1_alarm Output current alarm.
  54. curr1_max Maximum current.
  55. power1_label "pin"
  56. power1_input Input power.
  57. power1_alarm Input power alarm.
  58. power1_max Maximum poewr.
  59. temp1_input Chip temperature.
  60. temp1_min Minimum chip temperature.
  61. temp1_max Maximum chip temperature.
  62. temp1_crit Critical chip temperature.
  63. temp1_alarm Chip temperature alarm.
  64. ======================= =======================================================