Setting Up and Running ROS

  1. Make sure linux is running, Ubuntu is probably best, but Debian might be fine. The Ubuntu version should be Trusty Tahr. If you want to install it from an ISO that has all the turtlebot software pre-installed, you can find the ISO here.
  2. Install ROS. Make sure the version you install is Kinetic, as that is the most recent LTS release. If you have problems contacting the keyserver, instead run the following command: wget https://raw.githubusercontent.com/ros/rosdistro/master/ros.key -O - | sudo apt-key add -
  3. Set up the environment: $ source /opt/ros/kinetic/setup.bash. You will have to do this everytime you start.
  4. Create a catkin workspace. Catkin is a program like 'make' that is used by ROS.
    $ mkdir -p ~/catkin_ws/src
    $ cd ~/catkin_ws/src
    $ catkin_init_workspace

    You use it like:
    $ cd ~/catkin_ws/
    $ catkin_make
  5. Check that the make created a local setup file: devel/setup.bash
  6. Customize install for the turtlebot. Add the following to the local setup.bash:
    export TURTLEBOT_BASE=kobuki
    export TURTLEBOT_STACKS=hexagons
    export TURTLEBOT_3D_SENSOR=asus_xtion_pro
    export TURTLEBOT_SERIAL_PORT=/dev/ttyUSB0
    export TURTLEBOT_BATTERY=/proc/acpi/battery/BAT1
    export TURTLEBOT_SIMULATION=false
    export TURTLEBOT_NAME=turtlebot
    export TURTLEBOT_TYPE=turtlebot
  7. Install the turtle bot software:
    sudo apt-get install ros-kinetic-turtlebot ros-kinetic-turtlebot-apps ros-kinetic-turtlebot-interactions ros-kinetic-turtlebot-simulator ros-kinetic-kobuki-ftdi ros-kinetic-rocon-remocon ros-kinetic-rocon-qt-library ros-kinetic-ar-track-alvar-msgs
  8. Add yourself to the dialout group: sudo adduser username dialout
  9. Source the local setup file:$ source devel/setup.bash. You may want to add the sourcing of the two setup files to your ~/.bashrc
  10. Try launching: roslaunch turtlebot_bringup minimal.launch --screen
  11. A set of tutorials can be found to here (click Kinetic on the page). Do the visualization and teleoperation tutorials.