MCUXpresso IDE Project Converter - nxp-mcuxpresso/vscode-for-mcux GitHub Wiki

This option allows to import an existing project from MCUXpresso IDE (Eclipse based). Select from one of the 2 options:

  1. From PROJECTS view (in case it has no projects yet) press "Import Project" button (see the section above) or
  2. From PROJECTS view toolbar select "Import Project" option.

Be sure your MCUXpresso IDE project was already compiled for the build configurations (debug, release, ...) you need to convert.

When the import wizard will open and an MCUXpresso IDE project is selected, you'll be then asked to provide:

  • Import path - the root MCUXpresso IDE project path where .cproject and .project files are located. If the selected project is identified as a valid MCUXpresso IDE project, this will be reported with a label, right before this field selection (see on the picture below)
  • Destination - a folder where you want to have generated the MCUXpresso for VS Code project
  • Choose a repository - the software repository you want to associate with (for instance, if your MCUXpresso IDE was created based on MIMXRT1170-EVK SDK, select a MIMXRT1170-EVK SDK standalone or Github based software repository available in your MCUXpresso for VS Code installation)
  • Choose a toolchain - choose from available/installed ones a toolchain that will be used for further build process

MCUXpresso IDE import project wizard

At the end, press Import and a full MCUXpresso for VS Code project will be generated.

Import Multiple MCUXpresso IDE Projects

MCUXpresso IDE Import Multiple Projects command

Multiple MCUXpresso IDE projects can be imported at once by using the Import Multiple Projects from the command palette and then selecting the 'MCUXpresso IDE' project type.

MCUXpresso IDE Import Multiple Projects location

After that, you'll be asked to type a path to a directory in which the projects will be searched.

MCUXpresso IDE Import Multiple Projects selection

A list of found and valid projects will be shown once the search is complete and one or multiple projects can be then selected.

MCUXpresso IDE Import Multiple Projects destination

A destination path must be provided where the converter will generate all previously selected projects.

MCUXpresso IDE Import Multiple Projects select repository

MCUXpresso IDE Import Multiple Projects select toolchain

The next two prompts consist in a selection of a repository and a toolchain. The listed options are an intersection of repositories and toolchains compatible with the selected projects in order to be used for all of these.

SDK Linkage troubleshooting

Some projects might not have solved the link to the SDK after import. This can be easily identified by looking into the Repository Information node inside the Project view and determining if Type, Path, ID, Version fields are available with proper values. If not, this will potentially lead to build errors due to the missing SdkRootDirPath value.

In order to overcome this, go to Associate Repository option from Configure context menu and select an SDK from the displayed list. If there is no SDK that suits the converted project, please install one.

home