Atmel SAM

platform = atmelsam

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.

For more detailed information please visit vendor site.

Debugging

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

Supported debugging tools are listed in “Debug” column. For more detailed information, please scroll table by horizontal. You can switch between debugging Tools using debug_tool options.

On-Board tools

Boards listed below have on-board debugging tools and ARE READY for debugging! You do not need to use/buy external debugger.

ID Name Debug MCU Frequency Flash RAM
mzeropro Arduino M0 Pro (Programming/Debug Port) CMSIS-DAP (on-board), Atmel-ICE, Black Magic Probe, J-LINK SAMD21G18A 48MHz 256KB 32KB
samd21_xpro Atmel SAMD21-XPRO CMSIS-DAP (on-board), Atmel-ICE, Black Magic Probe, J-LINK SAMD21J18A 48MHz 256KB 32KB
samd21g18a Atmel ATSAMW25-XPRO CMSIS-DAP (on-board), Atmel-ICE, Black Magic Probe, J-LINK SAMD21G18A 48MHz 256KB 32KB
saml21_xpro_b Atmel SAML21-XPRO-B CMSIS-DAP (on-board), Atmel-ICE, Black Magic Probe, J-LINK SAML21J18B 48MHz 256KB 32KB
samr21_xpro Atmel ATSAMR21-XPRO CMSIS-DAP (on-board), Atmel-ICE, Black Magic Probe, J-LINK SAMR21G18A 48MHz 256KB 32KB
zero Arduino Zero (Programming/Debug Port) CMSIS-DAP (on-board), Atmel-ICE, Black Magic Probe, J-LINK SAMD21G18A 48MHz 256KB 32KB

External tools

Boards listed below are compatible with PIO Unified Debugger but depend on external debugging tools. See “Debug” column for compatible debugging tools.

