.. _pwrforge_multitarget:

Multitarget support in pwrforge
===============================

Creating a project
------------------
With pwrforge you are able to create multitarget project by specifying --target option multiple times.
For [atsam, esp32, stm32] targets if --chip option is not specified, default chip will be used. It's
also possible to specify --chip option instead (or with) --target option to specify the chip for each target.

Let's say we want to create a project for atsam and stm32 targets. We can do it by running the following command:

::

    pwrforge new --target atsam --target stm32 [project_name]

This will create a project with two targets: atsam and stm32, with default chips `ATSAMD10D14AM` and `STM32F100RBT6` respectively.
If instead we would like to specify different chips for each target we can do it by running the following command:

::

        pwrforge new --chip atsamd10d14am --chip STM32F100RBT6 [project_name]

Target is automatically deduced from chip labels. This means that in this case it's optional to specify --target for already specified chips.
So, the following commands will create thes same project as above:

::

        pwrforge new --target atsam --chip atsamd10d14am --chip STM32F100RBT6 [project_name]
        pwrforge new --target stm32 --chip atsamd10d14am --chip STM32F100RBT6 [project_name]
        pwrforge new --target atsam --target stm32 --chip atsamd10d14am --chip STM32F100RBT6 [project_name]

**First target that is specified will be used as default target.**
If at some point you would like to add/remove a target or change chip for some target, you can do it by modifying `pwrforge.toml` file.
If you want to change default target, you can do it by modifying order in `pwrforge.toml` file.
e.g.

::

    target = ["stm32", "atsam"] # default target is stm32
    target = ["x86", "atsam", "stm32"] # default target is x86


Building a project
------------------
To build a project you can run the following command:

::

    pwrforge build --profile --Release

In this case, since the target is not specified, default target will be used.
If you want to build a project for a specific target, you can do it by specifying --target option:

::

    pwrforge build --target atsam --profile --Release

Flashing and debugging a project
--------------------------------
As with building the project, if --target option is not specified, default target will be used.
To flash a target you can run the following command:

::

    pwrforge flash --target [TARGET]


To debug a project you can run the following command:

::

    pwrforge debug --target [TARGET]

Publishing a project
--------------------

Currently, publishing a multitarget project is limited. When you run pwrforge publish,
only package for the default target will be published.