1 What: /sys/class/habanalabs/hl<n>/armcp_kernel_ver
4 Contact: ogabbay@kernel.org
5 Description: Version of the Linux kernel running on the device's CPU.
6 Will be DEPRECATED in Linux kernel version 5.10, and be
7 replaced with cpucp_kernel_ver
9 What: /sys/class/habanalabs/hl<n>/armcp_ver
12 Contact: ogabbay@kernel.org
13 Description: Version of the application running on the device's CPU
14 Will be DEPRECATED in Linux kernel version 5.10, and be
15 replaced with cpucp_ver
17 What: /sys/class/habanalabs/hl<n>/clk_max_freq_mhz
20 Contact: ogabbay@kernel.org
21 Description: Allows the user to set the maximum clock frequency, in MHz.
22 The device clock might be set to lower value than the maximum.
23 The user should read the clk_cur_freq_mhz to see the actual
24 frequency value of the device clock. This property is valid
25 only for the Gaudi ASIC family
27 What: /sys/class/habanalabs/hl<n>/clk_cur_freq_mhz
30 Contact: ogabbay@kernel.org
31 Description: Displays the current frequency, in MHz, of the device clock.
32 This property is valid only for the Gaudi ASIC family
34 What: /sys/class/habanalabs/hl<n>/cpld_ver
37 Contact: ogabbay@kernel.org
38 Description: Version of the Device's CPLD F/W
40 What: /sys/class/habanalabs/hl<n>/cpucp_kernel_ver
43 Contact: ogabbay@kernel.org
44 Description: Version of the Linux kernel running on the device's CPU
46 What: /sys/class/habanalabs/hl<n>/cpucp_ver
49 Contact: ogabbay@kernel.org
50 Description: Version of the application running on the device's CPU
52 What: /sys/class/habanalabs/hl<n>/device_type
55 Contact: ogabbay@kernel.org
56 Description: Displays the code name of the device according to its type.
57 The supported values are: "GOYA"
59 What: /sys/class/habanalabs/hl<n>/eeprom
62 Contact: ogabbay@kernel.org
63 Description: A binary file attribute that contains the contents of the
66 What: /sys/class/habanalabs/hl<n>/fuse_ver
69 Contact: ogabbay@kernel.org
70 Description: Displays the device's version from the eFuse
72 What: /sys/class/habanalabs/hl<n>/fw_os_ver
75 Contact: ogabbay@kernel.org
76 Description: Version of the firmware OS running on the device's CPU
78 What: /sys/class/habanalabs/hl<n>/hard_reset
81 Contact: ogabbay@kernel.org
82 Description: Interface to trigger a hard-reset operation for the device.
83 Hard-reset will reset ALL internal components of the device
84 except for the PCI interface and the internal PLLs
86 What: /sys/class/habanalabs/hl<n>/hard_reset_cnt
89 Contact: ogabbay@kernel.org
90 Description: Displays how many times the device have undergone a hard-reset
91 operation since the driver was loaded
93 What: /sys/class/habanalabs/hl<n>/high_pll
96 Contact: ogabbay@kernel.org
97 Description: Allows the user to set the maximum clock frequency for MME, TPC
98 and IC when the power management profile is set to "automatic".
99 This property is valid only for the Goya ASIC family
101 What: /sys/class/habanalabs/hl<n>/ic_clk
104 Contact: ogabbay@kernel.org
105 Description: Allows the user to set the maximum clock frequency, in Hz, of
106 the Interconnect fabric. Writes to this parameter affect the
107 device only when the power management profile is set to "manual"
108 mode. The device IC clock might be set to lower value than the
109 maximum. The user should read the ic_clk_curr to see the actual
110 frequency value of the IC. This property is valid only for the
113 What: /sys/class/habanalabs/hl<n>/ic_clk_curr
116 Contact: ogabbay@kernel.org
117 Description: Displays the current clock frequency, in Hz, of the Interconnect
118 fabric. This property is valid only for the Goya ASIC family
120 What: /sys/class/habanalabs/hl<n>/infineon_ver
123 Contact: ogabbay@kernel.org
124 Description: Version of the Device's power supply F/W code. Relevant only to GOYA and GAUDI
126 What: /sys/class/habanalabs/hl<n>/max_power
129 Contact: ogabbay@kernel.org
130 Description: Allows the user to set the maximum power consumption of the
131 device in milliwatts.
133 What: /sys/class/habanalabs/hl<n>/mme_clk
136 Contact: ogabbay@kernel.org
137 Description: Allows the user to set the maximum clock frequency, in Hz, of
138 the MME compute engine. Writes to this parameter affect the
139 device only when the power management profile is set to "manual"
140 mode. The device MME clock might be set to lower value than the
141 maximum. The user should read the mme_clk_curr to see the actual
142 frequency value of the MME. This property is valid only for the
145 What: /sys/class/habanalabs/hl<n>/mme_clk_curr
148 Contact: ogabbay@kernel.org
149 Description: Displays the current clock frequency, in Hz, of the MME compute
150 engine. This property is valid only for the Goya ASIC family
152 What: /sys/class/habanalabs/hl<n>/pci_addr
155 Contact: ogabbay@kernel.org
156 Description: Displays the PCI address of the device. This is needed so the
157 user would be able to open a device based on its PCI address
159 What: /sys/class/habanalabs/hl<n>/pm_mng_profile
162 Contact: ogabbay@kernel.org
163 Description: Power management profile. Values are "auto", "manual". In "auto"
164 mode, the driver will set the maximum clock frequency to a high
165 value when a user-space process opens the device's file (unless
166 it was already opened by another process). The driver will set
167 the max clock frequency to a low value when there are no user
168 processes that are opened on the device's file. In "manual"
169 mode, the user sets the maximum clock frequency by writing to
170 ic_clk, mme_clk and tpc_clk. This property is valid only for
173 What: /sys/class/habanalabs/hl<n>/preboot_btl_ver
176 Contact: ogabbay@kernel.org
177 Description: Version of the device's preboot F/W code
179 What: /sys/class/habanalabs/hl<n>/security_enabled
182 Contact: obitton@habana.ai
183 Description: Displays the device's security status
185 What: /sys/class/habanalabs/hl<n>/soft_reset
188 Contact: ogabbay@kernel.org
189 Description: Interface to trigger a soft-reset operation for the device.
190 Soft-reset will reset only the compute and DMA engines of the
193 What: /sys/class/habanalabs/hl<n>/soft_reset_cnt
196 Contact: ogabbay@kernel.org
197 Description: Displays how many times the device have undergone a soft-reset
198 operation since the driver was loaded
200 What: /sys/class/habanalabs/hl<n>/status
203 Contact: ogabbay@kernel.org
204 Description: Status of the card:
206 * "operational" - Device is available for work.
207 * "in reset" - Device is going through reset, will be
209 * "disabled" - Device is not usable.
210 * "needs reset" - Device is not usable until a hard reset
212 * "in device creation" - Device is not available yet, as it
213 is still initializing.
214 * "in reset after device release" - Device is going through
215 a compute-reset which is executed after a device release
216 (relevant for Gaudi2 only).
218 What: /sys/class/habanalabs/hl<n>/thermal_ver
221 Contact: ogabbay@kernel.org
222 Description: Version of the Device's thermal daemon
224 What: /sys/class/habanalabs/hl<n>/tpc_clk
227 Contact: ogabbay@kernel.org
228 Description: Allows the user to set the maximum clock frequency, in Hz, of
229 the TPC compute engines. Writes to this parameter affect the
230 device only when the power management profile is set to "manual"
231 mode. The device TPC clock might be set to lower value than the
232 maximum. The user should read the tpc_clk_curr to see the actual
233 frequency value of the TPC. This property is valid only for
236 What: /sys/class/habanalabs/hl<n>/tpc_clk_curr
239 Contact: ogabbay@kernel.org
240 Description: Displays the current clock frequency, in Hz, of the TPC compute
241 engines. This property is valid only for the Goya ASIC family
243 What: /sys/class/habanalabs/hl<n>/uboot_ver
246 Contact: ogabbay@kernel.org
247 Description: Version of the u-boot running on the device's CPU
249 What: /sys/class/habanalabs/hl<n>/vrm_ver
252 Contact: ogabbay@kernel.org
253 Description: Version of the Device's Voltage Regulator Monitor F/W code. N/A to GOYA and GAUDI