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.

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.

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.

Frameworks¶