2.1. 简介

PCIe性能评测工具提供一套全面、高精度的基准测试，用于评估主机与后摩漫界^® M50 设备之间数据传输通道的读写通信带宽。

工具在不同传输负载和并发度环境下，测试主机内存与设备内存之间以及设备内部内存之间的数据传输最大有效吞吐量，旨在精确诊断I/O传输和M50芯片内存瓶颈对应用性能的影响。

2.1.1. 性能说明

工具所测得的实际有效带宽通常会低于理论峰值带宽。该差异是由于多种系统、硬件和运行状态因素共同影响所致：

数据传输模式与负载：
- 传输数据块大小： 在小数据块传输中，每次传输的驱动程序调用、硬件握手和协议封装等软件/硬件开销占比更高，导致实际带宽利用率低。随着数据块增大，开销占比降低，带宽逐渐逼近峰值。
- 并发线程数： 实际带宽的提升并非随着线程数线性增长。当达到最优并发度后，过多的线程会引入总线仲裁延迟和资源竞争开销，可能导致带宽饱和后性能趋于平稳或下降。
芯片工作频率的动态影响： M50芯片当前的工作频率是决定I/O传输速度的关键因素。例如，M50芯片IPU内核如果设置为ondemand模式，则会根据IPU实时利用率动态调整IPU频率，当IPU内核负载较低时，芯片为节能会自动降低工作频率。IPU核心频率的降低会直接影响到其PCIe的工作速度，导致实际I/O传输带宽被动限制在较低水平。
主机平台架构差异： 主机CPU的性能、内存带宽和I/O子系统直接决定了数据传输的起点和终点速度。例如，高性能的 X86服务器平台通常能提供远高于嵌入式 ARM 平台（如 RK3588）的系统内存带宽和PCIe 吞吐能力，从而在传输速度上形成显著差异。

该工具支持平台如下：

Linux系统：
- Ubuntu 24.04（x86_64）
- Ubuntu 22.04（x86_64）
- Ubuntu 20.04（x86_64、AArch64）
Windows系统：
- Windows 11（x86_64）
Android系统：
- 操作系统：Android 15 (API level 35)
- CPU 架构：arm64‑v8a
- 内核版本：Linux 6.1
- 开发调试工具：adb (Android Debug Bridge)
  
  注：adb 工具默认不随系统安装。

工具使用前需完成下面操作：

安装软件平台驱动。详情参看《后摩大道^® 软件平台驱动安装指南》。
烧写和升级后摩设备固件镜像。详情参看《后摩大道^® HmUpdateTool 工具使用指南》。
设置环境变量：
```
export LD_LIBRARY_PATH=${HOUMO_SDK_PATH}/hal/lib
```
其中 ${HOUMO_SDK_PATH} 为驱动安装路径，驱动默认安装在 /usr/local/houmo-sdk 目录下。
在 ${HOUMO_SDK_PATH}/hal/utility 路径下，运行下面指令即可运行该工具：
```
./pcie_test [device_id] <options>
```
指令详情参看使用说明。

工具使用前需完成下面操作：

安装软件平台驱动。详情参看《后摩大道^® 软件平台驱动安装指南》。
烧写和升级后摩设备固件镜像。详情参看《后摩大道^® HmUpdateTool 工具使用指南》。
设置环境变量：
- 在CMD 中，使用 set 命令设置环境变量：
```
set PATH=<DRIVER_INSTALL_PATH>\hal\lib;%PATH%
```
- 在 PowerShell 中设置环境变量：
```
$env:PATH = "<DRIVER_INSTALL_PATH>\hal\lib" + $env:PATH
```
其中 <DRIVER_INSTALL_PATH> 为驱动安装路径，如 ${PATH}\houmo_drv_xh2_<release> 目录下。${PATH} 为 Windows 驱动安装路径，默认安装在 C:\Program Files。
在 ${PATH}\houmo_drv_xh2_<release>\hal\utility 路径下，运行下面指令即可运行该工具：
```
pcie_test.exe [device_id] <options>
```
指令详情参看使用说明。

工具使用前需完成下面操作：

配置最新版本Andorid驱动，详情参看《后摩大道^® 软件平台驱动安装指南》。
在主机端，将工具 pcie_test 传输到Android设备的 /data/houmo 目录：
```
adb push pcie_test /data/houmo
```
该工具位于驱动安装包 houmo-drv-xh2_<release>_androidmicron_$arch/houmo_drv_xh2/hal/utility 路径下。
在主机端，通过 adb 进入Android设备开发板命令行，并获取 root 权限：
```
adb shell
su
```

设置环境变量：
```
export LD_LIBRARY_PATH=$DRV_HAL:$LD_LIBRARY_PATH
```
其中 $DRV_HAL 应替换为驱动安装后系统软件动态库 hal/lib 目录，如 /data/houmo/houmo_drv_xh2/hal/lib。
在 /data/houmo 路径下，运行下面指令即可运行该工具：
```
pcie_test [device_id] <options>
```
指令详情参看使用说明。