简介汇川机器人电脑版示教器软件面向工业机器人编程、调试与运维人员把传统示教器功能迁移到PC端便于远程控制、程序编写、离线仿真、示教点管理、状态监控与故障诊断适合自动化产线、装配搬运、焊接喷涂及汽车制造、3C电子、食品包装等场景的学习与工程应用。压缩包共711个文件约5.71MB以597张jpg和70张bmp界面及背景图片为主辅以21个ini配置、16个dll组件和exe主程序等构成较完整的电脑版示教器运行与界面资源。已有2608人学习下载说明其在汇川机器人用户中有一定参考价值。读者可借助其中的界面素材、配置文件和程序组件了解电脑版示教器的功能布局与运行结构为熟悉图形化编程、离线预览、通讯连接和故障排查提供直观参考也便于在Windows环境下开展软件安装与功能体验。1. 现场那台示教盒往往是效率瓶颈现场调试最怕的往往是有活干不出来程序能写方法也会可示教盒只有一台。控制器锁在电柜里示教器线缆拉到工位外就差半米够不着两个人一个调点位、一个改 IO 逻辑来回插拔重启一上午就没了。机器人电脑版示教器软件就是把示教盒那块屏搬到笔记本上同一套菜单结构、同一套指令集、同一套用户权限通过以太网连到控制器握手成功之后键鼠操作的每一步和按实体按键是等效的。它解决的是多人抢一台示教器、示教器线不够长、坐在办公室远程看报警这三类具体麻烦适合做集成调试、产线维护和实训教学的人。但有一句得先撂在前面它替代不了安全回路急停、使能开关、安全门这些硬件该有还得有。2. 电脑版示教器软件到底跑了哪一层把实时内核和 HMI 拆开看2.1 实时运动内核在控制器里PC 端只是个人机界面客户端很多人第一次接触这类软件会下意识以为它是个“模拟器”——装上去就能离线跑程序、看机器人动。这个理解偏了一半。控制器的软件架构里跑运动插补、伺服周期刷新、安全监控的是实时内核那部分永远在控制器上不在你的笔记本里。电脑版示教器软件承担的是 HMI 角色它把操作界面渲染出来把“用户点了 MovL、速度 300”这种意图打包成协议帧发给控制器控制器算完轨迹再把状态、报警、关节角回传上来刷新界面。想清楚这一层很多现象就顺了。笔记本关机机器人该停还是停因为运动指令早就下到控制器里了笔记本网线一拔界面立刻变灰、报警刷屏因为状态回传断了笔记本性能再差只要网络不丢包示教出来的点位精度也不受影响因为点位是控制器按编码器值记的不是你鼠标点出来的。所以选型时的判断标准不是“这软件界面像不像示教盒”而是三件事协议是否和控制器固件对得上、状态刷新是否够快一般要求 100ms 级别以内慢了手动点动的操作感受会明显变迟钝、以及它有没有把不该开放的功能开放出来。实体示教器上的使能开关是三段式的硬件开关PC 端只能用软件按钮模拟两者的安全等级完全不是一回事。我在配电柜上做首次上电测试时从来不会用 PC 端去试“按住使能能不能上电伺服”这一条必须回到实体示教器或者硬件按钮上做。2.2 三个参数必须事先对齐IP 网段、服务端口、固件与软件版本连接失败九成以上不是软件有问题而是这三个参数里有一个对不上。下面这张表是我每次进场前会填一遍的检查清单填完再动手能省掉大量反复试错。参数常见取值在哪里确认对不上的典型后果控制器 IP192.168.x.x 段控制器面板、参数页或随机资料ping 直接不通软件扫不到设备子网掩码/网段255.255.255.0同上能 ping 通网关却 ping 不通控制器示教器服务端口由控制器通讯说明给出控制器通讯参数页ping 通但软件连接超时控制器固件版本随机出厂记录控制器版本信息页界面能连上部分菜单缺失或灰显PC 端软件版本与固件配套发布安装包版本号指令参数项对不上程序下发报语法错重点说版本这一行。工业软件的版本配套关系比通用软件严格得多新版 PC 端软件为了支持新固件加的指令参数在老控制器上会被判成非法反过来老版本 PC 端软件连上新固件常见表现是某些参数页变成只读或者保存时静默丢字段。这不是玄学是协议字段长度变了。我一般的做法是先在控制器版本页把固件版本号完整抄下来包括小版本尾号再去要对应版本的安装包而不是手上有什么装什么。至于 IP 和端口还有一个容易被忽略的点控制器往往有两三个网口分别担任不同的角色比如一个接伺服或远程 IO一个接上位机。插错口的表现是链路灯亮着但怎么都通不了。进场前先确认“哪个口是给上位机/示教器用的”比在现场拔插网线试要快得多。2.3 首次连接的最小验证链ping、端口、登录三步分开验不要一上来就开软件点“连接”失败了只能看到一个笼统的提示框等于没有信息。我习惯用脚本把链路拆成三层分别验证网络层通不通、传输层端口开不开、应用层能不能登录。这样一旦失败立刻知道该往哪个方向查。import socket, ipaddress, sys CONTROLLER_IP 192.168.1.10 # 控制器 IP按现场实际改 SERVICE_PORT 6000 # 示教器服务端口以控制器通讯说明为准 TIMEOUT 2.0 # 单次连接超时交换机慢就调到 3~5 def check_ip(ip): try: ipaddress.ip_address(ip) return True except ValueError: print(f[FAIL] IP 格式不合法: {ip}) return False def check_port(ip, port): with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s: s.settimeout(TIMEOUT) code s.connect_ex((ip, port)) # 返回 0 表示 TCP 三次握手成功 if code 0: print(f[OK] {ip}:{port} 端口可达) return True print(f[FAIL] {ip}:{port} 连接失败错误码 {code}) return False if __name__ __main__: if not check_ip(CONTROLLER_IP): sys.exit(1) ok check_port(CONTROLLER_IP, SERVICE_PORT) print(下一步 (打开软件登录 if ok else 查网段、防火墙、控制器服务是否启动))这段脚本的逻辑很直白先做格式校验避免手抖把 192.168.1.1000 这种地址填进去再用 TCP 连接去探端口connect_ex不抛异常而是返回错误码方便在批处理里往下走。参数里最有价值的是TIMEOUT——现场交换机质量差或者跨了网段时1 秒超时会产生大量假阴性你会误以为端口没开其实是应答还没回来。结果怎么读ping 不通而端口检查也失败先查网段和网卡ping 通但端口检查失败八成是控制器侧服务没起来、本机防火墙拦了出站或者端口号记错了两步都通、软件仍连不上问题就上移到应用层了去看用户等级、并发登录数、软件版本。提示不少控制器的示教器服务只允许一个主控客户端在线。实体示教器还插着并且处于主控状态时PC 端会连接被拒界面提示往往很含糊。先确认实体示教器已经退出或者切到从属状态。3. 从零连上控制器网卡、环境、权限三件事一次配对3.1 安装前的环境准备路径、运行库、权限这类软件的安装包通常不大但踩坑概率不低原因集中在三个地方。第一是安装路径。默认路径里带中文或带空格一部分老版本程序在读写配置文件时会出问题表现为能打开界面但保存参数时报错、或者一重启配置就丢。我一般直接装到D:\PendantPC这种纯英文短路径下省事。第二是运行库。这类 HMI 软件多数基于 Windows 桌面框架开发需要对应版本的运行库支撑缺了的表现是双击没反应或者一启动就闪退事件查看器里能看到模块加载失败。安装包里一般会带一个运行库目录先装它再装主程序不要跳。第三是权限和杀毒软件。软件的通讯模块会做端口监听和原始套接字操作权限不够时连接能建立但收不到数据杀毒软件有时会直接拦掉这个行为表现是“昨天还好好的今天连不上”。我习惯把安装目录加进白名单并且始终用管理员身份运行——右键属性里勾上“以管理员身份运行”比每次手动右键稳。3.2 给笔记本单开一块调试网卡别动办公网最省心的做法是有线网卡专门接控制器无线网卡保持联网查资料两块网卡互不干扰。这样既不会因为改 IP 把自己的办公网络搞掉也不用为了连控制器去关防火墙。# 管理员身份运行 PowerShell先确认哪块网卡接的是控制器 Get-NetAdapter | Where-Object Status -eq Up # 假设调试网卡名为 Ethernet 2配成与控制器同网段的静态地址 # 不设默认网关避免抢走无线的路由 New-NetIPAddress -InterfaceAlias Ethernet 2 -IPAddress 192.168.1.100 -PrefixLength 24 # 只放行控制器所在网段访问本机端口比直接关防火墙安全 New-NetFirewallRule -DisplayName Pendant-TCP-In -Direction Inbound -Protocol TCP -LocalPort 6000 -RemoteAddress 192.168.1.0/24 -Action Allow几条参数值得说明。-PrefixLength 24对应 255.255.255.0必须和控制器一致两边掩码不同是最常见的“明明同网段却不通”。刻意不写-DefaultGateway是因为一旦给调试网卡配了网关Windows 可能把默认路由切过去你的无线网就断了现场查不了资料很麻烦。防火墙规则里限定-RemoteAddress为控制器网段比直接Set-NetFirewallProfile -Enabled False关掉整个防火墙要稳妥尤其是在客户现场安全策略经常不允许关防火墙。如果笔记本上已经有一块网卡占用了同一网段比如公司的 192.168.1.x 办公网务必换一个网段给调试用否则路由表里会出现两条同网段路由谁先谁后说不准。3.3 登录、用户等级与手动/自动模式连接建立之后第一件事不是急着点动而是确认当前登录的是哪个用户等级。这类软件一般分操作者、编程者、管理员三级操作者只能运行和看报警编程者能改点位和指令管理员才能动坐标系、轴参数和通讯配置。等级不够时很多菜单是灰的新手容易误判成“软件功能不全”。等级能干的事干不了的事现场建议操作者启动/暂停程序、查看报警与 IO改点位、改指令、标定坐标系交付给产线时用这一级编程者示教点位、编辑程序、单步调试改轴参数、改通讯配置调试期常用管理员全部含备份还原与参数配置——设独立口令交付后收回模式切换也要在动之前确认。手动模式下机器人受使能开关和速度限制约束程序只能单步或者低速运行自动模式下才允许连续执行。PC 端切模式的前提是控制器侧的物理模式开关位置允许如果实体示教器上的钥匙开关停在手动PC 端点了自动也不会生效——这个不是 bug是设计上的互锁。注意PC 端没有硬件使能开关多数实现里“按住使能”是个软件按钮。首次上电、首次点动这类高风险动作我坚持用实体示教器做一遍确认机器人和安全回路都正常再切到 PC 端做效率活。4. 示教编程落地坐标系、运动指令与程序下发4.1 两个坐标系必须先用起来工具坐标与用户坐标新手最容易跳过的一步就是标坐标系直接开始示教点位结果程序跑起来整体偏几十毫米然后开始怀疑软件精度。实际上点位本身是准的偏的是坐标系定义。工具坐标系描述的是“机器人法兰盘上挂的这个东西”——焊枪、吸盘、夹爪——它的 TCP 点在哪儿、姿态怎么定义。换一次夹具不更新工具坐标所有点位全部失效。用户坐标系描述的是“工件怎么摆在机器人面前”有了它程序可以相对工件编写工件挪了位置重新标一次用户坐标就行不用重示教。坐标系常用标定方法最少点数主要用途常见错误工具坐标三点法 / 六点法3 / 6定义末端 TCP 位置与姿态只标位置不标姿态绕 Z 转时跑偏用户坐标三点法3定义工件基准平面与原点三点共线平面退化成一条线三点法标工具坐标的操作逻辑是让 TCP 以三种不同姿态去触碰同一个固定参考点控制器用三个法兰位姿反解出 TCP 相对法兰的偏移。三个姿态差别越大解算越稳三个姿态几乎一样解算出来的结果会有很大随机误差——这就是典型的“标了还不如不标”。六点法在此基础上多三点定姿态绕工具轴旋转的场合必须用六点法。用户坐标三点法里原点、X 方向点、XY 平面上一点这三个点不能共线共线时平面法向量解不出来软件通常会直接报错但也有的实现会静默给一个错误结果程序跑起来就是斜的。4.2 点位示教与运动指令MovJ、MovL、MovC 怎么选点位示教本身没什么技巧手动把机器人挪到目标位姿选一个点位名记录。真正需要判断的是用哪种运动指令。三种基本类型的差别不在“走什么形状”而在“控制器有多大的自由度去规划路径”。指令路径形状速度参数含义典型场景注意点MovJ关节空间插值路径不固定以最慢轴的速度百分比或绝对速度约束大范围空走、回原点路径会绕路上有障碍必须试跑MovL末端走直线末端线速度涂胶、焊接、插装接近奇异点时关节速度会飙升MovC经过中间点走圆弧末端线速度倒角、圆弧焊缝三点不能共线否则圆弧退化成直线除了运动类型还有三个参数值得逐个确认。速度参数在关节指令里通常按百分比给在手直线指令里按 mm/s 给混用会导致速度严重偏离预期。平滑转弯区参数决定机器人经过中间点时是精确停顿还是带圆角过渡设成 0 逐点停顿节拍很慢设太大又会切掉工件拐角。工具号与用户坐标号必须和上一步标定的编号对应这一项填错是“程序没错但位置全错”的头号原因。提示手动低速试跑新程序时把全局速度倍率调到 5%~10%逐段单步。这一条不是建议是必须。我见过太多在 100% 倍率下第一次跑新程序的现场。4.3 IO 与逻辑指令程序能跑起来靠的是这一层纯运动程序只能做“来回搬运”真正干活要接 IO。基本的几类数字输出置位/复位控制夹爪、气缸、焊机启停、数字输入等待等工件到位、等夹具夹紧、延时给气缸动作留时间、条件跳转根据传感器状态走不同分支。这里的坑主要集中在时序上。典型场景是置位夹爪闭合 → 立刻执行 MovL 抬起 → 工件掉了。原因是夹爪动作有物理延迟控制器发出信号不等于夹爪已经夹紧。正确做法是在置位之后加一个“等待夹爪到位传感器”的输入等待而不是拍脑袋加 0.5 秒延时——延时在节拍上浪费在异常情况下又不够。另一类坑是等待指令没有超时。等一个永远不来的信号程序就卡死在那里操作工只看到机器人不动没有任何报警。所有输入等待都建议带超时和超时分支超时后置位一个报警输出或者跳到错误处理段。4.4 程序下发、备份与回滚PC 端相对实体示教器最大的效率优势就在这一块实体示教器上改一百行程序靠戳屏幕PC 上可以外部编辑再上传。常见的做法是维护一份点位表用脚本生成程序文本再通过软件的上传功能下发。import csv # 点位表列name,x,y,z,rx,ry,rz,move,speed,zone SRC points.csv TPL_JOINT MovJ {name}, v{speed}, zone{zone}; TPL_LINE MovL {name}, v{speed}, zone{zone}; def load(path): with open(path, newline, encodingutf-8) as f: return list(csv.DictReader(f)) def render(rows): lines [] for r in rows: name r[name].strip() if not name: continue # 空行跳过避免生成无效指令 tpl TPL_JOINT if r[move].upper() J else TPL_LINE lines.append(tpl.format(namename, speedint(r[speed]), zoneint(r[zone]))) return lines if __name__ __main__: body render(load(SRC)) with open(program.txt, w, encodingutf-8) as out: out.write(\n.join(body)) print(f生成 {len(body)} 条指令 - program.txt)逻辑说明点位表用 CSV 维护一行一个点位move列填 J 走关节、填 L 走直线脚本只做模板替换不碰坐标数值坐标仍然由示教或者离线软件算好填进表里。speed和zone强制转成整数是因为部分控制器对浮点格式的指令参数解析严格写v300.0会报语法错。空行跳过的判断看着多余实际能挡住表格末尾的空白行生成一条MovJ , v0。参数上唯一需要按控制器改的是zone的量纲有的控制器用 mm有的用百分比还有的用 0~5 的档位编号。第一次用之前拿一条指令下发试试报错就换量纲。备份这一环同样别偷懒程序文件、参数文件、坐标系数据通常是分开存的只备份程序等于没备份我习惯按“日期_产线号_版本号”建目录把三类文件一次全拷出来回滚时整目录还原比逐个文件找回稳。5. 避坑与排查连不上、动不了、跑偏的 5 个现场事故5.1 现象ping 通软件一直卡在“正在连接”原因通常是三层里的后两层出了问题控制器侧示教器服务没启动或者本机防火墙拦了入站再或者端口号照着旧资料填错了。也有一种情况是实体示教器仍占着主控权控制器拒绝第二个客户端接入提示语往往只写“连接失败”看不出真正原因。解决办法按顺序走先用第 2 章那段脚本确认端口可达端口通就去看控制器侧有没有“远程示教/上位机连接”的开关项把它打开再看实体示教器是否处于主控状态退出或切从属最后才怀疑版本不匹配。别一上来就重装软件重装解决不了权限和并发数的问题。5.2 现象界面连上了按使能、点启动都没反应这是最容易被误判成“软件坏了”的一类。原因在于安全链路根本没闭合急停按钮还压在下面、安全门开关没复位、外部安全继电器没吸合或者控制器物理钥匙开关停在手动而你在自动模式里点启动。PC 端的软件使能按钮再像硬件它也不在安全回路里。解决思路是从硬件往回捋先看控制器面板上的安全状态指示灯再逐个复位急停和安全门确认安全继电器吸合最后才看软件上的模式与使能状态。有一件事要形成条件反射——PC 端显示“已使能”不代表伺服真的上电了状态栏里的伺服 ON 才是准的。5.3 现象程序一条没报错跑起来整体偏几十毫米几乎都是坐标系。换过夹爪没重标工具坐标、工件重新摆放没重标用户坐标、程序里工具号和用户坐标号填的还是上一版的编号。还有一种更隐蔽的标定工具坐标时三个姿态差别太小解算结果本身就不准偏差不大但一直在反复重示教点位也修不掉。解决顺序是先验证再重标。拿一把直尺让 TCP 以低速去对同一个固定尖点手动换三个姿态偏差在 1~2mm 内说明工具坐标没问题偏差大就重标并且三个姿态尽量拉开角度差。工具坐标确认没问题再看用户坐标最后才怀疑减速机或者机械精度。顺序反了会在机械上白花两天。5.4 现象还原备份之后参数页一堆值是空的原因是备份不完整或者版本不一致。很多控制器把程序、参数、坐标系、IO 配置分在不同文件甚至不同分区里备份时只勾了“程序”一项还原后坐标系全丢。另一种情况是把新版本的备份还原到老固件上字段对不上软件不报错直接给空值。解决办法是把备份内容做成固定清单每次整份拷走并且记录固件版本和软件版本。还原前先比对版本不一致就别直接覆盖先在测试机上验证。还原后不要只看“还原成功”提示人工抽查三类关键数据工具坐标数值、用户坐标数值、IO 映射表。5.5 现象仿真里节拍 38 秒实机跑出来 46 秒差 20% 以上就别用“仿真不准”解释了。常见原因有三个仿真里的加减速参数比实机激进平滑区设得比实机小或者程序里有等待 IO 的指令在仿真里被直接跳过了。第三个最容易被忽略——仿真器不会真的等气缸动作实机会。排查方法是把程序按工段拆开逐段对比仿真时间和实机秒表时间找出差值集中的那一段再去看那一段里有没有等待指令、有没有接近奇异点的低速段。找到之后要么改参数要么在仿真里手工把等待时间补进去具体做法下一章展开。6. 离线节拍校核把仿真和实机的误差压到 10% 以内节拍这件事仿真给的是理想值实机跑的是真实值两者之间隔着加减速模型、平滑过渡和 IO 等待。真正有用的做法不是相信任何一边而是自己搭一个粗算模型跟仿真、跟实机各对一次把系统性偏差找出来。我的做法是把程序里的直线段抽出来按梯形速度曲线算时间。核心逻辑是一段行程在给定速度和加速度下先加速到设定速度、匀速走一段、再减速停下如果行程太短加速段还没到设定速度就得开始减速走的是三角形曲线。平滑区会吃掉一部分有效行程直接减掉。import math # 每个运动段(类型, 距离mm, 设定速度mm/s, 加速度mm/s^2, 平滑区mm) SEGS [ (L, 320, 500, 1500, 20), (L, 180, 300, 1500, 10), (J, 0, 0, 0, 0), # 关节段模型不适用用实测值回填 ] def trapezoid_time(d, v, a): d abs(d) t_acc v / a # 加速到设定速度所需时间 d_acc 0.5 * a * t_acc ** 2 # 加速段走过的距离 if 2 * d_acc d: # 行程太短到不了设定速度 return 2 * math.sqrt(d / a) return 2 * t_acc (d - 2 * d_acc) / v def total(segs): t 0.0 for kind, d, v, a, zone in segs: if kind J or v 0: continue # 关节段单独实测 t trapezoid_time(d - zone, v, a) return t if __name__ __main__: print(f模型节拍 {total(SEGS):.2f} s)参数怎么定a用控制器里实际配置的加减速不要用软件默认值zone从程序指令里读量纲要和距离统一关节段MovJ不套这个模型因为关节插值的路径长度和末端距离不是一回事只能实测回填。拿这个模型跑一遍通常会和仿真有 5% 以内的差和实机差 10%~15%。差值稳定就是好消息——说明是系统性偏差可以乘一个系数校正差值不稳定说明程序里有等待或者路径规划有异常回去逐段查。我给几个常做的产线记过系数搬运类 1.08 到 1.12带视觉定位的取放 1.15 左右涂胶类因为速度恒定反而接近 1.03。这个系数不是通用值是每类工况跑三五次之后自己回归出来的。验证方法很简单实机跑三遍取平均和模型值比如果三遍之间离散度就超过 5%先别管模型那是程序本身不稳可能是有等待指令的超时分支被触发也可能是某个点位接近奇异点导致速度被压。这种情况我把程序拆成单段循环跑用秒表逐段卡通常十分钟内能定位到具体哪一段。从那以后我每次拿到一份新的离线程序都强制走一遍“模型粗算 → 仿真对比 → 实机三点取样”这个流程哪怕客户催得再紧也不跳步。跳过这一步省下的半小时往往要在现场用半天补回来。希望帮到你。本文还有配套的精品资源点击获取
