电脑版示教器软件：连接、标定、编程与备份避坑指南

简介面向汇川机器人编程、调试与自动化产线运维人员的PC端示教器软件包将示教器功能迁移到个人计算机便于开展远程控制、程序编写、离线仿真、示教点管理和故障排查也可作为相关专业学生熟悉机器人操作界面的练习环境。压缩包共711个文件约5.71MB以597张jpg和70张bmp界面及示教点素材图为主并含21个ini配置、16个dll运行库以及xml、data、日志和可执行程序等分别承担界面资源、参数配置与运行支撑。已有2620人学习下载说明该工具在汇川机器人用户中具有一定参考价值。读者可据此了解电脑版示教器的文件构成与启动方式结合图形化编程、离线路径预览和错误信息提示搭建个人仿真调试环境减少现场停机与试错成本。1. 电脑版示教器软件为什么老调试员宁愿多带一台笔记本第一次在产线上改一段六十多行的轨迹程序我是在示教器的小屏上一个个字符敲完的敲到一半手腕发酸还敲错了一个坐标系编号整段重来。后来换成机器人电脑版示教器软件同样的程序在笔记本上二十分钟改完顺手把点位表导出来做了比对。这类软件干的事情很朴素把示教器上的界面、点位表、参数页、报警页搬到 PC 上通过以太网和控制器通信用键盘鼠标替代薄膜按键用大屏替代四寸小屏。它能解决的问题集中在三块批量编辑点位、参数页整页对照着改、程序与备份的导入导出。适合集成商调试人员、产线维保、实训教学这几类人——尤其是要反复调同一套轨迹、又需要在文档里保留参数快照的场景。不适合的场景也要说清楚动作固定、一次示教管半年的单机设备多装一套软件反而多一个版本要维护。2. 装完连不上网段、端口与控制权这三关2.1 装之前先核对版本、权限、依赖三件事电脑版示教器软件不是装完就能用它和控制器之间是有版本对应关系的。控制器固件升级过、而 PC 端软件还是老安装包最常见的表现是连接成功但某个参数页是空的或者写参数时提示写入失败。这类问题不会给明确报错只能靠版本核对排除。血泪经验是把控制器当前的系统版本号截图存进项目文档安装包文件名里带上版本号别用「示教器软件_final_新」这种命名。安装环境上有几个硬性点。第一是管理员权限软件通常要写注册表、装驱动组件普通用户装完会出现某些页面加载不出来。第二是运行库依赖缺 .NET 运行时的典型现象是双击图标闪一下就没了事件查看器里能看到缺 DLL。第三是杀毒和终端防护软件它们对「监听端口 读写本地配置文件」的行为比较敏感安装过程和首次运行都可能被拦。我一般会先临时放行安装目录再装。还有一个容易被忽略的点同一台电脑上不要混装多个品牌的机器人上位机软件。它们往往会往系统目录里放同名的通信库或驱动装第二个的时候把第一个的覆盖掉之后两个都连不上排查起来非常费时间。条件允许就给每个品牌配一台专用调试机。检查项典型要求不满足时的表现控制器系统版本与 PC 端软件版本对应页面缺项、写参数失败操作系统位数与版本64 位主流桌面系统安装中断、启动闪退运行库对应版本的运行环境双击无反应、闪退安装权限管理员部分模块注册失败同机其他上位机软件不建议共存通信库冲突、都连不上2.2 网段配不对后面全是白费功夫控制器和 PC 之间走的是以太网绝大多数现场问题的根因都在这一层。控制器出厂或项目配置里通常有一个固定的示教/上位机网口地址PC 必须配到同一网段。所谓同网段指 IP 前三段一致、最后一段不同子网掩码一致。实操上有两个细节。第一如果 PC 同时开着无线网卡和有线网卡两个都通外网的时候路由会打架软件发出的连接请求可能从无线网卡出去自然连不上控制器。我习惯在调试时把无线网卡禁用只留示教网口。第二直连控制器用普通网线就行现在的网卡都支持自适应不需要特意找交叉线。# 1. 先看清本机有几块网卡、各自什么地址确认要用来连控制器的是哪一块 ipconfig /all # 2. 给示教网口配静态地址。示例网段按现场实际改不要照抄 # name 后面是「网络连接」里显示的网卡名称含空格要加引号 netsh interface ip set address name以太网 2 static 192.168.1.100 255.255.255.0 # 3. 先 ping 通再谈软件能不能连 ping 192.168.1.10 -n 4 # 4. ping 不通时看 ARP 表能解析到控制器的 MAC说明链路是通的问题在 IP 层 arp -a上面第 2 步里的三个参数分别是「静态地址 / 子网掩码 / 网关」直连场景网关可以留空或者填控制器地址不影响通信。第 3 步的-n 4是发四个包比默认的四个更直观地看出丢包。第 4 步是分水岭ARP 里能看到控制器 MAC 但 ping 不通多半是 IP 冲突或控制器侧网口没启用连 MAC 都看不到就要查网线、交换机、网口指示灯别再折腾软件设置了。2.3 首次连接与控制权交接网通了之后连接对话框里一般要填三项控制器地址、通信端口、超时时间。端口号不要凭印象填查控制器侧的通信配置页或者问设备交付时给的参数表。超时时间默认值通常够用网络经过多级交换机时可以适当放大。真正容易出问题的是控制权。多数这类软件支持两种连接方式只读监视和完全控制。只读模式下能看到关节角、报警、IO 状态但参数页和点位页是灰的改不了。很多「软件有 bug参数改不动」的反馈其实是没拿到控制权。切换控制权之前有两个前提机器人处于停止状态、处于安全位置不要在伸到设备内部的时候抢控制权。手持示教器和 PC 端同时持有控制权的情况有些版本会互锁、有些会直接抢占抢占那一下如果有人在设备内部作业就是事故。连接成功后不要急着编程先看三样东西确认状态一致报警列表是否为空、当前关节角读数是否与手持示教器一致、当前模式是手动还是自动。这三样对上说明数据链路是可信的。2.4 连上之后第一件事做全量备份这一步的价值在出事的时候才体现但必须在没事的时候做。全量备份一般包含程序文件、点位数据、系统参数、IO 配置、坐标系数据几部分软件里通常有「备份/还原」入口选择备份到本地目录即可。我做备份有个固定习惯备份包解压后单独看一遍目录结构确认程序、参数、IO 三个子目录都非空。空目录说明备份没取全可能是权限只到只读、或者某类数据需要单独勾选。另外把控制器当前的系统版本号写进备份目录名还原的时候一眼能对上省掉后面「还原了但参数不对」的反复。提示备份目录不要放在系统盘也不要和安装目录放一起。软件重装或卸载时清理安装目录是常规行为备份放在里面等于没有。3. 坐标系标定四点法 TCP 与三点法用户坐标的验收标准3.1 为什么这类标定放在电脑上做更稳工具坐标系和用户坐标系的标定本质是解一个位姿方程机器人记录若干个姿态下的法兰位姿配合一个共同的参考点反解出工具中心点相对法兰的偏移。手持示教器也能做但电脑版的优势在三个地方。一是数值可读。标定完成后工具坐标的 X/Y/Z 偏移、姿态角是直接显示成数字的可以复制、可以存档、可以和上一次的标定结果对比。偏移量从 12.3mm 变成 12.8mm说明这次标定有问题手持示教器上你未必会注意到小数点后那位。二是可回退。标定前把旧的坐标系数据导出标坏了直接覆盖回去不用重新示教。这是很实际的后悔药。三是误差可量化。标定完把工具尖对准固定参考点绕工具坐标轴旋转看尖端偏移量这个验收动作在电脑上做起来顺手得多。3.2 工具坐标系四点法点位怎么选才不返工四点法的原理是用四个不同姿态让工具尖对准空间里同一个固定参考点控制器根据四组法兰位姿解出工具中心点。四个点的姿态差异越大方程越稳姿态越接近解出来的结果对测量误差越敏感。具体做法找一个尖锐的固定参考点锥尖、划针尖、固定在台钳上的针把工具尖对准它。第一个点用接近垂直的姿态第二、三、四个点分别绕不同轴倾斜 30° 到 45°尽量让四个点的姿态在空间里散开。每个点记录前确认工具尖和参考点确实接触不要靠目测留缝。点位姿态要求常见错误P1接近垂直作为基准姿态工具尖与参考点有 12mm 间隙P2绕 X 或 Y 倾斜 30°45°只倾斜了 10°解算不稳P3换一个轴倾斜 30°45°与 P2 倾斜方向相同姿态退化P4再换方向与前三点的姿态都不同四点姿态几乎一样重复性差标定完必须做验收不能标完就用。验收动作是把工具尖移到参考点上方贴合然后手动旋转工具坐标的 Z 轴绕工具轴自转±90°观察尖端相对参考点的偏移。偏移控制在 1mm 以内算合格超过 2mm 就要重标。这一步跳过的后果是程序里所有点位都带着一个固定偏差等到装配对不上、涂胶偏了才发现那时候已经示教了几十个点。3.3 用户坐标系三点法与交叉验证用户坐标系也叫工件坐标系解决的是「以工件为基准编程」的问题。三点法的三个点是原点、X 轴方向上的一点、XY 平面上的一点用于确定 Y 轴方向。三点确定一个平面和两个轴向Z 轴由右手定则推出。选点有三个原则。第一三点不能共线共线时平面无法确定软件会报错或者给出一个荒谬的姿态。第二原点到 X 方向点的距离要够长一般不小于 200mm距离太短角度误差会被放大。第三XY 平面点不要贴在 X 轴附近与 X 轴的夹角接近 90° 时解算最稳。验收方式比工具坐标系更直观在用户坐标系下让机器人沿 X 方向走 100mm拿卷尺量实际位移。量出来 98mm 说明标定尺度有问题量出来方向偏了说明轴向点选错。再沿 Y 方向走 100mm 复核一次两个方向都对这个坐标系才敢用来编程。有条件的话把工件的一个已知尺寸比如定位销间距在用户坐标下读出来对一遍这是最硬的验证。3.4 负载与重心参数跳过这步前面全白标这是最容易被跳过、又最容易在后面找麻烦的一步。工具重量、重心偏移、转动惯量这几个参数不填或者填错影响的是加减速过程中的动力学补偿和过载保护。轻负载、低速场景可能看不出问题一旦速度提上去表现就是跟随误差报警、伺服过载、轨迹在拐角处明显外甩。做法不复杂称一下工具总重含夹具、气管、线缆量出重心相对法兰中心的三向偏移填进工具参数页。重心不好量的可以用软件里的重心估算功能让机器人做几个姿态根据各轴扭矩反算。填完之后做一次中速空跑观察有没有过载报警、有没有明显的轨迹偏差。需要提醒的是工具坐标系的偏移和负载参数是两回事前者决定「工具尖在哪」后者决定「这东西有多重、重心在哪」。只标前者不填后者机器人在低速下看起来一切正常一提速就翻车。4. 示教与编程MOVJ/MOVL 的选型、速度单位与平滑过渡4.1 点位采集的三种输入方式电脑版示教器上采点一般有三条路子各有适用场景。第一种是手动到位后记录。用界面上的关节键或直角坐标键把机器人移动到目标位置点「记录」当前位姿写入点位表。这种方式最直观适合工件位置不固定、需要看着实物对位的场合。缺点是慢而且对位精度受操作者手感影响。第二种是直接输入坐标值。电脑版的大屏和键盘在这里价值最大已知工件坐标从图纸、从视觉系统、从上一道工序的 PLC 里读直接把 X/Y/Z/RX/RY/RZ 填进去机器人自己走过去。批量建点时效率高出一个量级尤其是需要按固定间距阵列排列的点——沿 X 方向每 50mm 一个把坐标算出来填表就行不用一个一个去对位。第三种是相对点位。以一个已有点为基准给一个偏移量生成新点比如「在 P_PICK 上方 80mm 处」。这种方式在取放料、上下料里用得最多好处是改基准点的时候衍生点全部跟着走不用逐个修改。4.2 MOVJ 与 MOVL省不得的那条指令这两个指令的区别是「走关节插补」还是「走直线插补」。MOVJ 每个关节按自己的插补曲线运动末端走出来的路径是曲线不可预测但速度快、不容易超程。MOVL 让末端沿空间直线运动路径可控但会经过中间所有位姿容易碰上奇异点和关节限位。选型原则很干脆过程中机器人不接触工件、不携带工艺负载的移动用 MOVJ机器人末端要走一条确定的线、或者过程中有工艺动作涂胶、焊接、插拔、压装、沿边扫描用 MOVL。取放料里「移过去」用 MOVJ「下探到料里」用 MOVL是常见的组合。速度单位是最容易踩的坑。MOVJ 的速度一般按百分比给指的是相对各关节最大速度的比例MOVL 的速度一般按 mm/s 给指的是末端线速度。两个指令混在一个程序里如果按同一套数值习惯去填MOVJ 填 100 和 MOVL 填 100实际速度差一个量级。加速度同理有的是百分比有的是 mm/s²看参数页上的单位标识别凭印象。对比项MOVJ关节插补MOVL直线插补末端路径曲线不保证直线可控速度单位多为百分比多为 mm/s适用场景空行程、回安全位下探、涂胶、插拔、压装主要风险路径可能蹭到周边设备奇异点、关节限位、超程平滑过渡一般可设较大值接触工艺时建议设 04.3 平滑过渡转弯区设多少平滑过渡有的界面叫转弯区、圆滑半径、SM决定机器人经过一个点位时是「精确到位停一下」还是「提前开始拐弯」。设 0 表示精确到位位姿误差为零但有加减速停顿设一个大于零的值机器人会在距离目标点还有一段距离时就开始过渡到下一段节拍更快但实际轨迹会在拐角处被「切」掉一块。设值的经验凡是末端与工件、夹具、工装存在接触或接近接触的点位一律设 0宁可慢也不要撞。空行程的中间过渡点可以放大一般按周边障碍物的余量来定余量 100mm 就设 3050不要设到贴着障碍物的程度。连续轨迹加工比如沿轮廓走一圈时中间点的平滑值要一致不然轨迹在点与点之间会有速度跳变表现出来是表面有接刀痕。一个实用的判断方法设完平滑值后用软件里的轨迹预览看一遍实际路径重点看拐角处离障碍物还有多少距离。肉眼看程序是看不出来的预览图一看就明白。4.4 程序结构与 IO 交互程序不是点位堆在一起就完事IO 时序、等待、条件判断决定了这套程序在现场稳不稳。下面是一段取放料循环的骨架指令名和参数写法各品牌不同结构是通用的。// 程序名: PICK_01 用途: 料盘取料 - 定位台放料 // 前置条件: 工具坐标 T1 已标定并验收, 用户坐标 U1 为料盘坐标系 // 参数约定: MOVJ 速度按百分比, MOVL 速度按 mm/s, SM 为平滑过渡值 MOVJ P_HOME V30% A30% SM0 // 回安全位, SM0 精确到位 MOVJ P_ABOVE_1 V60% A40% SM20 // 料盘上方过渡, 允许切角 MOVL P_PICK_1 V150 A200 SM0 // 直线下探到取料位, 到位停稳 IO[1] ON // 夹爪闭合 WAIT IO[2] ON // 等夹爪到位信号, 不要用固定延时硬等 MOVL P_PICK_1_UP V100 A150 SM10 // 直线抬起, 小平滑值避免抖动 MOVJ P_ABOVE_2 V60% A40% SM20 // 转到放料位上方 MOVL P_PLACE_1 V120 A180 SM0 // 直线下放到定位台 IO[1] OFF // 夹爪松开 WAIT IO[3] ON // 等松开到位 MOVL P_PLACE_1_UP V100 A150 SM10 MOVJ P_HOME V30% A30% SM0 END这段程序里有几个值得说明的设计。WAIT IO[2] ON替代固定延时是因为夹爪的动作时间受气压、磨损影响写死 0.3 秒在气源压力足的早上够用下午就可能不够表现出来是「偶尔掉件」。用信号等待慢一点但稳。下探和抬起的段全部用 MOVL 且 SM0 或小值因为这几段离工件和夹具最近任何切角都可能撞。中间的转移段用 MOVJ 且平滑值放大把节拍省在这里。程序开头写了前置条件这不是形式主义。工具坐标没验收就编程等于所有点位都建在一个错误的基准上后面返工是整段重来。参数约定也写清楚因为 MOVJ 和 MOVL 的速度单位不同隔一周再看这段程序不写单位必然要重新查手册。5. 避坑排查五条现场翻车记录与对应处理5.1 连接对话框一直转圈最后超时现象软件点「连接」后进度条走完报超时但ping控制器地址是通的。原因这一类多半不是网络层的问题而是端口或进程占用。控制器侧的通信服务端口被别的上位机占用比如另一台电脑还连着、或者手持示教器占着通道或者本机防火墙把出站连接拦了。解决先在控制器侧看当前连接的客户端列表把不用的连接踢掉再在本机防火墙里给出站规则放行软件主程序不是放行端口号是放行可执行文件。做完这两步仍然不行把软件完全退出任务管理器里确认进程结束再重开有时候是上一次连接没正常释放。5.2 参数页全是灰的改不了现象软件能连上能看关节角、能看报警但坐标系参数页、IO 配置页整页置灰输入框点不进去。原因只读连接模式。这不是权限等级不够是连接时选的就是监视模式。解决断开后重连连接方式选「控制」而不是「监视」。如果选控制时报占用说明手持示教器还持有控制权先在示教器上释放或者把示教器切到非编辑状态。切换控制权前务必确认机器人在安全位置且已停止。5.3 工具坐标系反复标定每次结果差 35mm现象四点法标完验收绕工具轴旋转时尖端偏移 3mm 以上重标一次结果又不一样。原因有三个常见来源一是四个点的姿态太接近方程条件数差测量误差被放大二是参考点在标定过程中被碰动了尤其是用胶带、磁力座固定的锥尖三是机器人没有回过零位编码器多圈数据有偏差。解决先确认参考点刚性固定用台钳夹死而不是随手放。再把四个点的姿态夹角拉到 35° 以上且四个方向都不同。最后在标定前做一次回零或原点确认。三件事都做完再标重复性通常能进到 1mm 以内。5.4 MOVL 走到中途报奇异点或关节限位现象程序单步执行时前几个点都正常走到某一段直线突然报警提示接近奇异点或某轴超程。原因直线插补要求末端沿直线走这条直线可能穿过腕部奇异区手腕两轴接近共线或者要求某个关节转过超出其行程的角度。示教时手动走的是关节插补路径是曲线避开了这些问题一换成 MOVL 就暴露了。解决在直线段的起点和终点之间插一个中间点把一条长直线拆成两段绕开奇异区或者调整工具姿态让腕部在整段运动中都不接近共线。改完用轨迹预览看一眼确认路径上没有红色告警区。别用加大平滑值的方式硬绕那只是把报警推迟到下一个点。5.5 备份还原之后 IO 配置全乱了现象把之前备份的参数还原回去程序能跑但 IO 点位全错夹爪信号接到了别的端口上。原因备份包和当前控制器固件版本不一致IO 配置文件的结构变了还原工具按旧结构解析字段错位。或者只还原了参数文件、没还原 IO 配置文件两套配置对不上。解决还原前先核对备份目录名里的版本号与控制器当前版本不一致时不要整包还原改成逐项还原并逐项验证。还原顺序上先还原系统参数、再还原 IO 配置、最后还原程序与点位。还原完成后必须做一次 IO 点动测试逐个确认输入输出对应关系别直接上自动。6. 从仿真到实机低速验证与备份版本管理的一个组合习惯新程序从软件里写完到真机跑起来中间那段路最容易出事。我现在的固定流程是三步。第一步在软件里做轨迹预览。把程序完整跑一遍虚拟执行重点看三处所有 MOVL 段的路径是否穿过夹具或料盘、拐角处的平滑切角有没有侵入障碍物、每个点的可达性有没有告警。预览图能看出来的问题别留到实机上试。第二步实机低速空跑。把全局速度倍率压到 10%拆掉工件只跑空动作一只手放在急停上逐段确认。10% 没问题升到 30%再升到 50%每个速度档至少跑三个循环。这个过程中如果出现异响、抖动、轨迹明显偏移立刻退回上一档别抱侥幸心理往上加。第三步是备份版本管理。这套习惯救过我几次每次程序定型、参数调整完成、准备交给客户之前各做一次全量备份目录名统一成「日期_固件版本_工位号」例如20240516_V3xx_ST02。同一工位的历次备份放在同一个父目录下形成一条可追溯的链。备份多了之后人工比对不现实我写了个小脚本做粗筛把两次备份里的点位表导出成文本逐行对比把坐标或速度有变化的行标出来。不同版本导出的列顺序不一定一致所以脚本按表头列名取值不按位置取。import csv def load_points(path): 读取点位表按表头列名建立索引避免不同版本列顺序变化导致取错列 with open(path, newline, encodingutf-8-sig) as f: reader csv.DictReader(f) # 兼容不同版本的列名写法取不到就跳过该行 return {row.get(NAME) or row.get(名称): row for row in reader} def diff(old_path, new_path, tol0.5): old, new load_points(old_path), load_points(new_path) for name in sorted(set(old) set(new)): o, n old[name], new[name] changed [] for col in (X, Y, Z): if col in o and col in n: # tol 是允许的浮点误差单位与点位表一致一般按 mm 给 if abs(float(o[col]) - float(n[col])) tol: changed.append(f{col}: {o[col]} - {n[col]}) if changed: print(name, |, ; .join(changed)) # 用法: diff(旧备份/points.csv, 新备份/points.csv, tol0.5)这段脚本只做一件事把两次备份里同名点位、坐标差异超过容差的行打出来。tol设 0.5 的意思是半毫米以内的改动当作噪声忽略避免每次导出都刷一屏。它不判断改动是对是错判断还是得靠人——但至少不用在几百个点里靠眼睛找。从那以后我每次交程序之前都会强制走一遍「低速空跑三档 一次全量备份 一次点位比对」哪怕这次只改了一个速度参数。有一次就是靠比对发现上一版有人把某个过渡点的平滑值从 20 改成了 80实机上表现为拐角处蹭了一下治具肉眼完全看不出来只有数据对得上。希望帮到你。本文还有配套的精品资源点击获取