=====Upgrading Firmware - Twiddler 3=====

Here are the steps to upgrade your Twiddler 3 firmware:

====Preparing for the Upgrade====
  - Plug into USB.
  - Identify which firmware you are running by pressing [[chordnotation#thumb_keys|N+S 0R00]].
  - Download and unzip the latest firmware here: [[twiddler_firmware|Twiddler Firmware]]
  - Plug the Twiddler into a computer via USB, mount the flash drive, and copy the Twiddler_0.XXu.hex file to it.  
  - **Rename the .hex file to twiddler.hex.**
  - Eject the flash drive using the OS's Eject function.  It is critical that the .hex file is fully written to the drive so **gracefully ejecting the drive is critical.** If data is being written to flash and power is cut, there is a high risk of flash corruption which will render your Twiddler non-functional.
  - Power off the Twiddler. 
  - Disconnect USB from Twiddler.

====Begin the Upgrade====
  - Make sure the Twiddler is **unplugged** from USB and remains **unplugged** in during the entire procedure.
  - Hold down N+S and power on the Twiddler.  This will load the factory boot image. To verify this, type N+S 0R00.  "Version x.xx**b**" should be typed out. (x.xx are numbers)
  - To start the upgrade procedure type N+S 000R.
  - The LED on the Twiddler will blink Green during the upgrade.  Do not plug in or turn off the Twiddler during this time.
  - Upon completion, The Twiddler will "reboot" and the LED will remain a solid color.
  - Plug the Twiddler back into USB or connect via Bluetooth.
  - Press N+S 0R00 to check to see if the new version has been installed correctly.  It should type out "Version x.xx*u*" where x.xx is the version number of the firmware you downloaded.

{{https://youtu.be/QVpusu-d-lc?si=efsPgSSbPBo_aga5|Twiddler 3 Upgrade Blink Codes Video}}
====Complete the Upgrade====

If everything looks good, head off to [[http://twiddler.tekgear.com/tuner|Twiddler Tuner]] and edit, save and download your twiddler.cfg file(s) to activate the new features found in the updated firmware.

**Remember to delete twiddler.hex off of the Twiddler's flash drive.**

====Troubleshooting====

**Problem:** Firmware did not upgrade.\\
**Solution 1:** Delete Twiddler.hex from the Twiddler's Flash Drive and restart the procedure from "[[firmwareupgrade&#preparing_for_the_upgrade|Preparing for the Upgrade]]".\\
**Solution 2:** Remember to rename the .hex file on the Twiddler3 to twiddler.hex before starting the upgrade procedure. See step 5 in "[[firmwareupgrade&#preparing_for_the_upgrade|Preparing for the Upgrade]]" above.

**Problem:** Bluetooth is not re-pairing immediately after the upgrade. \\
**Solution:** Remove Twiddler Bluetooth pairing entry on host device and also reset the pairing table on the Twiddler with N+S R000.  Rescan Bluetooth devices with host and pair with Twiddler.