xref: /linux/Documentation/ABI/testing/sysfs-driver-habanalabs (revision fd7d598270724cc787982ea48bbe17ad383a8b7f)
1What:           /sys/class/accel/accel<n>/device/armcp_kernel_ver
2Date:           Jan 2019
3KernelVersion:  5.1
4Contact:        ogabbay@kernel.org
5Description:    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
9What:           /sys/class/accel/accel<n>/device/armcp_ver
10Date:           Jan 2019
11KernelVersion:  5.1
12Contact:        ogabbay@kernel.org
13Description:    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
17What:           /sys/class/accel/accel<n>/device/clk_max_freq_mhz
18Date:           Jun 2019
19KernelVersion:  5.7
20Contact:        ogabbay@kernel.org
21Description:    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
27What:           /sys/class/accel/accel<n>/device/clk_cur_freq_mhz
28Date:           Jun 2019
29KernelVersion:  5.7
30Contact:        ogabbay@kernel.org
31Description:    Displays the current frequency, in MHz, of the device clock.
32                This property is valid only for the Gaudi ASIC family
33
34What:           /sys/class/accel/accel<n>/device/cpld_ver
35Date:           Jan 2019
36KernelVersion:  5.1
37Contact:        ogabbay@kernel.org
38Description:    Version of the Device's CPLD F/W
39
40What:           /sys/class/accel/accel<n>/device/cpucp_kernel_ver
41Date:           Oct 2020
42KernelVersion:  5.10
43Contact:        ogabbay@kernel.org
44Description:    Version of the Linux kernel running on the device's CPU
45
46What:           /sys/class/accel/accel<n>/device/cpucp_ver
47Date:           Oct 2020
48KernelVersion:  5.10
49Contact:        ogabbay@kernel.org
50Description:    Version of the application running on the device's CPU
51
52What:           /sys/class/accel/accel<n>/device/device_type
53Date:           Jan 2019
54KernelVersion:  5.1
55Contact:        ogabbay@kernel.org
56Description:    Displays the code name of the device according to its type.
57                The supported values are: "GOYA"
58
59What:           /sys/class/accel/accel<n>/device/eeprom
60Date:           Jan 2019
61KernelVersion:  5.1
62Contact:        ogabbay@kernel.org
63Description:    A binary file attribute that contains the contents of the
64                on-board EEPROM
65
66What:           /sys/class/accel/accel<n>/device/fuse_ver
67Date:           Jan 2019
68KernelVersion:  5.1
69Contact:        ogabbay@kernel.org
70Description:    Displays the device's version from the eFuse
71
72What:           /sys/class/accel/accel<n>/device/fw_os_ver
73Date:           Dec 2021
74KernelVersion:  5.18
75Contact:        ogabbay@kernel.org
76Description:    Version of the firmware OS running on the device's CPU
77
78What:           /sys/class/accel/accel<n>/device/hard_reset
79Date:           Jan 2019
80KernelVersion:  5.1
81Contact:        ogabbay@kernel.org
82Description:    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
86What:           /sys/class/accel/accel<n>/device/hard_reset_cnt
87Date:           Jan 2019
88KernelVersion:  5.1
89Contact:        ogabbay@kernel.org
90Description:    Displays how many times the device have undergone a hard-reset
91                operation since the driver was loaded
92
93What:           /sys/class/accel/accel<n>/device/high_pll
94Date:           Jan 2019
95KernelVersion:  5.1
96Contact:        ogabbay@kernel.org
97Description:    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
101What:           /sys/class/accel/accel<n>/device/ic_clk
102Date:           Jan 2019
103KernelVersion:  5.1
104Contact:        ogabbay@kernel.org
105Description:    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
113What:           /sys/class/accel/accel<n>/device/ic_clk_curr
114Date:           Jan 2019
115KernelVersion:  5.1
116Contact:        ogabbay@kernel.org
117Description:    Displays the current clock frequency, in Hz, of the Interconnect
118                fabric. This property is valid only for the Goya ASIC family
119
120What:           /sys/class/accel/accel<n>/device/infineon_ver
121Date:           Jan 2019
122KernelVersion:  5.1
123Contact:        ogabbay@kernel.org
124Description:    Version of the Device's power supply F/W code. Relevant only to GOYA and GAUDI
125
126What:           /sys/class/accel/accel<n>/device/max_power
127Date:           Jan 2019
128KernelVersion:  5.1
129Contact:        ogabbay@kernel.org
130Description:    Allows the user to set the maximum power consumption of the
131                device in milliwatts.
132
133What:           /sys/class/accel/accel<n>/device/mme_clk
134Date:           Jan 2019
135KernelVersion:  5.1
136Contact:        ogabbay@kernel.org
137Description:    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
145What:           /sys/class/accel/accel<n>/device/mme_clk_curr
146Date:           Jan 2019
147KernelVersion:  5.1
148Contact:        ogabbay@kernel.org
149Description:    Displays the current clock frequency, in Hz, of the MME compute
150                engine. This property is valid only for the Goya ASIC family
151
152What:           /sys/class/accel/accel<n>/device/pci_addr
153Date:           Jan 2019
154KernelVersion:  5.1
155Contact:        ogabbay@kernel.org
156Description:    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
158
159What:           /sys/class/accel/accel<n>/device/pm_mng_profile
160Date:           Jan 2019
161KernelVersion:  5.1
162Contact:        ogabbay@kernel.org
163Description:    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
171                the Goya ASIC family
172
173What:           /sys/class/accel/accel<n>/device/preboot_btl_ver
174Date:           Jan 2019
175KernelVersion:  5.1
176Contact:        ogabbay@kernel.org
177Description:    Version of the device's preboot F/W code
178
179What:           /sys/class/accel/accel<n>/device/security_enabled
180Date:           Oct 2022
181KernelVersion:  6.1
182Contact:        obitton@habana.ai
183Description:    Displays the device's security status
184
185What:           /sys/class/accel/accel<n>/device/soft_reset
186Date:           Jan 2019
187KernelVersion:  5.1
188Contact:        ogabbay@kernel.org
189Description:    Interface to trigger a soft-reset operation for the device.
190                Soft-reset will reset only the compute and DMA engines of the
191                device
192
193What:           /sys/class/accel/accel<n>/device/soft_reset_cnt
194Date:           Jan 2019
195KernelVersion:  5.1
196Contact:        ogabbay@kernel.org
197Description:    Displays how many times the device have undergone a soft-reset
198                operation since the driver was loaded
199
200What:           /sys/class/accel/accel<n>/device/status
201Date:           Jan 2019
202KernelVersion:  5.1
203Contact:        ogabbay@kernel.org
204Description:    Status of the card:
205
206                  * "operational" - Device is available for work.
207                  * "in reset" - Device is going through reset, will be
208                    available shortly.
209                  * "disabled" - Device is not usable.
210                  * "needs reset" - Device is not usable until a hard reset
211                    is initiated.
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).
217
218What:           /sys/class/accel/accel<n>/device/thermal_ver
219Date:           Jan 2019
220KernelVersion:  5.1
221Contact:        ogabbay@kernel.org
222Description:    Version of the Device's thermal daemon
223
224What:           /sys/class/accel/accel<n>/device/tpc_clk
225Date:           Jan 2019
226KernelVersion:  5.1
227Contact:        ogabbay@kernel.org
228Description:    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
234                Goya ASIC family
235
236What:           /sys/class/accel/accel<n>/device/tpc_clk_curr
237Date:           Jan 2019
238KernelVersion:  5.1
239Contact:        ogabbay@kernel.org
240Description:    Displays the current clock frequency, in Hz, of the TPC compute
241                engines. This property is valid only for the Goya ASIC family
242
243What:           /sys/class/accel/accel<n>/device/uboot_ver
244Date:           Jan 2019
245KernelVersion:  5.1
246Contact:        ogabbay@kernel.org
247Description:    Version of the u-boot running on the device's CPU
248
249What:           /sys/class/accel/accel<n>/device/vrm_ver
250Date:           Jan 2022
251KernelVersion:  5.17
252Contact:        ogabbay@kernel.org
253Description:    Version of the Device's Voltage Regulator Monitor F/W code. N/A to GOYA and GAUDI
254