Difference between revisions of "IGVC Software Installation Instructions"
Jump to navigation
Jump to search
(Updated "Run the Code" section to point back to github repo README, added recursive on clone.) |
|||
| Line 17: | Line 17: | ||
<div style="background:#eee; border:1px solid #ccc; padding:5px 10px"><span style="font-family:courier new,courier,monospace"></span> | <div style="background:#eee; border:1px solid #ccc; padding:5px 10px"><span style="font-family:courier new,courier,monospace"></span> | ||
sudo sh -c 'echo "deb http://packages.ros.org/ros/ubuntu $(lsb_release -sc) main" > /etc/apt/sources.list.d/ros-latest.list' | sudo sh -c 'echo "deb http://packages.ros.org/ros/ubuntu $(lsb_release -sc) main" > /etc/apt/sources.list.d/ros-latest.list' | ||
| − | + | </div> | |
== Step 3 - Set up your keys == | == Step 3 - Set up your keys == | ||
<div style="background:#eee; border:1px solid #ccc; padding:5px 10px">sudo apt-key adv --keyserver 'hkp://keyserver.ubuntu.com:80' --recv-key C1CF6E31E6BADE8868B172B4F42ED6FBAB17C654 | <div style="background:#eee; border:1px solid #ccc; padding:5px 10px">sudo apt-key adv --keyserver 'hkp://keyserver.ubuntu.com:80' --recv-key C1CF6E31E6BADE8868B172B4F42ED6FBAB17C654 | ||
| Line 37: | Line 37: | ||
== Step 9 - Clone IGVC Repository == | == Step 9 - Clone IGVC Repository == | ||
| − | + | <div style="line-height: 20.8px; border: 1px solid rgb(204, 204, 204); padding: 5px 10px; background: rgb(238, 238, 238);"><span style="font-family:courier new,courier,monospace;">cd src</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="font-family:courier new,courier,monospace;"><span style="line-height: 20.8px;">git clone https://github.com/RoboJackets/igvc-software --recursive</span></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="font-family:courier new,courier,monospace;">cd src</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="font-family:courier new,courier,monospace;"><span style="line-height: 20.8px;">git clone | ||
== Step 10 - Install ROS Dependencies == | == Step 10 - Install ROS Dependencies == | ||
<div style="line-height: 20.8px; border: 1px solid rgb(204, 204, 204); padding: 5px 10px; background: rgb(238, 238, 238);"><font face="courier new, courier, monospace">cd ..</font></div><div style="line-height: 20.8px; border: 1px solid rgb(204, 204, 204); padding: 5px 10px; background: rgb(238, 238, 238);"><span style="font-family:courier new,courier,monospace;">echo "source ~/catkin_ws/devel/setup.bash" >> ~/.bashrc</span> | <div style="line-height: 20.8px; border: 1px solid rgb(204, 204, 204); padding: 5px 10px; background: rgb(238, 238, 238);"><font face="courier new, courier, monospace">cd ..</font></div><div style="line-height: 20.8px; border: 1px solid rgb(204, 204, 204); padding: 5px 10px; background: rgb(238, 238, 238);"><span style="font-family:courier new,courier,monospace;">echo "source ~/catkin_ws/devel/setup.bash" >> ~/.bashrc</span> | ||
| Line 50: | Line 49: | ||
== Step 12 - Run the Code == | == Step 12 - Run the Code == | ||
| − | + | Refer back to the README of https://github.com/RoboJackets/igvc-software for instructions on running the code | |
| − | |||
Revision as of 21:10, 3 September 2019
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.
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 melodic
- 6 Step 6 - Initialize rosdep
- 7 Step 7 - Environment Variable Setup
- 8 Step 8 - Initialize catkin workspace
- 9 Step 9 - Clone IGVC Repository
- 10 Step 10 - Install ROS Dependencies
- 11 Step 11 - Build the Code
- 12 Step 12 - Run the Code
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 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://keyserver.ubuntu.com:80' --recv-key C1CF6E31E6BADE8868B172B4F42ED6FBAB17C654
Step 4 - Update your Debian packages
sudo apt update
Step 5 - Get Ros melodic
sudo apt install ros-melodic-desktop-full
Step 6 - Initialize rosdep
sudo rosdep init
rosdep update
Step 7 - Environment Variable Setup
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
- 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 9 - Clone IGVC Repository
cd src
git clone https://github.com/RoboJackets/igvc-software --recursive
Step 10 - Install ROS Dependencies
cd ..
echo "source ~/catkin_ws/devel/setup.bash" >> ~/.bashrc
rosdep install --from-path src --ignore-src -y
- 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 11 - 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 12 - Run the Code
Refer back to the README of https://github.com/RoboJackets/igvc-software for instructions on running the code
