Skip to content

The TUoS ROS Course Repo

A ROS Metapackage called tuos_ros has been put together to support these courses. This package is available on GitHub here. This repo contains the following ROS packages:

Package Name Description
tuos_examples Some example scripts to support certain exercises in COM2009 Assignment #1
tuos_interfaces Some custom ROS interfaces to support certain exercises in COM2009 Assignment #1
tuos_simulations Some Gazebo simulations to support certain exercises in COM2009 Assignment #1
tuos_tb3_tools Scripts that run on the real Waffles, and some RViz configs to support real robot work too
com2009_simulations Simulation resources to support your development work in COM2009 Assignment #2

Installing

The tuos_ros course repo is already installed and ready to go in WSL-ROS, for those who use it, and on the Robotics Laptops. To install the packages in your own local ROS installation, follow the steps here.

  1. Navigate to your ROS Workspace src directory:

    cd ~/ros2_ws/src/

  2. Clone the repo from GitHub:

    git clone -b humble https://github.com/tom-howard/tuos_ros.git

  3. Navigate back one directory, into the root* of the ROS workspace:

    cd ~/ros2_ws/

  4. Run colcon build to compile the packages:

    colcon build --packages-up-to tuos_ros

  5. Then re-source your .bashrc:

    source ~/.bashrc

Verify

Once you've installed it, then you can verify that the build process has worked using the following command:

colcon_cd tuos_ros

Which should take you to a directory within the repo that's also called tuos_ros, i.e.:

~/ros2_ws/src/tuos_ros/tuos_ros

Updating

The course repo may be updated every now and again, so its worth checking regularly that you have the most up-to-date version. You can do this by pulling down the latest updates from GitHub using git pull:

cd ~/ros2_ws/src/tuos_ros/ && git pull

If you see the following message:

-bash: cd: tuos_ros/: No such file or directory

... then go back and make sure you've installed the repo first!

Then, run colcon build and re-source your environment:

cd ~/ros2_ws && colcon build --packages-up-to tuos_ros && source ~/.bashrc