开发环境指南
使用说明¶
本手册是专为WECON系列设备Linux平台开发者设计的全流程环境配置指南，基于工业自动化领域对嵌入式开发的特殊需求编写。手册以Qt5.12.11为核心框架，深度整合虚拟机部署、创建Qt工程、交叉编译、远程调试等关键技术环节，助力开发者快速构建稳定高效的开发环境体系。
1、环境部署¶
1.1 环境及软件版本说明¶
软件环境配置表
| 环境 | 软件 | 版本 | 描述 |
|---|---|---|---|
| 虚拟机 | Vmware workstation | 17.6.0 | |
| 操作系统 | Ubuntu | 18.0.4 | 登录的账号：wecon 密码：wecon2022 |
| IDE | qt creator | 4.15.0 | |
| QT | QT 库 | 5.12.11 / 4.8.7 / 4.8.4 | |
| SSH工具 | Xshell、SecureCRT | ||
| 触摸屏后台登入 | 登录的账号：root 密码：123456 |
免责声明
重要提示：上述触摸屏登录的密码是我们提供的初始密码，建议客户修改密码，未修改密码导致屏被他人恶意登录操作，由客户自行承担风险。
1.2 资源下载路径¶
资源下载清单表
| 资源名称 | 下载路径 | 网盘密码 |
|---|---|---|
| 工具包（含SDK） | https://pan.baidu.com/s/1-g9wGvDndVldbzJhf_uY-w | ekx3 |
1.3 VMware Workstation虚拟机部署¶
虚拟机部署步骤表
| 步骤 | 操作内容 | 配置要求 | 说明 |
|---|---|---|---|
| 1 | 软件准备 | VMware 17.6.0 | 下载并安装虚拟机软件 |
| 2 | 虚拟机配置 | Ubuntu系统文件 | 配置虚拟机环境 |
| 3 | 系统启动 | wecon Ubuntu 18.04 | 启动虚拟机系统 |
| 4 | 系统登录 | wecon/wecon2022 | 登录虚拟机系统 |
详细操作步骤：
①：软件准备
安装包下载与安装 - 下载VMware workstation17.6.0安装包 - 安装VMware workstation软件
②：虚拟机配置
虚拟机环境设置 - 启动VMware Workstation Pro - 解压weconUbuntu_2022_09_04.rar压缩包 - 将解压后的文件添加到虚拟机中
③：系统启动
虚拟机启动流程 - 选择wecon Ubuntu 18.04.vmx文件 - 点击开启此虚拟机
④：系统登录
登录信息 - 用户名：根据系统设置 - 密码：wecon2022
1.4 SSH工具的使用方法¶
连接配置表
| 步骤 | 参数 | 值 | 说明 |
|---|---|---|---|
| 1 | 会话类型 | 新建会话 | 创建新的SSH连接 |
| 2 | 目标地址 | 触摸屏IP地址 | HMI设备网络地址 |
| 3 | 用户名 | root | 系统管理员账户 |
| 4 | 密码 | 初始密码 | 首次登录使用默认密码 |
操作步骤：
①：会话创建与目标地址设置
打开Xshell（这里以Xshell为例），添加会话，输入对应的触摸屏IP地址，点击确定。
②：用户认证
输入用户名"root"并点击确定。
③：密码验证
在弹出的对话框中输入初始密码，并点击确定，则可成功进入触摸屏后台。
1.5 Linux访问Windows共享目录¶
1.5.1 Windows端配置¶
Windows共享配置表
| 配置步骤 | 操作路径 | 关键参数 | 说明 |
|---|---|---|---|
| 1 | 设置 → 账户 → 家庭和其他用户 | 创建新用户 | 设置共享访问账户 |
| 2 | 文件夹属性 → 共享 | 设置共享权限 | 配置文件夹共享 |
| 3 | 共享配置窗口 | 设置用户权限 | 控制读写访问 |
详细操作：
①：打开系统设置
按下【 Win + I 】打开设置界面，点击左侧的【账户】，选择【家庭和其他用户】。
②：创建共享用户
点击“其他用户”下的“添加账户”按键，在弹出的对话框中填写用户名、密码。点击【下一步】，完成用户创建。
③：设置文件夹共享
设置 windows 共享目录，选择要共享的文件夹，右键点击【属性】，选择【共享】标签，点击【共享】按钮设置共享 。
④：配置共享权限
在打开的共享配置窗口中设置共享用户，设置共享用户的读写权限。
1.5.2 HMI挂载Windows共享目录¶
挂载命令详解
参数说明表
| 参数 | 值 | 说明 |
|---|---|---|
| -t | cifs | 文件系统类型 |
| -o | username=wecon | 共享用户名 |
| -o | password=123456 | 共享密码 |
| -o | vers=2.1 | SMB协议版本 |
| 源路径 | //192.168.1.100/share | Windows共享路径 |
| 目标路径 | /mnt/data/share | Linux挂载点（新建或已存在的空目录） |
访问Windows共享目录
- 进入/mnt/data/share 即可访问 windows 共享的目录，访问权限取决于设置的用户权限。
1.6 FTP服务配置¶
1.6.1 HMI触摸屏FTP环境搭建¶
FTP配置文件路径
FTP配置文件参数表
| 配置参数 | 默认值 | 功能说明 |
|---|---|---|
| local_enable | YES | 允许本地用户登录 |
| local_root | /mnt/data/ftppath | FTP根目录 |
| chroot_local_user | YES | 限制用户在主目录 |
| allow_writeable_chroot | YES | 允许主目录写入 |
| chroot_list_enable | YES | 启用特例用户列表 |
| chroot_list_file | /mnt/data/etc/vsftp/chroot_list | 特例用户列表文件 |
| secure_chroot_dir | /mnt/data/etc/vsftp/empty | 安全目录设置 |
| max_clients | 5 | 最大客户端连接数 |
| max_per_ip | 5 | 单IP最大连接数 |
| write_enable | YES | 允许文件写入 |
服务管理命令
1.6.2 FTP常用命令¶
| 序号 | 命令 | 功能描述 | 语法格式 | 使用示例 |
|---|---|---|---|---|
| 1 | ftp | 进入FTP命令行环境 | ftp |
ftp |
| 2 | open | 连接到远程FTP服务器 | open [IP地址] [端口号] |
open 192.168.1.106 21 |
| 3 | user | 输入用户名进行认证 | user [用户名] |
user admin |
| 4 | pwd | 查询远程服务器当前工作目录 | pwd |
pwd |
| 5 | dir/ls | 列出服务器当前目录文件 | dir [参数]或 ls [参数] |
dir或 ls -l |
| 6 | cd | 切换远程服务器目录 | cd [目录名] |
cd public_html |
| 7 | bin | 设置二进制传输模式 | bin |
bin |
| 8 | put | 上传单个文件到远程服务器 | put [本地文件路径] |
put "D:\docs\report.pdf" |
| 9 | get | 从远程服务器下载单个文件 | get [远程文件名] [本地路径] |
get index.html D:\downloads |
| 10 | prompt | 开启/关闭交互模式 | prompt |
prompt |
| 11 | mput | 批量上传文件 | mput [文件掩码] |
mput *.txt |
| 12 | mget | 批量下载文件 | mget [文件掩码] |
mget *.jpg |
| 13 | mkdir | 在远程服务器创建目录 | mkdir [目录名] |
mkdir backups |
| 14 | rmdir | 删除远程服务器空目录 | rmdir [目录名] |
rmdir temp |
| 15 | delete | 删除远程服务器文件 | delete [文件名] |
delete log.txt |
| 16 | mdelete | 批量删除远程服务器文件 | mdelete [文件掩码] |
mdelete *.bak |
| 17 | rename | 重命名远程服务器文件 | rename [旧名] [新名] |
rename old.doc new.doc |
| 18 | !dir | 查看本地当前目录文件 | !dir |
!dir |
| 19 | lcd | 切换本地文件目录 | lcd [本地路径] |
lcd D:\ftp_uploads |
| 20 | bye/quit | 退出FTP环境 | bye或 quit |
bye |
2、开发与调试¶
2.1 创建QT工程¶
QT工程创建步骤表
| 步骤 | 操作 | 配置选项 | 说明 |
|---|---|---|---|
| 1 | 启动Qt Creator | - | 打开开发环境 |
| 2 | 新建工程 | 新建项目，QT应用程序，嵌入式设备 | 创建新项目 |
| 3 | 设置信息 | 工程名称和路径 | 项目基本信息 |
| 4 | 编译器选择 | qmake（默认） | 构建工具配置 |
| 5 | 界面设置 | 主画面相关信息 | UI界面配置 |
| 6 | 国际化设置 | 默认不选择 | 多语言支持 |
| 7 | 平台选择 | 根据需要选择 | 目标平台配置 |
| 8 | 完成创建 | 点击完成 | 项目创建结束 |
操作步骤：
①：启动开发环境
打开虚拟机中的Qt Creator软件。
②：新建工程向导
新建工程，选择QT应用程序，设备选择嵌入式设备。
③：工程路径设置
设置工程的名称和工程路径。
④：编译器配置
编译器默认选择qmake。
⑤：主画面设置
设置主画面相关信息。
⑥：国际化配置
国际化翻译语言默认不选择，直接点击下一步。
⑦：平台选择
根据需要选择相应的平台。
⑧：完成创建
点击完成结束工程的创建。
2.2 切换QT版本¶
QT版本切换配置表
| QT版本 | 配置要求 | 特殊参数 | 说明 |
|---|---|---|---|
| Qt 5.12.11 | 默认配置 | 无 | 推荐版本 |
| Qt 4.8.4 | 需要额外配置 | -qws | 兼容旧项目 |
操作步骤：
①：打开设置选项
点击Tools中的Option。
②：选择QT版本
点击Kits->Qt version可切换Qt版本。
③：Qt4特殊配置
如果选择Qt4版本，需要在Projects->Run的命令行参数增加-qws。
2.3 QT代码编译¶
编译状态说明表
| 编译状态 | 显示特征 | 含义 |
|---|---|---|
| 编译中 | 进度条显示 | 正在编译 |
| 编译成功 | 绿色满格进度条 | 无错误，编译完成 |
| 编译错误 | 红色错误提示 | 需要修复代码错误 |
编译操作
编译代码，点击小锤子进行编译，如果有错误会有红色的提示，没有错误则会显示绿色满格进度条。
2.4 设备连接¶
网络连接配置表
| 配置项目 | 要求 | 检测方法 | 故障处理 |
|---|---|---|---|
| 虚拟机网络 | 桥接模式 | 网络设置检查 | 重新配置网络 |
| IP地址 | 同一网段 | ping命令测试 | 修改IP配置 |
| 设备连接 | SSH可达 | 连接测试 | 检查网络和权限 |
详细配置步骤：
①：网络桥接配置
检查虚拟机网络是否正常启动，我们这里需要将虚拟机的网络桥接到物理网卡。
②：网络连通性测试
测试虚拟机和触摸屏网络是否连通，此步骤需要确保电脑和屏都处于同一个网段下。触摸屏接上网线点击获取IP可以获取到触摸屏IP，打开虚拟机中的终端【快捷键：Ctrl+Alt+T】进行ping一下触摸屏。
③：调试设备配置
配置调试设备参数，并进行网络连通性测试。
④：连接测试结果
点击测试后，输入HMI的密码后会出来检测结果。
⑤：故障处理方案
如果出现测试失败的情况，如下图所示，在终端中执行命令rm -rf /home/wecon/.ssh/*可以解决此问题。
⑥：静态IP配置
- 当设备采用静态IP或者直连的情况下需对虚拟机的ip进行配置保证其在相同网段下。首先先打开菜单，然后点击设置。
- 打开网络设置。
- 设置静态ip地址。
- 当出现连接速度慢导致的无法连接问题则需修改连接等待时间，最后点击Test测试，测试通讯成功即可应用保存。
2.5 运行QT程序¶
程序运行模式表
| 运行模式 | 功能 | 适用场景 |
|---|---|---|
| 运行程序 | 发布运行 | 功能测试 |
| 调试运行 | 调试运行 | 问题排查 |
运行操作
在设备连接成功的基础上进行程序运行，运行程序和调试运行程序。
2.6 调试快捷键说明¶
调试快捷键功能对照表
| 快捷键 | 功能描述 | 使用场景 | 操作说明 |
|---|---|---|---|
| F5 | 开始调试 | 启动调试会话 | 从当前断点开始执行程序，进入调试模式 |
| Shift + F5 | 停止调试 | 终止调试会话 | 立即停止正在进行的调试过程 |
| F9 | 设置/取消断点 | 代码断点管理 | 在当前行设置或移除断点，用于暂停程序执行 |
| F10 | 单步前进 | 逐过程调试 | 执行当前行代码，但不进入函数内部（Step Over） |
| F11 | 单步进入函数 | 逐语句调试 | 执行当前行代码，并进入被调用函数内部（Step Into） |
| Shift + F11 | 单步跳出函数 | 函数跳出调试 | 执行完当前函数剩余代码，返回到调用处（Step Out） |