主题
浏览器人工关节点动
目标是由现场操作员像使用示教器一样,通过工作台实际控制机械臂,验证可见运动、方向和松手停止。 当前入口支持 J1–J6,每次一个关节,持续按住正/负按钮运动。微脉冲模式及固定验收轴入口已删除。 前提:现场人员已确认安装与允许运动范围,部署人员已准备 ROS 环境和工作台。
启动会话
将示例地址替换为现场确认的控制柜地址:
sh
uv run pride hardware teleop --device aubo --address 192.168.78.100 --manual-jog --port 8098打开终端打印的网页地址。启动后处于 inactive,不会自动启用或获取控制权。初次配置软件和系统服务的步骤见ROS 环境安装。
操作
工控机浏览器打开 http://localhost:8098。其他机器访问同一工控机时使用 http://192.168.77.2:8098。 页面必须显示 ROS 2 · AUBO 实机 和新鲜的实机关节反馈。三维模型是反馈与名义 FK,不是现场视频。
- 现场使机器人处于 Running/Normal,退出示教器和其他客户端的运动操作。
- 点击“启用遥操”,等待控制器就绪、停稳且“获取控制权”可用,再获取控制权。默认不启用,不自动开始动作。
- 默认速度上限 2°/s,关节区顶部可选择 0.5/1.0/1.5/2.0°/s。每次按下从 0.5°/s 起步,保持 0.25 s 后用 1.25 s 渐变到所选上限;0.5 档保持慢速。持续按住任一 J1–J6 的正/负按钮,观察实体运动及按钮旁的实测角度;松手停止。运行状态保留相对启用起点 Δ。切换速度前松开方向;速度是输入指令,不是每次点击的固定步长。
- 等待按钮上方显示“已就绪”,再反向或换一个关节。先做一个可见的几度往返,再重复;不靠连续快速点击延长动作。
- 结束时释放控制权并停用遥操。停止按钮会锁定;须松开方向按钮,连续停稳后复位,再重新获取控制权。
获取控制权成功后,页面自动聚焦键盘区;显示“键盘焦点已就绪”时,长按 W/S、A/D、Q/E、Z/X、T/G、C/V 分别操作 J1–J6。点击页面其他位置会失去键盘区焦点,需再次点击键盘区;窗口失焦仍释放控制权。 各方向按钮直接显示对应按键:负向 S/D/E/X/G/V,正向 W/A/Q/Z/T/C,标签与输入共用同一映射。 切换速度后,若本窗口持有控制权,会重新聚焦键盘区;正在按住方向时速度选项禁用。 键盘与按钮共用同一速度渐变与停稳门控,已按一个方向时不接受第二个方向;按下被禁用的方向不会排队等待执行。 速度区显示当前指令速度与占上限的进度;这不是编码器实测速度。松开、Esc 或取消操作立即清零输入, 机械臂仍需按实际反馈等待停稳,不将指令归零显示成“机械臂已停止”。重复按键事件不重启渐变,下一次新按压重新慢速起步。 控制权在左栏设备连接之后,停止与复位在右栏方向按钮之后、键盘区之前;桌面首屏可见。 按钮是持续按住输入,不是点击后执行固定角度。输入约每 75 ms 发送一次,短于发送周期的点击可能完全不产生运动; 不要把“点击事件正常”或短击无位移当作持续点动已验收或失效。
遇到“按了没反应”,先看按钮上方的状态:没有控制权时先获取;“等待连续停稳”时松开输入并等待; “停止已锁定”时查看下方原因,等“已停稳 · 点击复位后重新获取控制权”后执行复位和获取。 “已收到某轴输入”只证明服务端接收,不等于实体已运动;继续比较该轴实测角度与现场观察。
代理联调应由网页操作和独立控制柜观测组成闭环:每轴记录按下/释放、servo_input、柜端 target_q 与 actual_q, 并核对释放后连续停稳,再继续下一轴。浏览器和工控机墙钟不可直接拼接;以工控机单调时间对齐执行与柜端 RTDE。 浏览器工具的短击不能代替长按;原生拖拽工具若超时且遗留捕获,先清零并关闭测试页,再从服务端确认撤权。 本次六轴实机验证及真实鼠标事件边界见实机与诊断状态。
每次操作需现场确认可运动范围;六轴关节点动入口可用不等于所有姿态的碰撞模型已标定。 当前只开放关节点动;末端直线、方框、自动回零或自动往返需要相应的坐标、路径及验收支持,不能由关节点动通过推断。
执行约束
唯一参数定义为 pride_core.teleoperation.commissioning_limits(),prepare 将同一 SI 数值注入监督器与原生硬件参数, 并连同生成的 ROS 配置、模型和源码哈希归档。网页显示执行配置,不维护另一份速度常数。
| 约束 | 当前值与行为 |
|---|---|
| 输入 | 一个关节,网页选择 0.5–2°/s 上限;按住从 0.5°/s 渐快,执行端最大 2°/s |
| 时长 | 每次持续非零输入最多 5 s;到时撤权锁定。原生目标运动有 6 s 后备期限 |
| 相对范围 | 各轴始终相对本次启用起点,监督器 10°触发停止;原生目标 10°、反馈 12°触发退出。不是保证绝不越过的机械硬限位 |
| 未操作轴 | 相对本段停稳参考,反馈偏移 0.05°、目标偏移 0.02°;反馈速度仍 ≤0.30°/s |
| 活动轴反馈 | >5°/s 触发保护;单个超限样本也保留,不滤掉尖峰 |
| 停稳门控 | 六轴速度 ≤0.10°/s、连续 ≥0.5 s、各轴位置跨度 ≤0.02° |
| 时效 | 反馈年龄与间隔 <100 ms、原生写入间隔 ≤50 ms;控制权 300 ms 无输入即撤销 |
正常松手后可以再次点动;换轴/反向需先释放并连续停稳。原生层独立从目标变化识别本段活动轴,拒绝同时改变多轴, 只有目标保持且反馈连续停稳才重新选择活动轴。重新选择活动轴不重置启用时的全局范围。 原生越界、通信或模式故障仍停止并退出 Servo,不自动恢复;它们不属于正常的按钮释放。
启用阶段确认柜内运行时为 Stopped 后,由当前会话启动 RuntimeMachine,再进入 Servo;已有 Running/Paused 等 运行时一律拒绝接管。停用时停止本会话持有的运行时,并记录返回值与最终状态。此流程不加载或运行厂家工程, 不提交回零/回旧姿态轨迹。参考锁定 SDK 的 example_servoj.py 初始化顺序;对应柜内旧起点问题和实测状态见部署记录。
如发生 30017「目标位置突变」,先对齐 SDK journal 与柜内日志,确认是在模式切换还是目标写入阶段触发。 主 ROS 硬件进入 unconfigured 后不能反复点击启用;独立遥测仍可说明保护状态。现场通过厂家界面处理保护停止, 重新启动工作台恢复 inactive 观察;不要以清除报警代替修复旧规划起点。
该速度及范围是针对有限人工点动的工程选择,并非社区公认安全值或厂家安全认证参数。 控制柜安全功能保持独立;未重新证明此前 J6 响应尖峰的机械原因,旧失败记录不改判通过。
采用的实践
Apple UIStepper提供随持续按压加快的交互参考。采用已有 Vercel Labs UI 的
bindHold处理按压生命周期,Motion 的内置 tween 与 easeInOut 处理数值渐变;只增加机器人协议连接。没有引入滚动惯性,交互库不是机器人安全控制器,执行端限制继续独立负责。AUBO 基础模式使用长按关节按钮进行点动;步进模式默认关节步幅 1°、位置步幅 5 mm。它说明日常操作以明确可观察的位移组织;具体按钮行为仍以现场软件版本为准。
MoveIt Servo提供关节速度、末端速度与位姿输入,以及限位、奇异点和碰撞处理。本工作台沿用已有 Servo 链路,先验收关节点动;不照搬 Panda 示例的速度到 iS7。
UR ROS 2 驱动的运动示例先检查控制器与初始姿态,再执行有限轨迹。采用“先核对实际起点、再做可重复动作”的方法,不复制另一型号的示例关节角。
软件检查、ROS mock 和浏览器交互通过不等于真实运动验收通过。实际操作应保留用户所见、输入、目标、实测角度、 松手后的继续位移与停止证据;不以命令返回成功或三维模型变化代替实体运动。实际检查、部署和未覆盖边界见 实机与诊断状态,原始证据在 artifacts/manual-jog-20261114/。