linux GUI-QT5.6移植到Mini2440

大奥特曼打小怪兽 / 2023-05-07 / 原文

----------------------------------------------------------------------------------------------------------------------------
内核版本：linux 5.2.8
根文件系统：busybox 1.25.0
u-boot：2016.05
开发板：Mini2440
----------------------------------------------------------------------------------------------------------------------------

为实现目标嵌入式平台能够正常运行Qt程序，则需要在目标平台上部署QT运行环境。

一、QT编译和安装

1.1 QT版本介绍

QT的版本比较多，容易搞混。现分别介绍：

Qt/X11 ：指用于Linux/Unix的版本。如：我们常用的qt-x11-opensource-src-4.5.3.tar.gz，它是用于PC机linux平台的QT源码；
Qt Windows：指用于Windows的版本；
qt-everywhere：指（在配置时加上不同的参数）既可用于x86，也可用于ARM，如qt-everywhere-opensource-src-4.7.0.tar.gz、qt-everywhere-opensource-src-4.6.1.tar.gz；从Qt4.6开始提供这种源码包；
Qt/Embedded：指用于ARM平台的版本。如qt-embedded-linux-opensource-src-4.5.3.tar.gzz是用于嵌入式ARM的qt源码包；从Qt4.1开始，Qt/Embedded改名为Qtopia Core，又从Qt4.4.1开始，Qtopia Core又改名为Qt for Embedded Linux，一般发行的源码包的名字叫做:qt-embeded-linux-xxxxxx，但是自动Qt4.6开始就不再提供这种源码包了，而是开始提供qt-everywhere源码包；

1.2 qt-everywhere下载

这里我们下载qt-everywhere，这里我们不去选择较新版本，主要由于新版本已经不支持ARMv4t架构了。我们下载5.0版本即可。

国内镜像站点下载地址：

https://download.qt.io/archive（官方）
University of Science and Technology of China (推荐，旧版本较全)
清华大学开源软件镜像站

在ubuntu服务器上下载程序包：

root@zhengyang:/work/sambashare# cd tools
root@zhengyang:/work/sambashare/tools# wget https://download.qt.io/new_archive/qt/5.6/5.6.0/single/qt-everywhere-opensource-src-5.6.0.tar.xz

下载完后，解压程序包：

root@zhengyang:/work/sambashare/tools# tar -xvf  qt-everywhere-opensource-src-5.6.0.tar.xz

1.3 修改qmake.conf

进入 qt-everywhere-opensource-src-5.6.0文件夹，针对Mini2440开发板，修改qmake.conf文件：

root@zhengyang:/work/sambashare/tools# cd  qt-everywhere-opensource-src-5.6.0/
root@zhengyang:/work/sambashare/tools/qt-everywhere-opensource-src-5.6.0/# vim 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

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)

我们需要根据我们安装得交叉编译工具去修改，由于我之前安装的是arm-linux-gcc 4.8.3，

所以这里我们需要按照我们安装的交叉编译工具来修改QMAKE_CC、QMAKE_CXX等配置项：需要指定全路径。

#
# qmake configuration for building with arm-linux-gnueabi-g++
#

MAKEFILE_GENERATOR      = UNIX
CONFIG                 += incremental
QMAKE_INCREMENTAL_STYLE = sublib

QT_QPA_DEFAULT_PLATFORM = linuxfb
QMAKE_CFLAGS += -msoft-float -D__GCC_FLOAT_NOT_NEEDED -march=armv4t -mtune=arm920t
QMAKE_CXXFLAGS += -msoft-float -D__GCC_FLOAT_NOT_NEEDED -march=armv4t -mtune=arm920t

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

# modifications to g++.conf
QMAKE_CC                = /usr/local/arm/4.8.3/bin/arm-none-linux-gnueabi-gcc
QMAKE_CXX               = /usr/local/arm/4.8.3/bin/arm-none-linux-gnueabi-g++
QMAKE_LINK              = /usr/local/arm/4.8.3/bin/arm-none-linux-gnueabi-g++
QMAKE_LINK_SHLIB        = /usr/local/arm/4.8.3/bin/arm-none-linux-gnueabi-g++

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

1.4 配置安装

1.4.1 CMake安装

CMake是一个跨平台的构建工具，其支持程度要好于qmake。CMake的配置更加灵活、强大，也更容易维护。如果是Qt6.0+需要安装CMake，否则忽略即可。

注：是一个比make更高级的编译配置工具，它可以根据不同平台、不同的编译器，生成相应的Makefile或者vcproj项目。

接着回到安装目录，安装CMake:

