跳到正文

ROS 2 与 LeRobot 集成约定 ​

选型与当前状态 ​

操作架构采用 React 工作台 + Rerun + 无界面 ROS 2 后端:React 显示实时状态并提供遥操,Rerun 消费归档记录做离线诊断,ROS 负责消息、TF、Servo 与控制器。RViz 已退出工具链:不安装、构建或启动,也不提供备用操作入口。Servo 构建仅安装组件运行所需的白名单文件,排除上游演示和可视化配置;厂家原始资产和历史记录保留来源内容,不参与 ROS 构建。

实机控制主线采用 ROS 2,基线为当前 Ubuntu 24.04 ARM64 对应的 Jazzy;复用 TF2、标准消息、MoveIt 2、MoveIt Servo 和 ros2_control。本项目使用 LeRobot 的 Robot 与示教数据接口,未提供训练与真机推理闭环;桥接由本仓库实现和维护,不引入 leros2、lerobot-ros 等社区桥接包。

TF2、MoveIt 和控制器复用上游实现。iS7 使用本仓库的薄 ros2_control 适配 pride_aubo_hardware/IS7System,底层复用官方 AUBO SDK;不重写控制柜通信协议。官方 ROS 驱动作为接口审查依据,其中启动写示例寄存器、队列满无限重试和自动恢复 Servo 模式的行为不进入本项目适配。

已实现单臂遥操工作台、独立 ROS watchdog、控制权、RRD/事件记录,以及自研 LeRobot Robot 和示教导出。软件链路与真实现场接入分别取证:mock、SDK 插件加载与无设备故障检查通过,不自动开放实机运动。独立只读观察入口见硬件观察。

当前研究和首轮接入仅覆盖现场已连接的 iS7 六关节裸臂,使用 designs/aubo_is7_bare.yaml;不包括 Wuji 手、双臂遥操作或协同任务。现有双臂与带手仿真资产继续保留,不能当作这些硬件已接入的依据。

当前人工控制入口为 --manual-jog,具体操作与参数见浏览器关节点动。用户要求的六轴单关节点动已替换微脉冲和固定验收轴分支;prepare 将同一份 SI 限额注入监督器、原生适配和快照,并归档生成配置。启用、控制权、停稳与原生故障退出仍分别检查;历史实验结果见下文报告,不作为当前参数来源。

现场操作遵循联调要求与人工点动。已取得的实机响应和仍未闭环的 J6 故障分别见当前状态。

有界验收流程通过内部只读 RPC commissioning_status 查询执行端完整反馈窗口的停稳结果、窗口长度和速度峰值,不用低频网页快照重建停稳状态。该查询不授予控制权;启用、获取控制权与复位仍在执行端重新检查原有门槛。

单臂物理遥操也可使用 Isaac 原生控制后端:轨迹控制器驻留在仿真器进程中,PhysX 反馈经同一 ROS 与网页接口返回。它是独立的仿真设备选项,实机连接与验收边界保持独立。

单臂遥操作研究结论 ​

首轮保留两种控制方式:通过 control_msgs/JointJog 做单关节点动,通过 geometry_msgs/TwistStamped 做末端平移与旋转。末端动作显式选择基座或工具坐标系;输入经使能保持、死区、速度映射与超时处理后交给 MoveIt Servo,按住操作,释放停止。

网页按钮及键盘输入通过服务进程内的纯函数转换。React 提交完整 W3C 按键快照,pride_workbench.sessions.teleop_input.keyboard_input 使用已有 NumPy/SciPy 生成六维相对动作;保持原有 XYZ 欧拉增量转旋转向量、float32 输出转换和归一化语义,不依赖 NVIDIA Capture 或独立输入 worker。鼠标按钮和 Space / Enter 触发同一组虚拟按键;键盘操作区支持官方 W/S、A/D、Q/E、Z/X、T/G、C/V。关节点动显式把单键六维意图映射到 J1–J6,只允许一个键;末端模式允许组合按键。当前不包含手柄、SpaceMouse 或 XR 设备接入。

转换保留 0.01 m/rad 的规范化增量,再除以该尺度得到输入意图;它不随 HTTP 包数积分。末端平移和旋转分别限制向量范数,最后仍由 ROS 执行层按原速度上限与比例转换成 JointJog / TwistStamped。旋转由 SciPy 按 XYZ 内禀 Euler 合成后转为轴角,与移除前 Capture 的组合按键语义一致,不能将它当作六个独立欧拉角速度。原始键、规范化增量、转换后输入与最终 Servo 输入分别进入事件记录。

