Software Update v0.6.2 - RethinkRobotics/sdk-docs GitHub Wiki

Update Instructions for Baxter Research Robot: rsdk_0.6.2

This document provides instructions on updating the software on your Baxter Research Robot to 'rsdk_0.6.2'.

Note: These instructions are for updating from 0.6.1. If updating from version 0.6.0, you should follow the instructions at: Software Update - v0.6.1.

Prerequisites

You will need:

A Baxter Research Robot running 0.6.1
USB drive (FAT32 formatted, at least 500MB)
Update Files from the Rethink FTP
Development Workstation with the RSDK installed

Instructions

I. Download Update Files

Download the Update files from the Rethink FTP Service - Hosted~~FTP~~.
Your organization's Point-Of-Contact (POC) will receive an email notice, granting access to the new Update folder, and allowing them to create credentials upon first login. More Info
- From the 'Baxter Research Robot 0.6.2 Software' folder:
  Download the compressed gzip file: rethink-update-rsdk_0.6.2.tar.gz

Unzip the Update Files

$ mkdir updates
$ tar xvfz rethink-update-rsdk_0.6.2.tar.gz -C updates/
$ cd updates

Copy all the update files onto a USB flash drive

You may use a normal File Browser or any other method to copy the files onto a USB drive.
Make sure the USB flash drive is formatted as a FAT32 partition.

The files should all be placed in the top-level directory of the USB drive (i.e. not in a sub-folder).

#on the USB drive
$ ls 
rethink-update-0.6.2-obf
rethink-update-0.6.2-obf.config
rethink-update-0.6.2-obf.config.gpg

Safely eject the flash drive.

II. Setup and Check Version

Turn on Baxter.
Start an RSDK Shell on your development workstation.
Make sure you have edited the baxter.sh script file for your ROS_IP or ROS_HOSTNAME.
```
$ cd ~/ros_ws
$ ./baxter.sh
```
Check the Software Version
You can check the Software Version of your robot using the following command:
```
$ rosparam get /rethink/software_version
0.6.1
```
- If the version says 0.6.0 update to 0.6.1 first using these instructions: Software-Update - v0.6.1.

III. Run the Updater for Version 0.6.2

Allow robot to fully boot.
Plug the USB drive into the USB port on Baxter's torso.
Wait ~30 seconds for the system to recognize the drive.
(On Dev Workstation) Find the UUID for the Update Primer (Version 0.6.2) using the Software Update Tool:

Use the -l argument to the update_robot.py tool to list the available updates Baxter found on the USB drive.

$ rosrun baxter_tools update_robot.py -l
Version                       UUID
0.6.2                         e3790020-35db-11e3-bae4-e0cb4e8bae9f

Find the UUID for the Version '0.6.2' update. In this example, the UUID is e3790020-35db-11e3-bae4-e0cb4e8bae9f.

Start the Update, using the 0.6.2 Version.

Run the update_robot.py tool again, this time using the -u argument followed by the UUID found in the last step for Version 0.6.2.
```
$ rosrun baxter_tools update_robot.py -u e3790020-35db-11e3-bae4-e0cb4e8bae9f
```
This starts the verification and unpacking of the update payload. The status will be printed out as it goes through the required steps, ending in a notification that the robot system will reboot to finish updating.
NOTE: During this step, a bunch of text will scroll through on Baxter's screen. This is a good thing and shows that the update is progressing. Once finished, Baxter reboots to the new software and finalizes the update.

Confirm the New Software Version
```
$ rosparam get /rethink/software_version
0.6.2
```
You should see 0.6.2 reported back. Congratulations, you have updated your Baxter!

Problems after Reboot

Rebooting after an update can take a few minutes while the controller boards are flashed with new firmware. If you have any problems after reboot - such as the 'Halo' light on Baxter's head flashing Red, or the robot not fully booting with the Green light, even after a significant wait (~10 minutes) - you should try a hard power-cycle:

Hit the Power Button on Baxter's side to perform a full power-off shutdown of Baxter.
Once all the lights and fans are off and Baxter is completely shutdown, hit the Power Button again to turn Baxter back on.

#TODO: THIS NEEDS A REWRITE FOR 0.7

V. Updating the SDK on the Workstation (git repo)

Along with updating the software on the robot to version rsdk_0.6.2, you will want to update your Workstation-side SDK software from the git repository to the corresponding v0.6.2. To do this, follow the instructions for checking out a new tagged version, with tag v0.6.2: Installing the Research SDK bash $ cd sdk-examples $ git fetch $ git tag -l $ git checkout v0.6.2 $ ./init.sh <Baxter Hostname> [ROS Distro] $ rosmake baxter --pre-clean

FTP Access

Use the login credentials provided to your organization's Point-Of-Contact (POC). Updates to the Robot Software are distributed via the Rethink FTP Service - Hosted~~FTP~~. Your organization's Point-Of-Contact (POC) will receive an email, notifying them of the new update folder, and allowing them to sign-in using their email address. Note: When a new release occurs, POC's will be granted access to the Hosted~~FTP~~ via their email address. Credentials are created upon first sign-in.

Troubleshooting

For common issues specific to using software update with Baxter, check out the Troubleshooting page.