当前位置：首页 > news >正文

基于 VC++ 与机器人 SDK 的工业多轴示教器软件设计与实现

news 2026/6/30 23:32:45

摘要

工业机器人作为智能制造核心执行单元，示教器是操作人员与机器人本体交互的唯一可视化载体，承担状态监控、点位示教、运动控制、故障处理全流程功能。本文基于 Windows 平台 MFC 框架（VC++）搭配 fjrobotSDK 机器人运动控制开发套件，完成一套 8 轴联动工业机器人示教器软件完整开发，实现多轴实时数据采集、手动点动控制、点位存储、故障报警、倍率调节等工业级核心功能。文章从开发环境、总体架构、核心模块代码实现、人机交互界面优化、工业现场稳定性优化五大维度展开阐述，解决多轴数据高频刷新闪烁、SDK 驱动数据同步、GDI 绘图资源泄漏、多线程数据冲突等工程常见痛点，可为同类工业上位机示教软件开发提供参考。关键词：VC++；MFC；机器人 SDK；工业示教器；多轴运动控制；双缓冲绘图

一、项目开发背景与需求分析

1.1 行业应用背景

当下自动化产线、智能仓储、焊接打磨、机床上下料场景大量使用多轴联动工业机器人，传统配套示教器多为厂商定制硬件终端，存在采购成本高、功能固化、无法对接产线 MES 系统、屏幕尺寸受限等短板。基于 PC 平台 Windows 系统自主开发示教上位机，依托成熟 SDK 运动控制接口搭配 VC++ MFC 图形界面框架，具备定制灵活、拓展性强、硬件成本低、可对接工厂信息化系统等显著优势，成为中小型自动化设备厂商的主流开发方案。本文配套开发的 fjrobotSDK 是适配国产多轴伺服机器人的标准化开发套件，封装伺服通讯、点位插补、编码器读取、故障报警、原点回归等底层驱动接口，屏蔽不同伺服驱动器、总线协议（EtherCAT/Modbus）底层差异，开发者仅需调用高层函数即可完成机器人运动逻辑开发，大幅降低运动控制开发门槛。

1.2 示教器软件功能需求

结合实拍界面的实际功能，软件需满足工业现场操作人员的全流程使用需求，分为五大功能模块：

多轴实时状态监控模块：支持 a0-a7 共 8 轴同步数据采集，实时展示单轴坐标位置、扭矩百分比、绝对编码器原始值、实时转速、目标设定位置、电机故障报警码，数据毫秒级刷新，无界面闪烁；
手动运动控制模块：单轴点动选择、分区轴组切换（0-7 轴 / 8-15 轴等）、正反转切换、运动倍率分级调节（10%~100%），急停、使能、启停、暂停基础安全控制；
原点与点位管理模块：单轴 / 多轴回原点、自定义坐标系原点设置、目标位置点位写入与同步下发；
故障与安全处理模块：电机报警码实时展示、一键报警清除、全局急停锁定、操作权限管控（允许操作开关）；
底层通讯与状态展示：SDK 版本、客户端版本、网络连接状态、当前运动倍率底部状态栏常驻显示，断线自动重连、通讯异常弹窗提示。

1.3 非功能性工业指标需求

实时性：伺服轴数据采集周期≤10ms，界面刷新无卡顿；
稳定性：7×24 小时连续运行无 GDI 资源泄漏、无内存溢出、无 SDK 通讯断连；
交互友好性：工业大按钮布局、色彩区分功能（红色急停 / 启动、绿色使能、粉色运行），适配车间戴手套操作；
兼容性：Windows10/11 全平台兼容，适配工控低配置主机；
抗干扰：工业电磁环境下通讯丢包自动重传，数据异常过滤，避免界面数值跳变。

二、开发环境与整体软件架构

2.1 软硬件开发环境

软件开发环境：Visual Studio 2019（VC++ MFC），Windows SDK 10.0，fjrobotSDK V20250108 动态链接库，MFC 基于对话框程序架构；
运行硬件平台：工业触控工控机（10 寸触控屏），搭载 Windows10 专业版；
机器人硬件：8 轴伺服联动机器人本体，EtherCAT 总线伺服驱动器，支持绝对值编码器、扭矩实时反馈。

2.2 三层模块化软件架构

软件采用分层解耦架构，分为底层 SDK 驱动交互层、业务逻辑处理层、MFC 人机交互界面层，三层完全隔离，降低后期维护与功能拓展成本。

底层 SDK 交互层：封装所有 fjrobotSDK 接口调用，独立创建通讯管理类CRobotSdkManager，统一处理机器人连接、轴数据读取、运动指令下发、报警读取、原点回归等操作，向上层业务层提供标准化调用接口，屏蔽 SDK 底层回调、线程、总线细节；内部开辟独立采集线程，循环读取 8 轴伺服实时数据，存储至全局结构体缓存，避免界面主线程阻塞。
业务逻辑处理层：创建CRobotLogic业务类，接收 SDK 层推送的轴数据缓存，完成数据校验、数值换算（编码器转实际坐标、转速单位换算）、故障码解析、运动倍率限制逻辑、安全互锁逻辑（急停按下后禁止所有运动指令、未使能无法启动运行）；同时接收界面按钮操作指令，校验权限后转化为 SDK 标准运动指令下发。
MFC 人机交互界面层：基于对话框搭建主界面，拆分自定义控件、标准按钮、列表表格、状态栏四大交互单元；自定义CCustomStatic双缓冲静态文本控件用于实时数值显示，解决高频刷新闪烁问题；采用色彩分区 UI 设计区分安全、运动、设置类按钮；主线程定时器定时读取业务层处理完成的轴数据，刷新表格与数值控件。

