305 lines · plain
1.. SPDX-License-Identifier: GPL-2.02 3======================================4HiSilicon PCIe Tune and Trace device5======================================6 7Introduction8============9 10HiSilicon PCIe tune and trace device (PTT) is a PCIe Root Complex11integrated Endpoint (RCiEP) device, providing the capability12to dynamically monitor and tune the PCIe link's events (tune),13and trace the TLP headers (trace). The two functions are independent,14but is recommended to use them together to analyze and enhance the15PCIe link's performance.16 17On Kunpeng 930 SoC, the PCIe Root Complex is composed of several18PCIe cores. Each PCIe core includes several Root Ports and a PTT19RCiEP, like below. The PTT device is capable of tuning and20tracing the links of the PCIe core.21::22 23 +--------------Core 0-------+24 | | [ PTT ] |25 | | [Root Port]---[Endpoint]26 | | [Root Port]---[Endpoint]27 | | [Root Port]---[Endpoint]28 Root Complex |------Core 1-------+29 | | [ PTT ] |30 | | [Root Port]---[ Switch ]---[Endpoint]31 | | [Root Port]---[Endpoint] `-[Endpoint]32 | | [Root Port]---[Endpoint]33 +---------------------------+34 35The PTT device driver registers one PMU device for each PTT device.36The name of each PTT device is composed of 'hisi_ptt' prefix with37the id of the SICL and the Core where it locates. The Kunpeng 93038SoC encapsulates multiple CPU dies (SCCL, Super CPU Cluster) and39IO dies (SICL, Super I/O Cluster), where there's one PCIe Root40Complex for each SICL.41::42 43 /sys/bus/event_source/devices/hisi_ptt<sicl_id>_<core_id>44 45Tune46====47 48PTT tune is designed for monitoring and adjusting PCIe link parameters (events).49Currently we support events in 2 classes. The scope of the events50covers the PCIe core to which the PTT device belongs.51 52Each event is presented as a file under $(PTT PMU dir)/tune, and53a simple open/read/write/close cycle will be used to tune the event.54::55 56 $ cd /sys/bus/event_source/devices/hisi_ptt<sicl_id>_<core_id>/tune57 $ ls58 qos_tx_cpl qos_tx_np qos_tx_p59 tx_path_rx_req_alloc_buf_level60 tx_path_tx_req_alloc_buf_level61 $ cat qos_tx_dp62 163 $ echo 2 > qos_tx_dp64 $ cat qos_tx_dp65 266 67Current value (numerical value) of the event can be simply read68from the file, and the desired value written to the file to tune.69 701. Tx Path QoS Control71------------------------72 73The following files are provided to tune the QoS of the tx path of74the PCIe core.75 76- qos_tx_cpl: weight of Tx completion TLPs77- qos_tx_np: weight of Tx non-posted TLPs78- qos_tx_p: weight of Tx posted TLPs79 80The weight influences the proportion of certain packets on the PCIe link.81For example, for the storage scenario, increase the proportion82of the completion packets on the link to enhance the performance as83more completions are consumed.84 85The available tune data of these events is [0, 1, 2].86Writing a negative value will return an error, and out of range87values will be converted to 2. Note that the event value just88indicates a probable level, but is not precise.89 902. Tx Path Buffer Control91-------------------------92 93Following files are provided to tune the buffer of tx path of the PCIe core.94 95- rx_alloc_buf_level: watermark of Rx requested96- tx_alloc_buf_level: watermark of Tx requested97 98These events influence the watermark of the buffer allocated for each99type. Rx means the inbound while Tx means outbound. The packets will100be stored in the buffer first and then transmitted either when the101watermark reached or when timed out. For a busy direction, you should102increase the related buffer watermark to avoid frequently posting and103thus enhance the performance. In most cases just keep the default value.104 105The available tune data of above events is [0, 1, 2].106Writing a negative value will return an error, and out of range107values will be converted to 2. Note that the event value just108indicates a probable level, but is not precise.109 110Trace111=====112 113PTT trace is designed for dumping the TLP headers to the memory, which114can be used to analyze the transactions and usage condition of the PCIe115Link. You can choose to filter the traced headers by either Requester ID,116or those downstream of a set of Root Ports on the same core of the PTT117device. It's also supported to trace the headers of certain type and of118certain direction.119 120You can use the perf command `perf record` to set the parameters, start121trace and get the data. It's also supported to decode the trace122data with `perf report`. The control parameters for trace is inputted123as event code for each events, which will be further illustrated later.124An example usage is like125::126 127 $ perf record -e hisi_ptt0_2/filter=0x80001,type=1,direction=1,128 format=1/ -- sleep 5129 130This will trace the TLP headers downstream root port 0000:00:10.1 (event131code for event 'filter' is 0x80001) with type of posted TLP requests,132direction of inbound and traced data format of 8DW.133 1341. Filter135---------136 137The TLP headers to trace can be filtered by the Root Ports or the Requester ID138of the Endpoint, which are located on the same core of the PTT device. You can139set the filter by specifying the `filter` parameter which is required to start140the trace. The parameter value is 20 bit. Bit 19 indicates the filter type.1411 for Root Port filter and 0 for Requester filter. Bit[15:0] indicates the142filter value. The value for a Root Port is a mask of the core port id which is143calculated from its PCI Slot ID as (slotid & 7) * 2. The value for a Requester144is the Requester ID (Device ID of the PCIe function). Bit[18:16] is currently145reserved for extension.146 147For example, if the desired filter is Endpoint function 0000:01:00.1 the filter148value will be 0x00101. If the desired filter is Root Port 0000:00:10.0 then149then filter value is calculated as 0x80001.150 151The driver also presents every supported Root Port and Requester filter through152sysfs. Each filter will be an individual file with name of its related PCIe153device name (domain:bus:device.function). The files of Root Port filters are154under $(PTT PMU dir)/root_port_filters and files of Requester filters155are under $(PTT PMU dir)/requester_filters.156 157Note that multiple Root Ports can be specified at one time, but only one158Endpoint function can be specified in one trace. Specifying both Root Port159and function at the same time is not supported. Driver maintains a list of160available filters and will check the invalid inputs.161 162The available filters will be dynamically updated, which means you will always163get correct filter information when hotplug events happen, or when you manually164remove/rescan the devices.165 1662. Type167-------168 169You can trace the TLP headers of certain types by specifying the `type`170parameter, which is required to start the trace. The parameter value is1718 bit. Current supported types and related values are shown below:172 173- 8'b00000001: posted requests (P)174- 8'b00000010: non-posted requests (NP)175- 8'b00000100: completions (CPL)176 177You can specify multiple types when tracing inbound TLP headers, but can only178specify one when tracing outbound TLP headers.179 1803. Direction181------------182 183You can trace the TLP headers from certain direction, which is relative184to the Root Port or the PCIe core, by specifying the `direction` parameter.185This is optional and the default parameter is inbound. The parameter value186is 4 bit. When the desired format is 4DW, directions and related values187supported are shown below:188 189- 4'b0000: inbound TLPs (P, NP, CPL)190- 4'b0001: outbound TLPs (P, NP, CPL)191- 4'b0010: outbound TLPs (P, NP, CPL) and inbound TLPs (P, NP, CPL B)192- 4'b0011: outbound TLPs (P, NP, CPL) and inbound TLPs (CPL A)193 194When the desired format is 8DW, directions and related values supported are195shown below:196 197- 4'b0000: reserved198- 4'b0001: outbound TLPs (P, NP, CPL)199- 4'b0010: inbound TLPs (P, NP, CPL B)200- 4'b0011: inbound TLPs (CPL A)201 202Inbound completions are classified into two types:203 204- completion A (CPL A): completion of CHI/DMA/Native non-posted requests, except for CPL B205- completion B (CPL B): completion of DMA remote2local and P2P non-posted requests206 2074. Format208--------------209 210You can change the format of the traced TLP headers by specifying the211`format` parameter. The default format is 4DW. The parameter value is 4 bit.212Current supported formats and related values are shown below:213 214- 4'b0000: 4DW length per TLP header215- 4'b0001: 8DW length per TLP header216 217The traced TLP header format is different from the PCIe standard.218 219When using the 8DW data format, the entire TLP header is logged220(Header DW0-3 shown below). For example, the TLP header for Memory221Reads with 64-bit addresses is shown in PCIe r5.0, Figure 2-17;222the header for Configuration Requests is shown in Figure 2.20, etc.223 224In addition, 8DW trace buffer entries contain a timestamp and225possibly a prefix for a PASID TLP prefix (see Figure 6-20, PCIe r5.0).226Otherwise this field will be all 0.227 228The bit[31:11] of DW0 is always 0x1fffff, which can be229used to distinguish the data format. 8DW format is like230::231 232 bits [ 31:11 ][ 10:0 ]233 |---------------------------------------|-------------------|234 DW0 [ 0x1fffff ][ Reserved (0x7ff) ]235 DW1 [ Prefix ]236 DW2 [ Header DW0 ]237 DW3 [ Header DW1 ]238 DW4 [ Header DW2 ]239 DW5 [ Header DW3 ]240 DW6 [ Reserved (0x0) ]241 DW7 [ Time ]242 243When using the 4DW data format, DW0 of the trace buffer entry244contains selected fields of DW0 of the TLP, together with a245timestamp. DW1-DW3 of the trace buffer entry contain DW1-DW3246directly from the TLP header.247 2484DW format is like249::250 251 bits [31:30] [ 29:25 ][24][23][22][21][ 20:11 ][ 10:0 ]252 |-----|---------|---|---|---|---|-------------|-------------|253 DW0 [ Fmt ][ Type ][T9][T8][TH][SO][ Length ][ Time ]254 DW1 [ Header DW1 ]255 DW2 [ Header DW2 ]256 DW3 [ Header DW3 ]257 2585. Memory Management259--------------------260 261The traced TLP headers will be written to the memory allocated262by the driver. The hardware accepts 4 DMA address with same size,263and writes the buffer sequentially like below. If DMA addr 3 is264finished and the trace is still on, it will return to addr 0.265::266 267 +->[DMA addr 0]->[DMA addr 1]->[DMA addr 2]->[DMA addr 3]-+268 +---------------------------------------------------------+269 270Driver will allocate each DMA buffer of 4MiB. The finished buffer271will be copied to the perf AUX buffer allocated by the perf core.272Once the AUX buffer is full while the trace is still on, driver273will commit the AUX buffer first and then apply for a new one with274the same size. The size of AUX buffer is default to 16MiB. User can275adjust the size by specifying the `-m` parameter of the perf command.276 2776. Decoding278-----------279 280You can decode the traced data with `perf report -D` command (currently281only support to dump the raw trace data). The traced data will be decoded282according to the format described previously (take 8DW as an example):283::284 285 [...perf headers and other information]286 . ... HISI PTT data: size 4194304 bytes287 . 00000000: 00 00 00 00 Prefix288 . 00000004: 01 00 00 60 Header DW0289 . 00000008: 0f 1e 00 01 Header DW1290 . 0000000c: 04 00 00 00 Header DW2291 . 00000010: 40 00 81 02 Header DW3292 . 00000014: 33 c0 04 00 Time293 . 00000020: 00 00 00 00 Prefix294 . 00000024: 01 00 00 60 Header DW0295 . 00000028: 0f 1e 00 01 Header DW1296 . 0000002c: 04 00 00 00 Header DW2297 . 00000030: 40 00 81 02 Header DW3298 . 00000034: 02 00 00 00 Time299 . 00000040: 00 00 00 00 Prefix300 . 00000044: 01 00 00 60 Header DW0301 . 00000048: 0f 1e 00 01 Header DW1302 . 0000004c: 04 00 00 00 Header DW2303 . 00000050: 40 00 81 02 Header DW3304 [...]305