[Common Options] tab


This tab shows the detailed information on the build tool categorized by the following and the configuration can be changed.

 

(1) [Build Mode]

(2) [CPU]

(3) [PIC/PID]

(4) [Output File Type and Path]

(5) [Frequently Used Options(for Compile)]

(6) [Frequently Used Options(for Assemble)]

(7) [Frequently Used Options(for Link)]

(8) [Frequently Used Options(for Hex Output)]

(9) [Frequently Used Options(for Librarian)]

(10) [Build Method]

(11) [Version Select]

(12) [Notes]

(13) [Others]

Remark

If the property in the [Frequently Used Options] category is changed, the value of the property having the same name contained in the corresponding tab will be changed accordingly.

Figure A.2

Property Panel: [Common options] Tab

Remark

This figure is the image when the version of the compiler package is V2.01.00 or higher.

[Description of each category]

(1)

[Build Mode]

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

Build mode

Selects the build mode to be used during build.

Note that this property is not applied to [Reset All to Default] from the context menu.

Default

DefaultBuild

How to change

Select from the drop-down list.

Restriction

DefaultBuild

Builds with the default build mode that is set when a new project is created.

Build mode that is added to the project (other than DefaultBuild)

Builds with the build mode that is added to the project (other than DefaultBuild).

Change property value for all build modes at once

Selects whether to reflect the value newly set to all build modes when a value is set in this property.

Be careful since the value set may not be an appropriate value for other build modes.

Default

No

How to change

Select from the drop-down list.

Restriction

Yes

Reflects the value newly set to all build modes when a value is set in this property.

No

Does not reflect the value newly set to all build modes when a value is set in this property.

(2)

[CPU]

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

Instruction-set architecture

Selects the instruction-set architecture.

This corresponds to the -isa option of the compiler and library generator, -isa option of the assembler.

This property is displayed when [Always latest version which was installed] in the [Using compiler package version] property in the [Version Select] category is selected and the latest version is V2.01.00 or higher or when V2.01.00 or higher is selected in the [Using compiler package version] property.

Default

The default value is set by selected device on creating project.

How to change

Select from the drop-down list.

Restriction

RXv1 architecture
(-isa=rxv1)

Generates an instruction code for the RXv1 architecture.

RXv2 architecture
(-isa=rxv2)

Generates an instruction code for the RXv2 architecture.

None

It allows the Microcontroller type setting.

Microcontroller type

Selects the microcontroller type.

This corresponds to the -cpu option of the compiler and library generator, -cpu option of the assembler.

Default

RX600 series (-cpu=rx600)

How to change

Select from the drop-down list.

Restriction

RX600 series (-cpu=rx600)

Generates an instruction code for the RX600 Series.

RX200 or RX100 series (-cpu=rx200)

Generates an instruction code for the RX200 Series.

Uses floating-point operation instructions

Selects whether to use floating-point operation instructions.

This corresponds to the -fpu and -nofpu option of the compiler, and to the -fpu and -nofpu option of the assembler.

This property is displayed when [Always latest version which was installed] in the [Using compiler package version] property in the [Version Select] category is selected and the latest version is V2.01.00 or higher or when V2.01.00 or higher is selected in the [Using compiler package version] property.

When the version is V2.01.00 or lower, this property is displayed in the [Compile Options] tab.

Default

-

When [None] in the [Instruction-set architecture] property is selected:

Depends on the Microcontroller type option

-

Other than above:

The peculiar value for the target device

How to change

Select from the drop-down list.

Restriction

Depends on the Microcontroller type option

Depends on the Microcontroller type option.

This item is not available when other than [None] in the [Instruction-set architecture] property is selected.

Yes (-fpu)

Outputs an object that uses FPU instructions.

This item is not available when [RX200 series (-cpu=rx200)] in the [Microcontroller type] property is selected.

No (-nofpu)

Outputs an object that does not use FPU instructions.

Endian type for data

Selects endian type for data.

This corresponds to the -endian option of the compiler and library generator, -endian option of assembler.

Default

Little-endian data (-endian=little)

How to change

Select from the drop-down list.

Restriction

Big-endian data (-endian=big)

Arranges data bytes in big endian.

Little-endian data (-endian=little)

Arranges data bytes in little endian.

Rounding method for floating-point constant operations

Selects rounding method for floating-point constant operations.

This option does not affect the method of rounding for floating-point operations during program execution.

This corresponds to the -round option of the compiler and library generator.

Default

round to nearest (-round=nearest)

How to change

Select from the drop-down list.

Restriction

round to zero (-round=zero)

Rounds values to zero.

round to nearest (-round=nearest)

Rounds values to the nearest value.

Handling of denormalized numbers in floating-point constants

Selects handling of denormalized numbers in floating-point constants.

