Skip to main content

Getting Started

Arduino Setup​

  1. Download and Install Arduino
  2. Open Arduino and navigate to File > Preferences
  3. Under Additional Boards Manager URLs add the following URL to the list: https://bitbucket.org/deeplocal/gumband_arduino_public/raw/main/package_gumband_index.json
  4. Navigate to Tools > Boards > Boards Manager
  5. Find and install the package "Gumband Hardware"
  6. Under Tools > Boards you should now see "Gumband Boards", where you can select "Gumband Hardware"

Programming the Hardware​

The Gumband Development Board runs two programs on two separate cores:

  1. The Gumband Management program (M0p core) which provides networking and other support interfaces like a Serial Interface and Webserver for managing settings.
  2. The Custom User program (M4 core) from your Arduino sketch.
note

Your Gumband Development Board might already have the M0p core programmed, but it's good practice to update it whenever the Gumband Library version changes or if you are starting with a fresh board.

Update Gumband Management Program (M0p)​

info

The sketch isn't used for this step, but Arduino will still try to compile the active sketch so it's best to just use an empty sketch

  • Navigate to Tools > Core > M0p
  • Click the Upload button

Update Custom User Program (M4)​

  • Navigate to Tools > Core > M4
  • Select an Example to build
    • Device hardware examples using the on-board LED and User Button File > Examples > Basic
    • Gumband API examples for creating and interacting with properties File > Examples > Gumband API. There's also a tutorial you can follow here
  • Click the Upload button
Having trouble programming?

To manually enter the bootloader, reboot the device while holding the user button (useful if the upload fails or a sketch bricks the device). A reboot can be achieved by manually power cycling or pressing the reset button.