经过为期3天的编译、移植,终于将Qt5.7成功移植到iTop4412开发板,板载exynos4412处理器,基于ARM Cortex-A9内核。因此,本篇教程以iTop4412示例,适用于Qt5.7在ARM_Linux平台上的移植。
——————————————————————————————————————————–
提示:
针对移植中可能出现的问题,已整理好列在附录部分,需要查看的请直接跳到最后部分。
———————————————————————————————————-
目标机硬件平台:支持MMU的ARM嵌入式设备
(ARM7及以下芯片不支持MMU,不可运行Linux系统,只能运行RTOS,如uC linux,freeRTOS,本教程以linux最小系统示例)
目标机软件平台:arm_Linux最小系统(busybox+Linux3.0.15内核+rootfs根文件系统)
开发机硬件平台:x86/x64 PC机
开发机软件平台:Windows 7操作系统+QtCreator4_win版
、安装Ubuntu12.0.4操作系统的虚拟机+QtCreator4_linux版
示例移植应用:serial_Linux工程
(注:serial_Linux是针对桌面Linux系统移植好的PC端程序(x86/x64平台),无需交叉编译。将应用移植到ARM平台时,需要交叉编译。)
1.准备相关开发包
以下采用的系统为ubuntu16.04,开发板为迅为iTOP4412,4.3寸屏。
qt5.7源码qt-everywhere-opensource-src-5.7.0.tar.xz
http://www.download3k.com/Install-Qt.html
ARM交叉编译工具
arm-2014.05-29-arm-none-Linux-gnueabi-i686-pc-linux-gnu.tar.bz2
http://www.veryarm.com/arm-none-linux-gnueabi-gcc
tslib1.4
http://vdisk.weibo.com/s/AcUHxOERV2k0?sudaref=www.baidu.com
2.安装arm交叉编译器arm-2014
将“arm-2014.05-29-arm-none-linux-gnueabi-i686-pc-linux-gnu.tar.bz2”解压到Ubuntu 系统的文件夹“/usr/local/arm”中。
然后修改环境变量,切换到home目录,然后输入命令“vim .bashrc”,打开设置环境变量的文件“.bashrc”,将环境变量修改为“export PATH=$PATH:/usr/local/arm/arm-2014.05/bin”
保存退出,然后更新一下环境变量,输入命令
source .bashrc
接着测试一下,编译器路径设置的对不对。在Ubuntu 命令行中输入命令”arm”,
然后按键盘”Tab”,出现编译器“arm-none-linux-gnueabi-gcc-4.8.2”,这就说明编译
器路径设置正确。
3.交叉编译tslib1.4
对触摸屏信号的获取、校正、滤波处理,均采用开源的tslib,本文采用的tslib版本为最新的tslib1.4
1).将tslib1.4拷贝到/home/lz/transplant目录下(可以根据自己的系统选择某一目录),然后执行解压缩命令
tar -vxf tslib-1.4.tar.gz
2)切换到tslib目录:
cd tslib
安装交叉编译tslib必须的一些工具(可以先查看是否已安装)
sudo apt-get install autoconfsudo apt-get install automakesudo apt-get install libtool
3).利用脚本写编译过程
在tslib文件夹下新建文件configTslib14.sh
vi configTslib14.sh
内容如下:
#!/bin/sh
make clean && make distcleanecho “ac_cv_func_malloc_0_nonnull=yes” >arm-linux.cache
CC=/usr/local/arm/arm-2014.05/bin/arm-none-linux-gnueabi-gcc ./configure –host=arm-linux –prefix=/opt/tslib1.4 –cache-file=arm-linux.cache
make && make install
然后运行configTslib14.sh
./configTslib14.sh
执行结束后,我们查看一下是否安装成功,执行命令:
ls /opt/tslib1.4
如果出现bin,etc,include,lib这4个目录,如下图所示,说明交叉编译并安装tslib成功。
4.交叉编译QT5.7.0
1)将qt-everywhere-opensource-src-5.7.0.tar.gz执行如下命令解压:
tar -vxf qt-everywhere-opensource-src-5.7.0.tar.gz
cd qt-everywhere-opensource-src-5.7.0
2)修改交叉编译架构用到的信息:
gedit qtbase/mkspecs/linux-arm-gnueabi-g++/qmake.conf
修改如下所示:
## qmake configuration for building with arm-linux-gnueabi-g++#
MAKEFILE_GENERATOR = UNIX
CONFIG += incremental
QMAKE_INCREMENTAL_STYLE = sublib
QT_QPA_DEFAULT_PLATFORM = linux #eglfs
QMAKE_CFLAGS_RELEASE += -O2 -march=armv7-a
QMAKE_CXXFLAGS_RELEASE += -O2 -march=armv7-a
include(../common/linux.conf)include(../common/gcc-base-unix.conf)include(../common/g++-unix.conf)
# modifications to g++.conf
QMAKE_CC = arm-none-linux-gnueabi-gcc
QMAKE_CXX = arm-none-linux-gnueabi-g++
QMAKE_LINK = arm-none-linux-gnueabi-g++
QMAKE_LINK_SHLIB = arm-none-linux-gnueabi-g++
# modifications to linux.conf
QMAKE_AR = arm-none-linux-gnueabi-ar cqs
QMAKE_OBJCOPY = arm-none-linux-gnueabi-objcopy
QMAKE_NM = arm-none-linux-gnueabi-nm -P
QMAKE_STRIP = arm-none-linux-gnueabi-stripload(qt_config)
3)创建一个脚本文件,用于生成Makefile,执行命令
gedit autoConfigure.sh
输入下面内容并保存:
#!/bin/sh
./configure \
-v \-prefix /opt/qt-5.7.0 \-release \-opensource \-no-accessibility-make libs \-xplatform linux-arm-gnueabi-g++ \-optimized-qmake \-pch \-qt-sql-sqlite \-qt-zlib \-tslib \-no-opengl \-no-sse2 \-no-openssl \-no-nis \-no-cups \-no-glib \-no-pkg-config \-no-separate-debug-info \-I/opt/tslib1.4/include -L/opt/tslib1.4/lib
其中-prefix /opt/qt-5.7.0代表我们编译完后要安装地址;-tslib代表QT对触摸板的支持,-I 和 -L后面分别为为第一步编译tslib的include和lib的安装目录。
4)执行命令:
chmod 777 qt.configure.sh
./autoConfigure.sh
5)上述命令自动生成Makefile文件。
执行命令启动编译:
make
6)编译大概2个小时。
编译结束后,执行安装命令:
sudo make install
7)我们切换到目标目录下看看是否安装成功:
cd /opt/qt-5.7.0
ls -hl
8)将/opt/qt-5.7.0和/opt/tslib1.4 拷贝到ARM平台对应的文件系统中对应的目录中。
请保证ARM平台已成功移植Linux系统,原则上编译Linux内核的编译器应和编译Qt库的编译器版本一致,否则会出现应用无法运行,缺少必要依赖库的问题,请参看附录《移植常见问题与解决方法》。
5.配置QtCreator交叉编译环境
应用程序需要在ARM平台上运行,也需要交叉编译成对应平台的可执行文件。在QtCreator下直接配置交叉编译环境,一键编译是比较简单易行的方法。
1)在菜单中选择Tools——Options,在弹出的对话框中,选择Build & Run,选择标签Compilers,按下图设置,选择C++交叉编译器,如下图所示:
2)切换到Qt Versions标签,点击“Add”按钮,选择qmake,如图所示:
3)选择完成,按“OK”按钮,设置如图所示:
切换到Kits标签,点击“Add”按钮,然后设置如下图所示:
6.交叉编译待移植的应用程序
基于本SDK开发的应用软件几乎无需修改代码,配置好运行环境后,直接交叉编译通过即可在相应平台上运行,因此只需在开发环境中一键交叉编译后,按以下步骤配置运行环境即可:
1)把字库Ubuntu_L.ttf 等字库拷贝到
/opt/qt-5.7.0/lib/fonts
在开发板串口命令窗口中输入:
vi /etc/profile
如下图所示
:
将其修改为以下内容
export TSLIB_ROOT=/opt/tslib1.4
export QT_ROOT=/opt/qt-5.7.0
export TSLIB_TSDEVICE=/dev/input/event2
export TSLIB_TSEVENTTYPE=input
export TSLIB_CONFFILE=/opt/tslib1.4/etc/ts.conf
export TSLIB_PLUGINDIR=/opt/tslib1.4/lib/ts
export TSLIB_CONSOLEDEVICE=none
export TSLIB_FBDEVICE=/dev/fb0
export QWS_MOUSE_PROTO=tslib:/dev/input/event2
export LD_LIBRARY_PATH=/lib:/usr/lib:/usr/local/lib:QTROOT/lib:TSLIB_ROOT/lib:$TSLIB_ROOT/lib/
export QT_QPA_PLATFORM_PLUGIN_PATH=$QT_ROOT/plugins
export QT_QPA_PLATFORM=linuxfb:tty=/dev/fb0
export QT_QPA_FONTDIR=$QT_ROOT/lib/fonts
export QT_QPA_GENERIC_PLUGINS=tslib
保存退出,执行命令(一定要执行,否则可能报错):
source /etc/profile
2)然后在串口命令窗中输入 vi /opt/tslib1.4/etc/ts.conf 来配置触摸屏
把第二行的注释去掉,把ts设置成输入模式(注意把前面的空格也去掉)
3)将交叉编译好的应用软件拷贝到ARM平台上测试。
————————————————————————————————————————————————————
附录
常见移植问题汇总
1.Ubuntu64位系统在执行arm交叉编译器可能会出现如下看似莫名的问题:
环境变量配置正确,目录下也能找到相关编译器,执行编译时却仍报找不到编译器或目录的错误。
原因分析:这是由于编译器是32位的,在如Ubuntu64这样的64位linux系统下运行会缺少32位系统的运行库。
解决:64位linux系统上安装32位运行库,执行如下命令:
sudo apt-get install ia-32 libs
2.Win下直接拷贝过去的脚本执行错误
原因分析:
Linux系统的换行符为\n,而win下为\n\r,故直接拷贝到linux下执行会报错。
解决:执行命令将脚本中所有以\r结束的字符替换为空白:
sed -i ‘s/\r$//’ autoConfig.sh
3.Project ERROR:Unknown module(s) in QT: quick-private
在编译过程中出现错误:
Project ERROR:Unknown module(s) in QT: quick-private
make[2]: *[sub-quickwidgets-make_first-ordered] 错误 3
make[2]:正在离开目录
/home/jason/work/qt-everywhere-opensource-src-5.3.0/qtdeclarative/src’
make[1]: ***[sub-src-make_first] 错误 2
make[1]:正在离开目录
/home/jason/work/qt-everywhere-opensource-src-5.3.0/qtdeclarative’
make: *[module-qtdeclarative-make_first] 错误 2
原因分析:在qt5.7中,quickwidgets模块依赖quick模块,quick模块有依赖openGL,检查配置参数,发现在./configure添加了参数-no -opengl,
解决:在./configure去掉参数-no -opengl
提示:类似的问题多半是因为依赖问题,所以在初次编译时,格外需要注意./configure中的配置参数选取。
4.在编译的时候提示:
cannot find –lxxxx
原因分析:找不到libxxxx.so
解决:把libxxxx.so拷贝到交叉编译工具链的库目录就可以
例如:如果编译触摸屏出现找不到-lts,可以在tslib/lib目录下执行:
sudo cp libts-0.0.so.0.1.1
/usr/local/arm/arm-2014.05/arm-none-Linux-gnueabi/libc/thumb2/lib/libts.so
其中/usr/local/arm/arm-2014.05/是我的交叉编译工具链的安装目录。
5.在开发板运行过程中,假如运行有提示:
Illegal instruction (非法指令)
原因分析:这里很可能是因为对芯片的指令集没有选择好
解决:
在 /qtbase/mkspecs/linux-arm-gnueabi-g++/qmake.conf文件加入对应的参数,例如
QMAKE_CFLAGS_RELEASE += -O2 -march=armv7-a
QMAKE_CXXFLAGS_RELEASE += -O2 -march=armv7-a
6.运行时报错:
‘GLIBC_2.9’not found:/lib/lib.so.6
原因分析:linux系统和Qt库不匹配导致,确切地说应该是交叉编译链的版本不匹配导致。原则上应该用编译Qt库的编译器交叉编译Linux内核,制作相应的Linux最小系统。现提供一种间接解决方案。
解决:将编译Qt库的arm交叉编译器下的对应lib文件夹拷贝到Linux系统根目录下的lib,完全覆盖,arm编译器下的lib是已经交叉编译好的,可以直接拷贝解决linux系统的运行库问题。
7.运行时报错找不到libstdc++.so.6
原因分析:同理,找不到c++运行库的问题。
解决:将arm编译器下的lib找到拷贝到linux根文件系统的lib下。
8.运行时报错
原因分析:未更新ARM—Linux的环境变量或环境变量配置有误。
解决:
1.检查/etc/profile下的配置(参照移植步骤里的配置)
2.更新环境变量,执行:
source /etc/profile