Skip to main content
Control robotic arms for automated pick-and-place operations, positioning, and test fixture manipulation.

Import

Methods

Method Reference

Getting an Arm Net

Get a robotic arm net instance by name and type.
Parameters: Returns: Arm net instance with all methods listed below

position()

Get the current arm position.
Returns: tuple[float, float, float] - (x, y, z) coordinates in mm

move_to(x, y, z, timeout=15.0)

Move the arm to absolute coordinates with blocking wait.
Parameters: Raises: MovementTimeoutError if position not reached within timeout

move_relative(dx=0, dy=0, dz=0, timeout=15.0)

Move relative to current position.
Parameters: Returns: tuple[float, float, float] - New (x, y, z) position after move

go_home()

Return the arm to its home position (X=0, Y=300, Z=0).

enable_motor()

Enable the arm motors.

disable_motor()

Disable the arm motors (arm will be loose).

save_position()

Save the current position to the arm’s internal memory.

get_full_position()

Get the full position including joint angles.
Returns: tuple[float, ...] - (x, y, z, e, a, b, c) where a, b, c are joint angles

End Effector Methods

Soft Gripper

Air Picker

Laser Module

Conveyor Belt Methods

Sliding Rail Methods

Utility Methods

delay_ms(value) / delay_s(value)

Add delay to the arm’s command queue.

set_acceleration(acceleration, travel_acceleration, retract_acceleration=60)

Configure acceleration settings.

set_module_type(module_type)

Set the attached module type.

get_module_type()

Get the currently detected module type.

Examples

Basic Movement

Pick and Place

Automated Test Positioning

Error Handling

Supported Hardware

Exceptions

Notes

  • Always use the context manager (with statement) to ensure proper cleanup
  • The arm must be homed before accurate movements
  • Movement timeout errors may indicate obstructions or out-of-bounds coordinates
  • Joint angles (a, b, c) are in the arm’s internal coordinate system
  • Default tolerance for position verification is 0.5mm
  • The arm auto-detects via USB VID/PID (0x0483:0x5740)