This option does not affect the method of rounding for floating-point operations during program execution.

This corresponds to the -denormalize option of the compiler and library generator.

Default

Handles as zeros (-denormalize=off)

How to change

Select from the drop-down list.

Restriction

Handles as zeros (-denormalize=off)

Handles denormalized numbers as zero.

Handles as they are (-denormalize=on)

Handles denormalized numbers as they are.

Precision of the double type and long double type

Selects precision of the double type and long double type.

This corresponds to the -dbl_size option of the compiler and library generator.

Default

Handles in single precision (-dbl_size=4)

How to change

Select from the drop-down list.

Restriction

Handles in single precision (-dbl_size=4)

Handles the double type and long double type in single precision.

Handles in double precision (-dbl_size=8)

Handles the double type and long double type in double precision.

Replaces the int type with the short type

Selects whether to replace the int type with the short type.

This corresponds to the -int_to_short option of the compiler and library generator.

Default

No

How to change

Select from the drop-down list.

Restriction

Yes (-int_to_short)

Replaces the int type with the short type and the unsigned int type with the unsigned short type.

No

Does not replace the int type with the short type and the unsigned int type with the unsigned short type.

Sign of the char type

Selects sign of the char type with no sign specification.

This corresponds to the -signed_char and -unsigned_char options of the compiler and library generator.

Default

Handles as unsigned char (-unsigned_char)

How to change

Select from the drop-down list.

Restriction

Handles as signed char (-signed_char)

Handles the char type as signed char.

Handles as unsigned char (-unsigned_char)

Handles the char type as unsigned char.

Sign of the bit-field type

Selects sign of the bit-field type with no sign specification.

This corresponds to the -signed_bitfield and -unsigned_bitfield options of the compiler and library generator.

Default

Handles as unsigned (-unsigned_bitfield)

How to change

Select from the drop-down list.

Restriction

Handles as signed (-signed_bitfield)

Handles the sign of a bit-field as signed.

Handles as unsigned (-unsigned_bitfield)

Handles the sign of a bit-field as unsigned.

Selects the enumeration type size automatically

Selects whether to automatically selects the enumeration type size.

This corresponds to the -auto_enum option of the compiler and library generator.

Default

No

How to change

Select from the drop-down list.

Restriction

Yes (-auto_enum)

Processes the enumerated data qualified by enum as the minimum data type with which the enumeration value can fit in.

No

Processes the enumeration type size as the signed long type.

Order of bit-field members

Selects order of bit-field members.

This corresponds to the -bit_order option of the compiler and library generator.

Default

Allocates from right (-bit_order=right)

How to change

Select from the drop-down list.

Restriction

Allocates from left (-bit_order=left)

Allocates members from the upper bit.

Allocates from right (-bit_order=right)

Allocates members from the lower bit.

Assumes the boundary alignment value for structure members is 1

Selects whether to assume the boundary alignment value for structure members is 1.

This corresponds to the -pack and -unpack options of the compiler and library generator.

Default

No (-unpack)

How to change

Select from the drop-down list.

Restriction

Yes (-pack)

Assumes the boundary alignment value for structure members is 1.

No (-unpack)

Follows the boundary alignment.

Enables C++ exceptional handling function (try, catch and throw)

Selects whether to enable C++ exceptional handling function (try, catch and throw).

This corresponds to the -exception and -noexception options of the compiler and library generator.

Default

No (-noexception)

How to change

Select from the drop-down list.

Restriction

Yes (-exception)

Enables the exception handling function.

No (-noexception)

Disables the exception handling function.

Enables the C++ exceptional handling function (dynamic_cast and typeid)

Selects whether to enable the C++ exceptional handling function (dynamic_cast and typeid).

This corresponds to the -rtti option of the compiler and library generator.

Default

No (-rtti=off)

How to change

Select from the drop-down list.

Restriction

Yes (-rtti=on)

Enables dynamic_cast and typeid.

No (-rtti=off)

Disables dynamic_cast and typeid.

General registers used only in fast interrupt functions

Selects registers used only for fast interrupts.

If a register specified by this option has been specified by the -base option, an error will occur.

This corresponds to the -fint_register option of the compiler and library generator, -fint_register option of the assembler.

Default

None (-fint_register=0)

How to change

Select from the drop-down list.

Restriction

None (-fint_register=0)

No registers are used only for fast interrupts.

R13 (-fint_register=1)

R13 is used only for fast interrupts.

R12, R13 (-fint_register=2)

R13 and R12 are used only for fast interrupts.

R11 to R13 (-fint_register=3)

R13 to R11 are used only for fast interrupts.

R10 to R13 (-fint_register=4)

R13 to R10 are used only for fast interrupts.

Branch width size

Selects branch width size.

