1 串口库安装

pip install pyserial

2 案例运行

python demo.py

3 接口介绍

1. 夹爪信息查询

get_gripper_firmware_version()

• 功能: 获取夹爪固件主版本号
• 参数: 无
• 返回: (int)固件主版本号

get_gripper_modified_version()

• 功能: 获取夹爪固件次版本号
• 参数: 无
• 返回: (int)固件次版本号

get_gripper_gripper_Id()

• 功能: 获取夹爪ID
• 参数: 无
• 返回: (int)夹爪ID

get_gripper_gripper_baud()

• 功能: 获取夹爪波特率
• 参数: 无
• 返回:(int) 0-5
  • 0: 115200
  • 1: 1000000
  • 2: 57600
  • 3: 19200
  • 4: 9600
  • 5: 4800

get_gripper_joint_angle(id)

• 功能: 获取夹爪的当前位置数据信息
• 参数: id: (int) 夹爪关节ID,取值范围 1-6
• 返回: (int)夹爪关节ID的当前位置数据

get_gripper_status()

• 功能: 获取夹爪的当前状态
• 参数: 无
• 返回:(int) 0-3
  • 0: 正在运动
  • 1: 停止运动,未检测到夹到物体
  • 2: 停止运动,检测到夹到了物体
  • 3: 检测到夹到物体以后,物体掉落

get_gripper_joint_speed(id)

• 功能: 获取夹爪关节ID的当前速度
• 参数: id: (int) 夹爪关节ID,取值范围 1-6
• 返回: (int)夹爪关节ID的当前速度

get_gripper_joint_P(id)

• 功能: 获取夹爪关节ID的PID的P值
• 参数: id: (int) 夹爪关节ID,取值范围 1-6
• 返回: (int)夹爪关节ID的PID的P值

get_gripper_joint_I(id)

• 功能: 获取夹爪关节ID的PID的I值
• 参数: id: (int) 夹爪关节ID,取值范围 1-6
• 返回: (int)夹爪关节ID的PID的I值

get_gripper_joint_D(id)

• 功能: 获取夹爪关节ID的PID的D值
• 参数: id: (int) 夹爪关节ID,取值范围 1-6
• 返回: (int)夹爪关节ID的PID的D值

get_gripper_joint_cw(id)

• 功能: 获取夹爪关节ID的顺时针可运行误差
• 参数: id: (int) 夹爪关节ID,取值范围 1-6
• 返回: (int)夹爪关节ID的顺时针可运行误差

get_gripper_joint_cww(id)

• 功能: 获取夹爪关节ID的逆时针可运行误差
• 参数: id: (int) 夹爪关节ID,取值范围 1-6
• 返回: (int)夹爪关节ID的逆时针可运行误差

get_gripper_joint_mini_pressure(id)

• 功能: 获取夹爪关节ID的最小启动力
• 参数: id: (int) 夹爪关节ID,取值范围 1-6
• 返回: (int)夹爪关节ID的最小启动力

get_gripper_joint_mini_pressure(id)

• 功能: 获取夹爪关节ID的最小启动力
• 参数: id: (int) 夹爪关节ID,取值范围 1-6
• 返回: (int)夹爪关节ID的最小启动力

get_gripper_angles()

• 功能: 获取夹爪6个关节的角度
• 参数: id: (int) 夹爪关节ID,取值范围 1-6
• 返回: (list)夹爪6个关节的角度

2 夹爪设置

set_gripper_Id(value)

• 功能: 设置夹爪ID号
• 参数:
  • value: (int) 夹爪ID,取值范围 1-254
• 返回:(int) 0-1
  • 0: 失败
  • 1: 成功

set_gripper_baud(value)

• 功能: 设置夹爪波特率
• 参数:
  • value: (int) 夹爪波特率,取值范围 0-5
    • 0: 115200
    • 1: 1000000
    • 2: 57600
    • 3: 19200
    • 4: 9600
    • 5: 4800
• 返回:(int) 0-1
  • 0: 失败
  • 1: 成功

set_gripper_enable(value)

