mirror of
https://github.com/platformio/platformio-core.git
synced 2025-10-04 09:30:55 +02:00
106 lines
2.7 KiB
ReStructuredText
106 lines
2.7 KiB
ReStructuredText
.. _cmd_init:
|
|
|
|
platformio init
|
|
===============
|
|
|
|
.. contents::
|
|
|
|
Usage
|
|
-----
|
|
|
|
.. code-block:: bash
|
|
|
|
platformio init [OPTIONS]
|
|
|
|
|
|
Description
|
|
-----------
|
|
|
|
Initialize new PlatformIO based project.
|
|
|
|
|
|
This command will create:
|
|
|
|
* :ref:`projectconf`
|
|
* ``src`` - a source directory. Put your source code here
|
|
* ``lib`` - a directory for the project specific libraries. PlatformIO will
|
|
compile them to static libraries and link to executable file
|
|
|
|
Options
|
|
-------
|
|
|
|
.. option::
|
|
--project-dir, -d
|
|
|
|
A path to the directory where *PlatformIO* will initialise new project.
|
|
|
|
.. option::
|
|
--board, -b
|
|
|
|
If you specify board ``type`` (you can pass multiple ``--board`` options), then
|
|
*PlatformIO* will automatically generate environment for :ref:`projectconf` and
|
|
pre-fill these data:
|
|
|
|
* :ref:`projectconf_env_platform`
|
|
* :ref:`projectconf_env_framework`
|
|
* :ref:`projectconf_env_board`
|
|
|
|
The full list with pre-configured boards is available here :ref:`platforms`.
|
|
|
|
.. option::
|
|
--disable-auto-uploading
|
|
|
|
If you initialise project with the specified ``--board``, then *PlatformIO*
|
|
will create environment with enabled firmware auto-uploading. This option
|
|
allows you to disable firmware auto-uploading by default.
|
|
|
|
Examples
|
|
--------
|
|
|
|
1. Create new project in the current working directory
|
|
|
|
.. code-block:: bash
|
|
|
|
$ 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
|
|
src - a source directory. Put your source code here
|
|
lib - a directory for the project specific libraries
|
|
Do you want to continue? [y/N]: y
|
|
Project has been successfully initialized!
|
|
Now you can process it with `platformio run` command.
|
|
|
|
|
|
2. Create new project in the specified directory
|
|
|
|
.. code-block:: bash
|
|
|
|
$ platformio init -d %PATH_TO_DIR%
|
|
|
|
The next files/directories will be created in ***
|
|
platformio.ini - Project Configuration File
|
|
src - a source directory. Put your source code here
|
|
lib - a directory for the project specific libraries
|
|
Do you want to continue? [y/N]: y
|
|
Project has been successfully initialized!
|
|
Now you can process it with `platformio run` command.
|
|
|
|
3. Initialise project for Arduino Uno
|
|
|
|
.. code-block:: bash
|
|
|
|
$ platformio init --board uno
|
|
|
|
The next files/directories will be created in ***
|
|
platformio.ini - Project Configuration File
|
|
src - a source directory. Put your source code here
|
|
lib - a directory for the project specific libraries
|
|
Do you want to continue? [y/N]: y
|
|
Project has been successfully initialized!
|
|
Now you can process it with `platformio run` command.
|