1What:		/sys/bus/dsa/devices/dsa<m>/version
2Date:		Apr 15, 2020
3KernelVersion:	5.8.0
4Contact:	dmaengine@vger.kernel.org
5Description:	The hardware version number.
6
7What:           /sys/bus/dsa/devices/dsa<m>/cdev_major
8Date:           Oct 25, 2019
9KernelVersion:  5.6.0
10Contact:        dmaengine@vger.kernel.org
11Description:	The major number that the character device driver assigned to
12		this device.
13
14What:           /sys/bus/dsa/devices/dsa<m>/errors
15Date:           Oct 25, 2019
16KernelVersion:  5.6.0
17Contact:        dmaengine@vger.kernel.org
18Description:    The error information for this device.
19
20What:           /sys/bus/dsa/devices/dsa<m>/max_batch_size
21Date:           Oct 25, 2019
22KernelVersion:  5.6.0
23Contact:        dmaengine@vger.kernel.org
24Description:    The largest number of work descriptors in a batch.
25
26What:           /sys/bus/dsa/devices/dsa<m>/max_work_queues_size
27Date:           Oct 25, 2019
28KernelVersion:  5.6.0
29Contact:        dmaengine@vger.kernel.org
30Description:    The maximum work queue size supported by this device.
31
32What:           /sys/bus/dsa/devices/dsa<m>/max_engines
33Date:           Oct 25, 2019
34KernelVersion:  5.6.0
35Contact:        dmaengine@vger.kernel.org
36Description:    The maximum number of engines supported by this device.
37
38What:           /sys/bus/dsa/devices/dsa<m>/max_groups
39Date:           Oct 25, 2019
40KernelVersion:  5.6.0
41Contact:        dmaengine@vger.kernel.org
42Description:    The maximum number of groups can be created under this device.
43
44What:           /sys/bus/dsa/devices/dsa<m>/max_tokens
45Date:           Oct 25, 2019
46KernelVersion:  5.6.0
47Contact:        dmaengine@vger.kernel.org
48Description:    The total number of bandwidth tokens supported by this device.
49		The bandwidth tokens represent resources within the DSA
50		implementation, and these resources are allocated by engines to
51		support operations.
52
53What:           /sys/bus/dsa/devices/dsa<m>/max_transfer_size
54Date:           Oct 25, 2019
55KernelVersion:  5.6.0
56Contact:        dmaengine@vger.kernel.org
57Description:    The number of bytes to be read from the source address to
58		perform the operation. The maximum transfer size is dependent on
59		the workqueue the descriptor was submitted to.
60
61What:           /sys/bus/dsa/devices/dsa<m>/max_work_queues
62Date:           Oct 25, 2019
63KernelVersion:  5.6.0
64Contact:        dmaengine@vger.kernel.org
65Description:    The maximum work queue number that this device supports.
66
67What:           /sys/bus/dsa/devices/dsa<m>/numa_node
68Date:           Oct 25, 2019
69KernelVersion:  5.6.0
70Contact:        dmaengine@vger.kernel.org
71Description:    The numa node number for this device.
72
73What:           /sys/bus/dsa/devices/dsa<m>/op_cap
74Date:           Oct 25, 2019
75KernelVersion:  5.6.0
76Contact:        dmaengine@vger.kernel.org
77Description:    The operation capability bit mask specify the operation types
78		supported by the this device.
79
80What:           /sys/bus/dsa/devices/dsa<m>/state
81Date:           Oct 25, 2019
82KernelVersion:  5.6.0
83Contact:        dmaengine@vger.kernel.org
84Description:    The state information of this device. It can be either enabled
85		or disabled.
86
87What:           /sys/bus/dsa/devices/dsa<m>/group<m>.<n>
88Date:           Oct 25, 2019
89KernelVersion:  5.6.0
90Contact:        dmaengine@vger.kernel.org
91Description:    The assigned group under this device.
92
93What:           /sys/bus/dsa/devices/dsa<m>/engine<m>.<n>
94Date:           Oct 25, 2019
95KernelVersion:  5.6.0
96Contact:        dmaengine@vger.kernel.org
97Description:    The assigned engine under this device.
98
99What:           /sys/bus/dsa/devices/dsa<m>/wq<m>.<n>
100Date:           Oct 25, 2019
101KernelVersion:  5.6.0
102Contact:        dmaengine@vger.kernel.org
103Description:    The assigned work queue under this device.
104
105What:           /sys/bus/dsa/devices/dsa<m>/configurable
106Date:           Oct 25, 2019
107KernelVersion:  5.6.0
108Contact:        dmaengine@vger.kernel.org
109Description:    To indicate if this device is configurable or not.
110
111What:           /sys/bus/dsa/devices/dsa<m>/token_limit
112Date:           Oct 25, 2019
113KernelVersion:  5.6.0
114Contact:        dmaengine@vger.kernel.org
115Description:    The maximum number of bandwidth tokens that may be in use at
116		one time by operations that access low bandwidth memory in the
117		device.
118
119What:		/sys/bus/dsa/devices/dsa<m>/cmd_status
120Date:		Aug 28, 2020
121KernelVersion:	5.10.0
122Contact:	dmaengine@vger.kernel.org
123Description:	The last executed device administrative command's status/error.
124
125What:           /sys/bus/dsa/devices/wq<m>.<n>/group_id
126Date:           Oct 25, 2019
127KernelVersion:  5.6.0
128Contact:        dmaengine@vger.kernel.org
129Description:    The group id that this work queue belongs to.
130
131What:           /sys/bus/dsa/devices/wq<m>.<n>/size
132Date:           Oct 25, 2019
133KernelVersion:  5.6.0
134Contact:        dmaengine@vger.kernel.org
135Description:    The work queue size for this work queue.
136
137What:           /sys/bus/dsa/devices/wq<m>.<n>/type
138Date:           Oct 25, 2019
139KernelVersion:  5.6.0
140Contact:        dmaengine@vger.kernel.org
141Description:    The type of this work queue, it can be "kernel" type for work
142		queue usages in the kernel space or "user" type for work queue
143		usages by applications in user space.
144
145What:           /sys/bus/dsa/devices/wq<m>.<n>/cdev_minor
146Date:           Oct 25, 2019
147KernelVersion:  5.6.0
148Contact:        dmaengine@vger.kernel.org
149Description:    The minor number assigned to this work queue by the character
150		device driver.
151
152What:           /sys/bus/dsa/devices/wq<m>.<n>/mode
153Date:           Oct 25, 2019
154KernelVersion:  5.6.0
155Contact:        dmaengine@vger.kernel.org
156Description:    The work queue mode type for this work queue.
157
158What:           /sys/bus/dsa/devices/wq<m>.<n>/priority
159Date:           Oct 25, 2019
160KernelVersion:  5.6.0
161Contact:        dmaengine@vger.kernel.org
162Description:    The priority value of this work queue, it is a vlue relative to
163		other work queue in the same group to control quality of service
164		for dispatching work from multiple workqueues in the same group.
165
166What:           /sys/bus/dsa/devices/wq<m>.<n>/state
167Date:           Oct 25, 2019
168KernelVersion:  5.6.0
169Contact:        dmaengine@vger.kernel.org
170Description:    The current state of the work queue.
171
172What:           /sys/bus/dsa/devices/wq<m>.<n>/threshold
173Date:           Oct 25, 2019
174KernelVersion:  5.6.0
175Contact:        dmaengine@vger.kernel.org
176Description:    The number of entries in this work queue that may be filled
177		via a limited portal.
178
179What:		/sys/bus/dsa/devices/wq<m>.<n>/max_transfer_size
180Date:		Aug 28, 2020
181KernelVersion:	5.10.0
182Contact:	dmaengine@vger.kernel.org
183Description:	The max transfer sized for this workqueue. Cannot exceed device
184		max transfer size. Configurable parameter.
185
186What:		/sys/bus/dsa/devices/wq<m>.<n>/max_batch_size
187Date:		Aug 28, 2020
188KernelVersion:	5.10.0
189Contact:	dmaengine@vger.kernel.org
190Description:	The max batch size for this workqueue. Cannot exceed device
191		max batch size. Configurable parameter.
192
193What:           /sys/bus/dsa/devices/engine<m>.<n>/group_id
194Date:           Oct 25, 2019
195KernelVersion:  5.6.0
196Contact:        dmaengine@vger.kernel.org
197Description:    The group that this engine belongs to.
198