[Create Library Options] tab


This tab shows the detailed information on the create library phase categorized by the following and the configuration can be changed.

 

(1) [Debug Information]

(2) [Input File]

(3) [Output File]

(4) [Library]

(5) [List]

(6) [Message]

(7) [Others]

Caution

This tab is displayed for the library project.

Figure A.7

Property Panel: [Create Library Options] Tab

[Description of each category]

(1)

[Debug Information]

The detailed information on debug information is displayed and the configuration can be changed.

Output debug information

Select whether to output debug information.

This corresponds to the -DEBug and -NODEBug options of the rlink command.

This property is displayed only when [Relocatable file(-FOrm=Relocate)] in the [Output file format] property in the [Output File] category.

Default

Yes(Output to the output file)(-DEBug)

How to change

Select from the drop-down list.

Restriction

Yes(Output to the output file)(-DEBug)

Outputs debug information.

No

Does not output debug information.

Delete local symbol name information

Select whether to delete local symbol name information.

This corresponds to the -Hide option of the rlink command.

Default

No

How to change

Select from the drop-down list.

Restriction

Yes(-Hide)

Deletes information of the local symbol name.

No

Does not delete information of the local symbol name.

(2)

[Input File]

The detailed information on input files is displayed and the configuration can be changed.

Object file

Specify the object files.

Specify in the format of "library(module)", with one entry name per line.

The following placeholders are supported.

%ActiveProjectDir%: Replaces with the absolute path of the active project folder.

%ActiveProjectName%: Replaces with the active project name.

%BuildModeName%: Replaces with the build mode name.

%MainProjectDir%: Replaces with the absolute path of the main project folder.

%MainProjectName%: Replaces with the main project name.

%MicomToolPath%: Replaces with the absolute path of the install folder of this product.

%ProjectDir%: Replaces with the absolute path of the project folder.

%ProjectName%: Replaces with the project name.

%TempDir%: Replaces with the absolute path of the temporary folder.

%WinDir%: Replaces with the absolute path of the Windows system folder.

This corresponds to the -Input option of the rlink command.

The object file name is displayed as the subproperty.

Default

Object file[number of defined items]

How to change

Edit by the Text Edit dialog box which appears when clicking the [...] button.

For the subproperty, you can enter directly in the text box.

Restriction

Up to 1024 characters

Up to 256 items can be specified.

Binary file

Specify the binary files.

Specify in the format of "file name(section name[:number of alignment][/section attribute][,symbol name])", with one entry per line.

[:number of alignment], [/section attribute], and [,symbol name] can be omitted.

The value that can be specified for number of alignment is 1, 2, 4, 8, 16, or 32.

If the specification is omitted, it is assumed that 1 has been specified.

"CODE" or "DATA" can be specified as section attribute.

If the specification is omitted, all attributes such as the ability to write, read, and execute, will be all valid.

The following placeholders are supported.

%ActiveProjectDir%: Replaces with the absolute path of the active project folder.

%ActiveProjectName%: Replaces with the active project name.

%BuildModeName%: Replaces with the build mode name.

%MainProjectDir%: Replaces with the absolute path of the main project folder.

%MainProjectName%: Replaces with the main project name.

%MicomToolPath%: Replaces with the absolute path of the install folder of this product.

%ProjectDir%: Replaces with the absolute path of the project folder.

%ProjectName%: Replaces with the project name.

%TempDir%: Replaces with the absolute path of the temporary folder.

%WinDir%: Replaces with the absolute path of the Windows system folder.

This corresponds to the -Binary option of the rlink command.

The binary file name is displayed as the subproperty.

This property is displayed only when [Relocatable file(-FOrm=Relocate)] in the [Output file format] property in the [Output File] category.

Default

Binary file[number of defined items]

How to change

Edit by the Text Edit dialog box which appears when clicking the [...] button.

For the subproperty, you can enter directly in the text box.

Restriction

Up to 1024 characters

Up to 256 items can be specified.

(3)

[Output File]

The detailed information on output files is displayed and the configuration can be changed.

Output file format

Select the format of the output file.

This corresponds to the -FOrm option of the rlink command.

Default

User libraries(-FOrm=Library=U)

How to change

Select from the drop-down list.

Restriction

User libraries(-FOrm=Library=U)

Outputs a user library file.

System libraries(-FOrm=Library=S)

