睿尔曼超轻量仿人机械臂--二次开发之Python调用API接口(二)

目录

一、API文件简介

二、Python语言开发环境说明及接口使用

Win10系统下使用

1. 开发环境

2. 项目创建&加载Python SDK

Linux系统下使用

1. 开发环境

2. 项目创建&加载Python SDK


一、API文件简介

     睿尔曼系列机械臂提供多种高级语言可用的API,可以根据所需进行选择。在这里,我将列举Python语言的项目创建及接口使用。

本文章涉及的示例项目来自于API4.2.5,如需获取最新SDK可联系睿尔曼技术支持团队

forrest@realman-robot.com

二、Python语言开发环境说明及接口使用

Win10系统下使用

1. 开发环境

操作系统:win10

IDE:PyCharm

Python版本:python 3.12.0

SDK版本:4.2.5

由于机械臂相关软件版本不定期更新,如果你使用的软件接口或协议与本文有出入,请联系睿尔曼技术人员及时更新。

2. 项目创建&加载Python SDK

创建python文件,可以通过多种方式,本文中以Pycharm为示例。详述从项目创建到添加SDK、实际运行控制机械臂。

第一步,创建Python项目

打开Pycharm软件,在右上角“File-->New Project”。打开新建项目界面,在界面中可选择项目路径及项目名称、Python版本等信息。最后点击界面右下角“Create”按钮。

第二步,加载SDK文件

添加库和相关配置文件。找到项目创建的目录,在设备资料中“(2)API 4.2.5\Python”中将提供的 Python 包中的 “robotic_arm_package”文件夹,复制并粘贴至上一步骤中创建项目的文件夹中。SDK中的接口可以通过SDK接口函数示例文档查看。

robotic_arm_package文件夹内包含三个文件:

1. Log_setting.py:日志的配置文件;

2. robotic_arm.py:调用 C 库的代码封装;

3. RM_Base.dll:C 的接口函数库,该库的版本需要与操作系统以及 Python 版本对应用户可根据需要自行更换。例如在 Linux-x86 环境使用 Python,则应在 C 的文件夹 中选择 Linux_x86 的 release 版本的库:

程序中添加库文件。创建完成的程序为下图所示,可在程序界面右击选择‘Run main’选项进行运行程序测试。

第三步,导入包或模块

将程序中的原有程序替换为如下程序,导入 robotic_arm_package 中的 robotic_arm 模块,并使用 “*”导入了该模块 中的所有内容,使用户能够在代码中使用其中的函数和变量。

from robotic_arm_package.robotic_arm import *

第四步,使用包或模块中的函数或变量

导入包之后可以使用其中定义的函数、变量或类。 例如,要使用 Arm 类中的 API_Version()查询 API 版本:

from robotic_arm_package.robotic_arm import *

robot= Arm(RM65, '192.168.1.18')

# API 版本信息

print(robot.API_Version())

第五步,测试项目运行

在程序界面右击选择“Run main”,查看是否会报错。成功界面如下所示:

第六步,机械臂通信、读取及运动控制程序

将以下程序写入Python程序中,此程序实现了机械臂的通信连接、读取API版本信息和控制机械臂运动画8字。

from robotic_arm_package.robotic_arm import *

import sys

robot = Arm(RM65, "192.168.1.18")

# API版本信息

print(robot.API_Version())

# 运行示例 画八字

ret = robot.Movej_Cmd([18.44, -10.677, -124.158, -15, -71.455], 30)

if ret != 0:

    print("设置初始位置失败:" + str(ret))

    sys.exit()

for num in range(0, 3):

    po1 = [0.186350, 0.062099, 0.2, 3.141, 0, 1.569]

    ret = robot.Movel_Cmd(po1, 30)

    if ret != 0:

        print("Movel_Cmd 1 失败:" + str(ret))

        sys.exit()

    po2 = [0.21674, 0.0925, 0.2, 3.141, 0, 1.569]

    po3 = [0.20785, 0.114, 0.2, 3.141, 0, 1.569]

    ret = robot.Movec_Cmd(po2, po3, 30)

    if ret != 0:

        print("Movec_Cmd 1 失败:" + str(ret))

        sys.exit()

    po4 = [0.164850, 0.157, 0.2, 3.141, 0, 1.569]

    ret = robot.Movel_Cmd(po4, 30)

    if ret != 0:

        print("Movel_Cmd 2 失败:" + str(ret))

        sys.exit()

    po5 = [0.186350, 0.208889, 0.2, 3.141, 0, 1.569]

    po6 = [0.20785, 0.157, 0.2, 3.141, 0, 1.569]

    ret = robot.Movec_Cmd(po5, po6, 30)

    if ret != 0:

        print("Movel_Cmd 2 失败:" + str(ret))

        sys.exit()



print("cycle draw 8 demo success")

# 断开连接

robot.RM_API_UnInit()

第七步,运行程序

Linux系统下使用

1. 开发环境

  系统:Ubuntu 20.04

  Python版本:python3

  编译器:默认

  SDK版本号:4.2.5

2. 项目创建&加载Python SDK

Ubuntu下Python项目创建可参考win10下项目的创建,在本文中Ubuntu下创建项目未使用IDE,采用创建文本的方式实现。在同文件夹添加库文件。下面是具体的操作过程:

第一步,创建python文本

在主目录下新建文件夹,名称可根据个人习惯来,这里我创建了一个test文件夹,在创建完成的文件夹下使用以下命令新建’.py’文件:touch 文件名.py。

第二步,加载SDK文件

添加库和相关配置文件。找到项目创建的目录,在设备资料中“(2)API 4.2.5\Python”中将提供的 Python 包中的 “robotic_arm_package”文件夹,复制并粘贴至上一步骤中创建项目的文件夹中。SDK中的接口可以通过SDK接口函数示例文档查看。

在 Ubuntu下使用 Python,则应在 C 的文件夹 中选择 Linux_x86 的 release 版本的库:

将linux_x86_base_release_v4.2.5.tar.bz2内容解压到“robotic_arm_package”文件夹下,如下图红色框所示,蓝色框内容为日志的配置文件和C库的代码封装。

第三步,添加权限

python程序在此处我直接复制上面用到的win10下的程序,保存后为该python程序添加权限,使其可作为可执行文件执行。

第四步,运行程序

python文件目录下打开终端,编译并运行上一步骤中的文件。

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值