Project Convert Setting dialog box

This dialog box includes the settings for conversion from e2 studio and the old development environment (CubeSuite, HEW, PM+) project (or workspace) to a CS+ project.

Remark

For details of the method of conversion of an old development environment project, see the following.

-	"2.4.10 Convert an e2 studio project into a CS+ project [RX][RL78]"

-	"2.4.11 Convert a CubeSuite project into a CS+ project"2.4.12 Convert a HEW project into a CS+ project"

-	"2.4.13 Convert a PM+ project into a CS+ project"

Figure A.6

Project Convert Setting Dialog Box

The following items are explained here.

-	[How to open]

-	[Description of each area]

-	[Function buttons]

[How to open]

-	From the [Project] menu, select [Open Project...] to open the Open Project dialog box. And then select an e2 studio, CubeSuite, HEW, PM+ project (or workspace) and click the [Open] button.

[Open Existing MCU Simulator Online/e2 studio/CubeSuite/High-performance Embedded Workshop/PM+ Project] area on the Start panel, click the [GO] button to open the Open Project dialog box.
And then select an MCU Simulator Online/e2 studio, CubeSuite, HEW, PM+ project (or workspace) and click the [Open] button.

[Description of each area]

(1)

[Project]

This area displays the conversion target project configuration tree. Select the project for carrying out the conversion settings.

Description node

When you make the selection, the area on the right shows a summary of operations in this dialog box.

Main project node

Indicates that this is the main project for the conversion target project.

When selected, the area on the right shows the main project setting items.

Subproject node

Indicates that this is the subproject for the conversion target project.

When selected, the area on the right shows the subproject setting items.

Remark 1.

Holding down the [Ctrl] key and selecting a main project node and subproject node, allows you to make a multiple project setting.

Remark 2.

Selecting a main project node and then pressing the [*] key, allows you to expand the selected node.
Selecting a main project node and then pressing the [Shift] + [*] key, allows you to collapse the selected node.

Remark 3.

For the following conversions, subproject nodes do not appear.

-	In an e2 studio project

-	In a CubeSuite project when there are no subprojects

-	In a HEW workspace, when there is only one project

-	In a HEW project

-	In a PM+ project

Remark 4.

When the input for [Place] violates any restriction, the following messages are shown in the tooltip.

Message

Description

Some project names are too long. Make it within 259 characters.

For project settings not selected in this area, the absolute path of the conversion target project file exceeds 259 characters.

The device is not specified in some projects. Select the project in tree view, and please set the device.

The device list of the microcontroller selected for a project that is not selected in this area does not include the settings for that project.

This message is shown when CS+ does not support the device for the e2 studio, CubeSuite, or PM+ project or when a device was not set after the HEW project was opened.

(2)	[New microcontroller] area

Carry out the microcontroller settings for the conversion target project.

Remark

This area will be invalid when a PM+ workspace is converted and the main project node is selected.

(a)	[Microcontroller]

Select a microcontroller type to use in the new project.

You can select the item below.

RH850

RL78

(b)	[New microcontroller] area

Select a microcontroller to use in the new project.

<1>	Microcontroller search box

You can search a microcontroller selected in the list of microcontrollers simply.

<2>	List of microcontrollers

Select a microcontroller.

The microcontrollers that correspond to the microcontroller type selected in [Microcontroller] are listed and categorized by their nicknames.

The following information on the selected microcontroller that is used in the project is shown in the box at right.

-	Product Name

-	On-chip ROM size [Kbytes] [RX]

-	Internal ROM size [Kbytes] [RH850][RL78]

-	On-chip RAM size [Bytes] [RX]

-	Internal RAM size [Bytes] [RH850][RL78]

-	Additional InformationNote

Note	Other information appears only when present.

<3>

Button

Update...

Displays the CS+ Update Manager window.

When the microcontroller to be used does not appear in the list, you can search for the microcontroller via the network.

Caution

This button is only enabled when this product is installed using the installer. It is disabled when a packaged item is being used.

Remark

When the selection violates any restriction, the following messages are shown.

Message	Description
Select the device.	Because no device is selected (for example, a device category is selected), it is not possible to determine the project type.

Caution

If there is no microcontroller which is the same as that in the source project, a different microcontroller is automatically selected. Confirm the selected microcontroller and change it as required.

(3)	[Select session]

Select the session used in the new project from the drop-down list.

Only the sessions in the HEW project that are linked to the target will appear in the drop-down list.

