Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

improve docs around usage of extracted calibration info #1214

Merged
merged 3 commits into from
Dec 20, 2024
Merged
Show file tree
Hide file tree
Changes from 1 commit
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
9 changes: 6 additions & 3 deletions ur_robot_driver/doc/installation/robot_setup.rst
Original file line number Diff line number Diff line change
Expand Up @@ -69,11 +69,11 @@ Prepare the ROS PC
For using the driver make sure it is installed (either by the debian package or built from source
inside a colcon workspace).

.. _calibration_extraction:

Extract calibration information
-------------------------------

.. _calibration_extraction:

Each UR robot is calibrated inside the factory giving exact forward and inverse kinematics. To also
make use of this in ROS, you first have to extract the calibration information from the robot.

Expand All @@ -88,4 +88,7 @@ For this, there exists a helper script:
robot_ip:=<robot_ip> target_filename:="${HOME}/my_robot_calibration.yaml"

For the parameter ``robot_ip`` insert the IP address on which the ROS pc can reach the robot. As
``target_filename`` provide an absolute path where the result will be saved to.
``target_filename`` provide an absolute path where the result will be saved to. The robot must be
powered on (can be idle) before executing this script.

See :ref:`ur_robot_driver_startup` for instructions on using the extracted calibration information.
18 changes: 18 additions & 0 deletions ur_robot_driver/doc/usage/startup.rst
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,7 @@ Allowed ``ur_type`` strings: ``ur3``, ``ur3e``, ``ur5``, ``ur5e``, ``ur10``, ``u
Other important arguments are:


* ``kinematics_params_file`` (default: *None*) - Path to the calibration file extracted from the robot, as described in :ref:`calibration_extraction`.
* ``use_mock_hardware`` (default: *false* ) - Use simple hardware emulator from ros2_control. Useful for testing launch files, descriptions, etc.
* ``headless_mode`` (default: *false*) - Start driver in :ref:`headless_mode`.
* ``launch_rviz`` (default: *true*) - Start RViz together with the driver.
Expand Down Expand Up @@ -72,6 +73,23 @@ Depending on the :ref:`robot control mode<operation_modes>` do the following:

.. _continuation_after_interruptions:

Verify calibration info is being used correctly
urfeex marked this conversation as resolved.
Show resolved Hide resolved
-----------------------------------------------

.. _verify_calibration:

If you passed a path to extracted calibration via the *kinematics_params_file*
parameter, verify that the checksum of the loaded calibration matches that of your extracted
calibration. Search for the term *checksum* in the console output after launching the driver,
and you should see:

.. code-block:: console

$ [INFO] [1694437690.406932381] [URPositionHardwareInterface]: Calibration checksum: 'calib_xxxxxxxxxxxxxxxxxxx'

Verify that the printed checksum matches that on the final line of your extracted calibration file.


Continuation after interruptions
--------------------------------

Expand Down
Loading