iv/linux
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

accel/habanalabs: update debugfs-driver-habanalabs with the accel path

Browse Source 
Replace "/sys/kernel/debug/habanalabs/hl<n>/..." with
"/sys/kernel/debug/accel/<n>/...".

Signed-off-by: Tomer Tayar <ttayar@habana.ai>
Reviewed-by: Oded Gabbay <ogabbay@kernel.org>
Signed-off-by: Oded Gabbay <ogabbay@kernel.org>
This commit is contained in:
Tomer Tayar 2023-03-23 14:58:34 +02:00 committed by Oded Gabbay
parent 13312360ef
commit 38ed55bc58
1 changed files with 41 additions and 41 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

82
Documentation/ABI/testing/debugfs-driver-habanalabs
View File

@ -1,4 +1,4 @@
What: /sys/kernel/debug/habanalabs/hl<n>/addr What: /sys/kernel/debug/accel/<n>/addr
Date: Jan 2019 Date: Jan 2019
KernelVersion: 5.1 KernelVersion: 5.1
Contact: ogabbay@kernel.org Contact: ogabbay@kernel.org
@ -8,34 +8,34 @@ Description: Sets the device address to be used for read or write through
only when the IOMMU is disabled. only when the IOMMU is disabled.
The acceptable value is a string that starts with "0x" The acceptable value is a string that starts with "0x"
What: /sys/kernel/debug/habanalabs/hl<n>/clk_gate What: /sys/kernel/debug/accel/<n>/clk_gate
Date: May 2020 Date: May 2020
KernelVersion: 5.8 KernelVersion: 5.8
Contact: ogabbay@kernel.org Contact: ogabbay@kernel.org
Description: This setting is now deprecated as clock gating is handled solely by the f/w Description: This setting is now deprecated as clock gating is handled solely by the f/w
What: /sys/kernel/debug/habanalabs/hl<n>/command_buffers What: /sys/kernel/debug/accel/<n>/command_buffers
Date: Jan 2019 Date: Jan 2019
KernelVersion: 5.1 KernelVersion: 5.1
Contact: ogabbay@kernel.org Contact: ogabbay@kernel.org
Description: Displays a list with information about the currently allocated Description: Displays a list with information about the currently allocated
command buffers command buffers
What: /sys/kernel/debug/habanalabs/hl<n>/command_submission What: /sys/kernel/debug/accel/<n>/command_submission
Date: Jan 2019 Date: Jan 2019
KernelVersion: 5.1 KernelVersion: 5.1
Contact: ogabbay@kernel.org Contact: ogabbay@kernel.org
Description: Displays a list with information about the currently active Description: Displays a list with information about the currently active
command submissions command submissions
What: /sys/kernel/debug/habanalabs/hl<n>/command_submission_jobs What: /sys/kernel/debug/accel/<n>/command_submission_jobs
Date: Jan 2019 Date: Jan 2019
KernelVersion: 5.1 KernelVersion: 5.1
Contact: ogabbay@kernel.org Contact: ogabbay@kernel.org
Description: Displays a list with detailed information about each JOB (CB) of Description: Displays a list with detailed information about each JOB (CB) of
each active command submission each active command submission
What: /sys/kernel/debug/habanalabs/hl<n>/data32 What: /sys/kernel/debug/accel/<n>/data32
Date: Jan 2019 Date: Jan 2019
KernelVersion: 5.1 KernelVersion: 5.1
Contact: ogabbay@kernel.org Contact: ogabbay@kernel.org
@ -50,7 +50,7 @@ Description: Allows the root user to read or write directly through the
If the IOMMU is disabled, it also allows the root user to read If the IOMMU is disabled, it also allows the root user to read
or write from the host a device VA of a host mapped memory or write from the host a device VA of a host mapped memory
What: /sys/kernel/debug/habanalabs/hl<n>/data64 What: /sys/kernel/debug/accel/<n>/data64
Date: Jan 2020 Date: Jan 2020
KernelVersion: 5.6 KernelVersion: 5.6
Contact: ogabbay@kernel.org Contact: ogabbay@kernel.org
@ -65,7 +65,7 @@ Description: Allows the root user to read or write 64 bit data directly
If the IOMMU is disabled, it also allows the root user to read If the IOMMU is disabled, it also allows the root user to read
or write from the host a device VA of a host mapped memory or write from the host a device VA of a host mapped memory
What: /sys/kernel/debug/habanalabs/hl<n>/data_dma What: /sys/kernel/debug/accel/<n>/data_dma
Date: Apr 2021 Date: Apr 2021
KernelVersion: 5.13 KernelVersion: 5.13
Contact: ogabbay@kernel.org Contact: ogabbay@kernel.org
@ -79,11 +79,11 @@ Description: Allows the root user to read from the device's internal
a very long time. a very long time.
This interface doesn't support concurrency in the same device. This interface doesn't support concurrency in the same device.
In GAUDI and GOYA, this action can cause undefined behavior In GAUDI and GOYA, this action can cause undefined behavior
in case the it is done while the device is executing user in case it is done while the device is executing user
workloads. workloads.
Only supported on GAUDI at this stage. Only supported on GAUDI at this stage.
What: /sys/kernel/debug/habanalabs/hl<n>/device What: /sys/kernel/debug/accel/<n>/device
Date: Jan 2019 Date: Jan 2019
KernelVersion: 5.1 KernelVersion: 5.1
Contact: ogabbay@kernel.org Contact: ogabbay@kernel.org
@ -91,14 +91,14 @@ Description: Enables the root user to set the device to specific state.
Valid values are "disable", "enable", "suspend", "resume". Valid values are "disable", "enable", "suspend", "resume".
User can read this property to see the valid values User can read this property to see the valid values
What: /sys/kernel/debug/habanalabs/hl<n>/device_release_watchdog_timeout What: /sys/kernel/debug/accel/<n>/device_release_watchdog_timeout
Date: Oct 2022 Date: Oct 2022
KernelVersion: 6.2 KernelVersion: 6.2
Contact: ttayar@habana.ai Contact: ttayar@habana.ai
Description: The watchdog timeout value in seconds for a device release upon Description: The watchdog timeout value in seconds for a device release upon
certain error cases, after which the device is reset. certain error cases, after which the device is reset.
What: /sys/kernel/debug/habanalabs/hl<n>/dma_size What: /sys/kernel/debug/accel/<n>/dma_size
Date: Apr 2021 Date: Apr 2021
KernelVersion: 5.13 KernelVersion: 5.13
Contact: ogabbay@kernel.org Contact: ogabbay@kernel.org
@ -108,7 +108,7 @@ Description: Specify the size of the DMA transaction when using DMA to read
When the write is finished, the user can read the "data_dma" When the write is finished, the user can read the "data_dma"
blob blob
What: /sys/kernel/debug/habanalabs/hl<n>/dump_razwi_events What: /sys/kernel/debug/accel/<n>/dump_razwi_events
Date: Aug 2022 Date: Aug 2022
KernelVersion: 5.20 KernelVersion: 5.20
Contact: fkassabri@habana.ai Contact: fkassabri@habana.ai
@ -117,7 +117,7 @@ Description: Dumps all razwi events to dmesg if exist.
the routine will clear the status register. the routine will clear the status register.
Usage: cat dump_razwi_events Usage: cat dump_razwi_events
What: /sys/kernel/debug/habanalabs/hl<n>/dump_security_violations What: /sys/kernel/debug/accel/<n>/dump_security_violations
Date: Jan 2021 Date: Jan 2021
KernelVersion: 5.12 KernelVersion: 5.12
Contact: ogabbay@kernel.org Contact: ogabbay@kernel.org
@ -125,14 +125,14 @@ Description: Dumps all security violations to dmesg. This will also ack
all security violations meanings those violations will not be all security violations meanings those violations will not be
dumped next time user calls this API dumped next time user calls this API
What: /sys/kernel/debug/habanalabs/hl<n>/engines What: /sys/kernel/debug/accel/<n>/engines
Date: Jul 2019 Date: Jul 2019
KernelVersion: 5.3 KernelVersion: 5.3
Contact: ogabbay@kernel.org Contact: ogabbay@kernel.org
Description: Displays the status registers values of the device engines and Description: Displays the status registers values of the device engines and
their derived idle status their derived idle status
What: /sys/kernel/debug/habanalabs/hl<n>/i2c_addr What: /sys/kernel/debug/accel/<n>/i2c_addr
Date: Jan 2019 Date: Jan 2019
KernelVersion: 5.1 KernelVersion: 5.1
Contact: ogabbay@kernel.org Contact: ogabbay@kernel.org
@ -140,7 +140,7 @@ Description: Sets I2C device address for I2C transaction that is generated
by the device's CPU, Not available when device is loaded with secured by the device's CPU, Not available when device is loaded with secured
firmware firmware
What: /sys/kernel/debug/habanalabs/hl<n>/i2c_bus What: /sys/kernel/debug/accel/<n>/i2c_bus
Date: Jan 2019 Date: Jan 2019
KernelVersion: 5.1 KernelVersion: 5.1
Contact: ogabbay@kernel.org Contact: ogabbay@kernel.org
@ -148,7 +148,7 @@ Description: Sets I2C bus address for I2C transaction that is generated by
the device's CPU, Not available when device is loaded with secured the device's CPU, Not available when device is loaded with secured
firmware firmware
What: /sys/kernel/debug/habanalabs/hl<n>/i2c_data What: /sys/kernel/debug/accel/<n>/i2c_data
Date: Jan 2019 Date: Jan 2019
KernelVersion: 5.1 KernelVersion: 5.1
Contact: ogabbay@kernel.org Contact: ogabbay@kernel.org
@ -157,7 +157,7 @@ Description: Triggers an I2C transaction that is generated by the device's
reading from the file generates a read transaction, Not available reading from the file generates a read transaction, Not available
when device is loaded with secured firmware when device is loaded with secured firmware
What: /sys/kernel/debug/habanalabs/hl<n>/i2c_len What: /sys/kernel/debug/accel/<n>/i2c_len
Date: Dec 2021 Date: Dec 2021
KernelVersion: 5.17 KernelVersion: 5.17
Contact: obitton@habana.ai Contact: obitton@habana.ai
@ -165,7 +165,7 @@ Description: Sets I2C length in bytes for I2C transaction that is generated b
the device's CPU, Not available when device is loaded with secured the device's CPU, Not available when device is loaded with secured
firmware firmware
What: /sys/kernel/debug/habanalabs/hl<n>/i2c_reg What: /sys/kernel/debug/accel/<n>/i2c_reg
Date: Jan 2019 Date: Jan 2019
KernelVersion: 5.1 KernelVersion: 5.1
Contact: ogabbay@kernel.org Contact: ogabbay@kernel.org
@ -173,35 +173,35 @@ Description: Sets I2C register id for I2C transaction that is generated by
the device's CPU, Not available when device is loaded with secured the device's CPU, Not available when device is loaded with secured
firmware firmware
What: /sys/kernel/debug/habanalabs/hl<n>/led0 What: /sys/kernel/debug/accel/<n>/led0
Date: Jan 2019 Date: Jan 2019
KernelVersion: 5.1 KernelVersion: 5.1
Contact: ogabbay@kernel.org Contact: ogabbay@kernel.org
Description: Sets the state of the first S/W led on the device, Not available Description: Sets the state of the first S/W led on the device, Not available
when device is loaded with secured firmware when device is loaded with secured firmware
What: /sys/kernel/debug/habanalabs/hl<n>/led1 What: /sys/kernel/debug/accel/<n>/led1
Date: Jan 2019 Date: Jan 2019
KernelVersion: 5.1 KernelVersion: 5.1
Contact: ogabbay@kernel.org Contact: ogabbay@kernel.org
Description: Sets the state of the second S/W led on the device, Not available Description: Sets the state of the second S/W led on the device, Not available
when device is loaded with secured firmware when device is loaded with secured firmware
What: /sys/kernel/debug/habanalabs/hl<n>/led2 What: /sys/kernel/debug/accel/<n>/led2
Date: Jan 2019 Date: Jan 2019
KernelVersion: 5.1 KernelVersion: 5.1
Contact: ogabbay@kernel.org Contact: ogabbay@kernel.org
Description: Sets the state of the third S/W led on the device, Not available Description: Sets the state of the third S/W led on the device, Not available
when device is loaded with secured firmware when device is loaded with secured firmware
What: /sys/kernel/debug/habanalabs/hl<n>/memory_scrub What: /sys/kernel/debug/accel/<n>/memory_scrub
Date: May 2022 Date: May 2022
KernelVersion: 5.19 KernelVersion: 5.19
Contact: dhirschfeld@habana.ai Contact: dhirschfeld@habana.ai
Description: Allows the root user to scrub the dram memory. The scrubbing Description: Allows the root user to scrub the dram memory. The scrubbing
value can be set using the debugfs file memory_scrub_val. value can be set using the debugfs file memory_scrub_val.
What: /sys/kernel/debug/habanalabs/hl<n>/memory_scrub_val What: /sys/kernel/debug/accel/<n>/memory_scrub_val
Date: May 2022 Date: May 2022
KernelVersion: 5.19 KernelVersion: 5.19
Contact: dhirschfeld@habana.ai Contact: dhirschfeld@habana.ai
@ -209,7 +209,7 @@ Description: The value to which the dram will be set to when the user
scrubs the dram using 'memory_scrub' debugfs file and scrubs the dram using 'memory_scrub' debugfs file and
the scrubbing value when using module param 'memory_scrub' the scrubbing value when using module param 'memory_scrub'
What: /sys/kernel/debug/habanalabs/hl<n>/mmu What: /sys/kernel/debug/accel/<n>/mmu
Date: Jan 2019 Date: Jan 2019
KernelVersion: 5.1 KernelVersion: 5.1
Contact: ogabbay@kernel.org Contact: ogabbay@kernel.org
@ -217,19 +217,19 @@ Description: Displays the hop values and physical address for a given ASID
and virtual address. The user should write the ASID and VA into and virtual address. The user should write the ASID and VA into
the file and then read the file to get the result. the file and then read the file to get the result.
e.g. to display info about VA 0x1000 for ASID 1 you need to do: e.g. to display info about VA 0x1000 for ASID 1 you need to do:
echo "1 0x1000" > /sys/kernel/debug/habanalabs/hl0/mmu echo "1 0x1000" > /sys/kernel/debug/accel/0/mmu
What: /sys/kernel/debug/habanalabs/hl<n>/mmu_error What: /sys/kernel/debug/accel/<n>/mmu_error
Date: Mar 2021 Date: Mar 2021
KernelVersion: 5.12 KernelVersion: 5.12
Contact: fkassabri@habana.ai Contact: fkassabri@habana.ai
Description: Check and display page fault or access violation mmu errors for Description: Check and display page fault or access violation mmu errors for
all MMUs specified in mmu_cap_mask. all MMUs specified in mmu_cap_mask.
e.g. to display error info for MMU hw cap bit 9, you need to do: e.g. to display error info for MMU hw cap bit 9, you need to do:
echo "0x200" > /sys/kernel/debug/habanalabs/hl0/mmu_error echo "0x200" > /sys/kernel/debug/accel/0/mmu_error
cat /sys/kernel/debug/habanalabs/hl0/mmu_error cat /sys/kernel/debug/accel/0/mmu_error
What: /sys/kernel/debug/habanalabs/hl<n>/monitor_dump What: /sys/kernel/debug/accel/<n>/monitor_dump
Date: Mar 2022 Date: Mar 2022
KernelVersion: 5.19 KernelVersion: 5.19
Contact: osharabi@habana.ai Contact: osharabi@habana.ai
@ -243,7 +243,7 @@ Description: Allows the root user to dump monitors status from the device's
This interface doesn't support concurrency in the same device. This interface doesn't support concurrency in the same device.
Only supported on GAUDI. Only supported on GAUDI.
What: /sys/kernel/debug/habanalabs/hl<n>/monitor_dump_trig What: /sys/kernel/debug/accel/<n>/monitor_dump_trig
Date: Mar 2022 Date: Mar 2022
KernelVersion: 5.19 KernelVersion: 5.19
Contact: osharabi@habana.ai Contact: osharabi@habana.ai
@ -253,14 +253,14 @@ Description: Triggers dump of monitor data. The value to trigger the operatio
When the write is finished, the user can read the "monitor_dump" When the write is finished, the user can read the "monitor_dump"
blob blob
What: /sys/kernel/debug/habanalabs/hl<n>/set_power_state What: /sys/kernel/debug/accel/<n>/set_power_state
Date: Jan 2019 Date: Jan 2019
KernelVersion: 5.1 KernelVersion: 5.1
Contact: ogabbay@kernel.org Contact: ogabbay@kernel.org
Description: Sets the PCI power state. Valid values are "1" for D0 and "2" Description: Sets the PCI power state. Valid values are "1" for D0 and "2"
for D3Hot for D3Hot
What: /sys/kernel/debug/habanalabs/hl<n>/skip_reset_on_timeout What: /sys/kernel/debug/accel/<n>/skip_reset_on_timeout
Date: Jun 2021 Date: Jun 2021
KernelVersion: 5.13 KernelVersion: 5.13
Contact: ynudelman@habana.ai Contact: ynudelman@habana.ai
@ -268,7 +268,7 @@ Description: Sets the skip reset on timeout option for the device. Value of
"0" means device will be reset in case some CS has timed out, "0" means device will be reset in case some CS has timed out,
otherwise it will not be reset. otherwise it will not be reset.
What: /sys/kernel/debug/habanalabs/hl<n>/state_dump What: /sys/kernel/debug/accel/<n>/state_dump
Date: Oct 2021 Date: Oct 2021
KernelVersion: 5.15 KernelVersion: 5.15
Contact: ynudelman@habana.ai Contact: ynudelman@habana.ai
@ -279,7 +279,7 @@ Description: Gets the state dump occurring on a CS timeout or failure.
Writing an integer X discards X state dumps, so that the Writing an integer X discards X state dumps, so that the
next read would return X+1-st newest state dump. next read would return X+1-st newest state dump.
What: /sys/kernel/debug/habanalabs/hl<n>/stop_on_err What: /sys/kernel/debug/accel/<n>/stop_on_err
Date: Mar 2020 Date: Mar 2020
KernelVersion: 5.6 KernelVersion: 5.6
Contact: ogabbay@kernel.org Contact: ogabbay@kernel.org
@ -287,21 +287,21 @@ Description: Sets the stop-on_error option for the device engines. Value of
"0" is for disable, otherwise enable. "0" is for disable, otherwise enable.
Relevant only for GOYA and GAUDI. Relevant only for GOYA and GAUDI.
What: /sys/kernel/debug/habanalabs/hl<n>/timeout_locked What: /sys/kernel/debug/accel/<n>/timeout_locked
Date: Sep 2021 Date: Sep 2021
KernelVersion: 5.16 KernelVersion: 5.16
Contact: obitton@habana.ai Contact: obitton@habana.ai
Description: Sets the command submission timeout value in seconds. Description: Sets the command submission timeout value in seconds.
What: /sys/kernel/debug/habanalabs/hl<n>/userptr What: /sys/kernel/debug/accel/<n>/userptr
Date: Jan 2019 Date: Jan 2019
KernelVersion: 5.1 KernelVersion: 5.1
Contact: ogabbay@kernel.org Contact: ogabbay@kernel.org
Description: Displays a list with information about the currently user Description: Displays a list with information about the current user
pointers (user virtual addresses) that are pinned and mapped pointers (user virtual addresses) that are pinned and mapped
to DMA addresses to DMA addresses
What: /sys/kernel/debug/habanalabs/hl<n>/userptr_lookup What: /sys/kernel/debug/accel/<n>/userptr_lookup
Date: Oct 2021 Date: Oct 2021
KernelVersion: 5.15 KernelVersion: 5.15
Contact: ogabbay@kernel.org Contact: ogabbay@kernel.org
@ -309,7 +309,7 @@ Description: Allows to search for specific user pointers (user virtual
addresses) that are pinned and mapped to DMA addresses, and see addresses) that are pinned and mapped to DMA addresses, and see
their resolution to the specific dma address. their resolution to the specific dma address.
What: /sys/kernel/debug/habanalabs/hl<n>/vm What: /sys/kernel/debug/accel/<n>/vm
Date: Jan 2019 Date: Jan 2019
KernelVersion: 5.1 KernelVersion: 5.1
Contact: ogabbay@kernel.org Contact: ogabbay@kernel.org