Debian Codegraph @

Documentation/ABI/testing/sysfs-driver-habanalabs

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