Installing the Research SDK

Prerequisites

• A developer workstation meeting the minimum system requirements is available for use.
• The developer workstation has been set up successfully with Ubuntu and ROS - instructions here.
• You have configured your Development Workstation to access Github. Instructions here.

Outcome of this step

• You have installed the Rethink RSDK on the Development Workstation.

Installing the Research SDK

1. Download and Install the dependencies

$ sudo apt-get install python-wstool python-rosdep

2. Create a new catkin workspace.

$ mkdir -p ~/ros_ws/src
$ cd ~/ros_ws/src

3. Download and Copy the rosinstall file to this root of your catkin ws using wstool.

$ wstool init .
$ wstool merge https://raw.github.com/RethinkRobotics/baxter/master/baxter_sdk.rosinstall
$ wstool update
$ cd ..

This pulls down the development branches from all of our repositories into your source directory.

4. Source ros setup if you haven't yet

$ source /opt/ros/groovy/setup.bash

5. Build and Install

$ catkin_make
$ catkin_make install

6. Use the baxter.sh script for proper environment setup

$ cp src/baxter/baxter.sh .

7. Open the baxter.sh script in an editor, and edit 'baxter_hostname' and 'your_ip' OR 'your_hostname' variables:

# Specify Baxter's hostname
**baxter_hostname="baxter_hostname.local"**

# Set *Either* your computers ip address or hostname. Please note if using
# your_hostname that this must be resolvable to Baxter.
**your_ip="192.168.XXX.XXX"**
#your_hostname="my_computer.local"

Where 'baxter_hostname' is the hostname of your robot and 'your_ip' is the ip address of your development workstation. You may alternatively choose to use the hostname of your development machine but only if baxter can resolve the development machine hostname. Using both ip and hostname is not allowed so pick one method or the other and comment out the other line in the script using the '#' as leading character.

8. Init your sdk environment

$ ./baxter.sh

#REWRITE, NEED A CHECK ON ALL REPO TAGS?? SCRIPT? MANUAL? #Things to check or verify

• Make sure you have the proper tag which is currently v0.7.0

  $ git tag -l
  
  $ git checkout v0.7.0

• **Note: if the development workstation hostname is not resolvable to an IP address from the robot, then you will have to ensure the ROS_IP environment variable is set. Use the 'env' command to see what environment variables were set as a result of the running the baxter.sh script above and ensure that ROS_IP and/or ROS_HOSTNAME are set properly.

  $ env

Use 'ifconfig' to get your development workstation's IP address.**

Next Steps

Baxter Research Robot Hardware Installation Guide