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