键盘转换在网页服务进程内执行,不持有硬件接口、OpenXR 会话或物理步进。网页服务以原接收单调时间提交结果,包含排队与计算耗时;转换失败时尝试释放控制权,输入年龄与序号继续由 ROS 控制权入口校验。完整快照避免按键增量消息丢失后残留状态;松键、离开键盘区、窗口失焦、断流仍分别清零或撤权。MoveIt Servo、ros2_control、AUBO 适配与独立 watchdog 保持设备执行职责。

依据 MoveIt 手柄教程、Jazzy Servo 参数和 spacenav。这些资料提供接口和调参入口,不提供本机可直接使用的运动参数。

AUBO 官方 Jazzy 驱动提供位置命令接口。本项目用 MoveIt Servo 输出短 JointTrajectory,交给标准 JointTrajectoryController,再通过适配层调用官方 servoJoint。官方接口的 a/v 参数不能当作速度限制,适配层另行检查关节范围、相邻目标步长和跟踪误差;依据见 MotionControl。控制周期与真实停止行为仍需现场验证。

职责 ​

层职责
TanStack Start / React 工作台交互、三维显示、状态与操作请求,通过独立业务协议连接 Python
ROS 2 / TF2设备消息、坐标变换与时间信息
MoveIt 2 / MoveIt Servo分别提供规划运动与连续末端/关节遥操作;按任务需要选择
ros2_control / iS7 适配 / 厂家 SDK硬件接口、控制器生命周期、命令与反馈
自研 LeRobot 桥接ROS 消息与 LeRobot 观测/动作的转换,录制与推理的接入
LeRobot数据集、训练与策略计算

Python 与 LeRobot 保持可独立开发的包和环境;Torch 等学习依赖不进入 core、通用 runtime 或硬件只读采集环境。前端不加载厂家 SDK,不直接连接 ROS 控制器。

桥接接口边界 ​

优先使用已有上游接口,不为普通关节、位姿、相机或轨迹另造传输格式:

  • 关节观测:sensor_msgs/JointState,按显式关节名映射,不依赖消息中数组的偶然顺序。
  • 位姿与变换:geometry_msgs/PoseStamped、TF2,保留 frame_id 和有效时间。
  • 图像:sensor_msgs/Image 或明确的压缩格式,记录相机标定和采集时间。
  • 规划轨迹:control_msgs/action/FollowJointTrajectory;连续动作接入所选 Servo 或关节控制器支持的接口。每次策略输出不强制经过全局路径规划。

动作契约需明确位置/增量/速度、坐标系、时间范围和末端装置含义。桥接不得根据字段名称猜单位或控制模式。LeRobot 只产生动作请求,控制器资源占用与控制权由执行层统一管理;规划器、遥操作与策略不能并发写同一硬件接口。

仓库使用 m、rad 和 wxyz;ROS 的四元数字段为 x/y/z/w,转换必须在边界显式执行。TF2 中使用与归档厂家模型一致的腕部、法兰和任务 TCP,不能把 URDF 腕部原点当成法兰;名义坐标核对不替代基座、TCP 或实物标定。

记录与时间 ​

原始关节反馈、控制器目标、上层请求和实际发出的动作分别保存。动作因限幅或模式转换发生变化时,记录变换后真实应用的值,不以测得关节角代替动作标签。

相机、ROS、主机与设备时间分别标明来源;不得假设时钟已同步。rosbag2 的官方 RRD 存储插件保存原始消息,转换为 LeRobot 数据集时明确重采样和对齐规则,保留原始 bag、模型、标定与版本哈希。既有 Rerun 离线诊断入口继续消费归档数据。

会话切换、反馈过期、取消和故障终态遵循工作台协议与任务语义。节点恢复不得自动重放上一会话的运动命令;软件取消以执行层确认停稳为准。

独立遥测与故障时间线 ​

AUBO 遥操通过独立只读采集保存控制器退出后的反馈。 原生诊断队列新增 protection_trigger,保留保护原因和主机时间,先入队再尝试停止/关闭 Servo; 控制线程继续使用有界队列,文件写入由原有诊断线程执行。硬件强杀时日志可能缺少结束标记, 显式诊断读回允许缺少尾标或末尾半行,同时继续核对完整行、序号、已有文件哈希和模型。 常规回放与示教导出仍要求完整成功归档。

