1.. SPDX-License-Identifier: GPL-2.0 2 3=========================================================================== 4Driver for Synopsys DesignWare PCIe traffic generator (also known as xData) 5=========================================================================== 6 7Supported chips: 8Synopsys DesignWare PCIe prototype solution 9 10Datasheet: 11Not freely available 12 13Author: 14Gustavo Pimentel <gustavo.pimentel@synopsys.com> 15 16Description 17----------- 18 19This driver should be used as a host-side (Root Complex) driver and Synopsys 20DesignWare prototype that includes this IP. 21 22The dw-xdata-pcie driver can be used to enable/disable PCIe traffic 23generator in either direction (mutual exclusion) besides allowing the 24PCIe link performance analysis. 25 26The interaction with this driver is done through the module parameter and 27can be changed in runtime. The driver outputs the requested command state 28information to ``/var/log/kern.log`` or dmesg. 29 30Example 31------- 32 33Write TLPs traffic generation - Root Complex to Endpoint direction 34~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 35 36Generate traffic:: 37 38 # echo 1 > /sys/class/misc/dw-xdata-pcie.0/write 39 40Get link throughput in MB/s:: 41 42 # cat /sys/class/misc/dw-xdata-pcie.0/write 43 204 44 45Stop traffic in any direction:: 46 47 # echo 0 > /sys/class/misc/dw-xdata-pcie.0/write 48 49Read TLPs traffic generation - Endpoint to Root Complex direction 50~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 51 52Generate traffic:: 53 54 # echo 1 > /sys/class/misc/dw-xdata-pcie.0/read 55 56Get link throughput in MB/s:: 57 58 # cat /sys/class/misc/dw-xdata-pcie.0/read 59 199 60 61Stop traffic in any direction:: 62 63 # echo 0 > /sys/class/misc/dw-xdata-pcie.0/read 64 65