1. 为什么选择CMake构建海思SDK开发环境
第一次接触海思Hi3519/Hi3559开发时,我完全被它复杂的Makefile体系搞懵了。那些层层嵌套的Makefile文件就像迷宫一样,每次修改配置都要在各种include路径里转圈。直到尝试用CMake重构项目,才发现原来构建过程可以这么清爽。
CMake作为现代构建工具,在海思平台开发中至少有三大优势:首先是跨平台特性,同一套配置可以在Windows/Linux/macOS上运行;其次是依赖管理智能化,自动处理头文件包含和库链接;最重要的是配置可视化,通过CMake-GUI可以直观调整编译参数。实测将原有Makefile项目迁移到CMake后,编译效率提升了30%以上。
对于海思这种需要交叉编译的场景,CMake的toolchain文件机制简直是救星。我们只需要定义一次交叉编译链配置,之后所有项目都能复用。相比每次都要设置环境变量的传统方式,这种"一次配置,到处运行"的体验不要太舒服。下面这张对比表能清晰看出差异:
| 构建方式 | 配置复杂度 | 可维护性 | 跨平台支持 | 学习成本 |
|---|---|---|---|---|
| 传统Makefile | 高 | 差 | 有限 | 高 |
| CMake | 中 | 优秀 | 全平台 | 中 |
| 厂商IDE | 低 | 一般 | 无 | 低 |
2. 搭建交叉编译工具链
2.1 准备编译环境
在Ubuntu 20.04上配置海思工具链时,建议先安装这些基础依赖:
sudo apt-get install -y gcc g++ make cmake libncurses5-dev
海思官方提供的交叉编译器通常存放在/opt/hisi-linux目录下。以Hi3519AV100为例,其编译器路径为:
/opt/hisi-linux/x86-arm/arm-himix200-linux/bin/arm-himix200-linux-gcc
遇到"Permission denied"错误时,记得给安装脚本执行权限:
chmod +x arm-himix200-linux.install
sudo ./arm-himix200-linux.install
2.2 配置CMake工具链文件
创建toolchain.cmake文件是核心步骤,这个文件相当于告诉CMake如何与海思工具链对话。我的配置模板如下:
# 目标系统类型
set(CMAKE_SYSTEM_NAME Linux)
set(CMAKE_SYSTEM_PROCESSOR arm)
# 指定交叉编译器
set(CMAKE_C_COMPILER /opt/hisi-linux/x86-arm/arm-himix200-linux/bin/arm-himix200-linux-gcc)
set(CMAKE_CXX_COMPILER /opt/hisi-linux/x86-arm/arm-himix200-linux/bin/arm-himix200-linux-g++)
# 搜索规则设置
set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER)
set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY)
set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY)
set(CMAKE_FIND_ROOT_PATH_MODE_PACKAGE ONLY)
使用时通过-DCMAKE_TOOLCHAIN_FILE参数指定该文件位置:
cmake -DCMAKE_TOOLCHAIN_FILE=../toolchain.cmake ..
3. 集成海思专用库文件
3.1 定位SDK关键组件
海思SDK中这些目录需要特别关注:
mpp/include:媒体处理头文件mpp/lib:静态库文件(.a)sample/svp:智能视觉处理示例代码drv:外设驱动相关
建议在CMake中通过变量集中管理路径:
set(HISI_SDK_ROOT "/home/user/Hi3519AV100_SDK_V2.0.1.0")
set(HISI_MPP_INCLUDE ${HISI_SDK_ROOT}/mpp/include)
set(HISI_MPP_LIB ${HISI_SDK_ROOT}/mpp/lib)
3.2 链接静态库的技巧
海思的静态库有严格的链接顺序要求,这点可以从官方sample的Makefile.param文件中找到线索。常见的库依赖顺序是:
- 基础库:libmpi.a、libsecurec.a
- 音频处理:libupvqe.a、libdnvqe.a
- 视频处理:libhdmi.a、libdsp.a
- ISP相关:libsns_imx290.a、libisp.a
- 智能分析:libive.a、libnnie.a
在CMake中这样配置:
target_link_libraries(my_project
${HISI_MPP_LIB}/libmpi.a
${HISI_MPP_LIB}/libsecurec.a
${HISI_MPP_LIB}/libupvqe.a
${HISI_MPP_LIB}/libhdmi.a
# 其他库...
)
4. 典型问题排查指南
4.1 头文件找不到问题
遇到"fatal error: hi_comm.h: No such file"这类错误时,检查以下几点:
- 确认
include_directories()已添加海思头文件路径 - 检查SDK版本是否与芯片型号匹配
- 查看头文件权限是否为可读
4.2 库链接失败处理
当出现"undefined reference to `HI_MPI_SYS_Init'"时:
- 确认链接了libmpi.a库
- 检查库文件路径是否正确
- 尝试调整库的链接顺序
4.3 内存对齐问题
海思芯片对内存对齐有特殊要求,在CMake中可添加:
add_compile_options(-mfloat-abi=softfp -march=armv7-a)
5. 进阶优化技巧
5.1 模块化项目管理
对于大型项目,推荐采用这样的目录结构:
project/
├── CMakeLists.txt
├── core/ # 核心算法
├── mpp/ # 海思MPP封装
├── thirdparty/ # 第三方库
└── platform/ # 平台相关代码
对应的CMake配置示例:
# 主CMakeLists.txt
add_subdirectory(core)
add_subdirectory(mpp)
# 链接时自动处理依赖关系
target_link_libraries(main_app
PRIVATE core_lib mpp_lib
)
5.2 交叉编译调试
在VSCode中配置launch.json:
{
"version": "0.2.0",
"configurations": [
{
"name": "GDB Remote Debug",
"type": "cppdbg",
"request": "launch",
"program": "${workspaceFolder}/build/app",
"miDebuggerServerAddress": "192.168.1.100:2000",
"miDebuggerPath": "/opt/hisi-linux/x86-arm/arm-himix200-linux/bin/arm-himix200-linux-gdb"
}
]
}
6. 实战案例:视频分析项目
最近用这套环境完成了一个智能交通项目,核心CMake配置如下:
# 视频分析管道配置
set(VIDEO_SOURCES
src/video_input.cpp
src/video_analysis.cpp
src/video_output.cpp
)
# 添加可执行文件
add_executable(traffic_analysis ${VIDEO_SOURCES})
# 链接海思库
target_link_libraries(traffic_analysis
${HISI_LIBS}
opencv_core
opencv_videoio
)
项目上线后运行稳定,CPU占用率比原Makefile版本降低了15%。这充分证明了CMake在海思平台的应用价值。
1096



被折叠的 条评论
为什么被折叠?



