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, which is set by the device using gumbandSetUserFirmwareVer() in the code.

  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

...

  • Run the firmware command using the serial configuration interface to put the devie device in “OTA firmware update mode”. If successful, the device status LED will pulse green and there will be a response from the device.

    Image RemovedImage Added
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:

  • Put the device into “OTA firmware update mode” through a web interface hosted locally on the hardware (removing the need to connect via USB)

  • Push updates over the network from the Arduino IDE