Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  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.


    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 in the the hardware overview, 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.

  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.

    Image RemovedImage Added

  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.

    Image RemovedImage Added

...

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”.

...

  • Run

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

      Image Added
    to put the devie in “OTA firmware update mode”.
    • If successful, the device status LED will pulse green

    and there will be a response from the device. Image Removed
Info

The device will timeout waiting for an OTA firmware update in this mode after 30 seconds.

  • 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

Future releases for Gumband hardware will allow you to:

  • Push updates over the network from the Arduino IDE