简介面向固高运动卡三轴运动台控制场景基于Qt与C开发的上位机程序及完整源码适合毕业设计、课程设计与项目二次开发也可作为初学运动控制的上位机示例。压缩包共18个文件以源代码文件与界面文件为主体辅以工程配置、控制卡参数配置、静态库及图标图片等资源整体仅80KB目录简洁便于逐项阅读。代码已经过严格测试可构建运行界面利用自绘部件实时呈现轴状态控制逻辑清晰涉及运动卡初始化、点位运动、状态读取等常见功能配置文件便于适配不同型号的固高运动卡。目前已有499人学习参考对于希望在较短时间内掌握上位机开发框架、搭建三轴运动控制界面的学生与开发者具有不错的参考价值。1. 三轴运动台的上位机难点不在画界面而在运动状态机三轴运动台的上位机程序最耗时间的从来不是按钮排版而是三个轴的状态怎么同步回零顺序、JOG 松开后能不能立即收敛、限位触发后报警如何恢复。固高运动卡的插补、PID 与回零逻辑都在板卡上算好Qt C 侧真正要做的是把固高 API 封装成不绑界面的运动对象再用信号槽把命令和状态跨线程安全搬运。很多第一次上手的人直接在按钮槽里等 GT_Move 返回窗口卡死还以为是卡的问题。下面按工程习惯讲固高卡 SDK 接入、Axis 封装、QThread 线程模型、手动与 JOG 面板的数据链路以及回零、限位、急停与脉冲当量标定的坑。适合拿来做毕业设计、课程设计也适合刚接手三轴运动台项目的上位机工程师。2. 固高运动卡的接口约定与 Qt 侧的运动控制封装固高卡与上位机的通信方式并不神秘系统里装好驱动后DLL 导出一组 C 函数上位机调用它相当于把运动指令写进板卡的命令缓冲区。上位机不需要直接操作总线但要对「命令何时发送、状态何时回来、报警何时发生」有清晰的时序概念。先把接口层捋顺再落成一个可复用的 Axis 类比在主窗口里到处写GT_前缀的函数可靠得多。2.1 先接 SDK 再谈类设计CMake 配好 gts 库接入的固定套路是拿到固高随卡附带的 SDK 包把 gts.h 头文件放到工程目录gts.lib 放到库目录再在 CMake 里指明依赖。工程建议用 CMake 管理Qt 5.15 与 Qt 6 都能编译配置片段如下cmake_minimum_required(VERSION 3.16) project(StageControl LANGUAGES CXX) set(CMAKE_CXX_STANDARD 17) set(CMAKE_AUTOMOC ON) # 信号槽元对象编译Qt 工程必须开 set(CMAKE_AUTORCC ON) find_package(Qt6 COMPONENTS Widgets QUIET) if(NOT Qt6_FOUND) find_package(Qt5 5.15 REQUIRED COMPONENTS Widgets) endif() add_executable(StageControl main.cpp MainWindow.cpp MotionWorker.cpp Axis.cpp ) target_include_directories(StageControl PRIVATE ${CMAKE_SOURCE_DIR}/third_party/gts) target_link_directories(StageControl PRIVATE ${CMAKE_SOURCE_DIR}/third_party/gts/lib) target_link_libraries(StageControl PRIVATE Qt::Widgets gts)这段 CMake 里最重要的是CMAKE_AUTOMOC ON。Qt 的信号槽依赖 moc 预处理不开这个开关编译报错会在Q_OBJECT宏上定位起来比较绕。include 目录指向 gts.h 所在路径lib 目录指到 gts.lib 放的位置如果固高 SDK 里还给了gts64.lib记得按编译平台选。Qt 版本上环境是 5.15.2 MSVC2019_64 还是 Qt6 都能走通CMake 会自动找。网络上下载的 Qt 套件注重的一项是保证「编译器位数」和运动卡驱动一致64 位工程就用 64 位库混用会在一开始链接时就失败。SDK 接好后的最小调用本质是「打开卡、复位、设轨迹参数、发运动指令、等完成」五步。一个不带界面的控制台版本如下#include gts.h #include cstdio int main() { if (GT_Open() ! 0) return -1; // 打开第一块运动控制卡 GT_Reset(); // 复位板卡清报警与运动状态 short axis GT_AXIS_X; // 轴号从 0 开始的宏定义 GT_PrfTrap(axis, 0); // 设成点位运动梯形速度规划 TRAP_PRM trap{}; trap.acc 50.0; // 加速度单位脉冲/s^2 trap.dec 50.0; // 减速度 trap.vel 10.0; // 最大速度 GT_SetTrapPrm(axis, trap); // 下载轨迹参数 int sts 0; GT_Move(axis, 10000); // 走 10000 个脉冲 do { GT_GetSts(axis, sts); } while (!(sts MOTION_DONE)); GT_Close(); // 释放板卡资源 return 0; }GT_Open返回 0 才代表板卡初始化成功非 0 时先查驱动装没装、PCIe 灯亮不亮不要急着改参数。TRAP_PRM里三个速度单位都是脉冲联动到「毫米」之前必须先确定脉冲当量否则同样的速度值在两个不同导程的台子上手感完全不同。MOTION_DONE是状态字的完成位部分 SDK 称MOTION_STOP以头文件宏名为准这个轮询循环只适合测试放进 Qt 工程后会卡死主线程后面第 3 章专门讲怎么处理。固高卡常用函数可以整理成一张表后续封装的轴对象都是在调用这张表里的内容固高 API用途典型调用时机GT_Open / GT_Reset打开板卡、复位报警与运动状态程序启动、异常恢复GT_PrfTrap GT_SetTrapPrm GT_Move点位运动绝对定位、自动流程GT_PrfJog GT_SetJogPrm GT_Jog连续点动JOG 按键按下GT_GetSts / GT_GetPrfPos / GT_GetEncPos状态与位置回读状态轮询、到位判断GT_Home回零上电后的第一步动作2.2 Axis 类把固高 API 按轴收口三轴程序如果直接在 UI 里写GT_Move(GT_AXIS_X, ...)命令会散落各处轴号容易手滑写错报警判断还不统一。我会在中间加一层 Axis 类每个轴对象持有轴号、脉冲当量、加减速参数和当前目标位置。头文件骨架如下#pragma once class Axis { public: Axis(short axisNo, double pulsePerMm); bool init(); // 复位该轴报警、下 PID 参数 bool absMove(double mm); // 绝对定位单位毫米 bool relMove(double mm); // 相对定位 void jog(double velMmPerSec); // 连续点动 void stop(); // 减速停止 bool home(); // 回零 bool positionMm(double mm); // 读编码器实际位置 private: short m_axisNo; double m_pulsePerMm; double m_accPulse; // 换算好的加速度脉冲/s^2 double m_velPulse; // 换算好的速度脉冲/s };init里做的事很固定调用GT_Axis选轴、清除该轴报警、按厂商推荐值下发一组伺服参数。这个动作放在构造函数里做并不合适因为板卡可能还没打开分开一个init()可以在初始化失败时返回错误码UI 上弹提示。absMove的坑值得单独写一下。GT_Move 是「相对当前位置走多少」不是「走到某个绝对坐标」所以绝对定位必须先读当前逻辑位置再做差值否则第二次定位会整体偏移一段距离。bool Axis::absMove(double mm) { long target static_castlong(mm * m_pulsePerMm); long cur 0; GT_GetPrfPos(m_axisNo, cur); // 卡内当前规划位置 long delta target - cur; // 差值 目标 - 当前 TRAP_PRM trap{}; trap.acc m_accPulse; // 加/减速对称 trap.dec m_accPulse; trap.vel m_velPulse; GT_SetTrapPrm(m_axisNo, trap); return GT_Move(m_axisNo, delta) 0; // 只代表指令发出成功 }这里有个容易误读的细节GT_Move返回 0 只代表指令被板卡接收不代表运动完成。真正判断是否到位要等状态位里的运动完成标志或者读规划位置与目标位置的差值小于一个死区。如果是 Z 轴这类垂直轴减速度dec不要和加速度一样在实际项目中恰恰相反垂直轴带负载下落时减速过大容易丢步我会把 Z 轴的 dec 设成 acc 的 80% 左右并且初始速度保守一点。JOG 的实现更短但参数结构体不同void Axis::jog(double velMmPerSec) { long velPulse static_castlong(velMmPerSec * m_pulsePerMm); JOG_PRM jog{}; jog.jog velPulse; // 目标速度正负决定方向 jog.acc m_accPulse; // 加速斜率 jog.dec m_accPulse; // 减速斜率松键停车时用的就是它 GT_SetJogPrm(m_axisNo, jog); GT_Jog(m_axisNo, velPulse); }JOG_PRM的 dec 参数直接影响「松开按钮后滑多远」。手动调试时把 dec 与 acc 设成相同的值再逐步加大如果 dec 太小按钮松开台子还要往前冲一截新手会误以为指令失效。2.3 三轴参数表与软限位的两处防线三轴运动台的参数不能只写在注释里初始化时要有一份明确的配置表。以下是我在类似项目里常用的初始值实际数值要按标定结果覆盖轴固高轴号脉冲当量 pulse/mm最大速度 mm/s行程 mmXGT_AXIS_X1000300 ~ 300YGT_AXIS_Y1000300 ~ 300ZGT_AXIS_Z1000100 ~ 100Z 轴的行程最短、速度最慢因为垂直轴负载变化会直接影响动态响应速度过快容易丢步。脉冲当量并不是丝杠导程倒数的理论值而是实测标定出来的第 5 章会讲具体操作。软限位要做两道防线。第一道直接设在运动卡上固高部分型号有软限位接口位置到了卡自己停型号不支持时就在 Axis 层做absMove入口先判断目标值在不在软限位范围内。第二道防线在 UI输入框限制可输入范围按钮在超程时置灰。两层都能挡住错误指令但理由不同卡上的软限位是最后保险UI 层的判断是给操作者即时反馈。3. 用 QThread 和信号槽把界面操作与运动执行分开Qt 的线程模型是事件循环式的主线程负责界面刷新和事件分发运动控制这种长期的、需要轮询的任务放进单独的线程里才能避免「界面卡住」这类最常见的问题。固高卡与上位机的通信本质上就是上位机调 DLL 里的接口下位机与板卡之间怎么交换数据不用关心线程隔离做好系统的实时性就能落在运动卡侧。3.1 为什么运动调用不能放在 Qt 主线程错误的做法有两类。一类是在按钮的clicked槽里直接调GT_Move如果后续还要等待运动结束主线程就阻塞在轮询里窗口拖不动重绘全部停摆。另一类是用QTimer定时从界面线程发运动指令定时器间隔一短命令积压界面和运动相互抢事件。这两类问题从表现上看都是「程序没死但窗口像是被冻结」。正确的归属关系是凡是会与运动卡长时间交互的代码比如回零、连续点动、周期状态读取全部放进一个 worker 对象worker 通过moveToThread进入独立的 QThread主线程只发命令、收状态。这样 GUI 线程的事件循环不被打断worker 线程里的轮询再密集也影响不到界面。用 QThread QObject worker 而不是继承 QThread 重写 run是因为这里的 worker 需要「长期存活、反复接收指令」不是跑一次就结束的任务。QThread 自己只负责提供事件循环业务代码放在 worker 的槽函数里命令通过信号跨线程排队天然就是线程安全的。3.2 Worker 收命令、发状态信号槽的正确接法Worker 类的典型声明是几个槽函数对应几类运动操作外加一个 QTimer 定时做状态轮询class MotionWorker : public QObject { Q_OBJECT public: explicit MotionWorker(QObject *parent nullptr); public slots: void onInit(); // 上电初始化 void onAbsMove(int axisIndex, double mm); // 绝对定位 void onJog(int axisIndex, double velMmPerSec); // 点动 void onStopJog(int axisIndex); // 停止点动 void onStopAll(); // 紧急停止 void onPollTick(); // 定时轮询 signals: void initialized(bool ok); void positionUpdated(const QVectordouble posMm); void moveFinished(int axisIndex, bool ok); void alarmRaised(int axisIndex, int code); private: Axis m_axes[3]; QTimer *m_pollTimer nullptr; };主窗口与 worker 的连接如下MotionWorker *worker new MotionWorker; worker-moveToThread(m_workerThread); m_workerThread.start(); connect(this, MainWindow::sigAbsMove, worker, MotionWorker::onAbsMove, Qt::QueuedConnection); connect(worker, MotionWorker::positionUpdated, this, MainWindow::updatePositionLabel);这段代码的关键在连接方式。跨线程连接默认是Qt::QueuedConnection槽函数会进入 worker 线程的事件队列按顺序执行主线程发出的命令不会打断 worker 正在执行的逻辑。显式写出来是防止后人改成Qt::DirectConnection一旦改成直连槽函数实际在主线程执行worker 搬线程就白做了。回传方向的连接不用指定连接类型worker 发信号、主线程收自动排队回到界面线程UI 更新就不会有竞争。线程退出顺序有个常见崩溃点先delete worker再停线程或者先quit()后不等wait()。正确顺序是先调用m_workerThread.quit()再m_workerThread.wait()最后才 delete worker 对象。否则 worker 还在处理命令时对象被释放下一次信号过来直接访问野指针。3.3 状态回传100ms 刷一次界面就够了worker 内部用一个 QTimer 做周期轮询QTimer 在 worker 构造函数里创建moveToThread完成之后计时就跟随 worker 线程的事件循环走。典型轮询代码void MotionWorker::onPollTick() { QVectordouble pos(3); for (int i 0; i 3; i) { long enc 0; if (GT_GetEncPos(m_axes[i].axis(), enc) 0) { pos[i] enc / m_axes[i].pulsePerMm(); // 脉冲换算成 mm } } emit positionUpdated(pos); // 一次性把三个轴位置发出去 }100ms 的间隔对数字显示足够对按钮和灯的状态刷新也不会产生闪烁感。如果要做实时轨迹观测比如第 4 章的绘图10ms 的数据才有意义这时不要推高界面刷新频率而是让 worker 用 10ms 定时器往曲线缓存里追加点界面侧依然按 100ms 取一次数据重绘。这里有个容易搞混的点GT_GetEncPos读的是编码器实际反馈GT_GetPrfPos读的是卡内规划位置。判断「有没有到位」读规划位置判断「有没有丢步」对比两个值的差。把两件事读错排查问题时会平白多耗半天。4. 三轴运动台的手动/JOG/自动面板这样设计最省事面板设计直接影响调试效率。三个轴拆成三行每行放 JOG 加减、目标位置输入和定位按钮全局一行放急停。用 QGridLayout 排布窗口缩放也不会乱。4.1 用 Qt 布局搭手动控制面板手动面板用 QGroupBox 包一个 QGridLayout三个轴循环生成避免重复粘贴代码for (int i 0; i 3; i) { auto *box new QGroupBox(axisName[i], this); auto *grid new QGridLayout(box); auto *btnMinus new QPushButton(QStringLiteral(JOG -)); auto *btnPlus new QPushButton(QStringLiteral(JOG )); auto *btnMove new QPushButton(QStringLiteral(定位)); auto *editPos new QLineEdit(QStringLiteral(0.0)); connect(btnMinus, QPushButton::pressed, this, [this, i] { emit cmdJog(i, -m_manualSpeed); // 负方向点动 }); connect(btnMinus, QPushButton::released, this, [this, i] { emit cmdStopJog(i); // 松开必须发停止 }); // btnPlus 的连接与 btnMinus 对称速度取正方向 grid-addWidget(btnMinus, 0, 0); grid-addWidget(btnPlus, 0, 1); grid-addWidget(editPos, 0, 2); grid-addWidget(btnMove, 0, 3); }这里特意用pressed和released而不是clicked。clicked是按下又松开后才触发一次用在 JOG 上会造成「按久一点才动、松开还继续走」的错觉。pressed对应按下瞬间发 JOG 指令released对应松开瞬间发停止指令时序正好匹配物理按钮的手感。JOG 的停止命令必须由界面显式发出不能在 worker 里用定时器自动掐断否则手动微调时手感会很怪。步进量输入建议用 QDoubleSpinBox范围 0.001 到 10mm默认 1mm。位置显示区可以用 QProgressBar 显示当前轴位置占行程比例这个就是 Qt 自定义进度条最常见的用法设置setRange(0, rangeMm)位置更新时setValue(posMm)比纯数值直观。4.2 JOG 与点位运动的参数映射界面上的每一次交互最终都要落到固高卡的 API 调用。把映射关系整理成表做自动流程时就不会在命令序列上纠缠界面操作Worker 命令固高 API 序列关键参数按下 JOG-XcmdJog(0, vel)GT_PrfJog - GT_SetJogPrm - GT_Jog(axis, v)速度由 pulse/mm 换算成脉冲/s松开 JOG-XcmdStopJog(0)GT_Stop(axis, 1)第二参数 1 表示减速停止目标位置输入 定位cmdAbsMove(0, 50.0)GT_PrfTrap - GT_SetTrapPrm - GT_Move(axis, delta)先读当前规划位再算差值急停按钮cmdStopAll()对三个轴依次 GT_Stop不要同时断伺服使能急停这一行值得展开。很多初次做上位机的人一按急停就想着「切断伺服使能」结果运动卡的状态和电机物理位置脱钩恢复后GT_GetPrfPos和实际位置对不上还要重新回零。常见的可靠做法是急停时发GT_Stop让轴减速停止同时通过 IO 输出一路信号给驱动器急停端子。上位机里的软急停只做一件事——让运动卡停下断电逻辑交给硬件链路。4.3 用 Qt 绘图画实时轨迹三轴运动台调试时最需要看的是「指令位置 vs 实际位置」的偏差。用 QPainter 自定义一个轨迹控件比引入 QCustomPlot 更快也减少一个依赖。核心代码只在 paintEvent 里class TrackView : public QWidget { Q_OBJECT public: void appendPoint(const QPointF p) { m_points.append(p); update(); // 触发重绘 } protected: void paintEvent(QPaintEvent *) override { QPainter p(this); p.setRenderHint(QPainter::Antialiasing, true); p.setPen(QPen(QColor(220, 220, 220))); for (int x 0; x width(); x 20) p.drawLine(x, 0, x, height()); for (int y 0; y height(); y 20) p.drawLine(0, y, width(), y); p.setPen(QPen(Qt::blue)); p.drawRect(mmToPixels(QRectF(0, 0, 300, 300))); // 台面边界 p.setPen(QPen(Qt::red, 2)); if (m_points.size() 1) p.drawPolyline(m_points.constData(), m_points.size()); } private: QVectorQPointF m_points; // 已换算成像素坐标 QRectF mmToPixels(const QRectF r); };两个细节要注意。一是坐标系方向屏幕坐标 Y 轴向下运动台的 Y 轴通常向上mmToPixels里要做一次镜像不然画出来的轨迹是反的。二是不要在paintEvent里读运动卡位置重绘与运动线程抢数据会造成界面闪烁正确做法是 onPollTick 收到位置后调用appendPoint把数据推到控件内部再触发重绘。Qt 绘图的性能在几千个点内没有压力但如果跑长时间连续轨迹要限制m_points的容量超过容量就丢弃最旧的点避免内存无限增长。5. 回零、限位、急停与脉冲当量标定容易被扣分的四个细节回零、限位、急停和脉冲当量这四件事在课程答辩或项目验收时几乎必问。做得不完整界面再漂亮也会被扣分。回零顺序要先定好。三轴运动台的典型动作顺序是 Z 先回零抬到最高点然后 X、Y 再回零避免机构干涉。固高卡回零调用GT_Home回零速度分高速趋近和低速找原点两段回退量建议设成开关宽度的 1.5 倍以上否则开关位置公差会导致每次回零原点漂移。限位触发后不能按正常流程恢复。硬件正负限位要接到运动卡的限位输入触发后卡自动停对应轴。但要注意限位触发后运动卡进入报警状态GT_GetSts读到的是报警位而不是完成位上位机不能用运动完成的逻辑去判断。恢复流程应当手动确认机构安全再调用清报警接口复位界面里要弹窗让操作者确认不要自动清除。急停建议做三层第一层是运动卡急停 IO 直接断电机使能第二层是上位机收到 IO 状态后立刻发GT_Stop第三层是界面弹出报警对话框并禁止继续发命令。第二层不要同时断伺服使能否则运动卡里规划位置还在走复位后位置全乱。脉冲当量不要用丝杠导程和减速比纯算要实际走一段量。做法是 JOG 移动约 10mm用千分表读实际位移编码器脉冲差除以实际位移至少做 5 次取平均。标定结果写进 QSettings程序启动时自动读取换台机器不用重新编译。本文还有配套的精品资源点击获取