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 ¶

Debugging - “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 SAMC21-XPRO	SAMC21J18A	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 Debugging 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 BLM Badge	SAMD21E18A	48MHz	256KB	32KB
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 CAN	SAME51J19A	120MHz	496KB	192KB
Adafruit Feather M4 Express	SAMD51J19A	120MHz	512KB	192KB
Adafruit Gemma M0	SAMD21E18A	48MHz	256KB	32KB
Adafruit Grand Central M4	SAMD51P20A	120MHz	1MB	256KB
Adafruit Hallowing M0	SAMD21G18A	48MHz	256KB	32KB
Adafruit Hallowing M4	SAMD51J19A	120MHz	496KB	192KB
Adafruit ItsyBitsy M0	SAMD21G18A	48MHz	256KB	32KB
Adafruit ItsyBitsy M4	SAMD51G19A	120MHz	512KB	192KB
Adafruit MONSTER M4SK	SAMD51G19A	120MHz	496KB	192KB
Adafruit Matrix Portal M4	SAMD51J19A	120MHz	496KB	192KB
Adafruit Metro M0 Expresss	SAMD21G18A	48MHz	256KB	32KB
Adafruit Metro M4	SAMD51J19A	120MHz	512KB	192KB
Adafruit Metro M4 AirLift Lite	SAMD51J19A	120MHz	512KB	192KB
Adafruit PyGamer Advance M4	SAMD51J20A	120MHz	1MB	256KB
Adafruit PyGamer M4 Express	SAMD51J19A	120MHz	512KB	192KB
Adafruit PyPortal M4	SAMD51J20A	120MHz	1MB	256KB
Adafruit PyPortal M4 Titano	SAMD51J20A	120MHz	1MB	256KB
Adafruit QT Py M0	SAMD21E18A	48MHz	256KB	32KB
Adafruit Trellis M4	SAMD51J19A	120MHz	512KB	192KB
Adafruit Trinket M0	SAMD21E18A	48MHz	256KB	32KB
Adafruit pIRkey	SAMD21E18A	48MHz	256KB	32KB
Adafruit pyBadge AirLift M4	SAMD51J20A	120MHz	1008KB	192KB
Adafruit pyBadge M4 Express	SAMD51J19A	120MHz	512KB	192KB
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 WAN 1310	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
Briki ABC (MBC-WB) - Samd21	SAMD21G18A	48MHz	256KB	32KB
Briki MBC-WB - Samd21	SAMD21G18A	48MHz	256KB	32KB
Digistump DigiX	AT91SAM3X8E	84MHz	512KB	96KB
MKR Vidor 4000	SAMD21G18A	48MHz	256KB	32KB
Minitronics v2.0	SAMD21J18A	48MHz	256KB	32KB
Moteino M0	SAMD21G18A	48MHz	256KB	32KB
NANO 33 IoT	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
Seeeduino Femto M0	SAMD21G18A	48MHz	256KB	32KB
Seeeduino LoRaWAN	SAMD21G18A	48MHz	256KB	32KB
Seeeduino Wio Lite MG126	SAMD21G18A	48MHz	256KB	32KB
Seeeduino Wio Terminal	SAMD51P19A	120MHz	496KB	192KB
Seeeduino XIAO	SAMD21G18A	48MHz	256KB	32KB
Seeeduino Zero	SAMD21G18A	48MHz	256KB	32KB
SparkFun 9DoF Razor IMU M0	SAMD21G18A	48MHz	256KB	32KB
SparkFun Qwiic Micro	SAMD21E18A	48MHz	256KB	32KB
SparkFun RedBoard Turbo	SAMD21G18A	48MHz	256KB	32KB
SparkFun SAMD21 Dev Breakout	SAMD21G18A	48MHz	256KB	32KB
SparkFun SAMD21 Mini Breakout	SAMD21G18A	48MHz	256KB	32KB
SparkFun SAMD21 Pro RF	SAMD21G18A	48MHz	256KB	32KB
SparkFun SAMD51 Thing Plus	SAMD51J20A	120MHz	496KB	192KB
Tuino 096	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-arduino-mbcwb	Fork of Arduino Framework for briki MBC-WB boards
framework-arduino-sam	The official Arduino Wiring-based Framework for ATSAM3 microcontrollers
framework-arduino-samd	The official Arduino Wiring-based Framework for Microchip SAM D microcontrollers
framework-arduino-samd-adafruit	Arduino Wiring-based Framework for Microchip SAM D microcontrollers (Adafruit SAMD Core)
framework-arduino-samd-moteino	Arduino Wiring-based Framework for Microchip SAM D microcontrollers (Moteino SAMD Core)
framework-arduino-samd-reprap	Arduino Wiring-based Framework for Microchip SAM D microcontrollers (RepRap SAMD Core)
framework-arduino-samd-seeed	Arduino Wiring-based Framework for Microchip SAM D microcontrollers (Seeed SAMD Core)
framework-arduino-samd-sodaq	Arduino Wiring-based Framework for Microchip SAM D microcontrollers (SODAQ SAMD Core)
framework-arduino-samd-sparkfun	Arduino Wiring-based Framework for Microchip SAM D microcontrollers (SparkFun SAMD Core)
framework-arduino-samd-tuino0	Arduino Wiring-based Framework for Microchip SAM D microcontrollers (Tuino0 SAMD Core)
framework-cmsis	Vendor-independent hardware abstraction layer for the Cortex-M processor series
framework-cmsis-atmel	Atmel Smart ARM devices CMSIS module
framework-mbed	Arm Mbed OS is a platform operating system designed for the internet of things
framework-simba	Simba is an Embedded Programming Platform. It aims to make embedded programming easy and portable
framework-zephyr	Zephyr is a new generation, scalable, optimized, secure RTOS for multiple hardware architectures
framework-zephyr-canopennode	canopennode Zephyr module
framework-zephyr-civetweb	Zephyr module for CivetWeb Embedded C/C++ web server
framework-zephyr-cmsis	Zephyr module for Software Interface Standard for Arm Cortex-based Microcontrollers
framework-zephyr-fatfs	Zephyr module for FatFS filesystem
framework-zephyr-hal-atmel	Atmel SAM HAL for Zephyr framework
framework-zephyr-hal-st	Zephyr module for the official libraries provided by STMicroelectronics
framework-zephyr-libmetal	Zephyr module for an abstraction layer across user-space Linux, baremetal, and RTOS environments
framework-zephyr-littlefs	Zephyr module for littlefs filesystem
framework-zephyr-loramac-node	Zephyr module for LoRaWAN endpoint stack implementation
framework-zephyr-lvgl	Zephyr module for LittlevGL - an Open-source Embedded GUI Library
framework-zephyr-mbedtls	Zephyr module for the mbed TLS library
framework-zephyr-mcuboot	Zephyr module for MCUboot - a secure bootloader for 32-bit MCUs
framework-zephyr-mcumgr	Zephyr module for mcumgr management library for 32-bit MCUs
framework-zephyr-mipi-sys-t	Zephyr module for MIPI System Software Trace
framework-zephyr-open-amp	Zephyr module for Open Asymmetric Multi Processing (OpenAMP) framework
framework-zephyr-openthread	Zephyr module for OpenThread - an open-source implementation of the Thread networking protocol
framework-zephyr-segger	Zephyr module for the Segger RTT library
framework-zephyr-sof	Zephyr module for Sound Open Firmware
framework-zephyr-tfm-mcuboot	Zephyr module for MCUboot - a secure bootloader for 32-bit MCUs (TFM Dependency)
framework-zephyr-tinycbor	Zephyr module for Concise Binary Object Representation Library
framework-zephyr-tinycrypt	The TinyCrypt Library provides an implementation for constrained devices of a minimal set of standard cryptography primitives for Zephyr framework
framework-zephyr-trusted-firmware-m	Zephyr module for Trusted Firmware M - a reference implementation of secure world software for ARMv8-M
tool-avrdude	AVRDUDE is a utility to download/upload/manipulate the ROM and EEPROM contents of AVR microcontrollers
tool-bossac	Basic Open Source SAM-BA Application (BOSSA)
tool-cmake	CMake is an open-source, cross-platform family of tools designed to build, test and package software
tool-dtc	Device tree compiler
tool-gperf	GNU gperf is a perfect hash function generator
tool-jlink	Software and Documentation Pack for SEGGER J-Link debug probes
tool-mbctool	MBC-WB Uploader Application
tool-ninja	Ninja is a small build system with a focus on speed
tool-openocd	Open On-Chip Debugger. Free and Open On-Chip Debugging, In-System Programming and Boundary-Scan Testing
toolchain-gccarmnoneeabi	GNU toolchain for Arm Cortex-M and Cortex-R processors

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	Arm Mbed OS is an open source embedded operating system designed specifically for the ‘things’ in the Internet of Things. It includes all the features you need to develop a connected product based on an Arm Cortex-M microcontroller, including security, connectivity, an RTOS and drivers for sensors and I/O devices
Simba	Simba is an RTOS and build framework with aims to make embedded programming easy and portable
Zephyr RTOS	The Zephyr Project is a scalable real-time operating system (RTOS) supporting multiple hardware architectures, optimized for resource constrained devices, and built with safety and security in mind

