Skip to content
Permalink
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
60 lines (31 sloc) 3.48 KB

Update OpenHAK Firmware

Welcome! I'm going to guide you through the process to upload new firmware to your OpenHAK. We'll use our latest release as an example. It's pretty simple, but there's some steps involved.

Video showing OTA firmware using Android: https://youtu.be/99FAGOL7Lco

Video showing OTA firmware using iOS: https://youtu.be/hfw3FGN5gXY

NOTE: Images below from an Android phone. iPhone images coming soon!

Step One

Downlad out latest release to your phone, OpenHAK 0.1

github/openhak

If you have trouble, you can also email the zip file to yourself, and store it on your phone. The hardest part about this step is making sure that once you download the zip you can find it wherever the phone-thing has saved it to.

Step Two

Download the nRF Toolbox app from your favorite app store. A direct search for nRF Toolbox should bring it right to you. This app has the ability to connect to your OpenHAK and do all kinds of things, including Device Firmware Update (DFU). Install the app, and open it up. On first launch, you'll get asked to let the app access stuff on your phone. Just say yes to that. Once you launch it, the main screen of the app offers you some tools to choose from. Choose DFU to continue this guide.

DFU Tool

Now it's time to go find the .zip file of our software release. First, the app will ask you what you're doing. Tell it that you're sending a Distribution packet (ZIP), then press OK.

DistPack

I found My file in a DropBox folder on my Pixel. It's a handy place to store things. The Toolbox app seems to remember the last file you opened from, so it's good to keep your files tidy.

findFile

The next prompt is to Select scope. Make sure that All is selected, then press OK.

selectScope

The app will show you the file you just selected and all the settings. If you made a mistake, tap SELECT FILE to go a'hunting. Once you have the correct file loaded, it's time to select the device. Tap the button on the bottom of the screen.

SelectDevice

The next screen shows a list of availble devices. Your OpenHAK should be listed. If not, make sure that any other apps have disconected from it. Also, if there are other OpenHAKs nearby that are advertising, you'll see them too. Each OpenHAK has a unique 4-hexadecimal name. In this example, it's 78F8 Once you know yours, try not to forget it. Tap on the listing to connect.

coonect to OpenHAK

The last step is to upload the firmware. Tap the Upload button.

Upload

Uploading will happen. When it's done, you can run the OpenHAK app and connect to your OpenHAK.

Starting_Bootloader

Step 2 was kinda long but that's basically it!

What Happens If You Brick Your OpenHAK

More than likely, you haven't actually bricked your OpenHAK. More likely, you have failed to include the OTA bootloader library in your Arduino sketch.

#include <ota_bootloader.h>

Can't OTA if you don't have that. You can always access the OpenHAK via the breakout pins. We've broken out TX, RX, RESET, and GND on the Simblee so that you can connect an FTDI friend in need. Please open an issues tab in the appropriate repo for help if you need.

You can’t perform that action at this time.