Atmel SAM

Configuration: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.

Tools & Debug Probes

Supported debugging tools are listed in “Debug” column. For more detailed information, please scroll table by horizontal. You can switch between debugging Tools & Debug Probes using debug_tool option in “platformio.ini” (Project Configuration File).

Warning

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

On-Board Debug Tools

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

Name MCU Frequency Flash RAM
Arduino M0 Pro (Programming/Debug Port) SAMD21G18A 48MHz 256KB 32KB
Arduino Zero (Programming/Debug Port) SAMD21G18A 48MHz 256KB 32KB
Atmel ATSAMR21-XPRO SAMR21G18A 48MHz 256KB 32KB
Atmel ATSAMW25-XPRO SAMD21G18A 48MHz 256KB 32KB
Atmel SAMD21-XPRO SAMD21J18A 48MHz 256KB 32KB
Atmel SAML21-XPRO-B SAML21J18B 48MHz 256KB 32KB

External Debug Tools

Boards listed below are compatible with PIO Unified Debugger but DEPEND ON external debug probe. They ARE NOT READY for debugging. Please click on board name for the further details.

Name MCU Frequency Flash RAM
Adafruit Circuit Playground Express SAMD21G18A 48MHz 256KB 32KB
Adafruit Feather M0 SAMD21G18A 48MHz 256KB 32KB
Adafruit Feather M0 Express SAMD21G18A 48MHz 256KB 32KB
Adafruit Feather M4 Express (SAMD51) SAMD51J19A 120MHz 496KB 192KB
Adafruit Gemma M0 SAMD21E18A 48MHz 256KB 32KB
Adafruit Hallowing M0 SAMD21G18A 48MHz 256KB 32KB
Adafruit ItsyBitsy M0 SAMD21G18A 48MHz 256KB 32KB
Adafruit ItsyBitsy M4 (SAMD51) SAMD51J19A 120MHz 496KB 192KB
Adafruit Metro M0 Expresss SAMD21G18A 48MHz 256KB 32KB
Adafruit Metro M4 (SAMD51) SAMD51J19A 120MHz 496KB 192KB
Adafruit Trinket M0 SAMD21E18A 48MHz 256KB 32KB
Adafruit pIRkey SAMD21E18A 48MHz 256KB 32KB
Arduino Due (Programming Port) AT91SAM3X8E 84MHz 512KB 96KB
Arduino Due (USB Native Port) AT91SAM3X8E 84MHz 512KB 96KB
Arduino M0 SAMD21G18A 48MHz 256KB 32KB
Arduino M0 Pro (Native USB Port) SAMD21G18A 48MHz 256KB 32KB
Arduino MKR FOX 1200 SAMD21G18A 48MHz 256KB 32KB
Arduino MKR GSM 1400 SAMD21G18A 48MHz 256KB 32KB
Arduino MKR WAN 1300 SAMD21G18A 48MHz 256KB 32KB
Arduino MKR WiFi 1010 SAMD21G18A 48MHz 256KB 32KB
Arduino MKR1000 SAMD21G18A 48MHz 256KB 32KB
Arduino MKRZERO SAMD21G18A 48MHz 256KB 32KB
Arduino Tian SAMD21G18A 48MHz 256KB 32KB
Arduino Zero (USB Native Port) SAMD21G18A 48MHz 256KB 32KB
Digistump DigiX AT91SAM3X8E 84MHz 512KB 96KB
Macchina M2 AT91SAM3X8E 84MHz 512KB 96KB
Moteino M0 SAMD21G18A 48MHz 256KB 32KB
SODAQ Autonomo SAMD21J18A 48MHz 256KB 32KB
SODAQ ExpLoRer SAMD21J18A 48MHz 256KB 32KB
SODAQ ONE SAMD21G18A 48MHz 256KB 32KB
SODAQ SARA SAMD21J18A 48MHz 256KB 32KB
SODAQ SFF SAMD21G18A 48MHz 256KB 32KB
SainSmart Due (Programming Port) AT91SAM3X8E 84MHz 512KB 96KB
SainSmart Due (USB Native Port) AT91SAM3X8E 84MHz 512KB 96KB
SparkFun SAMD21 Dev Breakout SAMD21G18A 48MHz 256KB 32KB
SparkFun SAMD21 Mini Breakout 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 “platformio.ini” (Project Configuration File) as described below.

Stable

; Latest stable version
[env:latest_stable]
platform = atmelsam
board = ...

; Custom stable version
[env:custom_stable]
platform = [email protected]
board = ...

Upstream

