我用STM32MP1做了个疫情监控平台2—Qt环境搭建

嵌入式Linux

Posted by Wang Chao on March 5, 2020

0.系列教程

1.嵌入式Qt简介

Qt 是一个跨平台的应用程序开发框架。使用Qt开发的应用程序,只需要编写一套代码,然后把这套代码放在不同平台的Qt环境去编译,就会生成可以运行在对应平台的应用程序。例如,我在Windows写了一个串口助手,这套代码不用修改,放在Linux环境下的Qt开发环境,重新编译,就可以生成可以在Linux环境下运行的串口助手,当然,Qt支持的环境有很多。不同平台下的移植,只需要修改很小一部分或者不用修改就可以直接运行。

嵌入式Qt,即QtE,属于Qt Embedded Linux 分支平台。Qt/E 所面对的硬件平台较多,当开发人员需要在某硬件平台上移植 Qt/E 时,需要下载Qt 源代码,利用交叉编译器编译出 Qt 库。接着需要将 Qt 库复制两份,一份放置在开发主机上,供编译使用;一份放在目标板上,供运行时动态加载使用。

2.查看开发板Qt库的版本

要想在开发板上运行Qt程序,首先板子的系统要支持Qt图形库,而且要确定这个的库的版本。那么怎么看开发板是否支持Qt呢?可以使用find搜索命令,搜索本地所有Qt相关的文件:

#进入到根目录
cd /

#搜索qt相关的文件
find -name "*Qt*"
#或者
find -name "*qt*"

如果搜索结果有很多so类型的文件,说明这个开发板上的系统是支持Qt的,而且后面的数字就是当前Qt库的版本号。

可以看出,现在的系统是支持Qt的,库的版本是5.11.2。

3.主机搭建Qt环境

3.1 安装桌面版本Qt开发套件

安装桌面版本的 Qt 开发套件,用户可以先在 PC 主机上进行 Qt 应用程序的开发和调试,待应用程序完成之后,再使用嵌入式Qt套件构建一下,就可以生成可以在开发板上运行的目标程序。由于开发板上的Qt库版本是5.11版本的,建议桌面Qt版本尽量也是5.11版本的,如果不一致影响也不大。如果你的电脑上已经安装了Qt 5 Linux版本,这一节可以跳过。由于我的电脑之前已经安装了5.8版本的,所以不再重新安装。

  • 下载 Qt

Qt 安装包从Qt 5版本开始提供Linux版本的独立安装包,而不需要自己编译。在之前的Qt 4版本,是没有Linux安装包的。

官方下载地址:Index of /archive/qt

最好选择Qt 5.8以上,要选择Linux版本的,如qt-opensource-linux-x64-5.11.0.run,这个安装包是桌面Qt程序开发套件,包括qmake、QtCreator等工具。

实测官方下载速度还是非常快的,如果下载速度慢,可以转到国内的镜像地址:清华大学Qt下载镜像地址,下载速度会很快。

  • 安装 Qt

下载完成之后,直接双击安装就可以了,如果不能安装尝试添加可执行权限,或者以sudo权限执行:

#添加可执行权限
sudo chmod +x ./qt-opensource-linux-x64-5.11.0.run

#安装
sudo ./qt-opensource-linux-x64-5.11.0.run

#安装路径可根据需要选择
#其他选择默认安装配置就行了

安装完成之后:

其中MaintenanceTool是Qt的安装管理程序,运行这个文件可卸载Qt。

  • 启动 Qt

安装完成之后,可以在Ubuntu搜索Qt关键字,点击Qt Creator启动Qt环境。

你也可以进入到/Qt5.8.0/Tools/QtCreator/bin文件夹去启动Qt,如果启动失败,添加sudo 权限试试。

3.2 添加嵌入式Qt构建套件

搭建一个最基本的Qt环境,需要两个东西:qmake和编译器。在安装桌面版本 Qt 时,已经默认添加了桌面环境的Qt构建套件:

  • 桌面版本qmake:Qt5.8.0/5.8/gcc_64/bin/qmake
  • 桌面版本编译器:ubuntu 自带的GCC

为了编译可以在开发板上运行的Qt程序,我们还需要配置一个开发嵌入式Qt程序的构建套件:

#嵌入式qmake路径
/opt/st/stm32mp1/2.6-snapshot/sysroots/x86_64-openstlinux_eglfs_sdk-linux/usr/bin/qmake

#交叉编译器路径:
/opt/st/stm32mp1/2.6-snapshot/sysroots/x86_64-openstlinux_eglfs_sdk-linux/usr/bin/arm-openstlinux_eglfs-linux-gnueabi/arm-openstlinux_eglfs-linux-gnueabi-gcc

可以看到嵌入式Qt的版本是5.11.2。知道了qmake和交叉编译器的路径,下面我们在桌面版本Qt中添加一个开发套件,用于构建嵌入式Qt程序。

  • 添加交叉编译器

打开QtCreator之后,点击菜单栏的工具->选项->构建和运行->编译器,添加交叉编译器:

#添加gcc交叉编译器
名称:ya157c_gcc
路径:/opt/st/stm32mp1/2.6-snapshot/sysroots/x86_64-openstlinux_eglfs_sdk-linux/usr/bin/arm-openstlinux_eglfs-linux-gnueabi/arm-openstlinux_eglfs-linux-gnueabi-gcc

#添加g++交叉编译器
名称:ya157c_g++
路径:/opt/st/stm32mp1/2.6-snapshot/sysroots/x86_64-openstlinux_eglfs_sdk-linux/usr/bin/arm-openstlinux_eglfs-linux-gnueabi/arm-openstlinux_eglfs-linux-gnueabi-g++