Boards ¶

Note

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

Adafruit¶

Name	Debug	MCU	Frequency	Flash	RAM
Adafruit BLM Badge	External	SAMD21E18A	48MHz	256KB	32KB
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 CAN	External	SAME51J19A	120MHz	496KB	192KB
Adafruit Feather M4 Express	External	SAMD51J19A	120MHz	512KB	192KB
Adafruit Gemma M0	External	SAMD21E18A	48MHz	256KB	32KB
Adafruit Grand Central M4	External	SAMD51P20A	120MHz	1MB	256KB
Adafruit Hallowing M0	External	SAMD21G18A	48MHz	256KB	32KB
Adafruit Hallowing M4	External	SAMD51J19A	120MHz	496KB	192KB
Adafruit ItsyBitsy M0	External	SAMD21G18A	48MHz	256KB	32KB
Adafruit ItsyBitsy M4	External	SAMD51G19A	120MHz	512KB	192KB
Adafruit MONSTER M4SK	External	SAMD51G19A	120MHz	496KB	192KB
Adafruit Matrix Portal M4	External	SAMD51J19A	120MHz	496KB	192KB
Adafruit Metro M0 Expresss	External	SAMD21G18A	48MHz	256KB	32KB
Adafruit Metro M4	External	SAMD51J19A	120MHz	512KB	192KB
Adafruit Metro M4 AirLift Lite	External	SAMD51J19A	120MHz	512KB	192KB
Adafruit PyGamer Advance M4	External	SAMD51J20A	120MHz	1MB	256KB
Adafruit PyGamer M4 Express	External	SAMD51J19A	120MHz	512KB	192KB
Adafruit PyPortal M4	External	SAMD51J20A	120MHz	1MB	256KB
Adafruit PyPortal M4 Titano	External	SAMD51J20A	120MHz	1MB	256KB
Adafruit QT Py M0	External	SAMD21E18A	48MHz	256KB	32KB
Adafruit Trellis M4	External	SAMD51J19A	120MHz	512KB	192KB
Adafruit Trinket M0	External	SAMD21E18A	48MHz	256KB	32KB
Adafruit pIRkey	External	SAMD21E18A	48MHz	256KB	32KB
Adafruit pyBadge AirLift M4	External	SAMD51J20A	120MHz	1008KB	192KB
Adafruit pyBadge M4 Express	External	SAMD51J19A	120MHz	512KB	192KB

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 WAN 1310	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
MKR Vidor 4000	External	SAMD21G18A	48MHz	256KB	32KB
NANO 33 IoT	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 SAMC21-XPRO	On-board	SAMC21J18A	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

