IGVC Software Installation Instructions

Welcome! Let's jump right in.

Robojackets IGVC currently supports the Ubuntu 16.04 and ROS-kinetic 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.

Ok, lets get down to business.

Step 1 - Get Terminator

Forget the default Ubuntu terminal, we need both horizontal and vertical splits for productive activity. Start up the default terminal and type:

sudo apt-get install terminator

You should now be using this from now on, it will help later,

Step 2 - Set up your sources.list

Now for these next steps you don't need to understand what they do, only make sure they complete properly. So if you see any errors come up, tell one of us immediately. Copy this into your terminal:

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 - Get Ros Indigo

sudo apt-get install ros-kinetic-desktop-full

Step 6 - Initialize rosdep

sudo rosdep init

rosdep update

Step 7 - Environment Variable Setup

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

source ~/.bashrc

 Step 8 - Install QT Dependency

sudo apt-get install qtbase5-dev

 Step 9 - Install Flycature SDK

• Aquire Flycapture2 SDK version 2.8.3.1 from robojackets owncloud or a team member and extract to desktop

cd <path to extracted folder>

sudo ./install_flycapture.sh

•  This will probably fail because it is missing some dependencies which you will need to install via "sudo apt install <dependency name>"
• Rerun "sudo ./install_flycapture.sh"

Step 10 - Initialize catkin workspace

cd <path to where you want to keep the project>

mkdir <name of root folder of project i.e. "catkin_ws" or "igvc"

cd <name of folder>

mkdir src

cd src

catkin_init_workspace

cd ..

catkin_make

• Command should complete and not really do anything
• If init_catkin_workspace failed then ROS did not install correctly and/or try "sudo apt-get update" which may fix the issue where catkin_init_workspace command can not be found

Step 11 - Clone IGVC Repository

• Fork IGVC Github Repository

cd src

git clone <your fork>

Step 12 - Install ROS Dependencies

cd ..

echo "source devel/setup.bash" >> ~/.bashrc

rosdep install igvc igvc_control igvc_description

• rosdep will download and install all of the necessary ros package dependencies, type "y" whenever it asks if it is ok to continue installation

Step 13 - Build the Code

catkin_make

• If this fails the first time try running catkin_make again
• If it continues to fail because it could not find some of the igvc_msgs header files, run "catkin_make igvc_msgs_gencpp" and then "catkin_make"

Step 14 - Run the Code

In a separate terminal roscore

In a terminal that isn't running roscore roslaunch igvc igvc.launch

•  The code should now be running and complaining about not being able to connect to various devices, this is all good and you are ready to start writing igvc code