Outputs a system library file.

Relocatable file(-FOrm=Relocate)

Outputs a relocatable file.

Output folder

Specify the output folder.

The following placeholders are supported.

%ActiveProjectDir%: Replaces with the absolute path of the active project folder.

%ActiveProjectName%: Replaces with the active project name.

%BuildModeName%: Replaces with the build mode name.

%MainProjectDir%: Replaces with the absolute path of the main project folder.

%MainProjectName%: Replaces with the main project name.

%MicomToolPath%: Replaces with the absolute path of the install folder of this product.

%ProjectDir%: Replaces with the absolute path of the project folder.

%ProjectName%: Replaces with the project name.

%TempDir%: Replaces with the absolute path of the temporary folder.

%WinDir%: Replaces with the absolute path of the Windows system folder.

If this is blank, it is assumed that the project folder has been specified.

This corresponds to the -OUtput option of the rlink command.

Default

%BuildModeName%

How to change

Directly enter in the text box or edit by the Browse For Folder dialog box which appears when clicking the [...] button.

Restriction

Up to 247 characters

Output file name

Specify the output file name.

If the extension is omitted, it is automatically added according to the selection in the [Output file format] property.

When [User libraries(-FOrm=Library=U)] is selected: .lib

When [System libraries(-FOrm=Library=S)] is selected: .lib

When [Relocatable file(-FOrm=Relocate)] is selected: .rel

The following placeholders are supported.

%ActiveProjectName%: Replaces with the active project name.

%BuildModeName%: Replaces with the build mode name.

%MainProjectName%: Replaces with the main project name.

%ProjectName%: Replaces with the project name.

This corresponds to the -OUtput option of the rlink command.

Default

%ProjectName%.lib

How to change

Directly enter in the text box.

Restriction

Up to 259 characters

(4)

[Library]

The detailed information on the library is displayed and the configuration can be changed.

Using libraries

Specify the library files to be used.

If a relative path is specified, the reference point of the path is the main project or subproject folder.

The following placeholders are supported.

%ActiveProjectDir%: Replaces with the absolute path of the active project folder.

%ActiveProjectName%: Replaces with the active project name.

%BuildModeName%: Replaces with the build mode name.

%MainProjectDir%: Replaces with the absolute path of the main project folder.

%MainProjectName%: Replaces with the main project name.

%MicomToolPath%: Replaces with the absolute path of the install folder of this product.

%ProjectDir%: Replaces with the absolute path of the project folder.

%ProjectName%: Replaces with the project name.

%TempDir%: Replaces with the absolute path of the temporary folder.

%WinDir%: Replaces with the absolute path of the Windows system folder.

This corresponds to the -LIBrary option of the rlink command.

The library file name is displayed as the subproperty.

Default

Using libraries[number of defined items]

How to change

Edit by the Path Edit dialog box which appears when clicking the [...] button.

-> Edit by the Specify Using Library File dialog box which appears when clicking the [Browse...] button.

For the subproperty, you can enter directly in the text box.

Restriction

Up to 259 characters

Up to 65536 items can be specified.

System libraries

The system library files are displayed.

For the relative path, the reference point of the path is the main project or subproject folder.

This corresponds to the -LIBrary option of the rlink command.

The system library file name is displayed as the subproperty.

Default

System libraries[number of defined items]

How to change

Changes not allowed

Use standard/mathematical libraries

Select whether to use the standard/mathematical libraries provided by the compiler.

This corresponds to the -LIBrary option of the rlink command.

Default

No

How to change

Select from the drop-down list.

Restriction

Yes

Uses the standard/mathematical libraries.

No

Does not use the standard/mathematical libraries.

Check memory smashing on releasing memory

Selects whether to check memory smashing on releasing the memory.

This property is usable only in the Professional Edition.

The user-defined __heap_chk_fail() function is called if an illegal address has been specified or an address outside the allocated memory area has been written to when the memory that was dynamically allocated by malloc or another function is released or re-allocated by this function. See "CC-RL Compiler User's Manual" for details.

This corresponds to the -LIBrary option of the rlink command.

This property is displayed only in the following cases.

-

When [Always latest version which was installed] in the [Using compiler package version] property in the [Version Select] category from the [Common Options] tab is selected and the latest version is V1.03.00 or higher or when V1.03.00 or higher is selected in the [Using compiler package version] property

