OpenRR快速上手教程：5个步骤从安装依赖到跑通你的第一个模拟机器人

OpenRR快速上手教程5个步骤从安装依赖到跑通你的第一个模拟机器人【免费下载链接】openrrOpen Rust Robotics项目地址: https://gitcode.com/gh_mirrors/op/openrr本教程带你快速上手OpenRROpen Rust Robotics——全球首个完全由 Rust 构建的开源机器人平台。只需 5 个步骤安装依赖、安装工具、获取示例机器人、启动可视化器、执行运动命令你就能在本地跑通自己的第一个模拟机器人而且无需安装 ROS先认识 OpenRR 架构 OpenRR 采用清晰的模块化设计核心是arci抽象机器人控制接口硬件抽象层——你基于arci特性编写代码就能同时驱动真实机器人ROS/ROS2和模拟器urdf-viz模块作用arci机器人硬件抽象层关节、导航、激光雷达等接口arci-urdf-viz基于 urdf-viz 模拟器的 arci 实现arci-ros/arci-ros2ROS1 / ROS2 实现openrr-client在接口之上封装 IK、避障等客户端openrr-apps命令行与 GUI 工具集本教程主角openrr-planner运动规划、IK 求解、碰撞检测openrr-gui基于 egui 的图形界面滑杆控关节等更多模块说明可参考 arci/README.md 与 openrr-apps/README.md。第1步安装系统依赖一键命令OpenRR 支持 LinuxUbuntu、macOS 和 Windows。以 Ubuntu 为例一条命令装齐全部系统依赖sudo apt install cmake build-essential libudev-dev xorg-dev libglu1-mesa-dev libasound2-dev libxkbcommon-dev protobuf-compiler各项依赖的用途详见 ci/ubuntu-install-dependencies.shcmakebuild-essential编译 assimp 网格库openrr-plannerxorg-dev等GUI 界面openrr-gui / eguilibasound2-dev语音播报arci-speak-audioprotobuf-compiler远程调用openrr-remote同时确保已安装 Rust 工具链curl --proto https --tlsv1.2 -sSf https://sh.rustup.rs | sh第2步安装 urdf-viz 与 openrr-apps 两大工具# 安装 URDF 可视化器模拟机器人的眼睛 cargo install urdf-viz # 安装 OpenRR 命令行/GUI 工具集 cargo install openrr-apps⚠️ Windows 用户不支持 ROS请改用cargo install openrr-apps --no-default-features --features gui,assimpopenrr-apps会提供 4 个常用命令openrr_apps_robot_command通用机器人命令、openrr_apps_robot_teleop手柄遥操作、openrr_apps_joint_position_senderGUI 滑杆控关节、openrr_apps_velocity_sender速度发送。第3步获取示例机器人模型与配置文件从仓库拉取示例 URDF 机器人一个双臂底盘的 sample robot和配套配置git clone https://gitcode.com/gh_mirrors/op/openrr cd openrr你会用到三个关键文件机器人模型openrr-planner/sample.urdf客户端配置sample_robot_client_config_for_urdf_viz.toml演示命令脚本sample_cmd_urdf_viz.txt配置文件里定义了两条机械臂l_arm/r_arm的关节名、位置限位以及自碰撞检查、IK 求解器等——这些正是 OpenRR 的招牌能力。第4步启动 URDF 可视化器在仓库根目录启动可视化窗口让 sample robot 现身urdf-viz ./openrr-planner/sample.urdf 此时应看到一个双臂机器人渲染窗口它会实时接收并显示关节角度变化。第5步执行命令让机器人动起来 运行官方演示脚本含关节发送、避障、IK 运动、导航、语音播报等完整演示openrr_apps_robot_command \ --config-path./openrr-apps/config/sample_robot_client_config_for_urdf_viz.toml \ load_commands ./openrr-apps/command/sample_cmd_urdf_viz.txt观察可视化窗口你将看到左臂依次摆出多个姿态send_joints左右臂演示自碰撞避让l_arm_collision_avoidance通过IK 逆运动学让末端工具到达指定位置move_ik底盘以速度指令移动send_base_velocity机器人说话speak 恭喜你第一个模拟机器人已经跑通进阶玩法GUI 滑杆与手柄遥操作 GUI 控关节灵感来自 ROS 的 joint_state_publisher_guiopenrr_apps_joint_position_sender \ --config-path ./openrr-apps/config/sample_robot_client_config_for_urdf_viz.toml手柄/键盘遥操作默认配置为索尼 DualShock 4也可用键盘模拟openrr_apps_robot_teleop \ --config-path./openrr-apps/config/sample_teleop_config_urdf_viz.toml \ --teleop-configgamepadKeyboard配置文件支持--config启动时覆写比如直接替换 URDF 路径openrr_apps_robot_command \ --config-path./openrr-apps/config/sample_robot_client_config_for_urdf_viz.toml \ --configopenrr_clients_config.urdf_pathpath/to/your.urdf \ load_commands ./openrr-apps/command/sample_cmd_urdf_viz.txt还可以设置环境变量OPENRR_APPS_ROBOT_CONFIG_PATH免去每次传--config-path。常见问题排查 ️找不到 urdf-viz 命令确认cargo install urdf-viz后~/.cargo/bin在PATH中GUI 打不开检查第 1 步的xorg-dev、libglu1-mesa-dev、libxkbcommon-dev是否装齐配置路径不对配置中urdf_path为相对路径请在仓库根目录执行命令想换真实机器人只需把配置里的客户端换成arci-ros/arci-ros2上层代码零改动——这正是 arci 抽象层的价值小结步骤命令/动作耗时1. 安装依赖apt install rustup约 5 分钟2. 安装工具cargo install urdf-viz openrr-apps约 10 分钟3. 获取示例git clone仓库约 1 分钟4. 启动可视化urdf-viz sample.urdf1 条命令5. 跑通演示openrr_apps_robot_command load_commands1 条命令用 Rust 写机器人程序享受类型安全与高性能。想继续深入建议阅读 openrr-apps/README.md 了解 UR10、PR2 等更多机器人示例以及 openrr-client 与 openrr-planner 源码动手扩展你自己的机器人控制逻辑吧【免费下载链接】openrrOpen Rust Robotics项目地址: https://gitcode.com/gh_mirrors/op/openrr创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考