View source for Firmware Upgrade

This page details how to upgrade the Fluke and Scribbler and Scribbler2 robots to use the latest Myro firmware, over Bluetooth. 

= Calico =

# Start Calico
# Switch to the Shell, using the Python language
# from firmwareupgrade import upgrade
# upgrade("fluke")
# upgrade("scribbler")

There are other, more advanced, functions for upgrading from a file, etc. See the code in Calico/languages/Python/modules/upgradefirmware/ folder.

= Stand-alone Upgrader =

This section details the upgrade.py program for upgrading the Fluke and Scribbler and Scribbler2 robots. The program starts up a graphical user interface by default (if available), but it can also be used as a command line program (see below for options).

This program requires that you have a version of regular [http://python.org Python] installed on your system (Calico Python won't work) ([[http://www.youtube.com/watch?v=anDLKu2a49g video: installing Python on Windows Machine]]). You also need to have [http://pyserial.sourceforge.net/ pySerial] installed ([[http://www.youtube.com/watch?v=76p7LhryMhw video: installing pyserial on windows machine]]). 

# Download [[Media:pyserial.zip]] and place the pyserial\pyserial-2.6\serial folder in the C:\Python*\Lib\ folder.
# Download [http://svn.cs.brynmawr.edu/viewvc/Myro/trunk/Upgrade/upgrade.py?view=co upgrade.py] and save to a known location.
# Double-click on the file (or use the Command Line Option, below) [[http://www.youtube.com/watch?v=yTUMIXI8pcE video: installing and using the Firmware upgrade tool under windows]]

'''NOTE''': you may have to kill the upgrade program via the Task Manager to get it to release the serial port. Otherwise, Myro won't be able to connect onto the serial port.

If you have a Fluke purchased before September 2011, you will need to upgrade the Fluke first:

# Select the Fluke option
# On Windows, enter the com port (eg, COM8); on Mac/Linux enter the device path (eg, /dev/tty.scribbler or /dev/rfcomm0)
# Click on the Upgrade button

After upgrading the Fluke, you can then upgrade the Scribbler.

# Select the Scribbler option
# On Windows, enter the com port (eg, COM8); on Mac/Linux enter the device path (eg, /dev/tty.scribbler or /dev/rfcomm0)
# Click on the Upgrade button

= Troubleshooting Problems =
* Windows: 
** Problem: When I double click on the upgrade.py file, I see a black window flash open and then close and nothing happens.
*** Path to a solution: From the start menu, choose run, and then type cmd and say OK. The black window will open. Now you need to navigate to the folder that has your upgrade.py file in it. Suppose you're in C:\Documents and Settings and your upgrade.py is in D:\foo\bar\  First, type d: (and hit enter) in the black window to change to your d drive. Then using the cd (change directory command) change to the folder where your upgrade.py is e.g. '''cd \foo\bar'''  and hit enter. Now, typing upgrade.py (and enter) will let you see the error message. Hopefully when you see the error message you can figure out what you need to do!

= Graphical User Interface =

[[Image:upgrader_image.jpg|thumb|300px|Stand alone upgrade tool]]

To use the upgrader, indicate what you want to upgrade (Fluke or Scribbler) by selecting the appropriate radio button. (Default: Scribbler).

Then, type in the name of your bluetooth serial port, such as "COM4" or "/dev/tty.scribbler" (without quotes).

Make sure you are connected to the Internet so that the tool can download the latest firmware.

Finally, press the "Upgrade" button.

<br clear="all" />

= Command Line Options =

After downloading, to use the command line options of the upgrade.py program:

# Open a console/terminal window.
# cd to the known location
# Enter at the console prompt:
#* python upgrade.py

<pre>
Fluke and Scribbler/Scribbler2 Upgrade Program
----------------------------------------------
Usage:
   python upgrade.py --gui=VALUE --url=URL --port=PORT WHAT

     VALUE - is True OR False
     URL - is an internat address to use
     PORT - is the serial port address to use
     WHAT - is scribbler OR fluke

Options with examples:
  --gui=False                      (optional)
  --port=COM8                      (optional)
  --url=http://myurl.com/fluke.bin (optional)
  --help

Full Examples:

   python upgrade.py
   python upgrade.py fluke
   python upgrade.py scribbler
   python upgrade.py --gui=False
   python upgrade.py --port=COM5 fluke
   python upgrade.py --port=/dev/rfcomm3 scribbler
   python upgrade.py --url=http://myurl.com/file.bin fluke
   python upgrade.py --help
</pre>

= Troubleshooting =

It is a good idea to turn the Fluke and Scribbler off and then back on after each upgrade.

When the Scribbler is upgraded, it will play 5 notes quickly when you first turn it on or reboot it.