root@zhengyang:/work/sambashare# cd /work/sambashare/tools
root@zhengyang:/work/sambashare/tools# wget https://github.com/Kitware/CMake/releases/download/v3.21.2/cmake-3.21.2.tar.gz
root@zhengyang:/work/sambashare/tools# tar xf cmake-3.21.2.tar.gz
root@zhengyang:/work/sambashare/tools# cd cmake-3.21.2
root@zhengyang:/work/sambashare/tools/cmake-3.21.2# ./configure
root@zhengyang:/work/sambashare/tools/cmake-3.21.2# make && make install
root@zhengyang:/work/sambashare/tools/cmake-3.21.2# cd ..
root@zhengyang:/work/sambashare/tools# rm -rf cmake-3.21.2

这里我们没有指定安装路径，默认是安装到了 /usr/local/bin路径。

root@zhengyang:/work/sambashare/tools# ll  /usr/local/bin
总用量 47556
drwxr-xr-x  2 root root     4096 5月   7 13:45 ./
drwxr-xr-x 19 root root     4096 5月   7 13:48 ../
-rwxr-xr-x  1 root root 11319992 5月   7 13:45 ccmake*
-rwxr-xr-x  1 root root 11589232 5月   7 13:45 cmake*
-rwxr-xr-x  1 root root 12030672 5月   7 13:45 cpack*
-rwxr-xr-x  1 root root 13098200 5月   7 13:45 ctest*
-rwxr-xr-x  1 root root   230408 8月  27  2022 ffmpeg*
-rwxr-xr-x  1 root root   123424 8月  27  2022 ffplay*
-rwxr-xr-x  1 root root   139168 8月  27  2022 ffprobe*
-rwxr-xr-x  1 root root   136720 8月  27  2022 ffserver*
-rwxr-xr-x  1 root root     1568 8月  27  2022 sdl2-config*

1.4.2 tslib安装

要想Qt 支持触摸需要编译tslib ，以生成触摸相关插件。 tslib 多用于嵌入式系统中，是基本的触摸插件。在上一节linux设备树-LCD触摸屏设备驱动已经介绍了tslib的安装，这里不重复介绍了，当时我们将tslib安装到了ls /work/sambashare/drivers/tslib/tmp/路径下。

我们将其拷贝到/usr/local/tslib路径下：

root@zhengyang:/work/sambashare# ls drivers/tslib/tmp/
bin/     etc/     include/ lib/     share/
root@zhengyang:/work/sambashare# cp drivers/tslib/tmp/* /usr/local/tslib/ -rfd

1.4.3 Qt安装

接着回到qt安装目录：

root@zhengyang:/work/sambashare# cd tools/ qt-everywhere-opensource-src-5.6.0
root@zhengyang:/work/sambashare/tools/ qt-everywhere-opensource-src-5.6.0# sudo mkdir -p /usr/local/qt5.6

接下来配置Qt，在Qt的源码目录下有一个可执行程序 configure, 运行./configure --help 可以看到详细的配置选项。

为了操作方便，可以写一个脚本文件autoconfigure.sh，文容如下：

sudo ./configure -prefix /usr/local/qt5.6 \
-v \
-opensource \
-release \
-confirm-license \
-xplatform linux-arm-gnueabi-g++ \
-shared \
-qt-zlib \
-no-gif \
-qt-libjpeg \
-no-nis \
-no-opengl \
-no-cups \
-no-glib \
-no-dbus \
-no-rpath \
-no-sse2 -no-sse3 -no-ssse3 -no-sse4.1 -no-sse4.2 \
-no-avx \
-no-openssl \
-nomake tools \
-qreal float \
-qt-libpng \
-tslib \
-nomake examples \
-I /usr/local/tslib/include \
-L /usr/local/tslib/lib

-I和-L分别指定头文件目录和库目录，在安装tslib生成的目录tmp中，这里提前将tmp目录复制到/usr/local/tslib中。

赋予配置脚本autoconfigure.sh 可执行权限，然后执行

root@zhengyang:/work/sambashare/tools/ qt-everywhere-opensource-src-5.6.0# sudo apt-get install g++  #配置前请先安装g++,如已安装可忽略
root@zhengyang:/work/sambashare/tools/ qt-everywhere-opensource-src-5.6.0# chmod +x autoconfigure.sh
root@zhengyang:/work/sambashare/tools/ qt-everywhere-opensource-src-5.6.0# ./autoconfigure.sh

配置脚本运行完成之后，就可以进行编译和安装了，大约需要十几到几十分钟：