-

When [Yes] in the [Use standard/mathematical libraries] property is selected

Default

No

How to change

Select from the drop-down list.

Restriction

Yes

Checks memory smashing on releasing the memory.

No

Does not check memory smashing on releasing the memory.

Use runtime libraries

Select whether to use the runtime libraries provided by the compiler.

This corresponds to the -LIBrary option of the rlink command.

Default

No

How to change

Select from the drop-down list.

Restriction

Yes

Uses the runtime libraries.

No

Does not use the runtime libraries.

(5)

[List]

The detailed information on the list is displayed and the configuration can be changed.

Output link map file

Select whether to output the library list file.

This corresponds to the -LISt and -SHow options of the rlink command.

Default

No

How to change

Select from the drop-down list.

Restriction

Yes(List contents=not specify)(-LISt -SHow)

Outputs information according to the output format to the library list file.

Yes(List contents=ALL)(-LISt -SHow=ALL)

Outputs all information according to the output format to the library list file.

Yes(List contents=specify)(-LISt)

Outputs the specified information to the library list file.

No

Does not output the library list file.

Output file name

Specify the name of the link map file.

If the extension is omitted, it is automatically added according to the selection in the [Output file format] property in the [Output File] category.

When [User libraries(-FOrm=Library=U)] is selected: .lbp

When [System libraries(-FOrm=Library=S)] is selected: .lbp

When [Relocatable file(-FOrm=Relocate)] is selected: .map

The following placeholders are supported.

%ActiveProjectName%: Replaces with the active project name.

%BuildModeName%: Replaces with the build mode name.

%MainProjectName%: Replaces with the main project name.

%ProjectName%: Replaces with the project name.

This corresponds to the -LISt option of the rlink command.

This property is displayed when other than [No] in the [Output link map file] property is selected.

Default

%ProjectName%.lbp

How to change

Directly enter in the text box.

Restriction

Up to 259 characters

Output symbol information

Select whether to output the symbol information (symbol names within a module).

This corresponds to the -SHow=SYmbol option of the rlink command.

This property is displayed only when [Yes(List contents=specify)(-LISt)] in the [Output link map file] property is selected.

Default

No

How to change

Select from the drop-down list.

Restriction

Yes(-SHow=SYmbol)

Outputs the symbol information.

No

Does not output the symbol information.

Output section list in a module

Select whether to output the list of the section names within the module.

This corresponds to the -SHow=SEction option of the rlink command.

This property is displayed only when [Yes(List contents=specify)(-LISt)] in the [Output link map file] property is selected and [User libraries(-FOrm=Library=U)] or [System libraries(-FOrm=Library=S)] in the [Output file format] property in the [Output File] category is selected.

Default

No

How to change

Select from the drop-down list.

Restriction

Yes(-SHow=SEction)

Outputs the list of the section names within the module.

No

Does not output the list of the section names within the module.

Output cross reference information

Select whether to output the cross reference information.

This corresponds to the -SHow=XReference option of the rlink command.

This property is displayed only when [Yes(List contents=specify)(-LISt)] in the [Output link map file] property and [Relocatable file(-FOrm=Relocate)] in the [Output file format] property in the [Output File] category are selected.

Default

No

How to change

Select from the drop-down list.

Restriction

Yes(-SHow=Xreference)

Outputs the cross reference information.

No

Does not output the cross reference information.

Output total sizes of sections

Select whether to output the total size of sections.

This corresponds to the -SHow=Total_size option of the rlink command.

This property is displayed only when [Yes(List contents=specify)(-LISt)] in the [Output link map file] property and [Relocatable file(-FOrm=Relocate)] in the [Output file format] property in the [Output File] category are selected.

Default

No

How to change

Select from the drop-down list.

Restriction

Yes(-SHow=Total_size)

Outputs the total sizes of sections separately for ROM-allocated sections and RAM-allocated sections.

No

Does not output the total size of sections.

(6)

[Message]

The detailed information on messages is displayed and the configuration can be changed.

Enable information message output

Select whether to enable the output of information messages.

This corresponds to the -Message and -NOMessage options of the rlink command.

Default

No(-NOMessage)

How to change

Select from the drop-down list.

Restriction

Yes(-Message)

Outputs information messages.

No(-NOMessage)

Suppresses the output of information messages.

Suppress number of information message

