RaceCapture/Pro MK1 firmware upgrade: Difference between revisions

Latest revision as of 16:27, 17 July 2023

Upgrading RaceCapture/Pro firmware

Your RaceCapture/Pro unit ships with firmware pre-installed and should work out of the box. You'll only need to follow these instructions when you want to access new features or apply bug fixes.

Save your configuration

WARNING: Updating firmware restores the default configuration on RaceCapture/Pro

Be sure to save your configuration using the Race Analyzer software.

===Download the Latest firmware version from Downloads section=== and unzip the archive to a location on your computer.

Windows

Flash the firmware by double-clicking the flashRCP.bat file in Windows Explorer and follow the instructions.

Linux

While holding down the button on RaceCapture/Pro, plug the unit into USB. You should see 3 green LEDs light up.

Now flash the firmware by executing the flasher application at the command line:

flasher RaceCapturePro-X.X.X.elf

Flashing process

The flasher application should find the RaceCapture/Pro device and then start flashing new firmware. The red front panel LED on RaceCapture/Pro will flash while firmware is written.

Once the firmware completes flashing, RaceCapture/Pro will reset and run normally with the default configuration.

Steps for Factory ROM bootloader

This is the backup mechanism for re-flashing bootloader firmware and should only be used when the primary firmware upgrading mechanism fails.

Prerequisite

Install the Atmel SAM-BA flash utility. This is a small application that performs the firmware write.

Windows, Linux: download from Atmel's web site Direct download link
Linux alternative: Linux4SAM

Save RaceCapture/Pro configuration

The firmware upgrade process resets the configuration to factory defaults. To preserve the settings and any scripts you have running on your unit, save the active configuration using the RaceCapture/Pro configuration application.

Remove board from enclosure

Remove 4 screws from either end of the RaceCapture/Pro enclosure and slide the circuit board out. Place the board on a non-conductive surface.

Load Factory ROM Bootloader

Locate the 'test' button on the circuit board. If there is no test button installed, bridge the pads where the test button would be installed with a short jumper wire.
Press and hold the test button (or short the pads), then apply power to the RaceCapture/Pro board using the USB cable. Hold the button for 20 seconds.
- This will write back the ROM factory bootloader into flash memory
Release the button and disconnect power.

Download the bootloader image

Download the bootloader image from the Downloads Area

The correct filename will start with bootloader-X.X.X.bin where X.X.X represents the version number. Example: bootloader-0.0.1.bin

Flash firmware

Re-apply power using the USB cable.
If you are prompted for drivers, install the drivers provided under the SAM-BA directory (typically found under C:\Program Files\Atmel\sam-ba_2.12\drv)
Once the drivers are loaded, you should see the device listed under Windows Device Manager - Ports as 'AT91 USB to Serial Converter'
- If you do not see the board recognized this way, ensure you have the Atmel SAM-BA flash utility and drivers correctly installed. If you still have problems, repeat the previous step of loading the factory ROM bootloader.
- If the board comes up as 'GPS Camera Detector' then Windows installed the wrong drivers. Use these instructions to remove the incorrect drivers before proceeding.
Run the SAM-BA flash utility.
- Under 'Select the connection', select board as identified by Device Manager. The board will be defined as '\USBserial\COMXX' where COMXX is the COM port assigned in Device Manager.
- Under 'Select your board', select 'at91sam7s256-ek'.
On the Flash tab, under 'Download/Upload File' select button next to 'Send File Name'. Browse to the bootloader firmware image, which will be a file ending in .bin (e.g. bootloader-0.0.1.bin)
Click the 'Send File' option in the program.
- If prompted to 'Unlock' regions, click yes.
You should observe the firmware flashing progress in the window. When complete, you can remove power to RaceCapture/Pro.

Re-assemble RaceCapture/Pro

Slide the circuit board back in to the enclosure, aligning it with the holes in the end plate. It may be easier in some cases to remove both end plates to enable connectors/LEDs/button to fit into the end plate cut-outs. Ensure the smaller components, like LEDs fit correctly into their respective locations.
Slide mounting rails into place before installing 2nd end plate. Replace screws.

@@ Line 1: / Line 1: @@
 ==Upgrading RaceCapture/Pro firmware==
