CircuitPython Installation

Some CircuitPython compatible boards come with CircuitPython installed. Others are CircuitPython-ready, but need to have it installed. As well, you may want to update the version of CircuitPython already installed on your board. The steps are the same for installing and updating. 

Install the Mu Editor

This guide requires you to edit and interact with CircuitPython code. While you can use any text editor of your choosing, Mu is a simple code editor that works with the Adafruit CircuitPython boards. It's written in Python and works on Windows, MacOS, Linux and Raspberry Pi. The serial console is built right in, so you get immediate feedback from your board's serial output!

Before proceeding, if you'd like to use Mu, click the button below to install the Mu Editor. There are versions for PC, mac, and Linux.

CircuitPython Library Installation

First make sure you are running the latest version of Adafruit CircuitPython for your board.

Next you'll need to install the necessary libraries to use the hardware--carefully follow the steps to find and install these libraries from Adafruit's CircuitPython library bundle matching your version of CircuitPython. The FONA Library requires CircuitPython version 4.0.0 or higher.

Before continuing, make sure your board's lib folder has at least the following files and folders copied over:

  • adafruit_fona
  • adafruit_bus_device
  • adafruit_simpleio.mpy
  • adafruit_bme280.mpy

Once all the files are copied, your CIRCUITPY drive should look like the following screenshot:

This guide was first published on May 20, 2020. It was last updated on May 20, 2020.
This page (CircuitPython Setup) was last updated on Sep 25, 2020.