新会话记录 Linux boot ID。ROS 事件、SDK 调用和 RTDE 接收按同一启动周期的工控机单调时间排序; 跨机器/跨启动周期拒绝自动合并。历史 SDK 日志缺少此依据时只保留原记录和告警,不猜测偏移。 控制柜时间戳单独保留,接收时间包含未知传输延迟,不能相减得到柜内执行延迟。

Rerun 分开显示输入、ROS 轨迹首点、SDK 目标、控制柜目标和实际反馈,并提供调用耗时、写入间隔、 接收间隔、模式和停止事件。完整 ROS 轨迹仍在原始 RRD/事件中,首点的消息时间不是轨迹执行时刻。 停止分析报告停止请求后的首个可观测静止窗口,沿用 0.5 秒、0.05°/s、0.02°判据; 它是观测确认时刻,不是精确物理停止时刻。首个反馈的延迟、接收空洞和窗口前连续性单独报告, 断流后重新看到静止不能证明完整停止过程。诊断结果始终保留源会话状态且不宣称运动验收通过。

工控机直改与 Spark 回传采用 Git 分支和差异核对,操作见远程开发回传。 验证与限制见实机与诊断状态。

当前实现 ​

控制进程的事件记录通过 AsyncRecordWriter 交给容量为 256 条的单写入线程,回调只复制当前事件并非阻塞入队;RRD 编码及预览文件写入不持有控制锁。队列耗尽或后台写入失败会撤销控制权、锁定停止、发布零输入并让进程失败退出,由 Launch 继续执行会话清理;已接受的记录尽力排空,缺失证据的归档不能标记完整。进程收到停止信号时,按冻结的 RosSessionPolicy.interrupt_s 开始同一个关闭期限,服务停止和事件排空共用剩余时间,重复信号不延长预算。此机制不保证 Python/ROS 调度为硬实时,也不能替代设备侧停止反馈。故障验证使用真实 ROS 回调和注入的慢盘/写盘失败,不连接实机。

仿真、遥测、预算与归档归会话 Launch。有限物理任务采用 Action Goal 状态语义;worker 通信为 gRPC,没有原生 ROS Action server 或统一 systemd/cgroup 会话托管。

pride_control 是独立的 ament_python 包,采用系统 CPython 3.12 / Jazzy ABI。厂家归档 URDF 生成 ROS 描述和 SRDF,使用相同的关节名、碰撞网格、桌面和任务 TCP;ROS 文件只转换资源 URI 并添加 ros2_control 配置。厂家位置限位保留,运行参数额外限制关节速度 0.15 rad/s、加速度 0.3 rad/s²、末端平移 0.025 m/s 和旋转 0.1 rad/s。

mock 和 aubo 都以 inactive 硬件、inactive 关节控制器启动,状态广播保持 active。网页“启用遥操”先切换硬件生命周期,再激活关节控制器;之后仍须获取独立控制权。“停用遥操”先释放控制权、停用控制器,再切回 inactive。切换失败、停止锁定和断流不会自动重启运动;LeRobot 只接入已经启用的会话,不自行使能实机。

pride_aubo_hardware 使用当前 Jazzy 的硬件接口管理 API,直接复用官方 ARM64 C++ SDK 0.24.1-rc.3,来源及哈希在 backends/ros2/aubo-sdk.json。configure 阶段只登录、核对 API 24000 / iS7 / 六关节 / 名义 MDH / 非控制柜仿真,并订阅 RTDE 输出;不写寄存器、TCP、负载、速度倍率或硬件参数。activate 要求新鲜、静止的 Running / Normal 反馈,且其他客户端没有占用 Servo,然后请求计划 Servo 模式。初始目标来自实测关节,禁止使用模型参考角替代。

适配层拒绝超过 100 ms 的反馈、超过 50 ms 的写入间隔、非有限目标、超限角度、超过 0.15 rad/s 对应的相邻目标步长或 0.05 rad 跟踪差。每个 SDK RPC 配置 100 ms 超时;队列满和非零返回码立即故障退出,不循环重试,不自动重新启用 Servo。退出尝试 stopJoint 和关闭 Servo;不能确认时返回生命周期失败。这些是软件门控与故障处理阈值,不是实测停止延迟或硬件急停保证。

