鸿鸥派板端QT移植教程

目录

1. QT源码下载

2. QT源码编译

2.1. 解压QT源码

2.2. 修改qmake

2.3. configure 配置

2.4. 编译与安装

3. HIFB/GFBG 适配

3.1. 修改linuxfb插件

3.2. 编译

4. 板端环境部署

4.1. 添加板端QT运行环境

4.2. linuxfb 插件

4.3. QT依赖库

4.4. 字库

5. 板端测试QT程序

1. QT源码下载

官网链接：https://download.qt.io/archive/qt/

2. QT源码编译

2.1. 解压QT源码

tar -xvf qt-everywhere-opensource-src-5.15.16.tar.xz

2.2. 修改qmake

进入 qt-everywhere-src-5.15.16/qtbase/mkspecs/目录，复制一份 linux-aarch64-linux-gnu-g++为 aarch64-v01c01-linux-gnu-g++， 打开文件夹下面文件 qmake.conf, 将”aarch64-linux-gnu-” 替换为”aarch64-v01c01-linux-gnu-“， 如下图所示：

2.3. configure 配置

(1) 回到源码根目录， 新建 auto_build.sh 并添加以下配置：auto_build.sh

注意：以上配置做了一定的裁剪，可按需进行修改。

-prefix "$PWD"/Hi3519DV500_QT_INTASLL : 指定安装路径为源码目录Hi3519DV500_QT_INTASLL。
 
-xplatform aarch64-v01c01-linux-gnu-g++ : 指定编译器为aarch64-v01c01-linux-gnu-g++

(2) 执行./auto_build.sh , 出现以下信息则说明配置没问题。

2.4. 编译与安装

源码目录执行 make && make insatll

make && make insatll 

3. HIFB/GFBG 适配

参考文档以及代码：

ReleaseDoc\zh\01.software\board\MPP\GFBG 开发指南.pdf
ReleaseDoc\zh\01.software\board\MPP\GFBG API 参考.pdf
Hi3519DV500_SDK_V2.0.2.0/smp/a55_linux/source/mpp/sample/gfbg/sample_gfbg.c

HIFB/GFBG 相关说明可参考以上文档，以下不进行详细描述，只总结以下两个要点：

• HIFB/GFBG 开启前，必须先打开 VO 设备。
• colorkey 功能能让 QT 层设置成配置的颜色时透明，从而达到显示视频层的效果。

3.1. 修改linuxfb插件

(1) 进入源码目录 qt-everywhere-src-5.15.16/qtbase/src/plugins/platforms，复制一份 linuxfb 并改名为 linuxfb_hi3519dv500

(2) 修改qlinuxfbscreen.cpp 代码进行以下修改：

a. 设置FB 输出大小

b. 在 initialize 函数中添加海思相关 HIFB/GFBG 配置，相关代码参考于Hi3519DV500_SDK_V2.0.2.0/smp/a55_linux/source/mpp/sample/gfbg/sample_gfbg.c

c. 绘制函数 doRedraw 中修改为对 HIFB/GFBG 画布更新

d. 析构函数 QLinuxFbScreen 释放相关资源

3.2. 编译

(1) linuxfb.pro 适配

a. 拷贝 HIFB/GFBG 相关库文件和头文件到qt-everywhere-src-5.15.16/qtbase/src/plugins/platforms/linuxfb_hi3519dv500 目录下，相关库文件和头文件可从 SDK 目录 Hi3519DV500_SDK_V2.0.2.0/smp/a55_linux/source/out 中获取，可以先一次性复制 lib 和 include 目录。

b. 修改linuxfb.pro 文件

c. 需要依赖的头文件和库

(2) 编译插件

进入 qt-everywhere-src-5.15.16/qtbase/src/plugins/platforms/linuxfb_ss928v100 目录，打开终端,执行下图命令，即可生成 makefile

执行 make 操作，即可在目录 qt-everywhere-src-5.15.16/qtbase/plugins/platforms 生成libqlinuxfb_hi3519dv500.so 文件。

4. 板端环境部署

4.1. 添加板端QT运行环境

板端/etc/profile 文件中添加 QT 运行环境

export QT_QPA_PLATFORM_PLUGIN_PATH=/opt/plugins
export LD_LIBRARY_PATH=/opt/lib/
export QT_QPA_PLATFORM=linuxfb:tty=/dev/fb0
export QT_QPA_PLATFORM=linuxfb:fb=/dev/fb0:size=1920x1080:offset=0x0:nographicsmodeswitch
export QT_QPA_FONTDIR=/opt/fonts

注意：

a).size=1920x1080， 尽量与 libqlinuxfb_hi3519dv500.so 插件里 FBIOPUT_VSCREENINFO 设置的大小一致；

b).load3519dv500 中 gfbg.ko 参数配置, 参考 ReleaseDoc\zh\01.software\board\MPP\GFBG 开发指南.pdf 2.模块加载。

4.2. linuxfb 插件

拷贝libqlinuxfb_ss928v100.so 插件到板端/opt/plugins 目录下

4.3. QT依赖库

拷贝 QT 相关库到板端/opt/lib 目录下，仅拷贝测试验证相关库，如果程序中依赖了其他 QT 库，也需要拷贝到该目录下

4.4. 字库

拷贝字符文件到板端/opt/fonts 下，OPlusSans3-Medium.ttf 为一加开源免费使用的字库

5. 板端测试QT程序

(1) 修改并编译 QT 测试程序，以qt-everywhere-src-5.15.16/qtbase/examples/widgets/animation/moveblocks 为例。

(2) 在该目录下打开终端执行如下图命令, 生成 makefile，执行 make 生成可执行程序moveblocks

(3) 拷贝 moveblocks 到板端， 由于 HIFB/GFBG 的运行依赖 VO 设备的开启，板端需运行相关程序例如 sample_v io 打开 VO 设备。

fb插件未过滤颜色

代码修改后

代码修改前