Skip to main content

GUI description

The Project Creator GUI provides a series of pages used to create a new application or migrate an existing 3.x application to 4.x.

Menus

The tool 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 and content modes. 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.

Filter

On several of the pages, there is a filter text box above the list of items shown (BSPs, MPNs, Code Examples, etc.). Using this filter can make it easier to decide which BSPs, MPNs, and application(s) to select. Text entered in this field is searched against keywords in the application’s manifest, title, and description. Along with items that match the search, any imported BSPs/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 "psc", which is treated as a single term.



Menus

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™, and XMC™.

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.

Note:
Project Creator will automatically detect when you have a kit connected to your computer and select the correct BSP.


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.

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.

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.

Using virtual SDKs

If any virtual SDKs are available to you, the SDK and SDK Version fields display to select one and its version. You can use the Settings tool to specify an SDK that will always be selected by default. A virtual SDK is a list of assets (kits, applications, libraries, etc.) and specific versions of those assets. This setting allows you to filter available BSPs and applications based on the information in those files. It limits the available BSPs, example projects, and libraries to provide a more streamlined development process.



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.

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.

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

On several of the pages, there is a filter text box above the list of items shown (BSPs, MPNs, Code Examples, etc.). Using this filter can make it easier to decide which BSPs, MPNs, and application(s) to select. Text entered in this field is searched against keywords in the application’s manifest, title, and description. Along with items that match the search, any imported BSPs/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 "psc", 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.

Create an application

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

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).
Last updated on