Documentation / ABI / testing / sysfs-driver-habanalabs


Based on kernel version 6.8. Page generated on 2024-03-11 21:26 EST.

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265
What:           /sys/class/accel/accel<n>/device/armcp_kernel_ver
Date:           Jan 2019
KernelVersion:  5.1
Contact:        ogabbay@kernel.org
Description:    Version of the Linux kernel running on the device's CPU.
                Will be DEPRECATED in Linux kernel version 5.10, and be
                replaced with cpucp_kernel_ver

What:           /sys/class/accel/accel<n>/device/armcp_ver
Date:           Jan 2019
KernelVersion:  5.1
Contact:        ogabbay@kernel.org
Description:    Version of the application running on the device's CPU
                Will be DEPRECATED in Linux kernel version 5.10, and be
                replaced with cpucp_ver

What:           /sys/class/accel/accel<n>/device/clk_max_freq_mhz
Date:           Jun 2019
KernelVersion:  5.7
Contact:        ogabbay@kernel.org
Description:    Allows the user to set the maximum clock frequency, in MHz.
                The device clock might be set to lower value than the maximum.
                The user should read the clk_cur_freq_mhz to see the actual
                frequency value of the device clock. This property is valid
                only for the Gaudi ASIC family

What:           /sys/class/accel/accel<n>/device/clk_cur_freq_mhz
Date:           Jun 2019
KernelVersion:  5.7
Contact:        ogabbay@kernel.org
Description:    Displays the current frequency, in MHz, of the device clock.
                This property is valid only for the Gaudi ASIC family

What:           /sys/class/accel/accel<n>/device/cpld_ver
Date:           Jan 2019
KernelVersion:  5.1
Contact:        ogabbay@kernel.org
Description:    Version of the Device's CPLD F/W

What:           /sys/class/accel/accel<n>/device/cpucp_kernel_ver
Date:           Oct 2020
KernelVersion:  5.10
Contact:        ogabbay@kernel.org
Description:    Version of the Linux kernel running on the device's CPU

What:           /sys/class/accel/accel<n>/device/cpucp_ver
Date:           Oct 2020
KernelVersion:  5.10
Contact:        ogabbay@kernel.org
Description:    Version of the application running on the device's CPU

What:           /sys/class/accel/accel<n>/device/device_type
Date:           Jan 2019
KernelVersion:  5.1
Contact:        ogabbay@kernel.org
Description:    Displays the code name of the device according to its type.
                The supported values are: "GOYA"

What:           /sys/class/accel/accel<n>/device/eeprom
Date:           Jan 2019
KernelVersion:  5.1
Contact:        ogabbay@kernel.org
Description:    A binary file attribute that contains the contents of the
                on-board EEPROM

What:           /sys/class/accel/accel<n>/device/fuse_ver
Date:           Jan 2019
KernelVersion:  5.1
Contact:        ogabbay@kernel.org
Description:    Displays the device's version from the eFuse

What:           /sys/class/accel/accel<n>/device/fw_os_ver
Date:           Dec 2021
KernelVersion:  5.18
Contact:        ogabbay@kernel.org
Description:    Version of the firmware OS running on the device's CPU

What:           /sys/class/accel/accel<n>/device/hard_reset
Date:           Jan 2019
KernelVersion:  5.1
Contact:        ogabbay@kernel.org
Description:    Interface to trigger a hard-reset operation for the device.
                Hard-reset will reset ALL internal components of the device
                except for the PCI interface and the internal PLLs

What:           /sys/class/accel/accel<n>/device/hard_reset_cnt
Date:           Jan 2019
KernelVersion:  5.1
Contact:        ogabbay@kernel.org
Description:    Displays how many times the device have undergone a hard-reset
                operation since the driver was loaded

What:           /sys/class/accel/accel<n>/device/high_pll
Date:           Jan 2019
KernelVersion:  5.1
Contact:        ogabbay@kernel.org
Description:    Allows the user to set the maximum clock frequency for MME, TPC
                and IC when the power management profile is set to "automatic".
                This property is valid only for the Goya ASIC family

What:           /sys/class/accel/accel<n>/device/ic_clk
Date:           Jan 2019
KernelVersion:  5.1
Contact:        ogabbay@kernel.org
Description:    Allows the user to set the maximum clock frequency, in Hz, of
                the Interconnect fabric. Writes to this parameter affect the
                device only when the power management profile is set to "manual"
                mode. The device IC clock might be set to lower value than the
                maximum. The user should read the ic_clk_curr to see the actual
                frequency value of the IC. This property is valid only for the
                Goya ASIC family

What:           /sys/class/accel/accel<n>/device/ic_clk_curr
Date:           Jan 2019
KernelVersion:  5.1
Contact:        ogabbay@kernel.org
Description:    Displays the current clock frequency, in Hz, of the Interconnect
                fabric. This property is valid only for the Goya ASIC family

What:           /sys/class/accel/accel<n>/device/infineon_ver
Date:           Jan 2019
KernelVersion:  5.1
Contact:        ogabbay@kernel.org
Description:    Version of the Device's power supply F/W code. Relevant only to GOYA and GAUDI

What:           /sys/class/accel/accel<n>/device/max_power
Date:           Jan 2019
KernelVersion:  5.1
Contact:        ogabbay@kernel.org
Description:    Allows the user to set the maximum power consumption of the
                device in milliwatts.

