{% assign board_id = page.board_id %} {% if page.board_alias != nil %} {% assign board_id = page.board_alias %} {% endif %} {% assign board = site.data.files | where: "id", board_id %} {% if board[0] %} {% assign stable = board[0].versions | where: "stable", true | sort: "version" %} {% assign unstable = board[0].versions | where: "stable", false | sort: "version" %} {% assign releases = stable | concat: unstable %} {% capture board_url %}https://downloads.circuitpython.org/bin/{{ board_id}}{% endcapture %} {% for version in releases %}

CircuitPython {{ version.version }}

This is the latest {% if version.stable %}stable{% else %}unstable{% endif %} release of CircuitPython that will work with the {{ page.name }}.

{% if version.stable %} Start here if you are new to CircuitPython. {% else %} Unstable builds have the latest features but are more likely to have critical bugs. {% endif %}

Release Notes for {{ version.version }}

{% comment %} Create a list of language codes and names so it can be sorted. Jumping through hoops so that the new lines and spaces from the case are removed at the start of the names. Finally the array is sorted, which is possible because each entry is now guaranteed to start with the language name, no whitespace. Whitespaces still need to be filtered before outputing the strings. {% endcomment %} {% capture languages_with_names %} {% for language in version.languages %} {% case language %} {% when 'cs' %} CZECH {% when 'de_DE' %} GERMAN {% when 'en_GB' %} ENGLISH (UK) {% when 'en_US' %} ENGLISH (US) {% when 'en_x_pirate' %} PIRATE (ENGLISH) {% when 'es' %} SPANISH {% when 'fil' %} FILIPINO {% when 'fr' %} FRENCH {% when 'el' %} GREEK {% when 'hi' %} HINDI {% when 'ID' %} INDONESIAN {% when 'it_IT' %} ITALIAN {% when 'ja' %} JAPANESE {% when 'ko' %} KOREAN {% when 'nl' %} DUTCH {% when 'pl' %} POLISH {% when 'pt_BR' %} PORTUGUESE (BRAZILIAN) {% when 'ru' %} RUSSIAN {% when 'sv' %} SWEDISH {% when 'tr' %} TURKISH {% when 'zh_Latn_pinyin' %} CHINESE (PINYIN) {% else %} {{ file[0] | upcase }} {% endcase %} ::{{ language }}, {% endfor %} {% endcapture %} {% assign languages_with_names_array = languages_with_names | split: "," %} {% capture languages_with_names_strip %}{% for language_info in languages_with_names_array %}{{ language_info | strip }},{% endfor %}{% endcapture %} {% assign languages_sorted = languages_with_names_strip | split: "," | sort_natural %}
{% for extension in version.extensions %} DOWNLOAD .{{ extension | upcase }} NOW {% endfor %}
{% if version.modules %}

Built-in modules available: {{ version.modules | join: ', ' }}

{% endif %} {% if version.frozen_libraries and version.frozen_libraries.size != 0 %}

Included frozen(?) modules: {{ version.frozen_libraries | join: ', ' }}

{% endif %}
{% endfor %} {% endif %}

Absolute Newest

Every time we commit new code to CircuitPython we automatically build binaries for each board and language. The binaries are stored on Amazon S3, organized by board, and then by language. Try them if you want the absolute latest and are feeling daring or want to see if a problem has been fixed.

BROWSE S3

Past Releases

All previous releases are listed on GitHub, with release notes, and are available for download from Amazon S3. They are handy for testing, but otherwise we recommend using the latest stable release. Some older GitHub release pages include the same binaries for downloading. But we have discontinued including binaries as assets on newer release pages because of the large number of files for each release.

BROWSE GITHUB

BROWSE S3
{% comment %} Only output bootloader information if we have complete info about a board, and we know the latest version of its bootloader family. By the way, boolean operation precedence is right to left! (yeesh) {% endcomment %} {% assign bootloaders = site.data.bootloaders.bootloaders %} {% assign bootloader_version = bootloaders[page.family].version %} {% assign bootloader_id = page.bootloader_id %} {% if bootloader_version and bootloader_id %} {% if page.family == 'esp32s2' or page.family == 'esp32c3' or page.family == 'esp32s3' %}

Install, Repair, or Update UF2 Bootloader

Latest version: {{ bootloader_version }}

The UF2 bootloader allows you to load CircuitPython, MakeCode, and Arduino programs. The bootloader is not CircuitPython. If a UF2 bootloader is installed, you can check its version by looking in the INFO_UF2.TXT file when the BOOT drive is visible (FTHRS2BOOT, MAGTAGBOOT, HOUSEBOOT, etc.)

It is not necessary to reinstall a UF2 bootloader you unless a BOOT drive is not visible when in UF2 bootloader mode, or you know of a problem with your current UF2 bootloader.

If a UF2 bootloader has never been installed on the board, or the UF2 bootloader was removed by erasing or overwriting the flash, the UF2 bootloader must be installed in order to flash .uf2 files onto the board. .bin files can be uploaded without a UF2 bootloader, using the ESP Web Flasher or esptool.py.

Note: update.uf2 files are not currently working on ESP32-S2 or ESP32-S3 boards.

Important: this will erase previously flashed firmware and sketches from the board, but needs to be perfomed only once.

The instructions here are general. We recommend you consult the manufacturer's board documentation for detailed instructions, which may be different.

After installing the UF2 bootloader, enter the bootloader by double-clicking the reset button. On boards with an RGB status LED, tap reset once, wait for the LED to turn purple, and tap again before the purple goes away. On other boards, consult the board documentation.

After you update, check INFO_UF2.TXT to verify that the bootloader version has been updated. Then you will need to load or reload CircuitPython using the .uf2 file.

DOWNLOAD BOOTLOADER ZIP
{% else %}

Update UF2 Bootloader

Latest version: {{ bootloader_version }}

The bootloader allows you to load CircuitPython, MakeCode, and Arduino programs. The bootloader is not CircuitPython. You can check the current version of your bootloader by looking in the INFO_UF2.TXT file when the BOOT drive is visible (FEATHERBOOT, CPLAYBOOT, etc.).

It is not necessary to update your bootloader if it is working fine. Read the release notes on GitHub to see what has been changed. In general, we recommend you not update the bootloader unless you know there is a problem with it or a support person has asked you to try updating it.

{% if page.family == 'nrf52840' %}

Updating the bootloader on nRF52840 boards is an involved process right now. Follow the instructions in this README.

After you update, check INFO_UF2.TXT to verify that the bootloader version has been updated. Then you will need to reload CircuitPython.

BROWSE ON GITHUB
{% endif %} {% if page.family == 'atmel-samd' %}

To update, first save the contents of CIRCUITPY, just in case. Then double-click the reset button to show the BOOT drive. Drag the update-bootloader .uf2 file to the BOOT drive. Wait a few tens of seconds for the bootloader to update; the BOOT drive will reappear. After you update, check INFO_UF2.TXT to verify that the bootloader version has been updated. Then you will need to reload CircuitPython.

DOWNLOAD UPDATER UF2

BROWSE ON GITHUB
{% endif %}
{% endif %} {% endif %}