工作台与 LeRobot 经同一个本地业务网关提交输入,网关通过本地 gRPC(Unix socket)交给 ROS 节点,最终发布标准 JointJog / TwistStamped。LeRobot 不直接发布 DDS 运动话题,也不绕过执行层控制权。每会话采用唯一 ROS 命名空间,并使用独立 ROS domain 与本机发现;即便 domain 偶然相同,控制器、Servo 和 TF 话题也保持会话隔离。该隔离用于本仓库启动的模拟设备,不是物理网络的安全认证机制。

控制 socket 仍位于该次输出目录的 control.sock,权限为 0600。Linux 上绑定与连接统一通过目录文件描述符的 /proc/self/fd/<fd>/control.sock 短地址访问,避免自定义长路径及中文路径触发 Unix socket 地址长度限制;句柄在 gRPC server/channel 关闭后释放,正常关闭时删除 socket。该方式不改变进程工作目录,不截断输出路径,也不引入额外临时目录或端口。机制依据见 Unix socket 地址与权限和 proc 文件描述符入口。ros2 检查包含长中文路径的完整 mock 生命周期与并发会话隔离回归。

控制权有效期 300 ms,输入每 75 ms 更新;服务端接收时间至 ROS 消费超过 150 ms 的请求拒绝。输入序号严格递增,反馈本身的 ROS 时间和主机接收时间都需新鲜,控制器生命周期必须为 active。失焦、页面隐藏、刷新和断流都会释放或耗尽旧控制权;停止锁定后必须等反馈速度低于 0.005 rad/s 才能复位。Servo 还有 100 ms 输入超时,轨迹控制器有 200 ms 命令超时。上述数值是配置与 mock 验收输入,不是已测定的实机停止延迟或硬件急停能力。

TF 发布者 robot_state_publisher::RobotStatePublisher 与 moveit_servo::ServoNode 共享标准多线程组件容器 servo_container,减少一个常驻进程;两个 ROS 节点、模型参数、时钟与会话内 TF 话题保持不变。这沿用 MoveIt Jazzy 官方 Servo 示例的组合部署方式。控制权/watchdog 保留独立进程,mock/aubo 的控制器管理器也独立运行。共享容器意味着 TF 与 Servo 一同受容器崩溃或卡顿影响,容器外的状态新鲜度检查负责撤权,控制器保留命令超时;这不等于实机停止性能已经验证。

设备停用、启用失败回滚和最终关闭复用同一个停止序列:先停用关节控制器,再请求硬件 inactive;前一步失败仍尝试后一步,故障后已 unconfigured 的硬件不会被自动重新配置。结束会话还会暂停并按完整节点名卸载 Servo。关闭与设备切换互斥,状态转换继续通过 controller manager 的标准服务执行。

single_arm.launch.py 声明控制图,pride_control.session.RobotSession 作为 Launch Action 协调会话。仿真与只读 SDK 采集使用 ExecuteProcess:先通过显式 uv 项目准备并解析实际入口,再直接启动 worker,避免 uv 常驻父进程吞掉首个 SIGINT;Node/ExecuteProcess 的启动、退出观察及 SIGINT → SIGTERM → SIGKILL 升级均由 Launch 执行。网页不再持有仿真、遥测 Popen,也不运行会话预算线程。

ros/session-policy.json 冻结会话总预算及各关闭阶段期限。网页的关闭请求写入该实例的 ros/stop.request,可重复提交;Launch 自行响应预算耗尽和关键子进程退出,因此网页死亡后仍能结束会话并封存结果。正常路径先请求控制权执行端停用设备、卸载 Servo,随后逐个发出 Launch 的 ShutdownProcess 事件;控制进程全部退出后停止 recorder,再触发独立遥测尾段。此路径不一开始就发全局 Shutdown。外部信号或 Launch 错误触发全局关闭时,归档记录中断,不承诺完整尾段。

ros/launch-state.json 严格记录阶段、阶段单调时间、实际 PID/执行文件、退出码、提前退出与设备停用结果。running 仅表示程序图已安排启动,功能就绪仍以控制器和新鲜反馈为准。必需进程即使以零退出码提前结束也触发关闭;spawner 正常结束不触发故障,失败则关闭会话,不自动重启。执行层信号只请求退出,等当前回调完成后关闭事件记录。