Specify the number of the information message of which output is to be suppressed.

If multiple message numbers are specified, delimit them with "," (comma) (example: 4,200).

Also, a range of message numbers can be specified using "-" (hyphen) (example:4,200-203,1300).

This corresponds to the -NOMessage option of the rlink command.

This property is displayed when [No(-NOMessage)] in the [Enable information message output] property is selected.

Default

Blank

How to change

Directly enter in the text box or edit by the Character String Input dialog box which appears when clicking the [...] button.

Restriction

Up to 2048 characters

Change warning message to information message

Select whether to change the type of warning messages to information.

This corresponds to the -CHange_message option of the rlink command.

Default

No

How to change

Select from the drop-down list.

Restriction

Yes(All)(-CHange_message=Information)

Changes the type of all warning messages to information.

Yes(Specify message number)(-CHange_message=Information=<Message number>)

Specifies the number of warning message of which type is to be changed to information.

No

Does not change the type of warning messages.

Number of warning message

Specify the number of the warning message.

If multiple message numbers are specified, delimit them with "," (comma) (example: 4,200).

Also, a range of message numbers can be specified using "-" (hyphen) (example:4,200-203,1300).

This corresponds to the -CHange_message option of the rlink command.

This property is displayed only when [Yes(Specify message number)(-CHange_message=Information=<Message number>)] in the [Change warning message to information message] property is selected.

Default

Blank

How to change

Directly enter in the text box or edit by the Character String Input dialog box which appears when clicking the [...] button.

Restriction

Up to 2048 characters

Change information message to warning message

Select whether to change the type of information messages to warning.

This corresponds to the -CHange_message option of the rlink command.

Default

No

How to change

Select from the drop-down list.

Restriction

Yes(All)(-CHange_message=Warning)

Changes the type of all information messages to warning.

Yes(Specify message number)(-CHange_message=Warning=<Message number>)

Specifies the number of information message of which type is to be changed to warning.

No

Does not change the type of information messages.

Number of information message

Specify the number of the information message.

If multiple message numbers are specified, delimit them with "," (comma) (example: 4,200).

Also, a range of message numbers can be specified using "-" (hyphen) (example:4,200-203,1300).

This corresponds to the -CHange_message option of the rlink command.

This property is displayed only when [Yes(Specify message number)(-CHange_message=Information=<Message number>)] in the [Change warning message to information message] property is selected.

Default

Blank

How to change

Directly enter in the text box or edit by the Character String Input dialog box which appears when clicking the [...] button.

Restriction

Up to 2048 characters

Change information and warning message to error message

Select whether to change the type of information and warning messages to error.

This corresponds to the -CHange_message option of the rlink command.

Default

No

How to change

Select from the drop-down list.

Restriction

Yes(All)(-CHange_message=Error)

Changes the type of all information and warning messages to error.

Yes(Specify message number)(-CHange_message=Error=<Message number>)

Specifies the number of information or warning message of which type is to be changed to error.

No

Does not change the type of information and warning messages.

Number of information and warning message

Specify the number of the information and warning message.

If multiple message numbers are specified, delimit them with "," (comma) (example: 4,200).

Also, a range of message numbers can be specified using "-" (hyphen) (example:4,200-203,1300).

This corresponds to the -CHange_message option of the rlink command.

This property is displayed only when [Yes(Specify message number)(-CHange_message=Error=<Message number>)] in the [Change warning message to information message] property is selected.

Default

Blank

How to change

Directly enter in the text box or edit by the Character String Input dialog box which appears when clicking the [...] button.

Restriction

Up to 2048 characters

(7)

[Others]

Other detailed information on creating a library is displayed and the configuration can be changed.

Reduce memory occupancy

Select whether to reduce the memory usage.

This corresponds to the -MEMory option of the rlink command.

This property is displayed only in the following cases.

-

When [No] in the [Delete local symbol name information] property in the [Debug Information] category is selected

-

When [User libraries(-FOrm=Library=U)] or [System libraries(-FOrm=Library=S)] in the [Output file format] property in the [Output File] category is selected

Default

No(-MEMory=High)

How to change

Select from the drop-down list.

Restriction

Yes(-MEMory=Low)

Reduces the memory usage.

Select this item if processing is slow because a large project is linked and the memory size occupied by the linker exceeds the available memory in the machine used.

