CS+ RX Compiler CC
Contents
1. Microcontroller Options cpu Optimize Library File Purposes rtti 3 Options endian Others exception noexception For the RX600 Optimization speed rx6001q lib type Speed goptimize Little endian _round nearest endian little For the RX600 denormalize off Optimization size rx600Is lib type Size Pa dbl_size 4 goptimize Little endian cpu rx600 Lunsigned_char For the RX600 rtti on Lunsigned_bitfield Optimization speed exception bit_order right rx600bq lib type Speed o ype spee goptimize unpack Big endian endianzbig fint_register 0 For the RX600 branch 24 Optimization size rx600bs lib 1a type Size goptimize Big endian Table 6 1 Library Files Notes 1 For details on microcontroller options please see the Microcontroller Options columns of the 1 Compile Options of section B 1 3 Options in the Integrated Development Environment User s Manual RX Build 2 These option selections are same from the each default of them R20UT3552EJ0100 Rev 1 00 Sep 01 2015 RENESAS Page 13 of 14 CS RX Family Compiler CC RX V2 04 00 6 2 Using the library files Copy the library file s included in the package from lib directory into a desired directory Then specify one of the copied library files for the Library option and start the linkage processing All trademarks and registered trademarks are the property of their r2. j Omitted __ Sfrexp__tm__2_f__F2Z12ZPi_0Q2_21_Real_type__tm__4_2125_Type Tides BRA L11 Calls itself gt infinity loop Countermeasures Select one of the following ways to avoid the problem 1 Compile the program with the lang c or lang c99 option 2 Change int or int into long or long 3 Append the following declarations to each function that is being used For the frexp function static inline double frexp double x int y long v y double d frexp x amp v y v return d For the Idexp function static inline double Idexp double x int y long v y double d Idexp x v return d For the scalbn function static inline double scalon double x int y long v y double d scalbn x v return d For the remquo function static inline double remquo double x double y int z long v z double d remquo x y amp v z v return d Example of 2 Change in file cpp include lt math h gt R20UT3552EJ0100 Rev 1 00 Page 9 of 14 Sep 01 2015 RENESAS CS RX Family Compiler CC RX V2 04 00 double dl1 d2 int ij void func void long x i Accept as long type temporary d2 frexp dl amp x Call with long type argument i x Set the result for variable i Example of 3 Change in file cpp include lt math h gt Append declaration static inline double frexp double x int y lon
3. 2 Note on using MVTC or POPC instructions Assembler In the assembly language the program counter PC cannot be specified for MVTC or POPC instructions 4 3 Note on the delete option for linkage Optimizing linkage editor When a function symbol is removed by the delete option its following function in the source program is not allowed to have a breakpoint at its function name on the editor in your debugging If you would like to set a breakpointvia the Label window at the function entrance set the breakpoint via the Label window or at the program code of the function R20UT3552EJ0100 Rev 1 00 Page 7 of 14 Sep 01 2015 RENESAS CS RX Family Compiler CC RX V2 04 00 Chapter 5 Restrictions This chapter describes restrictions on CC RX 5 1 Options for compilers and other subsystems in the help system for the CS integrated environment In the CS help system refer to Compiler for the RX the CC RX environment rather than Build for details of the command line options for the CC RX ccrx C C compiler the assembler asrx the optimizing linkage editor rlink and the library generator lbgrx The descriptions under Build are very similar to those under Compiler but are for V2 02 00 5 2 Restriction on usage of math h functions frexp Idex scalbn and remquo in C language including EC An object is generated which will be an infinit loop at execution when the actual argument of some function f
4. 2rPENESAS CS RX Compiler CC RX V2 04 00 R20UT3552EJ0100 Rev 1 00 Release Notes Sep 01 2015 Contents Chapter 1 Target Devices 0 0 eccceeecceceeeceeaeeeeeeeceeeeeeaae sence seaeeecaaeeseaaeseaeecaaeeseaaeseeaeeseeeesaeseeaaeseeneeeeneess 2 Chapter 2 Keywords When Uninstalling the Product cc ccceecceeeeeeeeeeeeeeeeeceaeeeeaaeeeeneeseaeeesaeeesaeeeneees 3 Chapter 3 CHhAnQe S pecs dcadcteacineaes leshasdcoctevuslevdsscgechentuat cased dacdgesuclsaasatgectssraateslalsecsareecdh plakdennaigiieee 4 3 1 Standard and Professional editions cccceccccessseceeeesneeeeeesneeeceesaeeeeeeaeeeeeeaeeeeeeaeeeeesseeeessseeeenees 4 3 2 Checking of source code against MISRA C 2004 rules Professional cccscecseeesseeeeteeeeeeees 4 3 3 Checking of source code against MISRA C 2012 rules Professional cc cccseecesseeeeseeeeenees 4 3 4 Detection of stack smashing Professional ccceeeseseeeeeeeeeeeeeeeeeeeeeeeneeeeeeeeeeeeeseneeeeeseneaeeeeeeeaeees 4 3 5 Extensions to CRC Calculation ccccccccccccessescecesseeeeeecsneeeeessneeeeesceeesesensaeesseneeeessensaeeeseeeaeessensaeess 5 8 6 Enhanced support tor UTF Gissar EE 6 3 7 OUSHIMPOVEMENIS s4seecced vectitd stewart nected seenavtanentthl aa aie setae aaan na a aea aeea 6 Chapter 4 Points for Caution tisecsciiaeracccniiteactietaancuantecccateceantluitacecdartaancdditaavvdancaautiitaasiidhtaanteteancntaanedeil 7 4 1 Note on a case of th
5. 8 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 9 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 relating 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 10 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
6. Electronics assumes no responsibility for any losses incurred by you or third parties as a result of unauthorized use of Renesas Electronics products 11 This document may not be reproduced or duplicated in any form in whole or in part without prior written consent of Renesas Electronics 12 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 tENESAS SALES OFFICES Renesas Electronics Corporation http www 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 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 D sseldorf Germany Tel 49 211 6503 0 Fax 49 211 6503 1327
7. 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 i 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 9510 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 5 0
8. agma no_stack_protector This feature generates the codes which detect stack smashing at the entry and end points of functions Specifically instructions to execute the following three processes are produced 1 4 byte immediately before upper direction the local variable area of the stack frame are allocated at the entrance to the function and the values specified as arguments are stored there 2 A check is run on whether the value which was stored in step 1 has not been changed at the end of R20UT3552EJ0100 Rev 1 00 Page 4 of 14 Sep 01 2015 RENESAS CS RX Family Compiler CC RX V2 04 00 the function 3 The __stack_chk_fail function is called when the value has been changed which would lead to smashing the stack The __ stack_chk_fail function is defined by user and describes the processing to be executed when stack smashing is detected For example the __stack_chk_fail function will be executed when the following code which smashes the stack area is executed void f1 volatile char str 10 int i for i 0 i lt 10 i str i i The stack is smashed when i 10 Figure 3 1 Example of code that will lead to the __ stack_chk_fail function being called 3 5 Extensions to CRC calculation The CRC option of the optimizing linkage editor has been extended as follows The range for calculation can be specified by a section name Various methods of calculation have been added The methods added in this
9. andard and Professional editions The CC RX complier has the following two editions Standard edition Professional edition The features of the latter can only be used if the compiler is registered under the professional license They are indicated as Professional from here on 3 2 Checking of source code against MISRA C 2004 rules Professional The following options can only be used if the compiler is registered under the professional license misra2004 ignore_files_misra check_language_extension 3 3 Checking of source code against MISRA C 2012 rules Professional A misra2012 option which selects the checking of source code against the MISRA C 2012 rules has been added An ignore_files_misra option for the selection of files that are not to be checked and a check_language_extension option which enables the source code checking which are partially suppressed by language extensions are specifiable at the same time as each other and misra2012 Note that the misra2012 and misra2004 options cannot be specified at the same time Specifying these options to statically check source code makes improving the quality of user programs in early stages possible 3 4 Detection of stack smashing Professional A feature for the detection of stack smashing has been added This feature can be realized by the stack_protector stack_protector_all compiler options or the extended language specification pragma stack_protector pr
10. d body of a loop statement e g for while or do written as a single line The values of members of union type and of dummy variables that are to be passed via registers may be displayed incorrectly e g in the Watch window 5 6 Note on using sections that include the address Oxffffffff in assembler If two or more section directives in the assembly source code contain org directives the sections have the same name and the sections overlap at Oxffffffff the assembler outputs an internal error message C0554098 Example section SS ROMDATA org Offfffffeh byte 1 byte 2 Oxffffffff section SS ROMDATA org Offffffffh byte 3 Oxffffffff end 5 7 Note on using form and output at the same time in the linkage editor When formerel and output lt filename gt are specified for the linkage editor rlink at the same time the filename extension given as lt filename gt is ignored and replaced with rel Example rlink form relocat output DefaultBuild lib_test lib The filename specified for output test lib is changed to test rel 5 8 Note on using function names that begin with _builtin for the C C compiler Declaration of a function with a name that begins with _ builtin and for which the definition is in machine h in the include directory may lead to an internal error In general do not use any names that begin with an underscore _ in your source code since such names are reserved 5 9 N
11. e W0523041 message C C COMPIICL ccceecceceeeeeeteeteeeeeseeeeeaeeseeeteaes 7 4 2 Note on using MVTC or POPC instructions Assembler c ceceeeceeeeeeeeeeeeeeeeeeeeseeeeeaeeseneeeeaes 7 4 3 Note on the delete option for linkage Optimizing linkage editor esseesseesseesseeseeeseeesenssreseeee ene 7 Ghapter 5 REStriCtions wiiiei cases ieshevnesdceseescuckpenadeldsacceckeeata readied deck genuche ddsansectasvaste dary ecdaveqaie adseadebdaandedizeye 8 5 1 Options for compilers and other subsystems in the help system for the CS integrated environment sianie aa a e aa aaa aaea e aaa SOE a Aaaa a aa Ae aaan Eaa 8 5 2 Restriction on usage of math h functions frexp Idex scalbn and remquo in C language including EC FE avin ie Ae ee dee te ns eee es eee eee ede 8 5 3 Restriction of PIC PID function pic and pid options c ccceeeeeeeceeeeeeeeeeeeeeaeeeeeeeseeeeseaeeneneeeeaes 10 5 4 Eliminated options for the C C compiler 2 2 ceceeceeeeeceeeeeeeaeeeeeeeeeeeeeseaeeesaaeseeneeseeeesaeeteaeeeeaes 10 5 5 Notes on C C source level debugging for the C C compiler eeeeeeeeeeeeeeeeeeeeeeteeteeeteees 10 5 6 Note on using sections that include the address Oxffffffff in assembler ee eeeeeeeeeeeeeeeees 11 5 7 Note on using form and output at the same time in the linkage editor 11 5 8 Note on using function names that begin with _ builtin for the C C compiler 11 5 9 Note on us
12. espective owners R20UT3552EJ0100 Rev 1 00 Page 14 of 14 Sep 01 2015 RENESAS Notice 1 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 2 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 from the information included herein 3 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 4 You should not alter modify copy or otherwise misappropriate any Renesas Electronics product whether in whole or in part Renesas Electronics assume
13. g v y double d frexp x amp v y v return d double dl1 d2 int i void func void d2 frexp dl amp 1i 5 3 Restriction of PIC PID function pic and pid options When a standard library is created by the library generator lbgrx with the pic or pid option specified the following warning may appear once or more W0591301 pic option ignored When the pic option has been specified W0591301 pid option ignored When the pid option has been specified Despite the warning the created standard library has no problems 5 4 Eliminated options for the C C compiler a file_inline file_inline_path Specifying these options has no effect and the compiler will output a warning Instead of file_inline or file_inline_path write include in the source code b enable_register This option is simply ignored and does not affect the generated code 5 5 Notes on C C source level debugging for the C C compiler 1 Even when debug is specified you may not be able to set a breakpoint or stop stepped execution on lines that R20UT3552EJ0100 Rev 1 00 Page 10 of 14 Sep 01 2015 RENESAS CS RX Family Compiler CC RX V2 04 00 contain a dynamic initialization expression for a global variable in C are the first lines of functions that begin with a loop statement e g do or while and do not have an auto variable or of functions for which pragma inline_asm has been specified or contain the control section an
14. handled as encoded in UTF 8 3 7 Other improvements Other improvements are described below a Improved debugging information Unnecessary debugging information was deleted to reduce the sizes of object files obj and load module files abs b Fixed incorrect display when stepping When stepping over an if statement and it has a condition expression including any of the operators below the debugger displayed an incorrect result The problem has been fiexed amp amp c Internal errors Some of internal errors has been fixed d Optimization The performance and the size of generated code have been improved e Compiling time Compiling some programs with optimization took excessive time This problem has been relieved by shortening the times R20UT3552EJ0100 Rev 1 00 Page 6 of 14 Sep 01 2015 RENESAS CS RX Family Compiler CC RX V2 04 00 Chapter 4 Points for Caution This section describes points for caution regarding CC RX 4 1 Note on a case of the W0523041 message C C compiler When the int_to_short option is specified and a file including a C standard header is compiled as C or EC the compiler may show the W0523041 message In this case simply ignore the message because there are no problems NOTE In compilation of C or EC the int_to_short option will be invalid Data that are shared between C and C EC program must be declared as the long or short type rather than as the int type 4
15. ing pragma interrupt with functions for which save_acc is enabled and that have dummy arguments for the C C compiler cceeceeeeeeeeeeeeeeeee eae eeeeae scenes seaeeeeaaeeeeaeeseneeescaeeesaeeeeeeeee 11 Chapter 6 Standard Libraries INCIUGGC ccccceeececeeeeeeeeeceeeeeceeeeecaaeeeeaeeseeeeeseaeeesaaeeceeeeseaeessaeeseaeeseaes 13 eT IRAN Y TINGS wo 352 cahs ecg secede ceca E a ego adian eae fede cesarean wee cees 13 6 2 Usingi the library Mes nni EE RES 14 R20UT3552EJ0100 Rev 1 00 Page 1 of 14 Sep 01 2015 RENESAS CS RX Family Compiler CC RX V2 04 00 Chapter 1 Target Devices The target devices supported by the CC RX are listed on the Website Please see the URL below CS Product Page http www renesas com cs R20UT3552EJ0100 Rev 1 00 Sep 01 2015 RENESAS Page 2 of 14 CS RX Family Compiler CC RX V2 04 00 Chapter 2 Keywords When Uninstalling the Product There are two ways to uninstall this product e Use the integrated uninstaller uninstalls all CS components e Use the Windows uninstaller only uninstalls this product To use the Windows uninstaller select the following from the Control Panel e Add Remove Programs Windows XP e Programs and Features Windows Vista Windows 7 Then select CS CC RX V2 04 00 R20UT3552EJ0100 Rev 1 00 Page 3 of 14 Sep 01 2015 RENESAS CS RX Family Compiler CC RX V2 04 00 Chapter 3 Changes This section describes changes to the CC RX 3 1 St
16. ng from the use of any Renesas Electronics product for which the product is not intended by Renesas Electronics 6 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 7 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 Renesas 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
17. ote on using pragma interrupt with functions for which save_acc is R20UT3552EJ0100 Rev 1 00 Page 11 of 14 Sep 01 2015 RENESAS CS RX Family Compiler CC RX V2 04 00 enabled and that have dummy arguments for the C C compiler When pragma interrupt is specified for a function and the save_acc flag is enabled including where this is done by using the save_acc compiler option the compiler may not output code that reflects the correct values of dummy arguments which are passed via R4 Note In general we do not recommend defining arguments for functions with the pragma interrupt specification R20UT3552EJ0100 Rev 1 00 Page 12 of 14 Sep 01 2015 RENESAS CS RX Family Compiler CC RX V2 04 00 Chapter 6 Standard Libraries Included This chapter describes restrictions on standard libraries included in RX Family C C Compiler This compiler package includes four library files lib for the RX600 You can use any of the library files if they correspond to the options that you wish to specify Using these files shortens the time required for building 6 1 Library files Table 6 1 shows the standard library files and compiler options Note The compiler options you specify should be the same as the microcontroller options defined for each of the library files listed in table 6 1 Otherwise these library files are not usable so specify your compiler options in the library generator to generate your own library file
18. rexp Idexp scalon or remquo of math h is int type at compiling C or EC program Conditions This problem occurs when both 1 and 2 are satisfied 1 This program is in C or the lang cpp option is effective 2 math h is included and any of the following functions is called a frexp double long with int type second argument except when the first argument is float type and the dbl_size 8 option is effective b Idexp double long with int type second argument except when the first argument is float type and the dbl_size 8 option is effective c scalbn double long with int type second argument except when the first argument is float type and the dbl_size 8 option is effective d remquo double double long with int type third argument except when the both the first and second arguments are float type and the dbl_size 8 option is effective Examples file cpp Example of compiling C source that generates an infinity loop include lt math h gt double dl1 d2 R20UT3552EJ0100 Rev 1 00 Page 8 of 14 Sep 01 2015 RENESAS CS RX Family Compiler CC RX V2 04 00 int i void func void d2 frexp dl amp i Command Line ccrx cpu rx600 output sre file cpp file src Example of the generated assembly program _func j Omitted Calling substitute function of frexp BSR __Sfrexp__tm__2_f_ _FZ1ZPi_0Q2_ 21 Real_type__tm__4_Z1Z5_Type
19. s no responsibility for any losses incurred by you or third parties arising from such alteration modification copy or otherwise misappropriation of Renesas Electronics product 5 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 Electronics 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 arisi
20. version are listed in table 3 1 Table 3 1 Methods of CRC calculation added in CC RX V2 04 00 Method Description 16 CCITT MBS The result of calculation is obtained by applying CRC 16 CCITT to the input MSB first 16 CCITT The input is a 4 byte unit with little endian The result of calculation is obtained MSB LITTLE 4 by applying CRC 16 CCITT to the input MSB first 16 CCITT The input is a 2 byte unit with little endian The result of calculation is obtained MSB LITTLE 2 by applying CRC 16 CCITT to the input MSB first 16 CCITT LSB The result of calculation is obtained by applying CRC 16 CCITT to the input LSB first SENT MSB The input is 1 byte with the higher and lower order 4 bit units in little endian The result of calculation on the input MSB first is obtained with SENT compliance 32 ETHERNET The result of calculation is obtained by applying CRC 32 ETHERNET to the input The initial value of the result is OxFFFFFFFF and is XOR inverted and the bit order is reversed R20UT3552EJ0100 Rev 1 00 Page 5 of 14 Sep 01 2015 RENESAS CS RX Family Compiler CC RX V2 04 00 3 6 Enhanced support for UTF 8 The following options have been extended or added Extended the utf8 option and outcode utf8 option Those options are now always selectable not only when lang c99 option is also selected Added a new assembler option utf8 String literals and comments in assembly source are
Download Pdf Manuals
Related Search