mperf 项目下载及安装教程

1. 项目介绍

mperf 是一个面向移动/嵌入式平台的算子性能调优工具箱。它提供了多种功能，包括微架构参数分析、层次化屋顶线模型绘制、CPU/GPU PMU 事件数据收集与分析、OpenCL Linter 等。mperf 旨在帮助开发者优化移动/嵌入式平台的算子性能，支持 ARM CPU、Mali GPU 和 Adreno 6xx GPU 等平台。

2. 项目下载位置

mperf 项目托管在 GitHub 上，可以通过以下命令进行下载：

git clone https://github.com/MegEngine/mperf.git

3. 项目安装环境配置

3.1 环境要求

• CMake 版本：3.15.2 或更高
• 编译器：GCC 或 Clang
• 目标平台：ARM CPU、Mali GPU、Adreno 6xx GPU

3.2 环境配置示例

以下是一个典型的环境配置示例：

4. 项目安装方式

4.1 克隆项目

首先，克隆 mperf 项目到本地：

git clone https://github.com/MegEngine/mperf.git
cd mperf
git submodule update --init --recursive

4.2 选择测试平台

根据目标平台选择相应的配置：

• Android 平台：

  • 下载并解压 NDK。
  • 设置 NDK_ROOT 环境变量指向解压后的 NDK 目录。

• Linux 平台：

  • 确保系统中安装了 GCC 或 Clang 编译器。

4.3 编译项目

4.3.1 Android 平台

运行 android_build.sh 脚本进行编译：

./android_build.sh -h

示例：

./android_build.sh -m armeabi-v7a

4.3.2 Linux 平台

使用 CMake 进行编译：

cmake -S . -B "build-x86" -DMPERF_ENABLE_PFM=ON
cmake --build "build-x86" --config Release

4.4 安装项目

编译完成后，可以将 mperf 安装到系统路径或自定义安装目录：

cmake --build <mperf_build_dir> --target install

示例：

cmake --build ./build-arm64-v8a/ --target install

5. 项目处理脚本

mperf 提供了多个处理脚本，用于不同平台的编译和配置。以下是一些常用的脚本：

• android_build.sh：用于 Android 平台的编译。
• cmake：用于 Linux 平台的编译。

5.1 android_build.sh 脚本

该脚本用于 Android 平台的编译，支持多种选项：

• -m：指定目标架构（如 armeabi-v7a 或 arm64-v8a）。
• -g：指定目标 GPU（如 mali 或 adreno）。
• -p：启用 PMU 支持。
• -d：启用调试模式。
• -i：指定自定义安装目录。

示例：

./android_build.sh -m armeabi-v7a -g mali

5.2 cmake 脚本

该脚本用于 Linux 平台的编译，支持多种选项：

• -S：指定源代码目录。
• -B：指定构建目录。
• -DMPERF_ENABLE_PFM=ON：启用 PMU 支持。

示例：

cmake -S . -B "build-x86" -DMPERF_ENABLE_PFM=ON

通过以上步骤，您可以成功下载、配置并安装 mperf 项目，开始进行移动/嵌入式平台的算子性能调优。