Gimasi¶

Name	Debug	MCU	Frequency	Flash	RAM
Tuino 096	External	SAMD21G18A	48MHz	256KB	32KB

LowPowerLab¶

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

ReprapWorld¶

Name	Debug	MCU	Frequency	Flash	RAM
Minitronics v2.0	External	SAMD21J18A	48MHz	256KB	32KB

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

Seeed¶

Name	Debug	MCU	Frequency	Flash	RAM
Seeeduino Femto M0	External	SAMD21G18A	48MHz	256KB	32KB
Seeeduino LoRaWAN	External	SAMD21G18A	48MHz	256KB	32KB
Seeeduino Wio Lite MG126	External	SAMD21G18A	48MHz	256KB	32KB
Seeeduino Wio Terminal	External	SAMD51P19A	120MHz	496KB	192KB
Seeeduino XIAO	External	SAMD21G18A	48MHz	256KB	32KB
Seeeduino Zero	External	SAMD21G18A	48MHz	256KB	32KB

SparkFun¶

Name	Debug	MCU	Frequency	Flash	RAM
SparkFun 9DoF Razor IMU M0	External	SAMD21G18A	48MHz	256KB	32KB
SparkFun Qwiic Micro	External	SAMD21E18A	48MHz	256KB	32KB
SparkFun RedBoard Turbo	External	SAMD21G18A	48MHz	256KB	32KB
SparkFun SAMD21 Dev Breakout	External	SAMD21G18A	48MHz	256KB	32KB
SparkFun SAMD21 Mini Breakout	External	SAMD21G18A	48MHz	256KB	32KB
SparkFun SAMD21 Pro RF	External	SAMD21G18A	48MHz	256KB	32KB
SparkFun SAMD51 Thing Plus	External	SAMD51J20A	120MHz	496KB	192KB

meteca¶

Name	Debug	MCU	Frequency	Flash	RAM
Briki ABC (MBC-WB) - Samd21	External	SAMD21G18A	48MHz	256KB	32KB
Briki MBC-WB - Samd21	External	SAMD21G18A	48MHz	256KB	32KB