]> git.ipfire.org Git - thirdparty/kernel/linux.git/blame - Documentation/misc-devices/dw-xdata-pcie.rst
Merge tag 'riscv-soc-fixes-for-v6.9-rc3' of https://git.kernel.org/pub/scm/linux...
[thirdparty/kernel/linux.git] / Documentation / misc-devices / dw-xdata-pcie.rst
CommitLineData
e1181b5b
GP
1.. SPDX-License-Identifier: GPL-2.0
2
3===========================================================================
4Driver for Synopsys DesignWare PCIe traffic generator (also known as xData)
5===========================================================================
6
23188e0d
GP
7Supported chips:
8Synopsys DesignWare PCIe prototype solution
9
10Datasheet:
11Not freely available
12
13Author:
14Gustavo Pimentel <gustavo.pimentel@synopsys.com>
15
16Description
17-----------
18
e1181b5b
GP
19This driver should be used as a host-side (Root Complex) driver and Synopsys
20DesignWare prototype that includes this IP.
21
23188e0d 22The dw-xdata-pcie driver can be used to enable/disable PCIe traffic
e1181b5b
GP
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
23188e0d
GP
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