ibmpowernv.rst 3.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687
  1. Kernel Driver IBMPOWERNV
  2. ========================
  3. Supported systems:
  4. * Any recent IBM P servers based on POWERNV platform
  5. Author: Neelesh Gupta
  6. Description
  7. -----------
  8. This driver implements reading the platform sensors data like temperature/fan/
  9. voltage/power for 'POWERNV' platform.
  10. The driver uses the platform device infrastructure. It probes the device tree
  11. for sensor devices during the __init phase and registers them with the 'hwmon'.
  12. 'hwmon' populates the 'sysfs' tree having attribute files, each for a given
  13. sensor type and its attribute data.
  14. All the nodes in the DT appear under "/ibm,opal/sensors" and each valid node in
  15. the DT maps to an attribute file in 'sysfs'. The node exports unique 'sensor-id'
  16. which the driver uses to make an OPAL call to the firmware.
  17. Usage notes
  18. -----------
  19. The driver is built statically with the kernel by enabling the config
  20. CONFIG_SENSORS_IBMPOWERNV. It can also be built as module 'ibmpowernv'.
  21. Sysfs attributes
  22. ----------------
  23. ======================= =======================================================
  24. fanX_input Measured RPM value.
  25. fanX_min Threshold RPM for alert generation.
  26. fanX_fault - 0: No fail condition
  27. - 1: Failing fan
  28. tempX_input Measured ambient temperature.
  29. tempX_max Threshold ambient temperature for alert generation.
  30. tempX_highest Historical maximum temperature
  31. tempX_lowest Historical minimum temperature
  32. tempX_enable Enable/disable all temperature sensors belonging to the
  33. sub-group. In POWER9, this attribute corresponds to
  34. each OCC. Using this attribute each OCC can be asked to
  35. disable/enable all of its temperature sensors.
  36. - 1: Enable
  37. - 0: Disable
  38. inX_input Measured power supply voltage (millivolt)
  39. inX_fault - 0: No fail condition.
  40. - 1: Failing power supply.
  41. inX_highest Historical maximum voltage
  42. inX_lowest Historical minimum voltage
  43. inX_enable Enable/disable all voltage sensors belonging to the
  44. sub-group. In POWER9, this attribute corresponds to
  45. each OCC. Using this attribute each OCC can be asked to
  46. disable/enable all of its voltage sensors.
  47. - 1: Enable
  48. - 0: Disable
  49. powerX_input Power consumption (microWatt)
  50. powerX_input_highest Historical maximum power
  51. powerX_input_lowest Historical minimum power
  52. powerX_enable Enable/disable all power sensors belonging to the
  53. sub-group. In POWER9, this attribute corresponds to
  54. each OCC. Using this attribute each OCC can be asked to
  55. disable/enable all of its power sensors.
  56. - 1: Enable
  57. - 0: Disable
  58. currX_input Measured current (milliampere)
  59. currX_highest Historical maximum current
  60. currX_lowest Historical minimum current
  61. currX_enable Enable/disable all current sensors belonging to the
  62. sub-group. In POWER9, this attribute corresponds to
  63. each OCC. Using this attribute each OCC can be asked to
  64. disable/enable all of its current sensors.
  65. - 1: Enable
  66. - 0: Disable
  67. energyX_input Cumulative energy (microJoule)
  68. ======================= =======================================================