【技術(shù)分享】一文教你在ZPC上快速移植AWTK

ZPC是ZLG全新研發(fā)的顯控一體機(jī)。開(kāi)源AWTK，版權(quán)無(wú)憂！多種工業(yè)通信協(xié)議，工業(yè)互聯(lián)無(wú)壁壘！ZWS數(shù)據(jù)上云很輕松！更有AWFlow，應(yīng)用開(kāi)發(fā)很簡(jiǎn)單！本文將介紹如何在ZPC上快速移植AWTK。

ZPC簡(jiǎn)介

ZPC系列顯控一體機(jī) 是廣州致遠(yuǎn)電子全新研發(fā)的集“顯示”+“控制”一體化的高性能顯控終端產(chǎn)品。外框采用鋁合金材質(zhì)，簡(jiǎn)潔耐用；產(chǎn)品集成了多路隔離RS485、多路隔離CAN總線、多路千兆以太網(wǎng)等豐富外設(shè)。一觸即發(fā)，隨心控制。產(chǎn)品支持多種工業(yè)通信協(xié)議，工業(yè)互聯(lián)無(wú)壁壘！支持ZWS，數(shù)據(jù)上云很輕松！支持AWFlow，應(yīng)用開(kāi)發(fā)很簡(jiǎn)單！還支持開(kāi)源AWTK GUI，版權(quán)無(wú)憂！可以快速創(chuàng)作您的HMI作品。

ZPC系列顯控一體機(jī)

? RK3568處理器

? 顯控一體機(jī)

? 國(guó)產(chǎn)顯控

? 工業(yè)自動(dòng)化

參考價(jià)格：3099元

AWTK簡(jiǎn)介

AWTK全稱(chēng)為T(mén)oolkit AnyWhere，是ZLG傾心打造的一套基于C語(yǔ)言開(kāi)發(fā)的開(kāi)源GUI框架。旨在為用戶(hù)提供一個(gè)功能強(qiáng)大、高效可靠、簡(jiǎn)單易用、可輕松做出炫酷效果的GUI引擎；支持跨平臺(tái)同步開(kāi)發(fā)，一次編程，隨處編譯，跨平臺(tái)終身使用，無(wú)版權(quán)費(fèi)用擔(dān)憂！

準(zhǔn)備工作

裝有Ubuntu系統(tǒng)或Ubuntu虛擬機(jī)的可連接外網(wǎng)的PC 1臺(tái)；

ZPC-101Q55RTW-01顯控一體機(jī)1臺(tái)；

USB轉(zhuǎn)RS232調(diào)試串口1個(gè)；

12V@2A的電源適配器1個(gè)；

MobaXterm串口調(diào)試上位機(jī)；

TF卡或U盤(pán)或網(wǎng)線等。

移植過(guò)程

1. 環(huán)境準(zhǔn)備

AWTK代碼已在gitee和github上開(kāi)源，國(guó)內(nèi)推薦訪問(wèn)速度更快的gitee：

https://gitee.com/zlgopen/awtk

按照以下步驟，在PC虛擬機(jī)上進(jìn)行操作：

host$ sudo apt install gcc-aarch64-linux-gnu git scons //使用apt指令下載所需的工具host$ mkdir awtk-demo && cd awtk-demo//創(chuàng)建一個(gè)新的文件夾host$ git clone https://gitee.com/zlgopen/awtk.git //使用git克隆awtk倉(cāng)庫(kù)到本地，awtk為AWTK代碼本倉(cāng)，包含了AWTK最主要的代碼host$ git clone https://gitee.com/zlgopen/awtk-linux-fb.git //使用git克隆awtk-linux-fb倉(cāng)庫(kù)到本地，awtk-linux-fb為針對(duì)嵌入式的Frame buffer機(jī)制和DRM機(jī)制的倉(cāng)庫(kù)host$ lsawtk ?awtk-linux-fbhost$ cd awtk-linux-fb

2. 安裝依賴(lài)庫(kù)

Ubuntu上編輯/etc/apt/sources.list 文件，將它改為如下內(nèi)容：

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

Ubuntu上編輯/etc/apt/sources.list.d/ubuntu-ports.list ，如果文件不存在，則創(chuàng)建，將它改為如下內(nèi)容：

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

由于AWTK觸摸功能依賴(lài)于tslib觸摸庫(kù)，所以Ubuntu需要下載ARM64架構(gòu)的tslib。

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

3. 修改代碼

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

