本编介绍如何在嵌入式Linux开发板上配置Qt运行环境,并进行Qt程序运行测试。

[TOC]

1 tslib编译

tslib之前在测试触摸屏的时候使用过,这里再来记录一下编译过程。

下载tslib库的源码:https://github.com/libts/tslib/tags

将下载的源码拷贝到ubuntu虚拟机中,然后解压:

1
tar xvf tslib-1.21.tar.bz2 

编译 tslib 的时候需要先在 ubuntu 中安装一些文件:

1
2
3
sudo apt-get install autoconf 
sudo apt-get install automake
sudo apt-get install libtool

在 ubunt中创建一个名为“tslib”的目录存放编译结果,然后执行以下指令进行编译:

1
2
3
4
./configure --host=arm-linux-gnueabihf ac_cv_func_malloc_0_nonnull=yes --cache-file=arm-linux.cache -prefix=/home/xxpcb/myTest/imx6ull/otherlib/tslib-2/tslib

make
make install

编译完成后,make install会将编译成果复制到指定的tslib目录中:

将tslib文件夹先整个打包为arm-tslib.tar.bz2文件,后面移植到开发板时用:

1
tar -jcf arm-tslib.tar.bz2 tslib 

2 Qt源码编译

2.1 下载Qt5的源码

下载地址:https://download.qt.io/archive/qt/5.15/5.15.2/single/

将下载的qt-everywhere-src-5.15.2.tar.xz拷贝到Ubuntu中,然后解压:

1
tar -xvf qt-everywhere-src-5.15.2.tar.xz 

2.2 修改qmake.conf