ID Name Debug MCU Frequency Flash RAM
adafruit_circuitplayground_m0 Adafruit Circuit Playground Express Atmel-ICE, Black Magic Probe, J-LINK SAMD21G18A 48MHz 256KB 32KB
adafruit_feather_m0 Adafruit Feather M0 Atmel-ICE, Black Magic Probe, J-LINK SAMD21G18A 48MHz 256KB 32KB
adafruit_feather_m0_express Adafruit Feather M0 Express Atmel-ICE, Black Magic Probe, J-LINK SAMD21G18A 48MHz 256KB 32KB
adafruit_gemma_m0 Adafruit Gemma M0 Atmel-ICE, Black Magic Probe, J-LINK SAMD21E18A 48MHz 256KB 32KB
adafruit_metro_m0 Adafruit Metro M0 Expresss Atmel-ICE, Black Magic Probe, J-LINK SAMD21G18A 48MHz 256KB 32KB
adafruit_trinket_m0 Adafruit Trinket M0 Atmel-ICE, Black Magic Probe, J-LINK SAMD21E18A 48MHz 256KB 32KB
digix Digistump DigiX Black Magic Probe, J-LINK AT91SAM3X8E 84MHz 512KB 28KB
due Arduino Due (Programming Port) Black Magic Probe, J-LINK AT91SAM3X8E 84MHz 512KB 32KB
dueUSB Arduino Due (USB Native Port) Black Magic Probe, J-LINK AT91SAM3X8E 84MHz 512KB 32KB
macchina2 Macchina M2 Black Magic Probe, J-LINK AT91SAM3X8E 84MHz 512KB 32KB
mkr1000USB Arduino MKR1000 Atmel-ICE, Black Magic Probe, J-LINK SAMD21G18A 48MHz 256KB 32KB
mkrfox1200 Arduino MKR FOX 1200 Atmel-ICE, Black Magic Probe, J-LINK SAMD21G18A 48MHz 256KB 32KB
mkrgsm1400 Arduino MKR GSM 1400 Atmel-ICE, Black Magic Probe, J-LINK SAMD21G18A 48MHz 256KB 32KB
mkrwan1300 Arduino MKR WAN 1300 Atmel-ICE, Black Magic Probe, J-LINK SAMD21G18A 48MHz 256KB 32KB
mkrzero Arduino MKRZERO Atmel-ICE, Black Magic Probe, J-LINK SAMD21G18A 48MHz 256KB 32KB
mzeroUSB Arduino M0 Atmel-ICE, Black Magic Probe, J-LINK SAMD21G18A 48MHz 256KB 32KB
mzeroproUSB Arduino M0 Pro (Native USB Port) Atmel-ICE, Black Magic Probe, J-LINK SAMD21G18A 48MHz 256KB 32KB
sainSmartDue SainSmart Due (Programming Port) Black Magic Probe, J-LINK AT91SAM3X8E 84MHz 512KB 32KB
sainSmartDueUSB SainSmart Due (USB Native Port) Black Magic Probe, J-LINK AT91SAM3X8E 84MHz 512KB 32KB
sodaq_autonomo SODAQ Autonomo Atmel-ICE, Black Magic Probe, J-LINK SAMD21J18A 48MHz 256KB 32KB
sodaq_explorer SODAQ ExpLoRer Atmel-ICE, Black Magic Probe, J-LINK SAMD21J18A 48MHz 256KB 32KB
sodaq_one SODAQ ONE Atmel-ICE, Black Magic Probe, J-LINK SAMD21G18A 48MHz 256KB 32KB
sparkfun_samd21_dev_usb SparkFun SAMD21 Dev Breakout Atmel-ICE, Black Magic Probe, J-LINK SAMD21G18A 48MHz 256KB 32KB
sparkfun_samd21_mini_usb SparkFun SAMD21 Mini Breakout Atmel-ICE, Black Magic Probe, J-LINK SAMD21G18A 48MHz 256KB 32KB
tian Arduino Tian Atmel-ICE, Black Magic Probe, J-LINK SAMD21G18A 48MHz 256KB 32KB
zeroUSB Arduino Zero (USB Native Port) Atmel-ICE, Black Magic Probe, J-LINK SAMD21G18A 48MHz 256KB 32KB

Stable and upstream versions

You can switch between stable releases of Atmel SAM development platform and the latest upstream version using platform option in Project Configuration File platformio.ini as described below:

; Custom stable version
[env:stable]
platform =atmelsam@x.y.z
board = ...
...

; The latest upstream/development version
[env:upstream]
platform = https://github.com/platformio/platform-atmelsam.git
board = ...
...

Packages

Name Description
framework-arduinosam Arduino Wiring-based Framework (SAM Core, 1.6)
framework-mbed mbed Framework
framework-simba Simba Framework
tool-avrdude AVRDUDE
tool-bossac BOSSA CLI
tool-openocd OpenOCD
toolchain-gccarmnoneeabi gcc-arm-embedded

Warning

Linux Users:

Windows Users:

Please check that you have a correctly installed USB driver from board manufacturer

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.
mbed The mbed framework The mbed SDK has been designed to provide enough hardware abstraction to be intuitive and concise, yet powerful enough to build complex projects. It is built on the low-level ARM CMSIS APIs, allowing you to code down to the metal if needed. In addition to RTOS, USB and Networking libraries, a cookbook of hundreds of reusable peripheral and module libraries have been built on top of the SDK by the mbed Developer Community.
Simba Simba is an RTOS and build framework. It aims to make embedded programming easy and portable.

Boards

Note

Adafruit

