Skip to content
Merged
Show file tree
Hide file tree
Changes from 2 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion ur_robot_driver/doc/dashboard_client.rst
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
.. _dashboard_client:
.. _dashboard_client_ros2:

Dashboard client
================
Expand Down
67 changes: 0 additions & 67 deletions ur_robot_driver/doc/installation/install_urcap_cb3.rst

This file was deleted.

66 changes: 0 additions & 66 deletions ur_robot_driver/doc/installation/install_urcap_e_series.rst

This file was deleted.

95 changes: 4 additions & 91 deletions ur_robot_driver/doc/installation/robot_setup.rst
Original file line number Diff line number Diff line change
@@ -1,98 +1,11 @@
.. _robot_setup:

Setting up a UR robot for ur_robot_driver
=========================================

Network setup
-------------

There are many possible ways to connect a UR robot. This section describes a good example using static IP addresses and a direct connection from the PC to the Robot to minimize latency introduced by network hardware. Though a good network switch usually works fine, as well.


#.
Connect the UR control box directly to the remote PC with an ethernet cable.

#.
Open the network settings from the UR teach pendant (Setup Robot -> Network) and enter these settings:

.. code-block::

IP address: 192.168.1.102
Subnet mask: 255.255.255.0
Default gateway: 192.168.1.1
Preferred DNS server: 192.168.1.1
Alternative DNS server: 0.0.0.0

* Enable remote control (Not applicable on PolyScope X versions)
#. Go to the hamburger menu -> settings.
#. Go to System -> Remote control.
#. Unlock the menu using the admin password, and enable Remote Control.
#. Press exit.
#. The robot can now be toggled between local and remote control in the upper right hand corner.

.. image:: initial_setup_images/remote_control.png
:width: 600
:alt: Screenshot showing remote control toggle.

* **If using PolyScope 5.10 or greater:**
#. Go to the hamburger menu -> settings.
#. Go to Security -> Services.
#. Unlock the menu using the admin password.
#. Enable the Dashboard Server (Not applicable on PolyScope X versions), Primary Client Interface, Secondary Client Interface and Real-Time Data Exchange (RTDE) interfaces.
#. Lock the menu and press exit.

* PolyScope 5 screen:

.. image:: initial_setup_images/services_polyscope5.png
:width: 600
:alt: Screenshot from PolyScope 5.xx services menu.

* PolyScope X screen:

.. image:: initial_setup_images/services_polyscopex.jpg
:width: 600
:alt: Screenshot from PolyScope X screen.

Remote PC Setup
~~~~~~~~~~~~~~~
#.
On the remote PC, turn off all network devices except the "wired connection", e.g. turn off wifi.

#.
Open Network Settings and create a new Wired connection with these settings. You may want to name this new connection ``UR`` or something similar:

.. code-block::

IPv4
Manual
Address: 192.168.1.101
Netmask: 255.255.255.0
Gateway: 192.168.1.1


#. Verify the connection from the PC with e.g. ping.

.. code-block::

ping 192.168.1.102

Prepare the robot
-----------------

This section describes installation and launching of the URCap program from the pendant. It allows ROS to control the robot externally. Generally, you will launch the driver via ROS then start URCap from the pendant.

For using the *ur_robot_driver* with a real robot you need to install the
**externalcontrol urcap**. The latest release can be downloaded from `its own repository <https://github.com/UniversalRobots/Universal_Robots_ExternalControl_URCap/releases>`_.

**Note**: For installing this URCap a minimal PolyScope version of 3.14.3 or 5.9.4 (in case of e-Series) is
necessary.

For installing the necessary URCap and creating a program, please see the individual tutorials on
how to :ref:`setup a cb3 robot <install-urcap-cb3>` or how to
:ref:`setup an e-Series robot <install-urcap-e-series>`.
Prepare robot and network connection
------------------------------------

To setup the tool communication on an e-Series robot, please consider the :ref:`tool communication setup
guide <setup-tool-communication>`.
Before you can use the ``ur_robot_driver`` you need to prepare the robot and the network
connection as described in the :ref:`robot_setup` and :ref:`network_setup` section of the UR Client Library documentation.

Prepare the ROS PC
------------------
Expand Down
3 changes: 0 additions & 3 deletions ur_robot_driver/doc/installation/toc.rst
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,3 @@ This chapter explains how to install the ``ur_robot_driver``

installation
robot_setup
install_urcap_cb3
install_urcap_e_series
ursim_docker
99 changes: 0 additions & 99 deletions ur_robot_driver/doc/installation/ursim_docker.rst

This file was deleted.

4 changes: 2 additions & 2 deletions ur_robot_driver/doc/operation_modes.rst
Original file line number Diff line number Diff line change
Expand Up @@ -17,8 +17,8 @@ E-series robots can operate in different command modes: It can be either in *loc
The remote control mode is needed for many aspects of this driver such as

- :ref:`headless_mode`
- :ref:`Sending script code to the robot<script_command_interface>`
- Many :ref:`dashboard<dashboard_client>` functionalities such as
- :ref:`Sending script code to the robot<script_command_interface_ros2>`
- Many :ref:`dashboard<dashboard_client_ros2>` functionalities such as

- restarting the robot after protective / EM-Stop
- powering on the robot and do brake release
Expand Down
2 changes: 1 addition & 1 deletion ur_robot_driver/doc/usage/script_code.rst
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
Sending URScript code to the robot
==================================

.. _script_command_interface:
.. _script_command_interface_ros2:

Custom URScript commands
------------------------
Expand Down
2 changes: 1 addition & 1 deletion ur_robot_driver/doc/usage/toc.rst
Original file line number Diff line number Diff line change
Expand Up @@ -111,7 +111,7 @@ On the e-Series the robot has to be in :ref:`remote control mode <operation_mode
Using the dashboard doesn't work
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

On the e-Series the robot has to be in :ref:`remote control mode <operation_modes>` to accept certain calls on the dashboard server. See :ref:`Available dashboard commands <dashboard_client>` for details.
On the e-Series the robot has to be in :ref:`remote control mode <operation_modes>` to accept certain calls on the dashboard server. See :ref:`Available dashboard commands <dashboard_client_ros2>` for details.

.. |play_button| image:: ../resources/play_button.svg
:height: 20px
Expand Down
Loading