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