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