#添加gdb调试器
名称:ya157c_gdb
路径:/opt/st/stm32mp1/2.6-snapshot/sysroots/x86_64-openstlinux_eglfs_sdk-linux/usr/bin/arm-openstlinux_eglfs-linux-gnueabi/arm-openstlinux_eglfs-linux-gnueabi-gdb

  • 添加嵌入式版本qmake
#嵌入式Qt版本的qmake路径
路径:/opt/st/stm32mp1/2.6-snapshot/sysroots/x86_64-openstlinux_eglfs_sdk-linux/usr/bin/qmake

  • 添加设备

这一步可省略。

#添加一个通用Linux设备
设备类型:通用Linux
设备名称:ya157c
主机名称:192.168.1.136
用户名:root
密码:root

  • 添加嵌入式Qt开发套件

以上都是为了添加开发套件而服务的,开发套件需要指定qmake和编译器等。新建一个构建套件

名称:ya157c
设备类型:通用Linux设备
设备:选择之前添加的ya157c
Sysroot:/opt/st/stm32mp1/2.6-snapshot/sysroots/cortexa7t2hf-neon-vfpv4-openstlinux_eglfs-linux-gnueabi
C编译器:选择之前添加的ya157c_gcc
C++编译器:选择之前添加的ya157c_g++
调试器:选择之前添加的ya157c_gdb
Qt版本:选择之前添加的Qt 5.11.2
Qt mkspec:linux-oe-g++

点击Apply之后,如果构建套件前面有红色或黄色的感叹号,说明构建套件没有设置成功,需要检查配置选项。下面,我们来完成第一个Qt应用程序——Hello World。

4.第一个Qt程序——Hello World

嵌入式Qt应用程序的开发,可以完全按照桌面程序的开发流程:新建工程、设计界面和功能、编译运行。最后使用嵌入式开发套件构建一下,就生成了可以在嵌入式平台运行的Qt应用程序。

我们来设计一个简单的界面,程序只显示一个标签,标签的内容是“Hello World”。在PC上运行正确之后,然后使用ya157c开发套件交叉编译,再把可执行文件传输到开发板上运行,整个过程不需要写一行代码。

桌面效果:

开发板效果

4.1 新建一个工程

  • 新建一个应用程序工程

  • 输入工程名称和保存路径

  • 选择构建套件

就是这个程序在哪些平台上运行,我们选择桌面(Desktop Qt 5.8)和开发板(ya157c)这两个套件,如果只选择了一个,在开发过程中也可以再添加其他的构建套件。

  • 工程创建

  • 界面设计

拖入一个Label,内容是”Hello World”,并调整一下字体和布局。

这样就创建完成了一个最简单的Hello World应用程序。

4.2 PC运行Qt程序

点击左下绿色三角符号,构建并运行,实际效果:

4.3 开发板运行Qt程序

桌面版本运行正常之后,点击左下角电脑标志,切换为ya157c构建套件,再点击底部锤子按钮,交叉编译这个工程。

注意,由于这是交叉编译,所以编译出来的程序不能在本地 PC 机上运行或调试。因此不能点击运行按钮运行程序,也不能点击调试按钮调试程序。

如果构建成功,编译输出的文件默认在当前工程目录的上一级。

可以看到,成功输出了ARM平台下运行的可执行文件。通过scp或其他方式把文件传输到开发板:

#scp传输可执行文件到开发板
scp hello_world root@192.168.1.136:/home/root

连接HDMI显示器或RGB显示屏,我使用的是7寸IPS屏,1024*600分辨率。

开发板运行效果:

5.一些问题

  • 交叉编译时报错

桌面Qt套件编译时,正常。但是使用交叉编译套件编译会提示错误:

可以通过执行以下命令,复制相应的库文件:

#切换到库所在的文件夹
cd /opt/st/stm32mp1/2.6-snapshot/sysroots/cortexa7t2hf-neon-vfpv4-openstlinux_eglfs-linux-gnueabi/vendor/lib/

#复制库文件
cp -d * ../../lib/

复制完成之后,再编译就不会报错了。

  • 液晶屏不能显示程序界面

如果在运行Qt程序时,出现如下提示:

QStandardPaths: XDG_RUNTIME_DIR not set, defaulting to '/tmp/runtime-root'
qt.qpa.input: X-less xkbcommon not available, not performing key mapping
Could not queue DRM page flip on screen HDMI1 (Device or resource busy)

或者可以运行,但字体太小了。可以尝试在运行程序之前,先执行以下命令,再运行Qt程序

psplash-drm-quit
export QT_QPA_EGLFS_ALWAYS_SET_MODE="1"
export QT_QPA_EGLFS_PHYSICAL_WIDTH=150
export QT_QPA_EGLFS_PHYSICAL_HEIGHT=90

其中,150和90是显示屏的物理尺寸,长150mm,宽90mm。

  • 编译输出到当前工程文件夹下

Qt工程编译输出的Debug/Release目录是在当前工程目录的上一级:

../build-%{CurrentProject:Name}-%{CurrentKit:FileSystemName}-%{CurrentBuild:Name}

可以改为和工程文件同一目录下:

./build-%{CurrentProject:Name}-%{CurrentKit:FileSystemName}-%{CurrentBuild:Name}

去掉一个.就好了。

然后关闭工程,删除工程目录下的.user文件,重新导入,编译。

这样编译目录就在工程目录下了:

系列教程