PlatformIO is an open source ecosystem for IoT development with the cross-platform build system, library manager and full support for Black Magic Probe. It works on the popular host OS: macOS, Windows, Linux 32/64, Linux ARM (like Raspberry Pi, BeagleBone, CubieBoard).

Platforms: Atmel AVR, Atmel SAM, Espressif 32, Espressif 8266, Freescale Kinetis, Intel ARC32, Lattice iCE40, Maxim 32, Microchip PIC32, Nordic nRF51, Nordic nRF52, NXP LPC, Silicon Labs EFM32, ST STM32, Teensy, TI MSP430, TI Tiva, WIZNet W7500

Frameworks: Arduino, ARTIK SDK, CMSIS, Energia, ESP-IDF, libOpenCM3, mbed, Pumbaa, Simba, SPL, STM32Cube, WiringPi


PIO Unified Debugger

PIO Unified Debugger is “1-click” solution with zero configuration for the multiple architectures and development platforms. It supports over 200 embedded boards and the most popular IDEs:

See a full list of compatible boards for Black Magic Probe (“Debug” column).

PlatformIO IDE

Quick Start

  1. Install PlatformIO IDE.

  2. Create a new project using “PlatformIO Home > New Project” wizard (🏠 icon on the toolbar)

  3. Edit Project Configuration File platformio.ini and set Black Magic Probe as default tool for debugging and programming/uploading, update upload/debug port following this guide:

platform = ...
framework = ...
board = ...
debug_tool = blackmagic
upload_protocol = blackmagic
upload_port = !!!UPDATE_ME!!!
monitor_port = !!!UPDATE_ME!!!
  1. Start debug session:

    • PlatformIO IDE for Atom: Menu > PlatformIO > Debug > Start a debug session

    • PlatformIO IDE for VSCode: Menu > Debug > Start Debugging

  2. Happy debugging with PlatformIO!

Debugging from CLI

Further details in documentation for platformio debug command.

Advanced configuration

Please visit official PlatformIO documentation for the advanced debugging configuration.

Issues and support

Please mail or use our well-established PlatformIO Community for questions and answers.