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. 2591123b37SXiaochen 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. 539a8ddb35SXiaochen Shen It's not visible when the device does not support Read Buffer 549a8ddb35SXiaochen Shen allocation control. 55b131ad59SJing Lin 5677522b21SDave JiangWhat: /sys/bus/dsa/devices/dsa<m>/max_transfer_size 57b131ad59SJing LinDate: Oct 25, 2019 58b131ad59SJing LinKernelVersion: 5.6.0 59b131ad59SJing LinContact: dmaengine@vger.kernel.org 60b131ad59SJing LinDescription: The number of bytes to be read from the source address to 61b131ad59SJing Lin perform the operation. The maximum transfer size is dependent on 62b131ad59SJing Lin the workqueue the descriptor was submitted to. 63b131ad59SJing Lin 6477522b21SDave JiangWhat: /sys/bus/dsa/devices/dsa<m>/max_work_queues 65b131ad59SJing LinDate: Oct 25, 2019 66b131ad59SJing LinKernelVersion: 5.6.0 67b131ad59SJing LinContact: dmaengine@vger.kernel.org 68b131ad59SJing LinDescription: The maximum work queue number that this device supports. 69b131ad59SJing Lin 7077522b21SDave JiangWhat: /sys/bus/dsa/devices/dsa<m>/numa_node 71b131ad59SJing LinDate: Oct 25, 2019 72b131ad59SJing LinKernelVersion: 5.6.0 73b131ad59SJing LinContact: dmaengine@vger.kernel.org 74b131ad59SJing LinDescription: The numa node number for this device. 75b131ad59SJing Lin 7677522b21SDave JiangWhat: /sys/bus/dsa/devices/dsa<m>/op_cap 77b131ad59SJing LinDate: Oct 25, 2019 78b131ad59SJing LinKernelVersion: 5.6.0 79b131ad59SJing LinContact: dmaengine@vger.kernel.org 80b131ad59SJing LinDescription: The operation capability bit mask specify the operation types 81b131ad59SJing Lin supported by the this device. 82b131ad59SJing Lin 834749f51dSDave JiangWhat: /sys/bus/dsa/devices/dsa<m>/pasid_enabled 844749f51dSDave JiangDate: Oct 27, 2020 854749f51dSDave JiangKernelVersion: 5.11.0 864749f51dSDave JiangContact: dmaengine@vger.kernel.org 874749f51dSDave JiangDescription: To indicate if PASID (process address space identifier) is 884749f51dSDave Jiang enabled or not for this device. 894749f51dSDave Jiang 9077522b21SDave JiangWhat: /sys/bus/dsa/devices/dsa<m>/state 91b131ad59SJing LinDate: Oct 25, 2019 92b131ad59SJing LinKernelVersion: 5.6.0 93b131ad59SJing LinContact: dmaengine@vger.kernel.org 94b131ad59SJing LinDescription: The state information of this device. It can be either enabled 95b131ad59SJing Lin or disabled. 96b131ad59SJing Lin 9777522b21SDave JiangWhat: /sys/bus/dsa/devices/dsa<m>/group<m>.<n> 98b131ad59SJing LinDate: Oct 25, 2019 99b131ad59SJing LinKernelVersion: 5.6.0 100b131ad59SJing LinContact: dmaengine@vger.kernel.org 101b131ad59SJing LinDescription: The assigned group under this device. 102b131ad59SJing Lin 10377522b21SDave JiangWhat: /sys/bus/dsa/devices/dsa<m>/engine<m>.<n> 104b131ad59SJing LinDate: Oct 25, 2019 105b131ad59SJing LinKernelVersion: 5.6.0 106b131ad59SJing LinContact: dmaengine@vger.kernel.org 107b131ad59SJing LinDescription: The assigned engine under this device. 108b131ad59SJing Lin 10977522b21SDave JiangWhat: /sys/bus/dsa/devices/dsa<m>/wq<m>.<n> 110b131ad59SJing LinDate: Oct 25, 2019 111b131ad59SJing LinKernelVersion: 5.6.0 112b131ad59SJing LinContact: dmaengine@vger.kernel.org 113b131ad59SJing LinDescription: The assigned work queue under this device. 114b131ad59SJing Lin 11577522b21SDave JiangWhat: /sys/bus/dsa/devices/dsa<m>/configurable 116b131ad59SJing LinDate: Oct 25, 2019 117b131ad59SJing LinKernelVersion: 5.6.0 118b131ad59SJing LinContact: dmaengine@vger.kernel.org 119b131ad59SJing LinDescription: To indicate if this device is configurable or not. 120b131ad59SJing Lin 121fde212e4SDave JiangWhat: /sys/bus/dsa/devices/dsa<m>/read_buffer_limit 122fde212e4SDave JiangDate: Dec 10, 2021 123fde212e4SDave JiangKernelVersion: 5.17.0 124b131ad59SJing LinContact: dmaengine@vger.kernel.org 125fde212e4SDave JiangDescription: The maximum number of read buffers that may be in use at 126b131ad59SJing Lin one time by operations that access low bandwidth memory in the 127fde212e4SDave Jiang device. See DSA spec v1.2 9.2.8 GENCFG on Global Read Buffer Limit. 1289a8ddb35SXiaochen Shen It's not visible when the device does not support Read Buffer 1299a8ddb35SXiaochen Shen allocation control. 130b131ad59SJing Lin 131ff18de55SDave JiangWhat: /sys/bus/dsa/devices/dsa<m>/cmd_status 132ff18de55SDave JiangDate: Aug 28, 2020 133ff18de55SDave JiangKernelVersion: 5.10.0 134ff18de55SDave JiangContact: dmaengine@vger.kernel.org 135ff18de55SDave JiangDescription: The last executed device administrative command's status/error. 136125d1037SDave Jiang Also last configuration error overloaded. 137125d1037SDave Jiang Writing to it will clear the status. 138ff18de55SDave Jiang 139*9f0d99b3SDave JiangWhat: /sys/bus/dsa/devices/dsa<m>/iaa_cap 140*9f0d99b3SDave JiangDate: Sept 14, 2022 141*9f0d99b3SDave JiangKernelVersion: 6.0.0 142*9f0d99b3SDave JiangContact: dmaengine@vger.kernel.org 143*9f0d99b3SDave JiangDescription: IAA (IAX) capability mask. Exported to user space for application 144*9f0d99b3SDave Jiang consumption. This attribute should only be visible on IAA devices 145*9f0d99b3SDave Jiang that are version 2 or later. 146*9f0d99b3SDave Jiang 1474749f51dSDave JiangWhat: /sys/bus/dsa/devices/wq<m>.<n>/block_on_fault 1484749f51dSDave JiangDate: Oct 27, 2020 1494749f51dSDave JiangKernelVersion: 5.11.0 1504749f51dSDave JiangContact: dmaengine@vger.kernel.org 1514749f51dSDave JiangDescription: To indicate block on fault is allowed or not for the work queue 1524749f51dSDave Jiang to support on demand paging. 1534749f51dSDave Jiang 15477522b21SDave JiangWhat: /sys/bus/dsa/devices/wq<m>.<n>/group_id 155b131ad59SJing LinDate: Oct 25, 2019 156b131ad59SJing LinKernelVersion: 5.6.0 157b131ad59SJing LinContact: dmaengine@vger.kernel.org 158b131ad59SJing LinDescription: The group id that this work queue belongs to. 159b131ad59SJing Lin 16077522b21SDave JiangWhat: /sys/bus/dsa/devices/wq<m>.<n>/size 161b131ad59SJing LinDate: Oct 25, 2019 162b131ad59SJing LinKernelVersion: 5.6.0 163b131ad59SJing LinContact: dmaengine@vger.kernel.org 164b131ad59SJing LinDescription: The work queue size for this work queue. 165b131ad59SJing Lin 16677522b21SDave JiangWhat: /sys/bus/dsa/devices/wq<m>.<n>/type 167b131ad59SJing LinDate: Oct 25, 2019 168b131ad59SJing LinKernelVersion: 5.6.0 169b131ad59SJing LinContact: dmaengine@vger.kernel.org 170b131ad59SJing LinDescription: The type of this work queue, it can be "kernel" type for work 171b131ad59SJing Lin queue usages in the kernel space or "user" type for work queue 172b131ad59SJing Lin usages by applications in user space. 173b131ad59SJing Lin 17477522b21SDave JiangWhat: /sys/bus/dsa/devices/wq<m>.<n>/cdev_minor 175b131ad59SJing LinDate: Oct 25, 2019 176b131ad59SJing LinKernelVersion: 5.6.0 177b131ad59SJing LinContact: dmaengine@vger.kernel.org 178b131ad59SJing LinDescription: The minor number assigned to this work queue by the character 179b131ad59SJing Lin device driver. 180b131ad59SJing Lin 18177522b21SDave JiangWhat: /sys/bus/dsa/devices/wq<m>.<n>/mode 182b131ad59SJing LinDate: Oct 25, 2019 183b131ad59SJing LinKernelVersion: 5.6.0 184b131ad59SJing LinContact: dmaengine@vger.kernel.org 185b131ad59SJing LinDescription: The work queue mode type for this work queue. 186b131ad59SJing Lin 18777522b21SDave JiangWhat: /sys/bus/dsa/devices/wq<m>.<n>/priority 188b131ad59SJing LinDate: Oct 25, 2019 189b131ad59SJing LinKernelVersion: 5.6.0 190b131ad59SJing LinContact: dmaengine@vger.kernel.org 1913e42d1deSCarlos BilbaoDescription: The priority value of this work queue, it is a value relative to 192b131ad59SJing Lin other work queue in the same group to control quality of service 193b131ad59SJing Lin for dispatching work from multiple workqueues in the same group. 194b131ad59SJing Lin 19577522b21SDave JiangWhat: /sys/bus/dsa/devices/wq<m>.<n>/state 196b131ad59SJing LinDate: Oct 25, 2019 197b131ad59SJing LinKernelVersion: 5.6.0 198b131ad59SJing LinContact: dmaengine@vger.kernel.org 199b131ad59SJing LinDescription: The current state of the work queue. 200b131ad59SJing Lin 20177522b21SDave JiangWhat: /sys/bus/dsa/devices/wq<m>.<n>/threshold 202b131ad59SJing LinDate: Oct 25, 2019 203b131ad59SJing LinKernelVersion: 5.6.0 204b131ad59SJing LinContact: dmaengine@vger.kernel.org 205b131ad59SJing LinDescription: The number of entries in this work queue that may be filled 206b131ad59SJing Lin via a limited portal. 207b131ad59SJing Lin 208d7aad555SDave JiangWhat: /sys/bus/dsa/devices/wq<m>.<n>/max_transfer_size 209d7aad555SDave JiangDate: Aug 28, 2020 210d7aad555SDave JiangKernelVersion: 5.10.0 211d7aad555SDave JiangContact: dmaengine@vger.kernel.org 212d7aad555SDave JiangDescription: The max transfer sized for this workqueue. Cannot exceed device 213d7aad555SDave Jiang max transfer size. Configurable parameter. 214d7aad555SDave Jiang 215e7184b15SDave JiangWhat: /sys/bus/dsa/devices/wq<m>.<n>/max_batch_size 216e7184b15SDave JiangDate: Aug 28, 2020 217e7184b15SDave JiangKernelVersion: 5.10.0 218e7184b15SDave JiangContact: dmaengine@vger.kernel.org 219e7184b15SDave JiangDescription: The max batch size for this workqueue. Cannot exceed device 220e7184b15SDave Jiang max batch size. Configurable parameter. 22191123b37SXiaochen Shen It's not visible when the device does not support batch. 222e7184b15SDave Jiang 22392de5fa2SDave JiangWhat: /sys/bus/dsa/devices/wq<m>.<n>/ats_disable 22492de5fa2SDave JiangDate: Nov 13, 2020 22592de5fa2SDave JiangKernelVersion: 5.11.0 22692de5fa2SDave JiangContact: dmaengine@vger.kernel.org 22792de5fa2SDave JiangDescription: Indicate whether ATS disable is turned on for the workqueue. 22892de5fa2SDave Jiang 0 indicates ATS is on, and 1 indicates ATS is off for the workqueue. 22992de5fa2SDave Jiang 230e753a64bSDave JiangWhat: /sys/bus/dsa/devices/wq<m>.<n>/occupancy 231e753a64bSDave JiangDate May 25, 2021 232e753a64bSDave JiangKernelVersion: 5.14.0 233e753a64bSDave JiangContact: dmaengine@vger.kernel.org 234e753a64bSDave JiangDescription: Show the current number of entries in this WQ if WQ Occupancy 235e753a64bSDave Jiang Support bit WQ capabilities is 1. 236e753a64bSDave Jiang 2377930d855SDave JiangWhat: /sys/bus/dsa/devices/wq<m>.<n>/enqcmds_retries 2387930d855SDave JiangDate Oct 29, 2021 2397930d855SDave JiangKernelVersion: 5.17.0 2407930d855SDave JiangContact: dmaengine@vger.kernel.org 2417930d855SDave JiangDescription: Indicate the number of retires for an enqcmds submission on a sharedwq. 2427930d855SDave Jiang A max value to set attribute is capped at 64. 2437930d855SDave Jiang 244b0325aefSDave JiangWhat: /sys/bus/dsa/devices/wq<m>.<n>/op_config 245b0325aefSDave JiangDate: Sept 14, 2022 246b0325aefSDave JiangKernelVersion: 6.0.0 247b0325aefSDave JiangContact: dmaengine@vger.kernel.org 248b0325aefSDave JiangDescription: Shows the operation capability bits displayed in bitmap format 249b0325aefSDave Jiang presented by %*pb printk() output format specifier. 250b0325aefSDave Jiang The attribute can be configured when the WQ is disabled in 251b0325aefSDave Jiang order to configure the WQ to accept specific bits that 252b0325aefSDave Jiang correlates to the operations allowed. It's visible only 253b0325aefSDave Jiang on platforms that support the capability. 254b0325aefSDave Jiang 25577522b21SDave JiangWhat: /sys/bus/dsa/devices/engine<m>.<n>/group_id 256b131ad59SJing LinDate: Oct 25, 2019 257b131ad59SJing LinKernelVersion: 5.6.0 258b131ad59SJing LinContact: dmaengine@vger.kernel.org 259b131ad59SJing LinDescription: The group that this engine belongs to. 260fde212e4SDave Jiang 261fde212e4SDave JiangWhat: /sys/bus/dsa/devices/group<m>.<n>/use_read_buffer_limit 262fde212e4SDave JiangDate: Dec 10, 2021 263fde212e4SDave JiangKernelVersion: 5.17.0 264fde212e4SDave JiangContact: dmaengine@vger.kernel.org 265fde212e4SDave JiangDescription: Enable the use of global read buffer limit for the group. See DSA 266fde212e4SDave Jiang spec v1.2 9.2.18 GRPCFG Use Global Read Buffer Limit. 2679a8ddb35SXiaochen Shen It's not visible when the device does not support Read Buffer 2689a8ddb35SXiaochen Shen allocation control. 269fde212e4SDave Jiang 270fde212e4SDave JiangWhat: /sys/bus/dsa/devices/group<m>.<n>/read_buffers_allowed 271fde212e4SDave JiangDate: Dec 10, 2021 272fde212e4SDave JiangKernelVersion: 5.17.0 273fde212e4SDave JiangContact: dmaengine@vger.kernel.org 274fde212e4SDave JiangDescription: Indicates max number of read buffers that may be in use at one time 275fde212e4SDave Jiang by all engines in the group. See DSA spec v1.2 9.2.18 GRPCFG Read 276fde212e4SDave Jiang Buffers Allowed. 2779a8ddb35SXiaochen Shen It's not visible when the device does not support Read Buffer 2789a8ddb35SXiaochen Shen allocation control. 279fde212e4SDave Jiang 280fde212e4SDave JiangWhat: /sys/bus/dsa/devices/group<m>.<n>/read_buffers_reserved 281fde212e4SDave JiangDate: Dec 10, 2021 282fde212e4SDave JiangKernelVersion: 5.17.0 283fde212e4SDave JiangContact: dmaengine@vger.kernel.org 284fde212e4SDave JiangDescription: Indicates the number of Read Buffers reserved for the use of 285fde212e4SDave Jiang engines in the group. See DSA spec v1.2 9.2.18 GRPCFG Read Buffers 286fde212e4SDave Jiang Reserved. 2879a8ddb35SXiaochen Shen It's not visible when the device does not support Read Buffer 2889a8ddb35SXiaochen Shen allocation control. 2891f273752SDave Jiang 2901f273752SDave JiangWhat: /sys/bus/dsa/devices/group<m>.<n>/desc_progress_limit 2911f273752SDave JiangDate: Sept 14, 2022 2921f273752SDave JiangKernelVersion: 6.0.0 2931f273752SDave JiangContact: dmaengine@vger.kernel.org 2941f273752SDave JiangDescription: Allows control of the number of work descriptors that can be 2951f273752SDave Jiang concurrently processed by an engine in the group as a fraction 2961f273752SDave Jiang of the Maximum Work Descriptors in Progress value specified in 2971f273752SDave Jiang the ENGCAP register. The acceptable values are 0 (default), 2981f273752SDave Jiang 1 (1/2 of max value), 2 (1/4 of the max value), and 3 (1/8 of 2991f273752SDave Jiang the max value). It's visible only on platforms that support 3001f273752SDave Jiang the capability. 3017ca68fa3SDave Jiang 3027ca68fa3SDave JiangWhat: /sys/bus/dsa/devices/group<m>.<n>/batch_progress_limit 3037ca68fa3SDave JiangDate: Sept 14, 2022 3047ca68fa3SDave JiangKernelVersion: 6.0.0 3057ca68fa3SDave JiangContact: dmaengine@vger.kernel.org 3067ca68fa3SDave JiangDescription: Allows control of the number of batch descriptors that can be 3077ca68fa3SDave Jiang concurrently processed by an engine in the group as a fraction 3087ca68fa3SDave Jiang of the Maximum Batch Descriptors in Progress value specified in 3097ca68fa3SDave Jiang the ENGCAP register. The acceptable values are 0 (default), 3107ca68fa3SDave Jiang 1 (1/2 of max value), 2 (1/4 of the max value), and 3 (1/8 of 3117ca68fa3SDave Jiang the max value). It's visible only on platforms that support 3127ca68fa3SDave Jiang the capability. 313