# Connect UR to Wandelbots NOVA > Learn how to connect Universal Robots cobots to Wandelbots NOVA. Follow step-by-step setup instructions, safety guidelines, and supported controller requirements for reliable integration. > **Info:** Wandelbots NOVA includes a real-time kernel and `robot-realtime` tuned profile by default to ensure stable robot control and meet timing requirements. Using a UR with Wandelbots NOVA offers a wide range of possibilities for automating your production processes. There are 3 things you need to know before you start: Which UR controller types and models are supported by Wandelbots NOVA? [Supported models](#supported-models) Wandelbots NOVA provides you with virtual controllers for path planning, app development and simulation purposes. [Use virtual controller](#use-virtual-controller) You can connect your UR controller to Wandelbots NOVA for real-world automation. [Set up and connect UR controller](#set-up-and-connect-ur-controller) ### Controllers | Controller | Supports | Requirements | | - | - | - | | Control Box | cobot | Firmware: PolyScope >= 3.15.0 | | Control Box e-Series | cobot | Firmware: PolyScope 5.11 to 5.19 | ### Motion groups #### Robotic arms **Cobots** | Robot arm | Controller | | - | - | | UR10 CB | Control Box | | UR10e | Control Box e-Series | | UR12e | Control Box e-Series | | UR15 | Control Box | | UR16e | Control Box e-Series | | UR20e | Control Box e-Series | | UR3e | Control Box e-Series | | UR5 CB | Control Box | | UR5e | Control Box e-Series | | UR7e | Control Box e-Series | ## Use virtual controller ### Step 1: Open the home screen Open your cloud instance via NOVA Cloud or type in your physical instance's/virtual instance's IP address to access the home screen. Get an overview on the home screen and its functionalities [here](/nova/26.7/architecture). ### Step 2: Create a cell in Setup Open Setup and go to the `Cell` tab. ### Step 3: Add robot to your cell If you want to start using the Wandelbots API, do so now and [add a robot via the Wandelbots NOVA API](/nova/26.7/nova-api/overview#add-a-robot-to-the-cell). OR add a robot to your cell in Setup: 1. Open the `Robots` tab. → The robot overview is displayed. 2. Click [Add] to add a robot to your cell.\ → A drawer opens guiding you through adding a robot. If the [Add] button is greyed out, your license might not support adding more robots. Please contact your administrator. 3. Select the robot type `Virtual`. → The drawer updates to display options for adding a virtual robot. > **Info:** Adding a physical robot will only work after [successful setup](#set-up-and-connect-ur-controller). 4. Name the robot. 5. Select `UR` as manufacturer. 6. Select the desired robot model. 7. `Add` the robot to the cell. → A progress indicator is displayed while the robot is being added to the cell. → The robot is displayed in the cell overview. ### Step 4: Add a TCP To replicate a physical robot's behavior accurately, you can define TCPs for virtual robots in the Setup app. 1. Click on the robot. → A drawer opens displaying the robot details. 2. Open the `TCP` tab. → The TCP tab displays all existing TCPs of the robot. → For physical robots, the TCP tab presents an overview on all existing TCPs on the physical robot controller. You cannot add TCPs for physical robot controllers in Setup as these need to be configured on the robot controller. 3. Use [Add] to add a new TCP. → Options to add a new TCP are displayed. 4. Define the TCP's translation and rotation relative to the robot's flange. 5. Save the new TCP. → The new TCP is displayed in the TCP tab and can be selected in Robot Pad. Congrats! You can now start to plan paths and simulate! Open Robot Pad from the home screen of your instance and get started ✨. ## Set up and connect UR controller Cloud instances are not suited to control a physical robot and you need to use a VM or use an IPC instead. More information on available NOVA instance types [here](/nova/26.7/installation/installation#instance-types). ### About setup instructions The provided setup instructions do not replace a thorough understanding of the robot manufacturer's original operating instruction and only apply to the supported models mentioned above. The setup instructions include the following steps: 1. Preparing the robot for the connection with Wandelbots NOVA. 2. Physically connecting the IPC to the robot controller. 3. Configuring the IPC to establish communication with the robot controller. 4. Using the UR controller on Wandelbots NOVA. 5. Troubleshooting common issues that may arise during the setup process. In order to connect the UR controller to Wandelbots NOVA, Wandelbots NOVA needs to be integrated into the robotic cell according to these [cell designs](/nova/26.7/setup/cell-design). Ensure that the UR controller you're about to connect to Wandelbots NOVA is listed in the [supported models](#supported-models) section. Note that setting a correct mounting pose in the robot controller is crucial, especially for cobots, as they are sensitive to gravity direction. ### Qualified user groups Preparing a controller for the use of Wandelbots NOVA is a task that requires a certain level of expertise. The following instructions are intended for qualified user groups only. > **⚠️ CAUTION:** **Danger in case of insufficient qualification of users** > > People can be injured if unqualified user groups set up the physical robot environment. > > - Only qualified user groups designated by the operating company may set up the physical robot environment. > - Keep unqualified user groups away from the area of risk. If a high experience level, e.g. admin user, is recommended to complete the step, the following label will be displayed next to the header: [Admin] ### Step 1: Prepare UR [Admin] ### Step 2: Install URCaps To use Wandelbots NOVA, you need to install a custom URCaps file on the UR controller. > **Info:** As the Wandelbots NOVA URCaps file relies on the default UR root password for communication, > the installation of the URCaps file has to be done manually for UR controllers running PolyScope 5.22 or greater, > as these versions require a custom root password to be set up during the initial robot setup. > This is a requirement that is currently not supported by Wandelbots NOVA. 1. Ensure that the UR controller and the machine you're using are connected to the same network. 2. Ping the robot controller's IP address to check that it is reachable.\ If the ping fails, check the network connection and the robot controller's IP address. 3. Download the custom Wandelbots URCaps file from [Downloads](/nova-cloud/downloads) in NOVA Cloud. > **Info:** The URCaps file is named `UniversalRobotsServer-[version].jar`. > To find out which URCaps version is compatible with your Wandelbots NOVA version, refer to the [Compatibility section](/nova/26.7/compatibility#with-custom-files-for-robot-setups). 4. Upload the file to the robot controller. **Linux** Change into the folder where the file, e.g., `UniversalRobotsServer-1.6.0.jar`, is located, then run: ```bash scp UniversalRobotsServer-1.6.0.jar root@192.168.0.72:~/.urcaps/ # replace the IP address with the robot controller's IP ``` **Windows** Use PuTTY to connect via SSH to the UR controller. Then use PuTTY Secure Copy Client to copy the file, e.g., `UniversalRobotsServer-1.6.0.jar`, onto the UR controller: ```powershell pscp UniversalRobotsServer-1.6.0.jar root@192.168.1.1:.urcaps # replace the IP address with the robot controller's IP ``` 5. Reboot the UR controller.\ → The URCaps file is now installed. #### Configure network settings _Using the original robot control panel_ 1. Turn on robot controller according to the robot manufacturer's original operating instructions. 2. Set robot to local mode. 3. Open main menu. 4. Open settings. 5. Select System > Network > `Static address`. 6. Enter the robot controller's IP address, e.g. 192.168.1.100, into the `IP address` field. This IP address has to be within the same subnet as the IPC's IP address but can otherwise be set as desired. 7. Enter the subnet mask 255.255.255.0.\ This ensures that the robot controller and the IPC are in the same subnet. 8. Confirm settings. #### Activate remote control _Using the original robot control panel_ 1. Turn on robot controller according to the robot manufacturer's original operating instructions. 2. Open main menu > system settings. 3. Select System > Remote Control. 4. Activate Remote Control. 5. Switch to Remote Control in the home screen.\ → Remote Control connection will now be established. This can take a few minutes. → Upon successful remote control connection, the robot controller is rebooted and URCaps installed. > **Info:** While unlikely, the robot may [lock up unexpectedly and need to be restarted](#did-i-damage-the-ur-robot-during-setup) for further use. → The robot controller was successfully set up for Wandelbots NOVA. #### Configure payload and TCP To enable maximum acceleration and speed in path planning, the payload and TCP have to be correctly configured on the robot controller. Configure the payload and TCP on the UR [with this tutorial](https://www.youtube.com/watch?v=YnC-ccytJlw). ### Step 3: Connect IPC to robot controller [Admin] 1. Connect an ethernet cable to the IPC's LAN-1 port. 2. Connect the IPC to the robot controller's network port. 3. Turn on the IPC. ### Step 4: Configure IPC's network settings 1. Open `https://:9090`, e.g. `https://172.345.538.2:9090`, in a browser on your personal computer.\ If the IPC is not connected to the same network as your personal computer, you can connect a keyboard, a mouse and a display to the IPC. Then open `localhost:9090` in a web browser. > **Warning:** Only one personal computer is allowed to connect to the instance's IP address. > In case multiple personal computers control a physical robot, e.g. via API and the RobotPad, simultaneously, the robot will not move. > > - Close all applications on other personal computers and try again. > - Unplug the robot's ethernet cable from the physical instance and wait a couple of minutes to restart Wandelbots NOVA foundation services. Plug it into the LAN port again and try again. 2. Log in with the user credentials created during the Wandelbots NOVA installation.\ → The IPC's settings are displayed. → A popup prompts you to enable administrative access. 3. Enable administrative access and enter the admin password. 4. Select the Network tab in the sidebar.\ → The IPC's network settings are displayed. 5. Toggle the button next to the `enp3s0` port (corresponding to the IPC's LAN-1 port) to enable network activity. 6. Click `edit` next to the IPv4.\ → The IPv4 menu opens. 7. Set the address dropdown to `Manual`. 8. Create an IP address that is in the same subnet as the robot's IP address (255.255.255.0), e.g. 172.345.**255**.2. 9. Set the prefix to 255.255.255.0 (will automatically change to 24). 10. Delete the prefilled gateway value. 11. Save the settings.\ → Wandelbots NOVA can now connect to the robot. ### Step 5: Use UR controller on NOVA 1. Type in your physical instance's IP address to access the home screen. → The home screen is displayed. 2. Open Setup and go to the `Cell` tab. → The cell overview is displayed. 3. Open the `Robots` tab. → The robot overview is displayed. 4. Click [Add] to add a robot to your cell.\ → A drawer opens guiding you through adding a robot. If the [Add] button is greyed out, your license might not support adding more robots. Please contact your administrator. 5. Select the robot type `Physical`. → The drawer updates to display options for adding a physical robot. 6. Name the robot. 7. Select `UR` as manufacturer. 8. Enter the robot's IP address or host name. > **Info:** Ensure that the UR's control mode is set to Remote Control. More information in the original manufacturer's user manual. 9. Click on `Add`. → A progress indicator is displayed while the robot is being added to the cell. → The robot is displayed in the cell overview. 10. Activate Motion Groups using `post /cells/{cell}/motion-groups/all` to set the robot as active. Can also be done in Robot Pad by using the switch in the task bar. #### TCPs To use TCPs for connected physical controllers on NOVA, you need to set them up on the robot controller first. Refer to the original Universal Robots documentation on [how to set up TCPs on the robot controller](https://www.universal-robots.com/manuals/EN/HTML/SW5_24/Content/prod-usr-man/software/PolyScope/content/installation_g5/installation_TCP_configuration_en.htm). TCPs will then be displayed in the Setup app under the `TCPs` tab in the robot's settings and can be selected for path planning in Robot Pad. ## Troubleshooting ### Find the UR's IP address _Using the original robot control panel_ 1. Set robot to local mode. 2. Open the main menu. 3. Go to Settings > System > Network.\ → The controller's IP address corresponding to the network port is displayed. ### I can't connect the IPC to the robot controller Wandelbots NOVA can only communicate with UR, if the controller root password is `easybot`. Set the robot controller root password to `easybot` according to the robot manufacturer's original operating instructions. ### Connection from robot controller cannot be established. The UR is not moving. Option 1: The remote control is not activated on the robot controller. 1. Switch on remote control on the robot controller by using the original robot control panel. Option 2: The IPC's IP address is not within the same subnet as the robot controller. 1. Configure the robot controller's IP address and ensure that the IPC's IP address is part of the same subnet. [Wandelbots Customer Success](https://www.wandelbots.com/en/contact/) is happy to assist you with this. ### Did I damage the UR robot during setup? It is possible that while connecting NOVA to a robot, and after installing the URCaps, the robot could lock up. This can cause unexpected movement and sound when locking. 1. The robot is not damaged. Restart and continue as needed. ### Connection issues Resolve connection issues by referring to the [FAQ section on robot connectivity](/nova/26.7/faq#wandelbots-nova-instance-is-physically-connected-to-the-robot-but-the-robot-is-not-moving).