-===ROM bootloader===
+Your RaceCapture/Pro unit ships with firmware pre-installed and should work out of the box. You'll only need to follow these instructions when you want to access new features or apply bug fixes.
-====Prerequisite====
-Install the Atmel SAM-BA flash utility. This is a small application that performs the firmware writing.
+===Save your configuration===
-* Windows, Linux: download from [http://www.atmel.com/tools/ATMELSAM-BAIN-SYSTEMPROGRAMMER.aspx Atmel's web site]
+'''WARNING: Updating firmware restores the default configuration on RaceCapture/Pro'''
+Be sure to save your configuration using the [[RaceCapturePro_SoftwareOperation|Race Analyzer]] software.
+===Download the Latest firmware version from [[RaceCapturePro_Downloads|Downloads]] section=== and unzip the archive to a location on your computer.
+====Windows====
+Flash the firmware by double-clicking the flashRCP.bat file in Windows Explorer and follow the instructions.
+====Linux====
+While holding down the button on RaceCapture/Pro, plug the unit into USB. You should see 3 green LEDs light up.
+Now flash the firmware by executing the flasher application at the command line:
+#flasher RaceCapturePro-X.X.X.elf
+====Flashing process====
+The flasher application should find the RaceCapture/Pro device and then start flashing new firmware. The red front panel LED on RaceCapture/Pro will flash while firmware is written.
+Once the firmware completes flashing, RaceCapture/Pro will reset and run normally with the default configuration.
+[[Image:firmware_flasher_upgrade.png]]
+==Steps for Factory ROM bootloader==
+This is the backup mechanism for re-flashing bootloader firmware and should '''only''' be used when the primary firmware upgrading mechanism fails.
+===Prerequisite===
+Install the Atmel SAM-BA flash utility. This is a small application that performs the firmware write.
+* Windows, Linux: download from [http://www.atmel.com/tools/ATMELSAM-BAIN-SYSTEMPROGRAMMER.aspx Atmel's web site] [http://www.atmel.com/Images/sam-ba_2.12.exe Direct download link]
 * Linux alternative: [http://www.at91.com/linux4sam/bin/view/Linux4SAM/SoftwareTools Linux4SAM ]
-====Save RaceCapture/Pro configuration====
+===Save RaceCapture/Pro configuration===
 The firmware upgrade process resets the configuration to factory defaults. To preserve the settings and any scripts you have running on your unit, save the active configuration using the RaceCapture/Pro configuration application.
-====Remove board from enclosure====
+===Remove board from enclosure===
 Remove 4 screws from either end of the RaceCapture/Pro enclosure and slide the circuit board out. Place the board on a non-conductive surface.
-====Load Factory ROM Bootloader====
+===Load Factory ROM Bootloader===
 * Locate the 'test' button on the circuit board. If there is no test button installed, bridge the pads where the test button would be installed with a short jumper wire.
-* Press the test button (or short the pads), then apply power to the RaceCapture/Pro board using the USB cable. Hold for 20 seconds- this will write back the ROM factory bootloader into flash memory.
+* Press and hold the test button (or short the pads), then apply power to the RaceCapture/Pro board using the USB cable. Hold the button for 20 seconds.
+** This will write back the ROM factory bootloader into flash memory
 * Release the button and disconnect power.
-====Flash firmware====
+===Download the bootloader image===
+Download the bootloader image from the [[RaceCapturePro_Downloads#Bootloader_Releases|Downloads Area]]
+* The correct filename will start with bootloader-X.X.X.bin where X.X.X represents the version number. '''Example: bootloader-0.0.1.bin'''
+===Flash firmware===
 * Re-apply power using the USB cable.
-* In Windows Device Manager you should see the device listed as 'Atmel SAM-BA bootloader'
+* If you are prompted for drivers, install the drivers provided under the SAM-BA directory (typically found under C:\Program Files\Atmel\sam-ba_2.12\drv)
-** If you do not see the board recognized this way, ensure you have the Atmel SAM-BA flash utility correctly installed. If you still have problems, repeat the previous step of loading the factory ROM bootloader.
+* Once the drivers are loaded, you should see the device listed under Windows Device Manager - Ports as 'AT91 USB to Serial Converter'
-* Run the SAM-BA flash utility. It should recognize the board.
+** If you do not see the board recognized this way, ensure you have the Atmel SAM-BA flash utility and drivers correctly installed. If you still have problems, repeat the previous step of loading the factory ROM bootloader.
-* Using the SAM-BA flash utility, select the RaceCapture/Pro firmware, which will be a file ending in .bin (e.g. RaceCapturePro-0.0.2.bin)
+** If the board comes up as 'GPS Camera Detector' then Windows installed the wrong drivers. Use [http://support.atmel.com/bin/customer.exe?=&action=viewKbEntry&id=678 these instructions] to remove the incorrect drivers before proceeding.
-* Choose the 'flash now' option in the program.
+* Run the SAM-BA flash utility.
+** Under 'Select the connection', select board as identified by Device Manager. The board will be defined as '\USBserial\COMXX' where COMXX is the COM port assigned in Device Manager.
+** Under 'Select your board', select 'at91sam7s256-ek'.
+* On the Flash tab, under 'Download/Upload File' select button next to 'Send File Name'.  Browse to the bootloader firmware image, which will be a file ending in .bin (e.g. bootloader-0.0.1.bin)
+* Click the 'Send File' option in the program.
+** If prompted to 'Unlock' regions, click yes.
 * You should observe the firmware flashing progress in the window. When complete, you can remove power to RaceCapture/Pro.
-====Verify Firmware====
+===Re-assemble RaceCapture/Pro===
-* Re-Apply power to RaceCapture/Pro. In Windows, you should see the RaceCapture/Pro device listed under Ports; note the COM port number assigned. In Linux, you should see a device under /dev/ttyACM0. The 'dmesg' command should have information about the device.
-* Using the configuration application, select the appropriate port, connect to the RaceCapture/Pro and verify the current firmware version.
-* Restore any previously saved configuration.
-====Re-assemble RaceCapture/Pro====
 * Slide the circuit board back in to the enclosure, aligning it with the holes in the end plate. It may be easier in some cases to remove both end plates to enable connectors/LEDs/button to fit into the end plate cut-outs. Ensure the smaller components, like LEDs fit correctly into their respective locations.
 * Slide mounting rails into place before installing 2nd end plate. Replace screws.
-===SD card upgrade===
-We are developing a more convenient upgrade via SD card. Watch this space for updates.