This corresponds to the -branch option of the compiler and library generator.

Default

Compiles within 24 bits (-branch=24)

How to change

Select from the drop-down list.

Restriction

Compiles within 16 bits (-branch=16)

Compiles the program with a branch width within 16 bits.

Compiles within 24 bits (-branch=24)

Compiles the program with a branch width within 24 bits.

No specified (-branch=32)

Does not specify the branch width.

Base register for ROM

Specifies the general register used as a fixed base address throughout the program.

When "base=rom=register A" is specified, accesses to const variables are all performed relative to the specified "register A".

Note that the total size of the constant area section must be within 64 Kbytes to 256 Kbytes.

This corresponds to the -base option of the compiler and library generator, -base option of the assembler.

This property is displayed only when [No] in the [Enables the PID function] property in the [PIC/PID] category is selected.

Default

None

How to change

Select from the drop-down list.

Restriction

None

Does not specify the base register for ROM.

R8 (-base=rom=R8)

Specifies R8 as the base register for ROM.

R9 (-base=rom=R9)

Specifies R9 as the base register for ROM.

R10 (-base=rom=R10)

Specifies R10 as the base register for ROM.

R11 (-base=rom=R11)

Specifies R11 as the base register for ROM.

R12 (-base=rom=R12)

Specifies R12 as the base register for ROM.

R13 (-base=rom=R13)

Specifies R13 as the base register for ROM.

Base register for RAM

Specifies the general register used as a fixed base address throughout the program.

When "base=ram=register B" is specified, accesses to initialized variables and uninitialized variables are all performed relative to the specified "register B".

Note that the total RAM data size must be within 64 Kbytes to 256 Kbytes.

This corresponds to the -base option of the compiler and library generator, -base option of the assembler.

Default

None

How to change

Select from the drop-down list.

Restriction

None

Does not specify the base register for RAM.

R8 (-base=ram=R8)

Specifies R8 as the base register for RAM.

R9 (-base=ram=R9)

Specifies R9 as the base register for RAM.

R10 (-base=ram=R10)

Specifies R10 as the base register for RAM.

R11 (-base=ram=R11)

Specifies R11 as the base register for RAM.

R12 (-base=ram=R12)

Specifies R12 as the base register for RAM.

R13 (-base=ram=R13)

Specifies R13 as the base register for RAM.

Address value of base register that sets the address value

Specifies the Address value of base register that sets the address value.

This corresponds to the -base option of the compiler and library generator, -base option of the assembler.

Default

00000000 (hexadecimal number)

How to change

Directly enter in the text box.

Restriction

0 to FFFFFFFF (hexadecimal number)

Register of base register that sets the address value

Specifies the general register used as a fixed base address throughout the program.

When "address value=register C" is specified, accesses to an area within 64 Kbytes to 256 Kbytes from the address value, among the areas whose addresses are already determined at the time of compilation, are performed relative to the specified "register C".

This corresponds to the -base option of the compiler and library generator, -base option of the assembler.

Default

None

How to change

Select from the drop-down list.

Restriction

None

Does not specify the base register that sets the address value.

R8 (-base=<address value>=R8)

Specifies R8 as the base register that sets the address value.

R9 (-base=<address value>=R9)

Specifies R9 as the base register that sets the address value.

R10 (-base=<address value>=R10)

Specifies R10 as the base register that sets the address value.

R11 (-base=<address value>=R11)

Specifies R11 as the base register that sets the address value.

R12 (-base=<address value>=R12)

Specifies R12 as the base register that sets the address value.

R13 (-base=<address value>=R13)

Specifies R13 as the base register that sets the address value.

Avoids a problem specific to the CPU type

Selects avoid a problem specific to the CPU type.

This corresponds to the -patch option of the compiler and library generator, -patch option of the assembler.

Default

No

How to change

Select from the drop-down list.

Restriction

No

The code generated in response to the call by the intrinsic function set_ipl will contain the MVTIPL instruction.

Yes(for RX610 Group) (-patch=rx610)

Does not use the MVTIPL instruction in the generated code.

Saves and restores ACC using the interrupt function

Selects whether to save and restore Accumulator(ACC) using the interrupt function.

The generated saved and restored code is the same code generated when acc is selected in #pragma interrupt.

This corresponds to the -save_acc option of the compiler and library generator.

Default

No

How to change

Select from the drop-down list.

Restriction

Yes (-save_acc)

Saves and restores ACC using the interrupt function.

No

Does not save and restore ACC using the interrupt function.

(3)

[PIC/PID]

The detailed information on the PIC/PID function is displayed and the configuration can be changed.

Enables the PIC function

Selects whether to enable the PIC(position independent code) function.

In PIC, all function calls are performed with BSR or BRA instructions.