ID Name Debug MCU Frequency Flash RAM
adafruit_circuitplayground_m0 Adafruit Circuit Playground Express Yes SAMD21G18A 48MHz 256KB 32KB
adafruit_feather_m0 Adafruit Feather M0 Yes SAMD21G18A 48MHz 256KB 32KB
adafruit_feather_m0_express Adafruit Feather M0 Express Yes SAMD21G18A 48MHz 256KB 32KB
adafruit_gemma_m0 Adafruit Gemma M0 Yes SAMD21E18A 48MHz 256KB 32KB
adafruit_metro_m0 Adafruit Metro M0 Expresss Yes SAMD21G18A 48MHz 256KB 32KB
adafruit_trinket_m0 Adafruit Trinket M0 Yes SAMD21E18A 48MHz 256KB 32KB

Arduino

ID Name Debug MCU Frequency Flash RAM
due Arduino Due (Programming Port) Yes AT91SAM3X8E 84MHz 512KB 32KB
dueUSB Arduino Due (USB Native Port) Yes AT91SAM3X8E 84MHz 512KB 32KB
mkr1000USB Arduino MKR1000 Yes SAMD21G18A 48MHz 256KB 32KB
mkrfox1200 Arduino MKR FOX 1200 Yes SAMD21G18A 48MHz 256KB 32KB
mkrgsm1400 Arduino MKR GSM 1400 Yes SAMD21G18A 48MHz 256KB 32KB
mkrwan1300 Arduino MKR WAN 1300 Yes SAMD21G18A 48MHz 256KB 32KB
mkrzero Arduino MKRZERO Yes SAMD21G18A 48MHz 256KB 32KB
mzeroUSB Arduino M0 Yes SAMD21G18A 48MHz 256KB 32KB
mzeropro Arduino M0 Pro (Programming/Debug Port) Yes SAMD21G18A 48MHz 256KB 32KB
mzeroproUSB Arduino M0 Pro (Native USB Port) Yes SAMD21G18A 48MHz 256KB 32KB
tian Arduino Tian Yes SAMD21G18A 48MHz 256KB 32KB
zero Arduino Zero (Programming/Debug Port) Yes SAMD21G18A 48MHz 256KB 32KB
zeroUSB Arduino Zero (USB Native Port) Yes SAMD21G18A 48MHz 256KB 32KB

Atmel

ID Name Debug MCU Frequency Flash RAM
samd21_xpro Atmel SAMD21-XPRO Yes SAMD21J18A 48MHz 256KB 32KB
samd21g18a Atmel ATSAMW25-XPRO Yes SAMD21G18A 48MHz 256KB 32KB
saml21_xpro_b Atmel SAML21-XPRO-B Yes SAML21J18B 48MHz 256KB 32KB
samr21_xpro Atmel ATSAMR21-XPRO Yes SAMR21G18A 48MHz 256KB 32KB

Digistump

ID Name Debug MCU Frequency Flash RAM
digix Digistump DigiX Yes AT91SAM3X8E 84MHz 512KB 28KB

Macchina

ID Name Debug MCU Frequency Flash RAM
macchina2 Macchina M2 Yes AT91SAM3X8E 84MHz 512KB 32KB

SODAQ

ID Name Debug MCU Frequency Flash RAM
sodaq_autonomo SODAQ Autonomo Yes SAMD21J18A 48MHz 256KB 32KB
sodaq_explorer SODAQ ExpLoRer Yes SAMD21J18A 48MHz 256KB 32KB
sodaq_one SODAQ ONE Yes SAMD21G18A 48MHz 256KB 32KB

SainSmart

ID Name Debug MCU Frequency Flash RAM
sainSmartDue SainSmart Due (Programming Port) Yes AT91SAM3X8E 84MHz 512KB 32KB
sainSmartDueUSB SainSmart Due (USB Native Port) Yes AT91SAM3X8E 84MHz 512KB 32KB

SparkFun

ID Name Debug MCU Frequency Flash RAM
sparkfun_samd21_dev_usb SparkFun SAMD21 Dev Breakout Yes SAMD21G18A 48MHz 256KB 32KB
sparkfun_samd21_mini_usb SparkFun SAMD21 Mini Breakout Yes SAMD21G18A 48MHz 256KB 32KB