Configure a UR5e Arm

Configure a ur5e arm to add a Universal Robots UR5e to your machine:

Navigate to the Config tab of your machine’s page in the Viam app. Click on the Components subtab and click Create component. Select the arm type, then select the ur5e model. Enter a name for your arm and click Create.

Web UI configuration panel for an arm of model ur5e in the Viam app, with Attributes & Depends On dropdowns and the option to add a frame.

Edit and fill in the attributes as applicable.

{
  "components": [
    {
      "name": "<your-arm-name>",
      "model": "ur5e",
      "type": "arm",
      "namespace": "rdk",
      "attributes": {
        "speed_degs_per_sec": <float>,
        "host": "<your-host-address>"
      },
      "depends_on": []
    }
  ]
}
{
  "components": [
    {
      "name": "my-arm",
      "model": "ur5e",
      "type": "arm",
      "namespace": "rdk",
      "attributes": {
        "speed_degs_per_sec": 30,
        "host": "10.1.10.82"
      },
      "depends_on": []
    }
  ]
}

The following attributes are available for ur5e arms:

AttributeTypeInclusionDescription
speed_degs_per_secfloatRequiredDesired maximum speed of joint movement in degrees per second. Must be between 3 and 180.
hoststringRequiredThe IP address of the arm’s system on your network. Find this when setting up your UR5e.

Test the arm

Once your arm is configured and connected, go to the Control tab and click on the arm’s dropdown panel.

Use the buttons to move the end position or the joints and check whether it moves as expected.

Arm control panel.

If the arm does not appear on the Control tab, or if you notice unexpected behavior, check your machine’s Logs tab for errors, and review the configuration.



Have questions, or want to meet other people working on robots? Join our Community Discord.

If you notice any issues with the documentation, feel free to file an issue or edit this file.