Adafruit Metro M4 (SAMD51)

Hardware

Platform Atmel SAM: 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.

Microcontroller SAMD51J19A
Frequency 120MHz
Flash 496KB
RAM 192KB
Vendor Adafruit

Configuration

Please use adafruit_metro_m4 ID for board option in “platformio.ini” (Project Configuration File):

[env:adafruit_metro_m4]
platform = atmelsam
board = adafruit_metro_m4

You can override default Adafruit Metro M4 (SAMD51) settings per build environment using board_*** option, where *** is a JSON object path from board manifest adafruit_metro_m4.json. For example, board_build.mcu, board_build.f_cpu, etc.

[env:adafruit_metro_m4]
platform = atmelsam
board = adafruit_metro_m4

; change microcontroller
board_build.mcu = samd51j19a

; change MCU frequency
board_build.f_cpu = 120000000L

Uploading

Adafruit Metro M4 (SAMD51) supports the next uploading protocols:

  • sam-ba
  • blackmagic
  • jlink
  • atmel-ice

Default protocol is sam-ba

You can change upload protocol using upload_protocol option:

[env:adafruit_metro_m4]
platform = atmelsam
board = adafruit_metro_m4

upload_protocol = sam-ba

Debugging

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

Warning

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

You can switch between debugging Tools & Debug Probes using debug_tool option in “platformio.ini” (Project Configuration File).

Adafruit Metro M4 (SAMD51) does not have on-board debug probe and IS NOT READY for debugging. You will need to use/buy one of external probe listed below.

Compatible Tools On-board Default
Atmel-ICE   Yes
Black Magic Probe    
J-LINK    

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.