cachepc-linux

Fork of AMDESE/linux with modifications for CachePC side-channel attack
git clone https://git.sinitax.com/sinitax/cachepc-linux
Log | Files | Refs | README | LICENSE | sfeed.txt

ibmpowernv.rst (3023B)

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