• 功能: 设置夹爪使能状态
• 参数:
  • value: (int) 使能状态,取值范围 0-1
    • 0: 掉使能
    • 1: 上使能
• 返回:(int) 0-1
  • 0: 失败
  • 1: 成功

set_gripper_joint_calibration(id)

• 功能: 设置夹爪关节ID零位校准
• 参数: id: (int) 夹爪关节ID,取值范围 1-6
• 返回:(int) 0-1
  • 0: 失败
  • 1: 成功

set_gripper_joint_P(id,value)

• 功能: 设置夹爪关节ID的PID的P值
• 参数:
  • id: (int) 关节ID,取值范围 1-6
  • value: (int) P值,取值范围 0-254
• 返回:(int) 0-1
  • 0: 失败
  • 1: 成功

set_gripper_joint_I(id,value)

• 功能: 设置夹爪关节ID的PID的I值
• 参数:
  • id: (int) 关节ID,取值范围 1-6
  • value: (int) I值,取值范围 0-254
• 返回:(int) 0-1
  • 0: 失败
  • 1: 成功

set_gripper_joint_D(id,value)

• 功能: 设置夹爪关节ID的PID的D值
• 参数:
  • id: (int) 关节ID,取值范围 1-6
  • value: (int) D值,取值范围 0-254
• 返回:(int) 0-1
  • 0: 失败
  • 1: 成功

set_gripper_joint_cw(id,value)

• 功能: 设置夹爪关节ID的顺时针可运行误差
• 参数:
  • id: (int) 关节ID,取值范围 1-6
  • value: (int) 误差,取值范围 0-16
• 返回:(int) 0-1
  • 0: 失败
  • 1: 成功

set_gripper_joint_cww(id,value)

• 功能: 设置夹爪关节ID的逆时针可运行误差
• 参数:
  • id: (int) 关节ID,取值范围 1-6
  • value: (int) 误差,取值范围 0-16
• 返回:(int) 0-1
  • 0: 失败
  • 1: 成功

set_gripper_joint_mini_pressure(id,value)

• 功能: 设置夹爪关节ID的最小启动力
• 参数:
  • id: (int) 关节ID,取值范围 1-6
  • value: (int) 最小启动力,取值范围 0-254
• 返回:(int) 0-1
  • 0: 失败
  • 1: 成功

set_gripper_joint_torque(id,value)

• 功能: 设置夹爪关节ID的扭矩
• 参数:
  • id: (int) 关节ID,取值范围 1-6
  • value: (int) 扭矩,取值范围 0-300
• 返回:(int) 0-1
  • 0: 失败
  • 1: 成功

set_gripper_joint_speed(id,speed)

• 功能: 设置夹爪关节ID的速度
• 参数:
  • id: (int) 关节ID,取值范围 1-6
  • speed: (int) 速度,取值范围 1-100
• 返回:(int) 0-1
  • 0: 失败
  • 1: 成功

set_gripper_angles(angles,speed)

• 功能: 设置夹爪全关节角度
• 参数:
  • angles: (list) 6个关节角度,每个关节角度取值范围 0-100
  • speed: (int) 速度,取值范围 1-100
• 返回:(int) 0-1
  • 0: 失败
  • 1: 成功

set_gripper_action(value)

• 功能: 设置夹爪捏合动作
• 参数:
  • value: (int) 动作,取值范围 0-3
    • 0：食指与拇指捏合
    • 1: 中指于拇指捏合
    • 2: 三指握住
    • 3: 双指夹持
• 返回:(int) 0-1
  • 0: 失败
  • 1: 成功

set_gripper_pose(pose,value,flag)

• 功能: 设置夹爪捏合动作及开合程度

• 参数:

  • pose: (int) 动作,取值范围 0-3
    • 0：食指与拇指捏合
    • 1: 中指于拇指捏合
    • 2: 三指握住
    • 3: 双指夹持
  • value: (int) 开合程度,取值范围 0-5,合拢程度,等级越高越合拢
  • flag: (int) 空闲标志,标志1时,空闲手指可自由操控

• 返回:(int) 0-1

  • 0: 失败
  • 1: 成功