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