2.3 核心数据结构体设计

定义单轴状态结构体存储 SDK 采集的全部实时数据，8 轴数据通过数组统一管理，作为三层架构数据流转载体：

cpp

运行

// 单轴伺服状态结构体 typedef struct tagAxisData { int nAxisNo; // 轴号 a0~a7 double dActPos; // 当前实际坐标值 CString strTorque; // 扭矩百分比 LONGLONG lEncoder; // 绝对编码器原始值 double dSpeed; // 实时转速 转/分 double dTargetPos; // 目标设定位置 UINT nAlarmCode; // 电机报警码 }AXIS_DATA, *LPAXIS_DATA; // 8轴全局数据缓存数组 AXIS_DATA m_arrAxisData[8];

SDK 采集线程每 10ms 更新一次m_arrAxisData缓存，业务层完成数据过滤与换算后，界面定时器读取缓存渲染界面，杜绝主线程直接阻塞 SDK 通讯接口。

三、核心功能模块详细设计与代码实现

3.1 底层 SDK 通讯管理模块（CRobotSdkManager）

该类是软件与 fjrobotSDK 交互的唯一入口，封装 SDK 初始化、网络连接、周期数据采集、运动指令下发四大核心功能，开辟独立后台采集线程，避免 MFC 主线程 IO 阻塞导致界面卡顿。

关键功能 1：SDK 初始化与网络连接

软件启动时自动调用 SDK 初始化接口，传入客户端版本校验，建立工控机与机器人控制器的 TCP 通讯，底部状态栏实时更新网络连通状态；通讯断开时自动启动 3 秒周期重连机制，同时界面弹出故障提示。

cpp

运行

BOOL CRobotSdkManager::InitRobotSdk() { // 调用fjrobotSDK初始化接口 int nRet = FR_InitSdk(CLIENT_VERSION); if(nRet != 0) { m_bConnect = FALSE; return FALSE; } // 建立机器人控制器网络连接 m_bConnect = FR_ConnectRobot(_T("192.168.1.100")); // 启动后台数据采集线程 AfxBeginThread(SdkDataThread, this); return m_bConnect; }

关键功能 2：后台周期轴数据采集线程

独立线程循环读取 8 轴全部实时数据，存入全局缓存结构体，线程休眠 10ms 保证采集周期稳定，避免高频循环占用 CPU 资源：

cpp

运行

UINT SdkDataThread(LPVOID pParam) { CRobotSdkManager* pSdkMgr = (CRobotSdkManager*)pParam; while(pSdkMgr->IsConnect()) { for(int i = 0; i < 8; i++) { // SDK接口读取单轴全部状态数据 FR_GetAxisActPos(i, &pSdkMgr->m_arrAxisData[i].dActPos); FR_GetAxisTorque(i, pSdkMgr->m_arrAxisData[i].strTorque); FR_GetAxisEncoder(i, &pSdkMgr->m_arrAxisData[i].lEncoder); FR_GetAxisSpeed(i, &pSdkMgr->m_arrAxisData[i].dSpeed); FR_GetAxisTargetPos(i, &pSdkMgr->m_arrAxisData[i].dTargetPos); FR_GetAxisAlarm(i, &pSdkMgr->m_arrAxisData[i].nAlarmCode); } Sleep(10); // 10ms采集周期 } return 0; }

关键功能 3：运动指令标准化下发接口

封装急停、使能、点动正反转、回原点、倍率调节、报警清除等 SDK 运动指令，增加安全校验逻辑：急停触发状态下直接拦截所有运动指令下发，规避工业安全事故。

3.2 自定义双缓冲显示控件 CCustomStatic（解决界面闪烁痛点）

工业示教器需要毫秒级刷新数十组实时数值，原生 MFC 静态文本控件高频重绘会出现严重闪烁，本文自研CCustomStatic双缓冲 GDI 绘图控件，所有轴坐标、转速、报警数值均使用该控件展示，完全消除闪烁，前文完整实现代码已验证稳定运行。

控件核心设计要点

双缓冲内存 DC 绘图逻辑：创建兼容内存位图，所有文字、背景绘制在内存画布完成后一次性贴到界面，避免频繁刷新背景造成闪烁；
可自定义拓展接口：SetText()更新显示数值、SetTextFont()自由设置字体高度与字体名称、SetTextColor()自定义文字前景色，适配工业界面不同状态色彩区分（正常数值黑色、异常报警数值红色）；
资源自动管理：析构函数释放 CFont 字体 GDI 对象，杜绝长期运行内存泄漏；
刷新优化：仅文本 / 颜色变更时调用Invalidate()触发重绘，无数据变化跳过重绘，降低 CPU 占用。

控件典型调用示例

界面刷新时，读取业务层缓存的轴坐标数据，调用自定义控件接口更新显示红色异常数值：

cpp

运行

// a0轴坐标数值刷新 m_staA0Pos.SetTextColor(RGB(0,0,0)); if(m_arrLogicData[0].nAlarmCode != 0) { m_staA0Pos.SetTextColor(RGB(255,0,0)); // 报警状态标红 } CString strPos; strPos.Format(_T("%.3f"), m_arrLogicData[0].dActPos); m_staA0Pos.SetText(strPos);