跳转至

个性化定制开发指南

使用说明

本手册旨在帮助用户通过系列工具实现设备功能的个性化定制。内容涵盖触摸屏校准、屏幕背光亮度调节、更改后台登入密码、开机LOGO配置、自启动程序部署等核心功能，提供从开发到配置的完整流程指导。通过灵活调用工具包和脚本，用户可快速调整设备参数、替换系统资源或扩展功能模块，满足客户多样化需求。适用于需深度定制工业HMI界面及系统行为的开发者，助力高效开发与功能适配。

1.资源下载路径

资源名称 下载路径 网盘密码
工具包（含SDK） https://pan.baidu.com/s/1-g9wGvDndVldbzJhf_uY-w?pwd=ekx3 ekx3

2.触摸屏校准

使用SSH工具登入到屏幕后台，输入以下命令启动校准进程：

/usr/bin/ts_calibrate

3.屏幕背光亮度设置

通过修改系统文件调节屏幕背光亮度。示例：设置亮度为50（范围:1~100）

echo 50 > /sys/class/backlight/backlight/brightness
参数/部分 说明
亮度值 50为亮度值（范围1~100）
系统背光控制文件 /sys/class/backlight/backlight/brightness
操作方式 通过修改该文件内容即可调节亮度

4.更改后台登入密码

①：使用ssh工具登入到屏后台。

②：输入命令passwd root修改root用户的密码。

③：连续输入两次密码则可完成用户后台登入密码更改。

①：准备一张与HMI屏幕对应分辨率的24位BMP格式的图片。

②：将图片命名为logo.bmp（必要）。

5.2 生成图像bin文件

详细步骤：

①：从下载中心里下载“Logo替换工具包”。

②：拷贝“Logo制作工具”里的resource_tool和准备好的bmp图片一同拖拽拷贝到虚拟机桌面。

③：打开虚拟机终端，通过cd /home/wecon/Desktop/命令切换到Desktop路径并执行./resource_tool xxx.bmp。

④：执行命令后会生成resource.img文件，重命名文件为logo.bin（必要）。

详细步骤：

①：将以下文件拷贝到Linux虚拟机：

  • logo.bin（LOGO二进制文件）。
  • write_emmc.sh（烧录脚本，下载中心获取）。

②：在ssh工具中，使用scp命令将 logo.bin 和 write_emmc.sh 文件拷贝到 HMI 屏的/mnt/data/ 目录：

scp logo.bin write_emmc.sh root@192.168.1.1:/mnt/data
参数/部分 说明
scp 安全复制协议（Secure Copy Protocol）的命令行工具，用于在本地和远程系统之间安全地复制文件。
logo.bin write_emmc.sh 本地当前目录下的源文件名，即要复制的文件。
root 屏的用户名，这里使用 root 用户。
192.168.1.1 屏的IP地址。
:/mnt/data/ 屏下的目标路径。文件将被复制到屏的 /mnt/data/目录下。
password 屏下后台密码，默认为123456

③：拷贝完成后在HMI屏终端执行LOGO写入脚本。

./write_emmc.sh /mnt/data/logo.bin

④：脚本执行成功后重启设备检查LOGO是否替换成功。

reboot

详细步骤：

①：将以下文件拷贝到Linux虚拟机：

  • logo.bin（LOGO二进制文件）。

②: 打开虚拟机Linux终端Teminal，输入scp指令将logo.bmp图片文件拷贝到屏下。

scp logo.bmp root@192.168.1.1:/usr/local/
参数/部分 说明
scp 安全复制协议（Secure Copy Protocol）的命令行工具，用于在本地和远程系统之间安全地复制文件。
logo.bin 本地当前目录下的源文件名，即要复制的文件。
root 屏的用户名，这里使用 root 用户。
192.168.1.1 屏的IP地址。
:/usr/local/ 屏下的目标路径。文件将被复制到屏的 /usr/local/目录下。
password 屏下后台密码，默认为123456

③：使用SSH工具进入屏后台，输入whal logo命令设置LOGO

whal logo /usr/local/logo.bin

6.开机自启动程序配置

6.1 程序准备

①：将编译生成的可执行文件重命名为HMIApp。

②：根据系统版本将文件复制到对应“执行文件存放路径”目录（参照文件路径表）。

注：如需使用U盘升级配置开机自启动程序可参考U盘升级示例脚本。

6.2 设置执行权限

进入该目录，在终端中执行：

chmod +x ./HMIApp

为程序添加可执行权限。

6.3 依赖库处理

如果程序依赖自定义库文件，请将库文件根据下表放入对应目录。

6.3.1 文件路径表

系统版本 执行文件存放路径 库文件存放路径
通用Linux_V1.0 /opt/wecon/app/usr/bin/ /opt/wecon/app/usr/lib/
通用Linux_V2.0 /usr/local/bin/ /usr/local/lib/