跳转至

系统配置工具使用指南

使用说明

本手册将引导您快速掌握本工具的操作界面及其功能,包括:通过系统设置和网络管理进行基础参数调整;使用U盘升级替换开机程序或执行自定义脚本;以及恢复出厂默认工程的具体方法。

1.系统配置工具主界面

系统配置工具主界面为三个菜单选项,分别是"网络管理""系统设置""U盘升级",右上角有"U盘"、"网口"、"WIFI"和"4G移动网络"的状态显示图标,系统主界面及状态栏。

2.通用系统设置

2.1 基本设置

基本设置界面可以对设备名称、屏幕背光和蜂鸣器进行设置。

2.2 语言设置

语言设置可以切换文字的中英文显示。

2.3 时间设置

时间设置可以设置当前的日期和时间,同时也可切换对应的时区用于联网自动校时。

2.4 屏幕校准

屏幕校准用于校准触摸位置,点击"开始"进入校准程序,根据界面提示完成校准。

2.5 版本信息查看

版本信息界面,可以查看FW固件版本号。

3.网络管理

3.1 以太网

以太网配置界面,可以配置动态或静态IP以及一些静态IP地址相关的参数。

3.2 网络诊断界面

网络诊断界面包含了以太网、WIFI和4G的网络诊断,可通过Ping外网地址或网站测试网络连通性。

3.3 4G配置界面

4G配置界面包含了IMEI和ICCID信息,可手动配置APN来实现实现业务隔离、服务质量控制、安全策略部署。

3.4 WLAN配置界面

WLAN配置界面包含了WLAN功能的开关和扫描到的WLAN列表信息,可根据实际需要连接指定的WIFI。

4.U盘脚本执行

①:编写脚本并放置文件

编写对应脚本并放置于U盘文件,并将要拷贝的文件放在U盘中。

  • 示例脚本:
#!/bin/bash

echo "Remounting root filesystem as read-write..."
mount -o remount rw / || {
    echo "Error: Failed to remount root filesystem as read-write"
    exit 1
}

NEW_BIN_TARGET="/usr/local/bin/"
NEW_LIB_TARGET="/usr/local/lib/"
OLD_BIN_TARGET="/opt/wecon/app/usr/bin/"
OLD_LIB_TARGET="/opt/wecon/app/usr/lib/"
APP_NAME="HMIApp"
APP_NEW_PATH="${NEW_BIN_TARGET}${APP_NAME}"
APP_OLD_PATH="${OLD_BIN_TARGET}${APP_NAME}"

is_new_partition=0
if [ -d "$NEW_BIN_TARGET" ]; then
    is_new_partition=1
fi

mount_points=$(mount | grep /dev/sd | awk '{print $3}')
if [ -z "$mount_points" ]; then
    echo "Warning: No /dev/sd mount points found"
    exit 1
fi

found=0
target_bin=""
target_lib=""
app_path=""

for mount_point in $mount_points; do
    usb_hmiapp_bin="$mount_point/HMIApp/bin"
    usb_hmiapp_lib="$mount_point/HMIApp/lib"
    if [ -d "$usb_hmiapp_bin" ] && [ -d "$usb_hmiapp_lib" ]; then
        found=1
        if [ $is_new_partition -eq 1 ]; then
            target_bin="$NEW_BIN_TARGET"
            target_lib="$NEW_LIB_TARGET"
            app_path="$APP_NEW_PATH"
        else
            target_bin="$OLD_BIN_TARGET"
            target_lib="$OLD_LIB_TARGET"
            app_path="$APP_OLD_PATH"
        fi
      echo "Terminating HMIApp and SysSet processes before copy..."
        killall -9 HMIApp 2>/dev/null
        killall -9 SysSet 2>/dev/null
        sleep 1
        mkdir -p "$target_bin" "$target_lib"
        cp -rf "$usb_hmiapp_bin/"* "$target_bin"
        cp -rf "$usb_hmiapp_lib/"* "$target_lib"
        echo "Files copied successfully"
        break
    fi
done

if [ $found -eq 1 ] && [ -f "$app_path" ]; then
    chmod +x "$app_path"
else
    if [ $found -eq 0 ]; then
        echo "Error: No valid HMIApp directories found"
    else
        echo "Error: Application not found at $app_path"
    fi
fi

sync
reboot
  • 示例脚本对应HMIApp文件夹的目录结构:
HMIApp/                  # 主目录(必须存在)
    ├── bin/                 # 可执行文件目录
    │   ├── HMIApp           # 主应用程序(必须)
    │   ├── SysSet           # 系统设置程序(会被终止)
    │   └── ...              # 其他可执行文件
    └── lib/                 # 库文件目录
        ├── libmodule1.so    # 库文件1
        ├── libmodule2.so    # 库文件2
        └── ...              # 其他库文件

②:使用系统配置工具上的U盘升级工具

③:执行脚本文件

对脚本文件进行执行。

④:运行成功验证

运行成功,test文件被拷贝到相应目录,可使用SSH工具登入触摸屏后台查看拷贝文件,确认是否拷贝成功。

5.恢复出厂默认工程

功能说明

该功能实现的是用户需要进行二次写入时,可通过长按屏幕右上角区域实现出厂默认工程的切换,使用默认工程的 U盘升级功能来进行程序的替换。

长按返回逻辑由触摸脚本实现,触摸脚本位置: - V2.0 新分区:/usr/local/sbin/touchShell - V1.0 旧分区:/opt/wecon/app/etc/init.d/ 目录下

触摸脚本的详细说明见个性化定制开发指南 - 触摸脚本使用说明。

6.屏蔽系统配置工具启动

功能说明

部分场景下客户不希望设备开机后进入系统配置工具(系统设置)界面,可通过以下方式屏蔽系统配置工具的启动,使设备开机后直接运行客户工程。

⚠️ 注意:屏蔽系统配置工具后,将无法通过长按屏幕右上角返回系统配置工具进行系统 / 网络配置。请在确认系统配置已正确设置后再执行,并提前做好备份。

方法一:修改启动脚本(推荐)

①:使用 SSH 工具登录设备后台(用户名 root,密码默认 123456)。

②:编辑系统配置工具相关启动脚本(V2.0 路径示例):

vi /usr/local/etc/init.d/S06HMIApp

③:找到启动 SysSet(系统配置工具)的相关行,在该行前添加 # 注释屏蔽,或根据脚本参数禁用系统配置工具启动。

④:保存退出(ESC → :wq),执行 sync 保存,reboot 重启设备生效。

方法二:重命名系统配置工具程序

①:登录设备后台,将系统配置工具程序 SysSet 重命名备份:

mv /usr/local/bin/SysSet /usr/local/bin/SysSet.bak

②:重启设备后系统配置工具将不再启动,客户工程正常自启动。

如需恢复系统配置工具,将备份文件重命名回 SysSet 并重启即可。

方法三:使用触摸脚本(配合个性化定制)

可通过触摸脚本(V2.0 路径:/usr/local/sbin/touchShell)实现长按返回逻辑的控制,具体见个性化定制开发指南 - 触摸脚本使用说明。