1 What: /sys/class/accel/accel<n>/devi !! 1 What: /sys/class/habanalabs/hl<n>/armcp_kernel_ver
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: Version of the Linux kernel ru !! 5 Description: Version of the Linux kernel running on the device's CPU
6 Will be DEPRECATED in Linux ke <<
7 replaced with cpucp_kernel_ver <<
8 6
9 What: /sys/class/accel/accel<n>/devi !! 7 What: /sys/class/habanalabs/hl<n>/armcp_ver
10 Date: Jan 2019 8 Date: Jan 2019
11 KernelVersion: 5.1 9 KernelVersion: 5.1
12 Contact: ogabbay@kernel.org !! 10 Contact: oded.gabbay@gmail.com
13 Description: Version of the application run 11 Description: Version of the application running on the device's CPU
14 Will be DEPRECATED in Linux ke <<
15 replaced with cpucp_ver <<
16 12
17 What: /sys/class/accel/accel<n>/devi !! 13 What: /sys/class/habanalabs/hl<n>/clk_max_freq_mhz
18 Date: Jun 2019 14 Date: Jun 2019
19 KernelVersion: 5.7 !! 15 KernelVersion: not yet upstreamed
20 Contact: ogabbay@kernel.org !! 16 Contact: oded.gabbay@gmail.com
21 Description: Allows the user to set the max 17 Description: Allows the user to set the maximum clock frequency, in MHz.
22 The device clock might be set 18 The device clock might be set to lower value than the maximum.
23 The user should read the clk_c 19 The user should read the clk_cur_freq_mhz to see the actual
24 frequency value of the device 20 frequency value of the device clock. This property is valid
25 only for the Gaudi ASIC family 21 only for the Gaudi ASIC family
26 22
27 What: /sys/class/accel/accel<n>/devi !! 23 What: /sys/class/habanalabs/hl<n>/clk_cur_freq_mhz
28 Date: Jun 2019 24 Date: Jun 2019
29 KernelVersion: 5.7 !! 25 KernelVersion: not yet upstreamed
30 Contact: ogabbay@kernel.org !! 26 Contact: oded.gabbay@gmail.com
31 Description: Displays the current frequency 27 Description: Displays the current frequency, in MHz, of the device clock.
32 This property is valid only fo 28 This property is valid only for the Gaudi ASIC family
33 29
34 What: /sys/class/accel/accel<n>/devi !! 30 What: /sys/class/habanalabs/hl<n>/cpld_ver
35 Date: Jan 2019 31 Date: Jan 2019
36 KernelVersion: 5.1 32 KernelVersion: 5.1
37 Contact: ogabbay@kernel.org !! 33 Contact: oded.gabbay@gmail.com
38 Description: Version of the Device's CPLD F 34 Description: Version of the Device's CPLD F/W
39 35
40 What: /sys/class/accel/accel<n>/devi !! 36 What: /sys/class/habanalabs/hl<n>/device_type
41 Date: Oct 2020 <<
42 KernelVersion: 5.10 <<
43 Contact: ogabbay@kernel.org <<
44 Description: Version of the Linux kernel ru <<
45 <<
46 What: /sys/class/accel/accel<n>/devi <<
47 Date: Oct 2020 <<
48 KernelVersion: 5.10 <<
49 Contact: ogabbay@kernel.org <<
50 Description: Version of the application run <<
51 <<
52 What: /sys/class/accel/accel<n>/devi <<
53 Date: Jan 2019 37 Date: Jan 2019
54 KernelVersion: 5.1 38 KernelVersion: 5.1
55 Contact: ogabbay@kernel.org !! 39 Contact: oded.gabbay@gmail.com
56 Description: Displays the code name of the 40 Description: Displays the code name of the device according to its type.
57 The supported values are: "GOY 41 The supported values are: "GOYA"
58 42
59 What: /sys/class/accel/accel<n>/devi !! 43 What: /sys/class/habanalabs/hl<n>/eeprom
60 Date: Jan 2019 44 Date: Jan 2019
61 KernelVersion: 5.1 45 KernelVersion: 5.1
62 Contact: ogabbay@kernel.org !! 46 Contact: oded.gabbay@gmail.com
63 Description: A binary file attribute that c 47 Description: A binary file attribute that contains the contents of the
64 on-board EEPROM 48 on-board EEPROM
65 49
66 What: /sys/class/accel/accel<n>/devi !! 50 What: /sys/class/habanalabs/hl<n>/fuse_ver
67 Date: Jan 2019 51 Date: Jan 2019
68 KernelVersion: 5.1 52 KernelVersion: 5.1
69 Contact: ogabbay@kernel.org !! 53 Contact: oded.gabbay@gmail.com
70 Description: Displays the device's version 54 Description: Displays the device's version from the eFuse
71 55
72 What: /sys/class/accel/accel<n>/devi !! 56 What: /sys/class/habanalabs/hl<n>/hard_reset
73 Date: Dec 2021 <<
74 KernelVersion: 5.18 <<
75 Contact: ogabbay@kernel.org <<
76 Description: Version of the firmware OS run <<
77 <<
78 What: /sys/class/accel/accel<n>/devi <<
79 Date: Jan 2019 57 Date: Jan 2019
80 KernelVersion: 5.1 58 KernelVersion: 5.1
81 Contact: ogabbay@kernel.org !! 59 Contact: oded.gabbay@gmail.com
82 Description: Interface to trigger a hard-re 60 Description: Interface to trigger a hard-reset operation for the device.
83 Hard-reset will reset ALL inte 61 Hard-reset will reset ALL internal components of the device
84 except for the PCI interface a 62 except for the PCI interface and the internal PLLs
85 63
86 What: /sys/class/accel/accel<n>/devi !! 64 What: /sys/class/habanalabs/hl<n>/hard_reset_cnt
87 Date: Jan 2019 65 Date: Jan 2019
88 KernelVersion: 5.1 66 KernelVersion: 5.1
89 Contact: ogabbay@kernel.org !! 67 Contact: oded.gabbay@gmail.com
90 Description: Displays how many times the de 68 Description: Displays how many times the device have undergone a hard-reset
91 operation since the driver was 69 operation since the driver was loaded
92 70
93 What: /sys/class/accel/accel<n>/devi !! 71 What: /sys/class/habanalabs/hl<n>/high_pll
94 Date: Jan 2019 72 Date: Jan 2019
95 KernelVersion: 5.1 73 KernelVersion: 5.1
96 Contact: ogabbay@kernel.org !! 74 Contact: oded.gabbay@gmail.com
97 Description: Allows the user to set the max 75 Description: Allows the user to set the maximum clock frequency for MME, TPC
98 and IC when the power manageme 76 and IC when the power management profile is set to "automatic".
99 This property is valid only fo 77 This property is valid only for the Goya ASIC family
100 78
101 What: /sys/class/accel/accel<n>/devi !! 79 What: /sys/class/habanalabs/hl<n>/ic_clk
102 Date: Jan 2019 80 Date: Jan 2019
103 KernelVersion: 5.1 81 KernelVersion: 5.1
104 Contact: ogabbay@kernel.org !! 82 Contact: oded.gabbay@gmail.com
105 Description: Allows the user to set the max 83 Description: Allows the user to set the maximum clock frequency, in Hz, of
106 the Interconnect fabric. Write 84 the Interconnect fabric. Writes to this parameter affect the
107 device only when the power man 85 device only when the power management profile is set to "manual"
108 mode. The device IC clock migh 86 mode. The device IC clock might be set to lower value than the
109 maximum. The user should read 87 maximum. The user should read the ic_clk_curr to see the actual
110 frequency value of the IC. Thi 88 frequency value of the IC. This property is valid only for the
111 Goya ASIC family 89 Goya ASIC family
112 90
113 What: /sys/class/accel/accel<n>/devi !! 91 What: /sys/class/habanalabs/hl<n>/ic_clk_curr
114 Date: Jan 2019 92 Date: Jan 2019
115 KernelVersion: 5.1 93 KernelVersion: 5.1
116 Contact: ogabbay@kernel.org !! 94 Contact: oded.gabbay@gmail.com
117 Description: Displays the current clock fre 95 Description: Displays the current clock frequency, in Hz, of the Interconnect
118 fabric. This property is valid 96 fabric. This property is valid only for the Goya ASIC family
119 97
120 What: /sys/class/accel/accel<n>/devi !! 98 What: /sys/class/habanalabs/hl<n>/infineon_ver
121 Date: Jan 2019 99 Date: Jan 2019
122 KernelVersion: 5.1 100 KernelVersion: 5.1
123 Contact: ogabbay@kernel.org !! 101 Contact: oded.gabbay@gmail.com
124 Description: Version of the Device's power !! 102 Description: Version of the Device's power supply F/W code
125 103
126 What: /sys/class/accel/accel<n>/devi !! 104 What: /sys/class/habanalabs/hl<n>/max_power
127 Date: Jan 2019 105 Date: Jan 2019
128 KernelVersion: 5.1 106 KernelVersion: 5.1
129 Contact: ogabbay@kernel.org !! 107 Contact: oded.gabbay@gmail.com
130 Description: Allows the user to set the max 108 Description: Allows the user to set the maximum power consumption of the
131 device in milliwatts. 109 device in milliwatts.
132 110
133 What: /sys/class/accel/accel<n>/devi !! 111 What: /sys/class/habanalabs/hl<n>/mme_clk
134 Date: Jan 2019 112 Date: Jan 2019
135 KernelVersion: 5.1 113 KernelVersion: 5.1
136 Contact: ogabbay@kernel.org !! 114 Contact: oded.gabbay@gmail.com
137 Description: Allows the user to set the max 115 Description: Allows the user to set the maximum clock frequency, in Hz, of
138 the MME compute engine. Writes 116 the MME compute engine. Writes to this parameter affect the
139 device only when the power man 117 device only when the power management profile is set to "manual"
140 mode. The device MME clock mig 118 mode. The device MME clock might be set to lower value than the
141 maximum. The user should read 119 maximum. The user should read the mme_clk_curr to see the actual
142 frequency value of the MME. Th 120 frequency value of the MME. This property is valid only for the
143 Goya ASIC family 121 Goya ASIC family
144 122
145 What: /sys/class/accel/accel<n>/devi !! 123 What: /sys/class/habanalabs/hl<n>/mme_clk_curr
146 Date: Jan 2019 124 Date: Jan 2019
147 KernelVersion: 5.1 125 KernelVersion: 5.1
148 Contact: ogabbay@kernel.org !! 126 Contact: oded.gabbay@gmail.com
149 Description: Displays the current clock fre 127 Description: Displays the current clock frequency, in Hz, of the MME compute
150 engine. This property is valid 128 engine. This property is valid only for the Goya ASIC family
151 129
152 What: /sys/class/accel/accel<n>/devi !! 130 What: /sys/class/habanalabs/hl<n>/pci_addr
153 Date: Nov 2023 <<
154 KernelVersion: not yet upstreamed <<
155 Contact: ogabbay@kernel.org <<
156 Description: Displays the device's module i <<
157 <<
158 What: /sys/class/accel/accel<n>/devi <<
159 Date: Nov 2023 <<
160 KernelVersion: 6.8 <<
161 Contact: ttayar@habana.ai <<
162 Description: Displays the name of the paren <<
163 <<
164 What: /sys/class/accel/accel<n>/devi <<
165 Date: Jan 2019 131 Date: Jan 2019
166 KernelVersion: 5.1 132 KernelVersion: 5.1
167 Contact: ogabbay@kernel.org !! 133 Contact: oded.gabbay@gmail.com
168 Description: Displays the PCI address of th 134 Description: Displays the PCI address of the device. This is needed so the
169 user would be able to open a d 135 user would be able to open a device based on its PCI address
170 136
171 What: /sys/class/accel/accel<n>/devi !! 137 What: /sys/class/habanalabs/hl<n>/pm_mng_profile
172 Date: Jan 2019 138 Date: Jan 2019
173 KernelVersion: 5.1 139 KernelVersion: 5.1
174 Contact: ogabbay@kernel.org !! 140 Contact: oded.gabbay@gmail.com
175 Description: Power management profile. Valu 141 Description: Power management profile. Values are "auto", "manual". In "auto"
176 mode, the driver will set the 142 mode, the driver will set the maximum clock frequency to a high
177 value when a user-space proces 143 value when a user-space process opens the device's file (unless
178 it was already opened by anoth 144 it was already opened by another process). The driver will set
179 the max clock frequency to a l 145 the max clock frequency to a low value when there are no user
180 processes that are opened on t 146 processes that are opened on the device's file. In "manual"
181 mode, the user sets the maximu 147 mode, the user sets the maximum clock frequency by writing to
182 ic_clk, mme_clk and tpc_clk. T 148 ic_clk, mme_clk and tpc_clk. This property is valid only for
183 the Goya ASIC family 149 the Goya ASIC family
184 150
185 What: /sys/class/accel/accel<n>/devi !! 151 What: /sys/class/habanalabs/hl<n>/preboot_btl_ver
186 Date: Jan 2019 152 Date: Jan 2019
187 KernelVersion: 5.1 153 KernelVersion: 5.1
188 Contact: ogabbay@kernel.org !! 154 Contact: oded.gabbay@gmail.com
189 Description: Version of the device's preboo 155 Description: Version of the device's preboot F/W code
190 156
191 What: /sys/class/accel/accel<n>/devi !! 157 What: /sys/class/habanalabs/hl<n>/soft_reset
192 Date: Oct 2022 <<
193 KernelVersion: 6.1 <<
194 Contact: obitton@habana.ai <<
195 Description: Displays the device's security <<
196 <<
197 What: /sys/class/accel/accel<n>/devi <<
198 Date: Jan 2019 158 Date: Jan 2019
199 KernelVersion: 5.1 159 KernelVersion: 5.1
200 Contact: ogabbay@kernel.org !! 160 Contact: oded.gabbay@gmail.com
201 Description: Interface to trigger a soft-re 161 Description: Interface to trigger a soft-reset operation for the device.
202 Soft-reset will reset only the 162 Soft-reset will reset only the compute and DMA engines of the
203 device 163 device
204 164
205 What: /sys/class/accel/accel<n>/devi !! 165 What: /sys/class/habanalabs/hl<n>/soft_reset_cnt
206 Date: Jan 2019 166 Date: Jan 2019
207 KernelVersion: 5.1 167 KernelVersion: 5.1
208 Contact: ogabbay@kernel.org !! 168 Contact: oded.gabbay@gmail.com
209 Description: Displays how many times the de 169 Description: Displays how many times the device have undergone a soft-reset
210 operation since the driver was 170 operation since the driver was loaded
211 171
212 What: /sys/class/accel/accel<n>/devi !! 172 What: /sys/class/habanalabs/hl<n>/status
213 Date: Jan 2019 173 Date: Jan 2019
214 KernelVersion: 5.1 174 KernelVersion: 5.1
215 Contact: ogabbay@kernel.org !! 175 Contact: oded.gabbay@gmail.com
216 Description: Status of the card: !! 176 Description: Status of the card: "Operational", "Malfunction", "In reset".
217 <<
218 * "operational" - Device is <<
219 * "in reset" - Device is goi <<
220 available shortly. <<
221 * "disabled" - Device is not <<
222 * "needs reset" - Device is <<
223 is initiated. <<
224 * "in device creation" - Dev <<
225 is still initializing. <<
226 * "in reset after device rel <<
227 a compute-reset which is e <<
228 (relevant for Gaudi2 only) <<
229 177
230 What: /sys/class/accel/accel<n>/devi !! 178 What: /sys/class/habanalabs/hl<n>/thermal_ver
231 Date: Jan 2019 179 Date: Jan 2019
232 KernelVersion: 5.1 180 KernelVersion: 5.1
233 Contact: ogabbay@kernel.org !! 181 Contact: oded.gabbay@gmail.com
234 Description: Version of the Device's therma 182 Description: Version of the Device's thermal daemon
235 183
236 What: /sys/class/accel/accel<n>/devi !! 184 What: /sys/class/habanalabs/hl<n>/tpc_clk
237 Date: Jan 2019 185 Date: Jan 2019
238 KernelVersion: 5.1 186 KernelVersion: 5.1
239 Contact: ogabbay@kernel.org !! 187 Contact: oded.gabbay@gmail.com
240 Description: Allows the user to set the max 188 Description: Allows the user to set the maximum clock frequency, in Hz, of
241 the TPC compute engines. Write 189 the TPC compute engines. Writes to this parameter affect the
242 device only when the power man 190 device only when the power management profile is set to "manual"
243 mode. The device TPC clock mig 191 mode. The device TPC clock might be set to lower value than the
244 maximum. The user should read 192 maximum. The user should read the tpc_clk_curr to see the actual
245 frequency value of the TPC. Th 193 frequency value of the TPC. This property is valid only for
246 Goya ASIC family 194 Goya ASIC family
247 195
248 What: /sys/class/accel/accel<n>/devi !! 196 What: /sys/class/habanalabs/hl<n>/tpc_clk_curr
249 Date: Jan 2019 197 Date: Jan 2019
250 KernelVersion: 5.1 198 KernelVersion: 5.1
251 Contact: ogabbay@kernel.org !! 199 Contact: oded.gabbay@gmail.com
252 Description: Displays the current clock fre 200 Description: Displays the current clock frequency, in Hz, of the TPC compute
253 engines. This property is vali 201 engines. This property is valid only for the Goya ASIC family
254 202
255 What: /sys/class/accel/accel<n>/devi !! 203 What: /sys/class/habanalabs/hl<n>/uboot_ver
256 Date: Jan 2019 204 Date: Jan 2019
257 KernelVersion: 5.1 205 KernelVersion: 5.1
258 Contact: ogabbay@kernel.org !! 206 Contact: oded.gabbay@gmail.com
259 Description: Version of the u-boot running !! 207 Description: Version of the u-boot running on the device's CPU
260 <<
261 What: /sys/class/accel/accel<n>/devi <<
262 Date: Jan 2022 <<
263 KernelVersion: 5.17 <<
264 Contact: ogabbay@kernel.org <<
265 Description: Version of the Device's Voltag <<
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.