These tutorials have been superceded. Find the latest Ridgeback tutorials at docs.clearpathrobotics.com.
This package supplies Sphinx-based tutorial content to assist you with setting up and operating your Ridgeback mobile robot. The tutorials topics are listed in the left column, and presented in the suggested reading order.
These tutorials assume that you are comfortable working with ROS. We recommend starting with our ROS tutorial if you are not familiar with ROS already.
These tutorials specifically target Ridgeback robots running Ubuntu 20.04 with ROS Noetic, as it is the standard OS environment for Ridgeback. If instead you have an older Ridgeback robot running Ubuntu 18.04 with ROS Melodic, please follow this tutorial to upgrade its OS environment to Ubuntu 20.04 with ROS Noetic.
Simulation is a logical place for most users to start, as this is universally applicable; understanding how to effectively operate Ridgeback in simulation is valuable whether you are in the testing phase with software you intend to ultimately deploy on a real Ridgeback, or you do not have one and are simply exploring the platform’s capabilities.
Driving covers how to teleoperate Ridgeback using the remote control, a well as safety procedures for operating the real robot. Anyone working with a physical robot should be familiar with this section.
Navigation is a follow-on to what is learned in the simulation tutorial, as navigation and map-making may be run in the simulated environment. However, this content is applicable to both the simulator and the real platform, if equipped with a laser scanner.
The remainder of the subjects are more applicable to the real robot, and have to do with configuring, using, and maintaining the platform. If you are a lab administrator rather than direct platform user, you may wish to skip the introductory chapters and jump straight to these ones.
- Installing Ridgeback Software
- Setting Up Networking
- Pairing Controller
- Driving Ridgeback
- Simulating Ridgeback
- Navigating with Ridgeback
- Extending Ridgeback Startup
- Keeping Ridgeback Updated