Install firmware

Important: If you purchased an assembled device please skip this step

If you purchased an unassembled Friend device or built it yourself using our hardware guide, follow the steps below to flash the firmware:

Official firmware:

Go to Releases in Github, and find the latest official firmware release. To use this firmware, simply download it and skip to step 6. If you would like to build the firmware yourself please follow all the steps below.

Build your own firmware:

  1. Set up nRF Connect by following the tutorial in this video: https://youtu.be/EAJdOqsL9m8

  2. In the nRF Connect Extension inside your VS Code, click ā€œOpen an existing applicationā€ and open the firmware folder from the root of this repo.

    install_firmware_screenshot_1

  3. In the application panel of the extension, click the ā€œAdd Build Configurationā€ icon.

    Add Build Configuration

  4. Choose the board as ā€œxiao_ble_senseā€ and select the configuration as ā€œprj.confā€. Then, click ā€œBuild Configurationā€.

    Build Settings

  5. Once the build succeeds, you will find the zephyr.uf2 file in the firmware/build/zephyr directory.

  6. Double-click on the reset button of the device(see on image below) . The device will appear on your computer as a disk. Drag and drop the zephyr.uf2 file into it.

    Note: On a Mac, you might see an error message after dropping the file, indicating that the process did not complete. This is just a Mac-specific error; the firmware is successfully uploaded.

    Pinout

    If you have an assembled device, you can put a stick pin/needle into this whole and double-click 2 times

    whole

Thatā€™s it! You have successfully installed the firmware on your device.

Next Step: Audio Test ā†’