Follow this guide to upgrade firmware from Beta6 to Beta7
This guide is for upgrading legacy OnlyKey devices with firmware version v0.2-beta.6 or earlier only (OnlyKeys purchased prior to Nov 2018). For the current upgrade guide follow the **Firmware upgrade guide **.
Steps to Upgrade
Note: If you are a new OnlyKey user just complete steps 2 and 3 below as you won’t have anything to backup/restore. Then head over to the User’s Guide to get started.
Step 1.Backup OnlyKey - Create a backup of your OnlyKey by going to the Backup/Restore tab in the OnlyKey app. Ensure you have a copy of your backup key (User Guide Backup Instructions here).
Step 2.Upgrade OnlyKey firmware - Follow instructions here to upgrade firmware on the OnlyKey
Step 3.Upgrade OnlyKey desktop app - Follow instructions here to install the new OnlyKey app.
Step 4.Setup OnlyKey - Follow instructions here to setup OnlyKey and restore from backup
Pro Tip: To do this in Windows open a command prompt and type ‘certUtil -hashfile pathToFileToCheck SHA256’. To do this in Linux open a terminal and type ‘sha256sum pathToFileToCheck’. Where pathToFileToCheck is replaced with the path of the file you are checking.
Step 5. In Teensy Loader select File -> Open HEX File. Then select the firmware you downloaded and click open.
Step 6. Now the firmware should appear at the bottom of the Teensy Loader application.
Note: If a message prompts that ‘HEX file is too large’ ensure that your OnlyKey is plugged in.
Step 7. In order to enable the OnlyKey to upload the new firmware a jumper (Paperclip, aluminum foil etc) must make contact between the two small copper color circles shown while the OnlyKey is plugged into the USB port.
Pro Tip: If your OnlyKey has a case on it you can just slip the two corners out of the case without completely removing the case.
Step 8. With the Teensy Loader in the foreground, you should now see the Teensy Loader progress bar and then a reboot complete appear in the Teensy Loader which indicates that the firmware has loaded successfully.
Under The Hood - What actually happens when you load the firmware is that a mass erase is completed first. What this means is that all data is completely wiped, and then the new firmware is loaded.
You may notice now that there is an option in the app to load firmware when setting up a device. There is also a tab named Firmware in the app. This may be used to load the latest firmware onto OnlyKey directly through the app, no backup/restore or wiping is required. Firmware updates are securely signed using a simple blockchain and verified by on the OnlyKey.