主题
iS7 反馈、坐标与采集参考
当前只读交互使用 React 工作台,离线回放使用 Rerun。能力与验收边界见当前状态。
连接步骤见只读观察指南。
从只读连接推进到有限遥操的步骤与验收条件见 现场联调要求。
当前范围为 AUBO iS7 六关节的状态采集、React 只读显示、归档与 Rerun 离线诊断。 不提供本体上电、模式切换、使能、复位、寄存器写入或运动控制接口。 Wuji 灵巧手与相机尚未接入。默认使用 designs/aubo_is7_bare.yaml 的六关节裸臂, 与现场空法兰一致;生成器通过 end_effector: none 省略未安装的手,不修改厂家资产或缓存。 默认仿真平台仍保留 Wuji Beta 2 左手,显式选该安装配置观察时,手部只显示参考姿态。 桌体来自现有 CAD,基座安装仍待实测。新生成的裸臂任务 TCP 参考点与名义法兰重合, 并非外部测量标定结果;历史 run 保持其原本归档的模型和 TCP 定义。
进程与来源
根 CLI 将观察请求交给 server,准备并归档同一生成器输出的模型, 通过 core 的 uv 调度启动独立 backends/hardware 采集进程。 硬件包依赖 core 与厂商 SDK,不依赖 CLI、网页或物理引擎。 网页后端只读取追加写入的状态记录,不持有 SDK 客户端。
厂商 SDK 固定为 pyaubo-sdk==0.27.1rc4,锁文件记录 PyPI wheel 的哈希。 CPython 3.12 / Linux ARM64 wheel 的 SHA-256 为 5a3a27b1433ffbe663ab4768632791c64c2379ac89ceb245a19ac301479b9237。 只读验证时的控制柜软件为 0.31.0-rc.75+24280f0,接口版本为 0.24.0;SDK 自报接口为 0.26.0。 已实际验证本文使用的身份查询与 RTDE 输出字段,不把它扩大为全部 SDK 功能兼容。 观察进程还读取 isSimulationEnabled 并拒绝将控制柜仿真模式作为实机反馈验收。
接口依据:官方状态查询、 RTDE 协议、 RTDE 字段。
控制故障后的独立遥测
AUBO 会话 Launch 先启动独立只读采集,取得至少一秒连续反馈后再启动控制图。 Launch 等待控制进程和 recorder 退出后请求采集器记录五秒尾段;采集器也观察 Launch 所有者退出和自身终止信号。网页退出不再直接触发遥测结束。 这个尾段以主机时间计时;控制柜断流、采集器被强杀或主机断电仍可能导致证据缺失,报告必须保留失败状态。 遥测不具备运动接口,也不承担实时停止职责。
连接所有权为:ROS 持有控制 RPC 和自己的反馈 RTDE;独立采集器只持有一条诊断 RTDE, 启动时查询身份的 RPC 在就绪前断开。项目只读入口对同一主机、同一地址使用排他锁,拒绝第二个诊断采集器; 这不锁定其他机器或厂商客户端,仍需核对现场会话。两条 100 Hz RTDE 的有界负载检查和 inactive 控制进程故障证据见实机与诊断状态。
原始 telemetry/samples.rrd 保存实际位置/速度、控制柜目标位置/速度、模式、控制柜时间戳、 工控机单调接收时间和 UTC 接收时间。目标字段必须在固件 RTDE 菜单中存在,否则拒绝启动; 时间戳不可用时保持 null。采集器每约 100 ms 原子更新健康快照,原始记录保留请求的 100 Hz 数据。 启用、获取控制权和键盘输入检查遥测健康;Launch 会话协调器发现断流或超过 100 ms 的采样间隔后结束控制会话。 该协调器不是新的实时 watchdog,控制端已有的保护仍然生效。
结束后只读采集与控制运行分别记录状态;采集成功不能把失败的控制会话改成成功。 失败会话只能通过显式诊断导出查看,命令见ROS 遥操入口。
有效性与显示
SDK 的 J1–J6 按厂家机械链顺序显式对应归档模型的 shoulder、upperArm、foreArm、 wrist1、wrist2、wrist3 六个关节。原始角度和速度分别以 rad、rad/s 记录,界面显式换算为 °。 真实反馈只覆盖机械臂六关节,不为手部补造二十路测量或动作命令。
本体未上电时控制器返回 PowerOff、六路 Poweroff 与零关节角。 这些数据可以证明通信到达,不能证明真实编码器反馈;界面显示淡蓝参考模型, 不把零角度应用到“实测姿态”模型。只有机器人处于 Idle/Running/BackDrive 且六关节 均为 Idle/Running 时才显示实测模型;超过 500 ms 没有新数据立即撤下实测显示。 此标记只表示姿态反馈可用,不表示运动安全、安装标定或任务成功。
已验证的固件在的 PowerOff 和 Idle 状态下,时间戳字段均返回 JSON null,SDK 转成 NaN。 记录保持 controller_time_s=null;采样排序与回放使用主机 host_monotonic_ns, 同时保存接收 UTC 纳秒时间。若控制器时间可用则额外检查它严格递增。 未测定设备与主机时钟偏移,不从主机接收间隔推断单向网络延迟或执行节拍。
回放直接选取原始样本,不插值生成物理状态;使用本次归档 URDF、模型元数据和全部网格, 校验模型、映射和数据哈希,拒绝未完成、损坏或时间倒退的记录。 连接失败、畸形反馈、队列溢出或连续三秒无数据导致失败退出;主动中断保留诊断记录, 不标记为完成。SDK 凭据不归档。
产物与验收
每个观察 run 保存:
observation.json:地址、关节映射、时长/频率、源码和锁文件哈希、模型哈希。model/:同一次生成并归档的 URDF、网格和安装假设。samples.rrd:六关节原始状态、设备/主机时间与模式。summary.json:采样数、实际接收频率、最大接收间隔和有效姿态样本数。manifest.json:完成状态和输入/数据/结果哈希。worker.log:隔离进程与厂商 SDK 日志。
transport_valid 只代表完成了有序、有限值的状态采集;measured_pose_valid 要求 全部样本的机械臂姿态反馈可用。两者不替代物理有效性或任务成功。 现场完成本体上电并停在“启动”页后,可读取 Idle 状态的真实关节反馈。 只读验收无需调用启动、松刹车、使能或运动接口。
软件检查覆盖 fake SDK、断流、无效数据、完整性与只读协议;实机只读证据见当前状态。软件检查不替代现场编码器、方向与安装核对。
腕部、法兰与 TCP
configs/hardware/aubo_is7_frames.json 明确了这台 iS7 的名义坐标约定,并绑定厂家 URDF 哈希:
aubo_base_link:机械臂基座坐标。它相对 CAD 桌面的安装仍待实测。aubo_wrist3_Link:厂家 URDF 的最后一关节连杆原点,不等同于外部法兰中心。aubo_flange:从腕部原点沿其局部 +Z 平移 22 mm,方向与腕部坐标相同。left_tcp:安装配置指定的任务参考点。裸臂配置使它与名义法兰重合;带手配置仍为腕部 +Z 150 mm 的未标定参考点。
模型中的 wrist_from_tcp_pose 是 URDF 腕部原点到任务 TCP 的 m/wxyz 变换; 控制器的 getTcpOffset() 是 法兰到控制器 TCP 的 xyz/rpy 偏移。 因此裸臂模型中的 +22 mm 与控制器中的零 TCP 偏移可以表示同一个名义参考点, 不能把前者直接当作后者写入控制器。本项目只归档偏移,不调用设置 TCP 的接口。
坐标验证在 PowerOff、控制器返回名义运动学参数的条件下,通过 forwardKinematics1(q, zero_tcp_offset) 和 SDK 四元数转换,对 12 组虚拟关节角 进行了控制器只读计算,与独立厂家 URDF FK 比对。声明的固定变换在全部姿态下成立, 最大平移/转角差均小于 1e-12(m / rad);另用独立 modified-DH 实现做离线回归。 原始计算、参数及诊断在 artifacts/aubo-frame-verification/,虚拟关节角没有被发送为运动命令。 这只验证软件坐标约定和名义运动学,不是实物精度、关节零位或工具标定。
新观察 run 会保存名义 MDH、请求补偿后的参数、当时的机器人模式以及控制器 TCP 偏移。 若名义参数与归档模型定义不一致,采集在订阅前失败,避免误用其他机械臂模型。 本机 PowerOff 状态下,补偿参数查询与名义参数相同;不能把这种返回值写成“设备无需补偿”。
现场基座测量清单
填写 configs/calibration/aubo_is7_tabletop_measurement.yaml;该文件是待测工作表, 不作为运行配置,空值不能转换成默认安装值,也不改变 hardware_verified: false。
- 先核对现场桌体与选择的 CAD 是同一张桌子,记录桌面长、宽和离地高度。若不一致,先核对模型来源,不缩放 CAD 来迁就测量。
- 从上方看,按逆时针标记四角 A/B/C/D,AB 为长边;+X 为 A→B,+Y 为 A→D,+Z 向上,原点为桌面中心。
- 测底座安装中心距 AD 边沿 +X 的距离、距 AB 边沿 +Y 的距离,以及底座安装基准面高于桌面的高度。中心坐标分别为上述距离减去桌面长/宽的一半。
- 根据厂家基准识别机器人基座 +X,记录它相对桌面 +X 的偏航角,逆时针为正;不能用当前手臂姿态猜基座方向。确认安装面水平,否则补测 roll/pitch。
- 记录测量人员、时间、工具分辨率和不确定度。输入为 mm/°,实际写入安装配置时必须显式换成 m、wxyz 四元数。
这些数据到位后才能更新基座相对桌面的安装配置。工具四点 TCP 标定、末端负载/重心测量与运动验证仍需现场单独安排。
网络
专用有线连接与 DHCP 配置见网络部署。网络恢复只证明通信恢复,不能替代有效姿态、运动或整机冷启动验收。