The Project Creator GUI provides a series of pages used to create a project.

The Project Creator has the following menus:

  • Settings

    • ModusToolbox™ Settings

      –

      This opens the Settings tool, an editor that allows you to configure a wide range of settings for your environment, such as proxy settings, content modes, and manifest DB settings. See the Settings tool user guide for more details on specific features.

  • Help

    • View Help

      – Opens this document.

    • About Project Creator

      – Displays tool version information.

Choose BSP page​

When you first launch the GUI, it displays the "Choose Board Support Package (BSP)" page that lists the available BSPs by various types, such as AIROC™, PSoC™ 4, and XMC™.


../figures/image5.png

Expand one or more categories to view the BSPs, and select the desired BSP by clicking it. A description for the selected BSP displays in the right pane.

Use the

Expand All

or

Collapse All

options as needed to show or hide all the BSPs.

Create BSP from MPN​

This command opens the BSP Assistant tool to create a BSP based on device part numbers. Refer to the

BSP Assistant user guide

for more details about how to create a BSP from MPNs. When you close the BSP Assistant, the new BSP will show up in the list under

Import

.

Browse for BSP​

Use the

Browse for BSP

button to select any BSPs you may have created or received from a colleague. You can then create a new application for that imported BSP. After clicking the

Browse for BSP

button, the Select Folder dialog opens to select the appropriate BSP.


../figures/image6.png

Navigate to and select the appropriate folder containing the BSP to import and click

Select Folder

. The tool checks that the BSP begins with the name "TARGET_" and that it has a makefile, but it does not validate the makefile for correctness. If the selected BSP is correct, it is added to the list with all the other BSPs.


../figures/image7.png

If the selected BSP is not correct, a message displays indicating that it is not valid. Close the message, and either navigate to another directory to find the BSP or cancel the import operation.


../figures/image8.png

Select application page​

Select a board on the Choose BSP page and click

Next >

to display the "Select Application" page. This page displays the

Template Applications

available for the selected BSP, organized by categories.


../figures/image9.png

On this page, do one or more of the following:

  • Specify the

    Application(s) Root Path

    , or leave it as the default. All files and folders from the application(s) with a selected check box will be copied to this location in a folder with the

    Application Name(s)

    .

  • Optionally pick an item from the

    Target IDE

    pull-down menu, which will generate the necessary files for the selected target. For more details, refer to the applicable user guide for the desired IDE.

  • Expand one or more categories to see the applications available. Use the

    Expand All

    or

    Collapse All

    options as needed to show or hide all the applications.

  • Select one or more check boxes for applications in the list. You can click on the check box or use the right-click context menu. See

    Select multiple applications

    for more details.

  • Type a

    New Application Name

    or

    New BSP Name

    for the application(s) by double-clicking on the selected field, or leave the name as the default.


    ../figures/image10.png

Toolbar options​

The "Select Application" page contains a toolbar with several options to assist with the process, including:


../figures/image11.png

  • Filter text

    – Field used to show only the applications that match the text entered.

  • Browse for Application

    – Allows you to add other applications to the list. See

    Browse for application

    .

  • Show/Hide

    – Toggle to show only the applications with check boxes selected or show all applications. If there is search text, then only applications with check boxes selected and applications with matching search text will be shown instead of all.

  • Select All

    – Select the check boxes for all applications currently shown in the list.

  • Deselect

    – Deselect the check boxes for all applications currently shown in the list.

  • Expand All

    – Click to expand all item trees.

  • Collapse All

    – Click to collapse all item trees.

Select multiple applications​

The "Select Application" page allows you to select multiple applications, as follows:

  • Click multiple check boxes next to the applications.

  • Click to highlight an application, then press and hold [

    Ctrl

    ] and click additional applications.

  • Click to highlight an application, then press and hold [

    Shift

    ] to select a range of applications.

When you have multiple applications highlighted, right-click to open the context menu

Select Highlighted Applications

.


../figures/image12.png

Using filter text​

Enter text in the

Enter filter text

field above the list of applications to limit the number of applications shown. This can make it easier to decide which application(s) to select. Text entered in this field is searched against keywords in the application’s manifest, title, and description. Along with applications that match the search, any imported applications are included at the beginning of the list, and any applications with a selected check box are included at the end of the list.

You can enter text with spaces, and they are treated as separate search terms. You can also use a quoted phrase, such as "psoc 6", which is treated as a single term.

Browse for application​

The Select Application page provides a

Browse for Application

button to select other applications you may have created or received from a colleague. After clicking the button, the Select Folder dialog opens. Navigate to the appropriate directory containing the application to import and click

Select Folder

.

Note:

Ensure that you only select an application supported by the BSP you selected on the Choose BSP page.

The tool checks that the application to be imported has a makefile, but it does not validate the makefile for correctness. If the selected application has a makefile, it is added to the list with the other applications.


../figures/image13.png

If the application does not have a

Makefile

, a message displays indicating the application is not a valid ModusToolbox™ application.


../figures/image14.png

Create an application​

Click

Create

to start the process of creating a ModusToolbox™ application, and the GUI will display various messages showing the progress.


../figures/image15.png

Note:

During the project creation process, the tool automatically selects the best pair of BSP and application versions from the manifest file. Release versions are preferred over any custom name versions.

Using the command line (see

CLI description

), you can manually select which version to use. If the BSP and application flow versions match, then the project-creator tool will create a project. If not, then it will show an error.

The GUI always shows applications that have at least one application version that is supported by at least one BSP version.

When the process competes, the tool will display a message similar to the following:

../figures/image16.png

You can continue creating new projects from the "Select Application" page by selecting a new application and then clicking the

Create

button again. You can also go back to the "Choose BSP" page to select another BSP and then continue the project creation process as usual.

To close the tool, click the

Close

button or the

X

button at the top-right of the GUI.

Note:

If you launched the Project Creator tool from the Eclipse IDE, the Project Creator tool closes automatically upon completion, and the IDE will import the created application(s).