修改**qtbase/mkspecs/linux-arm-gnueabi-g++/**中的qmake.conf文件

这个文件默认的内容是:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
#
# qmake configuration for building with arm-linux-gnueabi-g++
#

MAKEFILE_GENERATOR = UNIX
CONFIG += incremental
QMAKE_INCREMENTAL_STYLE = sublib

include(../common/linux.conf)
include(../common/gcc-base-unix.conf)
include(../common/g++-unix.conf)

# modifications to g++.conf
QMAKE_CC = arm-linux-gnueabi-gcc
QMAKE_CXX = arm-linux-gnueabi-g++
QMAKE_LINK = arm-linux-gnueabi-g++
QMAKE_LINK_SHLIB = arm-linux-gnueabi-g++

# modifications to linux.conf
QMAKE_AR = arm-linux-gnueabi-ar cqs
QMAKE_OBJCOPY = arm-linux-gnueabi-objcopy
QMAKE_NM = arm-linux-gnueabi-nm -P
QMAKE_STRIP = arm-linux-gnueabi-strip
load(qt_config)

修改成如下:

2.3 配置编译选项

查看编译选项,输入./configure -help 指令,查看可配置选项

1
./configure -help

可以看到配置项有很多,因此可以使用一个配置脚本来进行配置。

编写一个autoconfigure.sh文件,然后根据自己的情况,写入如下配置:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
./configure -prefix /home/xxpcb/myTest/imx6ull/otherlib/qt/qt-everywhere-src-5.12.9/arm-qt \
-opensource \
-confirm-license \
-release \
-strip \
-shared \
-xplatform linux-arm-gnueabi-g++ \
-optimized-qmake \
-c++std c++11 \
--rpath=no \
-pch \
-skip qt3d \
-skip qtactiveqt \
-skip qtandroidextras \
-skip qtcanvas3d \
-skip qtconnectivity \
-skip qtdatavis3d \
-skip qtdoc \
-skip qtgamepad \
-skip qtlocation \
-skip qtmacextras \
-skip qtnetworkauth \
-skip qtpurchasing \
-skip qtremoteobjects \
-skip qtscript \
-skip qtscxml \
-skip qtsensors \
-skip qtspeech \
-skip qtsvg \
-skip qttools \
-skip qttranslations \
-skip qtwayland \
-skip qtwebengine \
-skip qtwebview \
-skip qtwinextras \
-skip qtx11extras \
-skip qtxmlpatterns \
-make libs \
-make examples \
-nomake tools -nomake tests \
-gui \
-widgets \
-dbus-runtime \
--glib=no \
--iconv=no \
--pcre=qt \
--zlib=qt \
-no-openssl \
--freetype=qt \
--harfbuzz=qt \
-no-opengl \
-linuxfb \
--xcb=no \
-tslib \
--libpng=qt \
--libjpeg=qt \
--sqlite=qt \
-plugin-sql-sqlite \
-I/home/xxpcb/myTest/imx6ull/otherlib/tslib-2/tslib/include \
-L/home/xxpcb/myTest/imx6ull/otherlib/tslib-2/tslib/lib \
-recheck-all

注意其中3处是自己的配置路:
1 /home/xxpcb/myTest/imx6ull/otherlib/qt/qt-everywhere-src-5.12.9/arm-qt 为编译输出路径。
2 /home/xxpcb/myTest/imx6ull/otherlib/tslib-2/tslib/include 为tslib 头文件路径。
3 /home/xxpcb/myTest/imx6ull/otherlib/tslib-2/tslib/lib 为tslib相关库文件路径。

其它一些参数的含义:

  • -opensource:构建Qt的开源版本

  • -release:使用release版本的Qt

  • -xplatform linux-arm-gnueabi-g++:指定编译器

  • -skip qt3d:跳过Qt的3d

  • -make libs:编译要用到的库

  • -make examples:编译生成Qt的例程代码

  • -nomake tools:不生成Qt的工具

  • -no-openssl:不使用openssl

2.4 编译

配置前需要先安装 g++

1
sudo apt-get install g++

赋予脚本可执行权限,然后执行 autoconfigure.sh

1
2
chmod +x autoconfigure.sh
./autoconfigure.sh

运行完成之后:

然后就可以执行make指令进行编译了。

编译大约需要十几到几十分钟。

编译完成之后,再执行make install进行安装,安装之后就可以看到arm-qt文件中的内容了:

将qrm-qt文件夹先整个打包为arm-qt.tar.bz2文件,后面移植到开发板时用:

1
tar -jcf arm-qt.tar.bz2 arm-qt

2.5 编译出错的问题

make编译时可能会遇到编译出错

  • 情况1:我遇到过下面这种:

这种情况是因为我的ubuntu虚拟机空间不够用了,解决方法就是给虚拟器扩容,具体操作过程见:

  • 情况2:编译最新版本的QT源码报错

使用Qt最新版本5.15.2编译报错,暂未找到解决方法,所以我先用5.12.9版本的Qt。

3 开发板上配置Qt环境

3.1 复制tslib和Qt的编译文件

将之前打包的arm-tslib.tar.bz2和arm-qt.tar.bz2压缩包复制到板子中,可以先复制到nfs网络位置,然后解压到/usr/lib 目录下,解压后开删除无用的压缩包。

这是对arm-qt的操作步骤:

1
2
3
4
cp arm-qt.tar.bz2 ~/myTest/nfs/rootfs/usr/lib
cd ~/myTest/nfs/rootfs/usr/lib/
tar xf arm-qt.tar.bz2
rm arm-qt.tar.bz2

arm-tslib复制与解压过程类似。

3.2 设置开发板的环境变量

编辑/etc/profile,写入如下内容:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
export TSLIB_ROOT=/usr/lib/arm-tslib 
export TSLIB_CONSOLEDEVICE=none
export TSLIB_FBDEVICE=/dev/fb0
export TSLIB_TSDEVICE=/dev/input/event1
export TSLIB_CONFFILE=$TSLIB_ROOT/etc/ts.conf
export TSLIB_PLUGINDIR=$TSLIB_ROOT/lib/ts
export TSLIB_CALIBFILE=/etc/pointercal
export LD_PRELOAD=$TSLIB_ROOT/lib/libts.so

export QT_ROOT=/usr/lib/arm-qt
export QT_QPA_GENERIC_PLUGINS=tslib:/dev/input/event1
export QT_QPA_FONTDIR=/usr/share/fonts
export QT_QPA_PLATFORM_PLUGIN_PATH=$QT_ROOT/plugins
export QT_QPA_PLATFORM=linuxfb:tty=/dev/fb0
export QT_PLUGIN_PATH=$QT_ROOT/plugins
export LD_LIBRARY_PATH=$QT_ROOT/lib:$QT_ROOT/plugins/platforms
export QML2_IMPORT_PATH=$QT_ROOT/qml
export QT_QPA_FB_TSLIB=1

然后使该配置立即生效:

1
source /etc/profile 

4 Qt运行测试

Qt的编译文件中,自带的Qt的一些例子,可以先来在板子上运行这些例子看看Qt程序能否在板子上正常运行。

这是运行其中的一个程序:

1
/usr/lib/arm-qt/examples/widgets/animation/animatedtiles/animatedtiles

https://www.bilibili.com/video/BV1dZ4y1o7U1?spm_id_from=333.999.0.0