Overview

This guide covers setting up a development environment on the computer to be able to create and modify embedded C/C++ firmware applications for the Dev Kit. Depending on your comfort and experience with C/C++ programming it may take some time to get everything installed and configured correctly.

<aside> 📖 If you’re already pretty familiar with development you might want to take a peek and bookmark the Bristlemouth Technical Documentation.

</aside>

<aside> ⏳ Expect to take about 60 minutes, but it could be longer.

</aside>

Programming on Bristlemouth

Currently, Bristlemouth application development in C/C++ on **FreeRTOS** is supported. Documentation is geared toward developing on macOS systems. The general process and tools for developing a Mote application are:

Getting a few system tools installed first.

<aside> 🍏 (MacOS only) You may need Xcode command line tools if you don’t have them already. Open a new macOS Terminal window. Enter the command:

$ **xcode-select --install**

If there is anything new to install, the process could take a few minutes. It may ask you to accept the license terms.

</aside>

For the more curious: a general overview of Bristlemouth application development

Retrieving the source code

Reference applications, libraries, and tools for the Development Kit are provided in the open source bm_protocol repository in the Bristlemouth GitHub organization (alongside the full open source implementation of the Bristlemouth protocol itself).

Reference applications for the Dev Kit are in the src/apps/bm_devkit directory.

If you have GitHub experience already:

We recommend using the command-line interface (CLI) to maintain source control and keep track of your own repos.