快速上手指南
使用说明
本手册是 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 旧分区版本。