Software Installation Instructions

Welcome! Let's jump right in.

Robojackets IGVC currently supports the Ubuntu 18.04 and ROS-melodic environment. If you don't know what those are, don't worry! The project may build/run in other environments, but we can't guarantee it. Most of these instructions were gathered directly from ROS's installation guide.

Ok, lets get down to business.

Step 1. Get Terminator

Optional, but highly encouraged Forget the default Ubuntu terminal, we need both horizontal and vertical splits for productivity. Start up the default terminal and type:

sudo apt install terminator

Step 2. Setup your sources.list

Setup your computer to accept software from packages.ros.org.

sudo sh -c 'echo "deb http://packages.ros.org/ros/ubuntu $(lsb_release -sc) main" > /etc/apt/sources.list.d/ros-latest.list'

Step 3. Set up your keys

sudo apt-key adv --keyserver hkp://ha.pool.sks-keyservers.net:80 --recv-key 421C365BD9FF1F717815A3895523BAEEB01FA116

Step 4. Update your Debian packages

sudo apt update

Step 5. Install ROS

Install the full desktop version of ROS, which includes: ROS, rqt, rviz, robot-generic libraries, 2D/3D simulators and 2D/3D perception

sudo apt install ros-melodic-desktop-full

Step 6. Initialize rosdep

Before you can use ROS, you will need to initialize rosdep. rosdep enables you to easily install system dependencies for source you want to compile and is required to run some core components in ROS.

sudo rosdep init
rosdep update

Step 7. Environment setup

It's convenient if the ROS environment variables are automatically added to your bash session every time a new shell is launched:

echo "source /opt/ros/melodic/setup.bash" >> ~/.bashrc
source ~/.bashrc

Step 8. Initialize Catkin workspace

cd <path to where you want to keep the project>
mkdir catkin_ws; cd catkin_ws
mkdir src; cd src
catkin_init_workspace
cd ..
catkin_make

Step 9. Clone IGVC Repository

cd src
git clone --recursive https://github.com/RoboJackets/igvc-software.git

Step 10. Install Dependencies

cd ..
echo "source ~/catkin_ws/devel/setup.bash" >> ~/.bashrc
cd src/igvc-software
./install_dependencies.sh

Step 11. Build the Code

cd ../..
catkin_make