Qcom平台通过Hexagon IDE 测试程序性能指导

1 安装Hexagon IDE工具

安装包安装的3.4.3版本：

安装时，可选择默认路径，也可选择其他路径。

2 测试工程

2.1 打开Hexagon IDE

在安装路径下打开Launch Hexagon IDE

2.2 新建工程

1. 依次选择菜单栏的File >> New >> Hexagon Project：
   

2. 弹出建立工程的对话框：
   

1. Project name栏里填写项目名称，注意项目名称不能包含空格；

2. Project location栏为打开Hexagon IDE工具时的工作地址，选择默认路径即可；

3. Tools location栏为安装hexagon_sdk的工具路径，一般不能修改；

4. Hexagon SDK location栏用来选择SDK的路径，打开Hexagon IDE时就自动填上；

5. Project type栏里选择Executable(.exe)，因为这个程序我们在Windows环境下运行；

6. Architecture栏选择V60(-mv60)；

7. Choose project template栏选择General下的Empty Executable；

8. 其余的无须修改，保持默认，如下：
   

9. 点击Finish新建完成，因Project location选择的是C：/Users/xx（我的workspace路径），此时在该路径下可以找到新建的工程：
   

2.3 添加测试案例

添加测试案例有两个方法：新建和拷贝，新建适用于代码量小的测试，当测试代码文件较多时，建议使用拷贝。

2.3.1 方法一：新建

1. 在项目名称上单击右键，选择New >> Source File
   

2. 弹出如下对话框
   

注意：Source file框中填写源文件名称时，要加上文件类型，这里可以是C或者C++。在Template框中选择C或者C++，这里选择的要与填写的源文件类型相符。
3. 点击Finish完成创建

2.3.2 方法二：拷贝

将头文件、源文件和配置文件拷贝到新建的工程下，如下图

注意，可以将包含主函数的源文件放至src文件夹，拷贝完成之后需要在Hexagon IDE主界面中的Project Explorer中刷新，有两个方法：其一，在Project Explorer空白处单击右键，选中Refresh；其二，快捷键F5。

2.4 配置测试环境

配置测试环境主要包含三个：包含头文件、添加程序优化功能和添加gprof测试性能。包含头文件主要配置项目头文件路径，添加程序优化功能主要实现优化代码的功能，添加gprof测试性能主要是生成测试文件。

2.4.1 包含头文件

1. 将头文件路径包含在工程中，在项目名称上单击右键，打开当前工程的Properties
   

2. 在弹出的界面中依次点击C/C++ General >> Paths and Symbols >> Includes >> GNU C >> Add
   

3. 接着在弹出的界面中点击File system，如下图
   

4. 选择头文件的路径，如下图
   

5. 点击OK保存，此时在Project Explorer中显示包含的文件
   

2.4.2 添加程序优化功能(需先bulid一下)

1. 同样打开当前工程的Properties，在弹出的界面中依次点击C/C++ Build >>Settings >> Tool Settings，Optimization为优化等级，将Hexagon C++ Compiler下的Optimization和Hexagon C Compiler下的Optimization均设置为为Optimize more(-O2)
   

2. 点击OK，设置成功。

2.4.3 添加gprof测试性能

1. 同样打开当前工程的Properties，在弹出的界面中依次点击Run/Debug Settings >> SHS_haptic_effect（工程名），在弹出的界面中点击Simulator，并在当前界面的Miscellaneous flags框中添加- -profile命令，用于生成gmon文件
   

2. 点击OK，设置成功。

2.5 编译

1. 在项目名称上单击右键，点击Build Project编译，或者直接采用快捷键Ctrl + B。编译完成后，会在项目下生成编译好的Binaries文件
   

2. 同时在项目路径下的LLVM Debug文件夹下生成可执行文件
   

2.6 运行

1. 在工具栏点击运行按钮
   

2. 运行结束会显示如下界面
   

3. 运行结束后会在项目所在的文件夹下生成gmon.t_0文件
   

3 解析gmon.t_0文件

1. cmd进入高通SDK路径下的bin目录下，有一个hexagon-gprof.exe文件，gprof是一个用于读取profile结果文件的工具
   

2. 将gmon.t_0文件拷贝至该文件夹下，并在cmd界面执行hexagon-gprof.exe，命令如下：
   

注意：如须重新解析新生成的gmon.t_0文件，需将新生成的gmon.t_0文件重新拷贝到该目录下。
指令：.\hexagon-gprof.exe C:\Users\xx\xxxxx_effects\LLVM_Debug\xxxxx_effects gmon.t_0>xxxxxx_effects.txt

4 解读生成的txt文件

1. 通过gprof解析生成的txt文件头如下
   

2. 各参数代表含义如下
   %time 函数执行占时百分比
   cumulative cycle(s) 函数和以上所有函数累积执行周期
   self cycle(s) 函数执行周期
   calls 函数执行总次数
   self Mc/call 函数每执行一次的执行周期
   total Mc/call 函数及其衍生函数执行一次的执行周期
   name 函数名

3. MCPS（Million Cycles Per Second）计算公式：
   某函数的MCPS = total_cycles × Fs / (time × number of channels × Fs ×1000000)

4. 示例
   如函数butter_filter_process_new执行周期9340704，采样率48k，time为2s，number of channels为2，则函数butter_filter_process_new的MCPS为
   MCPS = 934070448000/(22480001000000)
   注意：如果某函数有衍生函数，则计算MCPS时需加上所有衍生函数的self cycles。