hc
2024-12-19 9370bb92b2d16684ee45cf24e879c93c509162da
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
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)
======================= =======================================================