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)
 |