Skip to content

基础示例

1. 项目介绍

本项目是使用睿尔曼Python开发包完成工程、完成机械臂连接、机械臂版本获取、API版本获取、movej运动、moveL运动、moveC运动、关闭连接。

2. 代码结构

RMDemo_SimpleProcess/

├── README.md        <- 项目的核心文档
├── requirements.txt    <- 项目的依赖列表
├── setup.py        <- 项目的安装脚本

├── src/          <- 项目的源代码
│  ├── main.py       <- 程序的主入口
│  └── core/        <- 核心功能或业务逻辑代码
│    └── demo_simple_process.py      <- 完成机械臂连接、机械臂版本获取、API版本获取、movej运动、moveL运动、moveC运动、关闭连接的示例。
└── Robotic_Arm/      <- 睿尔曼机械臂二次开发包

3.项目下载

通过链接下载 RM_API2 到本地:开发包下载,进入RM_API2\Demo\RMDemo_Python目录,可找到RMDemo_SimpleProcess。

4. 环境配置

在Windows和Linux环境下运行时需要的环境和依赖项:

项目LinuxWindows
系统架构x86架构-
python3.9以上3.9以上
特定依赖--

Linux环境配置

  1. 参考python官网-linux下载安装python3.9。

  2. 进入项目目录后打开终端运行以下指令安装依赖:

bash
pip install -r requirements.txt

Windows环境配置

  1. 参考python官网-Windows下载安装python3.9。

  2. 进入项目目录后打开终端运行以下指令安装依赖:

bash
pip install -r requirements.txt

5. 注意事项

该Demo以RM65-B型号机械臂为例,请根据实际情况修改代码中的数据。

6. 使用指南

6.1 快速运行

按照以下步骤快速运行代码:

  1. 配置机械臂IP地址:打开 demo_simple_process.py 文件,在 main 函数中修改 RobotArmController 类的初始化参数为当前机械臂的IP地址,默认IP地址为 "192.168.1.18"

    python
    # Create a robot arm controller instance and connect to the robot arm
    robot_controller = RobotArmController("192.168.1.18", 8080, 3)
  2. 命令行运行:在终端进入 RMDemo_SimpleProcess 目录,输入以下命令运行Python脚本:

    bash
    python ./src/main.py
  3. 运行结果:在终端中可以看到机械臂的运行状态。

运行脚本后,输出结果如下所示:

current api version:  0.2.9

Successfully connected to the robot arm: 1

API Version:  0.2.9 

================== Arm Software Information ==================
Arm Model:  RM65-6FI
Algorithm Library Version:  V1.3.9
Control Layer Software Version:  V1.5.3
Dynamics Version:  2
Planning Layer Software Version:  V1.5.3
==============================================================

movej motion succeeded

movej_p motion succeeded

movel motion succeeded

movej_p motion succeeded

movec motion succeeded

Successfully disconnected from the robot arm

6.2 代码说明

下面是 demo_simple_process.py 文件的主要功能:

  • 连接机械臂

    python
    robot_controller = RobotArmController("192.168.1.18", 8080, 3)

    连接到指定IP和端口的机械臂。

  • 获取API版本

    python
    print("\nAPI Version: ", rm_api_version(), "\n")

    获取并显示API版本。

  • 获取机械臂软件信息

    python
    robot_controller.get_arm_software_info()

    获取并显示机械臂的基本信息,包括产品版本、算法库版本、控制层软件版本、动力学版本和规划层软件版本。

  • 执行movej运动

    python
    robot_controller.movej([0, 20, 70, 0, 90, 0])
  • 执行movej_p运动

    python
    robot_controller.movej_p([0.3, 0, 0.3, 3.14, 0, 0])
  • 执行movel运动

    python
    robot_controller.movel([0.2, 0, 0.3, 3.14, 0, 0])
  • 执行movec运动

    python
    robot_controller.movec([0.2, 0.05, 0.3, 3.14, 0, 0], [0.2, -0.05, 0.3, 3.14, 0, 0], loop=2)
  • 断开机械臂连接

    python
    robot_controller.disconnect()

7. 许可证信息

  • 本项目遵循MIT许可证。