跳转至

Linux开发常见问题 - 设备存储类

本类汇总 Linux 平台设备(HMI 屏)存储相关的常见问题,涵盖屏下内存空间、U盘升级、数据保存、挂载节点等场景。

1. 屏下可用内存空间不足

故障现象

程序部署或运行时报内存不足、无法正常升级工程。

解决方法

说明:以下为新分区(V2.0)下的可选措施。最新固件已去除该拷贝操作,一般无需执行;仅在空间确实不足时参考。

①:使用 SSH 工具进入屏后台,用户名:root,密码:123456。

②:使用 vi /usr/local/etc/init.d/S06HMIApp 命令编辑工程启动脚本。

③:通过方向键找到 APP_RUN_PATH 参数,按下 i 键进入编辑状态,修改为 /usr/local/bin。

④:通过方向键找到 start 方法中的 cp -rf ${APP_RUN_PATH}/* ${APP_RUN_PATH}/ 代码,在该代码前面添加 # 符号进行注释。

⑤:修改结束后按下 ESC 键,通过 shift+: 组合键切换到命令输入模式,输入 wq 后回车保存退出脚本编辑,输入 sync 命令回车保存最近修改,最后输入 reboot 命令回车重启设备生效。

⑥:使用 vi /usr/local/sbin/touchShell 命令编辑长按触摸恢复脚本。

⑦:通过方向键找到 APP_RUN_PATH 参数,按下 i 键进入编辑状态,修改为 /usr/local/bin。

⑧:通过方向键找到 cp -fv "$APP_BIN_PATH/SysSet" "$APP_RUN_PATH/" 代码,在该代码前面添加 # 符号进行注释。

⑨:修改结束后按下 ESC 键,通过 shift+: 组合键切换到命令输入模式,输入 wq 后回车保存退出脚本编辑,输入 sync 命令回车保存最近修改,最后输入 reboot 命令回车重启设备生效。


2. U盘升级工程无法运行

故障现象

使用 U盘升级功能升级工程时失败或升级后工程无法运行。

排查步骤

①:检查磁盘空间

  • 使用 SSH 工具进入设备后台
  • 执行 df -h 命令查看 /usr 分区的可用空间
  • 重点关注 /usr 分区的可用空间
  • 如可用空间不足,可对工程存放路径下的垃圾文件进行清理

②:空间清理

使用以下脚本清理 /usr/local/bin 和 /usr/local/lib 下的非系统文件:

以下为示例脚本,其中的目标路径与保留文件列表以 V2.0 新分区为例,请根据实际系统版本调整(如 V1.0 旧分区路径为 /opt/wecon/app/usr/bin、/opt/wecon/app/usr/lib,系统文件列表也不同,见系统结构与调试指南)。

#!/bin/bash

# 保留的系统文件列表
BIN_KEEP="bsd download gdbserver mountex SysSet"
LIB_KEEP="libcbl.so libcbl.so.6 libcbl.so.6.0.0 libcbl.so.6.15.2 libgtl.so libplatform.so libplatform.so.0 libplatform.so.0.0.0 libplc5v_driver.so libplc6v_driver.so libprotobuf-lite.so libprotobuf-lite.so.15 libprotobuf-lite.so.15.0.1 librttr_core.so librttr_core.so.0.9.6 libscl.so libscl.so.0 libscl.so.0.0.1 libservcli.so libservcli.so.1 libservcli.so.1.0.0 libSysSetGui.so libWecon6VProtocolClient.so"

# 目标路径
BIN_PATH="/usr/local/bin"
LIB_PATH="/usr/local/lib"

# 清理函数
clean_directory() {
    local dir_path=$1
    local keep_list=$2

    for file in "$dir_path"/*; do
        if [ -f "$file" ]; then
            filename=$(basename "$file")
            if ! echo " $keep_list " | grep -q " $filename "; then
                rm -f "$file"
            fi
        fi
    done
}

# 清理目录
if [ -d "$BIN_PATH" ]; then
    clean_directory "$BIN_PATH" "$BIN_KEEP"
fi

if [ -d "$LIB_PATH" ]; then
    clean_directory "$LIB_PATH" "$LIB_KEEP"
fi

使用方法:

  1. 将脚本保存为 clean_space.sh 并将该脚本放入 U盘根目录。
  2. 将 U盘插入设备后使用 U盘升级功能执行该脚本。

注意事项:

  • 脚本会清理 /usr/local/bin 和 /usr/local/lib 目录下的非系统文件
  • 保留列表中的系统文件不会被删除
  • 执行前建议备份重要数据

③:分区版本匹配检查

确认使用的升级脚本与设备分区版本匹配: - V2.0 新分区固件需使用新分区升级脚本,使用旧分区(V1.0)的升级脚本将无法正常升级 - 系统版本区分方法见快速上手指南

④:脚本问题检查

  • 确认脚本文件命名正确(如 AutoRun.sh),且存放路径正确(如 U盘 wecon/AutoRun.sh)。
  • 确认脚本文件有可执行权限,必要时执行 chmod +x 脚本名。
  • 确认脚本内路径 / 命令与目标系统版本匹配(如 V1.0 与 V2.0 路径不同,见系统结构与调试指南)。
  • 可在脚本中添加 echo 日志输出,通过后台日志定位执行到哪一步出错。

3. 可自行决定保留的文件说明

背景

在清理 /usr/local/bin、/usr/local/lib 等目录空间时,并非所有文件都属于系统必需文件。以下文件属于依赖 / 客户可自行决定是否保留的文件,可在空间不足时根据实际使用情况选择性清理或保留。

可自行决定保留的文件

文件 说明
客户工程依赖的动态库(.so) 仅当客户工程使用到时才需要,不用的可清理
客户工程附带的可执行文件 除系统必需的 HMIApp、SysSet 外,其余可选择性保留
历史备份文件(.bak 等) 如已确认不需要,可清理释放空间
日志文件 可定期清理

系统必需保留的文件(请勿删除)

以下文件为系统运行 / 升级必需,请勿随意删除(详见系统结构与调试指南):

文件 说明
SysSet 系统配置工具
HMIApp 主应用程序
系统基础库(libcbl、libscl、libplatform 等) 系统运行依赖

清理前请先备份,确认无误后再删除。


4. U盘无法识别或无法访问

故障现象

U盘插入设备后无法正常识别,或无法访问 U盘中的文件。

可能原因及解决方法

①:U盘文件系统格式不受支持

  • 支持的 U盘格式:建议使用 FAT32 格式。
  • 常见原因:U盘为 NTFS / exFAT 等格式,当前固件可能不支持。
  • 解决方法:将 U盘格式化为 FAT32 格式,或更换支持对应格式识别的固件。

注:格式化 U盘会清除其中数据,操作前请备份。U盘容量较大(如 32GB 以上)时,若系统工具无法格式化为 FAT32,可使用第三方工具(如 DiskGenius、Rufus)格式化。

②:U盘根路径下存在快捷方式

  • 常见原因:U盘文件存储在根路径下的快捷方式目录中,导致文件无法访问。
  • 解决方法:升级后台通用 Linux 工具,使用新增的 U盘文件浏览器 访问文件。

5. 数据文件保存后重启丢失

故障现象

将数据文件保存在 /mnt/data 目录下,设备重启后文件消失。

可能原因

  • /mnt/data 为临时挂载目录,掉电或重启后数据不保证持久保存
  • 客户工程未强制刷新 Qt 流缓冲到 QFile,导致数据未真正写入磁盘

解决方法

①:选择持久化存储路径

在 /usr 目录下创建自定义文件夹存放数据文件,该目录掉电后数据可保存。

②:Qt 程序中强制刷新缓冲

在 Qt 程序中写入数据后调用 flush() 刷新文件缓冲,确保数据真正写入磁盘。


6. SD卡与U盘挂载节点

挂载节点概览

以下是系统默认的存储设备挂载节点:

设备 挂载路径
SD卡 /media/sdcard
U盘 /media/udisk 或 /media/usb0(两者等效)

多分区U盘挂载说明

如果 U盘存在多个分区,/media/ 路径下挂载的可能不是所需的分区。此时可以前往以下路径查找对应分区:

  • 备用挂载路径:/mnt/automount/
  • 说明:在该路径下,系统会为每个 U盘分区自动创建挂载点,但挂载节点的名称不固定(通常与分区标签或设备名相关)。

使用提示

  • 建议优先检查 /media/udisk 或 usb0 是否已挂载所需分区
  • 若未找到目标数据,可进入 /mnt/automount/ 查看所有已挂载的 U盘分区,并根据分区内容判断所需分区
  • 可使用 lsblk 或 mount 命令查看当前所有存储设备的挂载详情

7. 挂载失败排查(auto-mount.sh)

故障现象

原有可用的启动脚本替换到新设备后,SD卡和 U盘无法挂载。

可能原因

设备下的 __auto-mount.sh 未改名为 auto-mount.sh,导致系统未找到对应的挂载脚本,从而挂载失败。

解决方法

将改名为 auto-mount.sh 的挂载脚本替换到现场设备中,重启设备即可解决。