一文教你在ZPC上快速移植AWTK

最新推荐文章于 2024-10-05 16:31:59 发布

ZLG_zhiyuan

最新推荐文章于 2024-10-05 16:31:59 发布

阅读量1.2k

点赞数 13

分类专栏：嵌入式工控机 AWTK 开源GUI引擎文章标签：嵌入式硬件

本文链接：https://blog.csdn.net/ZLG_zhiyuan/article/details/141892469

版权

嵌入式工控机同时被 2 个专栏收录

5 篇文章 0 订阅

订阅专栏

AWTK 开源GUI引擎

3 篇文章 0 订阅

订阅专栏

ZPC是ZLG全新研发的显控一体机。开源AWTK，版权无忧！多种工业通信协议，工业互联无壁垒！ZWS数据上云很轻松！更有AWFlow，应用开发很简单！本文将介绍如何在ZPC上快速移植AWTK。

ZPC简介

ZPC系列显控一体机 是广州致远电子全新研发的集“显示”+“控制”一体化的高性能显控终端产品。外框采用铝合金材质，简洁耐用；产品集成了多路隔离RS485、多路隔离CAN总线、多路千兆以太网等丰富外设。一触即发，随心控制。产品支持多种工业通信协议，工业互联无壁垒！支持ZWS，数据上云很轻松！支持AWFlow，应用开发很简单！还支持开源AWTK GUI，版权无忧！可以快速创作您的HMI作品。

AWTK简介

AWTK全称为Toolkit AnyWhere，是ZLG倾心打造的一套基于C语言开发的开源GUI框架。旨在为用户提供一个功能强大、高效可靠、简单易用、可轻松做出炫酷效果的GUI引擎；支持跨平台同步开发，一次编程，随处编译，跨平台终身使用，无版权费用担忧！

准备工作

装有Ubuntu系统或Ubuntu虚拟机的可连接外网的PC 1台；
ZPC-101Q55RTW-01显控一体机1台；
USB转RS232调试串口1个；
12V@2A的电源适配器1个；
MobaXterm串口调试上位机；
TF卡或U盘或网线等。

移植过程

1. 环境准备

AWTK代码已在gitee和github上开源，国内推荐访问速度更快的gitee：

https://gitee.com/zlgopen/awtk

按照以下步骤，在PC虚拟机上进行操作：

host$ sudo apt install gcc-aarch64-linux-gnu git scons 
//使用apt指令下载所需的工具
host$ mkdir awtk-demo && cd awtk-demo
//创建一个新的文件夹
host$ git clone https://gitee.com/zlgopen/awtk.git 
//使用git克隆awtk仓库到本地，awtk为AWTK代码本仓，包含了AWTK最主要的代码
host$ git clone https://gitee.com/zlgopen/awtk-linux-fb.git 
//使用git克隆awtk-linux-fb仓库到本地，awtk-linux-fb为针对嵌入式的Frame buffer机制和DRM机制的仓库
host$ ls
awtk  awtk-linux-fb
host$ cd awtk-linux-fb

2. 安装依赖库

Ubuntu上编辑/etc/apt/sources.list 文件，将它改为如下内容：

deb [arch=amd64] https://mirrors.ustc.edu.cn/ubuntu/ focal main restricted
deb [arch=amd64] https://mirrors.ustc.edu.cn/ubuntu/ focal-updates main restricted
deb [arch=amd64] https://mirrors.ustc.edu.cn/ubuntu/ focal universe
deb [arch=amd64] https://mirrors.ustc.edu.cn/ubuntu/ focal-updates universe
deb [arch=amd64] https://mirrors.ustc.edu.cn/ubuntu/ focal multiverse
deb [arch=amd64] https://mirrors.ustc.edu.cn/ubuntu/ focal-updates multiverse
deb [arch=amd64] https://mirrors.ustc.edu.cn/ubuntu/ focal-backports main restricted universe multiverse
deb [arch=amd64] https://mirrors.ustc.edu.cn/ubuntu/ focal-security main restricted
deb [arch=amd64] https://mirrors.ustc.edu.cn/ubuntu/ focal-security universe
deb [arch=amd64] https://mirrors.ustc.edu.cn/ubuntu/ focal-security multiverse

Ubuntu上编辑/etc/apt/sources.list.d/ubuntu-ports.list ，如果文件不存在，则创建，将它改为如下内容：

