CLion¶

Project configuration and CMake¶

PlatformIO does not depend on “CMake” and uses own multi-platform build system. Project configuration, such as build flags, library dependencies, etc., should be declared in “platformio.ini” (Project Configuration File).

Update CLion configuration: “Tools > PlatformIO > Re-Init”

CLion does not load project build environments from “platformio.ini”¶

This is a known issue CLion CPP-19478: CLion does not handle “CMAKE_CONFIGURATION_TYPES” from CMakeLists.txt. A temporary solution is to manually configure project profiles in CLion.

Please open CLion Settings and navigate to “Build, Execution, Deployment > CMake”. Press “+” button and PlatformIO-based project profiles:

Arduino .ino files are not supported¶

CLion uses “CMake” tool for code completion and code linting. As a result, it doesn’t support the Arduino files (*.ino and .pde) because they are not valid C/C++ based source files:

1. Missing includes such as #include <Arduino.h>

2. Function declarations are omitted.

See how to Convert Arduino file to C++ manually.

Setting Up the Project¶

1. Please open “New Project” wizard, select board and framework, and create a new PlatformIO project. Please USE ONLY Latin characters (a-z) in a project name to avoid further issues with project compilation. Numbers and some symbols are allowed depending on a file system:

2. Rename main.c file in src folder to main.cpp (right click on a file main.c, Refactor > Rename…) . Paste the next contents:

/**
 * Blink
 *
 * Turns on an LED on for one second,
 * then off for one second, repeatedly.
 */
#include "Arduino.h"

// Set LED_BUILTIN if it is not defined by Arduino framework
// #define LED_BUILTIN 13

void setup()
{
  // initialize LED digital pin as an output.
  pinMode(LED_BUILTIN, OUTPUT);
}

void loop()
{
  // turn the LED on (HIGH is the voltage level)
  digitalWrite(LED_BUILTIN, HIGH);

  // wait for a second
  delay(1000);

  // turn the LED off by making the voltage LOW
  digitalWrite(LED_BUILTIN, LOW);

   // wait for a second
  delay(1000);
}

Build & Upload¶

1. Open project configuration wizard and add PlatformIO Upload and PlatformIO Debug configurations (you can add the rest configurations if you need them):

2. Remove pre-task (“Build”) from PlatformIO Upload and PlatformIO Debug configurations to avoid double project building. You should see “There are no tasks to run before launch”.

3. Select PlatformIO Upload configuration and use the “Build” button for project compilation or the “Run” for a firmware uploading:

Peripheral Registers¶

Please navigate to the “Peripheral” tab in a “Debug” view, press the “Configure” icon and select registers to monitor. Close configuration window.