Difference between revisions of "IGVC Software Installation Instructions"
Jump to navigation
Jump to search
| Line 10: | Line 10: | ||
Forget the default Ubuntu terminal, we need both horizont and vertical splits for productive activity. Start up the default terminal and type: | Forget the default Ubuntu terminal, we need both horizont and vertical splits for productive activity. Start up the default terminal and type: | ||
| − | <div style="background:#eee; | + | <div style="background:#eee; border:1px solid #ccc; padding:5px 10px"><span style="font-family:courier new,courier,monospace">sudo apt-get install terminator</span><br/></div> |
You should now be using this from now on, it will help later, | You should now be using this from now on, it will help later, | ||
| Line 16: | Line 16: | ||
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: | 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: | ||
| − | <div style="background:#eee; | + | <div style="background:#eee; border:1px solid #ccc; padding:5px 10px"><span style="font-family:courier new,courier,monospace">sudo sh -c 'echo "deb [http://packages.ros.org/ros/ubuntu http://packages.ros.org/ros/ubuntu] $(lsb_release -sc) main" > /etc/apt/sources.list.d/ros-latest.list'</span><br/></div> |
== Step 3 - Set up your keys == | == Step 3 - Set up your keys == | ||
| − | <div style="background:#eee; | + | <div style="background:#eee; border:1px solid #ccc; padding:5px 10px"><span style="font-family:courier new,courier,monospace">sudo apt-key adv --keyserver hkp://pool.sks-keyservers.net --recv-key 0xB01FA116</span><br/></div> |
== Step 4 - Update your Debian packages == | == Step 4 - Update your Debian packages == | ||
| − | <div style="background:#eee; | + | <div style="background:#eee; border:1px solid #ccc; padding:5px 10px"><span style="font-family:courier new,courier,monospace">sudo apt-get update</span><br/></div> |
== Step 5 - Get Ros Indigo == | == Step 5 - Get Ros Indigo == | ||
<div style="background:#eee; border:1px solid #ccc; padding:5px 10px"><span style="font-family:courier new,courier,monospace">sudo apt-get install ros-indigo-desktop</span><br/></div> | <div style="background:#eee; border:1px solid #ccc; padding:5px 10px"><span style="font-family:courier new,courier,monospace">sudo apt-get install ros-indigo-desktop</span><br/></div> | ||
| Line 27: | Line 27: | ||
== Step 7 - Environment Variable Setup == | == Step 7 - Environment Variable Setup == | ||
<div style="background:#eee; border:1px solid #ccc; padding:5px 10px">echo "source /opt/ros/indigo/setup.bash" >> ~/.bashrc<br/></div><div style="background:#eee; border:1px solid #ccc; padding:5px 10px">source ~/.bashrc<br/></div> | <div style="background:#eee; border:1px solid #ccc; padding:5px 10px">echo "source /opt/ros/indigo/setup.bash" >> ~/.bashrc<br/></div><div style="background:#eee; border:1px solid #ccc; padding:5px 10px">source ~/.bashrc<br/></div> | ||
| + | == Step 8 - Install QT Dependency == | ||
| + | <div style="line-height: 20.8px; border: 1px solid rgb(204, 204, 204); padding: 5px 10px; background: rgb(238, 238, 238);">sudo apt-get install qtbase5-dev<br/></div> | ||
| + | == Step 9 - Install Flycature SDK == | ||
| + | |||
| + | *Aquire Flycapture2 SDK version 2.8.3.1 from owncloud or elsewhere and extract to desktop | ||
| + | <div style="line-height: 20.8px; border: 1px solid rgb(204, 204, 204); padding: 5px 10px; background: rgb(238, 238, 238);">cd <path to extracted folder></div><div style="line-height: 20.8px; border: 1px solid rgb(204, 204, 204); padding: 5px 10px; background: rgb(238, 238, 238);"><span style="line-height: 20.8px; background-color: rgb(238, 238, 238);">sudo ./install_flycapture.sh</span><br/></div> | ||
| + | * This will probably fail because it is missing some dependencies which you will need to install via "sudo apt-get <dependency name>" | ||
| + | *Rerun "sudo ./install_flycapture.sh" | ||
| + | |||
| + | == Step 10 - Initialize catkin workspace == | ||
| + | <div style="line-height: 20.8px; border: 1px solid rgb(204, 204, 204); padding: 5px 10px; background: rgb(238, 238, 238);">cd <path to where you want to keep the project></div><div style="line-height: 20.8px; border: 1px solid rgb(204, 204, 204); padding: 5px 10px; background: rgb(238, 238, 238);">mkdir <name of root folder of project i.e. "catkin_ws" or "igvc"</div><div style="line-height: 20.8px; border: 1px solid rgb(204, 204, 204); padding: 5px 10px; background: rgb(238, 238, 238);"><span style="line-height: 20.8px;">cd <name of folder></span></div><div style="line-height: 20.8px; border: 1px solid rgb(204, 204, 204); padding: 5px 10px; background: rgb(238, 238, 238);"><span style="line-height: 20.8px;">mkdir src</span><br/></div><div style="line-height: 20.8px; border: 1px solid rgb(204, 204, 204); padding: 5px 10px; background: rgb(238, 238, 238);"><span style="line-height: 20.8px;">cd src</span><br/></div><div style="line-height: 20.8px; border: 1px solid rgb(204, 204, 204); padding: 5px 10px; background: rgb(238, 238, 238);"><span style="line-height: 20.8px;">init_catkin_workspace</span><br/></div><div style="line-height: 20.8px; border: 1px solid rgb(204, 204, 204); padding: 5px 10px; background: rgb(238, 238, 238);"><span style="line-height: 20.8px;">cd ..</span><br/></div><div style="line-height: 20.8px; border: 1px solid rgb(204, 204, 204); padding: 5px 10px; background: rgb(238, 238, 238);"><span style="line-height: 20.8px;">catkin_make</span><br/></div> | ||
| + | * | ||
| + | Command should complete and not really do anything | ||
| + | |||
| + | * | ||
| + | If init_catkin_workspace failed then ROS did not install correctly | ||
| + | |||
| + | == Step 11 - Clone IGVC Repository == | ||
| + | |||
| + | *Fork IGVC Github Repository | ||
| + | <div style="line-height: 20.8px; border: 1px solid rgb(204, 204, 204); padding: 5px 10px; background: rgb(238, 238, 238);">cd src</div><div style="line-height: 20.8px; border: 1px solid rgb(204, 204, 204); padding: 5px 10px; background: rgb(238, 238, 238);"><span style="line-height: 20.8px;">git clone <your fork></span></div> | ||
| + | == Step 12 - Build the Code == | ||
| + | <div style="line-height: 20.8px; border: 1px solid rgb(204, 204, 204); padding: 5px 10px; background: rgb(238, 238, 238);">cd ..</div><div style="line-height: 20.8px; border: 1px solid rgb(204, 204, 204); padding: 5px 10px; background: rgb(238, 238, 238);">catkin_make</div> | ||
| + | *If this fails the first time try running catkin_make again, if it continues to fail then something went wrong | ||
| + | |||
| + | == Step 13 - Run the Code == | ||
| + | <div style="line-height: 20.8px; border: 1px solid rgb(204, 204, 204); padding: 5px 10px; background: rgb(238, 238, 238);">source devel/setup.sh</div><div style="line-height: 20.8px; border: 1px solid rgb(204, 204, 204); padding: 5px 10px; background: rgb(238, 238, 238);">''In a separate terminal ''roscore</div><div style="line-height: 20.8px; border: 1px solid rgb(204, 204, 204); padding: 5px 10px; background: rgb(238, 238, 238);"><span style="line-height: 20.8px;">''In a terminal that isn't running roscore ''roslaunch igvc igvc.launch</span></div> | ||
| + | * 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 | ||
Revision as of 17:15, 13 September 2015
Welcome! Let's jump right in.
Robojackets IGVC currently supports the Ubuntu 14.04 and ROS-indigo 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.
Contents
- 1 Step 1 - Get Terminator
- 2 Step 2 - Set up your sources.list
- 3 Step 3 - Set up your keys
- 4 Step 4 - Update your Debian packages
- 5 Step 5 - Get Ros Indigo
- 6 Step 6 - Initialize rosdep
- 7 Step 7 - Environment Variable Setup
- 8 Step 8 - Install QT Dependency
- 9 Step 9 - Install Flycature SDK
- 10 Step 10 - Initialize catkin workspace
- 11 Step 11 - Clone IGVC Repository
- 12 Step 12 - Build the Code
- 13 Step 13 - Run the Code
Step 1 - Get Terminator
Forget the default Ubuntu terminal, we need both horizont 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://pool.sks-keyservers.net --recv-key 0xB01FA116
Step 4 - Update your Debian packages
sudo apt-get update
Step 5 - Get Ros Indigo
sudo apt-get install ros-indigo-desktop
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 owncloud or elsewhere 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-get <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
init_catkin_workspace
cd ..
catkin_make
Command should complete and not really do anything
If init_catkin_workspace failed then ROS did not install correctly
Step 11 - Clone IGVC Repository
- Fork IGVC Github Repository
cd src
git clone <your fork>
Step 12 - Build the Code
cd ..
catkin_make
- If this fails the first time try running catkin_make again, if it continues to fail then something went wrong
Step 13 - Run the Code
source devel/setup.sh
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
