1What: /sys/kernel/debug/habanalabs/hl<n>/addr 2Date: Jan 2019 3KernelVersion: 5.1 4Contact: oded.gabbay@gmail.com 5Description: Sets the device address to be used for read or write through 6 PCI bar, or the device VA of a host mapped memory to be read or 7 written directly from the host. The latter option is allowed 8 only when the IOMMU is disabled. 9 The acceptable value is a string that starts with "0x" 10 11What: /sys/kernel/debug/habanalabs/hl<n>/clk_gate 12Date: May 2020 13KernelVersion: 5.8 14Contact: oded.gabbay@gmail.com 15Description: Allow the root user to disable/enable in runtime the clock 16 gating mechanism in Gaudi. Due to how Gaudi is built, the 17 clock gating needs to be disabled in order to access the 18 registers of the TPC and MME engines. This is sometimes needed 19 during debug by the user and hence the user needs this option. 20 The user can supply a bitmask value, each bit represents 21 a different engine to disable/enable its clock gating feature. 22 The bitmask is composed of 20 bits: 23 24 ======= ============ 25 0 - 7 DMA channels 26 8 - 11 MME engines 27 12 - 19 TPC engines 28 ======= ============ 29 30 The bit's location of a specific engine can be determined 31 using (1 << GAUDI_ENGINE_ID_*). GAUDI_ENGINE_ID_* values 32 are defined in uapi habanalabs.h file in enum gaudi_engine_id 33 34What: /sys/kernel/debug/habanalabs/hl<n>/command_buffers 35Date: Jan 2019 36KernelVersion: 5.1 37Contact: oded.gabbay@gmail.com 38Description: Displays a list with information about the currently allocated 39 command buffers 40 41What: /sys/kernel/debug/habanalabs/hl<n>/command_submission 42Date: Jan 2019 43KernelVersion: 5.1 44Contact: oded.gabbay@gmail.com 45Description: Displays a list with information about the currently active 46 command submissions 47 48What: /sys/kernel/debug/habanalabs/hl<n>/command_submission_jobs 49Date: Jan 2019 50KernelVersion: 5.1 51Contact: oded.gabbay@gmail.com 52Description: Displays a list with detailed information about each JOB (CB) of 53 each active command submission 54 55What: /sys/kernel/debug/habanalabs/hl<n>/data32 56Date: Jan 2019 57KernelVersion: 5.1 58Contact: oded.gabbay@gmail.com 59Description: Allows the root user to read or write directly through the 60 device's PCI bar. Writing to this file generates a write 61 transaction while reading from the file generates a read 62 transaction. This custom interface is needed (instead of using 63 the generic Linux user-space PCI mapping) because the DDR bar 64 is very small compared to the DDR memory and only the driver can 65 move the bar before and after the transaction. 66 67 If the IOMMU is disabled, it also allows the root user to read 68 or write from the host a device VA of a host mapped memory 69 70What: /sys/kernel/debug/habanalabs/hl<n>/data64 71Date: Jan 2020 72KernelVersion: 5.6 73Contact: oded.gabbay@gmail.com 74Description: Allows the root user to read or write 64 bit data directly 75 through the device's PCI bar. Writing to this file generates a 76 write transaction while reading from the file generates a read 77 transaction. This custom interface is needed (instead of using 78 the generic Linux user-space PCI mapping) because the DDR bar 79 is very small compared to the DDR memory and only the driver can 80 move the bar before and after the transaction. 81 82 If the IOMMU is disabled, it also allows the root user to read 83 or write from the host a device VA of a host mapped memory 84 85What: /sys/kernel/debug/habanalabs/hl<n>/device 86Date: Jan 2019 87KernelVersion: 5.1 88Contact: oded.gabbay@gmail.com 89Description: Enables the root user to set the device to specific state. 90 Valid values are "disable", "enable", "suspend", "resume". 91 User can read this property to see the valid values 92 93What: /sys/kernel/debug/habanalabs/hl<n>/engines 94Date: Jul 2019 95KernelVersion: 5.3 96Contact: oded.gabbay@gmail.com 97Description: Displays the status registers values of the device engines and 98 their derived idle status 99 100What: /sys/kernel/debug/habanalabs/hl<n>/i2c_addr 101Date: Jan 2019 102KernelVersion: 5.1 103Contact: oded.gabbay@gmail.com 104Description: Sets I2C device address for I2C transaction that is generated 105 by the device's CPU 106 107What: /sys/kernel/debug/habanalabs/hl<n>/i2c_bus 108Date: Jan 2019 109KernelVersion: 5.1 110Contact: oded.gabbay@gmail.com 111Description: Sets I2C bus address for I2C transaction that is generated by 112 the device's CPU 113 114What: /sys/kernel/debug/habanalabs/hl<n>/i2c_data 115Date: Jan 2019 116KernelVersion: 5.1 117Contact: oded.gabbay@gmail.com 118Description: Triggers an I2C transaction that is generated by the device's 119 CPU. Writing to this file generates a write transaction while 120 reading from the file generates a read transcation 121 122What: /sys/kernel/debug/habanalabs/hl<n>/i2c_reg 123Date: Jan 2019 124KernelVersion: 5.1 125Contact: oded.gabbay@gmail.com 126Description: Sets I2C register id for I2C transaction that is generated by 127 the device's CPU 128 129What: /sys/kernel/debug/habanalabs/hl<n>/led0 130Date: Jan 2019 131KernelVersion: 5.1 132Contact: oded.gabbay@gmail.com 133Description: Sets the state of the first S/W led on the device 134 135What: /sys/kernel/debug/habanalabs/hl<n>/led1 136Date: Jan 2019 137KernelVersion: 5.1 138Contact: oded.gabbay@gmail.com 139Description: Sets the state of the second S/W led on the device 140 141What: /sys/kernel/debug/habanalabs/hl<n>/led2 142Date: Jan 2019 143KernelVersion: 5.1 144Contact: oded.gabbay@gmail.com 145Description: Sets the state of the third S/W led on the device 146 147What: /sys/kernel/debug/habanalabs/hl<n>/mmu 148Date: Jan 2019 149KernelVersion: 5.1 150Contact: oded.gabbay@gmail.com 151Description: Displays the hop values and physical address for a given ASID 152 and virtual address. The user should write the ASID and VA into 153 the file and then read the file to get the result. 154 e.g. to display info about VA 0x1000 for ASID 1 you need to do: 155 echo "1 0x1000" > /sys/kernel/debug/habanalabs/hl0/mmu 156 157What: /sys/kernel/debug/habanalabs/hl<n>/set_power_state 158Date: Jan 2019 159KernelVersion: 5.1 160Contact: oded.gabbay@gmail.com 161Description: Sets the PCI power state. Valid values are "1" for D0 and "2" 162 for D3Hot 163 164What: /sys/kernel/debug/habanalabs/hl<n>/userptr 165Date: Jan 2019 166KernelVersion: 5.1 167Contact: oded.gabbay@gmail.com 168Description: Displays a list with information about the currently user 169 pointers (user virtual addresses) that are pinned and mapped 170 to DMA addresses 171 172What: /sys/kernel/debug/habanalabs/hl<n>/vm 173Date: Jan 2019 174KernelVersion: 5.1 175Contact: oded.gabbay@gmail.com 176Description: Displays a list with information about all the active virtual 177 address mappings per ASID 178 179What: /sys/kernel/debug/habanalabs/hl<n>/stop_on_err 180Date: Mar 2020 181KernelVersion: 5.6 182Contact: oded.gabbay@gmail.com 183Description: Sets the stop-on_error option for the device engines. Value of 184 "0" is for disable, otherwise enable. 185 186What: /sys/kernel/debug/habanalabs/hl<n>/dump_security_violations 187Date: Jan 2021 188KernelVersion: 5.12 189Contact: oded.gabbay@gmail.com 190Description: Dumps all security violations to dmesg. This will also ack 191 all security violations meanings those violations will not be 192 dumped next time user calls this API 193