Home

CS+ Integrated Development Environment User`s Manual: CC

1. R20UT3284EJ0101 Rev 1 01 ztENESAS Page 187 of 204 Aug 01 2015 CS A WINDOW REFERENCE System Include Path Order dialog box This dialog box is used to refer the system include paths specified for the compiler and set their specified sequence Figure A 15 System Include Path Order Dialog Box System Include Path Order Patt Function buttons The following items are explained here How to open Description of each area Function buttons How to open On the Property panel select the following properties and then click the button From the Common Options tab System include paths in the Frequently Used Options for Compile cate gory and System include paths in the Frequently Used Options for Assemble category From the Compile Options tab System include paths in the Preprocess category From the Assemble Options tab System include paths in the Preprocess category Description of each area 1 Path list display area This area displays the list of the system include paths specified for the compiler a Path This area displays the list of the system include paths in the specified sequence for the compiler The default order is the order that the files are registered to the project By changing the display order of the paths you can set the specified order of the paths to the compiler To change the display order use the Up and Down butt
2. Figure 2 18 Property Panel Compile Options Tab is replaced Figure 2 19 Level of optimization Property Code Size Precedence is replaced Figure 2 20 Level of optimization Property Execution Speed Precedence is replaced Figure 2 67 Property Panel Individual Compile Options Tab is replaced Figure 2 76 Update I O header file on build Property is replaced The description of Specify Rule Number dialog box in table A 1 is amended Figure A 1 Property Panel is replaced Figure A 2 Property Panel Common Options Tab is replaced The following property is added to 1 Build Mode Change property value for all build modes at once The description of the Output file type property in 3 Output File Type and Path is amended The Restriction values of the Level of optimization property in 3 Frequently Used Options for Compile are amended Default Optimization None gt Perform the default optimization None Code Size Precedence Osize gt Code size precedence Osize Speed Precedence Ospeed gt Speed precedence Ospeed Debug Precedence Onothing gt Debug precedence Onothing The display condition is deleted from the description of the Output folder property in 6 Frequently Used Options for Link The display condition is deleted from the description of the Output file name prop erty in 6 Frequently Used Options
3. Enter the include path per line in Path One path per one line You can specify up to 247 characters per line up to 256 lines Remark 1 This property supports placeholders If a line is double clicked in Placeholder the placeholder will be reflected in Path One path per one line Remark 2 You can also specify the include path by one of the following procedures Drag and drop the folder using such as Explorer Click the Browse button and then select the folder in the Browse For Folder dialog box Double click a row in Placeholder Remark 3 Select the Include subfolders automatically check box before clicking the Browse button to add all paths under the specified one down to 5 levels to Path One path per one line If you click the OK button the entered include paths are displayed as subproperties Figure 2 23 Additional include paths Property After Adding Include Paths Additional include path 2 RE Cir gt Include files sa of compiling wits inchrje fies u at heed of compiling uris D gt Macro definibon Macro definition 0 gt Mecro undehnitien Macro undefinition D To change the include paths you can use the button or enter the path directly in the text box of the subproperty When the include path is added to the project tree the path is added to the top of the subproperties automatically Remark You can also set the option in the same way with the Additional
4. change button For the subproperty you can enter directly in the text box Restriction Up to 1023 characters Up to 64 items can be specified R20UT3284EJ0101 Rev 1 01 ztENESAS Page 103 of 204 Aug 01 2015 CS A WINDOW REFERENCE Commands executed Specify the command to be executed after assemble processing after assemble pro Use the call instruction to specify a batch file example call a bat cessing The following placeholders are supported ActiveProjectDir Replaces with the absolute path of the active project folder ActiveProjectName Replaces with the active project name AssembledFile Replaces with the absolute path of the output file under assem bling BuildModeName Replaces with the build mode name nputFile Replaces with the absolute path of the file to be assembled 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 abs
5. Perform inter module Specify the level of inter module optimization such as function merging optimization This corresponds to the Ointermodule option of the ccrl command Default Configuration of the compile option How to Select from the drop down list change Restriction Yes Level 1 Perform Performs inter module optimization for Ointermodule each file No Does not perform inter module optimiza tion R20UT3284EJ0101 Rev 1 01 ztENESAS Page 161 of 204 Aug 01 2015 CS A WINDOW REFERENCE Perform optimization Select whether to perform optimization with consideration for the type of the data indi considering type of cated by the pointer based on the ANSI standard data indicated by This corresponds to the Oalias option of the ccrl command pointer Default Configuration of the compile option How to Select from the drop down list change Restriction Yes Performs optimization with consideration for the type Oalias ansi of the data indicated by the pointer In general this option improves the object perfor mance but the execution result may differ from the case when No is selected No Does not perform optimization with consideration for the type of the data indicated by the pointer Create subroutine for Select whether to create a subroutine for the same instruction sequence same instruction This corresponds to the Osame_code option of the ccrl comman
6. 1 Build Property Panel Build Settings Tab When Selecting C Source File Figure A 9 Set as build tanget Set individual compiles option File type C source file Setas build target Selects whether io build this file Sat as build tanget Set individual assemble option File type Assemity Source file Set as builld target Selects whether io build this file Figure A 11 Property Panel Build Settings Tab When Selecting Object File Yes Object file Sat as build tanget File type Selas builld target Selects whether to build this file Page 154 of 204 ztENESAS R20UT3284EJ0101 Rev 1 01 Aug 01 2015 CS A WINDOW REFERENCE Figure A 12 Property Panel Build Settings Tab When Selecting Library File i user lb Property 4 Build Sat as build tanget File type Sel as buildtarget Selects whether to build this file PATTI aae gt Bla iA File Information Description of each category 1 Build The detailed information on the build is displayed and the configuration can be changed Set as build target Select whether to run a build of the selected file Default Yes How to Select from the drop down list change Restriction Yes Runs a build of the selected file No Does not run a build of the selected file Set individual compile Select whether to set the compile option that differs from the project settings to the option selected C sou
7. Allow nested com ments 8 Character Encoding Select whether This correspon to allow the nest use of comments ds to the nest_comment option of the ccrl command Default No How to change Select from the drop down list Restriction Yes nest_comment Allows the nest use of comments No Does not allow the nest use of com ments The detailed information on character encoding is displayed and the configuration can be changed R20UT3284EJ0101 Rev 1 01 Aug 01 2015 RENESAS Page 85 of 204 CS A WINDOW REFERENCE Character encoding Select the character code to be used for Japanese Chinese comments and character strings in the source file This corresponds to the character_set option of the ccrl command Default Auto None How to Select from the drop down list change Restriction Auto None Interprets the Japanese character code in the source file as SUIS on Japanese OS On other than Japanese OS does not interpret the character code in the source file SJIS character_set sjis Interprets the Japanese character code in the source file as SJIS EUC Interprets the Japanese character code character_set euc_jp in the source file as EUC UTF 8 character_set utf8 Interprets the Japanese character code in the source file as UTF 8 Big5 character_set big5 Interprets the Chinese character code in the source file as Traditiona
8. Exclusion rule number Specify the rule number to be excluded from the check This property is usable only in the Professional Edition Specify at least one rule number in decimal This corresponds to the misra20XX option of the ccrl command This property is displayed only when Ignore specified rule number misra20XX ignore in the Apply rule property is selected Default Configuration of the compile option How to Directly enter in the text box or edit by the Specify Rule Number dia change log box which appears when clicking the button Restriction Up to 259 characters Check rule number besides required rule Specify the rule number to be checked besides the required rules This property is usable only in the Professional Edition Specify at least one rule number in decimal This corresponds to the misra20XX option of the ccrl command This property is displayed only when Apply rules that are classified as required and specified rule number misra20XX required_add in the Apply rule property is selected Default Configuration of the compile option How to Directly enter in the text box or edit by the Specify Rule Number dia change log box which appears when clicking the button Restriction Up to 259 characters Exclusion rule number from required rule Specify the required rule number to be excluded from the check This property is usable only in the Professional Ed
9. Figure 2 56 Output hex file Property Owiput fle fare Project Hamet mat b Division output file Civigion autput fileji When outputting a hex file you can set the output folder and output file name a Set the output folder Setting the output folder is made with the Output folder property by directly entering to the text box or by the button Up to 247 characters can be specified in the text box This property supports the following placeholder 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 R20UT3284EJ0101 Rev 1 01 ztENESAS Page 37 of 204 Aug 01 2015 CS 2 FUNCTIONS 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 BuildModeName is set by default b Set the output file name Setting the output file is made with the Output file name property by directly entering to the text box Up to 259 characters can be specified in the text box
10. Specify information to be output Select Yes List contents specify LISt in the Output link map file property The following property will be dis played Output symbol information property Output number of symbol reference property Output cross reference information property Output total sizes of sections property Output vector information property Select Yes for each output information property Figure 2 15 Output link map file Property When Information To Be Output Is Specified Ciipul eymbal miw mekon Ne Swipul number of eymbel reference Ne Outpul cress reference information He Output total sizes of sections Ne Output vector information Ho The link map file is output to the project folder It is also shown on the project tree under the Build tool generated files node The file name will be the project file name with the extension replaced by map Remark See CC RL Compiler User s Manual for details about the link map file 2 4 4 Output library information The library information information from the library creation result is output to the library list file Select the build tool node on the project tree and select the Create Library Options tab on the Property panel To output the library list file set the Output link map file property in the List category 1 Output information according to the output format Select Yes List contents not specify LISt SHow or Yes
11. 2 1 Overview This section describes how to create a load module and user library 2 1 1 Create a load module The procedure for creating a load module is shown below Remark See CS Integrated Development Environment User s Manual Project Operation for details about 1 1 2 2 3 8 and 9 Create or load a project Create a new project or load an existing one Remark When converting a CA78KOR project into a CC RL project see 2 2 Convert a CA78KOR project into a CC RL project Set a build target project Set a build target project Set build target files Add or remove build target files and update the dependencies Set speeding up of build Set a build speed up facility as required see 2 3 Speeding up of Build Set the type of the output file Select the type of the load module to be generated see 2 4 Set the Type of the Output File Set build options Set the options for the compiler assembler linker and the like see 2 5 Set Compile Options 2 6 Set Assem ble Options 2 7 Set Link Options and the like Set the update method of the I O header file Update the I O header file in accordance with the update of the device file see 2 12 Automatically Update the O Header File Run a build Run a build Remark If there are any commands you wish to run before or after the build process on the Property panel from the Common Options tab in the Others category set the C
12. Interprets the Japanese character code in the source file as UTF 8 Big5 character_set big5 Interprets the Chinese character code in the source file as Traditional Chinese GB2312 character_set gb2312 Interprets the Chinese character code in the source file as Simplified Chinese No process character_set none Does not interpret the Japanese Chinese character code in the source file The detailed information on output files is displayed and the configuration can be changed Object file name 6 Assemble List Specify the name of the object file generated after assembling The extension other than obj cannot be specified If the extension is omitted obj is automatically added If this is blank the file name will be the source file name with the extension replaced by obj This corresponds to the o option of the ccrl command Default Blank How to change Directly enter in the text box Restriction Up to 259 characters The detailed information on the assemble list is displayed and the configuration can be changed Output assemble list file R20UT3284EJ0101 Rev 1 01 Aug 01 2015 Select whether to output the assemble list file This corresponds to the asmopt prn_path option of the ccrl command Default Configuration of the assemble option How to change Select from the drop down list Restriction Yes as
13. Remark 3 Select the Include subfolders automatically check box before clicking the Browse button to add all paths under the specified one down to 5 levels to Path One path per one line If you click the OK button the entered include paths are displayed as subproperties Figure 2 30 Additional include paths Property After Adding Include Paths System include paths System indude pathe D gt Macro definitan Macro defintionf gt Macro undehniben Macro undetinitian 0 To change the include paths you can use the button or enter the path directly in the text box of the subproperty When the include path is added to the project tree the path is added to the top of the subproperties automatically Remark You can also set the option in the same way with the Additional include paths property in the Frequently Used Options for Assemble category on the Common Options tab R20UT3284EJ0101 Rev 1 01 ztENESAS Page 24 of 204 Aug 01 2015 CS 2 FUNCTIONS 2 6 2 Seta macro definition Select the build tool node on the project tree and select the Assemble Options tab on the Property panel The macro definition setting is made with the Macro definition property in the Preprocess category Figure 2 31 Macro definition Property 4 Prepress gt Additienal include paths Addtianal indude pahal If you click the button the Text Edit dialog box will open Figure 2 32 Text Edit Di
14. 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 5 Library Specify the output file name If the extension is omitted abs is automatically added 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 abs How to change Directly enter in the text box Restriction Up to 259 characters The detailed information on the library is displayed and the configuration can be changed R20UT3284EJ0101 Rev 1 01 Aug 01 2015 ztENESAS Page 110 of 204 CS A WINDOW REFERENCE Using libraries Specify the library files to be used I
15. 3 CRC Operation is amended The description of the Type of CRC property in 3 CRC Operation is amended The followings are added to Restriction CCITT type CRC CCITT MSB LITTLE 4 bytes type CRC CCITT MSB LITTLE 2 bytes type 16 32 ETHERNET type The Restriction values of the Initial value property in 3 CRC Operation are amended Description Summary Figure A 8 Property Panel I O Header File Generation Options Tab is replaced The description of the following Restriction values of the Update I O header file on build property in 1 I O Header File is amended Yes Checking the device file Yes Checking the property Yes Checking the device file and the property The display condition is deleted from the description of the Output 1bit access property in 1 I O Header File The following property is added to 1 I O Header File Enable MISRA C option The list of category names on the Individual Compile Options tab is amended Figure A 13 Property Panel Individual Compile Options Tab is replaced The following property is added to 1 Debug Information Enhance debug information with optimization The Restriction values of the Level of optimization property in 2 Optimization are amended Default Optimization None gt Perform the default optimization None Code Size Precedence Osize gt Code size precedence
16. Auto None Interprets the Japanese character code in the source file as SUIS on Japanese OS On other than Japanese OS does not interpret the character code in the source file SJIS character_set sjis Interprets the Japanese character code in the source file as SUIS EUC character_set euc_jp Interprets the Japanese character code in the source file as EUC UTF 8 character_set utf8 Interprets the Japanese character code in the source file as UTF 8 Big5 character_set big5 Interprets the Chinese character code in the source file as Traditional Chinese GBK character_set gbk Interprets the Chinese character code in the source file as Simplified Chinese No process character_set none Does not interpret the Japanese Chi nese character code in the source file The detailed information on output codes is displayed and the configuration can be changed Handle external vari ables as if they are volatile qualified Select whether to handle all external variables and variables specified with pragma address as if they are volatile qualified This corresponds to the volatile option of the ccrl command Default Configuration of the compile option How to Select from the drop down list change Restriction Yes volatile Handles all external variables and variables specified with pragma address as if they are volatile qualified No Op
17. On the Property panel select the following properties and then click the button From the Compile Options tab Rule number Exclusion rule number Check rule number besides required rule Exclusion rule number from required rule in the MISRA C Rule Check category From the Individual Compile Options tab Rule number Exclusion rule number Check rule number besides required rule Exclusion rule number from required rule in the MISRA C Rule Check category Description of each area 1 Select items The list of the MISRA C rule numbers which can be specified for the area that this dialog box is called from is dis played ascending order Select the check boxes to set the rule number Remark In the area that this dialog box is called from if a rule number is already set the check box for that rule number will be selected by default R20UT3284EJ0101 Rev 1 01 ztENESAS Page 190 of 204 Aug 01 2015 CS A WINDOW REFERENCE Function buttons Button Function OK Closes this dialog box and sets the selected rule number to the area that this dialog box is called from Cancel Cancels the rule number selecting and closes the dialog box Enable All Selects all the check boxes in Select items Disable All Clears all the check boxes in Select items Help Displays the help of this dialog box R20UT3284EJ0101 Rev 1 01 Aug 01 2015 ztENESAS
18. Output File Library Device Output Code List Variables functions information 0 Section 1 Verify 2 Message 3 Others Caution Figure A 5 Property Panel Link Options Tab A CCPL in This tab is not displayed for the library project Yes Outout to the output flek DEBug Pinner einer Delete local symbol name information Using libraries gt Shepton librares Use standard mathematical libraries Use runtime lebranes Device Output Code Specihy emecuton staat address Fill with padding data at the end of a section Address seting for specified ares of vector table Address seting for unused vechor area Variables functons infonmation Sack Others Hagia graye AEA Nol NOCOmpress No Ho optinize HOOPtiniza Binary fe 0 Symbol defing on 0 SProjectMame tabs Using lbranea 0 Syetem bbreries D Yes Yeo No Ho Address setting for spectied area o vetar tableji This option corresponda to the NOIDEBug and DEBug option of the dink command R20UT3284EJ0101 Rev 1 01 Aug 01 2015 Page 105 of 204 CS A WINDOW REFERENCE Description of each category 1 Debug Information The detailed information on debug information is displayed and the configuration can be changed Output debug informa Select whether to output debug information tion This corresponds to the DEBug and NODEBug options of the rlink command Default
19. Specify mirror area Select the area to allocate the segment that is mirrored in the RAM space This corresponds to the asmopt mirror_source option of the ccrl command Default MAA 0 None How to Select from the drop down list change Restriction MAA 0 None Specifies the mirror source section to be allo cated at address Ox0xxxx MAA 1 asmopt Specifies the mirror source section to be allo mirror_source 1 cated at address 0x1xxxx This item is displayed only when RL78 S2 core cpu S2 or RL78 S3 core cpu S3 in the Specify CPU core property in the CPU cat egory is selected Common Does not support reference to symbols allocated asmopt to the mirror source area and does not perform mirror_source co mirror conversion of the mirror source address mmon Security ID Specify the security ID of an on chip flash memory device Enter a 20 digit 10 byte value in hexadecimal This corresponds to the SECURITY_ID option of the rlink command Default 0 How to Directly enter in the text box change Restriction 00000000000000000000 to FFFFFFFFFFFFFFFFFFFE hexadecimal number or blank 12 Build Method The detailed information on the build method is displayed and the configuration can be changed R20UT3284EJ0101 Rev 1 01 ztENESAS Page 69 of 204 Aug 01 2015 CS A WINDOW REFERENCE Build simultaneously Select whether to generate the load module file by com
20. change Restriction Yes SHow SYmbol Outputs the symbol information No Does not output the symbol information Output number of Select whether to output the number of symbol references symbol reference This corresponds to the SHow Reference 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 Select from the drop down list change Restriction Yes SHow Reference Outputs the number of symbol refer ences No Does not output the number of symbol references Output cross reference Select whether to output the cross reference information 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 is selected Default No How to Select from the drop down list change Restriction Yes SHow Xreference Outputs the cross reference information No Does not output the cross reference infor mation Output total sizes of Select whether to output the total size of sections 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 is selected Default No How to Select fr
21. ActiveProjectName Replaces with the active project name AssembledFile Replaces with the absolute path of the output file under assem bling BuildModeName Replaces with the build mode name nputFile Replaces with the absolute path of the file to be assembled 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 assemble processing The placeholders can be described in the script The specified command is displayed as the subproperty Default Commands executed before assemble processing number of defined items How to Edit by the Text Edit dialog box which appears when clicking the
22. Be sure to set the control value of the on chip debug option byte To set it select Yes and specify the control value of the on chip debug option byte on the Option byte values for OCD property Or set the control value of the on chip debug option byte by using an assembler source file The control value for the on chip debug option byte depends on the device in use See the user s manual of the device for the value to be specified This property is not displayed when the device does not have an on chip debug func tion Default Yes OCDBG How to Select from the drop down list change Restriction Yes Sets the control value of the on chip debug OCDBG No Does not set the control value of the on chip debug Option byte values for OCD Specify the control value of the on chip debug option byte in hexadecimal without Ox This corresponds to the OCDBG option of the rlink command Be sure to set the control value for the on chip debug option byte by using this prop erty or an assembler source file The control value for the on chip debug option byte depends on the device in use See the user s manual of the device for the value to be specified This property is not displayed when the device does not have an on chip debug func tion and when No in the Set enable disable on chip debug by link option property is selected Default Blank How to Directly enter in the text box change Restrict
23. CENESAS C n D TE 7 lt A 3 E D CS Integrated Development Environment User s Manual CC RL Build Tool Operation Target Device RL78 Family Target Version V3 00 00 or higher All information contained in these materials including products and product specifications represents information on the product at the time of publication and is subject to change by Renesas Electronics Corp without notice Please review the latest information published by Renesas Electronics Corp through various means including the Renesas Electronics Corp website http www renesas com Renesas Electronics www renesas com Rev 1 01 2015 08 10 11 12 Notice Descriptions of circuits software and other related information in this document are provided only to illustrate the operation of semiconductor products and application examples You are fully responsible for the incorporation of these circuits software and information in the design of your equipment Renesas Electronics assumes no responsibility for any losses incurred by you or third parties arising from the use of these circuits software or information Renesas Electronics has used reasonable care in preparing the information included in this document but Renesas Electronics does not warrant that such information is error free Renesas Electronics assumes no liability whatsoever for any damages incurred by you resulting from errors in or omissions
24. Caution This tab is displayed for the library project Figure 2 63 Property Panel Create Library Options Tab Ay CECRL Property a Debug information Delete local sembol name ir onmabor Input File Object ile Object filefl Output File Quitpiut Fle bornat User libraree FOmm Library Quitput Folder SBuildModeName s Output fle name SP rojectameY fib Library Using libraries Usang librertes 0 gt Syehem beaters System libranes 1 Use clandad mathemetcal libiaies Me Use turilime liniaties No List gt Hesa gt Dthers Delete local symbol name informa Select whether to delete local symbol name infomation This option cor sponds te the Hide option ol Ihe link coenmnared Assen h create L AIO a Remark Often used options have been gathered under the Frequently Used Options for Create Library cate gory on the Common Options tab 2 9 1 Set the output of a library file Select the build tool node on the project tree and select the Create Library Options tab on the Property panel The setting to output a library file is made with the Output File category Figure 2 64 Output File Category weal Fike User libearies FOrm Libeary U Qlutput folder Build ModeNeme Output file name ProjeciName Jibs 1 Set the output format Select the format in the Output file format property You can select any of the formats below Format Configuration User libraries FOrm Library U Outp
25. Default Motorola S record file FOrm Stype How to Select from the drop down list change Restriction Intel HEX file FOrm Hexa Outputs an Intel HEX file decimal Motorola S record file Outputs a Motorola S record file FOrm Stype Binary file FOrm Binary Outputs a binary file R20UT3284EJ0101 Rev 1 01 ztENESAS Page 132 of 204 Aug 01 2015 CS Unify record size Intel HEX file A WINDOW REFERENCE Select whether to output a specified data record regardless of the address range This corresponds to the RECord option of the rlink command This property is displayed only when Intel HEX file FOrm Hexadecimal in the Hex file format property is selected Default No How to change Select from the drop down list Restriction Yes Intel hex record REcord H16 Outputs the Intel hex record Yes Intel expanded hex record REcord H20 Outputs the Intel expanded hex record Yes Intel 32 bit hex record REcord H32 Outputs the Intel 32 bit hex record No Outputs various data records according to each address Unify record size Motorola S record file Select whether to output a specified data record regardless of the address range This corresponds to the RECord option of the rlink command This property is displayed only when Motorola S record file FOrm Stype in the Hex file format property is selected Default
26. Disables MISRA C rule check is dis abled which are partially suppressed by the extended language specifica tions 12 Error Output The detailed information on the error output is displayed and the configuration can be changed Output error message Select whether to output the error message file file This corresponds to the error_file option of the ccrl command Error messages are displayed on the Output panel regardless of this property s This property is displayed only when No in the Build in parallel property in the Build Method category from the Common Options tab is selected Default Configuration of the common option How to Select from the drop down list change Restriction Yes error_file Outputs the error message file No Does not output the error message file R20UT3284EJ0101 Rev 1 01 ztENESAS Page 175 of 204 Aug 01 2015 CS A WINDOW REFERENCE Error message file out put folder Specify the folder which the error message file is output If a relative path is specified the reference point of the path is the main project or sub project 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 If this is blank it is assumed that the project folder has been specified This corr
27. FOrm Relocate in the Output file for mat 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 infor mation ztENESAS Page 146 of 204 CS Output total sizes of sections 6 Message A WINDOW REFERENCE 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 for mat property in the Output File category are selected Default No How to change Select from the drop down list Restriction Yes SHows Total_size Outputs the total sizes of sections sepa rately for ROM allocated sections and RAM allocated sections Does not output the total size of sections 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 Mes sage
28. Osize Speed Precedence Ospeed gt Speed precedence Ospeed Debug Precedence Onothing gt Debug precedence Onothing The following property is added to 3 Optimization Details Create subroutine for same instruction sequence The following category is added to the Individual Compile Options tab 5 Quality Improvement The category name of 11 is amended as shown below MISRA C 2004 Rule Check gt MISRA C Rule Check A sentence at the beginning is amended The following property is added to 11 MISRA C Rule Check MISRA C specification The fact that properties are usable only in the Professional Edition is added to the description of all properties in 11 MISRA C Rule Check The following amendments are made in the description and Restriction Xmisra2004 gt Xmisra20XX MISRA C 2004 gt MISRA C The following amendment is made throughout the description of the Specify Rule Number dialog box MISRA C 2004 gt MISRA C CS User s Manual CC RL Build Tool Operation Publication Date Rev 1 00 Feb 01 2015 Rev 1 01 Aug 01 2015 Published by Renesas Electronics Corporation tENESAS SALES OFFICES Renesas Electronics Corporation http Avww renesas com Refer to http www renesas com for the latest and detailed information Renesas Electronics America Inc 2801 Scott Boulevard Santa Clara CA 95050 2549 U S A Tel 1 408 588 6000 Fax 1 408
29. 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 preinclude option of the ccrl command The specified include file name is displayed as the subproperty Default Configuration of the compile option 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 259 characters Up to 256 items can be specified Macro definition Specify the name of the macro to be defined Specify in the format of macro name defined value with one macro name per line The defined value part can be omitted and in this case 1 is used as the defined value This corresponds to the D option of the ccrl command The specified macro is displayed as the subproperty Default Configuration of the compile option How to
30. 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 256 characters Up to 256 items can be specified Macro undefinition R20UT3284EJ0101 Rev 1 01 Aug 01 2015 Specify the macro name to be undefined Specify in the format of macro name with one macro name per line This corresponds to the U option of the ccrl command The specified macro is displayed as the subproperty Default Configuration of the compile option 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 ztENESAS Up to 256 characters Up to 256 items can be specified Page 164 of 204 CS A WINDOW REFERENCE Output C source com Select whether to output the comments of the C source to the preprocessed file ments to preprocessed This corresponds to the preprocess option of the ccrl command file This property is displayed only when Yes P in the Output preprocessed source file property in the Output File category is selected Default Configuration of the compile option How to Select from the drop down list change Restriction Yes preprocess com Outputs the comments of the C source to ment the preprocessed file No Does not output the comments of the C sou
31. source file The user option byte value depends on the device in use See the user s manual of the device for the value to be specified This property is not displayed when No in the Set user option byte property is selected Default Blank How to Directly enter in the text box change Restriction Hexadecimal number without Ox The range that can be specified depends on the selected device R20UT3284EJ0101 Rev 1 01 ztENESAS Page 113 of 204 Aug 01 2015 CS A WINDOW REFERENCE Control allocation to Select whether to control the allocation to the self RAM area self RAM area This corresponds to the SELF SELFW 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 01 00 or higher or when V1 01 00 or higher is selected in the Using compiler package version property For a device in which allocation to the self RAM area is controllable Default No How to Select from the drop down list change Restriction Yes Error mes Prohibits the allocation to the self RAM area sage SELF and displays an error Yes Warning mes Outputs a warning when allocating to the self sage SELFW RAM area No Uses the self RAM area as the internal RAM area An error or wa
32. 8 bit bus width type When Yes DEBUG_MONITOR in the Set debug monitor area property is selected When a value is specified in the Range of debug monitor area property Default No How to Select from the drop down list change Restriction Yes RRM Reserves a 4 byte memory as the work area for the RRM DMM function No Does not reserve the work area for the RRM DMM function R20UT3284EJ0101 Rev 1 01 ztENESAS Page 115 of 204 Aug 01 2015 CS A WINDOW REFERENCE Start address of work Specify the start address of the work area for the RRM DMM function in hexadecimal ing memory for RRM without Ox DMM function Four bytes starting from the specified address in the internal RAM area are reserved as the work area for the RRM DMM function This corresponds to the RRM 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 01 00 or higher or when V1 01 00 or higher is selected in the Using compiler package version property When Yes RRM in the Reserve working memory for RRM DMM function prop erty is selected Default Blank How to Directly enter in the text box change Restriction Even address from the lowest address up to the highest addre
33. Call Walker performs a static analysis and displays the symbols and their callers in a tree format as well as stack infor mation for each symbol symbol name attribute address size stack size and file name in list format To start Call Walker select Tool menu gt gt Startup Stack Usage Tracer To exit from Call Walker select Call Walker File menu gt gt Exit See Call Walker Help menu gt gt Help Topics for Call Walker operations R20UT3284EJ0101 Rev 1 01 ztENESAS Page 50 of 204 Aug 01 2015 CS A WINDOW REFERENCE A WINDOW REFERENCE This appendix explains panels dialog boxes used in the build tool A 1 Description The following lists the panels dialog boxes used in the build tool Table A 1 List of Panels Dialog Boxes Panel Dialog Box Name Function Description Property panel This panel is used to display the detailed information on the Build tool node or file that is selected on the Project Tree panel and change the settings of the information System Include Path Order dialog box This dialog box is used to refer the system include paths specified for the compiler and set their specified sequence Specify Rule Number dialog box This dialog box is used to select the number of the MISRA C rule and set it to the area that this dialog box is called from Section Settings dialog box This dialog box is used to add modify or delete sections Add Section dial
34. Figure 2 13 Output assemble list file Property Quipal assemble list file When outputting the assemble list file you can set the output folder and output file name 1 Set the output folder Setting the output folder is made with the Output folder for assemble list file property by directly entering in the text box or by the button This property supports the following placeholder BuildModeName Replaces with the build mode name BuildModeName is set by default The file name will be the source file name with the extension replaced by prn Remark See CC RL Compiler User s Manual for details about the assemble list file 2 4 3 Output map information The map information the information of the link result is output to the link map file Select the build tool node on the project tree and select the Link Options tab on the Property panel To output the link map file set the Output link map file property in the List category 1 Output information according to the output format Select Yes List contents not specify LISt SHow or Yes List contents ALL LISt SHow ALL in the Output link map file property Figure 2 14 Output link map file Property When Information According To Output Format Is Output R20UT3284EJ0101 Rev 1 01 ztENESAS Page 16 of 204 Aug 01 2015 CS 2 FUNCTIONS Remark See CC RL Compiler User s Manual for differences between the SHow and SHow ALL options
35. If a relative path is specified the reference point of the path is the main project or sub project 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 If this is blank it is assumed that the project folder has been specified This corresponds to the prep_path option of the ccrl command This property is displayed only when Yes P in the Output preprocessed source file property is selected Default BuildModeName How to Directly enter in the text box or edit by the Browse For Folder dialog change box which appears when clicking the button Restriction Up to 247 characters 11 Assemble List The detailed information on the assemble list is displayed and the configuration can be changed R20UT3284EJ0101 Rev 1 01 ztENESAS Page 90 of 204 Aug 01 2015 CS A WINDOW REFERENCE Output assemble list Select whether to output the assemble list file file This corresponds to the asmopt prn_path option of the ccrl command Default No How to Select from the drop down list change Restriction Yes asmopt prn_path Outputs the assemble list file No Does not output the assemble list file Output folder for Specify the folder which the assemble list file is output assemble list file The assemb
36. List contents ALL LISt SHow ALL in the Output link map file property Figure 2 16 Output link map file Property When Information According To Output Format Is Output Remark See CC RL Compiler User s Manual for differences between the SHow and SHow ALL options Specify information to be output Select Yes List contents specify LISt in the Output link map file property The following property will be dis played Output symbol information property Output section list in a module propertye 1 Output cross reference information propertyN te 2 Output total sizes of sections propertyN te 2 Note 1 This property is displayed only 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 Note 2 This property is displayed only when Relocate file FOrm Relocate in the Output file format property in the Output File category is selected R20UT3284EJ0101 Rev 1 01 ztENESAS Page 17 of 204 Aug 01 2015 CS 2 FUNCTIONS Select Yes for each output information property Figure 2 17 Output link map file Property When Information To Be Output Is Specified Gup Output spot module Meo The library list file is output to the project folder It is also shown on the project tree under the Build tool generated files node The file name will be the project file name with
37. OA eih FEMEIE Build in pala No Handling the source file inchides mon exigling lie Ae compile assemble the source file Remark 1 The files with the individual build options and files to be executed prior to the build are excluded from run ning build simultaneously A build of the file that is not targeted for a simultaneous build is run separately Remark 2 If the source file is older than the generated object module file or related properties and project or the like the object module file will be used for the build instead of the source file Another facility to speed up build is parallel build See 2 3 2 Running parallel build for details about parallel build R20UT3284EJ0101 Rev 1 01 ztENESAS Page 12 of 204 Aug 01 2015 CS 2 FUNCTIONS 2 3 2 Running parallel build Parallel build is a facility to build multiple source files in parallel at build in order to reduce the build time In parallel build since build is performed simultaneously for the number of logical CPUs in the host machine the effect is greater in a machine with a large number of CPU cores There are two types of parallel build facilities Each processing and its setting method are given below 1 Parallel build between source files When running parallel build between multiple source files registered in a project make the setting in the Build in parallel property in the Common Options tab on the Property panel Figure 2 3 Build in paralle
38. Outputs information messages No NOMes sage 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 exam ple 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 mes sage output property is selected Default Blank How to change Directly enter in the text box or edit by the Character String Input dia log box which appears when clicking the button Restriction Up to 2048 characters Change warning mes sage to information message R20UT3284EJ0101 Rev 1 01 Aug 01 2015 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 lInformation Changes the type of all warning messages to information Yes Specify message number CHange_message lInforma tion lt Message number gt Specifies the number of warning message of which type is to be changed to information No Does not chan
39. Page 191 of 204 CS A WINDOW REFERENCE Section Settings dialog box This dialog box is used to add modify or delete sections Figure A 17 Section Settings Dialog Box ted usel ted userii tet _user0IRA Aeat_uperdiZR fext_userQ3R Fi Function buttons The following items are explained here How to open Description of each area Function buttons How to open On the Property panel select the following property and then click the button From the Link Options tab Section start address in the Section category Description of each area 1 Address section area This area displays the list of currently configured section allocations a Address This area displays the start addresses of the sections b Section This area displays the names of the sections c Overlayn This area displays the names of the sections to be overlaid n number starting with 1 R20UT3284EJ0101 Rev 1 01 ztENESAS Page 192 of 204 Aug 01 2015 CS A WINDOW REFERENCE d Button When selecting an address in this area Opens the Section Address dialog box Adds the address specified in the dialog box to this area so that the addresses are listed in the ascending order the section column remains empty When selecting a section in this area Opens the Add Section dialog box Adds the section specified in the dialog box to this area Wh
40. Replaces with the build mode name If this is blank it is assumed that the project folder has been specified This corresponds to the asmopt prn_path option of the ccrl command This property is displayed only when Yes asmopt prn_path in the Output assem ble list file property is selected Default BuildModeName How to Directly enter in the text box or edit by the Browse For Folder dialog change box which appears when clicking the button Restriction Up to 247 characters 6 Others Other detailed information on assembly is displayed and the configuration can be changed Use support for porting Select whether to use support for porting from the CA78KOR assembler from assembler of This corresponds to the asmopt convert_asm option of the ccrl command CA78KOR Default No How to Select from the drop down list change Restriction Yes asmopt convert_asm Uses support for porting from the CA78KOR assembler No Does not use support for porting from the CA78KOR assembler R20UT3284EJ0101 Rev 1 01 ztENESAS Page 102 of 204 Aug 01 2015 CS A WINDOW REFERENCE Commands executed Specify the command to be executed before assemble processing before assemble pro Use the call instruction to specify a batch file example call a bat cessing The following placeholders are supported ActiveProjectDir Replaces with the absolute path of the active project folder
41. Speeding up of Build The build speed up facilities of this build tool are described here There are the following types of build speed up facilities Simultaneous build Multiple files are simultaneously passed by a single call of the build command See 2 3 1 Running simultaneous build for details about simultaneous build Parallel build Multiple build commands are executed in parallel See 2 3 2 Running parallel build for details about parallel build 2 3 1 Running simultaneous build Simultaneous build is a facility to simultaneously compile or assemble the files with a single call of the ccrl command when there are multiple files to be built An image of calling the ccrl command is shown below Example When build target files are aaa c bbb c and ccc c When a build is run simultaneously gt ccrl aaa c bbb c ccc c aaa obj bbb obj and ccc obj are generated gt rlink aaa obj bbb obj ccc obj aaa abs is generated When a build is not run simultaneously gt ccrl aaa c is generated gt ccrl bbb c is generated gt eerl cec c is generated gt rlink aaa obj bbb obj ccc obj lt s is generated Whether to run a build simultaneously is made with the property Select the build tool node on the project tree and select the Common Options tab on the Property panel Select Yes in the Build simultaneously property in the Build Method category Figure 2 2 Build simultaneously Property ah
42. String Input dia log box which appears when clicking the button Restriction Up to 2048 characters Change warning mes sage 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 This property is displayed only when No in the Use same message related settings as Link Options tab property is selected Default No How to change Select from the drop down list Restriction Yes All Changes the type of all warning R20UT3284EJ0101 Rev 1 01 Aug 01 2015 CHange_message lInformation messages to information Yes Specify message number CHange_message lInforma tion lt Message number gt Specifies the number of warning message of which type is to be changed to information No ztENESAS Does not change the type of warning messages Page 138 of 204 CS A WINDOW REFERENCE 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 exam ple 4 200 203 1300 This corresponds to the CHange_message option of the rlink command This property is displayed only when No in the Use same message related settings as Link Options tab property is selected and when Yes Specify messag
43. The load module file will be the debug target 2 When Execute Module Hex File is selected The hex file will be the debug target Caution For the library project this property is always Library and cannot be changed 2 4 1 Change the output file name The names of the load module file hex file and library file output by the build tool are set as follows by default Load module file name ProjectName abs Hex file name ProjectName mot Library file name lib ProjectName lib Remark ProjectName is a placeholder It is replaced with the project name The method to change these file names is shown below 1 When changing the load module file name and non ROMized load module file name Select the build tool node on the project tree and select the Link Options tab on the Property panel Enter the file name to be changed to in the Output file name property in the Output File category Figure 2 6 Output file name Property This property supports the following placeholders ActiveProjectName Replaces with the active project name MainProjectName Replaces with the main project name ProjectName Replaces with the project name Remark You can also change the option in the same way with the Output file name property in the Fre quently Used Options for Link category on the Common Options tab 2 When changing the hex file name Select the build tool node on the project tree and select the Hex Outpu
44. This property supports the following placeholders ActiveProjectName Replaces with the active project name MainProjectName Replaces with the main project name ProjectName Replaces with the project name ProjectName mot is set by default 2 Set the hex file format Select the format in the Hex file format property in the Hex Format category Figure 2 57 Hex file format Property Hex file format Piai ri Output 59 record at the end Na grala Second file FOnn Stype You can select any of the formats below Format Configuration Intel HEX file FOrm Hexadecimal Outputs an Intel HEX file Motorola S record file FOrm Stype Outputs a Motorola S record file Binary file FOrm Binary Outputs a binary file Remark See CC RL Compiler User s Manual for details about the Intel Hex file and Motorola S record file 2 8 2 Fill the vacant area Select the build tool node on the project tree and select the Hex Output Options tab on the Property panel 1 Set the hex file output range The setting of the hex file output range is made with the Division output file property in the Output File category Figure 2 58 Division output file Property 4 Output File Dutput hex file Yes Output folder BuildMadeName Ci If you click the button the Text Edit dialog box will open R20UT3284EJ0101 Rev 1 01 ztENESAS Page 38 of 204 Aug 01 2015 CS a 2 F
45. 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 NODEBug Does not output debug information Compress debug infor mation Select whether to compress debug information This corresponds to the COmpress and NOCOmpress options of the rlink command This property is displayed only when Yes Output to the output file DEBug in the Output debug information property is selected Default No NOCOmpress How to change Select from the drop down list Restriction Yes COmpress Compresses debug information The loading speed of the debugger will be improved No NOCOmpress Does not compress the debug information The link time will be shortened 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 2 Optimization Yes Hide Deletes information of the local symbol name No Does not delete information of the local symbol name The detailed information on the optimization is displayed and the configuration can be changed R20UT3284EJ0101 Rev 1 01 Aug 01 2015 RENESAS Page 106 of 204 CS Optimization type A WINDOW REFEREN
46. You can also set the option in the same way with the Macro definition property in the Frequently Used Options for Compile category on the Common Options tab R20UT3284EJ0101 Rev 1 01 ztENESAS Page 22 of 204 Aug 01 2015 CS 2 FUNCTIONS 2 6 Set Assemble Options To set options for the assemble phase select the Build tool node on the project tree and select the Assemble Options tab on the Property panel You can set the various assemble options by setting the necessary properties in this tab Figure 2 27 Property Panel Assemble Options Tab Add debug information Outputs additional information for inter module optimization Preprocess b Additional include paths System include paths Macro definition Macro undetination gt Character Encoding gt Assemble List Add debug informabon Species whether to generate the debug infomation Such information is generated when 1 debugging a program just like the case of wishing fo perform source debugging with debugger This option conesponds bo Remark Often used options have been gathered under the Frequently Used Options for Assemble category on the Common Options tab Caution This tab is displayed only when No in the Build simultaneously property in the Build Method category from the Common Options tab is selected 2 6 1 Add an include path Select the build tool node on the project tree and select the Assemble Options tab on the Prop
47. ary Do not check memory Select whether to link without checking memory allocation of sections allocation of sections This corresponds to the NO_CHECK_SECTION_LAYOUT option of the rlink com mand This property is displayed 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 01 00 or higher or when V1 01 00 or higher is selected in the Using compiler package version property Default No How to Select from the drop down list change Restriction Yes Does not check memory allocation of sec NO_CHECK_SECTIO tions N_LAYOUT No Checks memory allocation of sections 12 Message The detailed information on messages is displayed and the configuration can be changed Enable information Select whether to enable the output of information messages message output This corresponds to the Message and NOMessage options of the rlink command Default No NOMessage How to Select from the drop down list change Restriction Yes Message Outputs information messages No NOMessage Suppresses the output of informa tion messages R20UT3284EJ0101 Rev 1 01 ztENESAS Page 124 of 204 Aug 01 2015 CS Suppress number of information message A WINDOW REFERENCE Specify the number of the information message of which output is
48. assembly source file No Does not output a C source program as a comment to the assembly source file Merge string literals When the same string literals exist in the source file specify whether to merge them and allocate to the one area This corresponds to the merge_string option of the ccrl command Default No How to Select from the drop down list change Restriction Yes merge_string Merges the same string literals exist in the source file and allocates to the one area No Each allocates the same string literals exist in the source file to separate areas 10 Output File The detailed information on output files is displayed and the configuration can be changed Output assembly Select whether to output the assembly source file of the compile result for the C source file source This corresponds to the asm_path option of the ccrl command Default No How to Select from the drop down list change Restriction Yes asm_path Outputs the assembly source file of the compile result for the C source No Does not output the assembly source file of the compile result for the C source R20UT3284EJ0101 Rev 1 01 ztENESAS Page 89 of 204 Aug 01 2015 CS A WINDOW REFERENCE Output folder for Specify the folder which the assembly source file is output assembly source file If a relative path is specified the reference point of the path is the main project or su
49. 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 OUtput option of the rlink command The division output file name is displayed as the subproperty This property is displayed only when Yes in the Output hex file property is selected Default Division output file number of defined items How to Edit by the Text Edit dialog box which appears when clicking the change button For the subproperty you can enter directly in the text box Restriction Up to 259 characters Up to 65535 items can be specified 2 Hex Format The detailed information on the hex format is displayed and the configuration can be changed This category is displayed only when Yes in the Output hex file property in the Output File category is selected Hex file format Select the format of the hex file to be output This corresponds to the FOrm option of the rlink command
50. include paths property in the Frequently Used Options for Compile category on the Common Options tab R20UT3284EJ0101 Rev 1 01 ztENESAS Page 21 of 204 Aug 01 2015 CS 2 FUNCTIONS 2 5 4 Seta macro definition Select the build tool node on the project tree and select the Compile Options tab on the Property panel The macro definition setting is made with the Macro definition property in the Preprocess category Figure 2 24 Macro definition Property a Preprocess Additional include paths Additonal include paths 0 System include paths elem include oxtail If you click the button the Text Edit dialog box will open Figure 2 25 Text Edit Dialog Box Enter the macro definition in Text in the format of macro name defined value with one macro name per line You can specify up to 256 characters per line up to 256 lines The defined value part can be omitted and in this case 1 is used as the defined value If you click the OK button the entered macro definitions are displayed as subproperties Figure 2 26 Macro definition Property After Setting Macros 4 Prepress gt Additional include paths Additonal include pathe l oneni include pahe Saen hihna pahe 4 Maco definition 2 u TEST 1 gt Macro undefinition aa undefinition To change the macro definitions you can use the button or enter the path directly in the text box of the subproperty Remark
51. level 0 0 0 ete ee 43 2 10 2 Set build options at the file level 0 0 ett eee ee 43 2 11 Efficiently Allocate Variables and Functions 00 c eee ett tenes 46 2 12 Automatically Update the I O Header File 2 0 0 0 cette tenes 48 2 13 Estimate the Stack Capacity A WINDOW A 1 Description Revision Record REFERENC Ets teats tok hon Mie E E E e Rae ae EEA CS 1 GENERAL 1 GENERAL This chapter explains the overview of the build tool plug in of CC RL 1 1 Overview The build tool plug in can be used to set build options for creating load modules or user libraries 1 2 Features The features of the build tool plug in are shown below Build option setting Most build options can be set via the graphical user interface GUI Project conversion A project for the CA78KOR compiler created by using CS or CubeSuite can be converted into a project for the CC RL compiler Speeding up of build Two types of facilities are provided to speed up build simultaneous build and parallel build The build time can be shortened in simultaneous build by simultaneously compiling or assembling the files with a sin gle call of the build command and in parallel build by executing multiple build commands in parallel R20UT3284EJ0101 Rev 1 01 ztENESAS Page 6 of 204 Aug 01 2015 CS 2 FUNCTIONS 2 FUNCTIONS This chapter describes the build procedure using CS and about the main build functions
52. log box which appears when clicking the button Restriction Up to 259 characters R20UT3284EJ0101 Rev 1 01 ztENESAS Page 151 of 204 Aug 01 2015 CS A WINDOW REFERENCE I O Header File Generation Options tab This tab shows the detailed information on the I O header file generation tool categorized by the following and the con figuration can be changed 1 I O Header File 2 Others Figure A 8 4 CC RL Property a 1 0 Header Fie Property Panel I O Header File Generation Options Tab Update 140 heades file on build uiput ibit access Enable MBR option Dihers Update l0 header file on bud Selects whelherto update the 1 0 header file an buld Updates the 10 header fle if the device file i newer Ihan the device file when the 10 he Description of each category 1 I O Header File The detailed information on the I O header file is displayed and the configuration can be changed Update I O header file on build Select whether to update the I O header file at build The I O header file is updated when the device file is newer than that at generation of the I O header file or properties related to generation of the I O header file have been updated Update is performed by automatic overwriting and a backup file with the bak extension is created This contents are common to all the build modes Default No How to change Select from
53. messages are displayed on the Output panel regardless of this property s This property is displayed only when No in the Build in parallel property in the Build Method category from the Common Options tab is selected Default Configuration of the common option How to Select from the drop down list change Restriction Yes error_file Outputs the error message file No Does not output the error message file Error message file Specify the folder which the error message file is output output folder 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 If this is blank it is assumed that the project folder has been specified This corresponds to the error_file option of the ccrl command This property is displayed only when Yes error_file in the Output error message file property is selected Default Configuration of the common option How to Directly enter in the text box or edit by the Browse For Folder dialog change box which appears when clicking the button Restriction Up to 247 characters R20UT3284EJ0101 Rev 1 01 ztENESAS Page 184 of 204 Aug 01 2015 CS A WINDOW REFERENCE Error
54. of infor mation 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 exam ple 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 lt Message numbers gt 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 dia log 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 occu pancy 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
55. 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 exam ple 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 lt Message numbers gt in the Change warning mes sage to information message property is selected Default Blank How to Directly enter in the text box or edit by the Character String Input dia change log box which appears when clicking the button Restriction Up to 2048 characters R20UT3284EJ0101 Rev 1 01 tENESAS Page 148 of 204 Aug 01 2015 CS Change information and warning message to error message A WINDOW REFERENCE 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 informa tion and warning messages to error Yes Specify message number CHange_message Error lt Mes sage number gt Specifies the number of informa tion or warning message of which type is to be changed to error No Does not change the type
56. 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 Edit by the Text Edit dialog box which appears when clicking the change button For the subproperty you can enter directly in the text box Restriction Up to 1024 characters Up to 256 items can be specified R20UT3284EJ0101 Rev 1 01 ztENESAS Page 142 of 204 Aug 01 2015 CS A WINDOW REFERENCE Binary file Specify the binary files Specify in the format of file name section name number of alignmeni section attri bute 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 exe cute will be all valid The following placeholders are supported ActiveProjectDir Replaces with the absolute path of the a
57. perform source debugging with debugger This option corresponds fo L R20UT3284EJ0101 Rev 1 01 ztENESAS Page 75 of 204 Aug 01 2015 CS A WINDOW REFERENCE Description of each category 1 Debug Information The detailed information on debug information is displayed and the configuration can be changed Add debug information Select whether to generate the debug information It is possible to perform source debugging with the debugger by outputting information for source debugging to the output file This corresponds to the g option of the ccrl command Default Yes g How to Select from the drop down list change Restriction Yes g Generates the debug information No Does not generate the debug information Enhance debug infor mation with optimiza tion 2 Optimization Select whether to enhance debug information at optimization This corresponds to the g_line option of the ccrl command This property is displayed 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 02 00 or higher or when V1 02 00 or higher is selected in the Using compiler package version property When Yes g in the Add debug information property is selected Default No How to Select from the drop down list ch
58. result of preprocessing for the source file to a source file file This corresponds to the P option of the ccrl command Default Configuration of the compile option How to Select from the drop down list change Restriction Yes P Outputs the execution result of preprocessing for the source file to a file No Does not output the execution result of preprocess ing for the source file to a file Output folder for pre Specify the folder which the preprocessed source file is output processed source file The file is output under the source file name with the extension replaced by i If a relative path is specified the reference point of the path is the main project or sub project 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 If this is blank it is assumed that the project folder has been specified This corresponds to the prep_path option of the ccrl command This property is displayed only when Yes P in the Output preprocessed source file property is selected Default Configuration of the compile option How to Directly enter in the text box or edit by the Browse For Folder dialog change box which appears when clicking the button Restriction Up to 247 characters 10 Assemble Lis
59. rule number in decimal This corresponds to the misra20XX option of the ccrl command This property is displayed only when Apply rules that are classified as required and specified rule number misra20XX required_add in the Apply rule property is selected Default Blank How to Directly enter in the text box or edit by the Specify Rule Number dia change log box which appears when clicking the button Restriction Up to 259 characters Exclusion rule number from required rule Specify the required rule number to be excluded from the check This property is usable only in the Professional Edition Specify at least one rule number in decimal This corresponds to the misra20XX option of the ccrl command This property is displayed only when Ignore specified rule number from rules that are classified as required misra20XX required_remove in the Apply rule property is selected Default Blank How to Directly enter in the text box or edit by the Specify Rule Number dia change log box which appears when clicking the button Restriction Up to 259 characters R20UT3284EJ0101 Rev 1 01 ztENESAS Page 93 of 204 Aug 01 2015 CS A WINDOW REFERENCE Rule check exclusion Specify files that will not be checked against the MISRA C rules file This property is usable only in the Professional Edition The following placeholders are supported BuildModeName Replaces with the build mod
60. settings the same as those of the Link Options tab Makes the message related settings in the property of the Hex Output Options R20UT3284EJ0101 Rev 1 01 7tENESAS Page 137 of 204 Aug 01 2015 CS A WINDOW REFERENCE 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 This property is displayed only when No in the Use same message related settings as Link Options tab property is selected Default No NOMessage How to change Select from the drop down list Restriction Yes Message Outputs information messages No NOMessage Suppresses the output of informa tion 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 exam ple 4 200 203 1300 This corresponds to the NOMessage option of the rlink command This property is displayed only when No in the Use same message related settings as Link Options tab property is selected and 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
61. sion size until the code size increases by 100 becomes twice the initial size This corresponds to the Oinline_size option of the ccrl command This property is displayed only when Yes Auto detect Oinline 2 in the Perform inline expansion property is selected or when Yes To adjust the level of optimiza tion in the Perform inline expansion property and Speed precedence Ospeed in the Optimization Level property are selected Default Configuration of the compile option How to Directly enter in the text box change Restriction 0 to 65535 decimal number Use br instruction to Select whether to give precedence to using br instructions in the place of call instruc call a function at the tions when the function ends with a function call end of the function This corresponds to the Otail_call option of the ccrl command Default Configuration of the compile option How to Select from the drop down list change Restriction Yes To adjust the level of Performs optimization according to the optimization None Level of optimization property Yes Otail_call on Gives precedence to using br instructions in the place of call instructions when the function ends with a function call The code size can be reduced by remov ing the ret instruction However some debug functions cannot be used No Otail_call off Uses call instructions when the function ends with a function call
62. 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 cat egory 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 R20UT3284EJ0101 Rev 1 01 Aug 01 2015 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
63. the Include files at head of compiling units property Figure 2 73 Include files at head of compiling units Property 4 Preprocess 5 so pd Ailin indude yatag il undefiniton underan Run a build of the project Run a build of the project A load module file is generated with the variables and functions allocated as specified in the variables functions information header file R20UT3284EJ0101 Rev 1 01 ztENESAS Page 47 of 204 Aug 01 2015 CS 2 FUNCTIONS 2 12 Automatically Update the I O Header File When an application project is newly created an I O header file corresponding to the selected device is automatically generated If the I O header file needs to be automatically updated in response to the update of the device file use the following update method The I O header file is automatically generated as iodefine h when an application project is newly created and it is reg istered in the project tree Figure 2 74 I O Header File iodefine h Project Trea ax e 2 al i RSFIO0EH ea i CC RL Build Tool H E RL7A Simulator Debug Tool e y File a estart asm 0 hdwinitasm Remark The I O header file is generated in the same folder containing the project file If a file with the same name already exists the existing file is renamed as iodefine bak as a backup The timing to update the I O header file and the update method are shown below At opening of the project CS check
64. the Remove but ton Description of each area 1 Select sections This area displays the name of all sections allocated to the address selected in the Section Settings dialog box Select sections to be deleted by clicking their names You can select multiple sections by left clicking while holding down the Ctrl or Shift key Function buttons Button Function Closes this dialog box and deletes the selected section from the address section area in the Section Settings dialog box Deletes the section group when the section group an address and the sections allo cated to the address includes no section If no sections are left in the Overlayn column in the address section area the col umn itself is deleted Cancel Cancels the settings and closes this dialog box Unassign All Closes this dialog box and deletes all the sections the section group selected in the address section area in the Section Settings dialog box Help Displays the help of this dialog box R20UT3284EJ0101 Rev 1 01 ztENESAS Page 198 of 204 Aug 01 2015 Revision Record Description Summary Feb 01 2015 First Edition issued Aug 01 2015 Figure 2 4 Option Dialog Box General Build Category is replaced The description of the link map file name in 2 4 3 Output map information is amended The description of the link map file name in 2 4 4 Output library information is amended
65. the ccrl command This property is displayed only in the following cases When Apply all rules is selected in the Apply rule property When Apply rules that are classified as required is selected in the Apply rule property When Apply specified rule number is selected in the Apply rule property and a rule number is specified in the Rule number property When Ignore specified rule number is selected in the Apply rule property and a rule number is specified in the Rule number property When Apply rules that are classified as required and specified rule number is selected in the Apply rule property and a rule number is specified in the Check rule number besides required rule property When Ignore specified rule number from rules that are classified as required is selected in the Apply rule property and a rule number is specified in the Exclusion rule number from required rule property When Apply rules that are described in the specified file is selected in the Apply rule property and a rule number description file is specified in the Rule number description file property Default Configuration of the compile option How to Select from the drop down list change Restriction Yes Enables MISRA C rule check and check_language_extension outputs messages when the rule check is partially suppressed by the unique language specifications extended from the C language stan dard
66. the location calling functions This corresponds to the Oinline_level option of the ccrl command This property is displayed only when Perform the default optimization None Code size precedence Osize or Speed precedence Ospeed in the Level of optimiza tion property is selected Default Configuration of the compile option How to change Select from the drop down list Restriction Yes To adjust the level of optimization None Performs optimization according to the Level of optimization property Yes Only specified func tions Oinline_level 1 Performs inline expansion at the location calling the function for which pragma inline is specified Yes Auto detect Oinline_level 2 Distinguishes the function that is the tar get of inline expansion automatically and expands it Yes Auto detect without code size increase Oinline_level 3 Distinguishes the function that is the tar get of inline expansion automatically and expands it while minimizing the increase in code size No Oinline_level 0 ztENESAS Suppresses all inline expansion including the function for which pragma inline is specified Page 160 of 204 CS A WINDOW REFERENCE Maximum increasing Specify the maximum increasing rate of the code size up to which inline expan rate of inline expan sion is performed Example When 100 is specified inline expansion will be applied
67. the main project or subproject folder unless the drives are different 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 VFINFO 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 01 00 or higher or when V1 01 00 or higher is selected in the Using compiler package version property When Yes VFINFO in the Output variables functions information header file property is selected Default BuildModeName How to Directly enter in the text box o
68. 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 SEction_forbid option of the rlink command This property is not displayed when No optimize NOOPtimize in the Optimization type property is selected Default Section to disable optimization number of defined items How to Edit by the Text Edit dialog box which appears when clicking the change button For the subproperty you can enter directly in the text box Restriction Up to 32767 characters Up to 65535 items can be specified Address range to dis able optimization Specify the address range in which to suppress optimization in the format of address size with one specification on one line This corresponds to the Absolute_forbid option of the rlink command This property is not displayed when No optimize NOOPtimize in the Optimization type property is selected Default Address range to disable optimization number of defined items How to Edit by the Text Edit dialog box which appears when clicking the change button For the subproperty you can enter directly in the text box Restriction Up to 32767 characters Up to 65535 items can be specified R20UT3284EJ0101 Rev 1 01 Aug 01 2015 ztENESAS Page 108 of 204 CS A WINDOW REFE
69. the values in the case statements and selects and pro cesses case labels from the switch statement values The code will branch to all the case state ments with about the same speed However if case values are not used in suc cession an unnecessary area will be cre ated Table jump relative Outputs the code in the table jump format switch rel_table relative branch for switch statements in pro grams References a table indexed on the values in the case statements and selects and pro cesses case labels from the switch statement values The code will branch to all the case state ments with about the same speed However if case values are not used in suc cession an unnecessary area will be cre ated R20UT3284EJ0101 Rev 1 01 ztENESAS Page 88 of 204 Aug 01 2015 CS A WINDOW REFERENCE Output comment to Select whether to output a C source program as a comment to the assembly source assembly source file file to be output This corresponds to the pass_source option of the ccrl command This property is displayed only when Yes asm_path in the Output assembly source file property in the Output File category is selected or when Yes asmopt prn_path in the Output assemble list file property in the Assemble List category is selected Default No How to Select from the drop down list change Restriction Yes pass_ source Outputs a C source program as a comment to the
70. 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 exam ple 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 mes sage output property is selected Default Blank How to change Directly enter in the text box or edit by the Character String Input dia log box which appears when clicking the button Restriction Up to 2048 characters Notify unused symbol Select whether to notify the defined symbol that is not referenced This corresponds to the MSg_unused option of the rlink command This property is displayed only when Yes Message in the Enable information mes sage output property is selected or the Suppress number of information message property is specified Default No How to change Select from the drop down list Restriction Yes MSg_unused Notifies the defined symbol that is not referenced No Does not notify the defined sym bol that is not referenced Change warning mes sage 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
71. whole include paths specified for build tool gt Macro definition Macro undefination rr p ices eek Such information is generated when debugging a Species program just like the case of wishing to perform source debugging with debugger This option conesponds bo R20UT3284EJ0101 Rev 1 01 ztENESAS Page 179 of 204 Aug 01 2015 CS A WINDOW REFERENCE Description of each category 1 Debug Information The detailed information on debug information is displayed and the configuration can be changed Add debug information Select whether to generate the debug information It is possible to perform source debugging with the debugger by outputting information for source debugging to the output file This corresponds to the g option of the ccrl command Default Configuration of the assemble option How to Select from the drop down list change Restriction Yes g Generates the debug information No Does not generate the debug information 2 Optimization The detailed information on the optimization is displayed and the configuration can be changed Outputs additional Select whether to output additional information for inter module optimization information for inter At linkage inter module optimization is applied to files for which this option has been module optimization specified This corresponds to the goptimize option of the ccrl command Default Configuration of the assemble
72. 10 Renesas Electronics India Pvt Ltd No 777C 100 Feet Road HALII Stage Indiranagar Bangalore India Tel 91 80 67208700 Fax 91 80 67208777 Renesas Electronics Korea Co Ltd 12F 234 Teheran ro Gangnam Gu Seoul 135 080 Korea Tel 82 2 558 3737 Fax 82 2 558 5141 2015 Renesas Electronics Corporation All rights reserved Colophon 4 0 CS RENESAS Renesas Electronics Corporation R20UT3284EJ0101
73. 10 Output file name Property 4 Output File Cuma file format User barsi Oma l ears U CELL test i This property supports the following placeholders ActiveProjectName Replaces with the active project name MainProjectName Replaces with the main project name ProjectName Replaces with the project name Remark You can also change the option in the same way with the Output file name property in the Fre quently Used Options for Create Library category on the Common Options tab If the Output file format property is changed the following message dialog box will open R20UT3284EJ0101 Rev 1 01 ztENESAS Page 15 of 204 Aug 01 2015 CS 2 FUNCTIONS Figure 2 11 Message Dialog Box Question QU21001 E De you changa aie edenaion When Yes is selected in the dialog box the extension of the output file name is changed according to the format selected in the Output file format property Figure 2 12 Output file format and Output file name Property Dutpat Eilg Relocatable file FOrm Relocate Output file name test rel 2 4 2 Output an assemble list The assemble list the code of the assemble result is output to the assemble list file Select the build tool node on the project tree and select the Compile Options tab on the Property panel To output the assemble list file select Yes asm_option prn_path in the Output assemble list file property in the Assemble List category
74. 157 of 204 Aug 01 2015 CS A WINDOW REFERENCE Figure A 13 Property Panel Individual Compile Options Tab B la 4 ele Add debug information Yasla Enhance debug information with optimization Yeel g_ine Optimization Level of optimization Perfom the defauk optimization Mone Optimizaton Detals Maximum number of boop sapansions Remove unused static functions Yee To adjust the level of optimizations None Perform inking expansion Yee To adjust the level of optimizations Mame Use br instruction to call a function at the end of the function Yee To adjust the level of optimization Mone Perform inter module optimization No Perform optimization considering type of data indicated by pointer Mo Outputs additional information for inter medule optimization Ho Create subroutine for same inshruction sequence Ho Preprocess Additional include paths Additional include path M Use whole include paths specified for build tool Yas bo Include files at head of compiling units Include les at head of compiling unts 0 bo Macro definition Macro defintian 0 bo Macro undefinition Macro undefintion U Quality Improvement Detect stack overilow Noone gt ClLanguage gt MISRA C Rule Check bo Error Oulpat gt Warning Message bo Others Add debug informabon Specifies whether to generate the debug information Such information is generated when debugging program just like the case of washing io perform source debugging with debugger This opt
75. 2 YesiQutout to the output fle DEBug Compress debug formation Using libraries gt Skepta librares Use etandend mathematical libraries Use runtime lebranes gt Device Output Code Specify execution sheet addresa Fill with paddeng date at the end of a eechen gt Address seting for specified ares of vector table Address seting for unused vector area gt Variables iuncions information Remark Common Options tab R20UT3284EJ0101 Rev 1 01 Aug 01 2015 Not NOCOmpress No Ho optinize MOOPimiza Binary file 0 Symbol defingion 0 Projectlame tabs Ling libraries 0 System bbrariee D Yes Ye Ho Ha Address setting for spectied aea of vetar tablejil ztENESAS Often used options have been gathered under the Frequently Used Options for Link category on the Page 26 of 204 CS 2 FUNCTIONS 2 7 1 Add a user library Adding a user library is made with the property or on the project tree 1 Addition using the property Select the build tool node on the project tree and select the Link Options tab on the Property panel Adding a user library is made with the Using libraries property in the Library category Figure 2 35 Using libraries Property gt ii i Use shanderd mathemehoal lbranes Yes Use runtime libres Yes If you click the button the Path Edit dialog box will open Figure 2 36 Path Edit Dialog Box ian Path Edit Patine path ear cove inai Lad Y
76. 588 6130 Renesas Electronics Canada Limited 9251 Yonge Street Suite 8309 Richmond Hill Ontario Canada L4C 9T3 Tel 1 905 237 2004 Renesas Electronics Europe Limited Dukes Meadow Millboard Road Bourne End Buckinghamshire SL8 5FH U K Tel 44 1628 585 100 Fax 44 1628 585 900 Renesas Electronics Europe GmbH Arcadiastrasse 10 40472 Dusseldorf Germany Tel 49 211 6503 0 Fax 49 211 6503 1327 Renesas Electronics China Co Ltd Room 1709 Quantum Plaza No 27 ZhiChunLu Haidian District Beijing 100191 P R China Tel 86 10 8235 1155 Fax 86 10 8235 7679 Renesas Electronics Shanghai Co Ltd Unit 301 Tower A Central Towers 555 Langao Road Putuo District Shanghai P R China 200333 Tel 86 21 2226 0888 Fax 86 21 2226 0999 Renesas Electronics Hong Kong Limited Unit 1601 1611 16 F Tower 2 Grand Century Place 193 Prince Edward Road West Mongkok Kowloon Hong Kong Tel 852 2265 6688 Fax 852 2886 9022 Renesas Electronics Taiwan Co Ltd 13F No 363 Fu Shing North Road Taipei 10543 Taiwan Tel 886 2 8175 9600 Fax 886 2 8175 9670 Renesas Electronics Singapore Pte Ltd 80 Bendemeer Road Unit 06 02 Hyflux Innovation Centre Singapore 339949 Tel 65 6213 0200 Fax 65 6213 0300 Renesas Electronics Malaysia Sdn Bhd Unit 1207 Block B Menara Amcorp Amcorp Trade Centre No 18 Jin Persiaran Barat 46050 Petaling Jaya Selangor Darul Ehsan Malaysia Tel 60 3 7955 9390 Fax 60 3 7955 95
77. 64 items can be specified R20UT3284EJ0101 Rev 1 01 Aug 01 2015 RENESAS Page 128 of 204 CS A WINDOW REFERENCE Commands executed Specify the command to be executed after link processing after link 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 LinkedFile Replaces with the absolute path of the output file under link pro cessing 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 rega
78. CE Select optimization type Inter module optimization is performed for modules to which goptimize was added at compilation or assemble This corresponds to the NOOPtimize and OPtimize option of the rlink command Speed oriented optimization OPtimize SPeed and Safe optimization OPti mize SAFe are displayed 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 02 00 or higher or when V1 02 00 or higher is selected in the Using compiler package version property 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 Performs optimization with empha sis on execution speed Safe optimization OPti mize SAFe Performs safe optimization Custom Performs optimization for the speci fied options Deletes variables functions that are not referenced Select whether to delete symbols that are not referenced This corresponds to the OPtimize SYmbol_delete option of the rlink command This property is displayed in the following cases When Always latest version which was installed in the Using compiler package version prop
79. Configuration of the compile option How to Select from the drop down list change Restriction Yes asm_path Outputs the assembly source file of the compile result for the C source No Does not output the assembly source file of the compile result for the C source R20UT3284EJ0101 Rev 1 01 ztENESAS Page 169 of 204 Aug 01 2015 CS A WINDOW REFERENCE Output folder for Specify the folder which the assembly source file is output assembly source file If a relative path is specified the reference point of the path is the main project or sub project 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 The assembly source file is saved under the C source file name with the extension replaced by asm If this is blank it is assumed that the project folder has been specified This corresponds to the asm_path option of the ccrl command This property is displayed only when Yes asm_path in the Output assembly source file property is selected Default Configuration of the compile option How to Directly enter in the text box or edit by the Browse For Folder dialog change box which appears when clicking the button Restriction Up to 247 characters Output preprocessed Select whether to output the execution
80. Default Blank How to change Directly enter in the text box or edit by the Character String Input dia log box which appears when clicking the button Restriction Up to 32767 characters 8 List The detailed information on the list is displayed and the configuration can be changed Output link map file Select whether to output the link map file This corresponds to the LISt and SHow options of the rlink command Default Yes List contents specify LISt How to change Select from the drop down list Restriction Yes List contents not specify LISt SHow Outputs information according to the out put format to the link map file Yes List contents ALL LISt SHow ALL Outputs all information according to the output format to the link map file Yes List contents spec ify LISt Outputs the specified information to the link map file No Does not output the link map file R20UT3284EJ0101 Rev 1 01 ztENESAS Aug 01 2015 Page 117 of 204 CS A WINDOW REFERENCE Output symbol infor Select whether to output the symbol information symbol address size type and opti mation mization contents 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 Select from the drop down list
81. Edit dialog box which appears when clicking the change button For the subproperty you can enter directly in the text box Restriction Up to 247 characters Up to 256 items can be specified R20UT3284EJ0101 Rev 1 01 ztENESAS Page 99 of 204 Aug 01 2015 CS A WINDOW REFERENCE System include paths Change the specified order of the include paths which the system set during assem bling 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 system include path is searched with lower priority than the additional include path The reference point of the path is the project folder This corresponds to the I option of the ccrl command The include path is displayed as the subproperty Default System include paths number of defined items How to Ed
82. 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 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 Use standard mathe matical 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 Use runtime libraries R20UT3284EJ0101 Rev 1 01 Aug 01 2015 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 RENESAS Page 67 of 204 CS A WINDOW REFERENCE 9 Error Output The detailed information on the error output is displayed and the configuration can be changed Output error message S
83. IDE Version of IDE of CA78KOR project gt Version of IDE of CC RL project 3 lt Compiler package version gt CA78KOR Version gt CC RL Version 4 lt Options not to use Build mode gt Command name Tab name of build tool property Option 5 lt Options to change Build mode gt Command name Tab name of build tool property Option of CA78KOR project gt Option of CC RL project Time and date on which a project was created The time and date on which a CC RL project was created by reusing a CA78KOR project is output using format dddd mmmm dd yyyy hh mm ss AM PM R20UT3284EJ0101 Rev 1 01 ztENESAS Page 10 of 204 Aug 01 2015 CS 2 FUNCTIONS Description CS IDE Integrated Development Environment Framework version The version of IDE of a CA78KOR project and the version of IDE of a CC RL project are output Compiler package version The compiler package used in a CA78KOR 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 Options not to use Build mode If an option that has been set in a CA78KOR 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 exi
84. Man Project Dieser ib Bowe O Permi peet eoccrieret paih Placeholder Placeholder amu Chesonntion ie Actes Prost Dok emos Absolute path of the sdra E SotweeProectMicomheme ASFIDOLE Active priest mierni Active Progect Maret sae Active pied ream Busse Mir Dom hid Euki mede niami gar roped Der Dak aape Absohda path of fanang Marrs Meconiems ASFIMLE flsin omieci micronnimlies iti b Jal L Ece in Enter the library file including the path per line in Path One path per one line You can specify up to 259 characters per line up to 65536 lines Remark 1 This property supports placeholders If a line is double clicked in Placeholder the placeholder will be reflected in Path One path per one line Remark 2 You can also specify the library file by one of the following procedures Drag and drop the folder using such as Explorer Click the Browse button and then select the folder in the Specify Using Library File dialog box Double click a row in Placeholder If you click the OK button the entered library files are displayed as subproperties R20UT3284EJ0101 Rev 1 01 ztENESAS Page 27 of 204 Aug 01 2015 CS 2 FUNCTIONS Figure 2 37 Using libraries Property After Setting Library Files Using libraries 1 iin nee eee Use a ae ae libraries Yes Uze runtime libraries Yee To change the library files you can use the button or enter the path d
85. NESAS Page 159 of 204 Aug 01 2015 CS A WINDOW REFERENCE Maximum number of loop expansions Specify the maximum number of times to expand the loops such as for and while If O or 1 is specified expansion is suppressed If this is blank it is assumed that 2 has been specified This corresponds to the Ounroll option of the ccrl command This property is displayed only when Perform the default optimization None Code size precedence Osize or Speed precedence Ospeed in the Level of optimiza tion property is selected Default Configuration of the compile option How to change Directly enter in the text box Restriction 0 to 999 decimal number or blank Select whether to remove the static functions which are not called This corresponds to the Odelete_static_func option of the ccrl command Remove unused static functions Default Configuration of the compile option How to change Select from the drop down list Restriction Yes To adjust the level of optimization None Performs optimization according to the Level of optimization property Yes Odelete_static_func Removes the unused static functions which are not called No Odelete_static_func off Does not remove the unused static func tions which are not called Perform inline expan sion R20UT3284EJ0101 Rev 1 01 Aug 01 2015 Specify whether to perform inline expansion at
86. No How to change Select from the drop down list Restriction Yes S1 record REcord S1 Outputs the S1 record Yes S2 record REcord S2 Outputs the S2 record Yes S3 record REcord S3 Outputs the S3 record No Outputs various data records according to each address Fill unused areas in the output ranges with the value R20UT3284EJ0101 Rev 1 01 Aug 01 2015 Select whether to fill the vacant area of the output range with data This corresponds to the SPace option of the rlink command This property is displayed only when a file is specified in the Division output file prop erty in the Output File category Default No How to change Select from the drop down list Restriction Yes Random SPace Ran dom Fills the vacant area with random numbers Yes Specification value SPace lt Numerical value gt Fills the vacant area with the speci fied hexadecimal value No ztENESAS Does not fill the vacant area Page 133 of 204 CS A WINDOW REFERENCE Output padding data Specify the hexadecimal value to fill the vacant area This corresponds to the SPace option of the rlink command This property is displayed only when Yes Specification value SPace lt Numerical value gt in the Fill unused areas in the output ranges with the value property is selected Default FF How to Directly enter in the t
87. O header file This contents are common to all the build modes Default Yes How to change Select from the drop down list Restriction Yes Outputs 1 bit access No Does not output 1 bit access Enable MISRA C option 2 Others Select whether to output an I O header file compatible with the MISRA C rules This contents are common to all the build modes Default No How to change Select from the drop down list Restriction Yes misra_c on Outputs an I O header file compatible with the MISRA C rules No The MISRA C rules are not considered Other detailed information on the I O header file is displayed and the configuration can be changed Other additional options R20UT3284EJ0101 Rev 1 01 Aug 01 2015 Input the I O header file options to be added additionally The options set here are added at the end of the I O header file generation options group Default Blank How to change Directly enter in the text box or edit by the Character String Input dia log box which appears when clicking the button Restriction ztENESAS Up to 259 characters Page 153 of 204 A WINDOW REFERENCE CS Build Settings tab This tab shows the detailed information on each C source file assembly source file object file and library file catego rized by the following and the configuration can be changed
88. OM section to be added and click the OK button to add the entered section to Section in the Section Settings dialog box R20UT3284EJ0101 Rev 1 01 ztENESAS Page 31 of 204 Aug 01 2015 CS 2 FUNCTIONS Figure 2 46 Section Settings Dialog Box After ROM Sections Are Added For other ROM sections set addresses and section names in the same way Remark Click the Address column and click the Add button to open the Section Address dialog box allowing you to add a new address Figure 2 47 Section Settings Dialog Box After Multiple ROM Sections Are Added R20UT3284EJ0101 Rev 1 01 ztENESAS Page 32 of 204 Aug 01 2015 CS 2 FUNCTIONS lt 2 gt Set RAM sections overlaid sections Click an added address and click the Add button to open the Section Address dialog box Figure 2 48 Section Address Dialog Box Enter in Address the address of the RAM section to be added and click the OK button to add the entered address to Address in the Section Settings dialog box Figure 2 49 Section Settings Dialog Box After RAM Section Addresses Are Added Click here and then click the New Over lay button Click the added address row Address column or Section column and click the New Overlay button to open the Add Overlay dialog box Figure 2 50 Add Overlay Dialog Box Enter in Section name the name of the RAM
89. OM to RAM mapped section i im userljs ieot _uselaR daa usetl daa useR To change the section names you can use the button or enter them directly in the text box of the subprop erty b Set ROM sections and RAM sections overlaid sections Setting the sections is made with the Section start address property in the Section category Figure 2 41 Section start address Property corel ted data adala teti corm 02000_ cataR bes ada b ROM to RAM mapped section ROM to RAM mapped section 8 R20UT3284EJ0101 Rev 1 01 ztENESAS Page 29 of 204 Aug 01 2015 CS 2 FUNCTIONS lt 1 gt Set ROM sections If you click the button the Section Settings dialog box will open Figure 2 42 Section Settings Dialog Box If you click the Add button the Section Address dialog box will open Figure 2 43 Section Address Dialog Box Enter in Address the address of the ROM section to be added and click the OK button to add the entered address to Address in the Section Settings dialog box R20UT3284EJ0101 Rev 1 01 ztENESAS Page 30 of 204 Aug 01 2015 CS 2 FUNCTIONS Figure 2 44 Section Settings Dialog Box After ROM Section Addresses Are Added Click the Section column on the added address row and click the Add button to open the Add Section dia log box Figure 2 45 Add Section Dialog Box Enter in Section name the name of the R
90. RENCE 3 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 ibrary 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 Edit by the Text Edit dialog box which appears when clicking the change 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 alignmeni
91. RW options assumed to be specified 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 01 00 or higher or when V1 01 00 or higher is selected in the Using compiler package version property For a device in which allocation to the hot plug in RAM area is controllable Default No How to Select from the drop down list change Restriction Yes Error mes Prohibits the allocation to the hot plug in sage OCDHPI RAM area and displays an error Yes Warning mes Outputs a warning when allocating to the hot sage OCDHPIW plug in RAM area No Uses the hot plug in RAM area as the internal RAM area An error or warning is not dis played Reserve working Select whether to reserve a 4 byte memory as the work area for the RRM DMM func memory for RRM tion DMM function This corresponds to the RRM 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 01 00 or higher or when V1 01 00 or higher is selected in the Using compiler package version property When the device is the
92. Relocatable file FOrm Relocate in the Out put file format property in the Output File category Default Yes Output to the output file DEBug How to Select from the drop down list change Restriction Yes Output to the output Outputs debug information file DEBug No Does not output debug information R20UT3284EJ0101 Rev 1 01 ztENESAS Page 141 of 204 Aug 01 2015 CS A WINDOW REFERENCE Delete local symbol Select whether to delete local symbol name information name information This corresponds to the Hide option of the rlink command Default No How to Select from the drop down list change 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 ibrary 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
93. Restriction Xmisra2004 gt Xmisra20XX MISRA C 2004 gt MISRA C The Restriction value of the Use support for porting from assembler of CA78KOR property in 6 Others is amended No None gt No The display condition for Restriction is added to the description of the Optimization type property in 2 Optimization The followings are added to Restriction Speed oriented optimization OPtimize SPeed Safe optimization OPtimize SAFe The following properties are added to 2 Optimization Deletes variables functions that are not referenced Unreferenced symbol that disables deletion by optimization The default of the Section to disable optimization property in 2 Optimization is amended The default of the Address range to disable optimization property in 2 Optimiza tion is amended In the description of the Variables functions information header file name property in 9 Variables functions information the description on the case where the extension was omitted is amended The name of the Check allocation that crosses 64KB boundary property in 11 Verify is amended Check allocation that crosses 64KB boundary gt Suppress checking section allocation that crosses 64KB 1 boundary In accordance with the above change the description of the property and the description of the Restriction values are amended The description of the Target range property in
94. Settings tab for C source file assembly source file object file and library file Individual Compile Options tab for C source file Individual Assemble Options tab for assembly source file File Information tabNo e Note See CS Integrated Development Environment User s Manual Project Operation for details about the File Information tab Aug 01 2015 Undo A WINDOW REFERENCE Edit menu only available for the Property panel Cancels the previous edit operation of the value of the property Cut While editing the value of the property cuts the selected characters and copies them to the clipboard Copy Copies the selected characters of the property to the clipboard Paste While editing the value of the property inserts the contents of the clipboard Delete While editing the value of the property deletes the selected characters Select All Context menu Undo While editing the value of the property selects all the characters of the selected property Cancels the previous edit operation of the value of the property Cut While editing the value of the property cuts the selected characters and copies them to the clipboard Copy Copies the selected characters of the property to the clipboard Paste While editing the value of the property inserts the contents of the clipboard Delete While editing the value of the property dele
95. This corresponds to the OUtput option of the rlink command This property is displayed only when Yes in the Output hex file property is selected Default ProjectName mot How to Directly enter in the text box change Restriction Up to 259 characters R20UT3284EJ0101 Rev 1 01 ztENESAS Page 65 of 204 Aug 01 2015 CS A WINDOW REFERENCE Division output file Specify the division output files Specify in the format of file name start address end address or file name section name with one entry per line If multiple section names are specified delimit them with a colon as in file name sec tion name section name example file1 mot sec1 sec2 Specify the address in hexadecimal example file2 mot 400 4ff If the extension is omitted it is automatically added according to the selection in the Hex file format property When Intel HEX file FOrm Hexadecimal is selected hex When Motorola S record file FOrm Stype is selected mot When Binary file FOrm Binary is selected 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 in
96. UNCTIONS Figure 2 59 Text Edit Dialog Box Tet Edt Treat file Labs asec iser fiet absa 10010 HF Placahelder Pisceholder Vebue Deecaphon beline Projecti Dawekaangk Abaskaie path of the patie project To AdireePropdMconheme FAS VLE Adis prs oicaoningller nas Actes Project em sampe Adie pied meme ESET E e Bubi mode name Diib amka Ahanda nathani Tha main rriar ide m F Specify the division output file name in Text in the format of file name start address end address start address end address The start address and end address of the output range or file name section name section name The name of the output section with one file name per line If multiple section names are specified delimit them with a colon as in file name section name section name Specify the start address and end address in hexadecimal You can specify up to 259 characters per line up to 65535 lines If you click the OK button the entered division output file names are displayed as subproperties Figure 2 60 Division output file Property After Setting Division Output File Names Output Fike file 1 abe gec1eecd fle ae 10000 1h To change the division output file names you can use the button or enter them directly in the text box of the subproperty Set the method for filling the vacant area Set the method for filling the vacant area in the output range Fill the vacant area with random numbers Select Yes R
97. absolute path of the file to be compiled 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 compile processing The placeholders can be described in the script The specified command is displayed as the subproperty Default Commands executed after compile processing number of defined items How to Edit by the Text Edit dialog box which appears when clicking the change 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 Input the compile option to be added additionally optio
98. 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 specified include path is searched with higher priority than the standard include file folder of CC RL The reference point of the path is the project folder When this property is omitted only the standard folder of CC RL is searched This corresponds to the I option of the ccrl command The specified include path is displayed as the subproperty When the include path is added to the project tree the path is added to the top of the subproperties Uppercase characters and lowercase characters are not distinguished for the include paths Default Additional include paths number of defined items How to Edit by the Path Edit dialog box which appears when clicking the change button For the subproperty you can enter directly in the text box Restriction Up to 247 characters Up to 256 items can be specified System include paths Change the specified order of the include paths which the system set during compil ing 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 ab
99. absolute path of the temporary folder WinDir Replaces with the absolute path of the Windows system folder The specified include path is searched with higher priority than the standard include file folder of CC RL The reference point of the path is the project folder When this property is omitted only the standard folder of CC RL is searched This corresponds to the I option of the ccrl command The specified include path is displayed as the subproperty When the include path is added to the project tree the path is added to the top of the subproperties Uppercase characters and lowercase characters are not distinguished for the include paths Default Additional include paths number of defined items How to Edit by the Path Edit dialog box which appears when clicking the change button For the subproperty you can enter directly in the text box Restriction Up to 259 characters Up to 256 items can be specified R20UT3284EJ0101 Rev 1 01 ztENESAS Page 61 of 204 Aug 01 2015 CS A WINDOW REFERENCE System include paths Change the specified order of the include paths which the system set during assem bling 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
100. aces 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 assemble processing The placeholders can be described in the script The specified command is displayed as the subproperty Default Configuration of the assemble option How to Edit by the Text Edit dialog box which appears when clicking the change 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 Input the assemble option to be added additionally options The options set here are added at the end of the assemble options group Default Configuration of the assemble option How to Directly enter in the text box or edit by the Character String Input change dialog box which appears when clicking the button Restriction Up to 259 characters
101. acter encoding is displayed and the configuration can be changed R20UT3284EJ0101 Rev 1 01 Aug 01 2015 ztENESAS Page 100 of 204 CS Character encoding A WINDOW REFERENCE Select the character code to be used for comments and character strings in the source file This corresponds to the character_set option of the ccrl command Default Auto None How to change Select from the drop down list Restriction Auto None Interprets the Japanese character code in the source file as SUIS on Japanese OS On other than Japanese OS does not interpret the character code in the source file SJIS character_set sjis Interprets the Japanese character code in the source file as SJIS EUC character_set euc_jp Interprets the Japanese character code in the source file as EUC UTF 8 character_set utf8 Interprets the Japanese character code in the source file as UTF 8 Big5 character_set big5 Interprets the Chinese character code in the source file as Traditional Chi nese GB2312 character_set gbk Interprets the Chinese character code in the source file as Simplified Chinese No process character_set none Does not interpret the Japanese Chi nese character code in the source file Format of numerical constant 5 Assemble List Specify the representation format of the base number of numerical constants example Prefix format O
102. ainProjectDir 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 link 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 link processing number of defined items How to Edit by the Text Edit dialog box which appears when clicking the change button For the subproperty you can enter directly in the text box Restriction Up to 1023 characters Up to
103. ainst the rules of the required type and the rules with the specified numbers among the rules which are supported Ignore specified rule num ber from rules that are clas sified as required misra20XX required_remov e Checks the source code against the rules of the required type except for the rules with the specified numbers among the rules which are supported Apply rules that are described in the specified file misra20XX lt file name gt Checks the source code against the rules with the numbers described in specified file among the rules which are supported Not apply rule None Does not apply the MISRA C rules Rule number descrip tion file Specify the rule number description file MISRA C rule file This property is usable only in the Professional Edition The following placeholders are supported BuildModeName Replaces with the build mode name MicomToolPath Replaces with the absolute path of the install folder of this product ProjectName Replaces with the project name This corresponds to the misra20XX option of the ccrl command This property is displayed only when Apply rules that are described in the specified file misra20XX lt file name gt in the Apply rule property is selected Default Blank How to Directly enter in the text box or edit by the Specify MISRA C Rule File change dialog box which appears when clicking the button Re
104. alog Box TeaEdt Tast TEST TIMEs10 Enter the macro definition in Text in the format of macro name defined value with one macro name per line You can specify up to 256 characters per line up to 256 lines The defined value part can be omitted and in this case 1 is used as the defined value If you click the OK button the entered macro definitions are displayed as subproperties Figure 2 33 Macro definition Property After Setting Macros a Preprocess Additional include paths Additional include pathe D Waiari clude paih q F A AB Waco definition Macro 0 TEST 1 i TIME 10 gt Macro undehnitpon Macro undefinition 0 To change the macro definitions you can use the button or enter the path directly in the text box of the subproperty Remark You can also set the option in the same way with the Macro definition property in the Frequently Used Options for Assemble category on the Common Options tab R20UT3284EJ0101 Rev 1 01 ztENESAS Page 25 of 204 Aug 01 2015 CS 2 7 Set Link Options 2 FUNCTIONS To set options for the link phase select the Build tool node on the project tree and select the Link Options tab on the Property panel You can set the various link options by setting the necessary properties in this tab Caution Figure 2 34 Property Panel Link Options Tab Property iS Il A en This tab is not displayed for the library project a
105. and Default Handles as unsigned None How to Select from the drop down list change Restriction Handles as signed Handles the bit field type as signed signed_bitfield Handles as Handles the bit field type as unsigned unsigned None Structure packing Select whether to perform structure packing This corresponds to the pack option of the ccrl command This property is displayed 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 01 00 or higher or when V1 01 00 or higher is selected in the Using compiler package version property Default No How to Select from the drop down list change Restriction Yes pack Performs alignment of members in a structure in 1 byte units instead of performing alignment according to the member type No Performs alignment of members in a structure according to the member type Handle external vari Select whether to handle all external variables and variables specified with pragma ables as if they are address as if they are volatile qualified volatile qualified This corresponds to the volatile option of the ccrl command Default No How to Select from the drop down list change Restriction Yes volatile Handles all external variables and variables specified with pragma address a
106. and This property is displayed only when Yes CRc in the Outputs the calculation result of CRC property is selected Default Little endian How to Select from the drop down list change Restriction Little endian Outputs the value in little endian mode Big endian Outputs the value in big endian mode Output size Specify the output size for the CRC code This corresponds to the CRc option of the rlink command This property is displayed only when Yes CRc in the Outputs the calculation result of CRC property is selected Default Blank How to Directly enter to the text box change Restriction 2 4 or blank Remark The correspondence between the Type of CRC property of CA78KOR and the Type of CRC prop erty of CC RL is as follows CA78KOR CC RL High speed CRC CRC 16 CCITT CRC CCITT MSB type High speed CRC SENT SENT LSB type General purpose CRC CRC CCITT LSB type 4 Message The detailed information on messages is displayed and the configuration can be changed This category is displayed only when Yes in the Output hex file property in the Output File category is selected Use same message Select whether to make the message related settings the same as those of the Link related settings as Options tab Link Options tab Default Yes How to Select from the drop down list change Restriction Yes Makes the message related
107. and the latest version is V1 01 00 or higher or when V1 01 00 or higher is selected in the Using compiler package version property When Yes Specify address range DEBUG_MONITOR lt Address range gt in the Set debug monitor area property is selected Default The peculiar value for the target device How to Directly enter in the text box change Restriction 0 to FFFFF hexadecimal number without 0x Set user option byte Select whether to set the user option byte This corresponds to the USER_OPT_BYTE option of the rlink command Be sure to set the user option byte value To set it select Yes and specify the user option byte value on the User option byte value property Or set the user option byte value by using an assembler source file The user option byte value depends on the device in use See the user s manual of the device for the value to be specified Default Yes USER_OPT_BYTE How to Select from the drop down list change Restriction Yes Sets a value to the user option byte USER_OPT_BYTE However if the User option byte value prop erty is blank the user option byte is not set No Does not set a value to the user option byte User option byte value Specify the user option byte value in hexadecimal without 0x This corresponds to the USER_OPT_BYTE option of the rlink command Be sure to set the user option byte value by using this property or an assembler
108. andom SPace Random in the Fill unused areas in the output ranges with the value property in the Hex Format category Figure 2 61 Fill unused areas in the output ranges with the value Property 4 Hex Fonmal Hex file farmat Motorola Second file FOnn Stype Lirih ooid Sira Specify data to fill the vacant area Select Yes Specification value SPace lt Numerical value gt in the Fill unused areas in the output ranges with the value property in the Hex Format category The Output padding data property will be displayed R20UT3284EJ0101 Rev 1 01 ztENESAS Page 39 of 204 Aug 01 2015 2 FUNCTIONS CS Figure 2 62 Fill unused areas in the output ranges with the value and Output padding data Property Hex Format S format Motorola Secad fied POm Stype KELDI ba i mused z areas s i the suput nae with ihe value YestSpeciication walue SPace lt Numencal value gt Enter the fill value for the vacant area directly in the text box The range that can be specified for the value is 00 to FFFFFFFF hexadecimal number FF is set by default R20UT3284EJ0101 Rev 1 01 tENESAS Page 40 of 204 Aug 01 2015 CS 2 FUNCTIONS 2 9 Set Create Library Options To set options for the librarian select the Build tool node on the project tree and select the Create Library Options tab on the Property panel You can set the various create library options by setting the necessary properties in this tab
109. ange Restriction Yes g_line Enhances debug information at optimization No Does not enhance debug information at optimization The detailed information on the optimization is displayed and the configuration can be changed R20UT3284EJ0101 Rev 1 01 Aug 01 2015 RENESAS Page 76 of 204 CS A WINDOW REFERENCE Level of optimization Select the level of the optimization for compiling This corresponds to the O option of the ccrl command Default Perform the default optimization None How to Select from the drop down list change Restriction Perform the default Performs optimization that debugging is not optimization None affected optimization of expressions and register allocation and the like Code size prece Performs optimization with the object size dence Osize precedence Regards reducing the ROM RAM usage as important and performs the maximum optimi zation that is effective for general programs Speed precedence Performs optimization with the execution Ospeed speed precedence Regards shortening the execution speed as important and performs the maximum optimi zation that is effective for general programs Debug precedence Performs optimization with the debug prece Onothing dence Regards debugging as important and sup presses all optimization including default optimization 3 Optimization Details The detailed information on the optimi
110. ange can be set using hyphen example 20000 20100 20300 20500 This corresponds to the no_warning option of the ccrl command Default Configuration of the common option How to change Directly enter in the text box or edit by the Character String Input dia log box which appears when clicking the button Restriction Up to 2048 characters Other detailed information on compilation is displayed and the configuration can be changed R20UT3284EJ0101 Rev 1 01 Aug 01 2015 ztENESAS Page 176 of 204 CS A WINDOW REFERENCE Commands executed Specify the command to be executed before compile processing before compile pro Use the call instruction to specify a batch file example call a bat cessing 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 CompiledFile Replaces with the absolute path of the output file under compil ing nputFile Replaces with the absolute path of the file to be compiled 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 Repla
111. any commands you wish to run before or after the build process on the Property panel from the Common Options tab in the Others category set the Commands executed before build processing and Commands executed after build processing properties If there are any commands you wish to run before or after the build process at the file level you can set them from the Individual Compile Options tab for a C source file and Individual Assemble Options tab for an assembly source file Save the project Save the setting contents of the project to the project file R20UT3284EJ0101 Rev 1 01 ztENESAS Page 8 of 204 Aug 01 2015 CS 2 FUNCTIONS 2 2 Convert a CA78KOR project into a CC RL project A project for the CA78KOR 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 The properties of the build tool are also maintained and converted for use with the CC RL Remark When newly creating a project see CS Integrated Development Environment User s Manual Project Operation Caution 1 Since the source files are not converted a build error may occur in some source files immediately after conversion Caution 2 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 CS Integrate
112. ath 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 preinclude option of the ccrl command The specified include file name is displayed as the subproperty Default Include files at head of compiling units 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 247 characters Up to 256 items can be specified Macro definition Specify the name of the macro to be defined Specify in the format of macro name defined value with one macro name per line The defined value part can be omitted and in this case 1 is used as the defined value This corresponds to the D option of the ccrl command 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 subp
113. ation header file property to Yes to generate an empty variables functions information header file and add it to the project it will also appear in the File node of the project tree The output destination is the file set in the Output folder for variables functions information header file property and the Variables functions information header file name property ae 2 71 Output variables functions information header file Property vest e eisai a a header flan fare ea z v h The settings of the output folder and file of the variables functions information header file are can be changed lt 1 gt Set the output folder Setting the output folder is made with the Output folder for variables functions information header file prop erty by directly entering to the text box or by the button Up to 247 characters can be specified in the text box This property supports the following placeholders 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 Te
114. b project 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 The assembly source file is saved under the C source file name with the extension replaced by asm If this is blank it is assumed that the project folder has been specified This corresponds to the asm_path option of the ccrl command This property is displayed only when Yes asm_path in the Output assembly source file property is selected Default BuildModeName How to Directly enter in the text box or edit by the Browse For Folder dialog change box which appears when clicking the button Restriction Up to 247 characters Output preprocessed Select whether to output the execution result of preprocessing for the source file to a source file file This corresponds to the P option of the ccrl command Default No How to Select from the drop down list change Restriction Yes P Outputs the execution result of preprocessing for the source file to a file No Does not output the execution result of preprocess ing for the source file to a file Output folder for pre Specify the folder which the preprocessed source file is output processed source file The file is output under the source file name with the extension replaced by i
115. bed 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 assemble processing The placeholders can be described in the script The specified command is displayed as the subproperty Default Configuration of the assemble option How to Edit by the Text Edit dialog box which appears when clicking the change button For the subproperty you can enter directly in the text box Restriction Up to 1023 characters Up to 64 items can be specified R20UT3284EJ0101 Rev 1 01 ztENESAS Page 186 of 204 Aug 01 2015 CS A WINDOW REFERENCE Commands executed Specify the command to be executed after assemble processing after assemble Use the call instruction to specify a batch file example call a bat processing The following placeholders are supported ActiveProjectDir Replaces with the absolute path of the active project folder ActiveProjectName Replaces with the active project name AssembledFile Replaces with the absolute path of the output file under assembling BuildModeName Replaces with the build mode name nputFile Replaces with the absolute path of the file to be assembled 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 Repl
116. brary Options tab I O header file generation tool I O Header File Generation Options tab 2 10 2 Set build options at the file level You can individually set compile and assemble options for each source file added to the project 1 When setting compile options for a C source file Select the C source file on the project tree and select the Build Settings tab on the Property panel Select Yes in the Set individual compile option property in the Build category The Message Dialog Box will open Figure 2 65 Set individual compile option Property File trope source ile Figure 2 66 Message Dialog Box AG yu Sunn you wand bo aii The cum conpde opla io Ihe individual conde opera fer all Build meha F Ho e selected copy the current buli mode options oriy el Click Yes in the dialog box The Individual Compile Options tab will be displayed R20UT3284EJ0101 Rev 1 01 ztENESAS Page 43 of 204 Aug 01 2015 CS 2 FUNCTIONS Figure 2 67 Property Panel Individual Compile Options Tab Property _ amp j main c Property a a l d Debug Information Add debug information Yasla Enhance debug information with optimization Yeel q_ine Optimization Level of optimization the defauk optimization Mone Optimizaton Detals Maximum number of boop sapansions Remove unused static functions Yee To adjust the level of optimization Mone Perform inline expansion Yee To adus the level of optimization Mone Use br i
117. broutine for the same instruction sequence No Does not create a subroutine for the same instruction sequence Outputs additional Select whether to output additional information for inter module optimization information for inter At linkage inter module optimization is applied to files for which this option has been module optimization specified This corresponds to the goptimize option of the ccrl command Default No How to Select from the drop down list change Restriction Yes gopti Outputs additional information for inter module opti mize mization No Does not outputs additional information for inter mod ule optimization 4 Preprocess The detailed information on preprocessing is displayed and the configuration can be changed R20UT3284EJ0101 Rev 1 01 ztENESAS Page 80 of 204 Aug 01 2015 CS A WINDOW REFERENCE Additional include Specify the additional include paths during compiling paths 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
118. bsolute 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 compile processing The placeholders can be described in the script The specified command is displayed as the subproperty Default Commands executed before compile processing number of defined items How to Edit by the Text Edit dialog box which appears when clicking the change button For the subproperty you can enter directly in the text box Restriction Up to 1023 characters Up to 64 items can be specified R20UT3284EJ0101 Rev 1 01 ztENESAS Page 96 of 204 Aug 01 2015 CS A WINDOW REFERENCE Commands executed Specify the command to be executed after compile processing after compile process Use the call instruction to specify a batch file example call a bat ing 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 CompiledFile Replaces with the absolute path of the output file under compil ing nputFile Replaces with the
119. 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 This property is displayed only when Yes in the Output hex file property is selected Default BuildModeName How to Directly enter in the text box or edit by the Browse For Folder dialog change box which appears when clicking the button Restriction Up to 247 characters Output file name Specify the hex file name If the extension is omitted it is automatically added according to the selection in the Hex file format property When Intel HEX file FOrm Hexadecimal is selected hex When Motorola S record file FOrm Stype is selected mot When Binary file FOrm Binary is selected bin The following placeholders are supported ActiveProjectName Replaces with the active project name MainProjectName Replaces with the main project name ProjectName Replaces with the project name
120. buld eecoessful i oma Sg Bett ghar Cha reser of arroi accel the Bril Linper ieee M k ter a User Inferreson Sip baij when the dependent prosscts hee bald emors Timing of uscating dependencies St dha frat build Esable pi abal ferid arrora pros imap Zanga hisia A Settings ox Canc os ee In addition select Yes in the Build in parallel property in the Common Options tab on the Property panel Remark When there are dependencies between projects set the dependencies between the projects cor rectly before using the parallel build facility If a parallel build is performed for the main project and subprojects without the dependencies being set build is performed in parallel regardless of the build order of the projects For details on setting the dependencies between projects see CS Integrated Development Envi ronment User s Manual Project Operation R20UT3284EJ0101 Rev 1 01 RENESAS Page 13 of 204 Aug 01 2015 CS 2 FUNCTIONS 2 4 Set the Type of the Output File Set the type of the file to be output as the product of the build Select the build tool node on the project tree and select the Common Options tab on the Property panel Select the file type in the Output file type property in the Output File Type and Path category Qutput file type Wiuipal cross reherence infenmstian Ma Inbermediate file output folder ZBuldhlodetame i 1 When Execute Module Load Module File is selected Default
121. ces 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 compile processing The placeholders can be described in the script The specified command is displayed as the subproperty Default Configuration of the compile option How to Edit by the Text Edit dialog box which appears when clicking the change button For the subproperty you can enter directly in the text box Restriction Up to 1023 characters Up to 64 items can be specified R20UT3284EJ0101 Rev 1 01 ztENESAS Page 177 of 204 Aug 01 2015 CS A WINDOW REFERENCE Commands executed Specify the command to be executed after compile processing after compile process Use the call instruction to specify a batch file example call a bat ing The following placeholders are supported ActiveProjectDir Replaces with the absolute path of the active project folder ActiveProjectName Replaces with the active project na
122. cified it is converted into an absolute path using the main proj ect or subproject folder as the reference point of the path 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 Changes not allowed change Use standard mathe Select whether to use the standard mathematical libraries provided by the compiler matical libraries This corresponds to the LIBrary option of the rlink command Default No How to Select from the drop down list change Restriction Yes Uses the standard mathematical libraries No Does not use the standard mathematical libraries 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 Yes How to Select from the drop down list change Restriction Yes Uses the runtime libraries No Does not use the runtime libraries R20UT3284EJ0101 Rev 1 01 ztENESAS Page 111 of 204 Aug 01 2015 CS A WINDOW REFERENCE 6 Device The detailed information on the device is displayed and the configuration can be changed Set enable disable on chip debug by link option Select whether to set enabling disabling the on chip debug by the link option This corresponds to the OCDBG option of the rlink command
123. ction Yes g_line Enhances debug information at optimization No Does not enhance debug information at optimization 2 Optimization The detailed information on the optimization is displayed and the configuration can be changed Level of optimization Select the level of the optimization for compiling This corresponds to the O option of the ccrl command Default Configuration of the compile option How to Select from the drop down list change Restriction Perform the default Performs optimization that debugging is not optimization None affected optimization of expressions and reg ister allocation and the like Code size prece Performs optimization with the object size pre dence Osize cedence Regards reducing the ROM RAM usage as important and performs the maximum optimi zation that is effective for general programs Speed precedence Performs optimization with the execution Ospeed speed precedence Regards shortening the execution speed as important and performs the maximum optimi zation that is effective for general programs Debug precedence Performs optimization with the debug prece Onothing dence Regards debugging as important and sup presses all optimization including default opti mization 3 Optimization Details The detailed information on the optimization is displayed and the configuration can be changed R20UT3284EJ0101 Rev 1 01 ztE
124. ction name when adding modifying or overlaying a section respectively Figure A 18 Add Section Dialog Box 1 Function buttons 1 4 Function buttons 1 Function buttons The following items are explained here How to open Description of each area Function buttons How to open Add Section dialog box On the Section Settings dialog box select a section in the address section area and then click the Add but ton Modify Section dialog box On the Section Settings dialog box select a section in the address section area and then click the Modify button Add Overlay dialog box On the Section Settings dialog box click the New Overlay button R20UT3284EJ0101 Rev 1 01 ztENESAS Page 195 of 204 Aug 01 2015 CS A WINDOW REFERENCE Description of each area 1 Section name Specify the section name Directly enter the section name in the text box or select from the drop down list The following characters can be used only A Z a z 0 9 _ dot Wildcard characters can also be used Note that numeric characters 0 to 9 and dot cannot be used at the beginning of a section name The following reserved sections are set in the drop down list bss const data text Function buttons Button Function Add Section dialog box Closes this dialog box and adds the specified section to the a
125. ctive 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 Out put file format property in the Output File category Default Binary file number of defined items How to Edit by the Text Edit dialog box which appears when clicking the change 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 Select from the drop do
126. d sequence This property is displayed 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 02 00 or higher or when V1 02 00 or higher is selected in the Using compiler package version property When Perform the default optimization None Code size precedence Osize or Speed precedence Ospeed in the Level of optimization property is selected Default Configuration of the compile option How to Select from the drop down list change Restriction Yes Osame_code Creates a subroutine for the same instruction sequence No Does not create a subroutine for the same instruction sequence Outputs additional Select whether to output additional information for inter module optimization information for inter At linkage inter module optimization is applied to files for which this option has been module optimization specified This corresponds to the goptimize option of the ccrl command Default Configuration of the compile option How to Select from the drop down list change Restriction Yes goptimize Outputs additional information for inter module optimization No Does not outputs additional information for inter module optimization 4 Preprocess The detailed information on preprocessing is disp
127. d Development Environ ment User s Manual Project Operation First from the Project menu select Create New Project the Create Project dialog box will open Figure 2 1 Create Project Dialog Box Microcontroller Using microconbraller fy Search microcontroller Update RLT78 G13 ROM 128KB Product Name ASF100EH E W RL78G13 ROM 1S2K5 _ intemal ROM aize KEytes 1932 0 ECET T liae E nE J A5FI0EHi Apin J A5F100FHiddpin J RSF 101 FH 44pin J ASF 100GH Boin WE RSFIMGH Spin Empty Applicaton OCC AL sample_OC RL Cclworkigample Make the project folder Clowork sample sample_CC RLisample_CC AL mipj Propect bo be passed Copy composition files in the diverted project falder to a new project folder R20UT3284EJ0101 Rev 1 01 ztENESAS Page 9 of 204 Aug 01 2015 CS 2 FUNCTIONS 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 th
128. ddress section area in the Section Settings dialog box When there is no empty column in the section group an address and the sections allocated to the address where the specified section is to be included a new sec tion row is added to the bottom of the section group When there is an empty col umn the section is added there Modify Section dialog box Closes this dialog box and replaces the section name selected in the address section area in the Section Settings dialog box with the one specified Add Overlay dialog box Closes this dialog box and adds the Overlayn column n number starting with 1 to the address section area in the Section Settings dialog box Sets the specified section in the column that corresponds to the selected section group Cancel Cancels the settings and closes this dialog box Help Displays the help of this dialog box R20UT3284EJ0101 Rev 1 01 Aug 01 2015 RENESAS Page 196 of 204 CS A WINDOW REFERENCE Section Address dialog box This dialog box is used to set an address when adding or modifying a section Figure A 21 Section Address Dialog Box 0 Function buttons The following items are explained here How to open Description of each area Function buttons How to open On the Section Settings dialog box select an address in the address section area and then click the Add or Mod ify button Descriptio
129. definition 0 Macro undefinition Macro undefinition 0 Quality Improvement Detect stack overflow Nol Nene Memory Model Clason MISRA C Rule Check Add debug information Species whether fo generale the debug information Such information is generated when debugging a program just like the case of washing io perform source debugging with debugger This option conesponds to L Remark Often used options have been gathered under the Frequently Used Options for Compile category on the Common Options tab 2 5 1 Perform optimization with the code size precedence Select the build tool node on the project tree and select the Compile Options tab on the Property panel To perform optimization with the code size precedence select Code size precedence Osize in the Optimization Level property in the Optimization category R20UT3284EJ0101 Rev 1 01 ztENESAS Page 19 of 204 Aug 01 2015 CS 2 FUNCTIONS Figure 2 19 Level of optimization Property Code Size Precedence Remark You can also set the option in the same way with the Optimization Level property in the Frequently Used Options for Compile category on the Common Options tab 2 5 2 Perform optimization with the execution speed precedence Select the build tool node on the project tree and select the Compile Options tab on the Property panel To perform optimization with the execution speed precedence select Speed precedence Ospeed in the Optimizatio
130. displayed and the configuration can be changed Format of numerical constant R20UT3284EJ0101 Rev 1 01 Aug 01 2015 Specify the representation format of the base number of numerical constants Example Prefix format OxFFFF Suffix format FFFFH This corresponds to the asmopt base_number option of the ccrl command Default Configuration of the assemble option How to change Select from the drop down list Restriction Handles numerical constants in the Prefix format Prefix format None ztENESAS Handles numerical constants in the Suffix format Suffix format asmopt base_number suffix Page 182 of 204 CS Character encoding 5 Output File A WINDOW REFERENCE Select the character code to be used for Japanese comments and character strings in the source file This corresponds to the character_set option of the ccrl command Default Configuration of the assemble option How to change Select from the drop down list Restriction Auto None Interprets the Japanese character code in the source file as SUIS on Japanese OS On other than Japanese OS does not interpret the character code in the source file SJIS character_set sjis Interprets the Japanese character code in the source file as SJIS EUC character_set euc_jp Interprets the Japanese character code in the source file as EUC UTF 8 character_set utf8
131. dit by the Browse For Folder dialog change Box which appears when clicking the button Restriction Up to 247 characters 11 MISRA C Rule Check The detailed information on the MISRA C rule check are displayed and the configuration can be changed 20XxX in the following table corresponds to 2012 or 2004 in particular MISRA C specification Select the MISRA C specification This property is usable only in the Professional Edition This property is displayed 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 02 00 or higher or when V1 02 00 or higher is selected in the Using compiler package version property Default Configuration of the compile option How to Select from the drop down list change Restriction MISRA C 2012 Settings for MISRA C 2012 are made in the subsequent properties MISRA C 2004 Settings for MISRA C 2004 are made in the subsequent properties R20UT3284EJ0101 Rev 1 01 ztENESAS Page 171 of 204 Aug 01 2015 CS A WINDOW REFERENCE Apply rule Select the MISRA C rules to be applied This property is usable only in the Professional Edition This corresponds to the misra20XX option of the ccrl command Default Configuration of the compile option How to Select from the drop down list change Rest
132. dividual assemble option property in the Build category The Message Dialog Box will open R20UT3284EJ0101 Rev 1 01 ztENESAS Page 44 of 204 Aug 01 2015 CS 2 FUNCTIONS Figure 2 68 Set individual assemble option Property File type Figure 2 69 Message Dialog Box e ANG yOu SUS you ban bo oat The cumi aenooie optan bo ihe inciidual maembe options for all buld modes F Ho e selected copy the current build mode options oriy te te Gort Le Click Yes in the dialog box The Individual Assemble Options tab will be displayed Figure 2 70 Property Panel Individual Assemble Options Tab Outputs additional information for inter module optimization Preprocess b Additional include paths Use whole include paths specified for build tool gt Macro definition Macro undefinition gt Aseemble List You can set assemble options for the assembly source file by setting the necessary properties in this tab Note that this tab takes over the settings of the Common Options tab and Compile Options tab Assemble Options tab by default except the properties shown below Additional include paths and Use whole include paths specified for build tool in the Preprocess category Object module file name in the Output File category R20UT3284EJ0101 Rev 1 01 ztENESAS Page 45 of 204 Aug 01 2015 CS 2 FUNCTIONS 2 11 Efficiently Allocate Variables and Functions Generate a
133. dress in hexadecimal without Ox The range of specifiable address values is 0 to FFFFF This corresponds to the CRc option of the rlink command This property is displayed only when Yes CRc in the Outputs the calculation result of CRC property is selected Default Blank 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 ztENESAS Up to 32767 characters Up to 65535 items can be specified Page 135 of 204 CS A WINDOW REFERENCE Type of CRC Select the method of CRC operation See CC RL Compiler User s Manual for details about each operation CRC CCITT MSB LITTLE 4 bytes type corresponds to CRC CCITT MSB type in CS V3 01 00 This corresponds to the CRc option of the rlink command See Remark for the correspondence with the Type of CRC property of CA78KOR This property is displayed only when Yes CRc in the Outputs the calculation result of CRC property is selected Default CRC CCITT MSB LITTLE 4 bytes type How to change Select from the drop down list Restriction CCITT type Outputs the calculation result of CRC 16 CCITT MSB first operation with an initial value of Oxffff and inverse of XOR CRC CCITT MSB type Outputs the calculation result of CRC 16 CCITT MSB first operation CRC CCITT MSB LIT TLE 4 bytes type Out
134. e library project Output hex file Select whether to output the hex file This corresponds to the FOrm option of the rlink command Default Yes How to Select from the drop down list change Restriction Yes Outputs the hex file Default No Does not output the hex file Hex file format Select the format of the hex file to be output This corresponds to the FOrm option of the rlink command This property is displayed only when Yes in the Output hex file property is selected Default Motorola S record file FOrm Stype How to Select from the drop down list change Restriction Intel HEX file FOrm Hexa Outputs an Intel HEX file decimal Motorola S record file Outputs a Motorola S record file FOrm Stype Binary file FOrm Binary Outputs a binary file R20UT3284EJ0101 Rev 1 01 ztENESAS Page 64 of 204 Aug 01 2015 CS A WINDOW REFERENCE Output folder Specify the folder which the hex file is output If a relative path is specified the reference point of the path is the main project or sub project 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 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
135. e name MicomToolPath Replaces with the absolute path of the install folder of this product ProjectName Replaces with the project name This corresponds to the ignore_files_misra option of the ccrl command This property is displayed only in the following cases When Apply all rules is selected in the Apply rule property When Apply rules that are classified as required is selected in the Apply rule property When Apply specified rule number is selected in the Apply rule property and a rule number is specified in the Rule number property When Ignore specified rule number is selected in the Apply rule property and a rule number is specified in the Rule number property When Apply rules that are classified as required and specified rule number is selected in the Apply rule property and a rule number is specified in the Check rule number besides required rule property When Ignore specified rule number from rules that are classified as required is selected in the Apply rule property and a rule number is specified in the Exclusion rule number from required rule property When Apply rules that are described in the specified file is selected in the Apply rule property and a rule number description file is specified in the Rule number description file property Default Rule check exclusion file number of defined items How to Edit by the Path Edit dialog box which appears when clickin
136. e number CHange_message nformation lt Message numbers gt in the Change warning mes sage to information message property is selected Default Blank How to change Directly enter in the text box or edit by the Character String Input dia log 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 This property is displayed only when No in the Use same message related settings as Link Options tab property is selected Default No How to change Select from the drop down list Restriction Yes All CHange_message Warning Changes the type of all informa tion messages to warning Yes Specify message number CHange_message Warn ing lt Message number gt Specifies the number of informa tion message of which type is to be changed to warning No Does not change the type of infor mation messages Number of information message R20UT3284EJ0101 Rev 1 01 Aug 01 2015 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 exam ple 4 200 203 1300 This corresponds to the CHange_mes
137. e paths Change the specified order of the include paths which the system set during compil ing 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 system include path is searched with lower priority than the additional include path The reference point of the path is the project folder This corresponds to the I option of the ccrl command The include path is displayed as the subproperty Default System include paths number of defined items How to Edit by the System Include Path Order dialog box which appears change when clicking the button Restriction Changes not allowed Only the specified order of the include paths can be changed R20UT3284EJ0101 Rev 1 01 ztENESAS Page 60 of 204 Aug 01 2015 CS A WINDOW REFERENCE Macro definition Specify
138. e 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 determina tion fails and a build error is occurred 5 Specify the reuse of a CA78KOR 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 Remark The result that a CC RL project is created by reusing a CA78KOR 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 nis 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 lt CS IDE Integrated Development Environment Framework version gt CS
139. e rlink command Default No How to Select from the drop down list change Restriction Yes STACk Outputs the stack information file No Does not output the stack information file Reduce memory occu Select whether to reduce the memory usage of the linker pancy of linker This corresponds to the MEMory option of the rlink command This property is displayed only in the following cases When No NODEBug in the Output debug information property or No NOCOmpress in the Compress debug information property in the Debug Infor mation category is selected When any one of the conditions below is met When No in the Output link map file property in the List category is selected When Yes List contents not specify LISt SHow in the Output link map file property in the List category is selected When Yes List contents specify LISt in the Output link map file property No in the Output number of symbol reference property and No in the Output cross reference information property in the List category are selected When No in the Output stack information file property is selected Default No MEMory High How to Select from the drop down list change Restriction Yes MEMory Low Reduces the memory usage of the linker Select this item if processing is slow because a large project is linked and the memory size occupied by the linker exceeds the a
140. ecification that violates the standard This correspon ds to the ansi option of the ccrl command Default No How to change Select from the drop down list Restriction Yes ansi Processes as making C source program comply strictly with the ANSI standard and outputs an error or warning for a specification that violates the stan dard Compatibility with the conventional C language spec ifications is conferred and processing continues after warning is output Check function with out prototype declara tion Select whether to generate an error when using a function whose prototype declara tion was not made in advance or a function without a prototype declaration This correspon ds to the refs_without_declaration option of the ccrl command Default No How to change Select from the drop down list Restriction Yes Checks functions without prototype dec refs_without_declaration larations No Does not check functions without proto type declarations Set Oxffff bytes to max imum variable size Select whether to increase the maximum variable size from Ox7fff to Oxffff This correspon ds to the large_variable option of the ccrl command Default No How to change Select from the drop down list Restriction Yes large_variable Increases the maximum variable size No Does not increase the maximum variable size
141. ecified 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 RENESAS Page 150 of 204 CS A WINDOW REFERENCE Commands executed Specify the command to be executed after library generation processing after create library pro Use the call instruction to specify a batch file example call a bat cessing 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
142. ect from the drop down list Restriction Yes All CHange_message Warning Changes the type of all informa tion messages to warning Yes Specify message number CHange_message Warn ing lt Message number gt Specifies the number of informa tion message of which type is to be changed to warning No Does not change the type of infor mation 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 exam ple 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 nformation lt Message numbers gt in the Change warning mes sage to information message property is selected Default Blank How to change Directly enter in the text box or edit by the Character String Input dia log 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_
143. eed pa peda Dod gee d de Re 17 2 5 Set Compils Options nareset ere peu ees Atos ea Oe eee ede ee ae ae eee ae eS 19 2 5 1 Perform optimization with the code size precedence 0 eee ett eee 19 2 5 2 Perform optimization with the execution speed precedence 0 cece eet eee 20 2 5 3 Addani include path rer n25 6 nai e aE A Less i E E A DE eee VS oa ALS 20 2 5 4 Setamacro definition ssi reis aani aE fe hau A A ld aae eater gaat aed enero wr bed te Sedat g AE aal 22 2 6 Set Assemble Options c e205 6 tee ela nels ce ak Pd ve eva Sek dae eet at E 23 2 6 1 Add aniinclude path edit ee ee Ae ek eee ee eR BA eh ee SE 23 2 6 2 Seta macro definition wc eta eE pE eg el ee ce ee Ye ee ee eda 25 2 7 Set Link OptionS s n yie ore dete aot tae Mid Gide Se Va eee ree GE BR EEA ENE 26 2 7 1 Addauser library sane cae ac eae i au ea ai dal fe Manse econ cewek SA elias ace pa a 27 2 7 2 Prepare for using the overlaid section selection function 0 0 0 cece eee 28 2 8 Set Hex Output Options eine g eta ek de Fe ee ae ke ee Sale Sad eae hy ee 37 2 8 1 Set the output of a hex file 2 tenets 37 2 8 2 Fill the vacantiarea ed cicada eee Ete wider ee Sa i ee le SS es 38 2 9 Set Create LibraryOptionS ices ca sy etet paa a Rahs wie Desa haan et ee eke ea kei iais 41 2 9 1 Set the output of a library file 0 teen tte 41 2 10 Set Build Options Separately rn ici 6 tiae a a E a ew Yeats bead ae 43 2 10 1 Set build options at the project
144. eely specified The following placeholders are supported ActiveProjectName Replaces with the active project name MainProjectName Replaces with the main project name ProjectName Replaces with the project name If this is blank it is assumed that ProjectName err has been specified This corresponds to the error_file option of the ccrl command This property is displayed only when Yes error_file in the Output error message file property is selected Default ProjectName err How to Directly enter in the text box change Restriction Up to 259 characters 10 Warning Message The detailed information on warning messages is displayed and the configuration can be changed R20UT3284EJ0101 Rev 1 01 ztENESAS Page 68 of 204 Aug 01 2015 CS A WINDOW REFERENCE Undisplayed warning Specify the number of the warning message not to be displayed message If multiple message numbers are specified delimit them with comma example 20009 20011 Also the range can be set using hyphen example 20000 20100 20300 20500 This corresponds to the no_warning option of the ccrl command Default Blank How to Directly enter in the text box or edit by the Character String Input dia change log box which appears when clicking the button Restriction Up to 2048 characters 11 Device The detailed information on device is displayed and the configuration can be changed
145. elect whether to output the error message file file This corresponds to the error_file option of the ccrl command Error messages are displayed on the Output panel regardless of this property s This property is displayed only when No in the Build in parallel property is selected Default No How to Select from the drop down list change Restriction Yes error_file Outputs the error message file No Does not output the error message file Error message file out Specify the folder which the error message file is output put folder If a relative path is specified the reference point of the path is the main project or sub project 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 If this is blank it is assumed that the project folder has been specified This corresponds to the error_file option of the ccrl command This property is displayed only when Yes error_file in the Output error message file property is selected Default BuildModeName How to Directly enter in the text box or edit by the Browse For Folder dialog change box which appears when clicking the button Restriction Up to 247 characters Error message file Specify the error message file name name The extension can be fr
146. en there is no empty column in the section group an address and the sec tions allocated to the address where the specified section is to be included a new section row is added to the bottom of the section group When there is an empty column the section is added there When selecting an address in this area Opens the Section Address dialog box Moves the section group according to the address specified in the dialog box so that the addresses are listed in the ascending order in this area When selecting a section in this area Opens the Modify Section dialog box Replaces the section name selected in this area with the one specified in the dia log box Note that this button is disabled when the selected sell is blank New Overlay Opens the Add Overlay dialog box Adds the Overlayn column in this area and sets the section specified in the dialog box in the column that corresponds to the selected section group When selecting an address in this area Opens the Unassigned Section dialog box Deletes the section selected in the dialog box from this area If no sections are left in the section group the section group itself is deleted When selecting a section in this area Deletes the selected section from this area If no sections are left in the section group the section group itself is deleted If no section names are left in the Overlayn column the column itself is deleted Note that this button is disabled
147. eplaces 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 This property is displayed only when Yes in the Output hex file property is selected Default ProjectName mot How to Directly enter in the text box change Restriction Up to 259 characters R20UT3284EJ0101 Rev 1 01 ztENESAS Page 131 of 204 Aug 01 2015 CS A WINDOW REFERENCE Division output file Specify the division output files Specify in the format of file name start address end address start address end address The start address and end address of the output range or file name sec tion name section name The name of the output section with one entry per line If multiple section names are specified delimit them with a colon as in file name sec tion name section name example file1 mot sec1 sec2 Specify the address in hexadecimal without Ox example file2 mot 400 4ff If the extension is omitted it is automatically added according to the selection in the Hex file format property in the Hex Format category When Intel HEX file FOrm Hexadecimal is selected hex When Motorola S record file FOrm Stype is selected mot When Binary file FOrm Binary is selected bin The following placeholders are supported ActiveProjectDir Replaces with the absolute path of the active project
148. er file name property However if a file with the same name has already been registered this file is not registered The variables functions information header file of the project tree is not affected by the preinclude option of the Include files at head of compiling units property at build and the file specified by the Variables functions information header file name property will be specified This corresponds to the VFINFO option of the rlink command This property is displayed 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 01 00 or higher or when V1 01 00 or higher is selected in the Using compiler package version property Default No How to Select from the drop down list change Restriction Yes VFINFO Outputs the variables functions information header file No Does not output the variables functions informa tion header file R20UT3284EJ0101 Rev 1 01 ztENESAS Page 120 of 204 Aug 01 2015 CS A WINDOW REFERENCE Output folder for vari ables functions infor mation header file Specify the folder for saving the variables functions information header file If a relative path is specified the reference point of the path is the main project or sub project folder If an absolute path is specified the reference point of the path is
149. erty in the Version Select category from the Common Options tab is selected and the latest version is V1 02 00 or higher or when V1 02 00 or higher is selected in the Using compiler package version property When Custom in the Optimization type property is selected Default No How to change Select from the drop down list Restriction Yes OPti mize SYmbol_delete Deletes symbols that are not refer enced No Does not delete symbols that are not referenced Optimizes branch instruction size R20UT3284EJ0101 Rev 1 01 Aug 01 2015 Select whether to optimize the branch instruction size based on the program alloca tion information This corresponds to the OPtimize Branch option of the rlink command 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 the branch instruction size No ztENESAS Does not optimize the branch instruction size Page 107 of 204 CS A WINDOW REFERENCE Unreferenced symbol that disables deletion by optimization Specify unreferenced symbols that you do not wish to be deleted by optimization Specify in the format of symbo name with one specification on one line This option corresponds to the Symbol_ forbid option of the linker This property i
150. erty panel The include path setting is made with the Additional include paths property in the Preprocess category Figure 2 28 Additional include paths Property gt Mecro definition Mecro defintion gt Macro undefinitbon Mecro undefinitian D If you click the button the Path Edit dialog box will open R20UT3284EJ0101 Rev 1 01 ztENESAS Page 23 of 204 Aug 01 2015 CS 2 FUNCTIONS Figure 2 29 Path Edit Dialog Box Bath Edit PaiisiCiren path per cova linai Lad Amo z Proet Der F Permi preciaient path E Include subjolders automatical iy Flsceholder Placeholder Yske lsscration Deine ceci Diwork aarpls Abasia paih dea active E ActvePmecMeomMeme RSFICOLE Adiva prajadi micrncxirnily ActresProeciteme zampe Aree prec res BubdiMede Name Dem Guild Buld mode name Hanro Der Dwwork sane srs cbt a a oo caret tine Enter the include path per line in Path One path per one line You can specify up to 247 characters per line up to 256 lines Remark 1 This property supports placeholders If a line is double clicked in Placeholder the placeholder will be reflected in Path One path per one line Remark 2 You can also specify the include path by one of the following procedures Drag and drop the folder using such as Explorer Click the Browse button and then select the folder in the Browse For Folder dialog box Double click a row in Placeholder
151. es call instructions when the function ends with a function call Perform inter module optimization Specify the level of inter module optimization such as function merging Only Yes Level 1 Perform Xintermodule and No are displayed when No in the Build simultaneously property in the Build Method category from the Common Options tab is selected This corresponds to the Owhole_program Omerge_files and Ointermodule options of the ccrl command Default No How to Select from the drop down list change Restriction Yes Level 3 Perform Performs inter module optimization with assuming it the whole program Owhole_program assuming that the source files comprise the entire program However operation is not guaranteed if the preconditions are not met See CC RL Compiler User s Manual for details about the preconditions Yes Level 2 Perform with merging files Omerge_files Ointer module Merges two or more C source files and performs inter module optimization This item is displayed only when two or more source files are added to the proj ect Yes Level 1 Perform Ointermodule Performs inter module optimization for each file No Does not perform inter module optimiza tion R20UT3284EJ0101 Rev 1 01 Aug 01 2015 ztENESAS Page 79 of 204 CS A WINDOW REFERENCE Perform optimization Select whether to perform optimization with cons
152. esas Electronics products are not subject to radiation resistance design Please be sure to implement safety measures to guard them against the possibility of physical injury and injury or damage caused by fire in the event of the failure of a Renesas Electronics product such as safety design for hardware and software including but not limited to redundancy fire control and malfunction prevention appropriate treatment for aging degradation or any other appropriate measures Because the evaluation of microcomputer software alone is very difficult please evaluate the safety of the final products or systems manufactured by you Please contact a Renesas Electronics sales office for details as to environmental matters such as the environmental compatibility of each Renesas Electronics product Please use Renesas Electronics products in compliance with all applicable laws and regulations that regulate the inclusion or use of controlled substances including without limitation the EU RoHS Directive Renesas Electronics assumes no liability for damages or losses occurring as a result of your noncompliance with applicable laws and regulations Renesas Electronics products and technology may not be used for or incorporated into any products or systems whose manufacture use or sale is prohibited under any applicable domestic or foreign laws or regulations You should not use Renesas Electronics products or technology described in this document for any purpose re
153. esponds to the error_file option of the ccrl command This property is displayed only when Yes error_file in the Output error message file property is selected Default Configuration of the common option 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 Error message file name Specify the error message file name The extension can be freely specified The following placeholders are supported ActiveProjectName Replaces with the active project name MainProjectName Replaces with the main project name ProjectName Replaces with the project name If this is blank it is assumed that ProjectName err has been specified This corresponds to the error_file option of the ccrl command This property is displayed only when Yes error_file in the Output error message file property is selected 13 Warning Message Default Configuration of the common option How to change Directly enter in the text box Restriction Up to 259 characters The detailed information on warning messages is displayed and the configuration can be changed Undisplayed warning message 14 Others Specify the number of the warning message not to be displayed If multiple message numbers are specified delimit them with comma example 20009 20011 Also the r
154. estriction Yes Sets the option that differs from the project settings to the selected assembly source file No Does not set the option that differs from the project settings to the selected assembly source file File type The type of the selected file is displayed Default C source file when the C source file is selected Assembly source file when the assembly source file is selected Object file when the object file is selected Library file when the library file is selected Changes not allowed R20UT3284EJ0101 Rev 1 01 ztENESAS Page 156 of 204 Aug 01 2015 CS A WINDOW REFERENCE Individual Compile Options tab This tab shows the detailed information on a C source file categorized by the following and the configuration can be changed Note that this tab takes over the settings of the Common Options tab and Compile Options tab When the settings are changed from these tabs the properties are displayed in boldface Debug Information Optimization Optimization Details Preprocess Quality Improvement C Language Character Encoding Output Code Output File 0 Assemble List 1 MISRA C Rule Check 2 Error Output 3 Warning Message Remark This tab is displayed only when Yes in the Set individual compile option property in the Build category from the Build Settings tab is selected R20UT3284EJ0101 Rev 1 01 ztENESAS Page
155. ext box change Restriction 0 to FFFFFFFF hexadecimal number Specify byte count for Select whether to specify the maximum byte count for a data record data record This corresponds to the BYte_count option of the rlink command This property is displayed only when Intel HEX file FOrm Hexadecimal in the Hex file format property is selected Default No How to Select from the drop down list change Restriction Yes Specifies the maximum byte count for a data record BYte_count No Specifies OxFF as the maximum byte count for a data record Maximum byte count Specify the maximum byte count for a data record for data record This corresponds to the BYte_count option of the rlink command This property is displayed only when Yes BYte_count in the Specify byte count for data record property is selected Default FF How to Directly enter to the text box change Restriction 1 to FF hexadecimal number Output S9 record at Select whether to output the S9 record at the end the end This corresponds to the S9 option of the rlink command This property is displayed only when Motorola S record file FOrm Stype in the Hex file format property is selected Default No How to Select from the drop down list change Restriction Yes S9 Outputs the S9 record at the end No Does not output the S9 record at the end 3 CRC Operation T
156. f defined items How to Edit by the Text Edit dialog box which appears when clicking the change button For the subproperty you can enter directly in the text box Restriction Up to 32767 characters Up to 65535 items can be specified ROM to RAM mapped Specify the section that maps symbols from ROM to RAM section Specify in the format of ROM section name RAM section name with one section name per line This corresponds to the ROm option of the rlink command The section name is displayed as the subproperty Default ROM to RAM mapped section number of defined items data data R and sdata sdata R are specified in the subprop erty How to Edit by the Text Edit dialog box which appears when clicking the change button For the subproperty you can enter directly in the text box Restriction Up to 32767 characters Up to 65535 items can be specified R20UT3284EJ0101 Rev 1 01 ztENESAS Page 122 of 204 Aug 01 2015 CS A WINDOW REFERENCE 11 Verify The detailed information on verification is displayed and the configuration can be changed Check section larger Select whether to check the consistency of the address to which the section is allo than specified range of cated address This corresponds to the CPu option of the rlink command Default No How to Select from the drop down list change Restriction Yes CPu Checks the consistency of the add
157. f a relative path is specified it is converted into an absolute path using the main proj ect or subproject folder as the reference point of the path 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 Edit by the Path Edit dialog box which appears when clicking the change button gt 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 If a relative path is spe
158. 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 specified include path is searched with higher priority than the standard include file folder of CC RL The reference point of the path is the project folder When this property is omitted only the standard folder of CC RL is searched This corresponds to the I option of the ccrl command The specified include path is displayed as the subproperty When the include path is added to the project tree the path is added to the top of the subproperties Uppercase characters and lowercase characters are not distinguished for the include paths Default Additional include paths number of defined items How to Edit by the Path Edit dialog box which appears when clicking the change button For the subproperty you can enter directly in the text box Restriction Up to 259 characters Up to 256 items can be specified System includ
159. for Link The list of category names on the Compile Options tab is amended Figure A 3 Property Panel Compile Options Tab is replaced The following property is added to 1 Debug Information Enhance debug information with optimization The Restriction values of the Level of optimization property in 3 Frequently Used Options for Compile are amended Default Optimization None gt Perform the default optimization None Code Size Precedence Osize gt Code size precedence Osize Speed Precedence Ospeed gt Speed precedence Ospeed Debug Precedence Onothing gt Debug precedence Onothing The following property is added to 3 Optimization Details Create subroutine for same instruction sequence Description Summary The following category is added to the Compile Options tab 5 Quality Improvement The Restriction value of the Structure packing property in 9 Output Code is amended No None gt No The category name of 12 is amended as shown below MISRA C 2004 Rule Check gt MISRA C Rule Check A sentence at the beginning is amended The following property is added to 12 MISRA C Rule Check MISRA C specification The fact that properties are usable only in the Professional Edition is added to the description of all properties in 12 MISRA C Rule Check The following amendments are made in the description and
160. formation on frequently used options during compilation is displayed and the configuration can be changed Level of optimization Select the level of the optimization for compiling This corresponds to the O option of the ccrl command Default Perform the default optimization None How to Select from the drop down list change Restriction Perform the default Performs optimization that debugging is not optimization None affected optimization of expressions and reg ister allocation and the like Code size prece Performs optimization with the object size pre dence Osize cedence Regards reducing the ROM RAM usage as important and performs the maximum optimi zation that is effective for general programs Speed precedence Performs optimization with the execution Ospeed speed precedence Regards shortening the execution speed as important and performs the maximum optimi zation that is effective for general programs Debug precedence Performs optimization with the debug prece Onothing dence Regards debugging as important and sup presses all optimization including default opti mization R20UT3284EJ0101 Rev 1 01 Aug 01 2015 RENESAS Page 59 of 204 CS A WINDOW REFERENCE Additional include Specify the additional include paths during compiling paths The following placeholders are supported ActiveProjectDir Replaces with the absolute path of the active project
161. 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 R20UT3284EJ0101 Rev 1 01 Aug 01 2015 ztENESAS Page 149 of 204 CS Display total size of sections A WINDOW REFERENCE 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 Out put 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 infor mation 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 informa tion Commands executed before create library processing R20UT3284EJ0101 Rev 1 01 Aug 01 2015 Specify the co
162. from the information included herein Renesas Electronics does not assume any liability for infringement of patents copyrights or other intellectual property rights of third parties by or arising from the use of Renesas Electronics products or technical information described in this document No license express implied or otherwise is granted hereby under any patents copyrights or other intellectual property rights of Renesas Electronics or others You should not alter modify copy or otherwise misappropriate any Renesas Electronics product whether in whole or in part Renesas Electronics assumes no responsibility for any losses incurred by you or third parties arising from such alteration modification copy or otherwise misappropriation of Renesas Electronics product Renesas Electronics products are classified according to the following two quality grades Standard and High Quality The recommended applications for each Renesas Electronics product depends on the product s quality grade as indicated below Standard Computers office equipment communications equipment test and measurement equipment audio and visual equipment home electronic appliances machine tools personal electronic equipment and industrial robots etc High Quality Transportation equipment automobiles trains ships etc traffic control systems anti disaster systems anti crime systems and safety equipment etc Renesas Electronic
163. fy the output file name If the extension is omitted abs is automatically added The following placeholders are supported ActiveProjectName Replaces with the active project 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 abs How to change Directly enter in the text box Restriction 2tENESAS Up to 259 characters Page 63 of 204 CS A WINDOW REFERENCE Use standard mathe Select whether to use the standard mathematical libraries provided by the compiler matical libraries This corresponds to the LIBrary option of the rlink command Default Yes How to Select from the drop down list change Restriction Yes Uses the standard mathematical libraries No Does not use the standard mathematical libraries 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 Yes How to Select from the drop down list change Restriction Yes Uses the runtime libraries No Does not use the runtime libraries 7 Frequently Used Options for Hex Output The detailed information on frequently used options during hex outputting is displayed and the configuration can be changed This category is not displayed for th
164. g the change button gt Edit by the Add Excluding 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 R20UT3284EJ0101 Rev 1 01 ztENESAS Page 94 of 204 Aug 01 2015 CS A WINDOW REFERENCE Output message of the Select whether to output the message of the enhanced key word and extended speci enhanced key word fications and extended specifi This property is usable only in the Professional Edition cations This corresponds to the check_language_extention option of the ccrl command This property is displayed only in the following cases When Apply all rules is selected in the Apply rule property When Apply rules that are classified as required is selected in the Apply rule property When Apply specified rule number is selected in the Apply rule property and a rule number is specified in the Rule number property When Ignore specified rule number is selected in the Apply rule property and a rule number is specified in the Rule number property When Apply rules that are classified as required and specified rule number is selected in the Apply rule property and a rule number is specified in the Check rule number besides required rule property When Ignore specified rule number from rules that are classified as required is selected in the Apply rule proper
165. ge the type of warning messages ztENESAS Page 147 of 204 CS A WINDOW REFERENCE 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 exam ple 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 nformation lt Message numbers gt in the Change warning mes sage to information message property is selected Default Blank How to Directly enter in the text box or edit by the Character String Input dia change log 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 Select from the drop down list change Restriction Yes All Changes the type of all informa CHange_message Warning tion messages to warning Yes Specify message number CHange_message Warn ing lt Message number gt Specifies the number of informa tion message of which type is to be changed to warning No Does not change the type of infor mation messages Number
166. he Common Options tab is selected and the latest version is V1 02 00 or higher or when V1 02 00 or higher is selected in the Using compiler package version property Default No None How to Select from the drop down list change Restriction Yes Detects the stack overflow stack_protector Yes All Detects the stack overflow for all functions stack_protector_all No None Does not detect the stack overflow R20UT3284EJ0101 Rev 1 01 ztENESAS Page 83 of 204 Aug 01 2015 CS A WINDOW REFERENCE Value to be embed Specify the value to be embedded for detecting the stack overflow ded for detecting stack This property is usable only in the Professional Edition overflow This corresponds to the stack_protector and stack_protector_all options of the ccrl command This property is displayed 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 02 00 or higher or when V1 02 00 or higher is selected in the Using compiler package version property When other than No None in the Detect stack overflow property is selected Default Blank How to Directly enter in the text box change Restriction 0 to 65535 decimal number 6 Memory Model The detailed information on the memory model is disp
167. he Path Edit dialog box which appears when clicking the change button For the subproperty you can enter directly in the text box Restriction Up to 247 characters Up to 256 items can be specified Use whole include Select whether to compile using the include path specified in the Additional include paths specified for paths property in the Preprocess category from the Compile Options tab of the build tool build tool to be used The include paths are added by the following procedure Paths specified in the Additional include paths property from this tab Paths specified in the Additional include paths property from the Compile Options tab Paths displayed in the System include paths property from the Compile Options tab This corresponds to the I option of the ccrl command Default Yes How to Select from the drop down list change Restriction Yes Compiles using the include path specified in the property of the build tool to be used Does not use the include path specified in the prop erty of the build tool to be used R20UT3284EJ0101 Rev 1 01 7tENESAS Page 163 of 204 Aug 01 2015 CS Include files at head of compiling units A WINDOW REFERENCE Specify the file that is included at the top of the compilation unit The following placeholders are supported ActiveProjectDir Replaces with the absolute path of the active project folder ActiveProjectName
168. he detailed information on CRC operation is displayed and the configuration can be changed R20UT3284EJ0101 Rev 1 01 ztENESAS Page 134 of 204 Aug 01 2015 CS Outputs the calculation result of CRC A WINDOW REFERENCE Select whether to perform the CRC Cyclic Redundancy Check operation This corresponds to the CRc option of the rlink command Default No How to change Select from the drop down list Restriction Yes CRc The CRC operation is performed on the hex format objects in the specified range from low address to high address and the results of the operation are output to the specified address No The CRC operation and outputting the result are not performed Output address Specify the address that the result of the CRC operation is output in hexadecimal with out Ox example FFFOO Be sure to specify this property This corresponds to the CRc option of the rlink command This property is displayed only when Yes CRc in the Outputs the calculation result of CRC property is selected Default 0 How to change Directly enter in the text box Restriction 0 to FFFFF hexadecimal number Target range R20UT3284EJ0101 Rev 1 01 Aug 01 2015 Specify the CRC calculation range in the format of start address end address or section name However section name can be specified in only CC RL V1 02 00 or higher version Specify the ad
169. he end of a section This corresponds to the PADDING option of the rlink command Default No How to change Select from the drop down list Restriction Fills in data at the end of a section so that the section size is a multiple of the alignment of the section Yes PADDING No Does not fill with padding data at the end of a section Address setting for specified area of vec tor table Specify an address value to be set for a specific address in the vector table in the for mat of vector table address symbol address with one specification on one line Specify the vector table address as a hexadecimal value within the range between 0 and 7E Specify symbol using an external name of the target function Specify the address in hexadecimal without Ox This corresponds to the VECTN option of the rlink command Default Address setting for specified area of vector table 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 32767 characters Up to 65535 items can be specified Address setting for unused vector area Specify the address of the empty area in the vector table in the format of sym bolladdress Specify the address in hexadecimal without Ox This corresponds to the VECT option of the rlink command
170. hen clicking the button gt 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 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 R20UT3284EJ0101 Rev 1 01 Aug 01 2015 Speci
171. higher or when V1 02 00 or higher is selected in the Using compiler package version property Default MISRA C 2012 How to Select from the drop down list change Restriction MISRA C 2012 Settings for MISRA C 2012 are made in the subsequent properties MISRA C 2004 Settings for MISRA C 2004 are made in the subsequent properties R20UT3284EJ0101 Rev 1 01 ztENESAS Page 91 of 204 Aug 01 2015 CS A WINDOW REFERENCE Apply rule Select the MISRA C rules to be applied This property is usable only in the Professional Edition This corresponds to the misra20XX option of the ccrl command Default Not apply rule None How to Select from the drop down list change Restriction Apply all rules Checks the source code against all of misra20XX all the rules which are supported Apply specified rule num ber misra20XX apply Checks the source code against the rules with the specified numbers among the rules which are supported Ignore specified rule num ber misra20XX ignore Checks the source code against the rules that do not match the specified numbers among the rules which are supported Apply rules that are classi fied as required misra20XX required Checks the source code against the rules of the required type Apply rules that are classi fied as required and speci fied rule number misra20XX required_add Checks the source code ag
172. his property is displayed 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 02 00 or higher or when V1 02 00 or higher is selected in the Using compiler package version property Default Configuration of the compile option How to Select from the drop down list change Restriction Yes Detects the stack overflow stack_protector Yes All Detects the stack overflow for all functions stack_protector_all No None Does not detect the stack overflow R20UT3284EJ0101 Rev 1 01 ztENESAS Page 165 of 204 Aug 01 2015 CS Value to be embed ded for detecting stack overflow 6 C Language A WINDOW REFERENCE Specify the value to be embedded for detecting the stack overflow This property is usable only in the Professional Edition This corresponds to the stack_protector and stack_protector_all options of the ccrl command This property is displayed 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 02 00 or higher or when V1 02 00 or higher is selected in the Using compiler package version property When other than No None in the Detect stack overflow proper
173. ideration for the type of the data indi considering type of cated by the pointer based on the ANSI standard data indicated by This corresponds to the Oalias option of the ccrl command pointer Default No How to Select from the drop down list change Restriction Yes Performs optimization with consideration for the type Oalias ansi of the data indicated by the pointer In general this option improves the object perfor mance but the execution result may differ from the case when No is selected No Does not perform optimization with consideration for the type of the data indicated by the pointer Create subroutine for Select whether to create a subroutine for the same instruction sequence same instruction This corresponds to the Osame_code option of the ccrl command sequence This property is displayed 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 02 00 or higher or when V1 02 00 or higher is selected in the Using compiler package version property When Perform the default optimization None Code size precedence Osize or Speed precedence Ospeed in the Level of optimization property is selected Default No How to Select from the drop down list change Restriction Yes Osame_code Creates a su
174. ile is overwritten by running a build If the build completes successfully a load module file is generated with the variables and functions allocated Editing and using an auto generated variables functions information header file Users can edit a variables functions information header file Below is the procedure for editing the generated variables functions information header file in 1 Generating a variables functions information header file automatically and allocating variables and functions by the user and using that file to allocate variables and functions Edit the variables functions information header file Edit the variables functions information header file generated automatically in 1 Generating a variables func tions information header file automatically and allocating variables and functions Remark See CC RL Compiler User s Manual for details about the format of the auto generated vari ables functions information header file Set the generation of the variables functions information header file Select the build tool node on the project tree and select the Link Options tab on the Property panel Select No on the Output variables functions information header file property Figure 2 72 Output variables functions information header file Property Veriableafiuncsione a a file name Project Mamet wih Next select the Compile Options tab Specify the edited variables functions information header file on
175. in pro grams References a table indexed on the values in the case statements and selects and pro cesses case labels from the switch statement values The code will branch to all the case state ments with about the same speed However if case values are not used in suc cession an unnecessary area will be created Table jump rela tive switch rel_table ztENESAS Outputs the code in the table jump format rel ative branch for switch statements in pro grams References a table indexed on the values in the case statements and selects and pro cesses case labels from the switch statement values The code will branch to all the case state ments with about the same speed However if case values are not used in suc cession an unnecessary area will be created Page 168 of 204 CS A WINDOW REFERENCE Output comment to Select whether to output a C source program as a comment to the assembly source assembly source file file to be output This corresponds to the pass_ source option of the ccrl command This property is displayed only when Yes asm_path in the Output assembly source file property in the Output File category is selected or when Yes asmopt prn_path in the Output assemble list file property in the Assemble List category is selected Default Configuration of the compile option How to Select from the drop down list change Restriction Yes pass_ source Outpu
176. inDir 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 Edit by the Text Edit dialog box which appears when clicking the change button For the subproperty you can enter directly in the text box Restriction Up to 1023 characters Up to 64 items can be specified RENESAS Page 73 of 204 CS A WINDOW REFERENCE Other additional Input the option to be added additionally options The options set here are added at the end of the ccrl options group Default Blank How to Directly enter in the text box or edit by the Character String Input dia change log box which appears when clicking the button Restriction Up to 259 characters R20UT3284EJ0101 Rev 1 01 ztENESAS Page 74 of 204 Aug 01 2015 CS Compile Options tab A WINDOW REFERENCE This tab shows the detailed information on the compile phase categorized by the following and the configuration can be changed Debug Information Optimization Optimization Details Preprocess Quality Improvement Memor
177. ing property The following placeholders are supported Options Replaces with the command line option under build execution Program Replaces with the program name under execution TargetFiles Replaces with the file name being compile assemble or making link If this is blank Program Options will be set automatically Default TargetFiles How to Directly enter in the text box up to 256 characters or select from the change drop down list Restriction TargetFiles Displays the file name in the output mes sage TargetFiles Displays the file name and command line Options options in the output message Program Options Displays the program name and com mand line options in the output message Format of build option Specify the display format of the build option list 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 Options Replaces with the command line option under build execution Program Replaces with the program name under execution TargetFiles Replaces with the file name being compile assemble or making link If this is blank TargetFiles Program Options will be set automatically Default TargetFiles P
178. ion 0 to FF hexadecimal number without Ox Set debug monitor area Select whether to set the debug monitor area This corresponds to the DEBUG_MONITOR option of the rlink command This property is displayed 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 01 00 or higher or when V1 01 00 or higher is selected in the Using compiler package version property Default No How to Select from the drop down list change Restriction Yes Specifies the debug monitor area within the DEBUG_MONITOR default range Yes Specify address Specifies the address range of the debug range monitor area DEBUG_MONITOR lt Address range gt No Does not set the debug monitor area R20UT3284EJ0101 Rev 1 01 Aug 01 2015 ztENESAS Page 112 of 204 CS A WINDOW REFERENCE Range of debug moni Specify the range of the debug monitor area in the format of start address end tor area address This corresponds to the DEBUG_MONITOR option of the rlink command See CC RL Compiler User s Manual for details about the option 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
179. ion pena fe f apt Description of each category 1 Debug Information The detailed information on debug information is displayed and the configuration can be changed Add debug information Select whether to generate the debug information It is possible to perform source debugging with the debugger by outputting information for source debugging to the output file This corresponds to the g option of the ccrl command Default Configuration of the compile option How to Select from the drop down list change Restriction Yes g Generates the debug information No Does not generate the debug information R20UT3284EJ0101 Rev 1 01 2tENESAS Page 158 of 204 Aug 01 2015 CS A WINDOW REFERENCE Enhance debug infor Select whether to enhance debug information at optimization mation with optimiza This corresponds to the g_line option of the ccrl command tion This property is displayed 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 02 00 or higher or when V1 02 00 or higher is selected in the Using compiler package version property When Yes g in the Add debug information property is selected Default Configuration of the compile option How to Select from the drop down list change Restri
180. irectly in the text box of the subproperty Remark You can also set the option in the same way with the Using libraries property in the Frequently Used Options for Link category on the Common Options tab 2 Addition from the project tree Adding a library file to the project tree is performed from the Add Existing File dialog box Dropping a library file in the project tree is also possible When a library file is added from the project tree it is subject to timestamp comparison with the load module at build and the link processing is executed when the added library file is updated 2 7 2 Prepare for using the overlaid section selection function The optimizing linker rlink used by CC RL can allocate multiple sections defined in a program to the same address The sections allocated in this way are called overlaid sections The debug tool provides a function to select the debug target section from the overlaid sections priority sections allo cated to the same address The function is called overlaid section selection function A load module using overlaid sections can be debugged with switching of the priority section before program execution The method for generating a load module to use the overlaid section selection function is shown below 1 Copy the ROM area contents to RAM Copy the ROM area contents to the RAM area to expand the code and data in the RAM 2 Set build options Set the ROM to RAM mapped sections and o
181. isplay change area In this area the detailed information on the Build tool node or file that is selected on the Project Tree panel is dis played by every category in the list And the settings of the information can be changed directly Mark 4 indicates that all the items in the category are expanded Mark gt indicates that all the items are col lapsed You can expand collapse the items by clicking these marks or double clicking the category name Mark HEX indicates that only a hexadecimal number is allowed to input in the text box See the section on each tab for the details of the display setting in the category and its contents Tab selection area Categories for the display of the detailed information are changed by selecting a tab In this panel the following tabs are contained see the section on each tab for the details of the display setting on the tab Remark When multiple components are selected on the Project Tree panel only the tab that is common to all the components is displayed If the value of the property is modified that is taken effect to the selected components all of which are common to all When the Build tool node is selected on the Project Tree panel Common Options tab Compile Options tab Assemble Options tab Link Options tab Hex Output Options tab Create Library Options tab I O Header File Generation Options tab When a file is selected on the Project Tree panel Build
182. it by the System Include Path Order dialog box which appears change when clicking the button Restriction Changes not allowed Only the specified order of the include paths can be changed Macro definition Specify the name of the macro to be defined Specify in the format of macro name defined value with one macro name per line The defined value part can be omitted and in this case 1 is used as the defined value This corresponds to the asmopt define option of the ccrl command The specified macro is displayed as the subproperty Default Macro definition number of defined items How to Edit by the Text Edit dialog box which appears when clicking the change button For the subproperty you can enter directly in the text box Restriction Up to 256 characters Up to 256 items can be specified Macro undefinition Specify the macro name to be undefined Specify in the format of macro name with one macro name per line This corresponds to the asmopt undefine option of the ccrl command The specified macro is displayed as the subproperty Default Macro undefinition number of defined items How to Edit by the Text Edit dialog box which appears when clicking the change button For the subproperty you can enter directly in the text box Restriction Up to 256 characters Up to 256 items can be specified 4 Character Encoding The detailed information on char
183. ition Specify at least one rule number in decimal This corresponds to the misra20XX option of the ccrl command This property is displayed only when Ignore specified rule number from rules that are classified as required misra20XX required_remove in the Apply rule property is selected Default Configuration of the compile option How to Directly enter in the text box or edit by the Specify Rule Number dia change log box which appears when clicking the button Restriction Up to 259 characters R20UT3284EJ0101 Rev 1 01 ztENESAS Page 173 of 204 Aug 01 2015 CS A WINDOW REFERENCE Rule check exclusion Specify files that will not be checked against the MISRA C rules file This property is usable only in the Professional Edition The following placeholders are supported BuildModeName Replaces with the build mode name MicomToolPath Replaces with the absolute path of the install folder of this product ProjectName Replaces with the project name This corresponds to the ignore_files_misra option of the ccrl command This property is displayed only in the following cases When Apply all rules is selected in the Apply rule property When Apply rules that are classified as required is selected in the Apply rule property When Apply specified rule number is selected in the Apply rule property and a rule number is specified in the Rule number property When Ignore specified
184. l Property 4 Build Methool Remark Another facility to soeed up build is simultaneous build Simultaneous build is a facility to process the build command for multiple source files at once and specifying it simultaneously with parallel build has no effect due to its nature Generally the more CPU cores there are in the host machine in use or the more source files there are registered in a project parallel build is faster than simultaneous build However as there are properties that need to be used together with simultaneous build such as inter module optimization use the suitable facility for the situation See 2 3 1 Running simultaneous build for details about simultaneous build 2 Parallel build between projects When running parallel build between the main project and subprojects make the setting in Enable parallel build among projects of the General Build category of the Option dialog box Figure 2 4 Option Dialog Box General Build Category DD Generel R D Startup asd Exit Gerari Beale E Display z ia Era Teal Eaktor J Ehe Rapid Budd Deserve tegexteted Hi angr a Fort ancl Coir Ga Tarra Tools Fiad buid ia aehechied tha build ia airted wien the eied Jostoa file ia marvel Aa a al Frosi meak tha buld m mentad in parallel wih sttne Vitan rapid buli m alerted wa E meaane sawing amp Me with Cil S ater the Me eitis completed al Ei Comde Shoe depengency Hes in progenie FT Tezi Edie Deu geal reper fle whan
185. l Chi nese GBK character_set gbk Interprets the Chinese character code in the source file as Simplified Chinese No process Does not interpret the Japanese Chi character_set none nese character code in the source file 9 Output Code The detailed information on output codes is displayed and the configuration can be changed Process double type Select whether to handle the double or long double type as the float type long double type as This corresponds to the dbl_size option of the ccrl command float type Default Yes How to Select from the drop down list change Restriction Yes Processes the double or long double type as the float type No dbl_size 8 Does not process the double or long double type as the float type Sign of the char type Select sign of the char type with no sign specification This corresponds to the signed_char option of the ccrl command Default Handles as unsigned char None How to Select from the drop down list change Restriction Handles as signed Handles the char type as signed char char signed_char Handles as unsigned Handles the char type as unsigned char char None R20UT3284EJ0101 Rev 1 01 ztENESAS Page 86 of 204 Aug 01 2015 CS A WINDOW REFERENCE Sign of the bit field Select sign of the bit field type with no sign specification type This corresponds to the signed_bitfield option of the ccrl comm
186. lating to military applications or use by the military including but not limited to the development of weapons of mass destruction When exporting the Renesas Electronics products or technology described in this document you should comply with the applicable export control laws and regulations and follow the procedures required by such laws and regulations It is the responsibility of the buyer or distributor of Renesas Electronics products who distributes disposes of or otherwise places the product with a third party to notify such third party in advance of the contents and conditions set forth in this document Renesas Electronics assumes no responsibility for any losses incurred by you or third parties as a result of unauthorized use of Renesas Electronics products This document may not be reproduced or duplicated in any form in whole or in part without prior written consent of Renesas Electronics Please contact a Renesas Electronics sales office if you have any questions regarding the information contained in this document or Renesas Electronics products or if you have any other inquiries Note 1 Renesas Electronics as used in this document means Renesas Electronics Corporation and also includes its majority owned subsidiaries Note 2 Renesas Electronics product s means any product developed or manufactured by or for Renesas Electronics 2012 4 How to Use This Manual This manual describes the role of
187. layed and the configuration can be changed R20UT3284EJ0101 Rev 1 01 ztENESAS Page 162 of 204 Aug 01 2015 CS A WINDOW REFERENCE Additional include Specify the additional include paths during compiling paths 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 specified include path is searched with higher priority than the standard include file folder of CC RL The reference point of the path is the project folder When this property is omitted only the standard folder of CC RL is searched This corresponds to the I option of the ccrl command The specified include path is displayed as the subproperty Uppercase characters and lowercase characters are not distinguished for the include paths Default Additional include paths number of defined items How to Edit by t
188. layed and the configuration can be changed Memory model Specify the type of memory model This corresponds to the memory_model option of the ccrl command Default Auto None How to Select from the drop down list change Restriction Auto None Automatically interprets the value of the Specify CPU core property in the CPU category in the Common Options tab small when cpu S1 is selected medium when cpu S2 or cpu S3 is selected Small model Specifies the small model Code 64 K memory_model small bytes Data 64 K bytes as the memory model Medium model Specifies the medium model Code 1 M memory_model medium bytes Data 64 K bytes as the memory model Locate ROM data to Specify the allocation destination of ROM data far area This corresponds to the far_rom option of the ccrl command Default No How to Select from the drop down list change Restriction No Allocates ROM data depending on the value of the Memory Model property Yes Allocates ROM data to the far area far_rom 7 C Language The detailed information on C language is displayed and the configuration can be changed R20UT3284EJ0101 Rev 1 01 ztENESAS Page 84 of 204 Aug 01 2015 CS Compile strictly according to ANSI standards A WINDOW REFERENCE Select whether to process as making C source program comply strictly with the ANSI standard and output an error or warning for a sp
189. le R20UT3284EJ0101 Rev 1 01 ztENESAS Page 66 of 204 Aug 01 2015 CS A WINDOW REFERENCE 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 Hex file format property When User libraries FOrm Library U is selected lib When System libraries
190. le Hex file format Output folder Output file name bo Division output file b Error Output Warning Message b Device bo Build Method tf bo Hotes b Others Selects the build mode name to be used during build F ztENESAS DefaukBuikd No RLV8 53 core cpu S3 Ecte Module Load Module File Mo Build Mode Mame Perform the default optimization Mone Addtional ndude pathe D System include pathe D Macro dafiniion 0 Additional include paths 0 System include paths 0 Macro definition 0 Using libraneafD Build Mode Mame Project ames aba Yaa Yaa Yaa Motorla Second file FOm Stype 4 Build Mode Mame Project ame mot Divison output file 0 Link Options Hex Output OHeader Page 52 of 204 CS A WINDOW REFERENCE The following items are explained here How to open Description of each area Edit menu only available for the Property panel Context menu How to open On the Project Tree panel select the Build tool node or file and then select Property from the View menu or Prop erty from the context menu Remark When either one of the Build tool node or file on the Project Tree panel is selected while the Property panel has been opened the detailed information of the selected item is displayed Description of each area 1 2 a b R20UT3284EJ0101 Rev 1 01 ztENESAS Page 53 of 204 Detailed information d
191. le 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 Select from the drop down list change Restriction Execute Mod Generates a load module file during a build ule Load Module File The load module file will be the debug target Execute Module Hex Generates a hex file during a build File The hex file will be the debug target This item is displayed only when Yes in the Output hex file property in the Output File category from the Hex Output Options tab is selected Library Generates a library file during a build Output cross reference Select whether to output the cross reference information to a file information The file is output to the folder specified in the Output folder property in the Output File category from the Link Options tab The file is output under the file name specified in the Output file name property with the extension replaced by cref However if the Object file name property in the Output File category from the Indi vidual Compile Options tab is specified the file is output under the file name specified in the property with the extension replaced by cref This property is changed to Yes cref when Yes in the Compulsorily output cross reference file property of the analyze tool is selected If this pr
192. le list file is output under the source file name with the extension replaced by prn If a relative path is specified the reference point of the path is the main project or sub project 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 If this is blank it is assumed that the project folder has been specified This corresponds to the asmopt prn_path option of the ccrl command This property is displayed only when Yes asmopt prn_path in the Output assem ble list file property is selected Default BuildModeName How to Directly enter in the text box or edit by the Browse For Folder dialog change box which appears when clicking the button Restriction Up to 247 characters 12 MISRA C Rule Check The detailed information on the MISRA C rule check are displayed and the configuration can be changed 20XxX in the following table corresponds to 2012 or 2004 in particular MISRA C specification Select the MISRA C specification This property is usable only in the Professional Edition This property is displayed 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 02 00 or
193. list Restriction Yes All CHange_message lInformation Changes the type of all warning messages to information Yes Specify message number CHange_message Informa tion lt Message number gt 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 R20UT3284EJ0101 Rev 1 01 Aug 01 2015 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 exam ple 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 nformation lt Message numbers gt in the Change warning mes sage to information message property is selected Default Blank How to change Directly enter in the text box or edit by the Character String Input dia log box which appears when clicking the button Restriction Up to 2048 characters RENESAS Page 125 of 204 CS Change information message to warning message A WINDOW REFERENCE 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 Sel
194. ll be applied until the code size increases by 100 becomes twice the initial size This corresponds to the Oinline_size option of the ccrl command This property is displayed only when Yes Auto detect Oinline 2 in the Perform inline expansion property is selected or when Yes To adjust the level of optimiza tion in the Perform inline expansion property and Speed precedence Ospeed in the Optimization Level property are selected Default 100 How to change Directly enter in the text box Restriction ztENESAS 0 to 65535 decimal number Page 78 of 204 CS A WINDOW REFERENCE Use br instruction to call a function at the end of the function Select whether to give precedence to using br instructions in the place of call instruc tions when the function ends with a function call This corresponds to the Otail_call option of the ccrl command Default Yes To adjust the level of optimization None How to Select from the drop down list change Restriction Yes To adjust the level of Performs optimization according to the optimization None Level of optimization property Yes Otail_call Gives precedence to using br instructions in the place of call instructions when the function ends with a function call The code size can be reduced by remov ing the ret instruction However some debug functions cannot be used No Otail_call off Us
195. lled is selected in the Using compiler package version property is dis installed played 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 Latest version of the installed compiler packages How to Changes not allowed change 14 Notes The detailed information on notes is displayed and the configuration can be changed Add memos to the build tool Add one item in one line This setting is common to all the build modes The specified memo is displayed as the subproperty Default Memo number of items How to Edit by the Text Edit dialog box which appears when clicking the change button For the subproperty you can enter directly in the text box Restriction Up to 256 characters Up to 256 items can be specified 15 Others Other detailed information on the build tool is displayed and the configuration can be changed R20UT3284EJ0101 Rev 1 01 ztENESAS Page 71 of 204 Aug 01 2015 CS A WINDOW REFERENCE Output message for Specify the format of the message under build execution mat 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 process
196. lude path specified in the property of the build tool to be used R20UT3284EJ0101 Rev 1 01 ztENESAS Page 181 of 204 Aug 01 2015 CS A WINDOW REFERENCE Macro definition Specify the name of the macro to be defined Specify in the format of macro name defined value with one macro name per line The defined value part can be omitted and in this case 1 is used as the defined value This corresponds to the asmopt define option of the ccrl command The specified macro is displayed as the subproperty Default Configuration of the assemble option 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 256 characters Up to 256 items can be specified Macro undefinition 4 Character Encoding Specify the macro name to be undefined Specify in the format of macro name with one macro name per line This corresponds to the asmopt undefine option of the ccrl command The specified macro is displayed as the subproperty Default Configuration of the assemble option 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 256 characters Up to 256 items can be specified The detailed information on character encoding is
197. ly This corresponds to the AUTO_SECTION_LAYOUT option of the rlink command This property is displayed 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 01 00 or higher or when V1 01 00 or higher is selected in the Using compiler package version property Default No How to Select from the drop down list change Restriction Yes Allocates sections automatically AUTO_SECTION_LAYOUT Default No Does not allocate sections automati cally Section start address Specify the start address of the section This corresponds to the STARt option of the rlink command Default When Yes AUTO_SECTION_LAYOUT in the Layout sections automatically property is selected Blank Other than above The peculiar value for the target device How to Directly enter in the text box or edit by the Section Settings dialog box change which appears when clicking the button Restriction Up to 32767 characters Section that outputs Specify the section whose external defined symbols are output to a file external defined sym Specify one section name per line bols to the file This corresponds to the FSymbol option of the rlink command The section name is displayed as the subproperty Default Section that outputs external defined symbols to the file number o
198. ly set to all build modes when a value is set in this property 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 CPU is displayed and the configuration can be changed Specify CPU core The core of the device selected in the project is displayed This corresponds to the cpu option of the ccrl command Default Core of the device selected in the project How to Changes not allowed change Use arithmetic unit Specify whether to use the arithmetic unit This corresponds to the use_mda option of the ccrl command This property is displayed only when RL78 S2 core cpu S2 in the Specify CPU core property is selected Default Mul div accumulator None How to Select from the drop down list change Restriction Not use Generates a code that does not use the arith use_mda not_use metic unit Mul div accumula Generates a code that uses the arithmetic tor None unit 3 Output File Type and Path The detailed information on output file types and paths is displayed and the configuration can be changed R20UT3284EJ0101 Rev 1 01 ztENESAS Page 57 of 204 Aug 01 2015 CS A WINDOW REFERENCE Output file type The file type set here will be the debug target for other than the library project For other than library projects only Execute Module Load Module File and Execute Module Hex Fi
199. made with the Output file name property by directly entering to the text box 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 Up to 259 characters can be specified in the text box This property supports the following placeholders ActiveProjectName Replaces with the active project name MainProjectName Replaces with the main project name ProjectName Replaces with the project name ProjectName lib is set by default R20UT3284EJ0101 Rev 1 01 ztENESAS Page 42 of 204 Aug 01 2015 CS 2 FUNCTIONS 2 10 Set Build Options Separately Build options are set at the project or file level Project level See 2 10 1 Set build options at the project level File level See 2 10 2 Set build options at the file level 2 10 1 Set build options at the project level To set options for build options for the project main project or subproject select the Build tool node on the project tree to display the Property panel Select the phase tab and set build options by setting the necessary properties Compile phase Compile Options tab Assemble phase Assemble Options tab Link phase Link Options tab Hex output phase Hex Output Options tab Create library phase Create Li
200. me BuildModeName Replaces with the build mode name CompiledFile Replaces with the absolute path of the output file under compil ing nputFile Replaces with the absolute path of the file to be compiled 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 compile processing The placeholders can be described in the script The specified command is displayed as the subproperty Default Configuration of the compile option How to Edit by the Text Edit dialog box which appears when clicking the change button For the subproperty you can enter directly in the text box Restric
201. me 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 This property is displayed only when Yes in the Output hex file property is selected Default BuildModeName How to Directly enter in the text box or edit by the Browse For Folder dialog change box which appears when clicking the button Restriction Up to 247 characters Output file name Specify the hex file name Be sure to specify this property If the extension is omitted it is automatically added according to the selection in the Hex file format property in the Hex Format category When Intel HEX file FOrm Hexadecimal is selected hex When Motorola S record file FOrm Stype is selected mot When Binary file FOrm Binary is selected bin The following placeholders are supported ActiveProjectName Replaces with the active project name BuildModeName R
202. me 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 Edit by the Path Edit dialog box which appears when clicking the change button gt 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 Changes not allowed change Use standard mathe Select whether to use the standard mathematical libraries provided by the compiler matical libraries This corresponds to the LIBrary option of the rlink comma
203. message Error Changes the type of all informa tion and warning messages to error Yes Specify message number CHange_message Error lt Mes sage number gt Specifies the number of informa tion or warning message of which type is to be changed to error No Does not change the type of infor mation and warning messages R20UT3284EJ0101 Rev 1 01 ztENESAS Aug 01 2015 Page 126 of 204 CS A WINDOW REFERENCE Number of information Specify the number of the information and warning message 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 exam ple 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 lt Message numbers gt in the Change warning message to information message property is selected Default Blank How to Directly enter in the text box or edit by the Character String Input dia change log box which appears when clicking the button Restriction Up to 2048 characters 13 Others Other detailed information on linking is displayed and the configuration can be changed Output stack informa Select whether to output the stack information file tion file This corresponds to the STACk option of th
204. message file Specify the error message file name name The extension can be freely specified The following placeholders are supported ActiveProjectName Replaces with the active project name MainProjectName Replaces with the main project name ProjectName Replaces with the project name If this is blank it is assumed that ProjectName err has been specified This corresponds to the error_file option of the ccrl command This property is displayed only when Yes error_file in the Output error message file property is selected Default Configuration of the common option How to Directly enter in the text box change Restriction Up to 259 characters 8 Warning Message The detailed information on warning messages is displayed and the configuration can be changed Undisplayed warning Specify the number of the warning message not to be displayed message If multiple message numbers are specified delimit them with comma example 20009 20011 Also the range can be set using hyphen example 20000 20100 20300 20500 This corresponds to the no_warning option of the ccrl command Default Configuration of the common option How to Directly enter in the text box or edit by the Character String Input change dialog box which appears when clicking the button Restriction Up to 2048 characters 9 Others Other detailed information on assembly is displayed and
205. mmand 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 sp
206. mopt prn_path Outputs the assemble list file No ztENESAS Does not output the assemble list file Page 183 of 204 CS A WINDOW REFERENCE Output folder for Specify the folder which the assemble list file is output assemble list file The assemble list file is output under the source file name with the extension replaced by prn 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 If this is blank it is assumed that the project folder has been specified This corresponds to the asmopt prn_path option of the ccrl command This property is displayed only when Yes asmopt prn_path in the Output assemble list file property is selected Default Configuration of the assemble option How to Directly enter in the text box or edit by the Browse For Folder dialog change box which appears when clicking the button Restriction Up to 247 characters 7 Error Output The detailed information on the error output is displayed and the configuration can be changed Output error message Select whether to output the error message file file This corresponds to the error_file option of the ccrl command Error
207. mpDir Replaces with the absolute path of the temporary folder WinDir Replaces with the absolute path of the Windows system folder BuildModeName is set by default If this property is changed an empty variables functions information header file is generated and added to the project it will also appear in the File node of the project tree lt 2 gt Set the output file name Setting the output file is made with the Variables functions information header file name property by directly entering to the text box Up to 259 characters can be specified in the text box This property supports the following placeholders ActiveProjectName Replaces with the active project name MainProjectName Replaces with the main project name ProjectName Replaces with the project name ProjectName _vfi h is set by default R20UT3284EJ0101 Rev 1 01 ztENESAS Page 46 of 204 Aug 01 2015 CS 2 a 2 FUNCTIONS If this property is changed an empty variables functions information header file is generated and added to the project it will also appear in the File node of the project tree Run a build of the project Run a build of the project A variables functions information header file is generated It will be included in the C source automatically and a rebuild will be executed again Remark The variables functions information header file in a Set the generation of the variables func tions information header f
208. n Level property in the Optimization category Figure 2 20 Level of optimization Property Execution Speed Precedence Remark You can also set the option in the same way with the Optimization Level property in the Frequently Used Options for Compile category on the Common Options tab 2 5 3 Add an include path Select the build tool node on the project tree and select the Compile Options tab on the Property panel The include path setting is made with the Additional include paths property in the Preprocess category Figure 2 21 Additional include paths Property Additional include patha l TE i E de pamsi gt o indude files al head of compiling units Include files at head of compiling uras40 gt Mecro definiben Macro definition 0 Metre undefiniton Macro undefinition 0 If you click the button the Path Edit dialog box will open R20UT3284EJ0101 Rev 1 01 ztENESAS Page 20 of 204 Aug 01 2015 CS 2 FUNCTIONS Figure 2 22 Path Edit Dialog Box Bath Edit PaiiiCiren path per cova linai Lad Amo z Proet Der F Permi preciaient path E Include subjolders automatical iy Flsceholder Placeholder Yske lsscration Deine ceci Diwork aarpls Abasia paih dea active E ActvePmecMeomMeme RSFICOLE Adiva prajadi micrncxirnily ActresProeciteme zampe Aree prec res BubdiMede Name Dem Guild Buld mode name Hanro Der Dwwork sane srs cbt a a ok caret tine
209. n 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 Edit by the Text Edit dialog box which appears when clicking the change 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 build processing R20UT3284EJ0101 Rev 1 01 Aug 01 2015 Specify 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 W
210. n function is generated R20UT3284EJ0101 Rev 1 01 ztENESAS Page 36 of 204 Aug 01 2015 CS 2 FUNCTIONS 2 8 Set Hex Output Options To set options for the hex output phase select the Build tool node on the project tree and select the Hex Output Options tab on the Property panel You can set the various hex output options by setting the necessary properties in this tab Caution This tab is not displayed for the library project Figure 2 55 Property Panel Hex Output Options Tab 4 COAL Property 4 Dutput File Outpost hex files Yas Output folder 4 Bulldhtode Mame Quitpuk ile nams Project Mame maot Division output file Division cutout file 0 Hex Format Hens file format Motorola Second file FOnn Stype Unify recond size Ho Quiput 9 pecond at the ead Ho gt CRC Operation Message Others 0 cil potatoe File Selects whether tio output a hiet fle This opti n corespands to the FOrn option al the dink command Remark Often used options have been gathered under the Frequently Used Options for Hex Output category on the Common Options tab 2 8 1 Set the output of a hex file Select the build tool node on the project tree and select the Hex Output Options tab on the Property panel 1 Set the output of a hex file The setting to output a hex file is made with the Output hex file property in the Output File category To output a hex file select Yes to not output a hex file select No
211. n of each area 1 Address Specify the start address of the section Directly enter the address in the text box or select from the button The range that can be specified for the value is 0 to FFFFF hexadecimal number default 0 Function buttons Button Function When opening from the Add button in the Section Settings dialog box Closes this dialog box and adds the specified address to an appropriate location in the address section area in the Section Settings dialog box the section column remains empty When opening from the Modify button in the Section Settings dialog box Closes this dialog box and moves the section group an address and the sections allocated to the address to an appropriate location in the address section area in the Section Settings dialog box Cancel Cancels the settings and closes this dialog box Help Displays the help of this dialog box R20UT3284EJ0101 Rev 1 01 ztENESAS Page 197 of 204 Aug 01 2015 CS A WINDOW REFERENCE Unassigned Section dialog box This dialog box is used to delete sections Figure A 22 Unassigned Section Dialog Box Unassigned Section mj ied_usenile led userii L Function buttons The following items are explained here How to open Description of each area Function buttons How to open On the Section Settings dialog box select an address in the address section area and then click
212. nd Default No How to Select from the drop down list change Restriction Yes Uses the standard mathematical libraries No Does not use the standard mathematical libraries 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 Select from the drop down list change Restriction Yes Uses the runtime libraries No Does not use the runtime libraries R20UT3284EJ0101 Rev 1 01 ztENESAS Page 145 of 204 Aug 01 2015 CS 5 List A WINDOW REFERENCE 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 out put 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 spec ify LISt Outputs the specified information to the library list file No Does not output the library list file Output symbol infor mation Select whether to output the symbol information
213. nd use the variables functions information header file to efficiently allocate variables and functions A vari ables functions information header file header file used to efficiently assign the saddr area and callt area based on the number of times and order in which the variables and functions are referenced is generated by setting the Output vari ables functions information header file property from the Link Options tab on the Property panel Variables will be allo cated to the saddr area and functions to the callt area by performing compilation using that file The procedures for performing this operation are described below Generating a variables functions information header file automatically and allocating variables and functions Editing and using an auto generated variables functions information header file Make sure to confirm that build has completed successfully and a load module file has been generated before using this function 1 Generating a variables functions information header file automatically and allocating variables and functions Below is the procedure for generating a variables functions information header file automatically and using that file to allocate variables and functions via one build a Set the generation of the variables functions information header file Select the build tool node on the project tree and select the Link Options tab on the Property panel Set the Output variables functions inform
214. ng compiler package version property Default No How to Select from the drop down list change Restriction Yes Checks whether the device file is the same CHECK_DEVICE using the device file when an input file was generated and the option for specifying the device file Does not check the specification of the device file R20UT3284EJ0101 Rev 1 01 ztENESAS Page 123 of 204 Aug 01 2015 CS A WINDOW REFERENCE Suppress checking Select whether to suppress checking section allocation that crosses the 64 Kbytes section allocation that 1 boundary crosses 64KB 1 Section allocation that crosses the 64 Kbytes 1 boundary means that the lower 16 boundary bits of the address of the section exceeds OxFFFE and continues to OxFFFF This corresponds to the CHECK_64K_ONLY option of the rlink command This property is displayed 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 01 00 or higher or when V1 01 00 or higher is selected in the Using compiler package version property Default No How to Select from the drop down list change Restriction Yes Suppresses checking section allocation that CHECK_64K_ONLY crosses the 64 Kbytes 1 boundary No Does not suppress checking section alloca tion that crosses the 64 Kbytes 1 bound
215. nged accordingly Category from Common Options Tab Corresponding Tab Frequently Used Options for Compile category Compile Options tab Frequently Used Options for Assemble category Assemble Options tab Frequently Used Options for Link category Link Options tab Frequently Used Options for Hex Output category Hex Output Options tab Frequently Used Options for Create Library category Create Library Options tab R20UT3284EJ0101 Rev 1 01 ztENESAS Page 55 of 204 Aug 01 2015 CS A WINDOW REFERENCE Figure A 2 Property Panel Common Options Tab Build mode Change property value for all build modes at once CPU Specify CPU cone Output File Type and Path Output file type Output cross reference information Intermediate file output folder Frequently Used Options for Compile Level of optimization gt Additional include paths System include paths gt Macro defination Frequently Used Optons for Assembies gt Additional include paths gt System include paths Macro defination Frequently Used Options for Link Using libraries Dutput folder Output file name Use standard mathematical libraries Use runtime libraries Frequently Used Options ior Hex Output Output hex file Hex file format Output folder Output file nama Division output file Error Output Device Build Method Build mode Selects the build mode name to be used during build N
216. not check functions without pro totype declarations Set Oxffff bytes to max imum variable size R20UT3284EJ0101 Rev 1 01 Aug 01 2015 Select whether to increase the maximum variable size from Ox7fff to Oxffff This corresponds to the large_variable option of the ccrl command Default Configuration of the compile option How to Select from the drop down list change Restriction Yes large_variable Increases the maximum variable size No Does not increase the maximum vari able size RENESAS Page 166 of 204 CS Allow nested com ments 7 Character Encoding A WINDOW REFERENCE Select whether to allow the nest use of comments This corresponds to the nest_comment option of the ccrl command Default Configuration of the compile option How to change Select from the drop down list Restriction Yes nest_comment Allows the nest use of comments No Does not allow the nest use of com ments The detailed information on character encoding is displayed and the configuration can be changed Character encoding 8 Output Code Select the character code to be used for Japanese Chinese comments and character strings in the source file This corresponds to the character_set option of the ccrl command Default Configuration of the compile option How to change Select from the drop down list Restriction
217. ns Tab 5 laj la ele Cmo Dupak folder YBuldMode Mamat Output Fle nams Project Memes mot Division output file Division cutout file 0 Hex Format Hex file huma Moterla S ecord file Alnm Stype Unify recond size Ho Quiput 9 record at the ead Ho gt CRC Operation Message gt Others Out put hex Fike Selects whether to output a hex file This opti n comrespands to the FOrn option al the dink command Description of each category 1 Output File The detailed information on output files is displayed and the configuration can be changed Output hex file Select whether to output the hex file This corresponds to the FOrm option of the rlink command Default Yes How to Select from the drop down list change Restriction Yes Outputs the hex file Default No Does not output the hex file R20UT3284EJ0101 Rev 1 01 ztENESAS Page 130 of 204 Aug 01 2015 CS A WINDOW REFERENCE Output folder Specify the folder which the hex file is output If a relative path is specified the reference point of the path is the main project or sub project 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 placeholders are supported ActiveProjectDir Replaces with the absolute path of the active project folder ActiveProjectName Replaces with the active project name BuildModeNa
218. ns The options set here are added at the end of the compile options group Default Blank How to Directly enter in the text box or edit by the Character String Input dia change log box which appears when clicking the button Restriction Up to 259 characters R20UT3284EJ0101 Rev 1 01 ztENESAS Page 97 of 204 Aug 01 2015 CS A WINDOW REFERENCE Assemble Options tab This tab shows the detailed information on the assemble phase categorized by the following and the configuration can be changed 1 Debug Information 2 Optimization 3 Preprocess 4 Character Encoding 5 Assemble List 6 Others Figure A 4 Property Panel Assemble Options Tab Add debug informaton Optimization Qutputs additional information for inter module optimization Preprocess Additional include paths System include paths gt Macro defination gt Macro undefinition gt Character Encoding gt Assemble List Add debug informabon E a e e Yesa No Additional include pathaplj System include pathafl Macro defintion D Macro undefiniion D Species whether to generate the debug information Such information is generated when debugging a program just like the case of washing to perform source debugging with debugger This option comesponds bo Common Opt Compile Opt Asse semble Link Options Hex Output 0 Description of each categor
219. nstruction te call a function at the end of the function Yee To adjust the level of optimization Mame Perform inter moduble optimization No Perform optimizabon considering type of data indicated by pointer Ho Outputs additional information for inter module optimization Ho Create subroutine for same instruction sequence No Preprocess Additional include paths Additional include path M Use whole include paths specified for build tool Yes Include files at head of compiling units Include files at head of compiling unts 0 b Macro definition Macro defintionft bo Macro undefinition Macro undefintion U Hoone Add debug informabon Species whether to generate the debug information Such information is generated when debugging Program just like the case of wishing to perform source debugging with debugger a a E You can set compile options for the C source file by setting the necessary properties in this tab Note that this tab takes over the settings of the Common Options tab and Compile Options tab by default except the properties shown below Additional include paths and Use whole include paths specified for build tool in the Preprocess category Object module file name in the Output File category 2 When setting assemble options for an assembly source file Select the assembly source file on the project tree and select the Build Settings tab on the Property panel Select Yes in the Set in
220. o RLV8 53 core cpu S3 Execute Module Load Module Fle No 4 Build Mode Names Perform the default optimization Mene Addtional mdude pathe D Macro definition Additional include paths 0 System include paths 0 Macro definition 0 Using ibraneafD ProjactNemes aba Yaa Yaa Yaa Motorola Srecord file FOm Stepe Project Memes mot Divison output fils 0 R20UT3284EJ0101 Rev 1 01 Aug 01 2015 ztENESAS Page 56 of 204 CS A WINDOW REFERENCE Description of each category 1 Build Mode The detailed information on the build mode is displayed and the configuration can be changed Build mode Select the build mode to be used during a build Note that this property is not applied to Reset All to Default from the context menu Default DefaultBuild How to Select from the drop down list change Restriction DefaultBuild Runs a build with the default build mode that is set when a new project is created Build mode that is Runs a build with the build mode that is added to the project added to the project other than Default Build Change property value Select whether to reflect the value newly set to all build modes when a value is set in for all build modes at this property once Be careful since the value set may not be an appropriate value for other build modes Default No How to Select from the drop down list change Restriction Yes Reflects the value new
221. o the prepro information to prepro cessed file cessed file This corresponds to the preprocess option of the ccrl command This property is displayed only when Yes P in the Output preprocessed source file property in the Output File category is selected Default No How to Select from the drop down list change Restriction Yes preprocess line Outputs the line number information of the C source to the preprocessed file No Does not output the line number information of the C source to the preprocessed file 5 Quality Improvement The detailed information on the quality improvement is displayed and the configuration can be changed Detect stack overflow Select whether to detect the stack overflow This property is usable only in the Professional Edition Detection of stack overflow is a feature for writing a value outside the valid stack area before entering a function and checking whether that value is rewritten before exiting the function Upon detection the user defined __ stack_chk_fail function is called See CC RL Compiler User s Manual about the difference between Yes stack_protector and Yes All stack_protector_all This corresponds to the stack_protector and stack_protector_all options of the ccrl command This property is displayed when Always latest version which was installed in the Using compiler package version property in the Version Select category from t
222. of CC RL is searched This corresponds to the I option of the ccrl command The specified include path is displayed as the subproperty Uppercase characters and lowercase characters are not distinguished for the include paths Default Additional include paths number of defined items How to Edit by the Path Edit dialog box which appears when clicking the change button For the subproperty you can enter directly in the text box Restriction Up to 247 characters Up to 256 items can be specified Use whole include Select whether to assemble using the include path specified in the Additional include paths specified for paths property in the Preprocess category from the Assemble Options tab of the build tool build tool to be used The setting of the Compile Options tab is used when Yes in the Build simultaneously property in the Build Method category from the Common Options tab is selected This corresponds to the I option of the ccrl command Paths specified in the Additional include paths property from this tab Paths specified in the Additional include paths property from the Assemble Options tab Paths displayed in the System include paths property from the Assemble Options tab Default Yes How to Select from the drop down list change Restriction Yes Assembles using the include path specified in the property of the build tool to be used Does not use the inc
223. og box Modify Section dialog box Add Overlay dialog box These dialog boxes are used to set a section name when adding modifying or overlaying a section respectively Section Address dialog box This dialog box is used to set an address when adding or modifying a section Unassigned Section dialog box R20UT3284EJ0101 Rev 1 01 Aug 01 2015 This dialog box is used to delete sections ztENESAS Page 51 of 204 CS A WINDOW REFERENCE Property panel This panel is used to display the detailed information on the Build tool node or file that is selected on the Project Tree panel by every category and change the settings of the information Figure A 1 Property Panel A CORL Property a 2 cle R20UT3284EJ0101 Rev 1 01 Aug 01 2015 4 Build Mode Build mode Change property value for all build modes at once CPU Specify CPU cone Output File Type and Path Output file ype Output cross reference information Intermediate file output folder Frequently Used Opiona ior Compile Level of optimization gt Additional include paths System include paths gt Macro defination Frequently Used Optonsifor Assemble gt Additional include paths gt System include paths Macro defination Frequently Used Options for Link Using libraries Output folder Output file name Use standard mathematical libraries Use runtime libraries Frequently Used Options for Hex Output Output hese fi
224. olute 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 assemble processing The placeholders can be described in the script The specified command is displayed as the subproperty Default Commands executed after assemble processing number of defined items How to Edit by the Text Edit dialog box which appears when clicking the change 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 Input the assemble option to be added additionally options The assembler is executed via ccrl exe Add asmopt as required The options set here are added at the end of the assemble options group Default Blank How to Directly enter in the text box or edit by the Character String Input dia change log box which appears when clicking the button Restriction Up to 259 characters R20UT3284EJ0101 Rev 1 01 ztENESAS Page 104 of 204 Aug 01 2015 CS A WINDOW REFERENCE Link Options tab This tab shows the detailed information on the link phase categorized by the following and the configuration can be changed Debug Information Optimization Input File
225. om the drop down list change Restriction Yes SHows Total_size Outputs the total sizes of sections sepa rately for ROM allocated sections and RAM allocated sections Does not output the total size of sections R20UT3284EJ0101 Rev 1 01 ztENESAS Page 118 of 204 Aug 01 2015 CS A WINDOW REFERENCE Output vector informa tion Select whether to output the vector information This corresponds to the SHow VECTOR 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 Select from the drop down list change Restriction Yes SHow VECTOR Outputs vector information to the linkage list file No Does not output vector information to the linkage list file Output information of members of struct or union Select whether to output the member information of the structure or union To output it specify the g option when compiling This corresponds to the SHow STRUCT option of the rlink command This property is displayed 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 02 00 or higher or when V1 02 00 or higher is selected in the Using compiler package version property When Yes Lis
226. ommands executed before build processing and Commands executed after build processing properties If there are any commands you wish to run before or after the build process at the file level you can set them from the Individual Compile Options tab for a C source file and Individual Assemble Options tab for an assembly source file Save the project Save the setting contents of the project to the project file R20UT3284EJ0101 Rev 1 01 ztENESAS Page 7 of 204 Aug 01 2015 CS 2 FUNCTIONS 2 1 2 Create a user library The procedure for creating a user library is shown below Remark See CS Integrated Development Environment User s Manual Project Operation for details about 1 2 3 6 and 7 1 Create or load a project Create a new project or load an existing one When you create a new project set a library project Remark When converting a CA78KOR project into a CC RL project see 2 2 Convert a CA78KOR project into a CC RL project Set a build target project Set a build target project Set build target files Add or remove build target files and update the dependencies Set speeding up of build Set a build speed up facility as required see 2 3 Speeding up of Build Set build options Set the options for the compiler assembler librarian and the like see 2 5 Set Compile Options 2 6 Set Assemble Options 2 9 Set Create Library Options Run a build Run a build Remark If there are
227. on For the subproperty you can enter directly in the text box Restriction Up to 256 characters Up to 256 items can be specified 6 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 R20UT3284EJ0101 Rev 1 01 ztENESAS Page 62 of 204 Aug 01 2015 CS A WINDOW REFERENCE Using libraries Specify the library files to be used 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 w
228. ons or drag and drop the path names Remark 1 Move the mouse cursor over a file name to display a tooltip with the absolute path of that file Remark 2 Newly added system include paths are added next to the last path of the list Remark 3 When the path names are dragged and dropped the multiple path names which are next to each other can be selected together b Button Moves the selected path to up Moves the selected path to down Remark Note that above buttons are disabled when any path is not selected R20UT3284EJ0101 Rev 1 01 ztENESAS Page 188 of 204 Aug 01 2015 CS A WINDOW REFERENCE Function buttons Button Function OK Sets the specified order of the paths to the compiler as the display order in the Path list display area and closes this dialog box Cancel Cancels the specified order of the paths and closes the dialog box Help Displays the help of this dialog box R20UT3284EJ0101 Rev 1 01 Aug 01 2015 RENESAS Page 189 of 204 CS A WINDOW REFERENCE Specify Rule Number dialog box This dialog box is used to select the number of the MISRA C rule and set it to the area that this dialog box is called from Figure A 16 Specify Rule Number Dialog Box Specify the Rule Number Select tams Function buttons The following items are explained here How to open Description of each area Function buttons How to open
229. operty is changed to No when Yes in the Compulsorily output cross reference file property is selected this property will be changed to Yes cref during a build This corresponds to the cref option of the ccrl command Default No How to Select from the drop down list change Restriction Yes cref Outputs the cross reference information The build processing speed slows down but jump to function can be used Does not output the cross reference information R20UT3284EJ0101 Rev 1 01 ztENESAS Page 58 of 204 Aug 01 2015 CS Intermediate file output folder A WINDOW REFERENCE Specify 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 sub project 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 If this is blank it is assumed that the project folder has been specified This corresponds to the obj_path option or o option of the ccrl command Default BuildModeName How to Directly enter in the text box or edit by the Browse For Folder dialog change box which appears when clicking the button Restriction Up to 247 characters 4 Frequently Used Options for Compile The detailed in
230. option How to Select from the drop down list change Restriction Yes goptimize Outputs additional information for inter module optimization No Does not outputs additional information for inter module optimization 3 Preprocess The detailed information on preprocessing is displayed and the configuration can be changed R20UT3284EJ0101 Rev 1 01 ztENESAS Page 180 of 204 Aug 01 2015 CS A WINDOW REFERENCE Additional include Specify the additional include paths during assembling paths 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 specified include path is searched with higher priority than the standard include file folder of CC RL The reference point of the path is the project folder When this property is omitted only the standard folder
231. 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 Edit by the Text Edit dialog box which appears when clicking the change 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 Input the create library options to be added additionally options The options set here are added at the end of the create library options group Default Blank How to Directly enter in the text box or edit by the Character String Input dia change
232. pecify 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 Directly enter in the text box change Restriction Up to 259 characters 4 Library The detailed information on the library is displayed and the configuration can be changed R20UT3284EJ0101 Rev 1 01 ztENESAS Page 144 of 204 Aug 01 2015 CS A WINDOW REFERENCE 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 sub project 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 MainProjectNa
233. perty you can enter directly in the text box Restriction Up to 1024 characters Up to 256 items can be specified R20UT3284EJ0101 Rev 1 01 Aug 01 2015 RENESAS Page 109 of 204 CS Symbol definition 4 Output File A WINDOW REFERENCE Define the symbols Specify in the format of symbol name symbol name or symbol name numerical value with one entry name per line Specify the numerical value in hexadecimal without Ox This corresponds to the DEFine option of the rlink command The symbol name is displayed as the subproperty Default Symbol 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 enter directly in the text box Restriction Up to 256 characters Up to 256 items can be specified The detailed information on output files is displayed and the configuration can be changed 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
234. piling assembling linking multi ple 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 3 1 Running simultaneous build for details about running a build simultane ously Default Yes How to Select from the drop down list change Restriction Yes Compiles assembles and links multiple files simulta neously The assembly source file except the file with the individual options is assembled using the settings of the Compile Options tab No Compiles assembles and links for each file Build in parallel Select 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 gt gt Option and then making a setting in the General Build category of the Option dia log box See 2 3 2 Running parallel build for details about parallel build Default No How to Select from the drop down list change Restriction Yes Enables the parallel build facility No Disables the parallel build facility Handling the source Select whether to recompile assemble the source file if it includes a file that is not file includes unfound found in
235. puts the calculation result of CRC 16 CCITT MSB first operation with the input specified as 4 byte units in little endian mode CRC CCITT MSB LIT TLE 2 bytes type Outputs the calculation result of CRC 16 CCITT MSB first operation with the input specified as 2 byte units in little endian mode 16 Outputs the calculation result of CRC 16 LSB first operation SENT MSB type Outputs the calculation result of operation con forming to SENT CRC CCITT LSB type Outputs the calculation result of CRC 16 CCITT LSB first operation 32 ETHERNET type Outputs the calculation result of CRC 32 ETHERNET operation Initial value R20UT3284EJ0101 Rev 1 01 Aug 01 2015 Specify the initial value for the CRC code in the format of initial value This corresponds to the CRc option of the rlink command This property is displayed only when Yes CRc in the Outputs the calculation result of CRC property is selected Default Blank How to change Directly enter to the text box Restriction When other than 32 ETHERNET type is selected in the Type of CRC property 0 to FFFF hexadecimal number When 32 ETHERNET type is selected in the Type of CRC prop erty 0 to FFFFFFFF hexadecimal number ztENESAS Page 136 of 204 CS A WINDOW REFERENCE Endian Select the endian for CRC output This corresponds to the CRc option of the rlink comm
236. r edit by the Browse For Folder dialog change box which appears when clicking the button Restriction Up to 247 characters Variables functions information header file name 10 Section Specify the variables functions information header file name If the extension is omitted h is automatically added The following placeholders are supported ActiveProjectName Replaces with the active project name MainProjectName Replaces with the main project name ProjectName Replaces with the project name This corresponds to the VFINFO 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 01 00 or higher or when V1 01 00 or higher is selected in the Using compiler package version property When Yes VFINFO in the Output variables functions information header file property is selected Default ProjectName _vfi h How to Directly enter in the text box change Restriction Up to 259 characters The detailed information on the section is displayed and the configuration can be changed R20UT3284EJ0101 Rev 1 01 Aug 01 2015 ztENESAS Page 121 of 204 CS A WINDOW REFERENCE Layout sections auto Select whether to allocate sections automatically matical
237. rce file If Yes Level 3 Perform with assuming it the whole program Owhole_program is selected in the Perform inter module optimization property in the Optimiza tion Details category from the Compile Options tab this property will be grayed out and changed to No This property is displayed only when a C source file is selected on the project tree and Yes in the Set as build target property is selected Default No How to Select from the drop down list change Restriction Yes Sets the option that differs from the project settings to the selected C source file Does not set the option that differs from the project settings to the selected C source file R20UT3284EJ0101 Rev 1 01 ztENESAS Page 155 of 204 Aug 01 2015 CS A WINDOW REFERENCE Set individual assem Select whether to set the assemble option that differs from the project settings to the ble option selected assembly source file If Yes Level 3 Perform with assuming it the whole program Owhole_program is selected in the Perform inter module optimization property in the Optimiza tion Details category from the Compile Options tab this property will be grayed out and changed to No This property is displayed only when the assembly source file is selected on the proj ect tree and Yes in the Set as build target property tab is selected Default No How to Select from the drop down list change R
238. rce to the preprocessed file Output line number Select whether to output the line number information of the C source to the prepro information to prepro cessed file cessed file This corresponds to the preprocess option of the ccrl command This property is displayed only when Yes P in the Output preprocessed source file property in the Output File category is selected Default Configuration of the compile option How to Select from the drop down list change Restriction Yes preprocess line Outputs the line number information of the C source to the preprocessed file No Does not output the line number information of the C source to the preprocessed file 5 Quality Improvement The detailed information on the quality improvement is displayed and the configuration can be changed Detect stack overflow Select whether to detect the stack overflow This property is usable only in the Professional Edition Detection of stack overflow is a feature for writing a value outside the valid stack area before entering a function and checking whether that value is rewritten before exiting the function Upon detection the user defined __ stack_chk_fail function is called See CC RL Compiler User s Manual about the difference between Yes stack_protector and Yes All stack_protector_all This corresponds to the stack_protector and stack_protector_all options of the ccrl command T
239. rded as the script of the Python console and then executed after link 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 link processing number of defined items How to Edit by the Text Edit dialog box which appears when clicking the change 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 Input the link option to be added additionally options The options set here are added at the end of the link options group Default Blank How to Directly enter in the text box or edit by the Character String Input dia change log box which appears when clicking the button Restriction Up to 259 characters R20UT3284EJ0101 Rev 1 01 ztENESAS Page 129 of 204 Aug 01 2015 CS A WINDOW REFERENCE Hex Output Options tab This tab shows the detailed information on the Hex output phase categorized by the following and the configuration can be changed 1 Output File 2 Hex Format 3 CRC Operation 4 Message 5 Others Caution This tab is not displayed for the library project Figure A 6 Property Panel Hex Output Optio
240. ress to which the section is allocated Default No Does not check the consistency of the address to which the section is allocated Address range of Specify the address range of the memory type memory type Specify in the format of memory type start address end address with one entry per line Any of ROm RAm or FIX can be specified as memory type Specify start address and end address in hexadecimal without Ox This corresponds to the CPu option of the rlink command The address range of the memory type is displayed as the subproperty This property is displayed only when Yes CPu in the Check section larger than specified range of address property is selected Default Address range of memory type number of defined items How to Edit by the Text Edit dialog box which appears when clicking the change button For the subproperty you can enter directly in the text box Restriction Up to 32767 characters Up to 65535 items can be specified Check specifications Select whether to check the specification of the device file of device This corresponds to the CHECK_DEVICE option of the rlink command This property is displayed 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 01 00 or higher or when V1 01 00 or higher is selected in the Usi
241. riction Apply all rules Checks the source code against all of misra20XX all the rules which are supported Apply specified rule num ber misra20XX apply Checks the source code against the rules with the specified numbers among the rules which are supported Ignore specified rule num ber misra20XX ignore Checks the source code against the rules that do not match the specified numbers among the rules which are supported Apply rules that are classi fied as required misra20XX required Checks the source code against the rules of the required type Apply rules that are classi fied as required and speci fied rule number misra20XX required_add Checks the source code against the rules of the required type and the rules with the specified numbers among the rules which are supported Ignore specified rule number from rules that are classified as required misra20XX required_remov e Checks the source code against the rules of the required type except for the rules with the specified numbers among the rules which are supported Apply rules that are described in the specified file misra20XX lt file name gt Checks the source code against the rules with the numbers described in specified file among the rules which are supported Not apply rule None Does not apply the MISRA C rules Rule number descrip tion file Specify the rule number descrip
242. rning is not displayed Control allocation to Select whether to control the allocation to the trace RAM area trace RAM area This corresponds to the OCDTR OCDTRW option of the rlink command Note that specifying this option makes the SELF SELFW option assumed to be specified 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 01 00 or higher or when V1 01 00 or higher is selected in the Using compiler package version property For a device in which allocation to the trace RAM area is controllable Default No How to Select from the drop down list change Restriction Yes Error mes Prohibits the allocation to the trace RAM area sage OCDTR and displays an error Yes Warning mes Outputs a warning when allocating to the sage OCDTRW trace RAM area No Uses the trace RAM area as the internal RAM area An error or warning is not dis played R20UT3284EJ0101 Rev 1 01 ztENESAS Page 114 of 204 Aug 01 2015 CS A WINDOW REFERENCE Control allocation to Select whether to control the allocation to the hot plug in RAM area hot plug in RAM area This corresponds to the OCDHPI OCDHPIW option of the rlink command Note that specifying this option makes the SELF SELFW and OCDTR OCDT
243. rogram Options How to Directly enter in the text box or edit by the Character String Input dia change log box which appears when clicking the button Restriction Up to 256 characters R20UT3284EJ0101 Rev 1 01 ztENESAS Page 72 of 204 Aug 01 2015 CS Commands executed before build process ing A WINDOW REFERENCE Specify 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 Pytho
244. roperty you can enter directly in the text box Restriction Up to 256 characters Up to 256 items can be specified Macro undefinition R20UT3284EJ0101 Rev 1 01 Aug 01 2015 Specify the macro name to be undefined Specify in the format of macro name with one macro name per line This corresponds to the U option of the ccrl command The specified macro is displayed as the subproperty Default Macro undefinition 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 ztENESAS Up to 256 characters Up to 256 items can be specified Page 82 of 204 CS A WINDOW REFERENCE Output C source com Select whether to output the comments of the C source to the preprocessed file ments to preprocessed This corresponds to the preprocess option of the ccrl command file This property is displayed only when Yes P in the Output preprocessed source file property in the Output File category is selected Default No How to Select from the drop down list change Restriction Yes preprocess com Outputs the comments of the C source to ment the preprocessed file No Does not output the comments of the C source to the preprocessed file Output line number Select whether to output the line number information of the C source t
245. rule number is selected in the Apply rule property and a rule number is specified in the Rule number property When Apply rules that are classified as required and specified rule number is selected in the Apply rule property and a rule number is specified in the Check rule number besides required rule property When Ignore specified rule number from rules that are classified as required is selected in the Apply rule property and a rule number is specified in the Exclusion rule number from required rule property When Apply rules that are described in the specified file is selected in the Apply rule property and a rule number description file is specified in the Rule number description file property Default Configuration of the compile option How to Edit by the Path Edit dialog box which appears when clicking the change button gt Edit by the Add Excluding 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 R20UT3284EJ0101 Rev 1 01 ztENESAS Page 174 of 204 Aug 01 2015 CS A WINDOW REFERENCE Output message of the Select whether to output the message of the enhanced key word and extended speci enhanced key word fications and extended specifi This property is usable only in the Professional Edition cations This corresponds to the check_language_extention option of
246. s 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 exam ple 4 200 203 1300 This corresponds to the CHange_message option of the rlink command This property is displayed only when No in the Use same message related settings as Link Options tab property is selected and when Yes Specify message number CHange_message Error lt Message numbers gt in the Change information and warn ing message to error message property is selected Default Blank How to change Directly enter in the text box or edit by the Character String Input dia log box which appears when clicking the button Restriction Up to 2048 characters Other detailed information on the hex output is displayed and the configuration can be changed This category is displayed only when Yes in the Output hex file property in the Output File category is selected Other additional options Input the hex output options to be added additionally The options set here are added at the end of the hex output options group Default Blank How to change Directly enter in the text box or edit by the Character String Input dia log box which appears when clicking the button Restriction Up to 259 characters R20UT3284EJ0101 Re
247. s displayed 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 02 00 or higher or when V1 02 00 or higher is selected in the Using compiler package version property When other than No optimize NOOPtimize in the Optimization type property is selected Default Unreferenced symbol that disables deletion by optimization number of defined items How to Edit by the Text Edit dialog box which appears when clicking the change button For the subproperty you can enter directly in the text box Restriction Up to 32767 characters Up to 65536 items can be specified Section to disable opti mization Specify sections that you do not wish to be optimized in the format of file name mod ule name section name with one specification on one 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
248. s if they are volatile qualified No Optimizes external variables that are not volatile qualified R20UT3284EJ0101 Rev 1 01 ztENESAS Page 87 of 204 Aug 01 2015 CS A WINDOW REFERENCE Output code of switch Select the code output mode for switch statements in programs statement This corresponds to the switch option of the ccrl command Default Auto None How to Select from the drop down list change Restriction Auto None The ccrl selects the optimum output format if else switch ifelse Outputs the switch statements in the same format as the if else statement along a string of case statements in programs Select this item if the case statements are written in the order of frequency or if only a few labels are used Because the case statements are compared starting from the top unnecessary compari son can be reduced and the execution speed can be increased if the case statement that most often matches is written first Binary search Outputs the code in the binary search format switch binary for switch statements in programs Searches for a matching case statement by using a binary search algorithm If this item is selected when many labels are used any case statement can be found at almost the same speed Table jump abso Outputs the code in the table jump format lute absolute branch for switch statements in switch abs_table programs References a table indexed on
249. s products are neither intended nor authorized for use in products or systems that may pose a direct threat to human life or bodily injury artificial life support devices or systems surgical implantations etc or may cause serious property damages nuclear reactor control systems military equipment etc You must check the quality grade of each Renesas Electronics product before using it in a particular application You may not use any Renesas Electronics product for any application for which it is not intended Renesas Electronics shall not be in any way liable for any damages or losses incurred by you or third parties arising from the use of any Renesas Electronics product for which the product is not intended by Renesas Electronics You should use the Renesas Electronics products described in this document within the range specified by Renesas Electronics especially with respect to the maximum rating operating supply voltage range movement power voltage range heat radiation characteristics installation and other product characteristics Renesas Electronics shall have no liability for malfunctions or damages arising out of the use of Renesas Electronics products beyond such specified ranges Although Renesas Electronics endeavors to improve the quality and reliability of its products semiconductor products have specific characteristics such as the occurrence of failure at a certain rate and malfunctions under certain use conditions Further Ren
250. s the version of the device file when a project is opened If the device file has been updated and there is a possibility that the I O header file needs to be updated a message is displayed on the Output panel Update the I O header file with the method below as required On the Project Tree panel select the Build tool node and then select Generate I O Header File from the con text menu Figure 2 75 Generate I O Header File Item ALTE Simmulater Ea Build Project FF S File W Rebuild Project Shift F7 bark estarLagm hdwinitasn Clean Project tah stkinitasm FiF Ser to Default Build Option for Project EJ main c i a iodefineh LU Import Build Options I Set Link Order lt ia Generate VO Header File i gt E Property R20UT3284EJ0101 Rev 1 01 ztENESAS Page 48 of 204 Aug 01 2015 CS 2 FUNCTIONS At build The I O header file can be updated automatically when the build process is performed and immediately before build Set the Update I O header file on build property of the I O Header File Generation Options tab in the Property panel The update conditions can also be changed in the property of the same category Figure 2 76 Update I O header file on build Property rD header tile on build Enable MERA C option Ka R20UT3284EJ0101 Rev 1 01 ztENESAS Page 49 of 204 Aug 01 2015 CS 2 FUNCTIONS 2 13 Estimate the Stack Capacity To estimate the stack capacity use Call Walker
251. sage option of the rlink command This property is displayed only when No in the Use same message related settings as Link Options tab property is selected and when Yes Specify message number CHange_message Warning lt Message numbers gt in the Change information mes sage to warning message property is selected Default Blank How to change Directly enter in the text box or edit by the Character String Input dia log box which appears when clicking the button Restriction Up to 2048 characters ztENESAS Page 139 of 204 CS Change information and warning message to error message A WINDOW REFERENCE Select whether to change the type of information and warning messages to error This corresponds to the CHange_message option of the rlink command This property is displayed only when No in the Use same message related settings as Link Options tab property is selected Default No How to change Select from the drop down list Restriction Yes All CHange_message Error Changes the type of all informa tion and warning messages to error Yes Specify message number CHange_message Error lt Mes sage number gt Specifies the number of informa tion or warning message of which type is to be changed to error No Does not change the type of infor mation and warning messages Number of information and warning message 5 Other
252. section attri bute 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 exe cute 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 Default Binary file number of defined items How to Edit by the Text Edit dialog box which appears when clicking the change button For the subpro
253. section to be added and click the OK button to add the entered section to Section in the Section Settings dialog box R20UT3284EJ0101 Rev 1 01 ztENESAS Page 33 of 204 Aug 01 2015 CS 2 FUNCTIONS Figure 2 51 Section Settings Dialog Box After RAM Sections Are Added Click here and then click the New Over lay button Add the sections to be allocated to the same address by using the New Overlay button in the same way The added sections are displayed under Overlay n n number starting with 1 R20UT3284EJ0101 Rev 1 01 ztENESAS Page 34 of 204 Aug 01 2015 CS 2 FUNCTIONS Figure 2 52 Section Settings Dialog Box After Overlaid Sections Are Added bend us For other RAM sections set addresses and section names in the same way Remark Click the Address column and click the Add button to open the Section Address dialog box allowing you to add a new address R20UT3284EJ0101 Rev 1 01 7tENESAS Page 35 of 204 Aug 01 2015 CS 2 FUNCTIONS Figure 2 53 Section Settings Dialog Box After Multiple RAM Sections Are Added Click the OK button The specified ROM sections and RAM sections overlaid sections will be displayed in the text boxes Figure 2 54 Section start address Property After Setting Sections 3 Runa build of the project Run a build of the project A load module file to use the overlaid section selectio
254. solute 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 system include path is searched with lower priority than the additional include path The reference point of the path is the project folder This corresponds to the I option of the ccrl command The include path is displayed as the subproperty Default System include paths number of defined items How to Edit by the System Include Path Order dialog box which appears change when clicking the button Restriction Changes not allowed Only the specified order of the include paths can be changed R20UT3284EJ0101 Rev 1 01 ztENESAS Page 81 of 204 Aug 01 2015 CS Include files at head of compiling units A WINDOW REFERENCE Specify the file that is included at the top of the compilation unit 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 p
255. ss minus 3 in the internal RAM area in hexadecimal 7 Output Code The detailed information on output codes is displayed and the configuration can be changed Specify execution start Select whether to specify the execution start address with the external defined symbol address or address This corresponds to the ENTry option of the rlink command Default No How to Select from the drop down list change Restriction Yes ENTry Specifies the execution start address with the exter nal defined symbol or address No Does not specify the execution start address with the external defined symbol or address Execution start Specify the execution start address address Specify in the format of symbo name or address Specify the address in hexadecimal without Ox This corresponds to the ENTry option of the rlink command The execution start address is displayed as the subproperty This property is displayed only when Yes ENTry in the Specify execution start address property is selected Default Blank How to Directly enter in the text box or edit by the Character String Input dia change log box which appears when clicking the button Restriction Up to 32767 characters R20UT3284EJ0101 Rev 1 01 ztENESAS Page 116 of 204 Aug 01 2015 CS Fill with padding data at the end of a section A WINDOW REFERENCE Select whether to fill with padding data at t
256. stall 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 OUtput option of the rlink command The division output file name is displayed as the subproperty This property is displayed only when Yes in the Output hex file property is selected Default Division output file number of defined items How to Edit by the Text Edit dialog box which appears when clicking the change button For the subproperty you can enter directly in the text box Restriction Up to 259 characters Up to 65535 items can be specified 8 Frequently Used Options for Create Library The detailed information on frequently used options during library generation is displayed and the configuration can be changed This category is displayed only for the library project 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 Select from the drop down list change 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 fi
257. striction Up to 259 characters R20UT3284EJ0101 Rev 1 01 Aug 01 2015 ztENESAS Page 92 of 204 CS A WINDOW REFERENCE Rule number Specify the rule number to be checked This property is usable only in the Professional Edition Specify at least one rule number in decimal This corresponds to the misra20XX option of the ccrl command This property is displayed only when Apply specified rule number misra20XX apply in the Apply rule property is selected Default Blank How to Directly enter in the text box or edit by the Specify Rule Number dia change log box which appears when clicking the button Restriction Up to 259 characters Exclusion rule number Specify the rule number to be excluded from the check This property is usable only in the Professional Edition Specify at least one rule number in decimal This corresponds to the misra20XX option of the ccrl command This property is displayed only when Ignore specified rule number misra20XX ignore in the Apply rule property is selected Default Blank How to Directly enter in the text box or edit by the Specify Rule Number dia change log box which appears when clicking the button Restriction Up to 259 characters Check rule number besides required rule Specify the rule number to be checked besides the required rules This property is usable only in the Professional Edition Specify at least one
258. sts CA78KOR 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 See CS Integrated Development Environment User s Manual Project Operation for detail about a build mode Options to change Build mode If an option that has been set in a CA78KOR project and has been changed to use ina CC RL project exists in the case that the function is same as CA78KOR but the param eter 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 CA78KOR project gt Option of CC RL project This item is output only when the corresponding option exists CA78KOR 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 See CS Integrated Development Environment User s Manual Project Operation for detail about a build mode R20UT3284EJ0101 Rev 1 01 ztENESAS Page 11 of 204 Aug 01 2015 CS 2 FUNCTIONS 2 3
259. t The detailed information on the assemble list is displayed and the configuration can be changed R20UT3284EJ0101 Rev 1 01 ztENESAS Page 170 of 204 Aug 01 2015 CS A WINDOW REFERENCE Output assemble list Select whether to output the assemble list file file This corresponds to the asmopt prn_path option of the ccrl command Default Configuration of the compile option How to Select from the drop down list change Restriction Yes asmopt prn_path Outputs the assemble list file No Does not output the assemble list file Output folder for Specify the folder which the assemble list file is output assemble list file The assemble list file is output under the source file name with the extension replaced by prn If a relative path is specified the reference point of the path is the main project or sub project 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 If this is blank it is assumed that the project folder has been specified This corresponds to the asmopt prn_path option of the ccrl command This property is displayed only when Yes asmopt prn_path in the Output assem ble list file property is selected Default Configuration of the compile option How to Directly enter in the text box or e
260. t Options tab on the Property panel Enter the hex file name to be changed to in the Output file name property in the Output File category Figure 2 7 Output file name Property 4 Output File Ditput hex file Yes Output fle name This property supports the following placeholders ActiveProjectName Replaces with the active project name R20UT3284EJ0101 Rev 1 01 ztENESAS Page 14 of 204 Aug 01 2015 CS 2 FUNCTIONS MainProjectName Replaces with the main project name ProjectName Replaces with the project name Remark You can also change the option in the same way with the Output file name property in the Fre 3 quently Used Options for Hex Output category on the Common Options tab If the Hex file format property in the Hex Format category is changed the following message dialog box will open Figure 2 8 Message Dialog Box De you change ale edenaion When Yes is selected in the dialog box the extension of the output file name is changed according to the format selected in the Hex file format property Figure 2 9 Output file name and Hex file format Property 4 Output File aa file Yes Hex file When changing the library file name Select the build tool node on the project tree and select the Create Library Options tab on the Property panel Enter the library file name to be changed to on the Output file name property in the Output File category Figure 2
261. t contents specify LISt in the Output link map file property is selected Default No How to Select from the drop down list change Restriction Yes SHow STRUCT Outputs the member information of the structure or union No Does not output the member information of the structure or union 9 Variables functions information The detailed information on variables functions is displayed and the configuration can be changed R20UT3284EJ0101 Rev 1 01 Aug 01 2015 ztENESAS Page 119 of 204 CS A WINDOW REFERENCE Output variables func Select whether to output the variables functions information header file tions information If Yes VFINFO is selected commands are called in the following order Compiler header file and assembler commands will be called twice in a single build processing 1 Compiler CC RL 2 Assembler CC RL 3 Optimizing linker rlink VFINFO 4 Compiler CC RL preinclude variables functions information header file 5 Assembler CC RL 6 Optimizing linker rlink To edit the variables functions information header file which has been output when using it change this property to No and specify the edited file in the Include files at head of compiling units property of the Compile Options tab The variables functions information header file is registered in the File node of the project tree under the file name specified in the Variables functions information head
262. t from the drop down list change Restriction Yes CA78KOR Uses support for porting from the CA78KOR convert_cc ca78kOr compiler Yes NC30 Uses support for porting from the NC30 com convert_cc nc30 piler Yes IAR Uses support for porting from the IAR com convert_cc iar piler No None Uses support for porting from other compiler Commands executed Specify the command to be executed before compile processing before compile pro Use the call instruction to specify a batch file example call a bat cessing 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 CompiledFile Replaces with the absolute path of the output file under compil ing nputFile Replaces with the absolute path of the file to be compiled 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 a
263. t the location calling functions This corresponds to the Oinline_level option of the ccrl command This property is displayed only when Perform the default optimization None Code size precedence Osize or Speed precedence Ospeed in the Level of optimiza tion property is selected Default Yes To adjust the level of optimization None How to change Select from the drop down list Restriction Yes To adjust the level of optimization None Performs optimization according to the Level of optimization property Yes Only specified func tions Oinline_level 1 Performs inline expansion at the location calling the function for which pragma inline is specified Yes Auto detect Oinline_level 2 Distinguishes the function that is the tar get of inline expansion automatically and expands it Yes Auto detect without code size increase Oinline_level 3 Distinguishes the function that is the tar get of inline expansion automatically and expands it while minimizing the increase in code size No Oinline_level 0 Suppresses all inline expansion including the function for which pragma inline is specified Maximum increasing rate of inline expan sion size R20UT3284EJ0101 Rev 1 01 Aug 01 2015 Specify the maximum increasing rate of the code size up to which inline expan sion is performed Example When 100 is specified inline expansion wi
264. tes the selected characters Select All While editing the value of the property selects all the characters of the selected property Reset to Default Restores the configuration of the selected item to the default configuration of the project For the Individual Compile Options tab and Individual Assemble Options tab restores to the configuration of the general option Reset All to Default R20UT3284EJ0101 Rev 1 01 Aug 01 2015 Restores all the configuration of the current tab to the default configuration of the project For the Individual Compile Options tab and Individual Assemble Options tab restores to the configuration of the general option ztENESAS Page 54 of 204 CS A WINDOW REFERENCE Common Options tab This tab shows the detailed information on the build tool categorized by the following and the configuration can be changed Build Mode CPU Output File Type and Path Frequently Used Options for Compile Frequently Used Options for Assemble Frequently Used Options for Link Frequently Used Options for Hex Output Frequently Used Options for Create Library Error Output Warning Message Device 2 Build Method 3 Version Select 4 Notes 0 r rrrvrrvrwvrn a 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 cha
265. the CS integrated development environment for developing applications and sys tems for RL78 family and provides an outline of its features CS is an integrated development environment IDE for RL78 family integrating the necessary tools for the develop ment phase of software e g design implementation and debugging into a single platform By providing an integrated environment it is possible to perform all development using just this product without the need to use many different tools separately Readers Purpose Organization How to Read This Manual Conventions This manual is intended for users who wish to understand the functions of the CS and design software and hardware application systems This manual is intended to give users an understanding of the functions of the CS to use for reference in developing the hardware or software of systems using these devices This manual can be broadly divided into the following units 1 GENERAL 2 FUNCTIONS A WINDOW REFERENCE It is assumed that the readers of this manual have general knowledge of electricity logic circuits and microcontrollers Data significance Higher digits on the left and lower digits on the right Active low representation XXX overscore over pin or signal name Note Footnote for item marked with Note in the text Caution Information requiring particular attention Remarks Supplementary information Numeric representation Decimal XXXX He
266. the configuration can be changed R20UT3284EJ0101 Rev 1 01 ztENESAS Page 185 of 204 Aug 01 2015 CS A WINDOW REFERENCE Commands executed Specify the command to be executed before assemble processing before assemble Use the call instruction to specify a batch file example call a bat processing The following placeholders are supported ActiveProjectDir Replaces with the absolute path of the active project folder ActiveProjectName Replaces with the active project name AssembledFile Replaces with the absolute path of the output file under assembling BuildModeName Replaces with the build mode name nputFile Replaces with the absolute path of the file to be assembled 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 descri
267. the drop down list Restriction Yes Checking the device file Updates the I O header file when the device file has been updated at build Yes Checking the property Updates the I O header file when the properties have been updated at build Yes Checking the device file and the property Updates the I O header file when the device file or proper ties have been updated at build No Does not update the I O header file at build R20UT3284EJ0101 Rev 1 01 Aug 01 2015 ztENESAS Page 152 of 204 CS Device file on generat ing I O header file A WINDOW REFERENCE The file name and version of the device file when the I O header file was generated are displayed Note that this property is displayed only when a choice other than No was made in the Update I O header file on build property Default The file name and version of the device file when the I O header file was generated How to change Changes not allowed Current device file The file name and version of the device file which is installed in the running CS envi ronment are displayed Note that this property is displayed only when a choice other than No was made in the Update I O header file on build property Default Current device file How to change Changes not allowed Output 1bit access Select whether to output the 1 bit macro definition for IOR access in the I
268. the extension replaced by lbp Remark See CC RL Compiler User s Manual for details about the library list file R20UT3284EJ0101 Rev 1 01 ztENESAS Page 18 of 204 Aug 01 2015 CS 2 FUNCTIONS 2 5 Set Compile Options To set options for the compile phase select the Build tool node on the project tree and select the Compile Options tab on the Property panel You can set the various compile options by setting the necessary properties in this tab Figure 2 18 Property Panel Compile Options Tab a le Add ae information Yeal g Enhance debug information with optimization Yasla line Optimization Level of optimization Perfor the default optimization Mone Optimization Details aximum number of hoop esopaingions Remove unused static functions YealTo adjust the level of optimization Mone Perform inking expansion YeelTo adjust the level of optimization Mone Use br instruction to call a function at the end of the function YeelTo adjust the level of optimization Mone Perfonm inter modube optimization No Perform optimization considering type of data indicated by pointer Mo Outputs additional information for inter module optimization Ho Create subroutine for same instruction sequence Ho Preprocess Additional include paths Additional ncdude paths 0 System inchide paths Syetem include paths 0 b Include files at head of compiling units lndude fies at head of compiling unie 0 gt Macro definition Macro
269. 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 system include path is searched with lower priority than the additional include path The reference point of the path is the project folder This corresponds to the I option of the ccrl command The include path is displayed as the subproperty Default System include paths number of defined items How to Edit by the System Include Path Order dialog box which appears change when clicking the button Restriction Changes not allowed Only the specified order of the include paths can be changed Macro definition Specify the name of the macro to be defined Specify in the format of macro name defined value with one macro name per line The defined value part can be omitted and in this case 1 is used as the defined value This corresponds to the asmopt define option of the ccrl command The specified macro is displayed as the subproperty Default Macro definition number of defined items How to Edit by the Text Edit dialog box which appears when clicking the change butt
270. the name of the macro to be defined Specify in the format of macro name defined value with one macro name per line The defined value part can be omitted and in this case 1 is used as the defined value This corresponds to the D option of the ccrl command The specified macro is displayed as the subproperty Default Macro definition number of defined items How to Edit by the Text Edit dialog box which appears when clicking the change button For the subproperty you can enter directly in the text box Restriction Up to 256 characters Up to 256 items can be specified 5 Frequently Used Options for Assemble The detailed information on frequently used options during assembling is displayed and the configuration can be changed Additional include Specify the additional include paths during assembling paths 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
271. the standard and additional include paths file Default Re compile assemble the source file How to Select from the drop down list change Restriction Re compile assemble the Recompiles assembles the source source file file if it includes a file that is not found Ignore re compiling assembling Does not recompile assemble the the source file source file even if it includes a file that is not found 13 Version Select The detailed information on the build tool version is displayed and the configuration can be changed Using compiler pack The folder in which the compiler package to be used is installed is displayed age install folder Default Install folder name How to Changes not allowed change R20UT3284EJ0101 Rev 1 01 ztENESAS Page 70 of 204 Aug 01 2015 CS A WINDOW REFERENCE Using compiler pack Select the version of the compiler package to be used age version This setting is common to all the build modes Default Always latest version which was installed How to Select from the drop down list change Restriction Always latest version Uses the latest version in the installed which was installed compiler packages Versions of the installed Uses the selected version in the compiler compiler packages package Latest compiler pack The version of the compiler package to be used when Always latest version which age version which was was insta
272. timizes external variables that are not volatile qualified R20UT3284EJ0101 Rev 1 01 ztENESAS Page 167 of 204 Aug 01 2015 CS Output code of switch statement A WINDOW REFERENCE Select the code output mode for switch statements in programs This corresponds to the switch option of the ccrl command Default Configuration of the compile option How to change Select from the drop down list Restriction R20UT3284EJ0101 Rev 1 01 Aug 01 2015 Auto None The ccrl selects the optimum output format if else switch ife Ise Outputs the switch statements in the same for mat as the if else statement along a string of case statements in programs Select this item if the case statements are written in the order of frequency or if only a few labels are used Because the case statements are compared starting from the top unnecessary compari son can be reduced and the execution speed can be increased if the case statement that most often matches is written first Binary search switch binary Outputs the code in the binary search format for switch statements in programs Searches for a matching case statement by using a binary search algorithm If this item is selected when many labels are used any case statement can be found at almost the same speed Table jump abso lute switch abs_table Outputs the code in the table jump format absolute branch for switch statements
273. tion Up to 1023 characters Up to 64 items can be specified Other additional Input the compile option to be added additionally options The options set here are added at the end of the compile options group Default Configuration of the compile option How to Directly enter in the text box or edit by the Character String Input dia change log box which appears when clicking the button Restriction Up to 259 characters R20UT3284EJ0101 Rev 1 01 ztENESAS Page 178 of 204 Aug 01 2015 CS A WINDOW REFERENCE Individual Assemble Options tab This tab shows the detailed information on an assemble source file categorized by the following and the configuration can be changed Note that this tab takes over the settings of the Common Options tab Compile Options tab and Assemble Options tab When the settings are changed from these tabs the properties are displayed in boldface 1 Debug Information 2 Optimization 3 Preprocess 4 Character Encoding 5 Output File 6 Assemble List 7 Error Output 8 Warning Message 9 Others fas This tab is displayed only when Yes in the Set individual assemble option property in the Build category from the Build Settings tab is selected A 14 Property Panel Individual Assemble Options Tab Add debug information Outputs additional information for inter medule optimization Preprocess Une
274. tion file MISRA C rule file This property is usable only in the Professional Edition The following placeholders are supported BuildModeName Replaces with the build mode name MicomToolPath Replaces with the absolute path of the install folder of this product ProjectName Replaces with the project name This corresponds to the misra20XX option of the ccrl command This property is displayed only when Apply rules that are described in the specified file misra20XX lt file name gt in the Apply rule property is selected Default Configuration of the compile option How to Directly enter in the text box or edit by the Specify MISRA C Rule File change dialog box which appears when clicking the button Restriction Up to 259 characters R20UT3284EJ0101 Rev 1 01 tENESAS Page 172 of 204 Aug 01 2015 CS A WINDOW REFERENCE Rule number Specify the rule number to be checked This property is usable only in the Professional Edition Specify at least one rule number in decimal This corresponds to the misra20XX option of the ccrl command This property is displayed only when Apply specified rule number misra20XX apply in the Apply rule property is selected Default Configuration of the compile option How to Directly enter in the text box or edit by the Specify Rule Number dia change log box which appears when clicking the button Restriction Up to 259 characters
275. ts a C source program as a comment to the assembly source file No Does not output a C source program as a comment to the assembly source file Merge string literals When the same string literals exist in the source file specify whether to merge them and allocate to the one area This corresponds to the merge_string option of the ccrl command Default Configuration of the compile option How to Select from the drop down list change Restriction Yes merge_string Merges the same string literals exist in the source file and allocates to the one area No Each allocates the same string literals exist in the source file to separate areas 9 Output File The detailed information on output files is displayed and the configuration can be changed Object file name Specify the name of the object file generated after compilation The extension other than obj cannot be specified If the extension is omitted obj is automatically added If this is blank the file name will be the source file name with the extension replaced by obj This corresponds to the o option of the ccrl command Default Blank How to Directly enter in the text box change Restriction Up to 259 characters Output assembly Select whether to output the assembly source file of the compile result for the C source file source This corresponds to the asm_path option of the ccrl command Default
276. ty and a rule number is specified in the Exclusion rule number from required rule property When Apply rules that are described in the specified file is selected in the Apply rule property and a rule number description file is specified in the Rule number description file property Default No How to Select from the drop down list change Restriction Yes Enables MISRA C rule check and out check_language_extension puts messages when the rule check is partially suppressed by the unique lan guage specifications extended from the C language standard Disables MISRA C rule check is dis abled which are partially suppressed by the extended language specifica tions 13 Others Other detailed information on compilation is displayed and the configuration can be changed R20UT3284EJ0101 Rev 1 01 ztENESAS Page 95 of 204 Aug 01 2015 CS A WINDOW REFERENCE Use support for porting Select whether to use support for porting from other compilers from other compiler This corresponds to the convert_cc option of the ccrl command This property is displayed 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 01 00 or higher or when V1 01 00 or higher is selected in the Using compiler package version property Default No None How to Selec
277. ty is selected Default Configuration of the compile option How to Directly enter in the text box change Restriction 0 to 65535 decimal number The detailed information on C language is displayed and the configuration can be changed Compile strictly according to ANSI standards Select whether to process as making C source program comply strictly with the ANSI standard and output an error or warning for a specification that violates the standard This corresponds to the ansi option of the ccrl command Default Configuration of the compile option How to Select from the drop down list change Restriction Yes ansi Processes as making C source program comply strictly with the ANSI standard and outputs an error or warning for a specification that violates the stan dard Compatibility with the conventional C language spec ifications is conferred and processing continues after warning is output Check function with out prototype declara tion Select whether to generate an error when using a function whose prototype declara tion was not made in advance or a function without a prototype declaration This corresponds to the refs_without_declaration option of the ccrl command Default Configuration of the compile option How to Select from the drop down list change Restriction Yes Checks functions without prototype refs_without_declaration declarations No Does
278. uration can be changed Additional include Specify the additional include paths during assembling paths 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 specified include path is searched with higher priority than the standard include file folder of CC RL The reference point of the path is the project folder When this property is omitted only the standard folder of CC RL is searched This corresponds to the I option of the ccrl command The specified include path is displayed as the subproperty When the include path is added to the project tree the path is added to the top of the subproperties Uppercase characters and lowercase characters are not distinguished for the include paths Default Additional include paths number of defined items How to Edit by the Path
279. uts a user library file R20UT3284EJ0101 Rev 1 01 ztENESAS Page 41 of 204 Aug 01 2015 CS 2 FUNCTIONS Format Configuration System libraries FOrm Library S Outputs a system library file The system library file is linked after the user library file Select this item to create a library that is to be linked after the user library file Relocatable file FOrm Relocate Outputs a relocatable file 2 Set the output folder Setting the output folder is made with the Output folder property by directly entering to the text box or by the button Up to 247 characters can be specified in the text box This property supports the following placeholder 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 BuildModeName is set by default 3 Set the output file name Setting the output file is
280. v 1 01 Aug 01 2015 7tENESAS Page 140 of 204 CS A WINDOW REFERENCE 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 4 Debug information Delete local epodol name ir onmator Input File Object ile Output File Duput Fle Format User libraree FOm Library U Cuitput Folder SBuildModeName s Quilpul fle name SP ropecthameY fib Library Using libraries Uang librases 0 gt Syehem beaters System libranes 0 Use clandadmathemeical libraies Me Use iuriline lisvaties No List Message gt Dthers Delete local symbol name informa Select whether to delete local symbol name infomation This option cor sponds to the Hide option ol Ihe link command Common Compile Assembll A Create L 1 0 Head Description of each category 1 Debug Information The detailed information on debug information is displayed and the configuration can be changed Output debug informa Select whether to output debug information tion This corresponds to the DEBug and NODEBug options of the rlink command This property is displayed only when
281. vailable memory in the PC used No MEMory High Executes the same processing as usual R20UT3284EJ0101 Rev 1 01 ztENESAS Page 127 of 204 Aug 01 2015 CS A WINDOW REFERENCE 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 Default No How to Select from the drop down list change Restriction Yes Total_size Displays the total size of sections after the linking No Does not display the total size of sections after the linking Display copyright infor mation Select whether to display copyright information This corresponds to the LOgo and NOLOgo options of the rlink command Default No NOLOgo How to Select from the drop down list change Restriction Yes Displays copyright information No NOLOgo Suppresses the output of copyright informa tion Commands executed before link processing Specify the command to be executed before link 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 LinkedFile Replaces with the absolute path of the output file under link pro cessing M
282. verlaid sections to use the overlaid section selection function Select the build tool node on the project tree and select the Link Options tab on the Property panel a Set ROM to RAM mapped sections Setting the ROM to RAM mapped sections is made with the ROM to RAM mapped section property in the Section category This reserves the RAM section with the same size as that of the ROM section and relocates the symbols defined in the ROM section to addresses in the RAM section Figure 2 38 ROM to RAM mapped section Property 4 Secon Sarian siani atinan zona bad date sdata 1ed as daak bas ROMI to RAM siti deta daiaR sdala sdeteA If you click the button the Text Edit dialog box will open R20UT3284EJ0101 Rev 1 01 2tENESAS Page 28 of 204 Aug 01 2015 CS 2 FUNCTIONS Figure 2 39 Text Edit Dialog Box Tet Edt Treat da dsa sisas sisaf det usaie te erR Enter the section name in Text in the format of ROM section name RAM section name with one section name per line You can specify up to 32767 characters per line up to 65535 lines If you click the OK button the entered section names are displayed as subproperties Figure 2 40 ROM to RAM mapped section Property After Setting Sections 4 Secon Secton start address Jonna bet daia adata tedi conei TAM detaR bea ac bo Section lhal outputs etemal defined symbals bo the hle Sedin that oulputs ademal defined eymbole ta the Mell R
283. when the selected sell is blank Moves up the selected section However if the column above the selected section is blank no move can be made Input in advance a section name to the above column Note that this button is disabled when an address is selected or a blank section col umn is selected Moves down the selected section However if the column below the selected section is blank no move can be made Input in advance a section name to the column below Note that this button is disabled when an address is selected or a blank section col umn is selected Opens the Select Import File dialog box Acquires the section settings from the file specified in the dialog box and updates this area to reflect the acquired settings Opens the Select Export File dialog box Outputs the contents of this area to the file specified in the dialog box R20UT3284EJ0101 Rev 1 01 Aug 01 2015 RENESAS Page 193 of 204 CS A WINDOW REFERENCE Function buttons Button Function OK Reflects the specified section to the text box that opened this dialog box and closes this dialog box Cancel Cancels the settings and closes this dialog box Help Displays the help of this dialog box R20UT3284EJ0101 Rev 1 01 ztENESAS Page 194 of 204 Aug 01 2015 CS A WINDOW REFERENCE Add Section dialog box Modify Section dialog box Add Overlay dialog box These dialog boxes are used to set a se
284. wn list change Restriction User libraries Outputs a user library file FOrm Library U System libraries Outputs a system library file FOrm Library S Relocatable file FOrm Relo Outputs a relocatable file cate R20UT3284EJ0101 Rev 1 01 ztENESAS Page 143 of 204 Aug 01 2015 CS A WINDOW REFERENCE 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 Directly enter in the text box or edit by the Browse For Folder dialog change box which appears when clicking the button Restriction Up to 247 characters Output file name S
285. xFFFF Suffix format FFFFH This corresponds to the asmopt base_number option of the ccrl command Default Prefix format None How to change Select from the drop down list Restriction Prefix format None Handles numerical constants in the Prefix format Suffix format asmopt base_number suffix Handles numerical constants in the Suffix format The detailed information on the assemble list is displayed and the configuration can be changed Output assemble list file R20UT3284EJ0101 Rev 1 01 Aug 01 2015 Select whether to output the assemble list file This corresponds to the asmopt prn_path option of the ccrl command Default No How to change Select from the drop down list Restriction Yes asmopt prn_path Outputs the assemble list file No 2tENESAS Does not output the assemble list file Page 101 of 204 CS A WINDOW REFERENCE Output folder for Specify the folder which the assemble list file is output assemble list file The assemble list file is output under the source file name with the extension replaced by prn If a relative path is specified the reference point of the path is the main project or sub project 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
286. xadecimal OxXXXXX All trademarks or registered trademarks in this document are the property of their respective owners 1 2 TABLE OF CONTENTS GENERAL s sineja ans CRM h Bier ho ths a hte he BIE oh 2 nc tore uO GAGA esta a 6 1 1 OVEIVIEW 2 50 4 Pegi Avene td cis ohn Gaede 2 ae diet a Ok Sune ea ater nies aA Tare eee rg ti bette r 6 1 2 Features site s aie Mie lias eek teh o a ak eee eta d ek dn a saad aA ars oh eae 6 FUNCTIONS aso cs dd th ae R aa ees wer ee a EE dn tetra a ae aaa EAA EAE de Ta ee E ace eae 7 2 1 OVERVIEWS costiconma shared mathe We ese O A deedca land e lane oet aioacoteun a A ahaa a ea e a EE tee 7 2 1 1 Greate a load Module riypi sed ew Kedlwieed Yakov cite veces via Ae ee we eka bake 7 2 1 2 Greate auser library sui toari hike M4 Beet Sees bbe a aa Oe feeb i alent tad 8 2 2 Convert a CA78KOR project into a CC RL project 0 0 ete eee 9 2 3 Speeding up of Build o ou e e rere eeen e teen eens 12 2 3 1 Running simultaneous build 1 0 tenets 12 2 3 2 Running parallel p ildii nA srani eae a ek beac aa Olt iat pede aad ba ek ee oe 13 2 4 Set the Type of the Output File 2 2 2 cc tte 14 2 4 1 Change the output file name 2 2 aeaaaee 14 2 4 2 Output an assemble list 4 sca see ee de ee Se eb ee ae eee 16 2 4 3 OutputmMapiintormMation soss ose as ek eels Peas Seca a boosts Sey Bag Soe MDW enw E Een ie BRS ee Sees 16 2 4 4 Outputilibrary inforMationve i 456 deed eye dd ees Gece rec We P
287. y 1 Debug Information VO Header Fi The detailed information on debug information is displayed and the configuration can be changed Add debug information Select whether to generate the debug information It is possible to perform source debugging with the debugger by outputting information for source debugging to the output file This corresponds to the g option of the ccrl command Default Yes g change How to Select from the drop down list Restriction Yes g Generates the debug information No 2 Optimization Does not generate the debug information The detailed information on the optimization is displayed and the configuration can be changed R20UT3284EJ0101 Rev 1 01 ztENESAS Page 98 of 204 Aug 01 2015 CS A WINDOW REFERENCE Outputs additional Select whether to output additional information for inter module optimization information for inter At linkage inter module optimization is applied to files for which this option has been module optimization specified This corresponds to the goptimize option of the ccrl command Default No How to Select from the drop down list change Restriction Yes goptimize Outputs additional information for inter module optimization No Does not outputs additional information for inter module optimization 3 Preprocess The detailed information on preprocessing is displayed and the config
288. y Model C Language Character Encoding Output Code 0 Output File 1 Assemble List 2 MISRA C Rule Check 3 P 2 3 4 5 6 7 8 9 1 P P 13 Others Figure A 3 Property Panel Compile Options Tab Add debug information Optimization Level of optimization Maximum number of boop eopaingions Remove unused static functions Parfonm inline expansion Use br instruction to call a function at the end of the function Perform inter module optimization Yeal g Yaalg ine YealTo adjust the lawal of optimization Mona YealTo adjuat the laval of optimization None Yea To adjust the level of optimization Nana No Perform optimization considering type of data indicated by pointer Mo Outputs additional information for inter medule optimization Create subroutine for sama instruction sequence Prepress Additional include paths System include paths Include files at head of compiling units Macro definition Macro undefinition Quality Improvement Detect stack overilow Memory Model C Language MISRA C Rule Check T FFF FFY Add debug information Mo Mo Additional mclude paths 0 Syatam indude paths 0 lndlude fles at head of compiling unie I Macro defin ion 0 Macro undefinition O NolNone Species whether to generale the debug information Such information is generated when debugging a program just like the case of wishing to
289. zation is displayed and the configuration can be changed Maximum number of Specify the maximum number of times to expand the loops such as for and while loop expansions If O or 1 is specified expansion is suppressed If this is blank it is assumed that 2 has been specified This corresponds to the Ounroll option of the ccrl command This property is displayed only when Perform the default optimization None Code size precedence Osize or Speed precedence Ospeed in the Level of optimiza tion property is selected Default Blank How to Directly enter in the text box change Restriction 0 to 999 decimal number or blank Remove unused static Select whether to remove the static functions which are not called functions This corresponds to the Odelete_static_func option of the ccrl command Default Yes To adjust the level of optimization None How to Select from the drop down list change Restriction Yes To adjust the level of Performs optimization according to the optimization None Level of optimization property Yes Removes the unused static functions Odelete_static_func which are not called No Does not remove the unused static func Odelete_static_func off tions which are not called R20UT3284EJ0101 Rev 1 01 ztENESAS Page 77 of 204 Aug 01 2015 CS Perform inline expan sion A WINDOW REFERENCE Specify whether to perform inline expansion a

CS+ Integrated Development Environment User`s Manual: CC

Contents

Download Pdf Manuals

Related Search

Related Contents