Everything
2.4.13 Convert a PM+ project into a CS+ project

You can convert a PM+ project into a CS+ project. Select [Open Project...] from the [Project] menu with CS+, and then select a workspace file (*.prw) or project file (*.prj).

Caution

In converting projects created by using CA78K0R or CA78K0 to projects for use with CC-RL, conversion will not proceed if the destination folder already contains files with the same names as those of the files to be output. Check that there are no such files in the destination folder before using the converter.

(1)

When opening from a PM+ workspace file (*.prw)

(a)

Select the project for conversion settings

When a PM+ workspace file is selected, the Project Convert Setting dialog box will open.

Figure 2.38

Project Convert Setting Dialog Box

 

The [Project] area shows the configuration of conversion target projects as a tree; select the project for carrying out the conversion settings.

(b)

Set the conversion target project

When you select the project, the area on the right shows the conversion target project setting items.

Figure 2.39

Project Convert Setting Dialog Box (When Main Project Is Selected)

Figure 2.40

Project Convert Setting Dialog Box (When Subproject Is Selected)

 

After setting the microcontroller to be used for the conversion target project, and project type, name, and place of creation settings, click the [OK] button.

Remark 1.

When the main project is selected, the [New microcontroller] area and [Kind of project] in the [New project] area will be invalid.

Remark 2.

If you select [Backup the project composition files after conversion], immediately after the conversion the project source files and complete project are packed up and saved.
However, the main project is selected, this item will be invalid.

Remark 3.

See "Project Convert Setting dialog box" for details about each setting item.

Caution

The name of a network path cannot be used for [Place]. Assign the name of a path on a drive.

(c)

Convert the CS+ project

The PM+ project is converted to the CS+ project.

 

In converting a project for CA78K0R or CA78K0 to one for CC-RL, the source files are converted.

When you click on the [OK] button, the Source Convert Setting dialog box [CC-RL] will open.

Figure 2.41

Source Convert Setting dialog box

 

Select [Yes] to convert the source files.

When you wish to save the pre-conversion set of source files, select [Backup the project composition files before conversion] and specify the directory.

Conversion of the source files proceeds in response to clicking on the [OK] button.

 

PM+ projects are converted to CS+ projects according to the rules below.

-

The PM+ workspace is not converted.

-

PM+ project groups are divided into projects with the same name as the project group. After conversion, the project file name will be "project group name.mtpj".

-

PM+ projects are converted to subprojects with the same name as the original project. After conversion, the subproject file name will be "project name.mtsp".

-

After conversion, the first subproject shown in the Project Tree will be the active project.

-

After conversion, the link order in PM+ is not held.

Figure 2.42

PM+ Project Conversion Image

 

Remark 1.

After conversion, CS+ opens the project that was converted from the PM+ project group that includes the active project. Projects other than this project are registered in recently used projects. However, the number of projects that exceeds four is not registered.

Remark 2.

The project settings after conversion, of those in the PM+ project group, are set to the same settings as the project listed first in the workspace file. In addition, files are not registered.

Remark 3.

If you wish to organize each of the projects into a single project after conversion, add each project as a subproject to a single project.

Remark 4.

When loading a workspace that includes projects without build tools specified, build tools are set according to the microcontroller.

Caution 1.

Only projects that can be loaded by PM+ and built normally can be loaded into CS+.

Caution 2.

If there is already a subproject file in the same folder and with the same file name (excluding the file extension) as the project file, then the project file will not be saved correctly.
Change the name of the main project or the subproject on the project tree.

Caution 3.

When only one project exists in a PM+ workspace, the project will be converted to the main project.

 

(2)

When opening from a PM+ project file (*.prj)

(a)

Select the project for conversion settings

When a PM+ project file is selected, the Project Convert Setting dialog box will open.

Figure 2.43

Project Convert Setting Dialog Box

 

The [Project] area shows the configuration of conversion target projects as a tree; select the project for carrying out the conversion settings.

(b)

Set the conversion target project

When you select the project, the area on the right shows the conversion target project setting items.

Figure 2.44

Project Convert Setting Dialog Box (When Project Is Selected)

 

After setting the microcontroller to be used for the conversion target project, and project type, name, and place of creation settings, click the [OK] button.

Remark 1.

If you select [Backup the project composition files after conversion], immediately after the conversion the project source files and complete project are packed up and saved.

Remark 2.

See "Project Convert Setting dialog box" for details about each setting item.

Caution

The name of a network path cannot be used for [Place]. Assign the name of a path on a drive.

(c)

Convert the CS+ project

The PM+ project is converted to the CS+ project.

 

In converting a project for CA78K0R or CA78K0 to one for CC-RL, the source files are converted.

When you click on the [OK] button, the Source Convert Setting dialog box [CC-RL] will open.

Figure 2.45

Source Convert Setting dialog box

 

Select [Yes] to convert the source files.

When you wish to save the pre-conversion set of source files, select [Backup the project composition files before conversion] and specify the directory.

Conversion of the source files proceeds in response to clicking on the [OK] button.

 

PM+ projects are converted to CS+ projects according to the rules below.

-

A PM+ project is converted to a project with the same name as the original project. After conversion, the project file name will be "project name.mtpj".

Remark

When reading a project without build tools specified, build tools are set according to the microcontroller.

Caution

Only projects that can be loaded by PM+ and built normally can be loaded into CS+.

Remark 1.

The target for conversion is the file structure information of the PM+ project file and the build mode/build options information.
The build mode and build options information is not the target for conversion, if the build tool is different from the PM+ project file.

Remark 2.

When build options have been added from the version of the target build tools in the PM+ project to the version of the build tools after conversion, the added options are set to the build tools' default values after conversion.

Remark 3.

The project files after conversion are created in the folder the PM+ project file was placed in. If there is already a project file with the same name, "_number_" (number: 1, 2, ...) will be added to the file name.

Remark 4.

After conversion, the build mode will have the same name as that of a PM+ project.
Any characters that are not allowed in a CS+ folder name, however (\, /, :, *, ?, ", <, >, |) will be replaced by underscores ("_").
If there is another build mode with the same name after conversion, then the "_n_" (n = 1, 2, ...) will be appended to the build mode name.

Remark 5.

Only the file structure is converted. Build options are not converted.

Remark 6.

The conversion result is output to a file as project convert information.

-

The project convert information file name is "ProjectConvertInformation_projectname.txt".

-

The project convert information file is output for each converted project (subproject).

-

The project convert information file is output to the project folder of the project (subproject).

-

The project convert information file is displayed the File node of the project (subproject) on the Project Tree panel.

 

The output format of the project convert information file is shown below.

(1)Time and date on which a project was converted
 
(2)<IDE version>
    CS+ IDE: Version [Date]

Number

Description

(1)

Time and date on which a project was converted

The time and date on which a PM+ project was converted into a CS+ project is output using format "dddd, mmmm dd, yyyy hh:mm:ss AM/PM".

(2)

IDE version and date

The version of CS+ and the date are output.