Remark

This item is displayed only when the HEW project is converted and there are multiple sessions in it.

(4)	[New project] area

Set the project to create.

(a)	[Kind of project]

Select the project type to create on [Kind of project].

Caution

When the target device is changed in this dialog box while it is open for conversion of a project created by using the CubeSuite, HEW, or PM+, the item chosen in [Kind of project] is returned to the default value (top type in the drop-down list).
For example:
The setting for [Kind of project] changes to the default type (for example, [Application(CC-RH/CC-RX/CC-RL)]) when the device selection is changed.

Remark

This item will be invalid when a PM+ workspace is converted and the main project node is selected.

You can select the item below.

-	Application(CC-RH/CC-RX/CC-RL)

Select this to generate the load module file and hex file from C source files, by using the build tool provided by CS+.
The generated file will be the debug target.

-	Empty Application(CC-RH/CC-RX/CC-RL)

Select this to generate the load module file, by using build tool provided by CS+.
The generated file will be the debug target.
Sample startup programs are not generated when the project is created.

-	Library(CC-RH/CC-RX/CC-RL)

Select this to generate a library file for a user library, by using the build tool provided by CS+.

-	Debug Only

Select this to debug a load module file or hex file generated with a build tool other than the one provided by CS+ (i.e. creates a debug-dedicated project).
See "E. USING AN EXTERNAL BUILD TOOL" for details on how to create and use the debug-dedicated project.

(b)	[Project name]

Directly enter the name of the project to create.

The entered project name is followed by the extension, ".mtpj" and this forms the project file name.

Remark 1.

When the subproject is created, the entered project name is followed by the extension, ".mtsp" and forms the subproject name.

Remark 2.

When there is an existing project file with the same name in the location for creating the project file, the file name has a number (from 1 to 99) appended thus: "_n_".

(c)	[Create on a different place from the source project]

Select this check box when you wish to create the project in a different folder from that for the source project.

(d)

[Place]

Designate the location to create the project file by directly entering it with absolute path or selecting from the [Browse...] button.

"C:\Users\<user name>\Documents\CS+ Projects\<a folder for the source project>" is displayed by default.

Note that this item is only enabled when you have selected [Create on a different place from the source project].

Caution

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

(e)

Button

Browse...

Opens the Browse For Folder dialog box.

When a folder is selected, an absolute path of the folder is shown in [Place].

Remark 1.

The number of characters that can be entered in [Project name] and [Place] is up to 259 both for the path name and file name together.

Remark 2.

When the input for [Project name] violates any restriction, the following messages are shown in the tooltip.

Message	Description
The project name is invalid. Enter characters that can be used as a file name.	The project file name uses characters that are not allowed.
The subproject name is invalid. A subproject with the same name cannot be made in the location where the main project exists.	In the specified location there is already a main project with the same name (excluding extension).
Set the project name.	The project name is not specified.

Remark 3.

When the input for [Place] violates any restriction, the following messages are shown in the tooltip.

Message	Description
The file name including the path is too long. Make it within 259 characters.	The file name with the path is more than 259 characters.
The location where the project is to be created does not exist.	The folder creation was canceled or failed, so that a nonexistent folder has been specified.
The location for project creation is invalid. Enter characters that can be used as a path name.	The file name with the invalid path is designated. The characters, \, /, :, *, ?, ", <, >, \|, cannot be used for the folder name.
Some other projects are same setting. Change the project name or the folder.	Attempt to create a project file with the same absolute path as another project.
Set the place.	The creation location is not specified.

(f)	[Copy all files in the folder of the source project to the destination place]

Select this check box when you wish to copy all files in the folder for the source project to the place where the project was created.

All files in the folder and subfolder are copied, including files which are not related to the project, with the exception of the files of the source project itself.

Note that this item is only enabled when you have selected [Create on a different place from the source project].

(5)	[Backup the project composition after before conversion]

Select this check box to pack up and save the project source files and complete project immediately after the conversion.

Remark

This item will be invalid when a PM+ workspace is converted and the main project node is selected.

The destination folder for saving is on the same level as the conversion target project folder, named "conversion-target-project-folder_org".

If there is an existing folder file with the same name, the folder name has a number (from 1 to 99) appended thus: "_n_".

[Function buttons]

Button	Function
OK	Closes this dialog box and converts a project according to the designated condition.
Cancel	Cancels the designated condition and closes the dialog box.
Help	Displays the help of this dialog box.