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.

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 options.

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 tool and ARE READY for debugging! You do not need to use/buy external debug tool.

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 Debug Tools ¶

Boards listed below are compatible with PIO Unified Debugger but DEPEND ON external debug tool. See “Debug” column for compatible debug 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_feather_m4`	Adafruit Feather M4 (SAMD51)	Atmel-ICE, Black Magic Probe, J-LINK	SAMD51J19A	120MHz	496KB	192KB
`adafruit_gemma_m0`	Adafruit Gemma M0	Atmel-ICE, Black Magic Probe, J-LINK	SAMD21E18A	48MHz	256KB	32KB
`adafruit_itsybitsy_m0`	Adafruit ItsyBitsy M0	Atmel-ICE, Black Magic Probe, J-LINK	SAMD21G18A	48MHz	256KB	32KB
`adafruit_itsybitsy_m4`	Adafruit ItsyBitsy M4 (SAMD51)	Atmel-ICE, Black Magic Probe, J-LINK	SAMD51J19A	120MHz	496KB	192KB
`adafruit_metro_m0`	Adafruit Metro M0 Expresss	Atmel-ICE, Black Magic Probe, J-LINK	SAMD21G18A	48MHz	256KB	32KB
`adafruit_metro_m4`	Adafruit Metro M4 (SAMD51)	Atmel-ICE, Black Magic Probe, J-LINK	SAMD51J19A	120MHz	496KB	192KB
`adafruit_pirkey`	Adafruit pIRkey	Atmel-ICE, Black Magic Probe, J-LINK	SAMD21E18A	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.

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, 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:

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¶

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_feather_m4`	Adafruit Feather M4 (SAMD51)	Yes	SAMD51J19A	120MHz	496KB	192KB
`adafruit_gemma_m0`	Adafruit Gemma M0	Yes	SAMD21E18A	48MHz	256KB	32KB
`adafruit_itsybitsy_m0`	Adafruit ItsyBitsy M0	Yes	SAMD21G18A	48MHz	256KB	32KB
`adafruit_itsybitsy_m4`	Adafruit ItsyBitsy M4 (SAMD51)	Yes	SAMD51J19A	120MHz	496KB	192KB
`adafruit_metro_m0`	Adafruit Metro M0 Expresss	Yes	SAMD21G18A	48MHz	256KB	32KB
`adafruit_metro_m4`	Adafruit Metro M4 (SAMD51)	Yes	SAMD51J19A	120MHz	496KB	192KB
`adafruit_pirkey`	Adafruit pIRkey	Yes	SAMD21E18A	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