Launch 在子进程全部收尾后写 manifest,保存卸载确认、逐角色退出码和失败原因,并包含启动状态记录的文件哈希。尚可能变化的 Launch 输出日志、网页 viewer 文件和健康快照不纳入封存哈希;离线进程诊断优先读取已封存的结构化 Launch 状态。完整归档要求设备停止及卸载确认、预期子进程集合全部正常退出、没有提前退出且 bag 完成收尾;launch 自身退出码为零不足以认定成功。ros2 检查查询实际组件列表和进程树,并将静止及点动后的 TF 与归档 URDF 的 FK 对照;另在持续刷新输入时暂停 mock 容器,检查 watchdog 撤权、关节停止,以及容器暂停时仍能显式停用设备。测试随后恢复容器用于正常卸载与归档,确认设备保持 inactive、旧控制权被拒绝且关节不再运动。录制进程提前正常退出和控制权进程被强杀另有故障检查,要求归档 failed、其余子进程被回收。职责与隔离依据见 模块与执行状态,本机证据见 模块与执行状态。

当前网页仍持有最外层 Launch 句柄,异常超时有信号兜底;尚未采用 systemd/cgroup,不能据此保证 Launch 自身被强杀后所有后代都会回收。验证及边界见模块与执行状态。

容器卡顿后应停用设备并结束会话,不支持直接 SIGCONT 热恢复运动:Servo 可能保留轨迹,撤销输入控制权本身不清除其内部目标。先停用下游控制器,再恢复容器用于关闭,是本检查覆盖的处置顺序。旧独立 TF 与新组合部署的对照、通过记录及未覆盖范围见 模块与执行状态。

原始反馈、TF、Servo 输入、状态和控制器目标经 Rerun 官方 rosbag2_storage_rrd 写入 RRD;锁定源码与 Rust 工具链见 backends/ros2/rrd-storage.json。使用 raw 保留可逐字节读回的 ROS 消息,同时使用 lenses 保存可视化表示;不以可视化表示代替原始消息。启动前验证实际插件哈希,归档保存插件与配方身份。events.rrd 分开记录请求、限幅后真正发布的 Servo 输入和最终控制器目标。会话结束后写 manifest 哈希。学习环境固定 LeRobot 0.7.0 与本机已使用的 Torch 2.10.0 CUDA 13.0,core、通用 runtime 和只读 hardware 包不加载学习依赖。

新 aubo 会话在原生 SDK 边界另生成 sdk-calls.rrd,记录 Servo 目标、周期参数、模式切换/查询和停止调用,以及主机单调时间、耗时、返回值/异常和相邻写入间隔。队列复用 MIT 许可的 rigtorp/MPMCQueue,由 CMake 锁定源码提交与归档哈希,容量固定为 4096。上游 try_emplace 先预约容量,再构造调用记录;记录构造中执行 RPC、捕获异常并保存结果,构造结束后才发布记录,调用者随后获得返回值或重新抛出异常。项目不自行维护队列索引、槽位池或就绪标志。构造时预分配队列,生产路径不动态分配队列存储或执行文件 I/O。独立线程按预约顺序等待结果并落盘;队列耗尽或写入失败后拒绝新的运动调用,但仍执行停止与退出 Servo。关闭前须停止生产者,再排空已预约记录。关闭后必须读到完整结束标记,文件哈希、序号、时间与返回值语义都通过校验才算完整归档。记录中可保留失败调用;完整归档不等于运动成功。原生测试覆盖并发生产、槽位复用、晚完成调用和容量耗尽;这些无设备测试不验证真实 SDK 周期;队列使用非阻塞尝试接口,不保证 SDK 网络调用或整个控制循环实时。选型及 ThreadSanitizer 证据见记录与数据状态。

共享记录加载器核对 manifest、模型、资源、样本时间和关节顺序;同一验证入口服务于 Rerun 和 LeRobot 导出。Rerun 中反馈、Servo 输入和接收的轨迹首点分别显示,完整轨迹保留为事件与 RRD,不把目标当作实测执行。离线三维姿态由归档模型和 mock 关节反馈 FK 得到,不新增网页回放器。

自研插件 lerobot_robot_pride_is7 使用 LeRobot 官方 RobotConfig / Robot 和插件发现接口。观测是按名称映射的六关节 rad,动作是输入 Servo 的六关节速度 rad/s;默认只读,需显式选择控制。关节模式示教按主机单调时钟因果保持重采样,反馈年龄最多 50 ms,控制权变化切分 episode。导出通过 LeRobot 官方 Dataset API 写入并本地读回,保留来源 manifest、模型哈希、单位、动作语义和对齐方法。混合末端模式的记录目前拒绝转换为这个关节速度契约。

