Adding to Downloads

The Downloads section is for microcontroller boards which incorporate CircuitPython compatibility. If you have a Single Board Linux computer, see the Adding to Blinka page.

Image Location

Once you have your images prepared, you will want to place them into the three folders inside assets/images/boards as follows:

  1. The Original Sized image should be placed into the original folder.
  2. The Larger of the two resized images should be placed into the large folder.
  3. The Smaller of the two resized images should be placed into the small folder.

All three images should have the same filename.

Markdown File

The markdown file contains all of the information used for the board. To create a Markdown file for your board, go into the _boards folder and make a duplicate of the unknown.md file.

You will want to rename the duplicate to something like board_name.md to match your image files. For instance, if your images were named feather_m4_express.jpg, you would want to use feather_m4_express.md.

Open up the new markdown file in your favorite text editor. This should be a text editor like Windows notepad and not a word processor such as Microsoft Word because word processors add extra data that will not work well with the Markdown file format.

We'll start with the header section and go line by line to make sure you have the correct information added. The header section always starts with three hyphen characters and ends with three hyphen characters. You can always look at the other Markdown files for examples too. We're going to take a look at the Feather M4 Express file.

Download: file
---
layout: download
board_id: "feather_m4_express"
title: "Feather M4 Express Download"
name: "Feather M4 Express"
manufacturer: "Adafruit"
board_url: "https://www.adafruit.com"
board_image: "feather_m4_express.jpg"
features:
  - Feather-compatible
  - Battery Charging
---

This feather is powered by the ATSAMD51J19 -  with its 120MHz Cortex M4 with floating point support and 512KB Flash and 192KB RAM. Your code will zig and zag and zoom, and with a bunch of extra peripherals for support, this will for sure be your favorite new chipset.

And best of all, it's a Feather - so you know it will work with all our FeatherWings! What a great way to quickly get up and running.

The most exciting part of the Feather M4 is that while you can use it with the Arduino IDE - and it's bonkers fast when you do, we are shipping it with CircuitPython on board. When you plug it in, it will show up as a very small disk drive with main.py on it. Edit main.py with your favorite text editor to build your project using Python, the most popular programming language. No installs, IDE or compiler needed, so you can use it on any computer, even ChromeBooks or computers you can't install software on. When you're done, unplug the Feather and your code will go with you.

The Feather M4 Express uses the extra space left over to add a Mini NeoPixel, 2 MB SPI Flash storage and a little prototyping space. You can use the SPI Flash storage like a very tiny hard drive. When used in CircuitPython, the 2 MB flash acts as storage for all your scripts, libraries and files. When used in Arduino, you can read/write files to it, like a little datalogger or SD card, and then with our helper program, access the files over USB.

Easy reprogramming: the Feather M4 comes pre-loaded with the UF2 bootloader, which looks like a USB storage key. Simply drag firmware on to program, no special tools or drivers needed! It can be used to load up CircuitPython or Arduino IDE (it is bossa-compatible)

Comes fully assembled and tested, with the UF2 USB bootloader. We also toss in some headers so you can solder it in and plug into a solderless breadboard.

## Purchase
* [Adafruit](https://www.adafruit.com/product/3857)
* [Digi-Key](https://www.digikey.com/short/p87f17)

## Contribute

Have some info to add for this board? Edit the source for this page [here](https://github.com/adafruit/circuitpython-org/edit/master/_board/{{ page.board_id }}.md).

Header

layout

Leave this set to download since we're on the downloads page

board_id

This should be the name of the board for example "feather_m4_express".

title

This is the page title and should be more descriptive and end with the word Download. For example "Feather M4 Express Download".

name

This is the name of the board and should be the same as Title but without the word Download. For example "Feather M4 Express".

manufacturer

The name of the board manufacturer. For example "Adafruit".

board_url

This is a full URL that the use to view the product information for the board. For example "https://www.adafruit.com/product/3857".

board_image

This is the filename only for the image you created. The path for the appropriate sized will automatically be generated. For instance "feather_m4_express.jpg".

downloads_display

This can optionally be included in order to hide your board by setting it to false. Omitting this value or setting it to true will display your board.

features

This is a list with features that the board has such as Battery Charging, Bluetooth, WiFi, etc. Items in this list are preceded by a space, a hyphen character, and another space.

Body

The body is more free form and should include at least one paragraph for a description of the board. This is often copied from a product page.

Purchase Section

If a board is available for purchase, it should include a Purchase section with one or more links.

Learn More Section

This section is more commonly found on pages where the board is not yet available for purchase. This should include informational links about the board.

Contribute Section

This should is a standard section that should be left intact as it is. It allows an easy way for people to make modifications to board information.

Submit a Pull Request

Now that you have your changes made, go ahead and commit your code to Github and submit a Pull Request. It will be reviewed and if it looks good, it will be merged in.

This guide was first published on Jul 24, 2019. It was last updated on Jul 24, 2019. This page (Adding to Downloads) was last updated on Nov 11, 2019.