No(-MEMory=High)

Executes the same processing as usual.

Display total size of sections

Select whether to display the total size of sections after the linking.

This corresponds to the -Total_size option of the rlink command.

This property is displayed only when [Relocatable file(-FOrm=Relocate)] in the [Output file format] property in the [Output File] category.

Default

No

How to change

Select from the drop-down list.

Restriction

Yes(-Total_size)

Displays the total size of sections after the linking.

No

Does not display the total size of sections after the linki4ng.

Display copyright information

Select whether to display copyright information.

This corresponds to the -LOgo and -NOLOgo options of the rlink command.

Default

No(-NOLOgo)

How to change

Select from the drop-down list.

Restriction

Yes

Displays copyright information.

No(-NOLOgo)

Suppresses the output of copyright information.

Commands executed before create library processing

Specify the command to be executed before library generation processing.

Use the call instruction to specify a batch file (example: call a.bat).

The following placeholders are supported.

%ActiveProjectDir%: Replaces with the absolute path of the active project folder.

%ActiveProjectName%: Replaces with the active project name.

%BuildModeName%: Replaces with the build mode name.

%LibraryFile%: Replaces with the absolute path of the output file under the library generation processing.

%MainProjectDir%: Replaces with the absolute path of the main project folder.

%MainProjectName%: Replaces with the main project name.

%MicomToolPath%: Replaces with the absolute path of the install folder of this product.

%Options%: Replaces with the command line option under build execution.

%OutputDir%: Replaces with the absolute path of the output folder.

%OutputFile%: Replaces with the absolute path of the output file.

%Program%: Replaces with the program name under execution.

%ProjectDir%: Replaces with the absolute path of the project folder.

%ProjectName%: Replaces with the project name.

%TempDir%: Replaces with the absolute path of the temporary folder.

%WinDir%: Replaces with the absolute path of the Windows system folder.

When "#!python" is described in the first line, the contents from the second line to the last line are regarded as the script of the Python console, and then executed before library generation processing.

The placeholders can be described in the script.

The specified command is displayed as the subproperty.

This property is displayed only when [No] in the [Build simultaneously] property in the [Build Method] category from the [Common Options] tab is selected.

Default

Commands executed before library generate processing[number of defined items]

How to change

Edit by the Text Edit dialog box which appears when clicking the [...] button.

For the subproperty, you can enter directly in the text box.

Restriction

Up to 1023 characters

Up to 64 items can be specified.

Commands executed after create library processing

Specify the command to be executed after library generation processing.

Use the call instruction to specify a batch file (example: call a.bat).

The following placeholders are supported.

%ActiveProjectDir%: Replaces with the absolute path of the active project folder.

%ActiveProjectName%: Replaces with the active project name.

%BuildModeName%: Replaces with the build mode name.

%LibraryFile%: Replaces with the absolute path of the output file under the library generation processing.

%MainProjectDir%: Replaces with the absolute path of the main project folder.

%MainProjectName%: Replaces with the main project name.

%MicomToolPath%: Replaces with the absolute path of the install folder of this product.

%Options%: Replaces with the command line option under build execution.

%OutputDir%: Replaces with the absolute path of the output folder.

%OutputFile%: Replaces with the absolute path of the output file.

%Program%: Replaces with the program name under execution.

%ProjectDir%: Replaces with the absolute path of the project folder.

%ProjectName%: Replaces with the project name.

%TempDir%: Replaces with the absolute path of the temporary folder.

%WinDir%: Replaces with the absolute path of the Windows system folder.

When "#!python" is described in the first line, the contents from the second line to the last line are regarded as the script of the Python console, and then executed after library generation processing.

The placeholders can be described in the script.

The specified command is displayed as the subproperty.

This property is displayed only when [No] in the [Build simultaneously] property in the [Build Method] category from the [Common Options] tab is selected.

Default

Commands executed after library generate processing[number of defined items]

How to change

Edit by the Text Edit dialog box which appears when clicking the [...] button.

For the subproperty, you can enter directly in the text box.

Restriction

Up to 1023 characters

Up to 64 items can be specified.

Other additional options

Input the create library options to be added additionally.

The options set here are added at the end of the create library options group.

Default

Blank

How to change

Directly enter in the text box or edit by the Character String Input dialog box which appears when clicking the [...] button.

Restriction

Up to 259 characters