ibmpowernv 2.8 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980
  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. fanX_input Measured RPM value.
  24. fanX_min Threshold RPM for alert generation.
  25. fanX_fault 0: No fail condition
  26. 1: Failing fan
  27. tempX_input Measured ambient temperature.
  28. tempX_max Threshold ambient temperature for alert generation.
  29. tempX_highest Historical maximum temperature
  30. tempX_lowest Historical minimum temperature
  31. tempX_enable Enable/disable all temperature sensors belonging to the
  32. sub-group. In POWER9, this attribute corresponds to
  33. each OCC. Using this attribute each OCC can be asked to
  34. disable/enable all of its temperature sensors.
  35. 1: Enable
  36. 0: Disable
  37. inX_input Measured power supply voltage (millivolt)
  38. inX_fault 0: No fail condition.
  39. 1: Failing power supply.
  40. inX_highest Historical maximum voltage
  41. inX_lowest Historical minimum voltage
  42. inX_enable Enable/disable all voltage sensors belonging to the
  43. sub-group. In POWER9, this attribute corresponds to
  44. each OCC. Using this attribute each OCC can be asked to
  45. disable/enable all of its voltage sensors.
  46. 1: Enable
  47. 0: Disable
  48. powerX_input Power consumption (microWatt)
  49. powerX_input_highest Historical maximum power
  50. powerX_input_lowest Historical minimum power
  51. powerX_enable Enable/disable all power sensors belonging to the
  52. sub-group. In POWER9, this attribute corresponds to
  53. each OCC. Using this attribute each OCC can be asked to
  54. disable/enable all of its power sensors.
  55. 1: Enable
  56. 0: Disable
  57. currX_input Measured current (milliampere)
  58. currX_highest Historical maximum current
  59. currX_lowest Historical minimum current
  60. currX_enable Enable/disable all current sensors belonging to the
  61. sub-group. In POWER9, this attribute corresponds to
  62. each OCC. Using this attribute each OCC can be asked to
  63. disable/enable all of its current sensors.
  64. 1: Enable
  65. 0: Disable
  66. energyX_input Cumulative energy (microJoule)