[env:upstream_develop]
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-jlink SEGGER J-Link Software and Documentation Pack
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

Name Debug MCU Frequency Flash RAM
Adafruit Circuit Playground Express External SAMD21G18A 48MHz 256KB 32KB
Adafruit Feather M0 External SAMD21G18A 48MHz 256KB 32KB
Adafruit Feather M0 Express External SAMD21G18A 48MHz 256KB 32KB
Adafruit Feather M4 Express (SAMD51) External SAMD51J19A 120MHz 496KB 192KB
Adafruit Gemma M0 External SAMD21E18A 48MHz 256KB 32KB
Adafruit Hallowing M0 External SAMD21G18A 48MHz 256KB 32KB
Adafruit ItsyBitsy M0 External SAMD21G18A 48MHz 256KB 32KB
Adafruit ItsyBitsy M4 (SAMD51) External SAMD51J19A 120MHz 496KB 192KB
Adafruit Metro M0 Expresss External SAMD21G18A 48MHz 256KB 32KB
Adafruit Metro M4 (SAMD51) External SAMD51J19A 120MHz 496KB 192KB
Adafruit Trinket M0 External SAMD21E18A 48MHz 256KB 32KB
Adafruit pIRkey External SAMD21E18A 48MHz 256KB 32KB

Arduino

Name Debug MCU Frequency Flash RAM
Arduino Due (Programming Port) External AT91SAM3X8E 84MHz 512KB 96KB
Arduino Due (USB Native Port) External AT91SAM3X8E 84MHz 512KB 96KB
Arduino M0 External SAMD21G18A 48MHz 256KB 32KB
Arduino M0 Pro (Native USB Port) External SAMD21G18A 48MHz 256KB 32KB
Arduino M0 Pro (Programming/Debug Port) On-board SAMD21G18A 48MHz 256KB 32KB
Arduino MKR FOX 1200 External SAMD21G18A 48MHz 256KB 32KB
Arduino MKR GSM 1400 External SAMD21G18A 48MHz 256KB 32KB
Arduino MKR WAN 1300 External SAMD21G18A 48MHz 256KB 32KB
Arduino MKR WiFi 1010 External SAMD21G18A 48MHz 256KB 32KB
Arduino MKR1000 External SAMD21G18A 48MHz 256KB 32KB
Arduino MKRZERO External SAMD21G18A 48MHz 256KB 32KB
Arduino Tian External SAMD21G18A 48MHz 256KB 32KB
Arduino Zero (Programming/Debug Port) On-board SAMD21G18A 48MHz 256KB 32KB
Arduino Zero (USB Native Port) External SAMD21G18A 48MHz 256KB 32KB

Atmel

Name Debug MCU Frequency Flash RAM
Atmel ATSAMR21-XPRO On-board SAMR21G18A 48MHz 256KB 32KB
Atmel ATSAMW25-XPRO On-board SAMD21G18A 48MHz 256KB 32KB
Atmel SAMD21-XPRO On-board SAMD21J18A 48MHz 256KB 32KB
Atmel SAML21-XPRO-B On-board SAML21J18B 48MHz 256KB 32KB

Digistump

Name Debug MCU Frequency Flash RAM
Digistump DigiX External AT91SAM3X8E 84MHz 512KB 96KB

LowPowerLab

Name Debug MCU Frequency Flash RAM
Moteino M0 External SAMD21G18A 48MHz 256KB 32KB

Macchina

Name Debug MCU Frequency Flash RAM
Macchina M2 External AT91SAM3X8E 84MHz 512KB 96KB

SODAQ

Name Debug MCU Frequency Flash RAM
SODAQ Autonomo External SAMD21J18A 48MHz 256KB 32KB
SODAQ ExpLoRer External SAMD21J18A 48MHz 256KB 32KB
SODAQ ONE External SAMD21G18A 48MHz 256KB 32KB
SODAQ SARA External SAMD21J18A 48MHz 256KB 32KB
SODAQ SFF External SAMD21G18A 48MHz 256KB 32KB

SainSmart

Name Debug MCU Frequency Flash RAM
SainSmart Due (Programming Port) External AT91SAM3X8E 84MHz 512KB 96KB
SainSmart Due (USB Native Port) External AT91SAM3X8E 84MHz 512KB 96KB

SparkFun

Name Debug MCU Frequency Flash RAM
SparkFun SAMD21 Dev Breakout External SAMD21G18A 48MHz 256KB 32KB
SparkFun SAMD21 Mini Breakout External SAMD21G18A 48MHz 256KB 32KB