What:           /sys/class/accel/accel<n>/device/mme_clk
Date:           Jan 2019
KernelVersion:  5.1
Contact:        ogabbay@kernel.org
Description:    Allows the user to set the maximum clock frequency, in Hz, of
                the MME compute engine. Writes to this parameter affect the
                device only when the power management profile is set to "manual"
                mode. The device MME clock might be set to lower value than the
                maximum. The user should read the mme_clk_curr to see the actual
                frequency value of the MME. This property is valid only for the
                Goya ASIC family

What:           /sys/class/accel/accel<n>/device/mme_clk_curr
Date:           Jan 2019
KernelVersion:  5.1
Contact:        ogabbay@kernel.org
Description:    Displays the current clock frequency, in Hz, of the MME compute
                engine. This property is valid only for the Goya ASIC family

What:           /sys/class/accel/accel<n>/device/module_id
Date:           Nov 2023
KernelVersion:  not yet upstreamed
Contact:        ogabbay@kernel.org
Description:    Displays the device's module id

What:           /sys/class/accel/accel<n>/device/parent_device
Date:           Nov 2023
KernelVersion:  6.8
Contact:        ttayar@habana.ai
Description:    Displays the name of the parent device of the accel device

What:           /sys/class/accel/accel<n>/device/pci_addr
Date:           Jan 2019
KernelVersion:  5.1
Contact:        ogabbay@kernel.org
Description:    Displays the PCI address of the device. This is needed so the
                user would be able to open a device based on its PCI address

What:           /sys/class/accel/accel<n>/device/pm_mng_profile
Date:           Jan 2019
KernelVersion:  5.1
Contact:        ogabbay@kernel.org
Description:    Power management profile. Values are "auto", "manual". In "auto"
                mode, the driver will set the maximum clock frequency to a high
                value when a user-space process opens the device's file (unless
                it was already opened by another process). The driver will set
                the max clock frequency to a low value when there are no user
                processes that are opened on the device's file. In "manual"
                mode, the user sets the maximum clock frequency by writing to
                ic_clk, mme_clk and tpc_clk. This property is valid only for
                the Goya ASIC family

What:           /sys/class/accel/accel<n>/device/preboot_btl_ver
Date:           Jan 2019
KernelVersion:  5.1
Contact:        ogabbay@kernel.org
Description:    Version of the device's preboot F/W code

What:           /sys/class/accel/accel<n>/device/security_enabled
Date:           Oct 2022
KernelVersion:  6.1
Contact:        obitton@habana.ai
Description:    Displays the device's security status

What:           /sys/class/accel/accel<n>/device/soft_reset
Date:           Jan 2019
KernelVersion:  5.1
Contact:        ogabbay@kernel.org
Description:    Interface to trigger a soft-reset operation for the device.
                Soft-reset will reset only the compute and DMA engines of the
                device

What:           /sys/class/accel/accel<n>/device/soft_reset_cnt
Date:           Jan 2019
KernelVersion:  5.1
Contact:        ogabbay@kernel.org
Description:    Displays how many times the device have undergone a soft-reset
                operation since the driver was loaded

What:           /sys/class/accel/accel<n>/device/status
Date:           Jan 2019
KernelVersion:  5.1
Contact:        ogabbay@kernel.org
Description:    Status of the card:

                  * "operational" - Device is available for work.
                  * "in reset" - Device is going through reset, will be
                    available shortly.
                  * "disabled" - Device is not usable.
                  * "needs reset" - Device is not usable until a hard reset
                    is initiated.
                  * "in device creation" - Device is not available yet, as it
                    is still initializing.
                  * "in reset after device release" - Device is going through
                    a compute-reset which is executed after a device release
                    (relevant for Gaudi2 only).

What:           /sys/class/accel/accel<n>/device/thermal_ver
Date:           Jan 2019
KernelVersion:  5.1
Contact:        ogabbay@kernel.org
Description:    Version of the Device's thermal daemon

What:           /sys/class/accel/accel<n>/device/tpc_clk
Date:           Jan 2019
KernelVersion:  5.1
Contact:        ogabbay@kernel.org
Description:    Allows the user to set the maximum clock frequency, in Hz, of
                the TPC compute engines. Writes to this parameter affect the
                device only when the power management profile is set to "manual"
                mode. The device TPC clock might be set to lower value than the
                maximum. The user should read the tpc_clk_curr to see the actual
                frequency value of the TPC. This property is valid only for
                Goya ASIC family

What:           /sys/class/accel/accel<n>/device/tpc_clk_curr
Date:           Jan 2019
KernelVersion:  5.1
Contact:        ogabbay@kernel.org
Description:    Displays the current clock frequency, in Hz, of the TPC compute
                engines. This property is valid only for the Goya ASIC family

What:           /sys/class/accel/accel<n>/device/uboot_ver
Date:           Jan 2019
KernelVersion:  5.1
Contact:        ogabbay@kernel.org
Description:    Version of the u-boot running on the device's CPU

What:           /sys/class/accel/accel<n>/device/vrm_ver
Date:           Jan 2022
KernelVersion:  5.17
Contact:        ogabbay@kernel.org
Description:    Version of the Device's Voltage Regulator Monitor F/W code. N/A to GOYA and GAUDI