Versions Compared

Key

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

...

  1. To update or install the Gumband Core select the "M0p" core from the boards menu and flash the device with a blank sketch (or any sketch)

    1. Note: This only needs to happen once, either with new blank hardware or to update to the latest Gumband version

  2. To upload your sketch select the "M4 (user code)" core from the boards menu and flash the device.

    1. Under File > Examples > Basics are some examples of how to use the device hardware like blinking the on-board LED and using the user button.

    2. Under File > Examples > Gumband API are some examples of using the Gumband API to create properties (hardware endpoints).

Windows, missing DLL

Depending on your environment you may encounter an error during compilation on Windows. To fix this you’ll need to install the Microsoft C++ runtime libraries https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170

Info

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.

...

Configuring the Hardware

Talking to the Device

...

Insert excerpt
Hardware UI
Hardware UI
nameHWUI Create new hardware
nopaneltrue
5. Configure the hardware using the following commands:

Description

Command

Set Hardware ID

write hardware_id <ID>

Set Authentication Token

write auth_token <TOKEN>

Set Cloud Server

write cloud_server app.gbtt.gumband.com:8883

Enable Cloud Server

write cloud_enable true

Reboot the device

restart

Once your hardware device is plugged into the network via Ethernet cable, it should be online and should appear as connected on the online console in addition to your device’s LED pulsating cyan.

...

To disable the encryption, further configure the device with the below commands.

Description

Command

Set Cloud Server (Unencrypted)

write cloud_server app.gbtt.gumband.com:1883

Disable TLS encryption

write cloud_tls_enable false

Reboot the device

restart

...

Tips for Writing Gumband User Application Code

...