Introduction

.. image:: https://img.shields.io/discord/327254708534116352.svg :target: https://adafru.it/discord :alt: Discord

.. image:: https://travis-ci.org/adafruit/samd-peripherals.svg?branch=master :target: https://travis-ci.org/adafruit/samd-peripherals :alt: Build Status

A thin unifying API atop the peripherals in the MicroChip SAMD series of microcontrollers. It supports the SAMD21 and SAMD51.

It originated in the atmel-samd port of CircuitPython and will be strengthened as other people use it.

Using

First, add the samd-peripherals repo as a submodule within your own. For example:

.. code-block::

git submodule add https://github.com/adafruit/samd-peripherals.git peripherals

This will place the files from the repo in a peripherals directory. When your repo is checked out or updated from before people will need to:

.. code-block::

git submodule update --init --recursive

The header files in samd define the common API between the two series. Logic with most code shared lives in a corresponding .c file. Functions with mostly different implementations are in a .c file of the same name under the series specific directory, such as samd21. Includes are relative to the top of the repo so make sure to add the location of the library to your includes path with something like:

.. code-block::

-Iperipherals/

In your Makefile create a variable which stores the series such as CHIP_FAMILY and alter the source files depending on it. For example (from here):

.. code-block::

SRC_C = \
    peripherals/samd/clocks.c \
    peripherals/samd/dma.c \
    peripherals/samd/events.c \
    peripherals/samd/external_interrupts.c \
    peripherals/samd/sercom.c \
    peripherals/samd/timers.c \
    peripherals/samd/$(CHIP_FAMILY)/adc.c \
    peripherals/$(CHIP_FAMILY)/cache.c

Contributing

Contributions are welcome! Please read our Code of Conduct <https://github.com/adafruit/samd-peripherals/blob/master/CODE_OF_CONDUCT.md>_ before contributing to help this project stay welcoming.