CircuitPython

CircuitPython is a derivative of MicroPython designed to simplify experimentation and education on low-cost microcontrollers. It makes it easier than ever to get prototyping by requiring no upfront desktop software downloads. The trinket M0 is the second board that comes pre-loaded with CircuitPython. Simply copy and edit files on the CIRCUITPY drive to iterate.

Your Trinket M0 already comes with CircuitPython but maybe there's a new version, or you overwrote your Trinket M0 with Arduino code! In that case, see the below for how to reinstall or update CircuitPython. Otherwise you can skip this and go straight to the next page

Reinstalling and Updating CircuitPython

The latest builds of CircuitPython are available from the GitHub release page. Binaries for different boards are listed under the Downloads section. Pick the one that matches your board such as adafruit-circuitpython-trinket_m0-1.0.0.bin for the Trinket M0.

Files ending in .uf2 can be flashed onto a virtual drive when in bootloader mode. Files that end with .bin can be flashed with esptool.py or bossac.

You will see a list of all available flavors of CircuitPython. Since we support a lot of different hardware, we have a long list of available downloads!

See below for which file to download!

Flashing

Flashing is the process of updating the CircuitPython core. It isn't needed for updating your own code. There are two available methods: UF2 and bossac

Flashing is only available on newer boards including the Trinket M0. Flashing via bossac is possible with both the UF2 bootloader and the original "Arduino" one. We recommend using UF2 if you can, its the easiest! If UF2 fails, or is not available, try bossac.

Entering Bootloader Mode

Regardless of what method you use, you must first get the board into the bootloader mode. This is done by double clicking the reset button. The board is in bootloader mode when the red led fades in and out. Boards with the status neopixel will also show USB status while the red led fades. Green means USB worked while red means the board couldn't talk to the computer. The first step to troubleshooting a red neopixel is trying a different USB cable to make sure its not a charge-only cable.

Flashing UF2

The Trinket M0 comes with a new bootloader called UF2 (Usb Flasher version 2) that makes flashing CircuitPython even easier than before. This beta bootloader allows you to drag so-called ".uf2" type files onto the BOOT drive. For more information, check out our UF2 bootloader page.

Start by ejecting or "safely remove" the CIRCUITPY drive if its present, then double-clicking the reset button while it is plugged into your computer. You should see a new disk drive 'pop up' called TRINKETBOOT or similar, and the DotStar on your board glow green.

The drive will contain a few files. If you want to make a 'backup' of the current firmware on the device, drag-off and save the CURRENT.UF2 file. Other that that you can ignore the index.htm and info_uf2.txt files. They cannot be deleted and are only for informational purposes.

Next up, find the Trinket M0 UF2 file in the github downloads list:

Click to download and save the file onto your Desktop or somewhere else you can find it

Then drag the uf2 file into the TRINKETBOOT drive.

Once the full file has been received, the board will automatically restart into CircuitPython. Your computer may warn about ejecting the drive early, if it does, simply ignore it because the board made sure the file was received ok.

Flashing with BOSSAC

This method is only recommended if you can't use UF2 for some reason!

To flash with bossac (BOSSA's command line tool) first download the latest version from here. The mingw32 version is for Windows, apple-darwin for Mac OSX and various linux options for Linux. Once downloaded, extract the files from the zip and open the command line to the directory with bossac.

bossac -e -w -v -R ~/Downloads/adafruit-circuitpython-trinket_m0-1.0.0.bin

This will erase the chip, write the given file, verify the write and Reset the board. After reset, CircuitPython should be running. Newer boards with the UF2 bootloader may cause a warning of an early eject of a USB drive but just ignore it. Nothing important was being written to the drive.

After flashing

After a successful flash by bossac or UF2 you should see a CIRCUITPY drive appear.

Last updated on 2017-10-02 at 12.05.34 AM Published on 2017-08-23 at 05.57.02 PM