从编译到上板：手把手教你用Qt Creator远程调试正点原子I.MX6U的Qt应用（含SCP/SSH配置）

从编译到上板：手把手教你用Qt Creator远程调试正点原子I.MX6U的Qt应用（含SCP/SSH配置）

在嵌入式Linux开发中，Qt应用程序的远程调试一直是让开发者头疼的环节。特别是当面对正点原子I.MX6U这样的ARM Cortex-A7平台时，如何高效地将编译好的程序部署到开发板并进行调试，直接关系到开发效率。本文将深入探讨Qt Creator中那些鲜为人知的部署技巧，带你突破SFTP的限制，用更灵活的SSH+SCP方案实现一键部署与调试。

1. 环境准备与基础配置

1.1 开发环境检查清单

在开始之前，请确保你的工作环境满足以下要求：

• 主机系统：Ubuntu 18.04 LTS（推荐）或16.04
• Qt版本：5.12.9 LTS（与正点原子出厂系统保持一致）
• 交叉编译工具链：fsl-imx-x11-glibc-x86_64-meta-toolchain-qt5
• 开发板环境：正点原子I.MX6U-ALPHA开发板，运行出厂Qt文件系统
• 网络连接：开发板与主机在同一局域网，SSH服务已启用

提示：可以通过在开发板终端执行systemctl status sshd确认SSH服务状态

1.2 网络配置关键点

稳定的网络连接是远程调试的前提。建议按照以下步骤配置：

1. 固定开发板IP：

   # 在开发板终端执行（临时生效） ifconfig eth0 192.168.1.100 netmask 255.255.255.0

2. 测试基础连通性：

   # 在主机终端测试 ping 192.168.1.100 ssh root@192.168.1.100

3. 免密登录配置（可选但推荐）：

   # 主机生成密钥 ssh-keygen -t rsa ssh-copy-id root@192.168.1.100

2. Qt Creator设备配置详解

2.1 创建设备配置文件

在Qt Creator中配置开发板连接需要特别注意以下参数：

2.2 常见连接问题排查

当遇到连接失败时，可以按照以下流程检查：

1. 基础网络测试：

   telnet 192.168.1.100 22

   应看到SSH版本信息

2. 防火墙检查：

   # 开发板执行 iptables -L

3. SSH服务日志：

   # 开发板执行 journalctl -u sshd --no-pager

3. 自定义部署流程实战

3.1 替代SFTP的SCP方案

正点原子出厂系统未预装SFTP服务，我们需要用SCP+SSH组合实现部署：

1. 创建目标目录（通过SSH）：

   ssh -p %{Device:SshPort} %{Device:UserName}@%{Device:HostAddress} \ "mkdir -p %{CurrentRun:Executable:Path}"

2. 传输可执行文件（通过SCP）：

   scp -P %{Device:SshPort} %{CurrentRun:Executable:FileName} \ %{Device:UserName}@%{Device:HostAddress}:%{CurrentRun:Executable:FilePath}

3.2 Qt Creator配置步骤

在项目配置界面，需要精确设置以下参数：

1. 删除默认部署步骤：

   • 在"Run"配置中移除"Deploy via SFTP"

2. 添加自定义步骤：

   Command: ssh Arguments: -p %{Device:SshPort} %{Device:UserName}@%{Device:HostAddress} 'mkdir -p %{CurrentRun:Executable:Path}'

3. 添加文件传输步骤：

   Command: scp Arguments: -P %{Device:SshPort} %{CurrentRun:Executable:FileName} %{Device:UserName}@%{Device:HostAddress}:%{CurrentRun:Executable:FilePath}

4. 高级调试技巧与优化

4.1 远程调试配置

要实现完整的调试功能，还需要配置gdbserver：

1. 开发板端准备：

   # 在开发板安装gdbserver opkg update opkg install gdbserver

2. Qt Creator调试配置：

   Debugger: /opt/fsl-imx-x11/4.1.15-2.1.0/sysroots/x86_64-pokysdk-linux/usr/bin/arm-poky-linux-gnueabi/arm-poky-linux-gnueabi-gdb

4.2 性能优化建议

对于I.MX6U这类资源有限的平台，建议：

• 编译选项优化：

  QMAKE_CXXFLAGS += -O2 -mfpu=neon -mfloat-abi=hard

• Qt模块裁剪：

  ./configure -no-opengl -no-icu -no-glib -no-cups -no-iconv

• 部署后自动启动：

  ssh -p %{Device:SshPort} %{Device:UserName}@%{Device:HostAddress} \ "export DISPLAY=:0 && %{CurrentRun:Executable:FilePath}"

5. 实战问题解决方案

5.1 常见错误代码处理

5.2 日志收集与分析

建议在自定义部署步骤中添加日志输出：

# 在Custom Process Step中添加 Command: ssh Arguments: -p %{Device:SshPort} %{Device:UserName}@%{Device:HostAddress} \ "echo 'Deploy started at $(date)' >> /var/log/qt_deploy.log"

在开发板上可以通过以下命令查看实时日志：

tail -f /var/log/qt_deploy.log