177522b21SDave JiangWhat: /sys/bus/dsa/devices/dsa<m>/version 2c2ce6bbcSDave JiangDate: Apr 15, 2020 3c2ce6bbcSDave JiangKernelVersion: 5.8.0 4c2ce6bbcSDave JiangContact: dmaengine@vger.kernel.org 5c2ce6bbcSDave JiangDescription: The hardware version number. 6c2ce6bbcSDave Jiang 777522b21SDave JiangWhat: /sys/bus/dsa/devices/dsa<m>/cdev_major 8b131ad59SJing LinDate: Oct 25, 2019 9b131ad59SJing LinKernelVersion: 5.6.0 10b131ad59SJing LinContact: dmaengine@vger.kernel.org 11b131ad59SJing LinDescription: The major number that the character device driver assigned to 12b131ad59SJing Lin this device. 13b131ad59SJing Lin 1477522b21SDave JiangWhat: /sys/bus/dsa/devices/dsa<m>/errors 15b131ad59SJing LinDate: Oct 25, 2019 16b131ad59SJing LinKernelVersion: 5.6.0 17b131ad59SJing LinContact: dmaengine@vger.kernel.org 18b131ad59SJing LinDescription: The error information for this device. 19b131ad59SJing Lin 2077522b21SDave JiangWhat: /sys/bus/dsa/devices/dsa<m>/max_batch_size 21b131ad59SJing LinDate: Oct 25, 2019 22b131ad59SJing LinKernelVersion: 5.6.0 23b131ad59SJing LinContact: dmaengine@vger.kernel.org 24b131ad59SJing LinDescription: The largest number of work descriptors in a batch. 25*91123b37SXiaochen Shen It's not visible when the device does not support batch. 26b131ad59SJing Lin 2777522b21SDave JiangWhat: /sys/bus/dsa/devices/dsa<m>/max_work_queues_size 28b131ad59SJing LinDate: Oct 25, 2019 29b131ad59SJing LinKernelVersion: 5.6.0 30b131ad59SJing LinContact: dmaengine@vger.kernel.org 31b131ad59SJing LinDescription: The maximum work queue size supported by this device. 32b131ad59SJing Lin 3377522b21SDave JiangWhat: /sys/bus/dsa/devices/dsa<m>/max_engines 34b131ad59SJing LinDate: Oct 25, 2019 35b131ad59SJing LinKernelVersion: 5.6.0 36b131ad59SJing LinContact: dmaengine@vger.kernel.org 37b131ad59SJing LinDescription: The maximum number of engines supported by this device. 38b131ad59SJing Lin 3977522b21SDave JiangWhat: /sys/bus/dsa/devices/dsa<m>/max_groups 40b131ad59SJing LinDate: Oct 25, 2019 41b131ad59SJing LinKernelVersion: 5.6.0 42b131ad59SJing LinContact: dmaengine@vger.kernel.org 43b131ad59SJing LinDescription: The maximum number of groups can be created under this device. 44b131ad59SJing Lin 45fde212e4SDave JiangWhat: /sys/bus/dsa/devices/dsa<m>/max_read_buffers 46fde212e4SDave JiangDate: Dec 10, 2021 47fde212e4SDave JiangKernelVersion: 5.17.0 48b131ad59SJing LinContact: dmaengine@vger.kernel.org 49fde212e4SDave JiangDescription: The total number of read buffers supported by this device. 50fde212e4SDave Jiang The read buffers represent resources within the DSA 51b131ad59SJing Lin implementation, and these resources are allocated by engines to 52fde212e4SDave Jiang support operations. See DSA spec v1.2 9.2.4 Total Read Buffers. 53b131ad59SJing Lin 5477522b21SDave JiangWhat: /sys/bus/dsa/devices/dsa<m>/max_transfer_size 55b131ad59SJing LinDate: Oct 25, 2019 56b131ad59SJing LinKernelVersion: 5.6.0 57b131ad59SJing LinContact: dmaengine@vger.kernel.org 58b131ad59SJing LinDescription: The number of bytes to be read from the source address to 59b131ad59SJing Lin perform the operation. The maximum transfer size is dependent on 60b131ad59SJing Lin the workqueue the descriptor was submitted to. 61b131ad59SJing Lin 6277522b21SDave JiangWhat: /sys/bus/dsa/devices/dsa<m>/max_work_queues 63b131ad59SJing LinDate: Oct 25, 2019 64b131ad59SJing LinKernelVersion: 5.6.0 65b131ad59SJing LinContact: dmaengine@vger.kernel.org 66b131ad59SJing LinDescription: The maximum work queue number that this device supports. 67b131ad59SJing Lin 6877522b21SDave JiangWhat: /sys/bus/dsa/devices/dsa<m>/numa_node 69b131ad59SJing LinDate: Oct 25, 2019 70b131ad59SJing LinKernelVersion: 5.6.0 71b131ad59SJing LinContact: dmaengine@vger.kernel.org 72b131ad59SJing LinDescription: The numa node number for this device. 73b131ad59SJing Lin 7477522b21SDave JiangWhat: /sys/bus/dsa/devices/dsa<m>/op_cap 75b131ad59SJing LinDate: Oct 25, 2019 76b131ad59SJing LinKernelVersion: 5.6.0 77b131ad59SJing LinContact: dmaengine@vger.kernel.org 78b131ad59SJing LinDescription: The operation capability bit mask specify the operation types 79b131ad59SJing Lin supported by the this device. 80b131ad59SJing Lin 814749f51dSDave JiangWhat: /sys/bus/dsa/devices/dsa<m>/pasid_enabled 824749f51dSDave JiangDate: Oct 27, 2020 834749f51dSDave JiangKernelVersion: 5.11.0 844749f51dSDave JiangContact: dmaengine@vger.kernel.org 854749f51dSDave JiangDescription: To indicate if PASID (process address space identifier) is 864749f51dSDave Jiang enabled or not for this device. 874749f51dSDave Jiang 8877522b21SDave JiangWhat: /sys/bus/dsa/devices/dsa<m>/state 89b131ad59SJing LinDate: Oct 25, 2019 90b131ad59SJing LinKernelVersion: 5.6.0 91b131ad59SJing LinContact: dmaengine@vger.kernel.org 92b131ad59SJing LinDescription: The state information of this device. It can be either enabled 93b131ad59SJing Lin or disabled. 94b131ad59SJing Lin 9577522b21SDave JiangWhat: /sys/bus/dsa/devices/dsa<m>/group<m>.<n> 96b131ad59SJing LinDate: Oct 25, 2019 97b131ad59SJing LinKernelVersion: 5.6.0 98b131ad59SJing LinContact: dmaengine@vger.kernel.org 99b131ad59SJing LinDescription: The assigned group under this device. 100b131ad59SJing Lin 10177522b21SDave JiangWhat: /sys/bus/dsa/devices/dsa<m>/engine<m>.<n> 102b131ad59SJing LinDate: Oct 25, 2019 103b131ad59SJing LinKernelVersion: 5.6.0 104b131ad59SJing LinContact: dmaengine@vger.kernel.org 105b131ad59SJing LinDescription: The assigned engine under this device. 106b131ad59SJing Lin 10777522b21SDave JiangWhat: /sys/bus/dsa/devices/dsa<m>/wq<m>.<n> 108b131ad59SJing LinDate: Oct 25, 2019 109b131ad59SJing LinKernelVersion: 5.6.0 110b131ad59SJing LinContact: dmaengine@vger.kernel.org 111b131ad59SJing LinDescription: The assigned work queue under this device. 112b131ad59SJing Lin 11377522b21SDave JiangWhat: /sys/bus/dsa/devices/dsa<m>/configurable 114b131ad59SJing LinDate: Oct 25, 2019 115b131ad59SJing LinKernelVersion: 5.6.0 116b131ad59SJing LinContact: dmaengine@vger.kernel.org 117b131ad59SJing LinDescription: To indicate if this device is configurable or not. 118b131ad59SJing Lin 119fde212e4SDave JiangWhat: /sys/bus/dsa/devices/dsa<m>/read_buffer_limit 120fde212e4SDave JiangDate: Dec 10, 2021 121fde212e4SDave JiangKernelVersion: 5.17.0 122b131ad59SJing LinContact: dmaengine@vger.kernel.org 123fde212e4SDave JiangDescription: The maximum number of read buffers that may be in use at 124b131ad59SJing Lin one time by operations that access low bandwidth memory in the 125fde212e4SDave Jiang device. See DSA spec v1.2 9.2.8 GENCFG on Global Read Buffer Limit. 126b131ad59SJing Lin 127ff18de55SDave JiangWhat: /sys/bus/dsa/devices/dsa<m>/cmd_status 128ff18de55SDave JiangDate: Aug 28, 2020 129ff18de55SDave JiangKernelVersion: 5.10.0 130ff18de55SDave JiangContact: dmaengine@vger.kernel.org 131ff18de55SDave JiangDescription: The last executed device administrative command's status/error. 132125d1037SDave Jiang Also last configuration error overloaded. 133125d1037SDave Jiang Writing to it will clear the status. 134ff18de55SDave Jiang 1354749f51dSDave JiangWhat: /sys/bus/dsa/devices/wq<m>.<n>/block_on_fault 1364749f51dSDave JiangDate: Oct 27, 2020 1374749f51dSDave JiangKernelVersion: 5.11.0 1384749f51dSDave JiangContact: dmaengine@vger.kernel.org 1394749f51dSDave JiangDescription: To indicate block on fault is allowed or not for the work queue 1404749f51dSDave Jiang to support on demand paging. 1414749f51dSDave Jiang 14277522b21SDave JiangWhat: /sys/bus/dsa/devices/wq<m>.<n>/group_id 143b131ad59SJing LinDate: Oct 25, 2019 144b131ad59SJing LinKernelVersion: 5.6.0 145b131ad59SJing LinContact: dmaengine@vger.kernel.org 146b131ad59SJing LinDescription: The group id that this work queue belongs to. 147b131ad59SJing Lin 14877522b21SDave JiangWhat: /sys/bus/dsa/devices/wq<m>.<n>/size 149b131ad59SJing LinDate: Oct 25, 2019 150b131ad59SJing LinKernelVersion: 5.6.0 151b131ad59SJing LinContact: dmaengine@vger.kernel.org 152b131ad59SJing LinDescription: The work queue size for this work queue. 153b131ad59SJing Lin 15477522b21SDave JiangWhat: /sys/bus/dsa/devices/wq<m>.<n>/type 155b131ad59SJing LinDate: Oct 25, 2019 156b131ad59SJing LinKernelVersion: 5.6.0 157b131ad59SJing LinContact: dmaengine@vger.kernel.org 158b131ad59SJing LinDescription: The type of this work queue, it can be "kernel" type for work 159b131ad59SJing Lin queue usages in the kernel space or "user" type for work queue 160b131ad59SJing Lin usages by applications in user space. 161b131ad59SJing Lin 16277522b21SDave JiangWhat: /sys/bus/dsa/devices/wq<m>.<n>/cdev_minor 163b131ad59SJing LinDate: Oct 25, 2019 164b131ad59SJing LinKernelVersion: 5.6.0 165b131ad59SJing LinContact: dmaengine@vger.kernel.org 166b131ad59SJing LinDescription: The minor number assigned to this work queue by the character 167b131ad59SJing Lin device driver. 168b131ad59SJing Lin 16977522b21SDave JiangWhat: /sys/bus/dsa/devices/wq<m>.<n>/mode 170b131ad59SJing LinDate: Oct 25, 2019 171b131ad59SJing LinKernelVersion: 5.6.0 172b131ad59SJing LinContact: dmaengine@vger.kernel.org 173b131ad59SJing LinDescription: The work queue mode type for this work queue. 174b131ad59SJing Lin 17577522b21SDave JiangWhat: /sys/bus/dsa/devices/wq<m>.<n>/priority 176b131ad59SJing LinDate: Oct 25, 2019 177b131ad59SJing LinKernelVersion: 5.6.0 178b131ad59SJing LinContact: dmaengine@vger.kernel.org 1793e42d1deSCarlos BilbaoDescription: The priority value of this work queue, it is a value relative to 180b131ad59SJing Lin other work queue in the same group to control quality of service 181b131ad59SJing Lin for dispatching work from multiple workqueues in the same group. 182b131ad59SJing Lin 18377522b21SDave JiangWhat: /sys/bus/dsa/devices/wq<m>.<n>/state 184b131ad59SJing LinDate: Oct 25, 2019 185b131ad59SJing LinKernelVersion: 5.6.0 186b131ad59SJing LinContact: dmaengine@vger.kernel.org 187b131ad59SJing LinDescription: The current state of the work queue. 188b131ad59SJing Lin 18977522b21SDave JiangWhat: /sys/bus/dsa/devices/wq<m>.<n>/threshold 190b131ad59SJing LinDate: Oct 25, 2019 191b131ad59SJing LinKernelVersion: 5.6.0 192b131ad59SJing LinContact: dmaengine@vger.kernel.org 193b131ad59SJing LinDescription: The number of entries in this work queue that may be filled 194b131ad59SJing Lin via a limited portal. 195b131ad59SJing Lin 196d7aad555SDave JiangWhat: /sys/bus/dsa/devices/wq<m>.<n>/max_transfer_size 197d7aad555SDave JiangDate: Aug 28, 2020 198d7aad555SDave JiangKernelVersion: 5.10.0 199d7aad555SDave JiangContact: dmaengine@vger.kernel.org 200d7aad555SDave JiangDescription: The max transfer sized for this workqueue. Cannot exceed device 201d7aad555SDave Jiang max transfer size. Configurable parameter. 202d7aad555SDave Jiang 203e7184b15SDave JiangWhat: /sys/bus/dsa/devices/wq<m>.<n>/max_batch_size 204e7184b15SDave JiangDate: Aug 28, 2020 205e7184b15SDave JiangKernelVersion: 5.10.0 206e7184b15SDave JiangContact: dmaengine@vger.kernel.org 207e7184b15SDave JiangDescription: The max batch size for this workqueue. Cannot exceed device 208e7184b15SDave Jiang max batch size. Configurable parameter. 209*91123b37SXiaochen Shen It's not visible when the device does not support batch. 210e7184b15SDave Jiang 21192de5fa2SDave JiangWhat: /sys/bus/dsa/devices/wq<m>.<n>/ats_disable 21292de5fa2SDave JiangDate: Nov 13, 2020 21392de5fa2SDave JiangKernelVersion: 5.11.0 21492de5fa2SDave JiangContact: dmaengine@vger.kernel.org 21592de5fa2SDave JiangDescription: Indicate whether ATS disable is turned on for the workqueue. 21692de5fa2SDave Jiang 0 indicates ATS is on, and 1 indicates ATS is off for the workqueue. 21792de5fa2SDave Jiang 218e753a64bSDave JiangWhat: /sys/bus/dsa/devices/wq<m>.<n>/occupancy 219e753a64bSDave JiangDate May 25, 2021 220e753a64bSDave JiangKernelVersion: 5.14.0 221e753a64bSDave JiangContact: dmaengine@vger.kernel.org 222e753a64bSDave JiangDescription: Show the current number of entries in this WQ if WQ Occupancy 223e753a64bSDave Jiang Support bit WQ capabilities is 1. 224e753a64bSDave Jiang 2257930d855SDave JiangWhat: /sys/bus/dsa/devices/wq<m>.<n>/enqcmds_retries 2267930d855SDave JiangDate Oct 29, 2021 2277930d855SDave JiangKernelVersion: 5.17.0 2287930d855SDave JiangContact: dmaengine@vger.kernel.org 2297930d855SDave JiangDescription: Indicate the number of retires for an enqcmds submission on a sharedwq. 2307930d855SDave Jiang A max value to set attribute is capped at 64. 2317930d855SDave Jiang 232b0325aefSDave JiangWhat: /sys/bus/dsa/devices/wq<m>.<n>/op_config 233b0325aefSDave JiangDate: Sept 14, 2022 234b0325aefSDave JiangKernelVersion: 6.0.0 235b0325aefSDave JiangContact: dmaengine@vger.kernel.org 236b0325aefSDave JiangDescription: Shows the operation capability bits displayed in bitmap format 237b0325aefSDave Jiang presented by %*pb printk() output format specifier. 238b0325aefSDave Jiang The attribute can be configured when the WQ is disabled in 239b0325aefSDave Jiang order to configure the WQ to accept specific bits that 240b0325aefSDave Jiang correlates to the operations allowed. It's visible only 241b0325aefSDave Jiang on platforms that support the capability. 242b0325aefSDave Jiang 24377522b21SDave JiangWhat: /sys/bus/dsa/devices/engine<m>.<n>/group_id 244b131ad59SJing LinDate: Oct 25, 2019 245b131ad59SJing LinKernelVersion: 5.6.0 246b131ad59SJing LinContact: dmaengine@vger.kernel.org 247b131ad59SJing LinDescription: The group that this engine belongs to. 248fde212e4SDave Jiang 249fde212e4SDave JiangWhat: /sys/bus/dsa/devices/group<m>.<n>/use_read_buffer_limit 250fde212e4SDave JiangDate: Dec 10, 2021 251fde212e4SDave JiangKernelVersion: 5.17.0 252fde212e4SDave JiangContact: dmaengine@vger.kernel.org 253fde212e4SDave JiangDescription: Enable the use of global read buffer limit for the group. See DSA 254fde212e4SDave Jiang spec v1.2 9.2.18 GRPCFG Use Global Read Buffer Limit. 255fde212e4SDave Jiang 256fde212e4SDave JiangWhat: /sys/bus/dsa/devices/group<m>.<n>/read_buffers_allowed 257fde212e4SDave JiangDate: Dec 10, 2021 258fde212e4SDave JiangKernelVersion: 5.17.0 259fde212e4SDave JiangContact: dmaengine@vger.kernel.org 260fde212e4SDave JiangDescription: Indicates max number of read buffers that may be in use at one time 261fde212e4SDave Jiang by all engines in the group. See DSA spec v1.2 9.2.18 GRPCFG Read 262fde212e4SDave Jiang Buffers Allowed. 263fde212e4SDave Jiang 264fde212e4SDave JiangWhat: /sys/bus/dsa/devices/group<m>.<n>/read_buffers_reserved 265fde212e4SDave JiangDate: Dec 10, 2021 266fde212e4SDave JiangKernelVersion: 5.17.0 267fde212e4SDave JiangContact: dmaengine@vger.kernel.org 268fde212e4SDave JiangDescription: Indicates the number of Read Buffers reserved for the use of 269fde212e4SDave Jiang engines in the group. See DSA spec v1.2 9.2.18 GRPCFG Read Buffers 270fde212e4SDave Jiang Reserved. 2711f273752SDave Jiang 2721f273752SDave JiangWhat: /sys/bus/dsa/devices/group<m>.<n>/desc_progress_limit 2731f273752SDave JiangDate: Sept 14, 2022 2741f273752SDave JiangKernelVersion: 6.0.0 2751f273752SDave JiangContact: dmaengine@vger.kernel.org 2761f273752SDave JiangDescription: Allows control of the number of work descriptors that can be 2771f273752SDave Jiang concurrently processed by an engine in the group as a fraction 2781f273752SDave Jiang of the Maximum Work Descriptors in Progress value specified in 2791f273752SDave Jiang the ENGCAP register. The acceptable values are 0 (default), 2801f273752SDave Jiang 1 (1/2 of max value), 2 (1/4 of the max value), and 3 (1/8 of 2811f273752SDave Jiang the max value). It's visible only on platforms that support 2821f273752SDave Jiang the capability. 2837ca68fa3SDave Jiang 2847ca68fa3SDave JiangWhat: /sys/bus/dsa/devices/group<m>.<n>/batch_progress_limit 2857ca68fa3SDave JiangDate: Sept 14, 2022 2867ca68fa3SDave JiangKernelVersion: 6.0.0 2877ca68fa3SDave JiangContact: dmaengine@vger.kernel.org 2887ca68fa3SDave JiangDescription: Allows control of the number of batch descriptors that can be 2897ca68fa3SDave Jiang concurrently processed by an engine in the group as a fraction 2907ca68fa3SDave Jiang of the Maximum Batch Descriptors in Progress value specified in 2917ca68fa3SDave Jiang the ENGCAP register. The acceptable values are 0 (default), 2927ca68fa3SDave Jiang 1 (1/2 of max value), 2 (1/4 of the max value), and 3 (1/8 of 2937ca68fa3SDave Jiang the max value). It's visible only on platforms that support 2947ca68fa3SDave Jiang the capability. 295