RobotX:基于 GB/T 与 ROS2 标准的机器人统一编程接口框架项目

RobotX 是一个基于中国国家标准 (GB/T) 和 ROS2 事实国际标准的**机器人统一编程接口框架**。项目采用创新的**双标准驱动**架构,通过插件化设计屏蔽不同厂商机器人的硬件差异,实现"**一次编程、多机部署、厂商无感替换**"的目标。 ### 核心特性 🎯 **双标准驱动** - 严格遵循中国国家标准 (GB/T 29824, GB/T 47245) - 完全兼容 ROS2 消息/服务/Action 模型 - 国标与 ROS2 双向自动映射 🔌 **插件化架构** - 五层分层设计 (应用层→统一接口层→抽象层→适配层→硬件层) - 支持插件化加载各厂商适配器 - 新增机器人厂商无需改动上层应用 🤖 **广泛支持** - **工业机械臂**: ABB, KUKA, FANUC, UR, 埃斯顿,汇川 - **人形机器人**: 优必选 Walker X, 小米 CyberOne - **移动机器人**: AGV, AMR, 轮式/履带式平台 - **服务机器人**: 导引、配送、清洁机器人 ⚡ **强大功能** - 任务级编程接口 - 运动控制归一化 - IO 与外设统一控制 - 故障与安全标准化 - 人形机器人专用扩展 (步态、平衡、双臂协调)

Branch1Tags0
FilesLast commitLast update
2 days ago
2 days ago
4 months ago
2 days ago
6 months ago
2 days ago
2 days ago
2 days ago
4 months ago
2 days ago
4 months ago
2 days ago
6 months ago
2 days ago

RobotX - 机器人统一编程接口框架

🤖 项目名称

RobotX - 机器人统一编程接口框架
(Robot Unified Programming Interface Framework)

📖 项目简介

RobotX 是一个基于中国国家标准 (GB/T) 和 ROS2 事实国际标准的机器人统一编程接口框架。项目采用创新的双标准驱动架构,通过插件化设计屏蔽不同厂商机器人的硬件差异,实现"一次编程、多机部署、厂商无感替换"的目标。

核心特性

🎯 双标准驱动

  • 严格遵循中国国家标准 (GB/T 29824, GB/T 47245)
  • ROS2 兼容: 消息级双向映射 + 桥接节点 (可选组件)
  • 国标与 ROS2 双向自动映射

🔌 插件化架构

  • 五层分层设计 (应用层→统一接口层→抽象层→适配层→硬件层)
  • 支持插件化加载各厂商适配器
  • 新增机器人厂商无需改动上层应用

🤖 广泛支持

  • 工业机械臂: ABB, KUKA, FANUC, UR, 埃斯顿,汇川
  • 人形机器人: 优必选 Walker X, 小米 CyberOne
  • 移动机器人: AGV, AMR, 轮式/履带式平台
  • 服务机器人: 导引、配送、清洁机器人

⚡ 强大功能

  • 任务级编程接口
  • 运动控制归一化
  • IO 与外设统一控制
  • 故障与安全标准化
  • 人形机器人专用扩展 (步态、平衡、双臂协调)

快速开始

from robot_unified_api import UnifiedRobotInterface, Pose, Position
from robot_unified_api.plugins.ubtech_adapter import UBTECHRobotAdapter

# 创建适配器
adapter = UBTECHRobotAdapter(ip="YOUR_ROBOT_IP")

# 创建统一接口
robot = UnifiedRobotInterface("walker_x_001", adapter)

# 启动接口、注册(连接)机器人并控制
await robot.start()
await robot.register_robot({"ip": "YOUR_ROBOT_IP"})
await robot.move_to_pose(
    pose=Pose(position=Position(0.5, 0.3, 0.4)),
    velocity=0.5
)

项目结构