deb [arch=arm64,armhf] https://mirrors.ustc.edu.cn/ubuntu-ports/ focal main restricted
deb [arch=arm64,armhf] https://mirrors.ustc.edu.cn/ubuntu-ports/ focal-updates main restricted
deb [arch=arm64,armhf] https://mirrors.ustc.edu.cn/ubuntu-ports/ focal universe
deb [arch=arm64,armhf] https://mirrors.ustc.edu.cn/ubuntu-ports/ focal-updates universe
deb [arch=arm64,armhf] https://mirrors.ustc.edu.cn/ubuntu-ports/ focal multiverse
deb [arch=arm64,armhf] https://mirrors.ustc.edu.cn/ubuntu-ports/ focal-updates multiverse
deb [arch=arm64,armhf] https://mirrors.ustc.edu.cn/ubuntu-ports/ focal-backports main restricted universe multiverse
deb [arch=arm64,armhf] https://mirrors.ustc.edu.cn/ubuntu-ports/ focal-security main restricted
deb [arch=arm64,armhf] https://mirrors.ustc.edu.cn/ubuntu-ports/ focal-security universe
deb [arch=arm64,armhf] https://mirrors.ustc.edu.cn/ubuntu-ports/ focal-security multiverse

由于AWTK触摸功能依赖于tslib触摸库，所以Ubuntu需要下载ARM64架构的tslib。

host$ sudo dpkg --add-architecture arm64 
host$ sudo apt update
host$ sudo apt install libts0:arm64 libts-dev:arm64 libdrm-dev:arm64

3. 修改代码

注：以下修改在awtk-linux-fb目录下

打开awtk_config.py文件，该文件会描述并配置AWTK工程构建时所需环境变量，按照以下内容进行修改，将构建工程配置为DRM模式而非Frame buffer模式。

...
#LCD_DEVICES='fb'
LCD_DEVICES='drm'
...

修改tslib依赖库在本机的位置，Ubuntu默认位置如下：

...
TSLIB_LIB_DIR='/usr/lib/aarch64-linux-gnu/ts0'
TSLIB_INC_DIR='/usr/include'
...

修改编译工具链的指令，再次选择Ubuntu下的arm64交叉编译工具链：

...
TOOLS_PREFIX='aarch64-linux-gnu-'
...

可以使用以下指令确认交叉工具链版本，在Ubuntu 20.04下默认的交叉工具链版本为9.4.x：

host$ aarch64-linux-gnu-gcc -v                        
Using built-in specs.
COLLECT_GCC=aarch64-linux-gnu-gcc
COLLECT_LTO_WRAPPER=/usr/lib/gcc-cross/aarch64-linux-gnu/9/lto-wrapper
Target: aarch64-linux-gnu
Configured with: ../src/configure -v --with-pkgversion='Ubuntu 9.4.0-1ubuntu1~20.04.2' --with-bugurl=file:///usr/share/doc/gcc-9/README.Bugs --enable-languages=c,ada,c++,go,d,fortran,objc,obj-c++,gm2 --prefix=/usr --with-gcc-major-version-only --program-suffix=-9 --enable-shared --enable-linker-build-id --libexecdir=/usr/lib --without-included-gettext --enable-threads=posix --libdir=/usr/lib --enable-nls --with-sysroot=/ --enable-clocale=gnu --enable-libstdcxx-debug --enable-libstdcxx-time=yes --with-default-libstdcxx-abi=new --enable-gnu-unique-object --disable-libquadmath --disable-libquadmath-support --enable-plugin --enable-default-pie --with-system-zlib --without-target-system-zlib --enable-libpth-m2 --enable-multiarch --enable-fix-cortex-a53-843419 --disable-werror --enable-checking=release --build=x86_64-linux-gnu --host=x86_64-linux-gnu --target=aarch64-linux-gnu --program-prefix=aarch64-linux-gnu- --includedir=/usr/aarch64-linux-gnu/include
Thread model: posix
gcc version 9.4.0 (Ubuntu 9.4.0-1ubuntu1~20.04.2)

config文件夹下有文件devices.json.in这一配置文件，该文件配置了AWTK运行时所需物理设备的路径，但在名为devices.json.in时不生效，需要按照以下命令修改名称为devices.json；再打开config/devices.json，修改为以下内容，其中event1为触摸屏设备路径，类型为ts（表示为触摸屏）。

