# SparkFun SAMD21 Mini Breakout

Contents

- SparkFun SAMD21 Mini Breakout

  - Hardware

  - Configuration

  - Uploading

  - Debugging

  - Frameworks

## Hardware

Platform Atmel SAM: Atmel | SMART offers Flash- based ARM products based on the ARM Cortex-M0+, Cortex-M3 and Cortex-M4 architectures, ranging from 8KB to 2MB of Flash including a rich peripheral and feature mix.

Microcontroller | SAMD21G18A
Frequency | 48MHz
Flash | 256KB
RAM | 32KB
Vendor | SparkFun

## Configuration

Please use `sparkfun_samd21_mini_usb` ID for board option in “platformio.ini” (Project Configuration File):

    [env:sparkfun_samd21_mini_usb]
    platform = atmelsam
    board = sparkfun_samd21_mini_usb

You can override default SparkFun SAMD21 Mini Breakout settings per build environment using `board_***` option, where `***` is a JSON object path from board manifest sparkfun_samd21_mini_usb.json. For example, `board_build.mcu`, `board_build.f_cpu`, etc.

    [env:sparkfun_samd21_mini_usb]
    platform = atmelsam
    board = sparkfun_samd21_mini_usb

    ; change microcontroller
    board_build.mcu = samd21g18a

    ; change MCU frequency
    board_build.f_cpu = 48000000L

## Uploading

SparkFun SAMD21 Mini Breakout supports the next uploading protocols:

- `atmel-ice`

- `blackmagic`

- `jlink`

- `sam-ba`

Default protocol is `sam-ba`

You can change upload protocol using upload_protocol option:

    [env:sparkfun_samd21_mini_usb]
    platform = atmelsam
    board = sparkfun_samd21_mini_usb

    upload_protocol = sam-ba

## Debugging

PIO Unified Debugger - “1-click” solution for debugging with a zero configuration.

Warning

You will need to install debug tool drivers depending on your system. Please click on compatible debug tool below for the further instructions and configuration information.

You can switch between debugging Tools & Debug Probes using debug_tool option in “platformio.ini” (Project Configuration File).

SparkFun SAMD21 Mini Breakout does not have on-board debug probe and IS NOT READY for debugging. You will need to use/buy one of external probe listed below.

Compatible Tools | On-board | Default
--- | --- | ---
Atmel-ICE |  | Yes
Black Magic Probe |  |
J-LINK |  |

## Frameworks

Name | Description
--- | ---
Arduino | Arduino Wiring-based Framework allows writing cross-platform software to control devices attached to a wide range of Arduino boards to create all kinds of creative coding, interactive objects, spaces or physical experiences.