The EDTracker Update Tool is a command-line Windows utility that enables you to flash the sketches (programs) into your EDTracker device without the need for any Arduino IDE, code editing or knowledge of C. It downloads your chosen sketch in pre-compiled binary format from our website and loads it into your Arduino (or compatible) development board.
Before using the utility, you will need to ensure :-
- You are running Microsoft Windows on your PC
- You have installed the drivers for your device already, and it is recognised on your PC as either an EDTracker2 or Arduino Leonardo (or compatible).
- You have Java Runtime Environment 7 installed on your PC (you can use either the 32-bit or 64-bit version)
- An internet connection to download the software image
Download the Tool
The Update Tool can be downloaded from the Software category of the downloads section. Make sure you download the correct version that matches your Java installation - either 32-bit of 64-bit.
Save the ZIP locally and then unpack it to a directory of your choice.
Running the Tool
The Update Tool is run from the command line. Open up a Command Prompt on your windows machine, and then navigate to the directory where you unpacked the tool above. E.g.
The tool is then run by typing the following command :
java -jar UpdateTool.jar <options>
...where <options> is one or more of the parameters described below.
Obtaining a list of available sketches
To query the web server for available releases, use the -l option.
D:\temp\EDTrackerUpdateTool_v1.0.0_x64>java -jar UpdateTool.jar -l
EDTracker Update Tool v1.0.0
Found 4 releases available for download...
RELEASE_ID REVISION RELEASE COMMENT
EDTracker2 (v2.10.0) - Main sketch (22 Jun 2014) - fix 180 flip after prolonged use
EDTracker2Calib (v2.2.0) - Calibration sketch (22 Jun 2014) - fix 180 flip after prolonged use
WipeEEPROM (v1.0.0) - Utility sketch that wipes the EEPROM of stored values
debug (v1.0.0) - Simple flash-LED binary for Arduino sanity testing
Each available sketch is uniquely identified by a "RELEASE_ID". The two main ones of interest will be EDTracker2Calib (the calibration sketch that you use on freshly built devices) and EDTracker2 (which is the main sketch that makes the device function as a head tracker). The version of the sketch is also shown, so you can decide if it is newer than what you may already have (for those looking to update a device that has already been used).
Flashing an image
When you are ready to flash an image, plug the EDTracker device in to a USB port. It is important that the device is recognised correctly, otherwise the tool will not work. Windows should recognise the device as an "Arduino Leonardo" or an "EDTracker2". If not, install (or re-install) the Arduino drivers.
Choose the image from the list displayed in the previous step, and flash by issuing the following command. The UpdateTool will attempt to "guess" which COM port your EDTracker device is using, download the image and flash it into the device. The process takes approximately 2 minutes.
D:\temp\EDTrackerUpdateTool_v1.0.0_x64>java -jar UpdateTool.jar -f EDTracker2
EDTracker Update Tool v1.0.0
Found release EDTracker2 @ v2.10.0
Available serial ports : COM1 COM5
Guessing EDTracker port as COM5
If this is wrong, override with the -c option
Opened port COM5
Bootloader port : COM6
Opened port COM6
Connected to bootloader
Starting flash write...
Bootloader - clean exit
The device will restart and should now be running your required sketch.
New (blank) devices
If the device has never been used before, you will need to first flash the calibration sketch and follow the instructions underneath the calibration section.
Once calibrated, flash the main sketch in place and then continue with the instructions on the same page for calculating drift compensation.
Upgrading an existing device
Version 1.x users
If you have been using the old (version 1) software, we advise that you flash in the EEPROM wipe sketch (WipeEEPROM) first to clear the version 1 settings from your device. You should then perform the steps above, as if your device is new/blank.
Version 2.x users
If you are upgrading from an earlier v2 sketch, then you should not need to perform the calibration steps unless instructed otherwise. Just flash the main sketch straight into your device. The EDTracker UI displays the version number of the software in your device, should you not know!
Specifying the COM port
If the Update Tool cannot "guess" the correct COM port on your PC, you can specify it with the -c option, thus :-
java -jar UpdateTool.jar -f EDTracker2 -c COM10
You can use Windows Device Manager to show the COM ports on your PC - the EDTracker is usually the one displayed as "Arduino Leonardo" (although we cannot promise this; it will depend on what drivers you are using for your Arduino device).