If you do not see upstream locations, add the Adafruit repository:
git remote add upstream https://github.com/adafruit/circuitpython.git
Update your repository with any new additions to the upstream repository:
git fetch upstream
git checkout master
git rebase upstream/master
You will then need to synchronize the submodules in the repository:
git submodule sync
git submodule update --init --recursive
Create a new folder in
ports/atmel-samd/boards
with your board name. Create the following files in your
new folder:
board.c
mpconfigboard.h
mpconfigboard.mk
pins.c
Refer to other board files in the
atmel-samd/boards
folder as examples for what should go in each of
those files. You will need to look at the schematic for your board to see which pins map to which headers
and peripherals.
Once again, you will need a unique and legitimate USB VID and PID for the CIRCUITPY drive (assigned in
mpconfigboard.mk
). The PID (and possibly the VID) should be different from the value used for UF2.
Add your board's name to the TRAVIS_BOARDS list in
.travis.yml
(found in the top level directory of the
repository). This will tell Travis CI to automatically build CircuitPython with support for your board.
To build CircuitPython for your board, follow the instructions in the Building
CircuitPython (https://adafru.it/Bfu) tutorial.
3. Test Your Board
Use the modules found in the Adafruit_CircuitPython_BoardTest (https://adafru.it/Dkg) repository to test
the various pins and features of your board. Note that you will need some hardware (e.g. LEDs, resistors,
EEPROM) for the tests. Refer to the README in the repository for more detailed instructions.
4. Create Pull Requests
Feel free to fork any of the repositories, make your changes, and submit a pull request. We recommend
reading Contribute to CircuitPython with Git and GitHub (https://adafru.it/Dkh) to get a better
understanding of how to contribute to the CircuitPython project. We would love to have your board port as
part of CircuitPython!
5. Update Mu (Optional)
The Mu editor (https://adafru.it/Be6) is quickly becoming a fan favorite for writing CircuitPython programs.
If you would like to have your board supported in Mu, you will need to fork the Mu repository, make a few
changes, and submit a pull request.