Python新手必看：5分钟搞定睿尔曼机械臂基础控制（附代码示例）

最新推荐文章于 2026-04-24 05:33:44 发布

原创

最新推荐文章于 2026-04-24 05:33:44 发布 · 294 阅读

从零到一：用Python掌控睿尔曼机械臂的完整实战指南

如果你对机器人技术充满好奇，尤其是看到那些灵活自如的机械臂时，心里是否曾闪过这样的念头：“我能不能也让它动起来？”好消息是，现在这不再是专业工程师的专属领域。睿尔曼的超轻量仿人机械臂，配合其精心设计的Python SDK，让零基础的开发者也能在短时间内实现机械臂的基础控制。我刚开始接触时也有同样的疑问，但实际动手后发现，整个过程比想象中要直观得多。

这篇文章就是为你准备的。无论你是高校学生、创客爱好者，还是刚转行到机器人领域的开发者，我都会带你走完从环境搭建到代码运行的全过程。我们不谈复杂的运动学理论，只聚焦于最实用的“连接-控制-读取”核心流程。你会发现，让机械臂按照你的指令运动，其实只需要理解几个关键函数和正确的操作顺序。

1. 准备工作：搭建你的第一个机械臂控制环境

在开始写代码之前，我们需要确保硬件和软件都准备就绪。这个过程有点像组装一台新电脑——步骤明确，按部就班就能成功。

1.1 硬件连接与网络配置

睿尔曼机械臂的一大优势是即插即用。以RM65-B型号为例，开箱后你只需要：

连接电源：使用配套的电源适配器为机械臂供电
网络连接：用网线将机械臂的网口与电脑网口直接相连
开机启动：按下机械臂基座上的电源按钮，等待指示灯变为稳定蓝色

注意：首次使用时，建议通过有线方式连接，稳定性更高。无线连接可以在熟悉基本操作后再尝试。

接下来是网络配置的关键步骤。机械臂出厂默认IP地址通常是192.168.1.18，我们需要将电脑配置到同一网段：

Windows系统配置步骤：

# 打开命令提示符，检查当前网络配置
ipconfig

# 如果需要在同一网段，可以手动设置IP
# 控制面板 -> 网络和共享中心 -> 更改适配器设置
# 右键点击当前网络连接 -> 属性 -> Internet协议版本4(TCP/IPv4)
# 选择“使用下面的IP地址”：
# IP地址：192.168.1.100（或其他1-254之间，非18的数字）
# 子网掩码：255.255.255.0
# 默认网关：192.168.1.1

Linux系统配置步骤：

# 查看当前网络接口
ifconfig

# 临时设置IP地址（重启后失效）
sudo ifconfig eth0 192.168.1.100 netmask 255.255.255.0

# 或者使用nmcli（NetworkManager）
sudo nmcli connection modify "有线连接" ipv4.addresses 192.168.1.100/24
sudo nmcli connection up "有线连接"

配置完成后，测试连通性：

ping 192.168.1.18

如果看到类似下面的响应，说明连接成功：

来自 192.168.1.18 的回复: 字节=32 时间=1ms TTL=64

1.2 Python环境与SDK安装

睿尔曼机械臂的Python SDK支持Python 3.7及以上版本。我推荐使用Python 3.9，这是目前兼容性最好的版本之一。

安装Python（如果尚未安装）：

# Windows用户可以从官网下载安装包
# https://www.python.org/downloads/

# Linux用户使用包管理器
sudo apt update
sudo apt install python3.9 python3-pip

安装睿尔曼机械臂SDK：

官方提供了两种安装方式，我建议新手使用pip安装，最简单直接：

pip install Robotic_Arm

如果你需要最新的开发版本，或者想要查看源码，也可以从GitHub克隆：

git clone https://github.com/RealManRobot/RM_API2.git
cd RM_API2/Python
pip install -e .

安装完成后，可以通过一个简单的测试脚本来验证SDK是否正常工作：

# test_import.py
from Robotic_Arm.rm_robot_interface import *
print("SDK导入成功！")
print("API版本：", rm_api_version())

运行这个脚本，如果能看到版本号输出，说明环境配置成功。

2. 建立连接：与机械臂的第一次“握手”

现在进入最激动人心的部分——让代码与机械臂真正对话。睿尔曼的Python SDK设计得非常直观，核心控制逻辑围绕几个关键类展开。

2.1 理解连接参数

在建立连接前，我们需要了解几个关键参数：

