Set Speed

SUMMARY

Set Speed configures the default finger motion speed.

SUPPORTED GRIPPERS

Available on Robotiq grippers only. OnRobot grippers have no speed control.

UNITS

speed in the configured speed unit (default percent).

The Skill

actual_speed = gripper.set_speed(speed=50.0)

The Code

Example: Set a Slow Speed for Fragile Objects

"""
Robotiq 2F-85 set default speed example for the Synapse SDK.

Sets the default speed used by subsequent open/close/move calls.
Value is a percentage of the gripper's max speed.

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

import argparse
from loguru import logger

from telekinesis.synapse.tools.parallel_grippers import robotiq


def main(ip: str):
    """Set the gripper default speed to 50%."""

    # Create and connect to the gripper
    gripper = robotiq.Robotiq2F85()
    gripper.connect(ip=ip)

    try:
        actual = gripper.set_speed(speed=50.0)
        logger.success(f"Default speed set; effective: {actual}")
    finally:
        gripper.disconnect()


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

    main(ip=args.ip)

The Explanation of the Code

set_speed stores a session-level default speed. It applies to subsequent move, open, and close calls when those calls pass speed=-1.0. The method returns the actual speed value accepted by the backend, which may differ from the input if clamped by the hardware.

Default. After connect, the speed is automatically set to 100% in percent units. Only call set_speed to change this default.

-1.0 preset passthrough. Passing -1.0 instructs the backend to keep its current internal preset without overriding it from software.

Return Value

Type	Description
float	The actual speed value accepted by the backend (may be clamped).

How to Tune the Parameters

Robotiq 2F-85

Parameter	Type	Default	Description
speed	float	-	Desired speed in percent (0-100). Pass -1.0 to use the backend's current preset.

OnRobot RG2 / RG6

Speed control is not supported. OnRobot grippers move at a fixed internal rate - speed commands are silently ignored.

TIP

For pick-and-place of rigid objects, keep speed at 100% to minimise cycle time. For fragile or deformable objects, reduce to 20-40%.

Where to Use the Skill

• Fragile objects - Reduce speed to lower contact impact force when closing on delicate parts
• High-throughput tasks - Set to 100% to minimise open/close cycle time
• Backend-controlled speed - Pass -1.0 to respect a speed preset configured on the gripper hardware

When Not to Use the Skill

Do not call set_speed when:

• The default speed is acceptable - Robotiq defaults to 100% after connect; only call if a different speed is needed
• Speed is passed per-call - if every move/open/close already includes an explicit speed argument, this call is redundant