# Universal Robots UR5e 开发百科

> 原文链接：https://robotics.hellobike.com/wiki/universal-robots-ur5e-dev-guide
> 频道：wiki | 更新日期：2026-10-22 | 标签：协作机械臂, UR5e, ROS2, RTDE, MuJoCo, URCap
> 核心摘要：UR5e 是六轴协作机械臂，最高有效负载 5 千克，支持 ROS/ROS2；具备千兆以太网、USB 2.0、RTDE 与多类官方驱动，适合中等负载应用开发。

# Universal Robots UR5e 开发百科

## 本体与算力接口

UR5e 属于六轴协作机械臂，`dof` 为 6，`height_m` 按 850 mm 臂展记录，本体重量 20.6 千克，最高有效负载 5 千克。其电源输入电压范围为 100-240 VAC，具备 17 项可配置安全功能。扩展与通信侧提供千兆以太网、USB 2.0，其中以太网接口速率为 1 Gb/s；机型卡标注支持 ROS/ROS2。

## 官方 SDK 与通信协议

[PolyScopeX_URCap_SDK](/sdks/universalrobots-polyscopex-urcap-sdk) 面向 PolyScope X 的 URCap 开发与 URSim 测试，语言为 Dockerfile，仓库：https://github.com/UniversalRobots/PolyScopeX_URCap_SDK；README 写明可用 GitHub Codespaces，样例用 `npm install && npm run build`。

[RTDE_Python_Client_Library](/sdks/universalrobots-rtde-python-client-library) 是 Python RTDE 客户端库，仓库：https://github.com/UniversalRobots/RTDE_Python_Client_Library；README 写明实现 Universal Robots RTDE realtime interface，示例包含记录实时数据、控制回路与绘图，运行前需在机器人安全设置启用 RTDE。

[Universal_Robots_Client_Library](/sdks/universalrobots-universal-robots-client-library) 是 C++ 库，仓库：https://github.com/UniversalRobots/Universal_Robots_Client_Library；README 写明支持 RTDE、Dashboard、基础 primary interface 与自定义 motion streaming，并要求 PolyScope 3.14.3、5.9.4 或 10.7.0 及以上，以及 POSIX threads。

[Universal_Robots_ExternalControl_URCap](/sdks/universalrobots-universal-robots-externalcontrol-urcap) 是 Java URCap，仓库：https://github.com/UniversalRobots/Universal_Robots_ExternalControl_URCap；README 写明它是 ROS、ROS2、Isaac SDK 驱动及 Client Library 的用户界面，支持 CB3 与 e-Series，要求 URCap library 1.3.0 或更高。

[Universal_Robots_Isaac_Driver](/sdks/universalrobots-universal-robots-isaac-driver) 是 C++ Isaac SDK 驱动，仓库：https://github.com/UniversalRobots/Universal_Robots_Isaac_Driver；README 写明用于 UR robots 与 NVIDIA Isaac-SDK，支持 CB3 software >= 3.7 与 e-Series software >= 5.1 的机器人或仿真器。

## ROS 2 与仿真资产

机型卡给出官方 ROS 2 描述包资源：URDF 为 `https://github.com/UniversalRobots/Universal_Robots_ROS2_Description/blob/humble/urdf/ur.urdf.xacro`，仓库为 `https://github.com/UniversalRobots/Universal_Robots_ROS2_Description`，说明该 xacro 含 UR5e。MJCF 资产来自 MuJoCo Menagerie：`https://github.com/google-deepmind/mujoco_menagerie/blob/main/universal_robots_ur5e/ur5e.xml`。标注支持的仿真器包括 MuJoCo、Gazebo 与 ROS 2。

## 推荐上手顺序

1. 先按目标选择链路：ROS/ROS2 用户从 ROS 2 描述包与 External Control URCap 入手；MuJoCo 用户直接使用 MJCF。
2. 做 URCap 插件时使用 PolyScopeX_URCap_SDK，并在 Codespaces 或 URSim 中验证。
3. 做实时数据读写时启用 RTDE，Python 选 RTDE_Python_Client_Library，C++ 选 Universal_Robots_Client_Library。
4. 需要 Isaac SDK 时再接入 Universal_Robots_Isaac_Driver，并结合其 URCaps 与 Dashboard 能力。

## 来源

- [UR5e 官方数据表](https://www.universal-robots.com/media/1807465/ur5e_e-series_datasheets_web.pdf)
- [MuJoCo Menagerie UR5e](https://github.com/google-deepmind/mujoco_menagerie/blob/main/universal_robots_ur5e/ur5e.xml)
- [GitHub PolyScopeX_URCap_SDK](https://github.com/UniversalRobots/PolyScopeX_URCap_SDK)
- [GitHub RTDE_Python_Client_Library](https://github.com/UniversalRobots/RTDE_Python_Client_Library)
- [GitHub Universal_Robots_Client_Library](https://github.com/UniversalRobots/Universal_Robots_Client_Library)
- [GitHub Universal_Robots_ExternalControl_URCap](https://github.com/UniversalRobots/Universal_Robots_ExternalControl_URCap)
- [GitHub Universal_Robots_Isaac_Driver](https://github.com/UniversalRobots/Universal_Robots_Isaac_Driver)
- [GitHub Universal_Robots_ROS_controllers_cartesian](https://github.com/UniversalRobots/Universal_Robots_ROS_controllers_cartesian)

本页由站内机型卡、官方 SDK README 与已验证记录整理而成；命令与版本以仓库当前 README 为准。

## 原始参考来源 (Sources)

- [UR5e 官方数据表](https://www.universal-robots.com/media/1807465/ur5e_e-series_datasheets_web.pdf)
- [MuJoCo Menagerie UR5e](https://github.com/google-deepmind/mujoco_menagerie/blob/main/universal_robots_ur5e/ur5e.xml)
- [GitHub PolyScopeX_URCap_SDK](https://github.com/UniversalRobots/PolyScopeX_URCap_SDK)
- [GitHub RTDE_Python_Client_Library](https://github.com/UniversalRobots/RTDE_Python_Client_Library)
- [GitHub Universal_Robots_Client_Library](https://github.com/UniversalRobots/Universal_Robots_Client_Library)
- [GitHub Universal_Robots_ExternalControl_URCap](https://github.com/UniversalRobots/Universal_Robots_ExternalControl_URCap)
- [GitHub Universal_Robots_Isaac_Driver](https://github.com/UniversalRobots/Universal_Robots_Isaac_Driver)
- [GitHub Universal_Robots_ROS_controllers_cartesian](https://github.com/UniversalRobots/Universal_Robots_ROS_controllers_cartesian)