0001 What: /sys/class/habanalabs/hl<n>/armcp_kernel_ver
0002 Date: Jan 2019
0003 KernelVersion: 5.1
0004 Contact: ogabbay@kernel.org
0005 Description: Version of the Linux kernel running on the device's CPU.
0006 Will be DEPRECATED in Linux kernel version 5.10, and be
0007 replaced with cpucp_kernel_ver
0008
0009 What: /sys/class/habanalabs/hl<n>/armcp_ver
0010 Date: Jan 2019
0011 KernelVersion: 5.1
0012 Contact: ogabbay@kernel.org
0013 Description: Version of the application running on the device's CPU
0014 Will be DEPRECATED in Linux kernel version 5.10, and be
0015 replaced with cpucp_ver
0016
0017 What: /sys/class/habanalabs/hl<n>/clk_max_freq_mhz
0018 Date: Jun 2019
0019 KernelVersion: not yet upstreamed
0020 Contact: ogabbay@kernel.org
0021 Description: Allows the user to set the maximum clock frequency, in MHz.
0022 The device clock might be set to lower value than the maximum.
0023 The user should read the clk_cur_freq_mhz to see the actual
0024 frequency value of the device clock. This property is valid
0025 only for the Gaudi ASIC family
0026
0027 What: /sys/class/habanalabs/hl<n>/clk_cur_freq_mhz
0028 Date: Jun 2019
0029 KernelVersion: not yet upstreamed
0030 Contact: ogabbay@kernel.org
0031 Description: Displays the current frequency, in MHz, of the device clock.
0032 This property is valid only for the Gaudi ASIC family
0033
0034 What: /sys/class/habanalabs/hl<n>/cpld_ver
0035 Date: Jan 2019
0036 KernelVersion: 5.1
0037 Contact: ogabbay@kernel.org
0038 Description: Version of the Device's CPLD F/W
0039
0040 What: /sys/class/habanalabs/hl<n>/cpucp_kernel_ver
0041 Date: Oct 2020
0042 KernelVersion: 5.10
0043 Contact: ogabbay@kernel.org
0044 Description: Version of the Linux kernel running on the device's CPU
0045
0046 What: /sys/class/habanalabs/hl<n>/cpucp_ver
0047 Date: Oct 2020
0048 KernelVersion: 5.10
0049 Contact: ogabbay@kernel.org
0050 Description: Version of the application running on the device's CPU
0051
0052 What: /sys/class/habanalabs/hl<n>/device_type
0053 Date: Jan 2019
0054 KernelVersion: 5.1
0055 Contact: ogabbay@kernel.org
0056 Description: Displays the code name of the device according to its type.
0057 The supported values are: "GOYA"
0058
0059 What: /sys/class/habanalabs/hl<n>/eeprom
0060 Date: Jan 2019
0061 KernelVersion: 5.1
0062 Contact: ogabbay@kernel.org
0063 Description: A binary file attribute that contains the contents of the
0064 on-board EEPROM
0065
0066 What: /sys/class/habanalabs/hl<n>/fuse_ver
0067 Date: Jan 2019
0068 KernelVersion: 5.1
0069 Contact: ogabbay@kernel.org
0070 Description: Displays the device's version from the eFuse
0071
0072 What: /sys/class/habanalabs/hl<n>/fw_os_ver
0073 Date: Dec 2021
0074 KernelVersion: 5.18
0075 Contact: ogabbay@kernel.org
0076 Description: Version of the firmware OS running on the device's CPU
0077
0078 What: /sys/class/habanalabs/hl<n>/hard_reset
0079 Date: Jan 2019
0080 KernelVersion: 5.1
0081 Contact: ogabbay@kernel.org
0082 Description: Interface to trigger a hard-reset operation for the device.
0083 Hard-reset will reset ALL internal components of the device
0084 except for the PCI interface and the internal PLLs
0085
0086 What: /sys/class/habanalabs/hl<n>/hard_reset_cnt
0087 Date: Jan 2019
0088 KernelVersion: 5.1
0089 Contact: ogabbay@kernel.org
0090 Description: Displays how many times the device have undergone a hard-reset
0091 operation since the driver was loaded
0092
0093 What: /sys/class/habanalabs/hl<n>/high_pll
0094 Date: Jan 2019
0095 KernelVersion: 5.1
0096 Contact: ogabbay@kernel.org
0097 Description: Allows the user to set the maximum clock frequency for MME, TPC
0098 and IC when the power management profile is set to "automatic".
0099 This property is valid only for the Goya ASIC family
0100
0101 What: /sys/class/habanalabs/hl<n>/ic_clk
0102 Date: Jan 2019
0103 KernelVersion: 5.1
0104 Contact: ogabbay@kernel.org
0105 Description: Allows the user to set the maximum clock frequency, in Hz, of
0106 the Interconnect fabric. Writes to this parameter affect the
0107 device only when the power management profile is set to "manual"
0108 mode. The device IC clock might be set to lower value than the
0109 maximum. The user should read the ic_clk_curr to see the actual
0110 frequency value of the IC. This property is valid only for the
0111 Goya ASIC family
0112
0113 What: /sys/class/habanalabs/hl<n>/ic_clk_curr
0114 Date: Jan 2019
0115 KernelVersion: 5.1
0116 Contact: ogabbay@kernel.org
0117 Description: Displays the current clock frequency, in Hz, of the Interconnect
0118 fabric. This property is valid only for the Goya ASIC family
0119
0120 What: /sys/class/habanalabs/hl<n>/infineon_ver
0121 Date: Jan 2019
0122 KernelVersion: 5.1
0123 Contact: ogabbay@kernel.org
0124 Description: Version of the Device's power supply F/W code. Relevant only to GOYA and GAUDI
0125
0126 What: /sys/class/habanalabs/hl<n>/max_power
0127 Date: Jan 2019
0128 KernelVersion: 5.1
0129 Contact: ogabbay@kernel.org
0130 Description: Allows the user to set the maximum power consumption of the
0131 device in milliwatts.
0132
0133 What: /sys/class/habanalabs/hl<n>/mme_clk
0134 Date: Jan 2019
0135 KernelVersion: 5.1
0136 Contact: ogabbay@kernel.org
0137 Description: Allows the user to set the maximum clock frequency, in Hz, of
0138 the MME compute engine. Writes to this parameter affect the
0139 device only when the power management profile is set to "manual"
0140 mode. The device MME clock might be set to lower value than the
0141 maximum. The user should read the mme_clk_curr to see the actual
0142 frequency value of the MME. This property is valid only for the
0143 Goya ASIC family
0144
0145 What: /sys/class/habanalabs/hl<n>/mme_clk_curr
0146 Date: Jan 2019
0147 KernelVersion: 5.1
0148 Contact: ogabbay@kernel.org
0149 Description: Displays the current clock frequency, in Hz, of the MME compute
0150 engine. This property is valid only for the Goya ASIC family
0151
0152 What: /sys/class/habanalabs/hl<n>/pci_addr
0153 Date: Jan 2019
0154 KernelVersion: 5.1
0155 Contact: ogabbay@kernel.org
0156 Description: Displays the PCI address of the device. This is needed so the
0157 user would be able to open a device based on its PCI address
0158
0159 What: /sys/class/habanalabs/hl<n>/pm_mng_profile
0160 Date: Jan 2019
0161 KernelVersion: 5.1
0162 Contact: ogabbay@kernel.org
0163 Description: Power management profile. Values are "auto", "manual". In "auto"
0164 mode, the driver will set the maximum clock frequency to a high
0165 value when a user-space process opens the device's file (unless
0166 it was already opened by another process). The driver will set
0167 the max clock frequency to a low value when there are no user
0168 processes that are opened on the device's file. In "manual"
0169 mode, the user sets the maximum clock frequency by writing to
0170 ic_clk, mme_clk and tpc_clk. This property is valid only for
0171 the Goya ASIC family
0172
0173 What: /sys/class/habanalabs/hl<n>/preboot_btl_ver
0174 Date: Jan 2019
0175 KernelVersion: 5.1
0176 Contact: ogabbay@kernel.org
0177 Description: Version of the device's preboot F/W code
0178
0179 What: /sys/class/habanalabs/hl<n>/soft_reset
0180 Date: Jan 2019
0181 KernelVersion: 5.1
0182 Contact: ogabbay@kernel.org
0183 Description: Interface to trigger a soft-reset operation for the device.
0184 Soft-reset will reset only the compute and DMA engines of the
0185 device
0186
0187 What: /sys/class/habanalabs/hl<n>/soft_reset_cnt
0188 Date: Jan 2019
0189 KernelVersion: 5.1
0190 Contact: ogabbay@kernel.org
0191 Description: Displays how many times the device have undergone a soft-reset
0192 operation since the driver was loaded
0193
0194 What: /sys/class/habanalabs/hl<n>/status
0195 Date: Jan 2019
0196 KernelVersion: 5.1
0197 Contact: ogabbay@kernel.org
0198 Description: Status of the card: "Operational", "Malfunction", "In reset".
0199
0200 What: /sys/class/habanalabs/hl<n>/thermal_ver
0201 Date: Jan 2019
0202 KernelVersion: 5.1
0203 Contact: ogabbay@kernel.org
0204 Description: Version of the Device's thermal daemon
0205
0206 What: /sys/class/habanalabs/hl<n>/tpc_clk
0207 Date: Jan 2019
0208 KernelVersion: 5.1
0209 Contact: ogabbay@kernel.org
0210 Description: Allows the user to set the maximum clock frequency, in Hz, of
0211 the TPC compute engines. Writes to this parameter affect the
0212 device only when the power management profile is set to "manual"
0213 mode. The device TPC clock might be set to lower value than the
0214 maximum. The user should read the tpc_clk_curr to see the actual
0215 frequency value of the TPC. This property is valid only for
0216 Goya ASIC family
0217
0218 What: /sys/class/habanalabs/hl<n>/tpc_clk_curr
0219 Date: Jan 2019
0220 KernelVersion: 5.1
0221 Contact: ogabbay@kernel.org
0222 Description: Displays the current clock frequency, in Hz, of the TPC compute
0223 engines. This property is valid only for the Goya ASIC family
0224
0225 What: /sys/class/habanalabs/hl<n>/uboot_ver
0226 Date: Jan 2019
0227 KernelVersion: 5.1
0228 Contact: ogabbay@kernel.org
0229 Description: Version of the u-boot running on the device's CPU
0230
0231 What: /sys/class/habanalabs/hl<n>/vrm_ver
0232 Date: Jan 2022
0233 KernelVersion: not yet upstreamed
0234 Contact: ogabbay@kernel.org
0235 Description: Version of the Device's Voltage Regulator Monitor F/W code. N/A to GOYA and GAUDI
