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:

  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.


  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.


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


That’s it! You have successfully installed the firmware on your device.

Next Step: Audio Test →