Telekinesis Agentic Skill Library

Appearance

Set Max Pump Speed ​

SUMMARY

Set Max Pump Speed configures the maximum speed of a suction gripper's vacuum pump.

This skill is used to tune how quickly vacuum builds - lower speeds reduce noise and air consumption; higher speeds reduce cycle time.

SUPPORTED GRIPPERS

Available on Piab suction grippers.

UNITS

max_speed in percent (0-100).

The Skill ​

python
gripper.set_max_pump_speed(max_speed=80)

The Code ​

Example: Reduce Pump Speed for a Quiet Cell ​

python
"""
Piab set_max_pump_speed example for the Synapse SDK.

Reduces the maximum pump speed to 60%, then grasps.

Usage:
    python set_max_pump_speed.py --ip <ROBOT_IP>
"""

import argparse
from loguru import logger

from telekinesis.synapse.tools.suction_grippers import piab


def main(ip: str):
    """Reduce the maximum pump speed, then grasp."""

    # Create and connect to the gripper
    gripper = piab.PiabPiCobotElectric()
    gripper.connect(ip=ip, protocol="URCAP")

    try:
        gripper.set_max_pump_speed(60)
        gripper.grasp()
        logger.success("Grasped with pump speed capped at 60%.")
    finally:
        gripper.disconnect()


if __name__ == "__main__":
    parser = argparse.ArgumentParser(description="Piab gripper set_max_pump_speed example")
    parser.add_argument("--ip", type=str, required=True, help="UR controller IP address")
    args = parser.parse_args()

    main(ip=args.ip)

The Explanation of the Code ​

set_max_pump_speed caps how fast the vacuum pump is allowed to run. It does not change the target vacuum level set by set_vacuum_level - it only limits how quickly the pump ramps up to reach it, which affects noise, air consumption, and time-to-grasp.

How to Tune the Parameters ​

Piab piCOBOT Electric ​

ParameterTypeDefaultDescription
max_speedint-Maximum pump speed as a percentage, 0-100.

Where to Use the Skill ​

  • Noise-sensitive cells - Cap pump speed to reduce audible noise in shared workspaces
  • Air-consumption limits - Lower the cap when the facility's compressed-air supply is constrained

When Not to Use the Skill ​

Do not use Set Max Pump Speed when:

  • The gripper is not connected - always call connect before issuing commands
  • Fast cycle time is the priority - leaving the pump at its default (unrestricted) speed grasps fastest