打開(kāi)awtk_config.py文件，該文件會(huì)描述并配置AWTK工程構(gòu)建時(shí)所需環(huán)境變量，按照以下內(nèi)容進(jìn)行修改，將構(gòu)建工程配置為DRM模式而非Frame buffer模式。

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

修改tslib依賴(lài)庫(kù)在本機(jī)的位置，Ubuntu默認(rèn)位置如下：

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

修改編譯工具鏈的指令，再次選擇Ubuntu下的arm64交叉編譯工具鏈：

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

?可以使用以下指令確認(rèn)交叉工具鏈版本，在Ubuntu 20.04下默認(rèn)的交叉工具鏈版本為9.4.x：

host$ aarch64-linux-gnu-gcc -v ? ? ? ? ? ? ? ? ? ? ? ?Using built-in specs.COLLECT_GCC=aarch64-linux-gnu-gccCOLLECT_LTO_WRAPPER=/usr/lib/gcc-cross/aarch64-linux-gnu/9/lto-wrapperTarget: aarch64-linux-gnuConfigured 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/includeThread model: posixgcc version 9.4.0 (Ubuntu 9.4.0-1ubuntu1~20.04.2)

config文件夾下有文件devices.json.in這一配置文件，該文件配置了AWTK運(yùn)行時(shí)所需物理設(shè)備的路徑，但在名為devices.json.in時(shí)不生效，需要按照以下命令修改名稱(chēng)為devices.json；再打開(kāi)config/devices.json，修改為以下內(nèi)容，其中event1為觸摸屏設(shè)備路徑，類(lèi)型為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默認(rèn)使用鼠標(biāo)設(shè)備進(jìn)行操作，所以默認(rèn)情況下界面會(huì)有光標(biāo)顯示，在使用觸摸屏操作的時(shí)候會(huì)影響用戶(hù)體驗(yàn)，如若需要關(guān)閉鼠標(biāo)光標(biāo)，則需要在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. 編譯代碼

執(zhí)行scons指令進(jìn)行編譯工程。

host$ scons

編譯完成后會(huì)輸出log下圖所示，如果編譯過(guò)程中出現(xiàn)尋找不到對(duì)應(yīng)頭文件，請(qǐng)返回上文安裝依賴(lài)庫(kù)。

接下來(lái)執(zhí)行./release.sh腳本對(duì)文件資源進(jìn)行打包，執(zhí)行完成后，可以看到生成release文件夾和release.tar.gz壓縮文件。release文件夾中，包含了編譯生成的可執(zhí)行文件、awtk庫(kù)以及相關(guān)配置文件，也就是應(yīng)用程序運(yùn)行時(shí)所需的文件；而release.tar.gz就是對(duì)release文件夾的打包。

host$ ?awtk-linux-fb ?./release.shEXE_NAME = demouiAPP_ROOT = ../awtk==================================================EXE_NAME:demouiASSETS_DIR:../awtk/res/assetsOUTPUT_DIR:/home/felix/Workspace/Testcodes/awtk-demo/awtk-linux-fb/releaseBIN_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/demouicopy 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.socopy 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

執(zhí)行示例

拷貝release.tar.gz文件到ZPC一體機(jī)的/root文件夾下，并按照以下指令分別執(zhí)行對(duì)應(yīng)解壓命令解壓包、設(shè)置執(zhí)行權(quán)限等。

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

執(zhí)行以下指令，即可運(yùn)行示例demo如下圖所示。

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

設(shè)置開(kāi)機(jī)自啟動(dòng)

默認(rèn)系統(tǒng)會(huì)進(jìn)入Debian系統(tǒng)的LXDE界面，當(dāng)使用AWTK進(jìn)行開(kāi)發(fā)時(shí)，不需要原生桌面的情況下，可以執(zhí)行以下指令關(guān)閉原生桌面，提高啟動(dòng)速度。

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

基于systemd創(chuàng)建屬于awtk的運(yùn)行服務(wù)，創(chuàng)建/usr/lib/systemd/system/awtkdemo.service文件并修改為以下內(nèi)容：

[Unit]Description=AWTK demoAfter=network.target
[Service]Type=simpleExecStart=/root/release/bin/demoui #這里是運(yùn)行路徑，根據(jù)實(shí)際情況修改Restart=alwaysUser=rootGroup=root
[Install]WantedBy=multi-user.target

然后執(zhí)行以下指令開(kāi)啟awtk的運(yùn)行服務(wù)。

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

執(zhí)行reboot指令后，則可看到系統(tǒng)啟動(dòng)時(shí)沒(méi)有進(jìn)入本來(lái)的LXDE桌面，而是直接啟動(dòng)AWTK示例。