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 :-
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.
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.
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).
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.
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.
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.
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!
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).