Skip to content

Universal Robots Setup ​

SUMMARY

This guide walks through connecting a physical Universal Robots arm to Synapse over RTDE.

For supported models and specifications, see All Supported Manipulators.

Hardware Setup ​

Connect Ethernet cable from your PC to the UR controller ​

Configure your PC network on the same subnet as the controller with a static IPv4 address. ​

Set a static IP on the robot's subnet, e.g. robot 192.168.1.1 → PC 192.168.1.2, subnet mask 255.255.255.0, no gateway.

Verify connectivity with ping ​

bash
ping 192.168.1.1   # replace with your robot's IP

If the ping fails, work through these in order:

CheckAction
Physical linkConfirm cable seated, LAN port LEDs lit on the controller
Subnet matchPC and robot IPs share the first three octets
Robot IPRe-read Settings → System → Network on the pendant
Route hijackingDisable VPNs and virtual network adapters on the PC

Enable Remote Control on the teach pendant ​

Synapse drives the robot over RTDE, which requires the controller to be in Remote Control mode.

Verify the connection from Synapse ​

Replace the IP address below with your UR controller's address, then run the script in your SDK environment. A successful connection prints Connection successful.; connection errors are allowed to propagate so you can diagnose them.

python
from telekinesis.synapse.robots.manipulators import universal_robots

ip = "192.168.1.1"  # Replace with your UR controller IP.
robot = universal_robots.UniversalRobotsUR10E(name='UR10e')
robot.connect(ip=ip)
try:
    if not robot.is_connected():
        raise RuntimeError("The robot remained offline. Check the SDK connection logs.")
    print("Connection successful.")
finally:
    robot.disconnect()
Stuck on setup?
Ask on the Telekinesis Discord and we'll help you get connected.
Join Discord →