When acquiring the address of a function, a relative address from the PC should be used.

This allows PIC to be located at a desired address after linkage.

This option corresponds to the -pic option of the compiler and library generator, -pic option of the assembler.

Default

No

How to change

Select from the drop-down list.

Restriction

Yes (-pic)

Enables the PIC function.

No

Disables the PIC function.

Enables the PID function

Selects whether to enable the PID(position independent data) function.

The constant area sections C, C_2, and C_1, the literal section L, and the switch statement branch table sections W, W_2, and W_1 are handled as PID (position independent data).

PID can be accessed through a relative address from the PID register.

This corresponds to the -pid option of the compiler and library generator, the -pid option of the assembler.

This property is displayed only when [None] in the [Base register for ROM] property in the [CPU] category, and [Yes] in the [Uses the PID register for code generation] property is selected.

Default

No

How to change

Select from the drop-down list.

Restriction

Yes (The maximum bit width of the offset: 16 bits) (-pid=16)

Enables the PID function.

16-bit (64 Kbytes to 256 Kbytes) addressing mode is supported.

Yes (The maximum bit width of the offset: No limitation) (-pid=32)

Enables the PID function.

32-bit (4 Gbytes) addressing mode is supported.

No

Disables the PID function.

Uses the PID register for code generation

Selects whether to use the PID register for code generation.

A master program called by an application program in which the PID function is enabled needs to be compiled/assembled with this option.

This corresponds to the -nouse_pid_register option of the compiler and library generator, the -nouse_pid_register option of the assembler.

This property is displayed only when [No] in the [Enables the PID function] property is selected.

Default

Yes

How to change

Select from the drop-down list.

Restriction

Yes

Uses the PID register for code generation.

No (-nouse_pid_register)

Does not use the PID register for code generation.

(4)

[Output File Type and Path]

The detailed information on output file types and paths is displayed and the configuration can be changed.

Output file type

Selects the type of the file to be generated during a build.

The file type set here will be the debug target.

For other than the library project, only [Execute Module(Load Module File)] and [Execute Module(Hex File)] are displayed.

For the library project, only [Library] is displayed.

Default

-

For other than the library project

Execute Module(Load Module File)

-

For the library project

Library

How to change

Select from the drop-down list.

Restriction

Execute Module(Load Module File)

Generates a load module file and hex file during a build.

The load module file will be the debug target.

Execute Module(Hex File)

Generates a load module file and hex file during a build.

The hex file will be the debug target.

Library

Generates a library file during a build.

Intermediate file output folder

Specifies the folder which the intermediate file is output.

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

If an absolute path is specified, the reference point of the path is the main project or subproject folder (unless the drives are different).

The following placeholder is supported.

%BuildModeName%: Replaces with the build mode name.

%ProjectName%: Replaces with the project name.

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

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

This property is displayed when [Always latest version which was installed] in the [Using compiler package version] property in the [Version Select] category is selected and the latest version is V2.00.00 or higher or when V2.00.00 or higher is selected in the [Using compiler package version] property.

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

(5)

[Frequently Used Options(for Compile)]

The detailed information on frequently used options during compilation is displayed and the configuration can be changed.

Additional include paths

Specifies the name of the path to the folder that stores the include file.

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.

The reference point of the path is the project folder.

This corresponds to the -include option of the compiler.

The specified include path is displayed as the subproperty.

Default

Additional include paths[number of defined items]

How to change

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

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

Restriction

Up to 247 characters.

Up to 65536 items can be specified.

System include paths

Changes the specified order of the include paths which the system set during compiling.

This corresponds to the -include option of the compiler.

Default

System include paths[number of defined items]

How to change

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

Restriction

Changes not allowed (Only the specified order of the include paths can be changed.)

Macro definition

Specifies the macro name to be defined.

Specify in the format of "macro name=string", with one macro name per line.

The "=string" part can be omitted, and in this case, the macro name is assumed to be defined.

This corresponds to the -define option of the compiler.

The specified macro is displayed as the subproperty.

Default

