2025-09-30 11:56:06 +08:00
|
|
|
|
# AWTK 针对 arm-linux 平台的移植。
|
|
|
|
|
|
|
|
|
|
|
|
[AWTK](https://github.com/zlgopen/awtk) 是为嵌入式系统开发的 GUI 引擎库。
|
|
|
|
|
|
|
|
|
|
|
|
[awtk-linux-fb](https://github.com/zlgopen/awtk-linux-fb) 是 AWTK 在 arm-linux 上的移植。
|
|
|
|
|
|
|
|
|
|
|
|
本项目以 [ZLG 周立功 linux 开发套件 AWork 平台 iMX287A 入门级 ARM9 开发板](https://item.taobao.com/item.htm?spm=a230r.1.14.1.29c8b3f8qxjYf7&id=536334628394&ns=1&abbucket=17#detail) 为载体移植，其它开发板可能要做些修改，有问题请请创建 issue。
|
|
|
|
|
|
|
|
|
|
|
|
## 使用方法
|
|
|
|
|
|
|
|
|
|
|
|
* 1. 获取源码
|
|
|
|
|
|
|
|
|
|
|
|
> 以下两者并列放在同一个目录，如果用户有自己的项目，也建议与以下两者并列放在同一目录。
|
|
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
git clone https://github.com/zlgopen/awtk.git
|
|
|
|
|
|
git clone https://github.com/zlgopen/awtk-linux-fb.git
|
|
|
|
|
|
cd awtk-linux-fb
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
* 2. 编辑 awtk_config.py 设置工具链的路径
|
|
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
TSLIB_LIB_DIR='/opt/28x/tslib/lib'
|
|
|
|
|
|
TSLIB_INC_DIR='/opt/28x/tslib/include'
|
|
|
|
|
|
TOOLS_PREFIX='/opt/28x/gcc-4.4.4-glibc-2.11.1-multilib-1.0/arm-fsl-linux-gnueabi/bin/arm-linux-'
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
> 如果不需要 tslib，不定义 TSLIB\_LIB\_DIR 和 TSLIB\_INC\_DIR 即可。如：
|
|
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
#TOOLS_PREFIX=''
|
|
|
|
|
|
#TSLIB_LIB_DIR=''
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
* 3. 编辑 config/devices.json 修改输入设备的文件名
|
|
|
|
|
|
|
|
|
|
|
|
```json
|
|
|
|
|
|
{
|
|
|
|
|
|
"/dev/fb0" : {
|
|
|
|
|
|
"type" : "fb"
|
|
|
|
|
|
},
|
|
|
|
|
|
"/dev/dri/card0" : {
|
|
|
|
|
|
"type" : "drm"
|
|
|
|
|
|
},
|
|
|
|
|
|
"/dev/input/event0" : {
|
|
|
|
|
|
"type" : "ts"
|
|
|
|
|
|
},
|
|
|
|
|
|
"/dev/input/event1" : {
|
|
|
|
|
|
"type" : "input"
|
|
|
|
|
|
},
|
|
|
|
|
|
"/dev/input/mouse0" : {
|
|
|
|
|
|
"type" : "mouse"
|
|
|
|
|
|
}
|
|
|
|
|
|
}
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
> 注意：在有些平台下，如果设置"/dev/input/mice”，会出现触摸不灵的问题。通过 hexdump /dev/input/mice 命令发现，按下触摸屏或操作鼠标都会打印信息，即/dev/input/mice 会同时接收触摸和鼠标事件。可通过"hexdump /dev/input/xx" 命令选择正确的鼠标设备文件名。
|
|
|
|
|
|
|
|
|
|
|
|
* 4. 编译（请先安装 scons)
|
|
|
|
|
|
|
|
|
|
|
|
awtk 与用户的程序目录结构如下所示
|
|
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
/home/user/
|
|
|
|
|
|
|-- awtk/
|
|
|
|
|
|
|-- awtk-linux-fb/
|
|
|
|
|
|
|-- user_apps/
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
生成内置 demoui 例子，生成结果在bin 文件夹下的 demoui 文件
|
|
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
|
cd /home/user/awtk-linux-fb
|
|
|
|
|
|
scons
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
也可以指定生成其他 Demo，此处以 HelloDesigner-Demo 为例（该例程可以在 AWStudio 中下载，复制到user_apps目录下），生成结果在 bin 文件夹下的 demo 文件
|
|
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
|
cd /home/user/awtk-linux-fb
|
|
|
|
|
|
scons APP=../user_apps/HelloDesigner-Demo
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
如果想要改变 LCD 的尺寸，可以在编译时加上 LCD 参数
|
|
|
|
|
|
|
|
|
|
|
|
* 编译 HelloDesigner-Demo，并将 LCD 设置为 800 * 480：
|
|
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
cd /home/user/awtk-linux-fb
|
|
|
|
|
|
scons APP=../user_apps/HelloDesigner-Demo
|
|
|
|
|
|
```
|
|
|
|
|
|
* 编译 HelloDesigner-Demo，并将 LCD 设置为为 480 * 272：
|
|
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
cd /home/user/awtk-linux-fb
|
|
|
|
|
|
scons APP=../user_apps/HelloDesigner-Demo LCD=480_272
|
|
|
|
|
|
```
|
|
|
|
|
|
* 5. 生成发布包
|
|
|
|
|
|
|
|
|
|
|
|
对于内置的 demoui 例子
|
|
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
cd /home/user/awtk-linux-fb
|
|
|
|
|
|
sh ./release.sh
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
对于其他 Demo，需要加入资源文件夹参数和可执行程序名称，资源文件夹参数指向应用程序 assets 的父目录
|
|
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
cd /home/user/awtk-linux-fb
|
|
|
|
|
|
./release.sh ../user_apps/HelloDesigner-Demo/res demo
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
* 6. 运行
|
|
|
|
|
|
|
|
|
|
|
|
把 release.tar.gz 上传到开发板，并解压，然后运行：
|
|
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
sudo ./release/bin/demoui
|
|
|
|
|
|
sudo ./release/bin/demo
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
## 文档
|
|
|
|
|
|
|
|
|
|
|
|
* [如何搭建 Ubuntu 调试环境](docs/how_to_use_in_vmware.md)
|
|
|
|
|
|
|
|
|
|
|
|
## 其他问题
|
|
|
|
|
|
|
|
|
|
|
|
#### 1. 项目路径
|
|
|
|
|
|
|
|
|
|
|
|
默认情况下，scons 脚本假设以下文件夹在同一个目录。
|
|
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
zlgopen
|
|
|
|
|
|
|-- awtk
|
|
|
|
|
|
|-- awtk-examples
|
|
|
|
|
|
|-- awtk-linux-fb
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### 2. 使用 Direct Rendering Manager (DRM)
|
|
|
|
|
|
|
|
|
|
|
|
缺省使用 framebuffer，如果使用 DRM，请修改 awtk\_config.py，指定 LCD_DEVICES 和 drm 的路径。
|
|
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
LCD_DEVICES='drm'
|
|
|
|
|
|
|
|
|
|
|
|
#for drm
|
|
|
|
|
|
OS_FLAGS=OS_FLAGS + ' -DWITH_LINUX_DRM=1 -I/usr/include/libdrm '
|
|
|
|
|
|
OS_LIBS = OS_LIBS + ['drm']
|
|
|
|
|
|
```
|
|
|
|
|
|
> DRM 目前只在虚拟机中测试过，如果有问题请参考 awtk-port/lcd\_linux\_drm.c 进行调试。
|
|
|
|
|
|
|
|
|
|
|
|
#### 3. 使用 EGL 硬件加速
|
|
|
|
|
|
|
|
|
|
|
|
缺省使用 framebuffer，如果使用 EGL，请参考文档 [how_to_use_egl.md](docs/how_to_use_egl.md)。
|
|
|
|
|
|
|
|
|
|
|
|
#### 4. 编译输出 AWTK 动态链接库文件
|
|
|
|
|
|
|
|
|
|
|
|
请修改 awtk\_config.py，将 os.environ['WITH_AWTK_SO'] 标记为 true，则执行 scons 会同时输出 libawtk.so 等动态链接库文件。
|
|
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
os.environ['WITH_AWTK_SO'] = 'true'
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### 5. 上传文件到开发板的方法
|
|
|
|
|
|
|
|
|
|
|
|
如果开发板支持 ssh，可以使用 scp 命令上传文件或文件夹，比如上传文件：
|
|
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
# 开发板ip：192.168.1.136
|
|
|
|
|
|
# 登录用户名：root
|
|
|
|
|
|
# 上传文件 release.tar.gz 到 /opt 目录
|
|
|
|
|
|
scp release.tar.gz root@192.168.1.136:/opt/release.tar.gz
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
上传文件夹：
|
|
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
# 创建文件夹 ./release 中所有文件到 /opt/awtk 目录
|
|
|
|
|
|
scp -r ./release root@192.168.1.136:/opt/awtk
|
|
|
|
|
|
```
|
|
|
|
|
|
|
