跳转至

快速上手指南

使用说明

本手册是 WECON 通用 Linux 平台开发者(HMI、V-Box 系列)的总入口,帮助开发者快速定位自身产品类型与系统版本,并导航到对应的开发文档。本平台基于 Linux + Qt,适配工业自动化嵌入式开发场景,覆盖从出厂工程上手、开发环境搭建、远程调试到功能个性化定制的完整开发周期。

⚠️ 系统版本说明:本文档及配套 SDK 主要支持通用 Linux_V2.0(2025 发布,维护至今)新分区系统。V1.0 旧分区系统已停止维护,本文仅作兼容参考。


1. 产品线区分与快速定位

请先确认您使用的产品属于以下哪一类,再按对应路径阅读。WECON 通用 Linux 平台产品分为 HMI 触摸屏 与 V-Box 盒子 两大类。

产品线 硬件平台 产品说明
HMI 触摸屏 RK3308 / RK3566 触摸屏产品,多个尺寸 / 分辨率 / 功能等级,含 Qt 画面显示
V-Box 盒子 RK3308 / RK3566 盒式产品,部分型号带 Qt 画面显示,部分型号不带 Qt 画面

各产品线的有无网口、有无 Qt 画面细分及调试方法,请直接查阅系统结构与调试指南。系统版本检测方法及分区结构同样见该指南。


2. 默认系统配置工具使用向导

为助力开发工程师高效掌握默认系统配置工具工程的使用方法,编制了《系统配置工具使用指南》,该指南随 SDK 同步发布,详细覆盖以下内容:


3. 开发环境搭建与远程调试

为帮助开发工程师快速掌握 WECON_Linux 平台开发环境部署及基于 Qt Creator 的虚拟机远程调试流程,编制了《开发环境指南》,该指南随 SDK 同步发布,详细覆盖以下核心内容:

开发环境部署:

远程调试开发流程:


4. 系统结构与调试

系统级知识(分区结构、掉电保存区域、内存挂载区、危险路径、启动流程、启动脚本作用、FTP 功能、无网口 / 无 Qt 设备调试)请参阅《系统结构与调试指南》。


5. 功能定制工具

为帮助开发者快速实现设备功能的个性化定制,随 SDK 发布的《个性化定制开发指南》已同步提供,详细覆盖以下核心内容:


6. 配套软件工具

WECON 提供配套软件工具 iBoxTool,用于设备信息查看、程序部署与调试,使用方法见iBoxTool 使用指南。


7. 常见问题

开发过程中遇到问题,请查阅《Linux 开发常见问题》,涵盖开发环境、设备存储、网络连接、系统功能四大类排查指南。


8. 系统版本区分(速查)

系统版本 发布日期 维护情况 说明
通用 Linux_V1.0 2023 停止维护 旧分区结构,仅作兼容参考
通用 Linux_V2.0 2025 维护中 新分区结构
通用 Linux_V2.1 2026 最新 V2.0 的演变,将用户文件与系统重要文件分隔开

系统版本最新说明及详细分区结构,请见系统结构与调试指南。

快速检测命令:通过 SSH 工具登录设备后台,执行 env 命令检查是否存在 HMI_LOCAL_ROOT 环境变量。若存在则判定为 V2.0 及以上新分区版本;若不存在,则为 V1.0 旧分区版本。