1 Kernel driver occ-hwmon
2 =======================
3
4 Supported chips:
5
6 * POWER8
7 * POWER9
8
9 Author: Eddie James <eajames@linux.ibm.com>
10
11 Description
12 -----------
13
14 This driver supports hardware monitoring for t
15 embedded on POWER processors. The OCC is a dev
16 sensor data from the processor and the system.
17 sensor data as well as perform thermal and pow
18
19 The P8 version of this driver is a client driv
20 manually if an "ibm,p8-occ-hwmon" compatible d
21 appropriate I2C bus node in the device-tree.
22
23 The P9 version of this driver is a client driv
24 It will be probed automatically by the FSI-bas
25
26 Sysfs entries
27 -------------
28
29 The following attributes are supported. All at
30 specified.
31
32 The OCC sensor ID is an integer that represent
33 sensor with respect to the OCC. For example, a
34 DIMM slot in the system may have a sensor ID o
35 to the device driver, which must therefore exp
36
37 Some entries are only present with certain OCC
38 certain OCCs in the system. The version number
39 but can be inferred.
40
41 temp[1-n]_label
42 OCC sensor ID.
43
44 [with temperature sensor version 1]
45
46 temp[1-n]_input
47 Measured temperature o
48 Celsius.
49
50 [with temperature sensor version >= 2]
51
52 temp[1-n]_type
53 The FRU (Field
54 (represented b
55 that this sens
56 temp[1-n]_fault
57 Temperature se
58 that a fault i
59 no fault is pr
60
61 [with type == 3 (FRU type is VRM)]
62
63 temp[1-n]_alarm
64 VRM temperatur
65 alarm, 0 to in
66
67 [else]
68
69 temp[1-n]_input
70 Measured tempe
71 millidegrees C
72
73 freq[1-n]_label
74 OCC sensor ID.
75 freq[1-n]_input
76 Measured frequency of
77 power[1-n]_input
78 Latest measured power
79 microwatts.
80 power[1-n]_average
81 Average power of the c
82 power[1-n]_average_interval
83 The amount of
84 was taken in m
85
86 [with power sensor version < 2]
87
88 power[1-n]_label
89 OCC sensor ID.
90
91 [with power sensor version >= 2]
92
93 power[1-n]_label
94 OCC sensor ID + functi
95 of a string, delimited
96 Both the function ID a
97 further identify the p
98
99 [with power sensor version 0xa0]
100
101 power[1-n]_label
102 OCC sensor ID + sensor
103 delimited by an unders
104 type will be one of "s
105 For this sensor versio
106 for all power sensors.
107
108 [present only on "master" OCC; represents the
109 this type of power sensor will be present]
110
111 power[1-n]_label
112 "system"
113 power[1-n]_input
114 Latest system
115 power[1-n]_cap
116 Current system
117 power[1-n]_cap_not_redundant
118 System power c
119 there is not r
120 power[1-n]_cap_max
121 Maximum power
122 microwatts.
123 power[1-n]_cap_min Minimum power
124 microwatts.
125 power[1-n]_cap_user The power cap
126 This attribute
127 cap has been s
128 but writing an
129 ignored, i.e.
130 500900000 micr
131 request of 500
132
133 [with caps sensor version > 1]
134
135 power[1-n]_cap_user_source
136 Indica
137 set. T
138 system
139 set th
140
141 The following "extn" sensors are exported as a
142 that doesn't fit anywhere else. The meaning of
143 dependent on their data, and cannot be statica
144
145 extn[1-n]_label
146 ASCII ID or OCC sensor
147 extn[1-n]_flags
148 This is one byte hexad
149 type of the label attr
150 ASCII ID. Other bits a
151 extn[1-n]_input
152 6 bytes of hexadecimal
153 the sensor ID.
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.