platformio init

Usage

platformio init [OPTIONS]

Description

Initialize new PlatformIO based project or update existing with new data.

This command will create:

Options

-d, --project-dir

A path to the directory where PlatformIO will initialize new project.

-b, --board

If you specify board ID (you can pass multiple --board options), then PlatformIO will automatically generate environment for Project Configuration File platformio.ini and pre-fill these data:

The full list with pre-configured boards is available here Development Platforms.

--ide

Initialise PlatformIO project for the specified IDE which can be imported later via “Import Project” functionality.

A list with supported IDE is available within platformio init --help command. Also, please take a look at IDE Integration page.

--enable-auto-uploading

If you initialise project with the specified platformio init --board, then PlatformIO will create environment with enabled firmware auto-uploading.

--env-prefix

An environment prefix which will be used with pair in board type. For example, the default environment name for teensy_31 board will be [env:teensy_31].

Examples

  1. Create new project in the current working directory
$ platformio init

The current working directory *** will be used for the new project.
You can specify another project directory via
`platformio init -d %PATH_TO_THE_PROJECT_DIR%` command.

The next files/directories will be created in ***
platformio.ini - Project Configuration File. |-> PLEASE EDIT ME <-|
src - Put your source files here
lib - Put here project specific (private) libraries
Do you want to continue? [y/N]: y
Project has been successfully initialized!
Useful commands:
`platformio run` - process/build project from the current directory
`platformio run --target upload` or `platformio run -t upload` - upload firmware to embedded board
`platformio run --target clean` - clean project (remove compiled files)
  1. Create new project in the specified directory
$ platformio init -d %PATH_TO_DIR%

The next files/directories will be created in ***
 platformio.ini - Project Configuration File. |-> PLEASE EDIT ME <-|
src - Put your source files here
lib - Put here project specific (private) libraries
Do you want to continue? [y/N]: y
Project has been successfully initialized!
Useful commands:
`platformio run` - process/build project from the current directory
`platformio run --target upload` or `platformio run -t upload` - upload firmware to embedded board
`platformio run --target clean` - clean project (remove compiled files)
  1. Initialise project for Arduino Uno
$ platformio init --board uno

The current working directory *** will be used for the new project.
You can specify another project directory via
`platformio init -d %PATH_TO_THE_PROJECT_DIR%` command.

The next files/directories will be created in ***
platformio.ini - Project Configuration File. |-> PLEASE EDIT ME <-|
src - Put your source files here
lib - Put here project specific (private) libraries
Do you want to continue? [y/N]: y
Project has been successfully initialized!
Useful commands:
`platformio run` - process/build project from the current directory
`platformio run --target upload` or `platformio run -t upload` - upload firmware to embedded board
`platformio run --target clean` - clean project (remove compiled files)