Files
chenlin ceca51b0d8
Checks / Layout, translation and Colab checks (push) Has been cancelled
Checks / Ruff (push) Has been cancelled
Checks / Framework tests (native backend, CPU) (push) Has been cancelled
Checks / Portable Rust controller (push) Has been cancelled
Improve generic robot onboarding, walking controls and end-effector interaction
Default humanoid intake to command-following gait and support bounded Cartesian target dragging for arms. Carry model and actuator semantics through calibration, native verification and packaging. Document reusable intake decisions and cover them with regression tests.
2026-11-06 10:54:58 +08:00

2.6 KiB

操作控制

controller/vocabulary.json 定义键盘和手柄的控制名称。 python -m controller --vocabulary 可显示词表。 controller.controls.load_controls 验证共享的 schema_version: 2 格式。

训练模板

在机器人资产旁生成机体系运动绑定:

python .claude/skills/controls/scripts/write_controls.py --task my_robot \
  --out assets/my_robot/controls.yaml

命令 twist 送到 velocity_commands,轴顺序为 lin_vel_x、 lin_vel_y、ang_vel_z。摇杆的正负两侧分别按命令范围缩放。 已注册任务按形态选择布局。双足人形和暂未注册的机器人默认用 walking,轮足 双足用 differential,其余足式任务用 omni。可用 --profile 显式指定。

按键按住时,命令逐渐增大。walking 布局用 W/S 控制前进和后退, A/D 控制左转和右转,方向键与 WASD 对应。支持侧移的策略还可以用 J/L 左右侧移。 手柄的 Ly、Lx 和 Rx 分别控制前后、侧移和转向。按住 W+A 可边前进边左转。 显式选择 omni 可使用 A/D 侧移、J/L 转向的布局。轮足双足使用 --profile differential,其横向轴无键盘绑定,模板中的横向速度范围为零。

用 --bind AXIS=SOURCE+ 或 --bind AXIS=SOURCE- 指定符号, 用 --release BUTTON 设置手柄释放键。在仿真检查方向和释放动作, 并把机器人规格的 controls_path 指向生成文件。

确定性控制

onboard.py setup-tier2 为控制器的命名轴生成绑定。可选 operator_axes 最多选四个轴,其余关节滑块或目标可通过程序接口控制。 打包前验证实际使用的控制器和绑定。修改后重新生成报告。

在末端控制模式下,双击末端的目标标记,按住 Ctrl 并用鼠标右键拖动。 同时按住 Shift 可切换拖动平面,松开鼠标后保持当前位置目标。

共享格式

命令列表声明名称、输出位置、坐标系、有序的轴和满幅缩放规则。每个轴有单位与 正方向,手柄声明带符号的来源,键盘声明正负方向键或说明未绑定的原因。

解析器也支持分段行程、切换层、组合键、可复位的积分轴和兼容消费者的辅助控制。 锁定的运动模板使用一个零静止值的机体系速度命令。原生应用以 --app-mode 选择模式。旧版 FSM 模式切换由部署清单单独定义。

python -c "from pathlib import Path; from controller.controls import load_controls; load_controls(Path('assets/my_robot/controls.yaml'))"
python -m pytest tests/test_controls.py -q