robotx/
├── .github/                 # GitHub 配置
│   └── workflows/           # CI/CD 工作流
│       ├── ci.yml           # 持续集成
│       └── release.yml      # 发布流程
├── robot_unified_api/       # 核心框架
│   ├── core.py              # 核心数据类型
│   ├── interface.py         # 统一接口层
│   ├── plugin.py            # 插件规范
│   ├── abstraction_layer.py # 多标准兼容抽象层
│   ├── ros2_bridge.py       # ROS2 桥接节点 (可选组件)
│   ├── humanoid_extension.py # 人形机器人扩展
│   ├── plugins/             # 厂商适配器
│   ├── examples/            # 示例代码
│   └── tests/               # 框架测试
├── docs/                    # 项目文档
│   ├── api/                 # API 参考文档
│   ├── adapters/            # 适配器文档
│   ├── humanoid/            # 人形机器人文档
│   ├── ARCHITECTURE.md      # 架构设计
│   ├── PROJECT_OVERVIEW.md  # 项目总览
│   ├── PROJECT_STRUCTURE.md # 项目结构
│   ├── ROS2_COMPATIBILITY.md # ROS2 兼容性
│   ├── HUMANOID_ROBOTICS_GUIDE.md # 人形机器人指南
│   └── VERSION.md           # 版本历史
├── implementations/         # 厂商实现文档
├── standards/               # 国标文档
├── tests/                   # 集成测试
├── .pre-commit-config.yaml  # pre-commit 配置
├── CONTRIBUTING.md          # 贡献指南
├── CHANGELOG.md             # 更新日志
└── README.md                # 项目说明

支持的机器人

厂商 型号 类型 状态
ABB IRB 系列 工业机械臂 ✅ 已实现
KUKA KR 系列 工业机械臂 ✅ 已实现
FANUC R-30iB 工业机械臂 ✅ 已实现
UR UR5/UR10 协作机器人 ✅ 已实现
埃斯顿 ESTUN 工业机械臂 ✅ 已实现
汇川 INOVANCE 工业机械臂 ✅ 已实现
优必选 Walker X 人形机器人 ✅ 已实现
小米 CyberOne 人形机器人 ✅ 已实现

标准遵循

  • GB/T 29824-2013《工业机器人 用户编程指令》
  • GB/T 47245-2026《机器人智能控制系统总体架构》
  • GB/T 44251-2024《腿式机器人性能及试验方法》
  • ROS2 消息/服务/Action 模型

安装

pip install robotx

开发模式安装:

git clone https://gitcode.com/hunyuan2026/RobotX.git
cd RobotX
pip install -e "./robot_unified_api[dev]"

# 安装 pre-commit 钩子
pre-commit install

文档

版本

当前版本:v0.3.0

许可证

MIT License

联系方式


RobotX - 让机器人编程更简单!🚀

Introduction

RobotX 是一个基于中国国家标准 (GB/T) 和 ROS2 事实国际标准的**机器人统一编程接口框架**。项目采用创新的**双标准驱动**架构,通过插件化设计屏蔽不同厂商机器人的硬件差异,实现"**一次编程、多机部署、厂商无感替换**"的目标。 ### 核心特性 🎯 **双标准驱动** - 严格遵循中国国家标准 (GB/T 29824, GB/T 47245) - 完全兼容 ROS2 消息/服务/Action 模型 - 国标与 ROS2 双向自动映射 🔌 **插件化架构** - 五层分层设计 (应用层→统一接口层→抽象层→适配层→硬件层) - 支持插件化加载各厂商适配器 - 新增机器人厂商无需改动上层应用 🤖 **广泛支持** - **工业机械臂**: ABB, KUKA, FANUC, UR, 埃斯顿,汇川 - **人形机器人**: 优必选 Walker X, 小米 CyberOne - **移动机器人**: AGV, AMR, 轮式/履带式平台 - **服务机器人**: 导引、配送、清洁机器人 ⚡ **强大功能** - 任务级编程接口 - 运动控制归一化 - IO 与外设统一控制 - 故障与安全标准化 - 人形机器人专用扩展 (步态、平衡、双臂协调)

Customize your domain