CS 354 Autonomous Robotics

This document outlines how to config a workstatiion with all the required software for CS 354 (Autonomous Robotics). This class will use ROS 2 on a Ubuntu/Linux environment. The ROS 2 version utilizied will be Dashing (which is NOT the most current version of ROS 2). Dashing requires that the OS be based on Ubuntu 18.04 (bionic) , which is cinnamon/tricia in Mint 19

Step 1: Install Ubuntu (via a virtual machine)

Unless you are running Ubuntu natively, you will need to install a virtual machine in order to host the Ubuntu operating system on your computer.

If you are running Windows 10, you can install VirtualBox by following these instructions. The instructors have tested this configuration running ROS and it performs acceptable.

If you are running Mac OS, the instructors highly recommend installing VMWare Fusion, which you can install by following these instructions.

Step 2: Installing ROS 2

Once you have a virtual machine running Mint 19.3 (Ubuntu 18.04), you will need to install ROS 2 by following these instructions.

Step 1: Installing ROS software

You can download the installROS2.sh script and place it on your virtual machine. You can run it by setting it to be execute using chmod and then running it: 

            chmod 700 installROS2.sh
            ./installROS2.sh
It will prompt you for your account password. This process takes about 10 to 15 minutes depending on your machine and the speed of your Internet connection.

Step 2: Configure ROS2

You can download the ros2_config_account.sh script and place it on your virtual machine. You can run it by setting it to be execute using chmod and then running it: 

            chmod 700 ros2_config_account.sh
            source ./ros2_config_account.sh
This process runs very fast and only needs to be run once.

Step 3: Testing your ROS2 environment

To test your ROS 2 configuration, you can open 2 terminals. In the first terminal, execute this command: 

            ros2 run demo_nodes_cpp talker
In the second window, run this command: 

           ros2 run demo_nodes_py listener
Some of these instructions and the example programs are from the ROS website (ros.org)