root@zhengyang:/work/sambashare/tools/ qt-everywhere-opensource-src-5.6.0# make -j4
root@zhengyang:/work/sambashare/tools/ qt-everywhere-opensource-src-5.6.0# make install

注意：make -j4编译时间较长，而且可能出现各种问题，我们先把一些库装下来（不管它有用没用），不然一make就是半小时，实在没那个精力去试哪个没用，建议全部安装。

root@zhengyang:/work/sambashare# sudo apt-get install lib32z1
root@zhengyang:/work/sambashare# sudo apt-get install lib32ncurses5
root@zhengyang:/work/sambashare# sudo apt-get install libncurses5-dev libncursesw5-dev
root@zhengyang:/work/sambashare# sudo apt-get install lib32stdc++6
root@zhengyang:/work/sambashare# sudo apt-get install libc6-dev
root@zhengyang:/work/sambashare# sudo apt-get install libqt5serialport5-dev libudev-dev
root@zhengyang:/work/sambashare# sudo apt-get install dbus
root@zhengyang:/work/sambashare# sudo apt-get install libjpeg-dev

安装完成后查看安装的文件夹：

ls /usr/local/qt5.6

1.5 打包

将 qt5.6文件夹打包为qt5.6.tar.gz文件，以备移植开发板时使用:

root@zhengyang:/work/sambashare# cd /usr/local
root@zhengyang:/usr/local# cp -rfd qt5.6 qt5.6-1    #建立一个副本
root@zhengyang:/usr/local/qt5.6# cd qt5.6
root@zhengyang:/usr/local/qt5.6# rm -rf doc include bin mkspecs qml translations
root@zhengyang:/usr/local/qt5.6# cd ..
root@zhengyang:/usr/local# sudo tar -zcvf qt5.6.tar.gz qt5.6
root@zhengyang:/usr/local# rm -rf qt5.6 && mv qt5.6-1 qt5.6 #删除库目录并将副本名字改回来
root@zhengyang:/usr/local# cp qt5.6.tar.gz /work/nfs_root/rootfs/usr/local/    #拷贝到根文件下

不能直接将lib和plugins目录复制到根文件系统中，这样制作出根文件系统后文件太大，一般会超过了SDRAM的大小64M，uboot烧写文件系统的程序是一次将程序完整读到内存再烧写的，所以无法烧写到Nand Flash。如果用NFS启动当然就没有这些问题。

1.6 配置环境变量

最后在根文件系统添加QT的环境变量：

root@zhengyang:/usr/local# vim /work/nfs_root/rootfs/etc/profile

添加如下内容：

export QTEDIR=/usr/local/qt5.6
export LD_LIBRARY_PATH=/usr/local/qt5.6/lib:$LD_LIBRARY_PATH
export QT_QPA_GENERIC_PLUGINS=tslib
export QT_QPA_FONTDIR=$QTEDIR/lib/fonts 
export QT_QPA_PLATFORM_PLUGIN_PATH=$QTEDIR/plugins  
export QT_QPA_PLATFORM=linuxfb:fb=/dev/fb0:size=240x320:offset=0x0:tty=/dev/tty1
export QT_QPA_FB_TSLIB=1
export LD_PRELOAD=/lib/preloadable_libiconv.so53

最后一行的preloadable_libiconv.so：稍后执行程序时会有如下两条错误信息。

QIconvCodec::convertFromUnicode: using Latin-1 for conversion, iconv_open failed
QIconvCodec::convertToUnicode: using Latin-1 for conversion, iconv_open failed

需要安装libiconv-1.14.tar.gz.

1.6.1 libiconv库安装

下载源码：

root@zhengyang:/work/sambashare# cd /work/sambashare/tools/
root@zhengyang:/work/sambasharetools# wget xxxx
root@zhengyang:/work/sambasharetools# mkdir -p /usr/local/libiconv    #安装到这个目录

解压源码：

root@zhengyang:/work/sambashare/tools# tar xzvf libiconv-1.14.tar.gz

进入源码进行配置：

cd libiconv-1.14
CC=arm-linux-gcc ./configure --host=arm-linux --prefix=/usr/local/libiconv  CFLAGS="-march=armv4t -O2 -Wall -W" --enable-static

编译

make
sudo make install
cd /usr/local/libiconv/lib
cp preloadable_libiconv.so /work/nfs_root/rootfs/lib    #拷贝到文件系统

二、安装QT Creator

二、根文件系统制作

三、QT应用程序测试

参考文章

[1]移植QT5.6到JZ2440

[2]一、搭建通用Arm平台的QT交叉编译环境

[3]嵌入式Linux下的Qt环境搭建

[4]嵌入式Linux--交叉编译安装Qt5.12.9