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
117 ================= =========== 117 ================= =========================
118 'dfl_fme_thermal' thermal hwm 118 'dfl_fme_thermal' thermal hwmon device name
119 'dfl_fme_power' power hwmon 119 'dfl_fme_power' power hwmon device name
120 ================= =========== 120 ================= =========================
121 121
122 What: /sys/bus/platform/devices/dfl- 122 What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/temp1_input
123 Date: October 2019 123 Date: October 2019
124 KernelVersion: 5.5 124 KernelVersion: 5.5
125 Contact: Wu Hao <hao.wu@intel.com> 125 Contact: Wu Hao <hao.wu@intel.com>
126 Description: Read-Only. It returns FPGA dev 126 Description: Read-Only. It returns FPGA device temperature in millidegrees
127 Celsius. 127 Celsius.
128 128
129 What: /sys/bus/platform/devices/dfl- 129 What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/temp1_max
130 Date: October 2019 130 Date: October 2019
131 KernelVersion: 5.5 131 KernelVersion: 5.5
132 Contact: Wu Hao <hao.wu@intel.com> 132 Contact: Wu Hao <hao.wu@intel.com>
133 Description: Read-Only. It returns hardware 133 Description: Read-Only. It returns hardware threshold1 temperature in
134 millidegrees Celsius. If tempe 134 millidegrees Celsius. If temperature rises at or above this
135 threshold, hardware starts 50% 135 threshold, hardware starts 50% or 90% throttling (see
136 'temp1_max_policy'). 136 'temp1_max_policy').
137 137
138 What: /sys/bus/platform/devices/dfl- 138 What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/temp1_crit
139 Date: October 2019 139 Date: October 2019
140 KernelVersion: 5.5 140 KernelVersion: 5.5
141 Contact: Wu Hao <hao.wu@intel.com> 141 Contact: Wu Hao <hao.wu@intel.com>
142 Description: Read-Only. It returns hardware 142 Description: Read-Only. It returns hardware threshold2 temperature in
143 millidegrees Celsius. If tempe 143 millidegrees Celsius. If temperature rises at or above this
144 threshold, hardware starts 100 144 threshold, hardware starts 100% throttling.
145 145
146 What: /sys/bus/platform/devices/dfl- 146 What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/temp1_emergency
147 Date: October 2019 147 Date: October 2019
148 KernelVersion: 5.5 148 KernelVersion: 5.5
149 Contact: Wu Hao <hao.wu@intel.com> 149 Contact: Wu Hao <hao.wu@intel.com>
150 Description: Read-Only. It returns hardware 150 Description: Read-Only. It returns hardware trip threshold temperature in
151 millidegrees Celsius. If tempe 151 millidegrees Celsius. If temperature rises at or above this
152 threshold, a fatal event will 152 threshold, a fatal event will be triggered to board management
153 controller (BMC) to shutdown F 153 controller (BMC) to shutdown FPGA.
154 154
155 What: /sys/bus/platform/devices/dfl- 155 What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/temp1_max_alarm
156 Date: October 2019 156 Date: October 2019
157 KernelVersion: 5.5 157 KernelVersion: 5.5
158 Contact: Wu Hao <hao.wu@intel.com> 158 Contact: Wu Hao <hao.wu@intel.com>
159 Description: Read-only. It returns 1 if tem 159 Description: Read-only. It returns 1 if temperature is currently at or above
160 hardware threshold1 (see 'temp 160 hardware threshold1 (see 'temp1_max'), otherwise 0.
161 161
162 What: /sys/bus/platform/devices/dfl- 162 What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/temp1_crit_alarm
163 Date: October 2019 163 Date: October 2019
164 KernelVersion: 5.5 164 KernelVersion: 5.5
165 Contact: Wu Hao <hao.wu@intel.com> 165 Contact: Wu Hao <hao.wu@intel.com>
166 Description: Read-only. It returns 1 if tem 166 Description: Read-only. It returns 1 if temperature is currently at or above
167 hardware threshold2 (see 'temp 167 hardware threshold2 (see 'temp1_crit'), otherwise 0.
168 168
169 What: /sys/bus/platform/devices/dfl- 169 What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/temp1_max_policy
170 Date: October 2019 170 Date: October 2019
171 KernelVersion: 5.5 171 KernelVersion: 5.5
172 Contact: Wu Hao <hao.wu@intel.com> 172 Contact: Wu Hao <hao.wu@intel.com>
173 Description: Read-Only. Read this file to g 173 Description: Read-Only. Read this file to get the policy of hardware threshold1
174 (see 'temp1_max'). It only sup 174 (see 'temp1_max'). It only supports two values (policies):
175 175
176 == ========================== 176 == ==========================
177 0 AP2 state (90% throttling) 177 0 AP2 state (90% throttling)
178 1 AP1 state (50% throttling) 178 1 AP1 state (50% throttling)
179 == ========================== 179 == ==========================
180 180
181 What: /sys/bus/platform/devices/dfl- 181 What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/power1_input
182 Date: October 2019 182 Date: October 2019
183 KernelVersion: 5.5 183 KernelVersion: 5.5
184 Contact: Wu Hao <hao.wu@intel.com> 184 Contact: Wu Hao <hao.wu@intel.com>
185 Description: Read-Only. It returns current 185 Description: Read-Only. It returns current FPGA power consumption in uW.
186 186
187 What: /sys/bus/platform/devices/dfl- 187 What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/power1_max
188 Date: October 2019 188 Date: October 2019
189 KernelVersion: 5.5 189 KernelVersion: 5.5
190 Contact: Wu Hao <hao.wu@intel.com> 190 Contact: Wu Hao <hao.wu@intel.com>
191 Description: Read-Write. Read this file to 191 Description: Read-Write. Read this file to get current hardware power
192 threshold1 in uW. If power con 192 threshold1 in uW. If power consumption rises at or above
193 this threshold, hardware start 193 this threshold, hardware starts 50% throttling.
194 Write this file to set current 194 Write this file to set current hardware power threshold1 in uW.
195 As hardware only accepts value 195 As hardware only accepts values in Watts, so input value will
196 be round down per Watts (< 1 w 196 be round down per Watts (< 1 watts part will be discarded) and
197 clamped within the range from 197 clamped within the range from 0 to 127 Watts. Write fails with
198 -EINVAL if input parsing fails 198 -EINVAL if input parsing fails.
199 199
200 What: /sys/bus/platform/devices/dfl- 200 What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/power1_crit
201 Date: October 2019 201 Date: October 2019
202 KernelVersion: 5.5 202 KernelVersion: 5.5
203 Contact: Wu Hao <hao.wu@intel.com> 203 Contact: Wu Hao <hao.wu@intel.com>
204 Description: Read-Write. Read this file to 204 Description: Read-Write. Read this file to get current hardware power
205 threshold2 in uW. If power con 205 threshold2 in uW. If power consumption rises at or above
206 this threshold, hardware start 206 this threshold, hardware starts 90% throttling.
207 Write this file to set current 207 Write this file to set current hardware power threshold2 in uW.
208 As hardware only accepts value 208 As hardware only accepts values in Watts, so input value will
209 be round down per Watts (< 1 w 209 be round down per Watts (< 1 watts part will be discarded) and
210 clamped within the range from 210 clamped within the range from 0 to 127 Watts. Write fails with
211 -EINVAL if input parsing fails 211 -EINVAL if input parsing fails.
212 212
213 What: /sys/bus/platform/devices/dfl- 213 What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/power1_max_alarm
214 Date: October 2019 214 Date: October 2019
215 KernelVersion: 5.5 215 KernelVersion: 5.5
216 Contact: Wu Hao <hao.wu@intel.com> 216 Contact: Wu Hao <hao.wu@intel.com>
217 Description: Read-only. It returns 1 if pow 217 Description: Read-only. It returns 1 if power consumption is currently at or
218 above hardware threshold1 (see 218 above hardware threshold1 (see 'power1_max'), otherwise 0.
219 219
220 What: /sys/bus/platform/devices/dfl- 220 What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/power1_crit_alarm
221 Date: October 2019 221 Date: October 2019
222 KernelVersion: 5.5 222 KernelVersion: 5.5
223 Contact: Wu Hao <hao.wu@intel.com> 223 Contact: Wu Hao <hao.wu@intel.com>
224 Description: Read-only. It returns 1 if pow 224 Description: Read-only. It returns 1 if power consumption is currently at or
225 above hardware threshold2 (see 225 above hardware threshold2 (see 'power1_crit'), otherwise 0.
226 226
227 What: /sys/bus/platform/devices/dfl- 227 What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/power1_xeon_limit
228 Date: October 2019 228 Date: October 2019
229 KernelVersion: 5.5 229 KernelVersion: 5.5
230 Contact: Wu Hao <hao.wu@intel.com> 230 Contact: Wu Hao <hao.wu@intel.com>
231 Description: Read-Only. It returns power li 231 Description: Read-Only. It returns power limit for XEON in uW.
232 232
233 What: /sys/bus/platform/devices/dfl- 233 What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/power1_fpga_limit
234 Date: October 2019 234 Date: October 2019
235 KernelVersion: 5.5 235 KernelVersion: 5.5
236 Contact: Wu Hao <hao.wu@intel.com> 236 Contact: Wu Hao <hao.wu@intel.com>
237 Description: Read-Only. It returns power li 237 Description: Read-Only. It returns power limit for FPGA in uW.
238 238
239 What: /sys/bus/platform/devices/dfl- 239 What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/power1_ltr
240 Date: October 2019 240 Date: October 2019
241 KernelVersion: 5.5 241 KernelVersion: 5.5
242 Contact: Wu Hao <hao.wu@intel.com> 242 Contact: Wu Hao <hao.wu@intel.com>
243 Description: Read-only. Read this file to g 243 Description: Read-only. Read this file to get current Latency Tolerance
244 Reporting (ltr) value. It retu 244 Reporting (ltr) value. It returns 1 if all Accelerated
245 Function Units (AFUs) can tole 245 Function Units (AFUs) can tolerate latency >= 40us for memory
246 access or 0 if any AFU is late 246 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.