跳转至

个性化定制开发指南

使用说明

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

1.资源下载路径

资源名称 下载路径 网盘密码
工具包（含SDK） https://pan.baidu.com/s/1-g9wGvDndVldbzJhf_uY-w 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.开机LOGO配置

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

②：将图片命名为logo.bmp

4.2 生成图像bin文件

详细步骤：

①：从网盘链接里下载“图像处理工具”和“解包工具”的压缩包，并进行解压

②：打开图像处理工具，并点击“开机Logo制作工具”

③：按顺序进行配置“logo名称”、“图像文件路径”、“输出文件路径”、“屏系列”、"屏型号"和“屏尺寸分辨率”，然后点击生成

④：打开输出文件夹，可在文件夹内找到对应的.osf3文件

⑤：打开解包工具，切换到解包界面，并打开之前生成的.osf3文件路径，配置输出文件路径，然后点击解包按键进行解包

⑥：解包成功后，在对应路径下可找到生成的logo.bin文件

旧分区固件区分：

固件版本 存在目录
旧分区 /opt/wecon/

详细步骤：

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

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

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

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

reboot

新分区固件区分：

固件版本 存在目录
新分区 /usr/local/

详细步骤：

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

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

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

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

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

whal logo /usr/local/logo.bin

5.开机自启动程序配置

5.1 程序准备

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

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

5.2 设置执行权限

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

chmod +x ./HMIApp

为程序添加可执行权限

5.3 依赖库处理

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

文件路径表

固件版本 执行文件存放路径 库文件存放路径
V_20250425 /usr/Local/bin /usr/Local/lib
V_20250106 /opt/wecon/app/usr/bin /opt/wecon/app/usr/lib