Revision as of 21:34, 21 November 2011

This page details the upgrade.py program for upgrading the Fluke and Scribbler and Scribbler2 robots to use the latest Myro firmware, over Bluetooth. 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 Python installed on your system (Calico Python won't work) ([video: installing Python on Windows Machine]). You also need to have pySerial installed ([video: installing pyserial on windows machine]).

1. Download Media:pyserial.zip
2. Download upgrade.py and save to a known location.
3. Double-click on the file (or use the Command Line Option, below) [video: installing and using the Firmware upgrade tool under windows]

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

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

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

1. Select the Scribbler option
2. On Windows, enter the com port (eg, COM8); on Mac/Linux enter the device path (eg, /dev/tty.scribbler or /dev/rfcomm0)
3. 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

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.

Command Line Options

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

1. Open a console/terminal window.
2. cd to the known location
3. Enter at the console prompt:
   • python upgrade.py

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

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.