xref: /linux/Documentation/ABI/testing/debugfs-driver-habanalabs (revision be709d48329a500621d2a05835283150ae137b45)
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. The acceptable value is a string that starts with "0x"
7
8What:           /sys/kernel/debug/habanalabs/hl<n>/command_buffers
9Date:           Jan 2019
10KernelVersion:  5.1
11Contact:        oded.gabbay@gmail.com
12Description:    Displays a list with information about the currently allocated
13                command buffers
14
15What:           /sys/kernel/debug/habanalabs/hl<n>/command_submission
16Date:           Jan 2019
17KernelVersion:  5.1
18Contact:        oded.gabbay@gmail.com
19Description:    Displays a list with information about the currently active
20                command submissions
21
22What:           /sys/kernel/debug/habanalabs/hl<n>/command_submission_jobs
23Date:           Jan 2019
24KernelVersion:  5.1
25Contact:        oded.gabbay@gmail.com
26Description:    Displays a list with detailed information about each JOB (CB) of
27                each active command submission
28
29What:           /sys/kernel/debug/habanalabs/hl<n>/data32
30Date:           Jan 2019
31KernelVersion:  5.1
32Contact:        oded.gabbay@gmail.com
33Description:    Allows the root user to read or write directly through the
34                device's PCI bar. Writing to this file generates a write
35                transaction while reading from the file generates a read
36                transcation. This custom interface is needed (instead of using
37                the generic Linux user-space PCI mapping) because the DDR bar
38                is very small compared to the DDR memory and only the driver can
39                move the bar before and after the transaction
40
41What:           /sys/kernel/debug/habanalabs/hl<n>/device
42Date:           Jan 2019
43KernelVersion:  5.1
44Contact:        oded.gabbay@gmail.com
45Description:    Enables the root user to set the device to specific state.
46                Valid values are "disable", "enable", "suspend", "resume".
47                User can read this property to see the valid values
48
49What:           /sys/kernel/debug/habanalabs/hl<n>/i2c_addr
50Date:           Jan 2019
51KernelVersion:  5.1
52Contact:        oded.gabbay@gmail.com
53Description:    Sets I2C device address for I2C transaction that is generated
54                by the device's CPU
55
56What:           /sys/kernel/debug/habanalabs/hl<n>/i2c_bus
57Date:           Jan 2019
58KernelVersion:  5.1
59Contact:        oded.gabbay@gmail.com
60Description:    Sets I2C bus address for I2C transaction that is generated by
61                the device's CPU
62
63What:           /sys/kernel/debug/habanalabs/hl<n>/i2c_data
64Date:           Jan 2019
65KernelVersion:  5.1
66Contact:        oded.gabbay@gmail.com
67Description:    Triggers an I2C transaction that is generated by the device's
68                CPU. Writing to this file generates a write transaction while
69                reading from the file generates a read transcation
70
71What:           /sys/kernel/debug/habanalabs/hl<n>/i2c_reg
72Date:           Jan 2019
73KernelVersion:  5.1
74Contact:        oded.gabbay@gmail.com
75Description:    Sets I2C register id for I2C transaction that is generated by
76                the device's CPU
77
78What:           /sys/kernel/debug/habanalabs/hl<n>/led0
79Date:           Jan 2019
80KernelVersion:  5.1
81Contact:        oded.gabbay@gmail.com
82Description:    Sets the state of the first S/W led on the device
83
84What:           /sys/kernel/debug/habanalabs/hl<n>/led1
85Date:           Jan 2019
86KernelVersion:  5.1
87Contact:        oded.gabbay@gmail.com
88Description:    Sets the state of the second S/W led on the device
89
90What:           /sys/kernel/debug/habanalabs/hl<n>/led2
91Date:           Jan 2019
92KernelVersion:  5.1
93Contact:        oded.gabbay@gmail.com
94Description:    Sets the state of the third S/W led on the device
95
96What:           /sys/kernel/debug/habanalabs/hl<n>/mmu
97Date:           Jan 2019
98KernelVersion:  5.1
99Contact:        oded.gabbay@gmail.com
100Description:    Displays the hop values and physical address for a given ASID
101                and virtual address. The user should write the ASID and VA into
102                the file and then read the file to get the result.
103                e.g. to display info about VA 0x1000 for ASID 1 you need to do:
104                echo "1 0x1000" > /sys/kernel/debug/habanalabs/hl0/mmu
105
106What:           /sys/kernel/debug/habanalabs/hl<n>/set_power_state
107Date:           Jan 2019
108KernelVersion:  5.1
109Contact:        oded.gabbay@gmail.com
110Description:    Sets the PCI power state. Valid values are "1" for D0 and "2"
111                for D3Hot
112
113What:           /sys/kernel/debug/habanalabs/hl<n>/userptr
114Date:           Jan 2019
115KernelVersion:  5.1
116Contact:        oded.gabbay@gmail.com
117Description:    Displays a list with information about the currently user
118                pointers (user virtual addresses) that are pinned and mapped
119                to DMA addresses
120
121What:           /sys/kernel/debug/habanalabs/hl<n>/vm
122Date:           Jan 2019
123KernelVersion:  5.1
124Contact:        oded.gabbay@gmail.com
125Description:    Displays a list with information about all the active virtual
126                address mappings per ASID
127