This is the latest (main) BeagleBoard documentation. If you are looking for stable releases, use the drop-down menu on the bottom-left and select the desired version.

Using Zephyr

Developing directly in Zephyr will not be ultimately required for end-users who won’t touch the firmware running on BeagleConnect™ Freedom and will instead use the BeagleConnect™ Greybus functionality, but is important for early adopters as well as people looking to extend the functionality of the open source design. If you are one of those people, this is a good place to get started.

Equipment to begin development

There are many options, but using BeaglePlay gives a reasonable common environment. Please adjust as you see fit.


  • BeaglePlay with provided antennas

  • BeagleConnect Freedom with provided USB cable

  • 2x 5V/3A USB power adapters

  • USB Type-C cable for use with BeaglePlay

Install the SDK on BeaglePlay

See Setup Zephyr development on BeaglePlay.


TODO: note the tested version of software for BeaglePlay


TODO: describe how to know it is working

Change default board

The instructions linked above setup the environment for targeting BeaglePlay’s on CC1352. We need to change it to target BeagleConnec Freedom.

echo "export BOARD=beagleconnect_freedom" >> $HOME/zephyr-beagle-cc1352-sdk/zephyr-beagle-cc1352-env/bin/activate
source $HOME/zephyr-beagle-cc1352-sdk/zephyr-beagle-cc1352-env/bin/activate

Try demo applications

Now you can build various Zephyr applications

Build and flash Blinky

Make sure your BeagleConnect Freedom is connected to your BeaglePlay via the USB cable provided.

west build zephyr/samples/basic/blinky
west flash

Debug applications over the serial terminal