ZPC是ZLG全新研发的显控一体机。开源AWTK,版权无忧!多种工业通信协议,工业互联无壁垒!ZWS数据上云很轻松!更有AWFlow,应用开发很简单!本文将介绍如何在ZPC上快速移植AWTK。
ZPC简介
ZPC系列显控一体机 是广州致远电子全新研发的集“显示”+“控制”一体化的高性能显控终端产品。外框采用铝合金材质,简洁耐用;产品集成了多路隔离RS485、多路隔离CAN总线、多路千兆以太网等丰富外设。一触即发,随心控制。产品支持多种工业通信协议,工业互联无壁垒!支持ZWS,数据上云很轻松!支持AWFlow,应用开发很简单!还支持开源AWTK GUI,版权无忧!可以快速创作您的HMI作品。
ZPC系列显控一体机
• RK3568处理器
• 显控一体机
• 国产显控
• 工业自动化
参考价格:3099元
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示例。