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.

Examples ¶

Examples are listed from Atmel SAM development platform repository:

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 & 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 Crickit M0	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 Grand Central M4 (SAMD51)	SAMD51P20A	120MHz	496KB	192KB
Adafruit Hallowing M0	SAMD21G18A	48MHz	256KB	32KB
Adafruit ItsyBitsy M0	SAMD21G18A	48MHz	256KB	32KB
Adafruit ItsyBitsy M4 (SAMD51)	SAMD51G19A	120MHz	496KB	192KB
Adafruit Metro M0 Expresss	SAMD21G18A	48MHz	256KB	32KB
Adafruit Metro M4 (SAMD51)	SAMD51J19A	120MHz	496KB	192KB
Adafruit Trellis 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 NB 1500	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 = atmelsam@x.y.z
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)
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:

Install “udev” rules 99-platformio-udev.rules

Raspberry Pi users, please read this article Enable serial port on Raspberry Pi.

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

You can list pre-configured boards by platformio boards command or PlatformIO Boards Explorer
For more detailed board information please scroll tables below by horizontal.

Adafruit¶

Name	Debug	MCU	Frequency	Flash	RAM
Adafruit Circuit Playground Express	External	SAMD21G18A	48MHz	256KB	32KB
Adafruit Crickit M0	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 Grand Central M4 (SAMD51)	External	SAMD51P20A	120MHz	496KB	192KB
Adafruit Hallowing M0	External	SAMD21G18A	48MHz	256KB	32KB
Adafruit ItsyBitsy M0	External	SAMD21G18A	48MHz	256KB	32KB
Adafruit ItsyBitsy M4 (SAMD51)	External	SAMD51G19A	120MHz	496KB	192KB
Adafruit Metro M0 Expresss	External	SAMD21G18A	48MHz	256KB	32KB
Adafruit Metro M4 (SAMD51)	External	SAMD51J19A	120MHz	496KB	192KB
Adafruit Trellis 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 NB 1500	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
LowPowerLab CurrentRanger	No	SAMD21G18A	48MHz	256KB	32KB
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