当前未包含相机、手部、策略训练、真机推理或手柄。桥接检查不连接或移动实机;已取得的有限运动证据不覆盖完整停止/失联性能与基座配准。

单臂预设仿真验收 ​

预设只通过检查入口执行,当前不提供真机运行选项。七类动作展开为 14 个独立用例:保持 5 秒;J6 ±1° 往返;使能释放、操作员停止、输入超时三种停止;J5/J4/J3/J2/J1 各 ±0.5° 往返;基座坐标系 X/Y/Z 各 ±5 mm 往返;边长 10 mm 的 XY 方框。各段停顿后再继续,停止用例停在触发后的实际位置,不自动回起点。下一用例重新捕获自己的起点。

J6/J5/J4 的候选指令速度上限为 0.5°/s,J3/J2/J1 为 0.25°/s,末端平移为 2 mm/s。这些参数是本仓库的仿真验收候选值,不是厂家的通用安全参数。客户端独立检查起点、指定活动轴、相对位移、速度、反馈年龄和每项 60 秒预算;失效后停止并结束整套验收。它不替代未来实机执行器内的独立限制。

ROS 层经现有工作台命令协议获取控制权并提交 JointJog / TwistStamped,不直接改关节状态。完整 100 Hz 反馈归档另行复算关节位移、速度、样本间隙和三种停止结果。关节到点容差 0.02°、末端位置容差 0.15 mm、姿态容差 0.05°;关节实测速度允许 10% 数值裕量及 1e-5 rad/s;末端模式另设 0.03 rad/s 关节速度界限。归档还检查末端轨迹横向偏差 ≤0.3 mm、姿态偏差 ≤0.05°、末端实测速度 ≤2.22 mm/s。停止判据为 0.65 秒内停稳且继续运动不超过 0.3°,随后持续停稳至少 250 ms,它们仅是 mock 判据。使能释放用例持续发送 deadman=false 心跳,保持控制权有效,防止用超时停止掩盖使能释放路径的错误;测完后再显式释放控制权。停止后旧控制权必须拒绝,复位不能恢复控制权。

默认直腕参考姿态存在腕部奇异性,验收复制原安装配置并在自己的 run 中初始化非奇异姿态 [0, -0.3, 1.3, 0.1, 0.6, 0] rad。该值只是仿真 fixture,不是实机回零指令;厂家几何、关节限位和 CAD 桌面保持不变。

物理层在独立 Isaac Lab / PhysX CPU 环境中,把已归档 ROS mock 关节反馈按主机单调时间线性重采样为位置参考,以 2 ms 步长积分,10 ms 记录关节状态与 TCP。它不是 ROS–PhysX 闭环,也不能测量真机通信、伺服或停止延迟。基于原单臂物理参数显式启用名义重力补偿:前馈占用原力矩预算,剩余预算才交给 PhysX 位置驱动;不提高厂家力矩限额。基础物理任务默认继续不补偿重力。此控制假设、原参数来源、解析惯量、模型和执行代码哈希全部归档。

当前 Isaac Lab 显式应用归档 URDF 的关节摩擦并核对实际值,结果写入 adapter manifest;不修改厂家资产或放宽跟随判据。省略 dynamics 时的零摩擦是名义模型假设,不代表已测得实机摩擦。

物理验收要求每步状态有限、厂家关节范围与速度不超限、FK 一致、没有非排除接触、最大跟随及到点参考偏差不超过 0.1°。原始轨迹、接触记录与每项指标独立保存,物理有效性和预设通过分别报告。安装配准、模型惯性与伺服参数尚未实测,因此这些结果不构成实机安全认证。

Servo 模式切换确认后发布该请求的实际输入值,确认前抑制运动;预设验收核对模式切换的返回值与实际输入一致。

KDL 运行配置显式设置 epsilon=1e-7,避免 100 Hz 下的小增量被视为已到点;低速预设保持原位置容差与速度限制。参数语义见 MoveIt 2.12.4 KDL 实现。

实机 ServoJ 的实时系统、专用有线网络、厂家受限运动基线与现场安装要求见现场联调。预设仿真不连接控制柜,也不改变现场配置。

实机、mock 和仿真证据分别索引于当前状态,软件检查范围见验证指南。