Sparrow Firmware Updates

This article is a step-by-step guide for downloading firmware releases and uploading those firmware binaries to your Sparrow devices.

note

The Sparrow Essentials Board and Sparrow Reference Nodes run the same firmware, and you can use this article's instructions to update the firmware of each.

Downloading Firmware Binaries

The Sparrow reference firmware is open source and available on GitHub . You can view all firmware releases on the repository's releases page . The steps below you show you how to download a firmware binary.

  1. Open the firmware repository's release list in a web browser.

  2. Select the appropriate release. (The most recent version will be on top.)

  3. Scroll down to find the release's .elf file, and click it to download the firmware.

Location of the .elf file

Uploading With STM32CubeProgrammer

Now that you have the firmware binary downloaded, you're ready to push the binary out to your device.

warning

To complete this section you'll need to have STM32CubeProgammer installed. So if you haven't already, install STM32CubeProgrammer , and make sure to follow these installation notes.

  1. Ensure your Sparrow device has power, either from a LiPo battery, a Qwiic connection, or a USB connection.

  2. Connect your STLINK-V3MINI to your Sparrow Essentials Board, or Sparrow Reference Node.

Connecting to an STLINK-V3MINI

  1. Use a micro USB cable to connect the other end of your STLINK-V3MINI to your laptop or computer.

  2. Open STM32CubeProgrammer on your laptop or computer, and select ST-LINK from pulldown menu (shown below).

Configuring a connection type in STM32CubeProgammer

  1. Select Reset mode: Hardware Reset.

Selecting hardware reset in STM32CubeProgammer

  1. Click the Connect button.

Location of the connect button in STM32CubeProgammer

  1. Click the "Erasing & programming" button.

Location of the erasing and programming button in STM32CubeProgammer

  1. Click the Browse button, and select a local copy of the sparrow.elf file you just downloaded.

Location of the browse button in STM32CubeProgammer

  1. Click the Start Programming button.

Location of the start programming button in STM32CubeProgammer

  1. Wait for the download to complete and your Sparrow device to reboot.

At this point you've now successfully updated the firmware on your Sparrow board.

(Optional) You can verify the installation succeeded by completing the following steps in a serial terminal application, such as CoolTerm or TerraTerm .

  1. Connect to the STLINK-V3MINI serial terminal at 9600-8-N-1.

  2. Press the RESET button on your Sparrow device.

  3. Verify the updated firmware by referencing the banner message (example shown below).

===================
===== SPARROW =====
===================
Feb 24 2022 15:19:28

Uploading With STM32_Programmer_CLI

You can also update Sparrow firmware with STM32_Programmer_CLI by following the steps below.

warning

To complete this section you'll need to have STM32CubeProgammer installed. So if you haven't already, install STM32CubeProgrammer , and make sure to follow these installation notes.

  1. Ensure your Sparrow device has power, either from a LiPo battery, a Qwiic connection, or a USB connection.

  2. Connect your STLINK-V3MINI to your Sparrow Essentials Board, or Sparrow Reference Node.

Connecting to an STLINK-V3MINI

  1. Upload the local copy of the sparrow.elf file you just downloaded:
STM32_Programmer_CLI --connect port=SWD reset=HWrst --write ~/Downloads/sparrow.elf --verify --go
  1. Wait for the download to complete and your Sparrow device to reboot.

(Optional) You can verify the installation succeeded by completing the following steps in a serial terminal application, such as CoolTerm or TerraTerm .

  1. Connect to the STLINK-V3MINI serial terminal at 9600-8-N-1.

  2. Press the RESET button on your Sparrow device.

  3. Verify the updated firmware by referencing the banner message (example shown below).

===================
===== SPARROW =====
===================
Feb 24 2022 15:19:28