admin-guide/perf/hisi-pcie-pmu.rst

6 bandwidth, latency, bus utilization and buffer occupancy data of PCIe.
8 Each PCIe Core has a PMU to monitor multi Root Ports of this PCIe Core and
9 all Endpoints downstream these Root Ports.
15 The PCIe PMU driver registers a perf PMU with the name of its sicl-id and PCIe
20 PMU driver provides description of available events and filter options in sysfs,
23 The "format" directory describes all formats of the config (events) and config1
24 (filter options) fields of the perf_event_attr structure. The "events" directory
27 The "identifier" sysfs file allows users to identify the version of the
30 The "bus" sysfs file allows users to get the bus number of Root Ports
31 monitored by PMU. Furthermore users can get the Root Ports range in
35 Example usage of perf::
40   ------------------------------------------
42   $# perf stat -e hisi_pcie0_core0/rx_mwr_latency,port=0xffff/
43   $# perf stat -e hisi_pcie0_core0/rx_mwr_cnt,port=0xffff/
54 Example usage of perf group::
56 …$# perf stat -e "{hisi_pcie0_core0/rx_mwr_latency,port=0xffff/,hisi_pcie0_core0/rx_mwr_cnt,port=0x…
62 --------------
66    PMU could only monitor the performance of traffic downstream target Root
67    Ports or downstream target Endpoint. PCIe PMU driver support "port" and
69    Please notice that, one of these two interfaces must be set, and these two
70    interfaces aren't supported at the same time. If they are both set, only
72    If "port" filter not being set or is set explicitly to zero (default), the
75    - port
78      selected by configuring the 16-bits-bitmap "port". Multi ports can be
79      selected for AP-layer-events, and only one port can be selected for
80      TL/DL-layer-events.
82      For example, if target Root Port is 0000:00:00.0 (x8 lanes), bit0 of
83      bitmap should be set, port=0x1; if target Root Port is 0000:00:04.0 (x4
84      lanes), bit8 is set, port=0x100; if these two Root Ports are both
87      Example usage of perf::
89        $# perf stat -e hisi_pcie0_core0/rx_mwr_latency,port=0x1/ sleep 5
91    - bdf
94      selected by configuring BDF to "bdf". Counter only counts the bandwidth of
97      For example, "bdf=0x3900" means BDF of target Endpoint is 0000:39:00.0.
99      Example usage of perf::
101        $# perf stat -e hisi_pcie0_core0/rx_mrd_flux,bdf=0x3900/ sleep 5
106    than trigger condition. You can set the trigger condition by writing
107    "trig_len", and set the trigger mode by writing "trig_mode". This filter can
114    Example usage of perf::
116      $# perf stat -e hisi_pcie0_core0/rx_mrd_flux,port=0xffff,trig_len=0x4,trig_mode=1/ sleep 5
120    Counter counts when TLP length within the specified range. You can set the
121    threshold by writing "thr_len", and set the threshold mode by writing
128    Example usage of perf::
130      $# perf stat -e hisi_pcie0_core0/rx_mrd_flux,port=0xffff,thr_len=0x4,thr_mode=1/ sleep 5
134    When counting bandwidth, the data can be composed of certain parts of TLP
137    - 2'b00: Reserved (Do not use this since the behaviour is undefined)
138    - 2'b01: Bandwidth of TLP payloads
139    - 2'b10: Bandwidth of TLP headers
140    - 2'b11: Bandwidth of both TLP payloads and headers
142    For example, "len_mode=2" means only counting the bandwidth of TLP headers
143    and "len_mode=3" means the final bandwidth data is composed of both TLP
146    Example usage of perf::
148      $# perf stat -e hisi_pcie0_core0/rx_mrd_flux,port=0xffff,len_mode=0x1/ sleep 5