参数	说明	默认值	注意事项
IP地址	机械臂的网络地址	192.168.1.18	可通过示教器修改
端口	通信端口	8080	一般无需修改
连接等级	控制权限级别	3	等级3为完全控制权限
线程模式	内部处理线程数	2（三线程）	0:单线程, 1:双线程, 2:三线程

2.2 创建连接实例

让我们从一个完整的连接示例开始：

# connect_robot.py
import sys
from Robotic_Arm.rm_robot_interface import *

def connect_to_robot(ip="192.168.1.18", port=8080):
    """
    连接到睿尔曼机械臂
    
    参数:
        ip: 机械臂IP地址
        port: 端口号
    
    返回:
        robot: 机械臂控制实例
        handle: 连接句柄
    """
    try:
        # 创建机械臂控制实例，使用三线程模式
        robot = RoboticArm(rm_thread_mode_e.RM_TRIPLE_MODE_E)
        
        # 建立连接，连接等级为3（完全控制）
        handle = robot.rm_create_robot_arm(ip, port, 3)
        
        # 检查连接是否成功
        if handle.id == -1:
            print("❌ 连接失败！请检查：")
            print("   1. 机械臂是否已开机")
            print("   2. IP地址是否正确")
            print("   3. 网络是否连通")
            return None, None
        else:
            print(f"✅ 成功连接到机械臂，ID: {handle.id}")
            return robot, handle
            
    except Exception as e:
        print(f"连接过程中出现异常: {e}")
        return None, None

if __name__ == "__main__":
    # 修改这里的IP为你的机械臂实际IP
    robot, handle = connect_to_robot("192.168.1.18")
    
    if robot and handle:
        print("连接测试通过！")
        # 记得断开连接
        robot.rm_delete_robot_arm()

运行这个脚本，如果一切正常，你会看到“成功连接到机械臂”的提示。第一次成功连接时，那种成就感是实实在在的——你已经跨过了最基础也是最重要的门槛。

2.3 获取机械臂信息

连接成功后，我们可以获取机械臂的详细信息，这有助于后续的调试和开发：

def get_robot_info(robot):
    """
    获取机械臂详细信息
    """
    # 获取软件版本信息
    software_info = robot.rm_get_arm_software_info()
    
    if software_info[0] == 0:  # 返回码为0表示成功
        info = software_info[1]
        print("\n" + "="*60)
        print("机械臂软件信息")
        print("="*60)
        print(f"产品型号: {info['product_version']}")
        print(f"算法库版本: {info['algorithm_info']['version']}")
        print(f"控制层版本: {info['ctrl_info']['version']}")
        print(f"动力学版本: {info['dynamic_info']['model_version']}")
        print(f"规划层版本: {info['plan_info']['version']}")
        print("="*60)
    else:
        print(f"获取软件信息失败，错误码: {software_info[0]}")
    
    # 获取机械臂型号
    res, model_info = robot.rm_get_robot_info()
    if res == 0:
        print(f"机械臂型号: {model_info['arm_model']}")
        print(f"序列号: {model_info['serial_number']}")
    else:
        print(f"获取型号信息失败，错误码: {res}")

这些信息在后续开发中非常有用，特别是当遇到兼容性问题时，首先检查版本匹配性可以节省大量调试时间。

3. 基础运动控制：让机械臂动起来

掌握了连接方法后，我们进入最核心的部分——运动控制。睿尔曼SDK提供了多种运动指令，我们先从最基础的三种开始。

3.1 关节空间运动（movej）

movej指令让机械臂的各个关节运动到指定角度。这是最直接的运动方式，速度快，但末端轨迹不可控。

关键参数解析：

def movej_demo(robot, joint_angles, speed=20):
    """
    执行关节空间运动
    
    参数:
        joint_angles: 关节角度列表，单位度
            6轴机械臂: [j1, j2, j3, j4, j5, j6]
            7轴机械臂: [j1, j2, j3, j4, j5, j6, j7]
        speed: 运动速度，单位度/秒
    """
    # 参数说明表格
    params_table = {
        "参数": ["joint_angles", "speed", "r", "connect", "block"],
        "类型": ["list[float]", "float", "float", "int", "int"],
        "默认值": ["无", "20", "0", "0", "1"],
        "说明": [
            "目标关节角度，长度与轴数对应",
            "关节运动速度(度/秒)",
            "混合半径，用于轨迹平滑",
            "轨迹连接标志(0:新轨迹)",
            "阻塞标志(1:等待完成)"

标签