2.4.9 Convert a CA78K0R or CA78K0 project into a CC-RL project

A project for the CA78K0R or CA78K0 compiler created by using CS+ or CubeSuite+ can be converted into a project for the CC-RL compiler. Make use of the existing file configuration to create a new project for the CC-RL compiler.

When creating the project, it is not necessary to code build-tool dependent source, because the source files are converted for the CC-RL.

The properties of the build tool are also maintained, and converted for use with the CC-RL.

Caution 1.

If you wish to reuse an existing PM+ project, open the project in CS+, then save it as a CS+ project (for the method of converting a PM+ project into a CS+ project, see "2.4.13 Convert a PM+ project into a CS+ project").

Caution 2.

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.

 

First, from the [Project] menu, select [Create New Project...], the Create Project dialog box will open.

Figure 2.25

Create Project Dialog Box

 

Set the items in the order below and click the [Create] button.

(1)

Select the microcontroller type

Select "RL78" on [Microcontroller].

(2)

Select the microcontroller

Select the microcontroller to use in the project on [Using microcontroller].

(3)

Select the project type

Under [Kind of project], select "Empty Application(CC-RL)" or "Library(CC-RL)", in accordance with the source project.

(4)

Specify the project name and location to create the project file

Specify the name of the project and the location to create the project file in [Project name] and [Place].

If you don’t create a folder with the project name under the specified location, clear the [Make the project folder] check box.

Remark

It is recommended to specify the same folder as the diverted project for the location to create the project file.
If a folder different from the diverted project is specified, there is a possibility that path determination fails and a build error is occurred.

Caution

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

(5)

Specify the reuse of a CA78K0R or CA78K0 project

Check [Pass the file composition of an existing project to the new project] and specify the location of the project filename to reuse in [Project to be passed].

 

Click the [Create] button. The Source Convert Setting dialog box [CC-RL] appears.

Figure 2.26

Source Convert Setting Dialog Box

 

Select [Yes] to perform conversion on the source files.

To save a backup of the entire project (including source files), select the [Backup the project composition files before conversion] check box, and specify a location in which to save the backup.

Click the [OK] button to convert the source files and create the CC-RL project.

 

Remark

The result that a CC-RL project is created by reusing a CA78K0R or CA78K0 project (the versions of the IDE and compiler package, and conversion information of options) is output to a file as project divert information.

-

The project divert information file name is "ProjectDivertInformationn.txt" (n = 2 to 100).
n is not added normally. It is added if the file to be created already exist.

-

The project divert information file is output for each created project (subproject).

-

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

-

The project divert information file is added to the File node of the project (subproject) on the Project Tree panel.

 

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

(1)Time and date on which a project was created
 
(2)<CS+ IDE(Integrated Development Environment Framework) version>
    CS+ IDE: Version of IDE of CA78K0R or CA78K0 project -> Version of IDE of CC-RL project
 
(3)<Compiler package version>
    CA78K0R: Version -> CC-RL: Version
 
(4)<Options not to use(Build mode)>
    Command name(Tab name of build tool property)
     Option
        :
 
(5)<Options to change(Build mode)>
    Command name(Tab name of build tool property)
     Option of CA78K0R project -> Option of CC-RL project
        :

Number

Description

(1)

Time and date on which a project was created

The time and date on which a CC-RL project was created by reusing a CA78K0R or CA78K0 project is output using format "dddd, mmmm dd, yyyy hh:mm:ss AM/PM".

(2)

CS+ IDE(Integrated Development Environment Framework) version

The version of IDE of a CA78K0R or CA78K0 project and the version of IDE of a CC-RL project are output.

(3)

Compiler package versionNote

The compiler package used in a CA78K0R project and the version, and the compiler package used in a CC-RL project and the version are output.

The version of CC-RL is the latest version in the compiler packages which are installed in the CS+ environment.

(4)

Options not to use(Build mode)Note

If an option that has been set in a CA78K0R project and is not used in a CC-RL project exists, the information is output for each build mode in the format shown below.

 

   Command name(Tab name of build tool property)
    Option
       :

-

This item is output only when the corresponding option exists.

-

CA78K0R options are converted into CC-RL options which have the same function.
The option that has the same function and different name is not output.

-

Build modes are output in the following order: "DefaultBuild", user-created build mode ("DefaultBuild" is the build mode that CS+ provides by default).

(5)

Options to change(Build mode)Note

If an option that has been set in a CA78K0R project and has been changed to use in a CC-RL project exists (in the case that the function is same as CA78K0R, but the parameter does not exist in CC-RL, so it is changed to other one, and the like), the information is output for each build mode in the format shown below.

 

   Command name(Tab name of build tool property)
    Option of CA78K0R project -> Option of CC-RL project
        :

-

This item is output only when the corresponding option exists.

-

CA78K0R options are converted into CC-RL options which have the same function.
The option that has the same function and different name is not output.

-

Build modes are output in the following order: "DefaultBuild", user-created build mode ("DefaultBuild" is the build mode that CS+ provides by default).

Note

This item is not output when the source project is a CA78K0 project.