1 What: /sys/kernel/debug/accel/<paren !! 1 What: /sys/kernel/debug/habanalabs/hl<n>/addr
2 Date: Jan 2019 2 Date: Jan 2019
3 KernelVersion: 5.1 3 KernelVersion: 5.1
4 Contact: ogabbay@kernel.org !! 4 Contact: oded.gabbay@gmail.com
5 Description: Sets the device address to be 5 Description: Sets the device address to be used for read or write through
6 PCI bar, or the device VA of a 6 PCI bar, or the device VA of a host mapped memory to be read or
7 written directly from the host 7 written directly from the host. The latter option is allowed
8 only when the IOMMU is disable 8 only when the IOMMU is disabled.
9 The acceptable value is a stri 9 The acceptable value is a string that starts with "0x"
10 10
11 What: /sys/kernel/debug/accel/<paren !! 11 What: /sys/kernel/debug/habanalabs/hl<n>/clk_gate
12 Date: May 2020 12 Date: May 2020
13 KernelVersion: 5.8 13 KernelVersion: 5.8
14 Contact: ogabbay@kernel.org !! 14 Contact: oded.gabbay@gmail.com
15 Description: This setting is now deprecated !! 15 Description: Allow the root user to disable/enable in runtime the clock
>> 16 gating mechanism in Gaudi. Due to how Gaudi is built, the
>> 17 clock gating needs to be disabled in order to access the
>> 18 registers of the TPC and MME engines. This is sometimes needed
>> 19 during debug by the user and hence the user needs this option.
>> 20 The user can supply a bitmask value, each bit represents
>> 21 a different engine to disable/enable its clock gating feature.
>> 22 The bitmask is composed of 20 bits:
>> 23 0 - 7 : DMA channels
>> 24 8 - 11 : MME engines
>> 25 12 - 19 : TPC engines
>> 26 The bit's location of a specific engine can be determined
>> 27 using (1 << GAUDI_ENGINE_ID_*). GAUDI_ENGINE_ID_* values
>> 28 are defined in uapi habanalabs.h file in enum gaudi_engine_id
16 29
17 What: /sys/kernel/debug/accel/<paren !! 30 What: /sys/kernel/debug/habanalabs/hl<n>/command_buffers
18 Date: Jan 2019 31 Date: Jan 2019
19 KernelVersion: 5.1 32 KernelVersion: 5.1
20 Contact: ogabbay@kernel.org !! 33 Contact: oded.gabbay@gmail.com
21 Description: Displays a list with informati 34 Description: Displays a list with information about the currently allocated
22 command buffers 35 command buffers
23 36
24 What: /sys/kernel/debug/accel/<paren !! 37 What: /sys/kernel/debug/habanalabs/hl<n>/command_submission
25 Date: Jan 2019 38 Date: Jan 2019
26 KernelVersion: 5.1 39 KernelVersion: 5.1
27 Contact: ogabbay@kernel.org !! 40 Contact: oded.gabbay@gmail.com
28 Description: Displays a list with informati 41 Description: Displays a list with information about the currently active
29 command submissions 42 command submissions
30 43
31 What: /sys/kernel/debug/accel/<paren !! 44 What: /sys/kernel/debug/habanalabs/hl<n>/command_submission_jobs
32 Date: Jan 2019 45 Date: Jan 2019
33 KernelVersion: 5.1 46 KernelVersion: 5.1
34 Contact: ogabbay@kernel.org !! 47 Contact: oded.gabbay@gmail.com
35 Description: Displays a list with detailed 48 Description: Displays a list with detailed information about each JOB (CB) of
36 each active command submission 49 each active command submission
37 50
38 What: /sys/kernel/debug/accel/<paren !! 51 What: /sys/kernel/debug/habanalabs/hl<n>/data32
39 Date: Jan 2019 52 Date: Jan 2019
40 KernelVersion: 5.1 53 KernelVersion: 5.1
41 Contact: ogabbay@kernel.org !! 54 Contact: oded.gabbay@gmail.com
42 Description: Allows the root user to read o 55 Description: Allows the root user to read or write directly through the
43 device's PCI bar. Writing to t 56 device's PCI bar. Writing to this file generates a write
44 transaction while reading from 57 transaction while reading from the file generates a read
45 transaction. This custom inter 58 transaction. This custom interface is needed (instead of using
46 the generic Linux user-space P 59 the generic Linux user-space PCI mapping) because the DDR bar
47 is very small compared to the 60 is very small compared to the DDR memory and only the driver can
48 move the bar before and after 61 move the bar before and after the transaction.
49 <<
50 If the IOMMU is disabled, it a 62 If the IOMMU is disabled, it also allows the root user to read
51 or write from the host a devic 63 or write from the host a device VA of a host mapped memory
52 64
53 What: /sys/kernel/debug/accel/<paren !! 65 What: /sys/kernel/debug/habanalabs/hl<n>/data64
54 Date: Jan 2020 66 Date: Jan 2020
55 KernelVersion: 5.6 67 KernelVersion: 5.6
56 Contact: ogabbay@kernel.org !! 68 Contact: oded.gabbay@gmail.com
57 Description: Allows the root user to read o 69 Description: Allows the root user to read or write 64 bit data directly
58 through the device's PCI bar. 70 through the device's PCI bar. Writing to this file generates a
59 write transaction while readin 71 write transaction while reading from the file generates a read
60 transaction. This custom inter 72 transaction. This custom interface is needed (instead of using
61 the generic Linux user-space P 73 the generic Linux user-space PCI mapping) because the DDR bar
62 is very small compared to the 74 is very small compared to the DDR memory and only the driver can
63 move the bar before and after 75 move the bar before and after the transaction.
64 <<
65 If the IOMMU is disabled, it a 76 If the IOMMU is disabled, it also allows the root user to read
66 or write from the host a devic 77 or write from the host a device VA of a host mapped memory
67 78
68 What: /sys/kernel/debug/accel/<paren !! 79 What: /sys/kernel/debug/habanalabs/hl<n>/device
69 Date: Apr 2021 <<
70 KernelVersion: 5.13 <<
71 Contact: ogabbay@kernel.org <<
72 Description: Allows the root user to read f <<
73 memory (DRAM/SRAM) through a D <<
74 This property is a binary blob <<
75 DMA transfer. <<
76 This custom interface is neede <<
77 Linux user-space PCI mapping) <<
78 memory is huge (>32GB) and rea <<
79 a very long time. <<
80 This interface doesn't support <<
81 In GAUDI and GOYA, this action <<
82 in case it is done while the d <<
83 workloads. <<
84 Only supported on GAUDI at thi <<
85 <<
86 What: /sys/kernel/debug/accel/<paren <<
87 Date: Jan 2019 80 Date: Jan 2019
88 KernelVersion: 5.1 81 KernelVersion: 5.1
89 Contact: ogabbay@kernel.org !! 82 Contact: oded.gabbay@gmail.com
90 Description: Enables the root user to set t 83 Description: Enables the root user to set the device to specific state.
91 Valid values are "disable", "e 84 Valid values are "disable", "enable", "suspend", "resume".
92 User can read this property to 85 User can read this property to see the valid values
93 86
94 What: /sys/kernel/debug/accel/<paren !! 87 What: /sys/kernel/debug/habanalabs/hl<n>/engines
95 Date: Oct 2022 <<
96 KernelVersion: 6.2 <<
97 Contact: ttayar@habana.ai <<
98 Description: The watchdog timeout value in <<
99 certain error cases, after whi <<
100 <<
101 What: /sys/kernel/debug/accel/<paren <<
102 Date: Apr 2021 <<
103 KernelVersion: 5.13 <<
104 Contact: ogabbay@kernel.org <<
105 Description: Specify the size of the DMA tr <<
106 from the device's internal mem <<
107 than 128MB. Writing to this va <<
108 When the write is finished, th <<
109 blob <<
110 <<
111 What: /sys/kernel/debug/accel/<paren <<
112 Date: Aug 2022 <<
113 KernelVersion: 5.20 <<
114 Contact: fkassabri@habana.ai <<
115 Description: Dumps all razwi events to dmes <<
116 After reading the status regis <<
117 the routine will clear the sta <<
118 Usage: cat dump_razwi_events <<
119 <<
120 What: /sys/kernel/debug/accel/<paren <<
121 Date: Jan 2021 <<
122 KernelVersion: 5.12 <<
123 Contact: ogabbay@kernel.org <<
124 Description: Dumps all security violations <<
125 all security violations meanin <<
126 dumped next time user calls th <<
127 <<
128 What: /sys/kernel/debug/accel/<paren <<
129 Date: Jul 2019 88 Date: Jul 2019
130 KernelVersion: 5.3 89 KernelVersion: 5.3
131 Contact: ogabbay@kernel.org !! 90 Contact: oded.gabbay@gmail.com
132 Description: Displays the status registers 91 Description: Displays the status registers values of the device engines and
133 their derived idle status 92 their derived idle status
134 93
135 What: /sys/kernel/debug/accel/<paren !! 94 What: /sys/kernel/debug/habanalabs/hl<n>/i2c_addr
136 Date: Jan 2019 95 Date: Jan 2019
137 KernelVersion: 5.1 96 KernelVersion: 5.1
138 Contact: ogabbay@kernel.org !! 97 Contact: oded.gabbay@gmail.com
139 Description: Sets I2C device address for I2 98 Description: Sets I2C device address for I2C transaction that is generated
140 by the device's CPU, Not avail !! 99 by the device's CPU
141 firmware <<
142 100
143 What: /sys/kernel/debug/accel/<paren !! 101 What: /sys/kernel/debug/habanalabs/hl<n>/i2c_bus
144 Date: Jan 2019 102 Date: Jan 2019
145 KernelVersion: 5.1 103 KernelVersion: 5.1
146 Contact: ogabbay@kernel.org !! 104 Contact: oded.gabbay@gmail.com
147 Description: Sets I2C bus address for I2C t 105 Description: Sets I2C bus address for I2C transaction that is generated by
148 the device's CPU, Not availabl !! 106 the device's CPU
149 firmware <<
150 107
151 What: /sys/kernel/debug/accel/<paren !! 108 What: /sys/kernel/debug/habanalabs/hl<n>/i2c_data
152 Date: Jan 2019 109 Date: Jan 2019
153 KernelVersion: 5.1 110 KernelVersion: 5.1
154 Contact: ogabbay@kernel.org !! 111 Contact: oded.gabbay@gmail.com
155 Description: Triggers an I2C transaction th 112 Description: Triggers an I2C transaction that is generated by the device's
156 CPU. Writing to this file gene 113 CPU. Writing to this file generates a write transaction while
157 reading from the file generate !! 114 reading from the file generates a read transcation
158 when device is loaded with sec <<
159 <<
160 What: /sys/kernel/debug/accel/<paren <<
161 Date: Dec 2021 <<
162 KernelVersion: 5.17 <<
163 Contact: obitton@habana.ai <<
164 Description: Sets I2C length in bytes for I <<
165 the device's CPU, Not availabl <<
166 firmware <<
167 115
168 What: /sys/kernel/debug/accel/<paren !! 116 What: /sys/kernel/debug/habanalabs/hl<n>/i2c_reg
169 Date: Jan 2019 117 Date: Jan 2019
170 KernelVersion: 5.1 118 KernelVersion: 5.1
171 Contact: ogabbay@kernel.org !! 119 Contact: oded.gabbay@gmail.com
172 Description: Sets I2C register id for I2C t 120 Description: Sets I2C register id for I2C transaction that is generated by
173 the device's CPU, Not availabl !! 121 the device's CPU
174 firmware <<
175 122
176 What: /sys/kernel/debug/accel/<paren !! 123 What: /sys/kernel/debug/habanalabs/hl<n>/led0
177 Date: Jan 2019 124 Date: Jan 2019
178 KernelVersion: 5.1 125 KernelVersion: 5.1
179 Contact: ogabbay@kernel.org !! 126 Contact: oded.gabbay@gmail.com
180 Description: Sets the state of the first S/ !! 127 Description: Sets the state of the first S/W led on the device
181 when device is loaded with sec <<
182 128
183 What: /sys/kernel/debug/accel/<paren !! 129 What: /sys/kernel/debug/habanalabs/hl<n>/led1
184 Date: Jan 2019 130 Date: Jan 2019
185 KernelVersion: 5.1 131 KernelVersion: 5.1
186 Contact: ogabbay@kernel.org !! 132 Contact: oded.gabbay@gmail.com
187 Description: Sets the state of the second S !! 133 Description: Sets the state of the second S/W led on the device
188 when device is loaded with sec <<
189 134
190 What: /sys/kernel/debug/accel/<paren !! 135 What: /sys/kernel/debug/habanalabs/hl<n>/led2
191 Date: Jan 2019 136 Date: Jan 2019
192 KernelVersion: 5.1 137 KernelVersion: 5.1
193 Contact: ogabbay@kernel.org !! 138 Contact: oded.gabbay@gmail.com
194 Description: Sets the state of the third S/ !! 139 Description: Sets the state of the third S/W led on the device
195 when device is loaded with sec <<
196 <<
197 What: /sys/kernel/debug/accel/<paren <<
198 Date: May 2022 <<
199 KernelVersion: 5.19 <<
200 Contact: dhirschfeld@habana.ai <<
201 Description: Allows the root user to scrub <<
202 value can be set using the deb <<
203 140
204 What: /sys/kernel/debug/accel/<paren !! 141 What: /sys/kernel/debug/habanalabs/hl<n>/mmu
205 Date: May 2022 <<
206 KernelVersion: 5.19 <<
207 Contact: dhirschfeld@habana.ai <<
208 Description: The value to which the dram wi <<
209 scrubs the dram using 'memory_ <<
210 the scrubbing value when using <<
211 <<
212 What: /sys/kernel/debug/accel/<paren <<
213 Date: Jan 2019 142 Date: Jan 2019
214 KernelVersion: 5.1 143 KernelVersion: 5.1
215 Contact: ogabbay@kernel.org !! 144 Contact: oded.gabbay@gmail.com
216 Description: Displays the hop values and ph 145 Description: Displays the hop values and physical address for a given ASID
217 and virtual address. The user 146 and virtual address. The user should write the ASID and VA into
218 the file and then read the fil 147 the file and then read the file to get the result.
219 e.g. to display info about VA 148 e.g. to display info about VA 0x1000 for ASID 1 you need to do:
220 echo "1 0x1000" > /sys/kernel/ !! 149 echo "1 0x1000" > /sys/kernel/debug/habanalabs/hl0/mmu
221 <<
222 What: /sys/kernel/debug/accel/<paren <<
223 Date: Mar 2021 <<
224 KernelVersion: 5.12 <<
225 Contact: fkassabri@habana.ai <<
226 Description: Check and display page fault o <<
227 all MMUs specified in mmu_cap_ <<
228 e.g. to display error info for <<
229 echo "0x200" > /sys/kernel/deb <<
230 cat /sys/kernel/debug/accel/<p <<
231 <<
232 What: /sys/kernel/debug/accel/<paren <<
233 Date: Mar 2022 <<
234 KernelVersion: 5.19 <<
235 Contact: osharabi@habana.ai <<
236 Description: Allows the root user to dump m <<
237 protected config space. <<
238 This property is a binary blob <<
239 monitors registers dump. <<
240 This custom interface is neede <<
241 Linux user-space PCI mapping) <<
242 and cannot be accessed using P <<
243 This interface doesn't support <<
244 Only supported on GAUDI. <<
245 <<
246 What: /sys/kernel/debug/accel/<paren <<
247 Date: Mar 2022 <<
248 KernelVersion: 5.19 <<
249 Contact: osharabi@habana.ai <<
250 Description: Triggers dump of monitor data. <<
251 must be 1. Triggering the moni <<
252 current registers values of al <<
253 When the write is finished, th <<
254 blob <<
255 <<
256 What: /sys/kernel/debug/accel/<paren <<
257 Date: Feb 2024 <<
258 KernelVersion: 6.11 <<
259 Contact: trisin@habana.ai <<
260 Description: Exposes the device's server ty <<
261 150
262 What: /sys/kernel/debug/accel/<paren !! 151 What: /sys/kernel/debug/habanalabs/hl<n>/set_power_state
263 Date: Jan 2019 152 Date: Jan 2019
264 KernelVersion: 5.1 153 KernelVersion: 5.1
265 Contact: ogabbay@kernel.org !! 154 Contact: oded.gabbay@gmail.com
266 Description: Sets the PCI power state. Vali 155 Description: Sets the PCI power state. Valid values are "1" for D0 and "2"
267 for D3Hot 156 for D3Hot
268 157
269 What: /sys/kernel/debug/accel/<paren !! 158 What: /sys/kernel/debug/habanalabs/hl<n>/userptr
270 Date: Jun 2021 <<
271 KernelVersion: 5.13 <<
272 Contact: ynudelman@habana.ai <<
273 Description: Sets the skip reset on timeout <<
274 "0" means device will be reset <<
275 otherwise it will not be reset <<
276 <<
277 What: /sys/kernel/debug/accel/<paren <<
278 Date: Oct 2021 <<
279 KernelVersion: 5.15 <<
280 Contact: ynudelman@habana.ai <<
281 Description: Gets the state dump occurring <<
282 State dump is used for debug a <<
283 a problem in a CS execution, b <<
284 Reading from the node returns <<
285 Writing an integer X discards <<
286 next read would return X+1-st <<
287 <<
288 What: /sys/kernel/debug/accel/<paren <<
289 Date: Mar 2020 <<
290 KernelVersion: 5.6 <<
291 Contact: ogabbay@kernel.org <<
292 Description: Sets the stop-on_error option <<
293 "0" is for disable, otherwise <<
294 Relevant only for GOYA and GAU <<
295 <<
296 What: /sys/kernel/debug/accel/<paren <<
297 Date: Sep 2021 <<
298 KernelVersion: 5.16 <<
299 Contact: obitton@habana.ai <<
300 Description: Sets the command submission ti <<
301 <<
302 What: /sys/kernel/debug/accel/<paren <<
303 Date: Jan 2019 159 Date: Jan 2019
304 KernelVersion: 5.1 160 KernelVersion: 5.1
305 Contact: ogabbay@kernel.org !! 161 Contact: oded.gabbay@gmail.com
306 Description: Displays a list with informati !! 162 Description: Displays a list with information about the currently user
307 pointers (user virtual address 163 pointers (user virtual addresses) that are pinned and mapped
308 to DMA addresses 164 to DMA addresses
309 165
310 What: /sys/kernel/debug/accel/<paren !! 166 What: /sys/kernel/debug/habanalabs/hl<n>/vm
311 Date: Oct 2021 <<
312 KernelVersion: 5.15 <<
313 Contact: ogabbay@kernel.org <<
314 Description: Allows to search for specific <<
315 addresses) that are pinned and <<
316 their resolution to the specif <<
317 <<
318 What: /sys/kernel/debug/accel/<paren <<
319 Date: Jan 2019 167 Date: Jan 2019
320 KernelVersion: 5.1 168 KernelVersion: 5.1
321 Contact: ogabbay@kernel.org !! 169 Contact: oded.gabbay@gmail.com
322 Description: Displays a list with informati 170 Description: Displays a list with information about all the active virtual
323 address mappings per ASID and !! 171 address mappings per ASID
>> 172
>> 173 What: /sys/kernel/debug/habanalabs/hl<n>/stop_on_err
>> 174 Date: Mar 2020
>> 175 KernelVersion: 5.6
>> 176 Contact: oded.gabbay@gmail.com
>> 177 Description: Sets the stop-on_error option for the device engines. Value of
>> 178 "0" is for disable, otherwise enable.
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.