![Shilpasri G Bhat](/assets/img/avatar_default.png)
OPAL firmware provides the facility for some groups of sensors to be enabled/disabled at runtime to give the user the option of using the system resources for collecting these sensors or not. For example, on POWER9 systems, the On Chip Controller (OCC) gathers various system and chip level sensors and maintains their values in main memory. This patch provides support for enabling/disabling the sensor groups like power, temperature, current and voltage. Signed-off-by: Shilpasri G Bhat <shilpa.bhat@linux.vnet.ibm.com> [stewart@linux.vnet.ibm.com: Commit message] Acked-by: Guenter Roeck <linux@roeck-us.net> Signed-off-by: Michael Ellerman <mpe@ellerman.id.au>
81 lines
2.8 KiB
Plaintext
81 lines
2.8 KiB
Plaintext
Kernel Driver IBMPOWERNV
|
|
========================
|
|
|
|
Supported systems:
|
|
* Any recent IBM P servers based on POWERNV platform
|
|
|
|
Author: Neelesh Gupta
|
|
|
|
Description
|
|
-----------
|
|
|
|
This driver implements reading the platform sensors data like temperature/fan/
|
|
voltage/power for 'POWERNV' platform.
|
|
|
|
The driver uses the platform device infrastructure. It probes the device tree
|
|
for sensor devices during the __init phase and registers them with the 'hwmon'.
|
|
'hwmon' populates the 'sysfs' tree having attribute files, each for a given
|
|
sensor type and its attribute data.
|
|
|
|
All the nodes in the DT appear under "/ibm,opal/sensors" and each valid node in
|
|
the DT maps to an attribute file in 'sysfs'. The node exports unique 'sensor-id'
|
|
which the driver uses to make an OPAL call to the firmware.
|
|
|
|
Usage notes
|
|
-----------
|
|
The driver is built statically with the kernel by enabling the config
|
|
CONFIG_SENSORS_IBMPOWERNV. It can also be built as module 'ibmpowernv'.
|
|
|
|
Sysfs attributes
|
|
----------------
|
|
|
|
fanX_input Measured RPM value.
|
|
fanX_min Threshold RPM for alert generation.
|
|
fanX_fault 0: No fail condition
|
|
1: Failing fan
|
|
|
|
tempX_input Measured ambient temperature.
|
|
tempX_max Threshold ambient temperature for alert generation.
|
|
tempX_highest Historical maximum temperature
|
|
tempX_lowest Historical minimum temperature
|
|
tempX_enable Enable/disable all temperature sensors belonging to the
|
|
sub-group. In POWER9, this attribute corresponds to
|
|
each OCC. Using this attribute each OCC can be asked to
|
|
disable/enable all of its temperature sensors.
|
|
1: Enable
|
|
0: Disable
|
|
|
|
inX_input Measured power supply voltage (millivolt)
|
|
inX_fault 0: No fail condition.
|
|
1: Failing power supply.
|
|
inX_highest Historical maximum voltage
|
|
inX_lowest Historical minimum voltage
|
|
inX_enable Enable/disable all voltage sensors belonging to the
|
|
sub-group. In POWER9, this attribute corresponds to
|
|
each OCC. Using this attribute each OCC can be asked to
|
|
disable/enable all of its voltage sensors.
|
|
1: Enable
|
|
0: Disable
|
|
|
|
powerX_input Power consumption (microWatt)
|
|
powerX_input_highest Historical maximum power
|
|
powerX_input_lowest Historical minimum power
|
|
powerX_enable Enable/disable all power sensors belonging to the
|
|
sub-group. In POWER9, this attribute corresponds to
|
|
each OCC. Using this attribute each OCC can be asked to
|
|
disable/enable all of its power sensors.
|
|
1: Enable
|
|
0: Disable
|
|
|
|
currX_input Measured current (milliampere)
|
|
currX_highest Historical maximum current
|
|
currX_lowest Historical minimum current
|
|
currX_enable Enable/disable all current sensors belonging to the
|
|
sub-group. In POWER9, this attribute corresponds to
|
|
each OCC. Using this attribute each OCC can be asked to
|
|
disable/enable all of its current sensors.
|
|
1: Enable
|
|
0: Disable
|
|
|
|
energyX_input Cumulative energy (microJoule)
|