Macro definition[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 use the text box directly enter the text.

Restriction

Up to 32767 characters

Up to 65536 items can be specified.

Outputs debugging information

Selects whether to output debugging information to object module files.

This corresponds to the -debug and -nodebug options of the compiler.

Default

No (-nodebug)

How to change

Select from the drop-down list.

Restriction

Yes (-debug)

Outputs debugging information to object module files.

No (-nodebug)

Does not output debugging information to object module files.

Optimization level

Selects optimization level.

This corresponds to the -optimize option of the compiler.

Default

2 (-optimize=2)

How to change

Select from the drop-down list.

Restriction

0 (-optimize=0)

Does not optimize the program.

1 (-optimize=1)

Partially optimizes the program by automatically allocating variables to registers, integrating the function exit blocks, integrating multiple instructions which can be integrated, etc.

2 (-optimize=2)

Performs overall optimization.

Max (-optimize=max)

Performs optimization as much as possible.

Outputs additional information for inter-module optimization

Selects whether to output additional information for inter-module optimization.

At linkage, inter-module optimization is applied to files for which this option has been specified.

This corresponds to the -goptimize option of the compiler.

Default

No

How to change

Select from the drop-down list.

Restriction

Yes (-goptimize)

Outputs additional information for inter-module optimization.

No

Does not outputs additional information for inter-module optimization.

Optimization type

Selects optimization type.

This corresponds to the -speed and -size option of the compiler.

Default

Optimizes with emphasis on code size (-size)

How to change

Select from the drop-down list.

Restriction

Optimizes with emphasis on execution performance (-speed)

Optimizes with emphasis on execution performance.

Optimizes with emphasis on code size (-size)

Optimizes with emphasis on code size.

Outputs a source list file

Selects whether to output a source list file.

This corresponds to the -listfile and -nolistfile option of the compiler.

Default

No (-nolistfile)

How to change

Select from the drop-down list.

Restriction

Yes (-lisfile)

Outputs a source list file.

No (-nolistfile)

Disable output of a source list file.

Outputs the C/C++ source file

Specifies the contents of the source list file.

Selects whether to output the C/C++ source file.

This corresponds to the -show option of the compiler.

This property is not displayed when [Yes (-lisfile)] in the [Outputs a source list file] property is selected.

Default

No

How to change

Select from the drop-down list.

Restriction

Yes (-show=source)

Outputs the C/C++ source file.

No

Does not output the C/C++ source file.

Outputs the statements unsatisfied in conditional assembly

Specifies the contents of the source list file.

Selects whether to output the statements unsatisfied in conditional assembly.

This corresponds to the -show option of the compiler.

This property is not displayed when [Yes (-lisfile)] in the [Outputs a source list file] property is selected.

Default

No

How to change

Select from the drop-down list.

Restriction

Yes (-show=conditionals)

Outputs the statements unsatisfied in conditional assembly.

No

Does not output the statements unsatisfied in conditional assembly.

Outputs the information before .DEFINE replacement

Specifies the contents of the source list file.

Selects whether to output the information before .DEFINE replacement.

This corresponds to the -show option of the compiler.

This property is not displayed when [Yes (-lisfile)] in the [Outputs a source list file] property is selected.

Default

No

How to change

Select from the drop-down list.

Restriction

Yes (-show=definitions)

Outputs the information before .DEFINE replacement.

No

Does not output the information before .DEFINE replacement.

Outputs the assembler macro expansion statements

Specifies the contents of the source list file.

Selects whether to output the assembler macro expansion statements.

This corresponds to the -show option of the compiler.

This property is not displayed when [Yes (-lisfile)] in the [Outputs a source list file] property is selected.

Default

No

How to change

Select from the drop-down list.

Restriction

Yes (-show=expansions)

Outputs the assembler macro expansion statements.

No

Does not output the assembler macro expansion statements.

(6)

[Frequently Used Options(for Assemble)]

The detailed information on frequently used options during assembling is displayed and the configuration can be changed.

Additional include paths

Specifies the name of the path to the folder that stores the include file.

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.

The reference point of the path is the project folder.

This corresponds to the -include option of the assembler.

The specified include path is displayed as the subproperty.

Default

Additional include paths[number of defined items]

How to change

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

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

Restriction

Up to 247 characters

Up to 65536 items can be specified.

System include paths

Changes the specified order of the include paths which the system set during assembling.

This corresponds to the -include option of the assembler.

Default

System include paths[number of defined items]

How to change

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

Restriction

Changes not allowed (Only the specified order of the include paths can be changed.)

Macro definition

Specifies the macro name to be defined.

Specifies in the format of "macro name=string", with one macro name per line.

This corresponds to the -define option of the assembler.

The specified macro is displayed as the subproperty.

Default

Macro definition[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 use the text box directly enter the text.

Restriction

Up to 32767 characters

Up to 65536 items can be specified.

Outputs debugging information

Selects whether to output debugging information to object module files.

This corresponds to the -debug and -nodebug options of the assembler.

This property is not displayed when [No] in the [Build simultaneously] property is selected.

Default

No (-nodebug)

How to change

Select from the drop-down list.

Restriction

Yes (-debug)

Outputs debugging information to object module files.

No (-nodebug)

Does not output debugging information to object module files.

Output additional information for inter-module optimization

Selects whether to output additional information for inter-module optimization.

At linkage, inter-module optimization is applied to files for which this option has been specified.

This corresponds to the -goptimize option of the assembler.

This property is displayed only when [No] in the [Build simultaneously] property is selected.

Default

No

How to change

Select from the drop-down list.

Restriction

Yes (-goptimize)

Outputs additional information for inter-module optimization.

No

Does not output additional information for inter-module optimization.

Outputs a assemble list file

Selects whether to output an assemble list file.

This corresponds to the -listfile and -nolistfile option of the assembler.

This property is displayed only when [No] in the [Build simultaneously] property is selected.

Default

No (-nolistfile)

How to change

Select from the drop-down list.

Restriction

Yes (-listfile)

Outputs an assemble list file.

No (-nolistfile)

Does not output an assemble list file.

Outputs the statements unsatisfied in conditional assembly

Specifies the contents of the assemble list file.

Selects whether to output the statements unsatisfied in conditional assembly.

This corresponds to the -show option of the assembler.

This property is displayed only when [Yes (-listfile)] in the [Output a assemble list file] property is selected.

Default

No

How to change

Select from the drop-down list.

Restriction

Yes (-show=conditionals)

Outputs the statements unsatisfied in conditional assembly.

No

Does not output the statements unsatisfied in conditional assembly.

Outputs the information before .DEFINE replacement

Specifies the contents of the assemble list file.

Selects whether to output the information before .DEFINE replacement.

This corresponds to the -show option of the assembler.

This property is displayed only when [Yes (-listfile)] in the [Output a assemble list file] property is selected.

Default

No

How to change

Select from the drop-down list.

Restriction

Yes (-show=definitions)

Outputs the information before replacement specified with .DEFINE.

No

Does not output the information before replacement specified with .DEFINE.

Outputs the assembler macro expansion statements

Specifies the contents of the assemble list file.

Selects whether to output the assembler macro expansion statements.

This corresponds to the -show option of the assembler.

This property is displayed only when [Yes (-listfile)] in the [Output a assemble list file] property is selected.

Default

No

How to change

Select from the drop-down list.

Restriction

Yes (-show=expansions)

Outputs the macro expansion statements.

No

Does not output the macro expansion statements.

(7)

[Frequently Used Options(for Link)]

The detailed information on frequently used options during linking is displayed and the configuration can be changed.

This category is not displayed for the library project.

Using libraries

Specifies an input library file.

The following placeholders are supported.

%BuildModeName%: Replaces with the build mode name.

%ProjectName%: Replaces with the project name.

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

This corresponds to the -library option of the linker.

The library file name is displayed as the subproperty.

Default

Input object module file[number of defined items]

How to change

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

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

Restriction

Up to 32767 characters

Up to 65536 items can be specified.

Outputs debugging information

Specifies whether debugging information is output.

This corresponds to the -nodebug, -sdebug, and -debug options of the linker.

Default

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

How to change

Select from the drop-down list.

Restriction

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

Outputs a debugging information to the output file.

Yes (Outputs to <output file name>.dbg file) (-SDebug)

Outputs a debugging information to <output file name>.dbg file.

No (-NODEBug)

Does not output a debugging information.

Optimization type

Specifies optimization type.

This corresponds to the -nooptimize and -optimize options of the linker.

Default

No optimize (-NOOPtimize)

How to change

Select from the drop-down list.

Restriction

No optimize (-NOOPtimize)

Does not execute optimization for a module.

All(-OPtimize)

Provides all optimizations.

Speed-oriented optimization (-OPtimize=SPeed)

Provides optimization for speed.

Safe optimization (-OPtimize=SAFe)

Provides safe optimization.

Custom

Performs optimization for the specified options.

Deletes variables/functions that are not referenced

Selects whether to delete variables/functions that are not referenced.

This corresponds to the -optimize option of the linker.

This property is displayed only when [Custom] in the [Optimization type] property is selected.

Default

No

How to change

Select from the drop-down list.

Restriction

Yes (-OPtimize=SYmbol_delete)

Deletes variables/functions that are not referenced.

No

Does not delete variables/functions that are not referenced.

Creates a subroutine for the same instruction sequence

Selects whether to create a subroutine for the same instruction sequence.

This corresponds to the -optimize option of the linker.

This property is displayed only when [Custom] in the [Optimization type] property is selected.

Default

No

How to change

Select from the drop-down list.

Restriction

Yes (-OPtimize=SAMe_code)

Creates a subroutine for the same instruction sequence.

No

Does not create a subroutine for the same instruction sequence.

Minimum code size

Specifies the minimum code size for the optimization.

This corresponds to the -samesize option of the linker.

This property is displayed only when [Yes (-OPtimize=SAMe_code)] in the [Creates a subroutine for the same instruction sequence] property is specified.

Default

1E (hexadecimal number)

How to change

Directly enter in the text box.

Restriction

8 to 7FFF (hexadecimal number)

Replaces an instruction with a smaller-size instruction

Selects whether to replace an instruction with a smaller-size instruction.

This corresponds to the -optimize option of the linker.

This property is displayed only when [Custom] in the [Optimization type] property is selected.

Default

No

How to change

Select from the drop-down list.

Restriction

Yes (-OPtimize=SHort_format)

Replaces an instruction with a smaller-size instruction.

No

Does not replace an instruction with a smaller-size instruction.

Optimizes branch instruction size

Selects whether to optimize branch instruction size.

This corresponds to the -optimize option of the linker.

This property is displayed only when [Custom] in the [Optimization type] property is selected.

Default

No

How to change

Select from the drop-down list.

Restriction

Yes(-OPtimize=Branch)

Optimizes branch instruction size according to program allocation information.

No

Does not optimize branch instruction size.

Section start address

Specifies the section start address.

This corresponds to the -start option of the linker.

Default

The peculiar value for the target device

How to change

Directly enter in the text box or edit by the Section Settings dialog box which appears when clicking the [...] button.

Restriction

Up to 1022 characters

(8)

[Frequently Used Options(for Hex Output)]

The detailed information on frequently used options during hex output is displayed and the configuration can be changed.

This category is not displayed for the library project.

Output hex file

Specifies whether hex file is output.

Default

Yes

How to change

Select from the drop-down list.

Restriction

Yes

Outputs a hex file.

No

Does not output a hex file.

Load module file convert format

Selects the load module file convert format.

This corresponds to the -form option of the linker.

Default

S record file (-FOrm=Stype)

How to change

Select from the drop-down list.

Restriction

Intel expanded hex file (-FOrm=Hexadecimal)

Outputs a Intel expanded hex file.

Motorola S type file (-FOrm=Stype)

Outputs a Motorola S-type file.

Binary file (-FOrm=Binary)

Outputs a binary file.

Output folder

Specifies path of 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.

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

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

%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 linker.

This property is displayed only when [Yes] in the [Output hex file] property is selected.

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

Specifies the output file name.

The default extensions depends on [Load module file convert format] property when extension omitted.

The default extensions are as follows:

"Hex file (-FOrm=Hexadecimal)" : .hex

"S record file (-FOrm=Stype)" : .mot

"Binary data file (-FOrm=Binary)" : .bin.

The following placeholders are supported.

%BuildModeName%: Replaces with the build mode name.

%ProjectName%: Replaces with the project name.

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

This corresponds to the -output option of the linker.

This property is displayed only when [Yes] in the [Output hex file] property is selected.

Default

-

When [Hex file (-FOrm=Hexadecimal)] in the [Load module file convert format] property is selected

%ProjectName%.hex

-

When [S record file (-FOrm=Stype)] in the [Load module file convert format] property is selected

%ProjectName%.mot

-

When [Binary data file (-FOrm=Binary)] in the [Load module file convert format] property is selected

%ProjectName%.bin

How to change

Directly enter in the text box.

Restriction

Up to 259 characters

Division output file

Specifies the division conversion file.

Specifies in the format of "file name=start address-end address" or "file name=section name", with one file name per line.

Specifies an address in the hexadecimal notation (example: file2.mot=400-ffff).

To define multiple sections, use a colon to separate each entry written, as in "file name=section name:section name" (example: file1.mot=stack:istack).

The default extensions depends on [Load module file convert format] property when extension omitted.

The default extensions are as follows:

"Hex file (-FOrm=Hexadecimal)" : .hex

"S record file (-FOrm=Stype)" : .mot

"Binary data file (-FOrm=Binary)" : .bin.

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.

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

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

%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 -output option of the linker.

This property is displayed only when [Yes] in the [Output hex file] property is selected.

Default

Division conversion 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 use the text box directly enter the text.

Restriction

Up to 255 characters

Up to 65536 items can be specified.

(9)

[Frequently Used Options(for Librarian)]

The detailed information on frequently used options during library generating is displayed and the configuration can be changed.

This category is displayed only for the library project and when [Relocatable module file (-FOrm=Relocate)] in the [Output file type] property in the [Output] category from [Librarian Options] tab is selected.

Outputs debugging information

Specifies whether debugging information is output.

This corresponds to the -nodebug and -debug options of the linker.

Default

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

How to change

Select from the drop-down list.

Restriction

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

Outputs a debugging information to the output file.

No (-NODEBug)

Does not output a debugging information.

(10)

[Build Method]

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

Build simultaneously

Selects whether to generate the load module file by compiling/assembling/linking multiple files simultaneously.

The files with the individual build options and files to be executed prior to the build are excluded from running a build simultaneously.

See "2.2.1 Running simultaneous build" for details about running a build simultaneously.

This property is displayed when [Always latest version which was installed] in the [Using compiler package version] property in the [Version Select] category is selected and the latest version is V2.00.00 or higher or when V2.00.00 or higher is selected in the [Using compiler package version] property.

Default

Yes

How to change

Select from the drop-down list.

Restriction

Yes

Compiles, assembles, and links multiple files simultaneously.

No

Compiles, assembles, and links for each file.

Build in parallel

Selects whether to enable the parallel build facility.

The parallel build facility enables CS+ to compile/assemble multiple source files in parallel using all processors mounted on the computer. This speeds up compilation/assemble.

In addition, parallel build between projects can be set by selecting [Tool] menu >> [Option] and then making a setting in the [General - Build] category of the Option dialog box.

See "2.2.2 Running parallel build" for details about parallel build.

Default

No

How to change

Select from the drop-down list.

Restriction

Yes

Enables the parallel build facility.

No

Disables the parallel build facility.

Handling the source file includes non-existing file

Selects whether to recompile/assemble the source file if there are no files that include it.

Default

Re-compile/assemble the source file

How to change

Select from the drop-down list.

Restriction

Re-compile/assemble the source file

Recompiles/assembles the source file if there are no files that include it.

Ignore re-compiling/assembling the source file

Does not recompile/assemble the source file if there are no files that include it.

Ensure compatibility of paths and linkage order

Selects compatibility with High-performance embedded workshop about paths and linkage order.

Default

No

How to change

Select from the drop-down list.

Restriction

Yes

Accords to the High-performance Embedded Workshop's linkage order.

No

Accords to this product's path and linkage order.

(11)

[Version Select]

The detailed information on the build tool version is displayed and the configuration can be changed.

Using compiler package install folder

The folder in which the compiler package to be used is installed is displayed.

Default

Install folder name

How to change

Changes not allowed

Using compiler package version

Selects the version of the compiler package to be used.

This setting is common to all the build modes.

Default

Always latest version which was installed

How to change

Select from the drop-down list.

Restriction

Always latest version which was installed

Uses the latest version in the installed compiler packages.

Versions of the installed compiler packages

Uses the selected version in the compiler package.

Latest compiler package version which was installed

The version of the compiler package to be used when [Always latest version which was installed] is selected in the [Using compiler package version] property is displayed.

This setting is common to all the build modes.

This property is displayed only when [Always latest version which was installed] in the [Using compiler package version] property is selected.

Default

The latest version of the installed compiler packages

How to change

Changes not allowed

(12)

[Notes]

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

Memo

Adds memos to the build tool.

Adds one item in one line.

This setting is common to all the build modes.

The added memos are displayed as the subproperty.

Default

Memo[number-of-items]

How to change

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

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

Restriction

Up to 256 characters

Up to 256 items can be specified.

(13)

[Others]

Other detailed information on the build tool are displayed and the configuration can be changed.

Output message format

Specifies the format of the message being built.

This applies to the messages output by the build tool to be used, and commands added by plugins.

It does not apply to the output messages of commands specified in the [Commands executed before build processing] or [Commands executed after build processing] property.

The following placeholders are supported.

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

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

%TargetFiles%: Replaces with the file name being built.

If this is blank, it is assumed that "%Program% %Options%" will be set automatically.

Default

%TargetFiles%

How to change

Directly enter to the text box (up to 256 characters) or select from the drop-down list.

Restriction

%TargetFiles%

Displays the file name in the output message.

%TargetFiles%: %Options%

Displays the file name and command line options in the output message.

%Program% %Options%

Displays the program name and command line options in the output message.

Format of build option list

Specifies the display format of the build option list.

This applies to the options of the build tool to be used, and commands added by plugins.

It does not apply to the options of commands specified in the [Commands executed before build processing] or [Commands executed after build processing] property.

The following placeholders are supported.

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

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

%TargetFiles%: Replaces with the file name being built.

If this is blank, it is assumed that "%TargetFiles% : %Program% %Options%" will be set automatically.

Default

%TargetFiles% : %Program% %Options%

How to change

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

Restriction

Up to 256 characters

Commands executed before build processing

Specifies the command to be executed before build 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.

%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.

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

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

%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 build processing.

The placeholders can be described in the script.

The specified command is displayed as the subproperty.

Default

Commands executed before build 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 use the text box directly enter the text.

Restriction

Up to 1023 characters

Up to 64 items can be specified.

Commands executed after build processing

Specifies the command to be executed after build 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.

%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.

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

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

%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 build processing.

The placeholders can be described in the script.

The specified command is displayed as the subproperty.

Default

Commands executed after build 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 use the text box directly enter the text.

Restriction

Up to 1023 characters

Up to 64 items can be specified.

Other additional options

Inputs the option to be added additionally.

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

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