Updating Firmware OTA Steps

Via the Cloud Dashboard

Make sure your hardware is connected to the Cloud and is online. Steps on how to set up your device to connect the cloud server can be found here: Hardware Getting Started Guide | Creating Credentials

1. Log into your Gumband Cloud dashboard (i.e. http://app.gumband.com ) and navigate to your hardware.

2. Open the “Firmware” tab. Here you can upload and store firmware for your hardware device.

   Open

   

   
   The “Firmware” page is broken into two sections:

   • The Gumband Firmware section is for the Gumband Core firmware (.gbm0 file types). This will not be frequently used unless migrating to a newer version, or for smaller security and API updates.

   • The User Firmware section is for your code (.gbm4 file types). This is the one you will be interacting with the most!
     
     

3. In the User Firmware section, click Upload then choose the .gbm4 firmware file from your computer/file-system you want to add to the Cloud dashboard. You can assign it a name and file version.
   
   Note: this “Firmware Version” is only for file management. It does not represent nor affect the User Firmware Version on the hardware’s Overview tab (which is set by the device using gumbandSetUserFirmwareVer() in the code). It’s best practice to ensure that these two values match.
   
   

   Open

   

   Selecting a firmware file from your computer

    

4. To update your device with this firmware, select it with the check-box and click Update. This will trigger a firmware update to begin on your device.
   
   

    

5. Your device’s status LED will pulse green while receiving the updated firmware before restarting to run the new firmware. Uploading the firmware this way will also show up in the Change History with a timestamp.

Via the Gumband Loader

The Gumband loader can be run locally to perform OTA updates for offline applications.

• Put the device into “OTA firmware update mode”.

  • Using a web-browser, open the local web server by going to your hardware device’s IP address and press:

    • This update mode can instead be triggered via user code using the hardware API

    • Alternatively, run the firmware command using the serial configuration interface

  • If successful, the device status LED will pulse green

• Run the gumband_loader tool with the following arguments:
  gumband_loader OTA <firmware file> <hardware ip> <port>

  • Firmware file is the .gbm0 or .gbm4 file on your computer/file-system

  • You can get the hardware’s IP by running the read ip command

  • The port will always be 23