1 What: /sys/bus/platform/devices/dfl- 1 What: /sys/bus/platform/devices/dfl-fme.0/ports_num
2 Date: June 2018 2 Date: June 2018
3 KernelVersion: 4.19 3 KernelVersion: 4.19
4 Contact: Wu Hao <hao.wu@intel.com> 4 Contact: Wu Hao <hao.wu@intel.com>
5 Description: Read-only. One DFL FPGA device 5 Description: Read-only. One DFL FPGA device may have more than 1
6 port/Accelerator Function Unit 6 port/Accelerator Function Unit (AFU). It returns the
7 number of ports on the FPGA de 7 number of ports on the FPGA device when read it.
8 8
9 What: /sys/bus/platform/devices/dfl- 9 What: /sys/bus/platform/devices/dfl-fme.0/bitstream_id
10 Date: June 2018 10 Date: June 2018
11 KernelVersion: 4.19 11 KernelVersion: 4.19
12 Contact: Wu Hao <hao.wu@intel.com> 12 Contact: Wu Hao <hao.wu@intel.com>
13 Description: Read-only. It returns Bitstrea 13 Description: Read-only. It returns Bitstream (static FPGA region)
14 identifier number, which inclu 14 identifier number, which includes the detailed version
15 and other information of this 15 and other information of this static FPGA region.
16 16
17 What: /sys/bus/platform/devices/dfl- 17 What: /sys/bus/platform/devices/dfl-fme.0/bitstream_metadata
18 Date: June 2018 18 Date: June 2018
19 KernelVersion: 4.19 19 KernelVersion: 4.19
20 Contact: Wu Hao <hao.wu@intel.com> 20 Contact: Wu Hao <hao.wu@intel.com>
21 Description: Read-only. It returns Bitstrea 21 Description: Read-only. It returns Bitstream (static FPGA region) meta
22 data, which includes the synth 22 data, which includes the synthesis date, seed and other
23 information of this static FPG 23 information of this static FPGA region.
24 24
25 What: /sys/bus/platform/devices/dfl- 25 What: /sys/bus/platform/devices/dfl-fme.0/cache_size
26 Date: August 2019 26 Date: August 2019
27 KernelVersion: 5.4 27 KernelVersion: 5.4
28 Contact: Wu Hao <hao.wu@intel.com> 28 Contact: Wu Hao <hao.wu@intel.com>
29 Description: Read-only. It returns cache si 29 Description: Read-only. It returns cache size of this FPGA device.
30 30
31 What: /sys/bus/platform/devices/dfl- 31 What: /sys/bus/platform/devices/dfl-fme.0/fabric_version
32 Date: August 2019 32 Date: August 2019
33 KernelVersion: 5.4 33 KernelVersion: 5.4
34 Contact: Wu Hao <hao.wu@intel.com> 34 Contact: Wu Hao <hao.wu@intel.com>
35 Description: Read-only. It returns fabric v 35 Description: Read-only. It returns fabric version of this FPGA device.
36 Userspace applications need th 36 Userspace applications need this information to select
37 best data channels per differe 37 best data channels per different fabric design.
38 38
39 What: /sys/bus/platform/devices/dfl- 39 What: /sys/bus/platform/devices/dfl-fme.0/socket_id
40 Date: August 2019 40 Date: August 2019
41 KernelVersion: 5.4 41 KernelVersion: 5.4
42 Contact: Wu Hao <hao.wu@intel.com> 42 Contact: Wu Hao <hao.wu@intel.com>
43 Description: Read-only. It returns socket_i 43 Description: Read-only. It returns socket_id to indicate which socket
44 this FPGA belongs to, only val 44 this FPGA belongs to, only valid for integrated solution.
45 User only needs this informati 45 User only needs this information, in case standard numa node
46 can't provide correct informat 46 can't provide correct information.
47 47
48 What: /sys/bus/platform/devices/dfl- 48 What: /sys/bus/platform/devices/dfl-fme.0/errors/pcie0_errors
49 Date: August 2019 49 Date: August 2019
50 KernelVersion: 5.4 50 KernelVersion: 5.4
51 Contact: Wu Hao <hao.wu@intel.com> 51 Contact: Wu Hao <hao.wu@intel.com>
52 Description: Read-Write. Read this file for 52 Description: Read-Write. Read this file for errors detected on pcie0 link.
53 Write this file to clear error 53 Write this file to clear errors logged in pcie0_errors. Write
54 fails with -EINVAL if input pa 54 fails with -EINVAL if input parsing fails or input error code
55 doesn't match. 55 doesn't match.
56 56
57 What: /sys/bus/platform/devices/dfl- 57 What: /sys/bus/platform/devices/dfl-fme.0/errors/pcie1_errors
58 Date: August 2019 58 Date: August 2019
59 KernelVersion: 5.4 59 KernelVersion: 5.4
60 Contact: Wu Hao <hao.wu@intel.com> 60 Contact: Wu Hao <hao.wu@intel.com>
61 Description: Read-Write. Read this file for 61 Description: Read-Write. Read this file for errors detected on pcie1 link.
62 Write this file to clear error 62 Write this file to clear errors logged in pcie1_errors. Write
63 fails with -EINVAL if input pa 63 fails with -EINVAL if input parsing fails or input error code
64 doesn't match. 64 doesn't match.
65 65
66 What: /sys/bus/platform/devices/dfl- 66 What: /sys/bus/platform/devices/dfl-fme.0/errors/nonfatal_errors
67 Date: August 2019 67 Date: August 2019
68 KernelVersion: 5.4 68 KernelVersion: 5.4
69 Contact: Wu Hao <hao.wu@intel.com> 69 Contact: Wu Hao <hao.wu@intel.com>
70 Description: Read-only. It returns non-fata 70 Description: Read-only. It returns non-fatal errors detected.
71 71
72 What: /sys/bus/platform/devices/dfl- 72 What: /sys/bus/platform/devices/dfl-fme.0/errors/catfatal_errors
73 Date: August 2019 73 Date: August 2019
74 KernelVersion: 5.4 74 KernelVersion: 5.4
75 Contact: Wu Hao <hao.wu@intel.com> 75 Contact: Wu Hao <hao.wu@intel.com>
76 Description: Read-only. It returns catastro 76 Description: Read-only. It returns catastrophic and fatal errors detected.
77 77
78 What: /sys/bus/platform/devices/dfl- 78 What: /sys/bus/platform/devices/dfl-fme.0/errors/inject_errors
79 Date: August 2019 79 Date: August 2019
80 KernelVersion: 5.4 80 KernelVersion: 5.4
81 Contact: Wu Hao <hao.wu@intel.com> 81 Contact: Wu Hao <hao.wu@intel.com>
82 Description: Read-Write. Read this file to 82 Description: Read-Write. Read this file to check errors injected. Write this
83 file to inject errors for test 83 file to inject errors for testing purpose. Write fails with
84 -EINVAL if input parsing fails 84 -EINVAL if input parsing fails or input inject error code isn't
85 supported. 85 supported.
86 86
87 What: /sys/bus/platform/devices/dfl- 87 What: /sys/bus/platform/devices/dfl-fme.0/errors/fme_errors
88 Date: August 2019 88 Date: August 2019
89 KernelVersion: 5.4 89 KernelVersion: 5.4
90 Contact: Wu Hao <hao.wu@intel.com> 90 Contact: Wu Hao <hao.wu@intel.com>
91 Description: Read-Write. Read this file to 91 Description: Read-Write. Read this file to get errors detected on FME.
92 Write this file to clear error 92 Write this file to clear errors logged in fme_errors. Write
93 fails with -EINVAL if input pa !! 93 fials with -EINVAL if input parsing fails or input error code
94 doesn't match. 94 doesn't match.
95 95
96 What: /sys/bus/platform/devices/dfl- 96 What: /sys/bus/platform/devices/dfl-fme.0/errors/first_error
97 Date: August 2019 97 Date: August 2019
98 KernelVersion: 5.4 98 KernelVersion: 5.4
99 Contact: Wu Hao <hao.wu@intel.com> 99 Contact: Wu Hao <hao.wu@intel.com>
100 Description: Read-only. Read this file to g 100 Description: Read-only. Read this file to get the first error detected by
101 hardware. 101 hardware.
102 102
103 What: /sys/bus/platform/devices/dfl- 103 What: /sys/bus/platform/devices/dfl-fme.0/errors/next_error
104 Date: August 2019 104 Date: August 2019
105 KernelVersion: 5.4 105 KernelVersion: 5.4
106 Contact: Wu Hao <hao.wu@intel.com> 106 Contact: Wu Hao <hao.wu@intel.com>
107 Description: Read-only. Read this file to g 107 Description: Read-only. Read this file to get the second error detected by
108 hardware. 108 hardware.
109 109
110 What: /sys/bus/platform/devices/dfl- 110 What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/name
111 Date: October 2019 111 Date: October 2019
112 KernelVersion: 5.5 112 KernelVersion: 5.5
113 Contact: Wu Hao <hao.wu@intel.com> 113 Contact: Wu Hao <hao.wu@intel.com>
114 Description: Read-Only. Read this file to g 114 Description: Read-Only. Read this file to get the name of hwmon device, it
115 supports values: 115 supports values:
116 !! 116 'dfl_fme_thermal' - thermal hwmon device name
117 ================= =========== !! 117 'dfl_fme_power' - power hwmon device name
118 'dfl_fme_thermal' thermal hwm <<
119 'dfl_fme_power' power hwmon <<
120 ================= =========== <<
121 118
122 What: /sys/bus/platform/devices/dfl- 119 What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/temp1_input
123 Date: October 2019 120 Date: October 2019
124 KernelVersion: 5.5 121 KernelVersion: 5.5
125 Contact: Wu Hao <hao.wu@intel.com> 122 Contact: Wu Hao <hao.wu@intel.com>
126 Description: Read-Only. It returns FPGA dev 123 Description: Read-Only. It returns FPGA device temperature in millidegrees
127 Celsius. 124 Celsius.
128 125
129 What: /sys/bus/platform/devices/dfl- 126 What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/temp1_max
130 Date: October 2019 127 Date: October 2019
131 KernelVersion: 5.5 128 KernelVersion: 5.5
132 Contact: Wu Hao <hao.wu@intel.com> 129 Contact: Wu Hao <hao.wu@intel.com>
133 Description: Read-Only. It returns hardware 130 Description: Read-Only. It returns hardware threshold1 temperature in
134 millidegrees Celsius. If tempe 131 millidegrees Celsius. If temperature rises at or above this
135 threshold, hardware starts 50% 132 threshold, hardware starts 50% or 90% throttling (see
136 'temp1_max_policy'). 133 'temp1_max_policy').
137 134
138 What: /sys/bus/platform/devices/dfl- 135 What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/temp1_crit
139 Date: October 2019 136 Date: October 2019
140 KernelVersion: 5.5 137 KernelVersion: 5.5
141 Contact: Wu Hao <hao.wu@intel.com> 138 Contact: Wu Hao <hao.wu@intel.com>
142 Description: Read-Only. It returns hardware 139 Description: Read-Only. It returns hardware threshold2 temperature in
143 millidegrees Celsius. If tempe 140 millidegrees Celsius. If temperature rises at or above this
144 threshold, hardware starts 100 141 threshold, hardware starts 100% throttling.
145 142
146 What: /sys/bus/platform/devices/dfl- 143 What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/temp1_emergency
147 Date: October 2019 144 Date: October 2019
148 KernelVersion: 5.5 145 KernelVersion: 5.5
149 Contact: Wu Hao <hao.wu@intel.com> 146 Contact: Wu Hao <hao.wu@intel.com>
150 Description: Read-Only. It returns hardware 147 Description: Read-Only. It returns hardware trip threshold temperature in
151 millidegrees Celsius. If tempe 148 millidegrees Celsius. If temperature rises at or above this
152 threshold, a fatal event will 149 threshold, a fatal event will be triggered to board management
153 controller (BMC) to shutdown F 150 controller (BMC) to shutdown FPGA.
154 151
155 What: /sys/bus/platform/devices/dfl- 152 What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/temp1_max_alarm
156 Date: October 2019 153 Date: October 2019
157 KernelVersion: 5.5 154 KernelVersion: 5.5
158 Contact: Wu Hao <hao.wu@intel.com> 155 Contact: Wu Hao <hao.wu@intel.com>
159 Description: Read-only. It returns 1 if tem 156 Description: Read-only. It returns 1 if temperature is currently at or above
160 hardware threshold1 (see 'temp 157 hardware threshold1 (see 'temp1_max'), otherwise 0.
161 158
162 What: /sys/bus/platform/devices/dfl- 159 What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/temp1_crit_alarm
163 Date: October 2019 160 Date: October 2019
164 KernelVersion: 5.5 161 KernelVersion: 5.5
165 Contact: Wu Hao <hao.wu@intel.com> 162 Contact: Wu Hao <hao.wu@intel.com>
166 Description: Read-only. It returns 1 if tem 163 Description: Read-only. It returns 1 if temperature is currently at or above
167 hardware threshold2 (see 'temp 164 hardware threshold2 (see 'temp1_crit'), otherwise 0.
168 165
169 What: /sys/bus/platform/devices/dfl- 166 What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/temp1_max_policy
170 Date: October 2019 167 Date: October 2019
171 KernelVersion: 5.5 168 KernelVersion: 5.5
172 Contact: Wu Hao <hao.wu@intel.com> 169 Contact: Wu Hao <hao.wu@intel.com>
173 Description: Read-Only. Read this file to g 170 Description: Read-Only. Read this file to get the policy of hardware threshold1
174 (see 'temp1_max'). It only sup 171 (see 'temp1_max'). It only supports two values (policies):
175 !! 172 0 - AP2 state (90% throttling)
176 == ========================== !! 173 1 - AP1 state (50% throttling)
177 0 AP2 state (90% throttling) <<
178 1 AP1 state (50% throttling) <<
179 == ========================== <<
180 174
181 What: /sys/bus/platform/devices/dfl- 175 What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/power1_input
182 Date: October 2019 176 Date: October 2019
183 KernelVersion: 5.5 177 KernelVersion: 5.5
184 Contact: Wu Hao <hao.wu@intel.com> 178 Contact: Wu Hao <hao.wu@intel.com>
185 Description: Read-Only. It returns current 179 Description: Read-Only. It returns current FPGA power consumption in uW.
186 180
187 What: /sys/bus/platform/devices/dfl- 181 What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/power1_max
188 Date: October 2019 182 Date: October 2019
189 KernelVersion: 5.5 183 KernelVersion: 5.5
190 Contact: Wu Hao <hao.wu@intel.com> 184 Contact: Wu Hao <hao.wu@intel.com>
191 Description: Read-Write. Read this file to 185 Description: Read-Write. Read this file to get current hardware power
192 threshold1 in uW. If power con 186 threshold1 in uW. If power consumption rises at or above
193 this threshold, hardware start 187 this threshold, hardware starts 50% throttling.
194 Write this file to set current 188 Write this file to set current hardware power threshold1 in uW.
195 As hardware only accepts value 189 As hardware only accepts values in Watts, so input value will
196 be round down per Watts (< 1 w 190 be round down per Watts (< 1 watts part will be discarded) and
197 clamped within the range from 191 clamped within the range from 0 to 127 Watts. Write fails with
198 -EINVAL if input parsing fails 192 -EINVAL if input parsing fails.
199 193
200 What: /sys/bus/platform/devices/dfl- 194 What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/power1_crit
201 Date: October 2019 195 Date: October 2019
202 KernelVersion: 5.5 196 KernelVersion: 5.5
203 Contact: Wu Hao <hao.wu@intel.com> 197 Contact: Wu Hao <hao.wu@intel.com>
204 Description: Read-Write. Read this file to 198 Description: Read-Write. Read this file to get current hardware power
205 threshold2 in uW. If power con 199 threshold2 in uW. If power consumption rises at or above
206 this threshold, hardware start 200 this threshold, hardware starts 90% throttling.
207 Write this file to set current 201 Write this file to set current hardware power threshold2 in uW.
208 As hardware only accepts value 202 As hardware only accepts values in Watts, so input value will
209 be round down per Watts (< 1 w 203 be round down per Watts (< 1 watts part will be discarded) and
210 clamped within the range from 204 clamped within the range from 0 to 127 Watts. Write fails with
211 -EINVAL if input parsing fails 205 -EINVAL if input parsing fails.
212 206
213 What: /sys/bus/platform/devices/dfl- 207 What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/power1_max_alarm
214 Date: October 2019 208 Date: October 2019
215 KernelVersion: 5.5 209 KernelVersion: 5.5
216 Contact: Wu Hao <hao.wu@intel.com> 210 Contact: Wu Hao <hao.wu@intel.com>
217 Description: Read-only. It returns 1 if pow 211 Description: Read-only. It returns 1 if power consumption is currently at or
218 above hardware threshold1 (see 212 above hardware threshold1 (see 'power1_max'), otherwise 0.
219 213
220 What: /sys/bus/platform/devices/dfl- 214 What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/power1_crit_alarm
221 Date: October 2019 215 Date: October 2019
222 KernelVersion: 5.5 216 KernelVersion: 5.5
223 Contact: Wu Hao <hao.wu@intel.com> 217 Contact: Wu Hao <hao.wu@intel.com>
224 Description: Read-only. It returns 1 if pow 218 Description: Read-only. It returns 1 if power consumption is currently at or
225 above hardware threshold2 (see 219 above hardware threshold2 (see 'power1_crit'), otherwise 0.
226 220
227 What: /sys/bus/platform/devices/dfl- 221 What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/power1_xeon_limit
228 Date: October 2019 222 Date: October 2019
229 KernelVersion: 5.5 223 KernelVersion: 5.5
230 Contact: Wu Hao <hao.wu@intel.com> 224 Contact: Wu Hao <hao.wu@intel.com>
231 Description: Read-Only. It returns power li 225 Description: Read-Only. It returns power limit for XEON in uW.
232 226
233 What: /sys/bus/platform/devices/dfl- 227 What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/power1_fpga_limit
234 Date: October 2019 228 Date: October 2019
235 KernelVersion: 5.5 229 KernelVersion: 5.5
236 Contact: Wu Hao <hao.wu@intel.com> 230 Contact: Wu Hao <hao.wu@intel.com>
237 Description: Read-Only. It returns power li 231 Description: Read-Only. It returns power limit for FPGA in uW.
238 232
239 What: /sys/bus/platform/devices/dfl- 233 What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/power1_ltr
240 Date: October 2019 234 Date: October 2019
241 KernelVersion: 5.5 235 KernelVersion: 5.5
242 Contact: Wu Hao <hao.wu@intel.com> 236 Contact: Wu Hao <hao.wu@intel.com>
243 Description: Read-only. Read this file to g 237 Description: Read-only. Read this file to get current Latency Tolerance
244 Reporting (ltr) value. It retu 238 Reporting (ltr) value. It returns 1 if all Accelerated
245 Function Units (AFUs) can tole 239 Function Units (AFUs) can tolerate latency >= 40us for memory
246 access or 0 if any AFU is late 240 access or 0 if any AFU is latency sensitive (< 40us).
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.