host$ mv config/devices.json.in config/devices.json
{
    "/dev/fb0" : {
        "type" : "fb"
    },
    "/dev/dri/card0" : {
        "type" : "drm"
    },
    "/dev/input/event1" : {
        "type" : "ts"
    }
}

AWTK默认使用鼠标设备进行操作，所以默认情况下界面会有光标显示，在使用触摸屏操作的时候会影响用户体验，如若需要关闭鼠标光标，则需要在scons_argv.py文件中，找到ENABLE_CURSOR定义，并将其value值改为False。

...
  'ENABLE_CURSOR' : { 'value' : False, 'type' : bool.__name__, 'desc' : ['enable cursor mouse'], 'help_info' : 'set enable cursor mouse, value is true or false'},
...

至此，代码修改完成。

4. 编译代码

执行scons指令进行编译工程。

host$ scons

编译完成后会输出log下图所示，如果编译过程中出现寻找不到对应头文件，请返回上文安装依赖库。

接下来执行./release.sh脚本对文件资源进行打包，执行完成后，可以看到生成release文件夹和release.tar.gz压缩文件。release文件夹中，包含了编译生成的可执行文件、awtk库以及相关配置文件，也就是应用程序运行时所需的文件；而release.tar.gz就是对release文件夹的打包。

host$  awtk-linux-fb  ./release.sh
EXE_NAME = demoui
APP_ROOT = ../awtk
==================================================
EXE_NAME:demoui
ASSETS_DIR:../awtk/res/assets
OUTPUT_DIR:/home/felix/Workspace/Testcodes/awtk-demo/awtk-linux-fb/release
BIN_DIR:/home/felix/Workspace/Testcodes/awtk-demo/awtk-linux-fb/bin
==================================================
/home/felix/Workspace/Testcodes/awtk-demo/awtk-linux-fb/bin/demoui->/home/felix/Workspace/Testcodes/awtk-demo/awtk-linux-fb/release/bin/demoui
copy shared lib: /home/felix/Workspace/Testcodes/awtk-demo/awtk-linux-fb/bin/libtkc.so ==> /home/felix/Workspace/Testcodes/awtk-demo/awtk-linux-fb/release/bin/libtkc.so
copy shared lib: /home/felix/Workspace/Testcodes/awtk-demo/awtk-linux-fb/bin/libawtk.so ==> /home/felix/Workspace/Testcodes/awtk-demo/awtk-linux-fb/release/bin/libawtk.so
../awtk/res/assets->/home/felix/Workspace/Testcodes/awtk-demo/awtk-linux-fb/release/assets


host$  awtk-linux-fb  ls -l release.tar.gz
-rw-rw-r-- 1 felix felix 8262509 7月   9 09:52 release.tar.gz

执行示例

拷贝release.tar.gz文件到ZPC一体机的/root文件夹下，并按照以下指令分别执行对应解压命令解压包、设置执行权限等。

[root@zpc:~]# tar -xvf release.tar.gz
......
[root@zpc:~]# chmod +x release/bin/demoui

执行以下指令，即可运行示例demo如下图所示。

[root@zpc:~]# ./release/bin/demoui

设置开机自启动

默认系统会进入Debian系统的LXDE界面，当使用AWTK进行开发时，不需要原生桌面的情况下，可以执行以下指令关闭原生桌面，提高启动速度。

[root@zpc:~]# systemctl disable lightdm
Synchronizing state of lightdm.service with SysV service script with /lib/systemd/systemd-....
Executing: /lib/systemd/systemd-sysv-install disable lightdm
Removed /etc/systemd/system/display-manager.service.

基于systemd创建属于awtk的运行服务，创建/usr/lib/systemd/system/awtkdemo.service文件并修改为以下内容：

[Unit]
Description=AWTK demo
After=network.target


[Service]
Type=simple
ExecStart=/root/release/bin/demoui #这里是运行路径，根据实际情况修改
Restart=always
User=root
Group=root


[Install]
WantedBy=multi-user.target

然后执行以下指令开启awtk的运行服务。

[root@zpc:/usr/lib/systemd/system]# systemctl enable awtkdemo
Created symlink /etc/systemd/system/multi-user.target.wants/awtkdemo.service → /lib/system...

执行reboot指令后，则可看到系统启动时没有进入本来的LXDE桌面，而是直接启动AWTK示例。