Home

CS+ V3.02.00 Integrated Development Environment User`s Manual

Contents

1. lt lt Classes categories tree area zw bemphune2 lt T 2s4 3w bampfunclz T ihar shot l cw hemphunci2eT 2s4hort int lt lt Functions variables list area 3w teamplabatest Theoid Varebles w AAA emo Caution CC RX The class information is provided only when C source files are subject to analysis When C source files are subject to analysis see 3 6 When CC RX C Source Files Is Used The acquired information is displayed in the classes categories tree area top and the functions variables list area bot tom When a node on the tree displayed in the classes categories tree area is selected the information of the node e g function names variable names defined in the selected node will be displayed in the functions variables list area You can use the View Setting combo box in the panel control area to classify the items in the classes categories tree into the following five groups Table 2 3 Classification Methods for Tree on Class Member Panel Items of List Description Category group default Classifies and displays classes interfaces and other types Access group Classifies and displays nodes by their access specifiers specified in their classes etc Namespace group Classifies and displays nodes by namespaces in which the class and other elements are defined File group Classifies and displays nodes by the files in which the class and other elements ar
2. H M S Displays the time as hours minutes 0 59 seconds 0 59 Second Displays the time in second units The value is rounded to three decimal places Millisecond Displays the time in millisecond units The value is rounded to three decimal places Microsecond Displays the time in microsecond units The value is rounded to three decimal places Nanosecond Displays the time in nanosecond units The value is rounded to integer number Clock Displays the time in clock units The value is rounded to integer number Note that this item is displayed only when the selected microcontroller supports a time display in units of clock cycles File menu Function List panel dedicated items The File menu for this panel provides the following items and functions Save Function List Data Overwrites the contents of this panel to the previously saved file see 2 14 Save Analysis Information Note that when the file has never been saved or the file is write disabled the same operation is applied as the selection in Save Function List Data As Save Function List Data As Opens the Save As dialog box to newly save the contents of this panel to the spec ified text file see 2 14 Save Analysis Information Print Opens the Windows dialog box to print the contents currently being displayed in this panel R20UT3461EJ0100
3. 3 to the folder specified with Common Options tab gt gt Output File Type and Path category gt gt Intermediate file output folder property on the property panel of the build tool to use Default No Modifying Select from the drop down list Available values Yes When Yes is selected the contents of the Function List panel currently being displayed is output to a file if the Function List panel is not displayed the information acquired from the last trace data is output Thereafter the information acquired from the last trace data is output to the file each time program execution is stopped Note that the file is always overwritten No Does not output the information file for STF Frees memory of host machine when all pan els are closed Select whether to free memory of the host machine when all of the panels provided by the analyze too Function List panel Variable List panel Analysis Chart panel Call Graph panel Class Member panel and Variable Value Changing Chart zoomed in panel are closed Default Yes Modifying Select from the drop down list Available values Yes Frees the memory of the host machine when all panels provided by the analysis tool are closed so that the other CS plug in tools operate stably Note that after memory is freed it may take some time to open a panel of the analysis tool next time Does not free
4. How to open Description of each area Toolbar File menu Call Graph panel dedicated items Edit menu Call Graph panel dedicated items Context menu How to open On the toolbar in the Main window click the button From the View menu select Program Analyzer gt gt Call Graph Description of each area 1 Panel control area Toggles whether scrolling of content is enabled by dragging the panel directly By default scrolling is disabled Note that if scrolling is enabled then the shape of the mouse cursor will change and a function variable will be neither highlighted shown in selected state nor reflected in the Target Function Name combo box even if clicking on a Function box Variable box with mouse There will also not be a Pop up display with information about the function Changes the call graph s zoom ratio A number between 10 and 109 can be selected by default 100 is specified You can also change the zoom by rotating the mouse wheel forward or backward while pressing the Ctrl key Changes the call graph s zoom ratio Each click of one of the buttons decrements increments the value of the zoom slider by 1 Automatically changes the call graph s zoom ratio The call graph is enlarged or shrunk in accordance with the size of the panel so that the entire call graph can be displayed Resets the zoom ratio of the call graph to the default value of 100
5. Figure 2 13 Change the Order of Displayed Items Operation from Panel awe T SS ES Unit of Time G Function Name Ye FileName WS Attribute 7 4 Return Type Y ze AD_ nat CG_adc woid w AD Read CG_ade unsigned short AD Shari CG_ad lt Drag the column name to move using the mouse zw AD_Stop CG rors Ea Function Neme Wet p Attribute TE Return Type Wee pepa yar ome t zw AD_Init AD Read CG_adc unsigned short This mark indicates CG_ade Drop on the destination column the position after CG adc movement 2 Performing the operation from the Column Chooser dialog box On the left edge of the panel s header area click the button to open the Column Chooser dialog box and then drag and drop the column names to move directly to the desired column header area on the panel using the mouse Figure 2 14 Change the Order of Displayed Items Operation from Column Chooser Dialog Box Column Chooser Function Name File Name File Paih import Click this button to open the Column Chooser dialog box aA wl O Argument Count W Arquenents Drag and drop using the mouse This mark indicates the cG_adec position after movement 2 6 3 Lock the specific column to display You can set specified items columns to always be displayed on the Function List panel Variable List panel even i
6. The context menu displayed by right clicking on this panel provides the following items and functions Jump to Source Opens the Editor panel and displays the source file in which the function variable currently being selected is defined see 2 7 Jump to Defined Location Jump to Disassemble Opens the Disassemble panel Disassemble1 and displays the disassemble data corresponding to the start address of the function variable currently being selected see 2 7 Jump to Defined Location Note that this item is disabled while disconnecting from the debug tool Jump to Memory Opens the Memory panel Memory1 and displays the memory list corresponding to the start address of the function variable currently being selected see 2 7 Jump to Defined Location Note that this item is disabled while disconnecting from the debug tool Jump to Function Variable List Opens the Function List panel Variable List panel and selects the function variable currently being selected Detail View Switches to the details view that displays the parent functions and child functions of the function currently being selected specified with the Target Function Name combo box Note that this item is disabled during execution of a program R20UT3461EJ0100 Rev 1 00 Aug 01 2015 ztENESAS Page 125 of 163 CS V3 02 00 A WINDOW REFERENCE Class Member panel This panel is used to display the class information CC RX
7. ehd A AB 106208me 0 1Hz Cursor selection buttons Select the target axis to perform a Cursor measurement Note however that this button is disabled during execution of a program X axis Time Set the cursor measurement target to the X axis time default Y axis Value Set the cursor measurement target to the Y axis value Measurement result This area displays the following measurement result from the cursor A and cursor B positions Note however that the information below disappears during execution of a program When the target is the X axis time between the two the cycle Hz calculated from the difference When the target is the Y axis value Shows Shows the time indicated by cursor A the time indicated by cursor B and the difference When the target is the X axis time indicates and the difference between the two When the target is the Y axis value Shows the value indicated by cursor A the value indicated by cursor B and the differ ence between the two If no value can be obtained will be displayed Shows the value at the time when cursor A indicates the value at the time when cursor B R20UT3461EJ0100 Rev 1 00 ztENESAS Aug 01 2015 Page 113 of 163 CS V3 02 00 A WINDOW REFERENCE Execution Time Percentage Chart tab Use this tab to display the acquired function information in a pie chart of the fun
8. u E E al main li Target Function i area Parent Function Name combo box Target Function Name combo box Man maine 55 man subi Function boxes o subDt t abile 3 UA uki abii gubite 14 Cautions 1 If the debug tool to use does not support the trace function or if the debug tool s trace function is not enabled then the Dynamic analysis information e g the execution count read count write count in the call graph cannot be displayed For the dynamic analysis information see the caution of a Trace function Cautions 2 CC RX When C source files are subject to analysis see 3 6 When CC RX C Source Files Is Used The following operations can be performed on the call graph displayed 1 Change a parent function By default the first function to appear named main RH850 RL78 reset RX or containing such word is con sidered to be the parent function and that function is placed on the left edge of the call graph in a box format function box Select a function from the drop down list of the Parent Function Name combo box to change the parent function to be displayed in call graph Remark RH850 If the selected microcontroller version supports multi core you can select PMn in the Parent Function Name combo box In this case the call graph will only be displayed for the functions exe cuted in the selected PMn PEn 2 Display the parent and c
9. A list of the variables daing a reference read write by function subl fal glowal_a End of finding all references AllMessages i Find References Build Tool Program Analyzer The following items are explained here How to open Description of each area How to open From the View menu select Output Description of each area 1 Message area This area displays the following list of locations referencing a function variable on the Function List panel Variable List panel see 2 11 Display List of Referencing Location Remarks 1 When the function name variable name on this tab is double clicked the Editor panel appears and the caret moves to the line where the function variable is defined Remarks 2 The color of the highlighted target function name and target variable name depends on the High light item in the General Font and Color category of the Option dialog box Remarks 3 You can save the contents displayed on this tab to a text file txt by selecting Save Output Find References As from the File menu a Output format of list of locations referencing a function The contents of the search results consist of the following parts R20UT3461EJ0100 Rev 1 00 ztENESAS Page 143 of 163 Aug 01 2015 CS V3 02 00 A WINDOW REFERENCE Figure A 35 Output Format of List of Locations Referencing Function Start of finding all references Target Target function na
10. function information and variable information in a tree struc ture The following types of function variable are displayed in this panel Global function Static function Member function only when C source files are subject to analysis CC RX Global variable Static variable inside a file Class variable only when C source files are subject to analysis CC RX Instance variable only when C source files are subject to analysis CC RX Note however that the class information CC RX function information and variable information in the files not to be analyzed is not displayed in this panel see 1 1 1 What is analyzed See 2 5 Display Class Function Variable Information for details on how to display the class information CC RX func tion information and variable information Caution CC RX The class information is provided only when C source files are subject to analysis When C source files are subject to analysis also see 3 6 When CC RX C Source Files ls Used Figure A 24 Class Member Panel Toolbar a Typedels af Global Functions and Variables ge Define Macros and Constants L Namespaces p Classas m Struct Types m Union Types Enum Types lemphuncll2 lt T 2oi w tamphuncD2 lt T 2ichar shot ce laemphuncl s T Ahat int zw bamplabatest 01 hscid Variables w mo The following items are explained here How to open Description of each
11. gory on the Variable Value Changing tab of the Property panel You can also change the values above by any one of the following mouse operations Note however that these operations are disabled during execution of a program The time per unit grid Time Div Double clicking on the Time Div label in the Analysis Chart panel has the same effect as the automatic adjustment function on the X axis In the graph area move the mouse wheel forward or backward while holding down the Ctrl key The value per unit grid Val Div or the offset value Double clicking on the Val Div label in the Analysis Chart panel has the same effect as the automatic adjustment function on the Y axis Select a graph the mark of transition points transforms into E and then move the mouse wheel for ward or backward while holding down the Ctrl key Offset value Click and vertically drag the mouse while pressing the Shift key with the mouse cursor placed over any of the transition points in the graph the mouse cursor transforms into the icon Pressing the Esc key during dragging the mouse cancels changing the ortset value 5 Validate the graph data You can perform the following operations on the displayed graph as needed Caution These operations below are disabled during execution of a program a Pop up display at a transition point Check the information about transition points in the graph When the mouse cursor is hovered ov
12. An union type name node An enum type name node Class Member panel On the functions variables list area Double click A function name node A variable name node A macro name node An alternative name node An enum member name node Note If scrolling via the mouse dragging is being enabled by the button on the panel control area this operation cannot be used In this case select Jump to Source from the context menu after selecting the target or disable the scroll function temporarily then perform the operation above 2 Jump to the Disassemble panel Memory panel When the jump is executed the disassembly data memory list corresponding to the starting address of the target opens in the Disassemble panel Disassemble1 Memory panel Memory1 and the caret moves to the corre sponding location note however that this is only possible while connecting to the debug tool To do this perform the following operation R20UT3461EJ0100 Rev 1 00 ztENESAS Page 32 of 163 Aug 01 2015 CS V3 02 00 2 FUNCTIONS Panel Target Operation Function List panel A line of function One of the following Variable List panel A line of variableN e 1 Jump to the Disassemble panel Select Jump to Disassemble from the Call Graph panel A function box context menu A variable box Jump to the Memory panel f f N Select Jump to Memory from the context Class Member panel On ihg functions variables list
13. CENESAS C n D TE 7 lt A 3 E D CS V3 02 00 Integrated Development Environment User s Manual Analysis Tool Target Device RL78 Family RX Family RH850 Family 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 00 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 from the informat
14. Caution Assembler source files cannot be analyzed Remark If a header file is selected then functions variables defined in that header file are displayed R20UT3461EJ0100 Rev 1 00 ztENESAS Page 30 of 163 Aug 01 2015 CS V3 02 00 2 FUNCTIONS b Linking with the Editor panel Only display information for functions variables starting with the word at the caret position in the Editor panel To do this click the button on the Function List panel Variable List panel toolbar to enable this filtering func tion then move the caret to the desired function variable name in the Editor panel Click this button again to dis able this function Note however that if there is no word at the caret position e g if it is at a space or tab character then the display will not be filtered linked to the Editor panel Linking with the Debug Manager panel RH850 Only display information for functions variables in the common region Common and PEn currently being selected in the Debug Manager panel To do this click ne buton on the Function List panel Variable List panel toolbar to enable this filtering func tion Click this button again to disable this function Note however that if the selected microcontroller version does not support multi core then this function will be invalid R20UT3461EJ0100 Rev 1 00 ztENESAS Page 31 of 163 Aug 01 2015 CS V3 02 00 2 FUNCTIONS 2 7 Jump to Defined Location You can jump to the l
15. Functions variables other than the above are merged as identical function information variable information The rules for determining merging as identical function information variable information are as fol lows Function Variable Class Name CC RX Namespace CC RX Function Name File Pass PM Information RH850 e Arguments Count Arguments Return Type Access Specifier CC RX Attribute Class Name CC RX Namespace CC RX File Name Function Name File Path Access Specifier CC RX Attribute Type Members PM Information RH850 e The precedence is as follows Active project value gt Import file value Note however that if there is function information variable information from multiple import files to merge then the function information variable information of the last file to be imported is loaded If a value does not exist in either the active project or import file then it is left blank Code Size Bytes Note 3 Cancel the file import To cancel the file import delete the import files on the Path Edit dialog box R20UT3461EJ0100 Rev 1 00 Aug 01 2015 Size Bytes ztENESAS The precedence is as follows Import file value gt Active project value Note however that if there is function information variable information from multiple import files to merge then the function information
16. If it is defined in a header file then the absolute path of the header file is displayed PM Information RH850 Static analysis Displays the following information about PE in which the function is exe cuted In PEn PMn In common PE Common Unknown Note that this item appears only when the selected microcontroller ver sion supports multi core R20UT3461EJ0100 Rev 1 00 Aug 01 2015 Static analysis Displays the following information about the source of the function infor mation If it was acquired from inside an active project Original is displayed If it was acquired from an import file The names of all import files are displayed If it was acquired from inside an active project and an import file Original and the names of all import files are displayed See 2 12 Import or Export Information File for details on the import function ztENESAS Page 90 of 163 CS V3 02 00 A WINDOW REFERENCE Item Type Contents Access Specifier Static Displays the access specifier being declared to the member function CC RX analysis Note however that this will display if analysis is not complete The following access specifiers can be displayed public private protected Attribute Static Displays the function s symbol attributes symbol modifier attributes analysis If there are multiple attributes then they are displayed separated by com mas N Note howe
17. Start menu of Windows Remark For details on how to start CS see CS Integrated Development Environment User s Manual Project Operation 2 Seta project Create a new project or load an existing one Remark For details on how to set a project see CS Integrated Development Environment User s Manual Project Operation 3 Create a load module Create a load module by running a build after setting of the active project and the build tool to be used Caution Run a build after setting the Enable static analysis information property in the General category on the Settings tab of the Property panel to Yes in order to generate the cross reference informa tion required for the analysis tool without depending on the configuration of the build tool being used see 1 Static analysis information Remarks 1 For details on how to create a load module see CS Integrated Development Environment User s Manual Project Operation of the compiler to use Remarks 2 If the build completes without compiler or assembler errors then at this point the Static analysis information can be displayed in the Function List panel Variable List panel Call Graph panel Class Member panel 4 Execute downloading Connect CS to the debug tool after configuring the operational environment of the debug tool and then download the load module created in steps 3 to the debug tool Caution Connect to the debug tool after setting the Enable d
18. This area displays a pie chart indicating function execution time ratios You can change the number of functions to display by setting from the The number of functions displaying in the Execution Time Percentage Chart 1 4 property in the General category on the Settings tab of the Property panel set to 10 by default The targets are charted in ranking order of highest proportion of execution time taken Functions exceeding the number specified here are displayed together under Others Remarks 1 The colors of labels and background of a chart depend on the settings of font color and back ground color for the Default item in the General Font and Color category of the Option dialog box R20UT3461EJ0100 Rev 1 00 2tENESAS Page 114 of 163 Aug 01 2015 CS V3 02 00 A WINDOW REFERENCE Remarks 2 You can expand or shrink the graph display from 10 to 100 by rotating the mouse wheel forward or backward while pressing the Ctrl key note that this does not apply to the font size of each label a Label display Each function label is displayed in the format Function name proportion of execution time For static files the file name is also included inside the parentheses Remark The proportion of execution time is the same as the Execution Time Percentage in the Function List panel b Pop up display When the mouse cursor is hovered over the chart information about that function appears in a pop up
19. V3 02 00 2 FUNCTIONS 1 Specify the number of functions to display You can change the number of functions displayed in the chart To do this specify the number in the The number of functions displaying in the Execution Time Percentage Chart property in the Analysis Chart category on the Settings tab of the Property panel set to 10 by default The targets are graphed in ranking order of highest proportion of execution time taken Functions exceeding the number specified here are displayed together under Others 2 Pop up display of execution time When the mouse cursor is hovered over a function information about that function s execution time appears in a pop up Figure 2 38 Pop up Display of Execution Time main 19 115 Oilers 34 72 bi 7 48 a SL k 5 main sub iistatic 5 56 e subOS_subO 05 e sub0 _sub01 6 05 lt Remark The display contents are updated each time program execution is stopped Note however that if the Refresh at program stop property in the General category on the Settings tab of the Property panel is set to other than Yes default the information will be updated in accordance with the setting on the Property panel R20UT3461EJ0100 Rev 1 00 ztENESAS Page 56 of 163 Aug 01 2015 CS V3 02 00 2 FUNCTIONS 2 14 Save Analysis Information You can save the contents of the Function List panel Variable List panel Analysis Chart panel C
20. also see 3 6 When CC RX C Source Files Is Used CC RX Unused static functions deleted via compiler optimization cannot be displayed in the panel You can set filters for displaying function information on this panel see 2 6 5 Filter the analysis informa tion This panel can be zoomed in and out by in the tool bar or by moving the mouse wheel for ward or backward while holding down the Ctrl key RH850 See a Trace function and c Coverage function IECUBE E20 RX Simulator for details on the relationship between the Dynamic analysis information in this panel and PEn currently being selected in the Debug Manager panel Function List Panel Function List ame me ES Unit of Time Funchon Ham Wee FileName We Strbute We Reban Type Yt Zz Arguments T gt AL init see AD Feed sie AD Start w AD Stop MO_INTAC TMPO Start Wi TMP1_Stast am fungi The func la w func OG_ade OG_ade CG_ade OG_ad_userc Da timane CO timene No Definition CG maing CG _main c CG meme unaigned short buffer yond vod v d vied vaig ureagned short vad vad v d youd youd yond void void weed wood m The following items are explained here How to open Description of each area Toolbar File menu Function List panel dedicated items R20UT3461EJ0100 Rev 1 00 Aug 01 2015 ztENESAS Page 88 of 163 CS V3 02 00 A WINDOW REFERENCE Edit me
21. calls of A to B and B to C no connection line will be shown for the call of C to A Instead the following line segment will only be shown to indicate a circular call You can check information about functions in a circular call via the Pop up display credat calens maine 105 6 Remark If there are no static function calls but there are dynamic function calls e g if function calls are only made using function pointers then this information can be confirmed in the Pop up display d Pop up display When the mouse cursor is hovered over a function box variable box information about that function variable appears in a pop up The display format is as follows Caution This function cannot be used while scrolling via the mouse dragging is being enabled by the button R20UT3461EJ0100 Rev 1 00 ztENESAS Page 122 of 163 Aug 01 2015 CS V3 02 00 A WINDOW REFERENCE Function box inalioriDi _ cales combiraliont_ cable mane 256 Le Function nam combination _eallerl Recursive call count 1 Execution 1 Times Circular call count combimation_calll L Execution 1 Times Dynamic call count cub fpi 1 Tires Function name Function name Location File name Line number absolute path of the file Recursive call count Reference count Execution Execution count Circular call count Function name Reference count Execution Execution count Dynamic call count Funct
22. rlia in Selects the parent function to target for display in the call graph it will be at the top of the call graph from the drop down liste 1 By default the first function to appear Parent Function named main reset start N 2 or containing such word is specified as the parent Name combo box function if there is no corresponding function it will be empty Left combo box R20UT3461EJ0100 Rev 1 00 7tENESAS Page 117 of 163 Aug 01 2015 CS V3 02 00 A WINDOW REFERENCE fe Selects the function to highlight show in selected state on the call graph from the following drop down list Target Function Name combo box Right combo box If the Parent Function Name combo box is empty Whole view The names of all functions in the program Details view The names of all functions currently being shown If a parent function is specified with the Parent Function Name combo box Whole view The names of functions called by that parent function including child and grandchild functions Details view The names of all functions currently being shown When a function box is clicked in the call graph the function is highlighted unless scrolling via the mouse dragging is enabled by the button and then the func tion s name is also reflected in this combo box The function box being highlighted nites shown in selected state subD1 c 1 shalics Switches to th
23. tab in the General category changing the Unit of time property The unit of time can be changed by selecting Unit of Time from the Tool bar or from the Property panel s Settings tab in the General category changing the Unit of time property see the Unit of time property in the Property panel for details on the time display format Note however that this will display if the debug tool s Trace function is disabled or analysis is not complete ztENESAS Page 92 of 163 CS V3 02 00 A WINDOW REFERENCE Item Type Contents Code Coverage Dynamic Displays the code coverage rates of the function CO number of bytes of IECUBE analysis code executed in the address range function s code size x 100 see E20 Rx X e 5 3 2 Coverage Results Simulator The level of shading of the cell s background color indicates the code cov erage Note however that this will display if the debug tool s Coverage func tion IECUBE E20 RX Simulator is disabled or analysis is not com plete Notes 1 This item does not appear by default See 2 6 1 Set the columns to display for details on how to display this item Notes 2 If including an alternative name by using define or typedef then not the alternative name but the original type is displayed Notes 3 Set the Accumulate result of analysis property in the General category on the Settings tab of the Property panel to
24. the debug tool is set to the Data collection mode Sampling interval ms R20UT3461EJ0100 Rev 1 00 Aug 01 2015 Specify the sampling interval in ms unit to collect the data by using Smart Analog function Before the debug tool starts acquiring data in the Data collection mode the value of the symbol r_dbg_graph c static_e1_waveout_rate is replaced with the value spec ified for this property Default 10 Modifying Directly enter from the keyboard Note that changes cannot be made during execution of a program Available values 0 to 1000 in decimal number ztENESAS Page 84 of 163 CS V3 02 00 Data collection channel 4 Channel 1 16 A WINDOW REFERENCE Select channels to collect the data Before the debug tool starts acquiring data in the Data collection mode the value of the symbol r_dbg_graph c static_e1_waveout_flag is replaced with the value spec ified for this property Default All check boxes are not selected Modifying Select check boxes from the drop down list Note that changes cannot be made during execution of a program Available values ch1 to ch8 multiple selections possible The information on the graphing target that is registered in each channel is displayed and its configuration can be changed see 1 Register graphing targets Caution If Load from file has been specified with the Analysis method property then th
25. without Dynamic Analysis Information Target global a Definition maia bid Definition main c 18 Reference main ciao i Heferanca Reference aferent Reference gia ant main ci 116 mean ctlagh main c l136 subol ct18 AELA ERE O Herel rT Pech of el top PLIM global_b global_e Figure A 40 Example of List of Locations Referencing Variable with Dynamic Analysis Information Targen global al Dafinieien aaia Bi i ee Defindtion main ellais int idi Referance Read Write osant j main c 5 ogicheal pointer Baichel af al Rafecence Asad Write Ceant j main c 11 D Hatecence AaadWrite Coant 29 main g lIlzj A 45 Reference Read Write Coane 20 madn a 1a6 gt kreml Se med qichal_b gichel_a Reference Read Write Goons LO wabdl o 15l jresult tmp R20UT3461EJ0100 Rev 1 00 ztENESAS Page 146 of 163 Aug 01 2015 CS V3 02 00 A WINDOW REFERENCE Select Files not To Analyze dialog box This dialog box is used to specify the files not to be analyzed by the analysis tool see 1 1 1 What is analyzed The function information and variable information in the files specified not to be analyzed on this dialog box are not dis played in the following panels Function List panel Variable List panel Call Graph panel Class Member panel Figure A 41 Select Files not To Analyze Di
26. 2 About Namespace name node If an element contains an internal namespace it is displayed in the form enveloping Namespace name internal Namespace name Examples 1 namespace Name Name Examples 2 For an internal namespace Name SubName Remarks 3 About Class name node If it is a template class then the type information is added If an element is an internal class it is displayed in the form enveloping Class name internal Class name Examples 1 class Sub Sub Examples 2 template lt class T gt class List List lt T gt Examples 3 For an internal class Main SubInMain Remarks 4 About Class Interface Struct type Base Types Derived Types and Inner Types are only shown for classes interfaces that are direct descendants if there are multiple such types they are all shown Remarks 5 If Class name Interface name Struct type name Union type name Enum type name is an anony mous i e it has no tag name then it will be displayed in the format of lt unnamed_N gt N A num ber from 1 automatically provided in appearance order Remarks 6 You can jump to the corresponding node Class name node Interface name node etc in the same tree by double clicking a node displayed under the Base Types node Derived Types node Inner Types node Remarks 7 You can jump to the location where the node currently being selected is defined or declared see 2 7 Jump to Defined Location 2 8 Jump to Declared Location 3 Functio
27. 2 When the mouse cursor is hovered over a file name the full path of the file and the path including the tree node name that is displayed in the project tree appear in a pop up b Category Displays the category name to which the corresponding C C source file is registered in the project tree When a category name is displayed in the File Name File is displayed if it is a root category is dis played c Defined Symbol Count Displays the total number decimal number of the functions and variables that are defined in the corresponding C C source file or category However if the number of the defined symbols cannot be obtained then will be displayed 3 All Select All Deselect check box Select this check box to select all of the check boxes in File column Conversely remove the check of this check box to remove all of the checks in File column Indicates that all of the check boxes in File column is being selected Indicates that all of the check boxes in File column is not being selected or all of the check boxes in File column is not being cleared Indicates that no check box in File column is being selected default Function buttons Function Sets the specified file s to the file s to be analyzed then closes the dialog box Ignores the setting and closes this dialog box Displays the help of this dialog box R20UT3461EJ0100 Rev 1 00 7tENESAS
28. 239 Zoom 4 64 255 84 28 Modifying Specify with the color selection combo box or directly enter from the keyboard Available When directly enter from the keyboard values The value in decimal number hexadecimal number prefix Ox is needed or the color name see About the specification of the color Notes 1 E1 E20 RL78 This feature is supported only when the selected microcontroller incorporates Smart Analog IC Notes 2 If the unit case insensitive is omitted when Real time sampling is selected in the Analysis method property it will be handled as ms In other cases it will be handled as ns When this property is changed if the value of the Trigger position property is greater than the value of this property x 10 then the value of this property x 10 is automatically specified to the Trigger position property Notes 3 The color specified in this property will also be reflected to the foreground color background color of the Variable Value Changing Chart zoomed in panel 2 Trigger The information on the trigger function is displayed and its configuration can be changed see 3 Use the trigger function R20UT3461EJ0100 Rev 1 00 ztENESAS Aug 01 2015 Page 82 of 163 CS V3 02 00 A WINDOW REFERENCE Use trigger function Select whether to display the graphs by using the trigger function Default No Modifying Depends on the
29. 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 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
30. Analog is supported only when the selected microcontroller incorporates a Smart Analog IC Notes 2 CC RX The class information is provided only when C source files are subject to analysis In the each panel the following types of function variable are subject to analysis Table 2 2 Types of Functions Variables That Are Subject to Analysis Panel Function List Variable List Analysis Chart Call Graph Class Member Variable Value Changing Chart zoomed in Global function 2 Static function Member function CC RxjNote 1 Global variable Static variable inside a file Static variable inside a func tion Local variable R20UT3461EJ0100 Rev 1 00 2tENESAS Page 14 of 163 Aug 01 2015 CS V3 02 00 2 FUNCTIONS Panel Function List Variable List Analysis Chart Call Graph Class Member Variable Value Changing Chart zoomed in IOR SFRN te 2 I Class variable CC RX N te 1 I Instance variable CC RxjNote 1 Notes 1 CC RX This is a function variable that exists only in C source files Notes 2 RH850 RX IOR RL78 SFR By validating this analysis information it is possible to search for unused functions and variables and processing that is creating bottlenecks allocate memory effectively to reduce code size and the like The basic operation sequence of the analysis tool is as follows 1 Start CS Launch CS from the
31. Beget Badd Delas Jeol Wreker Hiki r AERE E EE E N Tg ih Oead ah LRLS R T T oe ME e E eT 7 ae a ra en ew M MiM me SEK of itie Arane Amet Proparty a Ee m Prego Aratrcer Paneer L alt a Gersa E HA Preionnroi Berba rsr srayeia Tierra You pe Cee Sereno cigs Tod Soot mera mayan ier You 4 CE PL rh Toefl Asteralats al of ed ul Me F ALTE Sirma Debug Teet lekai thet peo it Gel A IS a F Firbrh a anyam dion Tpi HT he ea ge m Pua mip ni is Bik ne H iiri te SFR hi Diii the LRN ibis ia HCM Gih bi Frese reran dhenie hen ehen afl oerets me chord He FL fan Ei RADIC Sip ed ka aj j a oe R ADC Ser Cie og ec in wad mad d s AAD Set p epee in and ead 4 A ADC Alt tg eee amp aj PrE bak 1 i R TAI Dni 1 ep braa tu wad aad Ea s FPL _Cheeme o_eg_bewec iu ai ead 4 E Faction Lit T va God Ee The following items are explained here How to open Description of each area How to open From the Windows start menu select All Programs gt gt Renesas Electronics CS gt gt CS for CC Remark In Windows 8 or Windows 8 1 select CS for CC RL78 RX RH850 on the start screen In Windows 10 select Windows Start menu gt gt All apps gt gt Renesas Electronics CS gt gt CS for CC RL78 RX RH850 Description of each area 1 Menubar a View The View menu for the analysis tool provides the following items and functions default Output Opens the
32. CS Integrated Development Environment User s Manual Debug Tool R20UT3461EJ0100 Rev 1 00 ztENESAS Page 8 of 163 Aug 01 2015 CS V3 02 00 1 GENERAL c Coverage function IECUBE E20 RX Simulator This function is used to perform coverage measurements The coverage function provides the following Dynamic analysis information Code coverage rates Data coverage rates Cautions 1 E20 RX The code coverage rates are measured only when the selected microcontroller supports the cov erage function a measurement of the data coverage is not supported Cautions 2 Simulator RH850 The coverage is measured for access in all PEs In the Local RAM self area note that the mea surement results will be displayed only for the access in PEn currently selected in the Debug Manager panel R20UT3461EJ0100 Rev 1 00 ztENESAS Page 9 of 163 Aug 01 2015 CS V3 02 00 1 GENERAL 1 2 Features The features of the analysis tool are shown below Displaying function information The following information about functions is displayed Static analysis information e g function name file name attribute return type reference count etc and Dynamic analysis information e g execution count execution time code coverage etc Displaying variable information The following information about variables is displayed Static analysis information e g variable name file name attribute type reference count etc a
33. CS V3 02 00 A WINDOW REFERENCE b Access group This classifies and displays nodes by their access specifiers specified in their classes etc Nodes of the same type are displayed in alphabetical order AH Typedefs a Global Functions and Variables Define Macros and Constants 7 public CC RX Gg Class name 1 Note 1 Interface name a Struct type nameNe 1 a Union type nameNte 2 Enum type name _ protected CC RX Gg Class nameN e t Note 1 Interface name So Struct type nameNe Note 2 Union type name Enum type name _ private CC RX aes Class nameN 1 Note 1 Interface name a Struct type nameNe a Union type nameN te 2 Enum type name Notes 1 CC RX Base Types node Derived Types node and Inner Types node are displayed as necessary Notes 2 CC RX Inner Types node is displayed as necessary c Namespace group This classifies and displays nodes by the namespaces in which the class or other elements are defined Nodes of the same type are displayed in the access specifier order see a Category group default and nodes with the same access specifier are displayed in alphabetical order Note 1 cae Namespace name aL Typedefs al Global Functions and Variables Define Macros and Constants Sg Class name CC RX 2 R20UT3461EJ0100 Rev 1 00 ztENESAS
34. Displays the time as hours minutes 0 59 seconds 0 59 clk Displays the time in units of clock cycles The value is rounded to integer number Note that this item is displayed only when the selected microcontroller supports a time display in units of clock cycles Delimits arguments by new line Select whether to display the Arguments items in the Function List panel with new Display the SFR IOR lines Default No Modifying Select from the drop down list Available Yes Displays in multiple lines one value per line values F No Displays without newlines comma separated Select whether to display the SFR IOR on the Variable List panel by treating it as a variable Default No Modifying Changes not allowed R20UT3461EJ0100 Rev 1 00 Aug 01 2015 ztENESAS Page 71 of 163 CS V3 02 00 Display the function variable without defini tion at Call Graph panel A WINDOW REFERENCE Select whether to display the function variable without definition i e a function vari able whose source file does not exist in the Call Graph panel Default No Modifying Select from the drop down list Available values Yes Displays the function without definition No Does not display the function without definition Output function infor mation at program stop RH850 Select whether to output the information file for STFN
35. Page 127 of 163 CS V3 02 00 A WINDOW REFERENCE a Category group default This classifies and displays classes interfaces and other types aH Typedefs a Global Functions and Variables Define Macros and Constants _ Namespaces CC RX Y Namespace name 7 Class CC RX ve Class nameN e 1 Base Types Base type Class Interface Struct type name Derived Types Derived type Class Interface Struct type name Inner Types Inner type Class Interface Struct type Union type Enum type name _ Interfaces CC RX Interface nameN 1 Base Types Base type Class Interfaces Struct type name Derived Types Derived type Class Interface Struct type name Inner Types Inner type Class Interface Struct type Union type Enum type name _ Struct Types a Struct type nameNe 1 2 _ Union Types a Union type nameN te 3 _ Enum Types Enum type name Notes 1 CC RX These are displayed in the following access specifier order together with icons denoting the access specifier nodes with the same access specifier are displayed in alphabetical order Access Specifier public protected private Notes 2 CC RX Base Types node Derived Types node and Inner Types node are displayed as necessary Notes 3 CC RX Inner Types node is displayed as necessary R20UT3461EJ0100 Rev 1 00 ztENESAS Page 128 of 163 Aug 01 2015
36. We Arguments Te undigned short unsigned short bufer weed MC_IRTAD CG ad usec w TMPO Stat CG_timere v TMP Stat Da timent v _ am No Definition fung CG maing w tungla CG mms w tunes CG mem Cautions 1 E20 RX In the debug tool s Property panel when the Trace data type property in the Trace category on the Debug Tool Settings tab is set to Branch the acquisition time of the Dynamic analysis information by trace data will increase because complement of instructions between branch instructions is performed the processing time is proportional to the set value of the Trace memory size MByte property in the same category above Cautions 2 CC RX When C source files are subject to analysis see 3 6 When CC RX C Source Files Is Used Cautions 3 CC RX Unused static functions deleted via compiler optimization cannot be displayed in the panel Remarks 1 The display contents are updated each time program execution is stopped Note however that if the Refresh at program stop property in the General category on the Settings tab of the Property panel is set to other than Yes default the information will be updated in accor dance with the setting on the Property panel Remarks 2 The value of the information that has been changed because of the execution of a program is shown highlighted the color depends on the configuration in the General Font and Color category of the Option dialog b
37. Yes to display the cumulative value for each program execution Notes 4 The execution time does not include the execution time of the runtime libraries provided by the compiler If the current setting of the debug tool does not allow clearing of the trace memory before tracing starts the execution time value will be incorrect Notes 5 E20 RX This item appears only when the selected microcontroller supports the coverage function and also CS is connected to the debug tool In the bottom of the Function Name item the following information for each file is shown as Total Note that No Definition displayed in the File Name item is treated as one file Figure A 7 Total Display Function List Panel Function Name We FileName Te Code Size Bytes Te Reference Count WA WL Execution Cou TA Total CG timere 40 2 i Total Mo Definition o 3 o Total OG _ main 50 3 4317 Contents File Name The target file name File PassNote File pass of the target file Code Size Bytes Total of the function s code size in the target file Reference Count Total number of times functions are referenced in the target file Execution Count Total number of times functions were executed in the target file Execution Time uni Total of the execution time of functions in the target file Execution Time Percent The proportion of total execution time range that could be obtained as trace age data ta
38. a breakpoint to the function on the panel d Display List of Referencing Location Find and display a list of locations referencing the function on the panel Remark It is also possible to display the function information defined in other than the active project For detailed instructions on displaying function information see 2 12 Import or Export Information File 8 Display Variable Information Display the Variable List panel in order to validate the acquired variable information The Variable List panel can be operated as follows in accordance with the purpose Note that if the program is modified during debugging the operation is repeated via 3 above a Customize Display Method Change the display method e g set which columns to display and the sorting order on the panels b Jump to Defined Location Jump to the location where the function on the panel has been defined c Seta break event to a variable Set a break event with access condition to the variable on the panel d Register Watch Expressions Register variables to the Watch panel Watch1 as watch expressions e Display List of Referencing Location Find and display a list of locations referencing the variable on the panel Remark It is also possible to display the function information defined in other than the active project For detailed instructions on displaying function information see 2 12 Import or Export Information File 9 Display Calling Re
39. access External trace out put Select the method for externally outputting trace data Set the property in the Trace category on the Debug Tool Settings tab in the debug tool s Prop erty panel Standard Settings Necessary for Dynamic Analysis Coverage Function Property of Debug Too Note Description Value to be Set When Yes is Selected for Enable dynamic analysis information Property RH850 RX RL78 Use coverage func tion The value of this property automatically changes to Yes when the debug tool is connected if Yes is selected for the Enable dynamic analysis information property Yes RX Note Table A 4 Micro controller Use code coverage function Select Yes Coverage area of measurement Specify the address range normally the code section range to be measured by coverage Set the property in the Coverage category on the Debug Tool Settings tab in the debug tool s Property panel Standard Settings Necessary for Dynamic Analysis RRM Function Property of Debug Too Note Description Value to be Set When Yes is Selected for Enable dynamic analysis information Property RH850 RX RL78 Update display dur ing the execution The value of this property automatically changes to Yes when the debug tool is connected if Yes is selected for the Enable dynamic analysis information prop
40. area menu ote i A function name node A variable name node A macro name node An alternative name node An enum member name node Notes 1 You can jump to only the Memory panel Notes 2 Neither a node on the classes categories tree area nor a node of an instance variable can be target for this function R20UT3461EJ0100 Rev 1 00 ztENESAS Page 33 of 163 Aug 01 2015 CS V3 02 00 2 FUNCTIONS 2 8 Jump to Declared Location You can jump to the location of the source text where the function variable or class CC RX etc on the Class Member panel is declared Caution CC RX When C source files are subject to analysis the reference information for functions variables that are referenced in a member function defined in a template function or a template class cannot be obtained Therefore the following operation is invalid for them except however when the template function is defined with a static declaration and defined outside a class When the jump is executed the source file in which the target is declared opens in the Editor panel and the caret moves to the line of the function prototype declaration for C source files or the line of the function prototype declaration inside class declaration for C source files To do this perform the following operation Target Operation On the classes categories tree area Select Jump to Declaration of Source from the context A name
41. background color Select whether to select the foreground color and background color of the graph Default No Modifying Select from the drop down list Available values Yes Selects the foreground color and background color of the graph No Does not select the foreground color and background color of the graph i e uses the setting of background color for the Default item in the Option dialog box Background color Specify the background color Note 3 of the graph This property appears only when the Specify foreground color and background color property is set to Yes Default The setting of background color for the Default item in the Option dia log box Modifying Specify with the color selection combo box or directly enter from the keyboard Available values When directly enter from the keyboard The value in decimal number hexadecimal number prefix Ox is needed or the color name see About the specification of the color Background color Lost section R20UT3461EJ0100 Rev 1 00 Aug 01 2015 Specify the background color This property appears only when the Specify foreground color and background color property is set to Yes Note 3 of the graph in a lost section see a Graph Default The setting of background color for the Lost item in the Option dialog box Modifying Specify with the color selection combo box or d
42. by the column name of the column that the information is sorted on Table 2 5 Marks that Indicate Sorted Display Indicates that the information is being sorted in ascending order Click again with the mouse to sort in descending order Indicates that the information is being sorted in descending order Click again with the mouse to sort in ascending order Remark Click while holding down the Shift key to sort on multiple columns 2 6 5 Filter the analysis information You can set filters for displaying information on the Function List panel Variable List panel The following types of filters are available 1 Filtering via custom settings for each column 2 Filtering results linked to panel Caution The Filtering via custom settings for each column and the Filtering results linked to panel are mutually exclusive functions For this reason the two filtering functions described here cannot be enabled simul taneously when one of the filters is active setting the other filter will disable the first one 1 Filtering via custom settings for each column Configure a custom filter for each column and display the acquired information To do this click on the filter icon F F of the target column name then select the following menu item Table 2 6 Filter Display Settings Description All Does not set filter resets filter display Displays all information Custom Opens the Filter Settings dial
43. debug tool is set in the Data collection mode Cautions 2 The auto adjustment function becomes invalid when the following operation is performed the Auto adjustment property in the General category on the Variable Value Changing tab of the Property panel will be changed to None The Time Div label or Val Div label on the Analysis Chart panel is double clicked The display range is changed with the mouse operation see Set the display range manu ally R20UT3461EJ0100 Rev 1 00 ztENESAS Page 51 of 163 Aug 01 2015 CS V3 02 00 2 FUNCTIONS Remark The timing at which the auto adjustment is conducted can be specified with the Auto adjust ment property in the General category on the Variable Value Changing tab of the Property panel lt 2 gt Set the display range manually First specify None with the Auto adjustment property in the General category on the Variable Value Changing tab of the Property panel Then specify the following value X axis time You can specify the time per unit grid for all channels To make the setting set the Time per grid Time Div property in the General category on the Variable Value Changing tab of the Property panel Y axis value You can specify the value per unit grid or the offset value for each channel individually To make the setting set the Value per grid Val Div 7 16 property or the Offset 7 16 property in the Channel 7 16 cate
44. e un igned int Gine La g_oounl_ ime in uncigned int EEE E w g fag_detect wnsigaad shart EAEE AEs a S rome Co _systeminite EAEE e Total CG maine Total CG_sysbeminite al Cautions 1 E20 RX In the debug tool s Property panel when the Trace data type property in the Trace category on the Debug Tool Settings tab is set to Branch the acquisition time of the Dynamic analysis information by trace data will increase because complement of instructions between branch instructions is performed If you focus only on variables we recommend selecting Data access in this property Cautions 2 CC RX When C source files are subject to analysis see 3 6 When CC RX C Source Files Is Used Cautions 3 CC RX Unused variables deleted via compiler optimization are not displayed Remarks 1 The display contents are updated each time program execution is stopped Note however that if the Refresh at program stop property in the General category on the Settings tab of the Property panel is set to other than Yes default the information will be updated in accor dance with the setting on the Property panel Remarks 2 The value of the information that has been changed because of the execution of a program is shown highlighted the color depends on the configuration in the General Font and Color category of the Option dialog box To reset the highlighting click the button on the toolbar Remarks 3 The cur
45. following message appears in the Output panel RRM lost or buffer overflow has occurred during data sampling R20UT3461EJ0100 Rev 1 00 tENESAS Page 109 of 163 Aug 01 2015 CS V3 02 00 Figure A 14 View of Section Where Acquisition of Graph Data Has Failed qae Lost section Lost section Remarks 1 Acquisition of graph data may fail for the following reasons The target variable without a scope definition is outside the current scope at the time of sam pling because it is a static variable inside a file or function E1 E20 RL78 Some data has been lost while the debug tool is in the Data collection mode Other than the above see 3 4 Trace Data Analysis Remarks 2 The rendering color of the graph for each channel can be changed individually via the Color 1 16 property in the Channel 1 16 category on the Variable Value Changing tab of the Property panel Remarks 3 If Real time sampling analysis is selected the format of the line chart can be changed via the Chart type property in the General category on the Variable Value Changing tab of the Prop erty panel see b Selection of the chart type X axis time Displays the passage of time Grid lines divided in ten are displayed The time per unit grid Time Div for all channels can be specified with the Time per grid Time Div property in the General category on the Variable Value Changing tab of the Prop erty panel see
46. graph on the Variable Value Changing Chart zoomed in panel When the graph to be saved are being displayed on this panel select Save button to open the Save As dia log box On this dialog box select Analysis Chart Data mtac in the Save as type area and specify the name of new file in the File name area and then click the Save button note that the file extension must be mtac However the graph data saved on the Variable Value Changing Chart zoomed in panel is limited to the zoom range b Load the graph data On the Variable Value Changing tab of the Property panel select Load from file in the Analysis method property in the General category see 2 Specify the method for acquiring the graph data Then specify the analysis chart data file mtac that was saved previously with the Analysis chart data file property in the same category Figure 2 36 Load Graph Data General Category Load from file CA Test Sample Chat 01 mtac lod Time per grid Time Diw Ime Chart type line chat Specify foreground color and background color No Cursor A color E PaleGreen Cursor B color Pale Turquoise Foom 1 color E 64 255 10 79 Zoom color LO 64 91 228 22 Zoom 3 color L 64 5 105 235 Zoom d color LO 64 255 84 28 At this time data items to be saved restored are as follows Graph data for each channel Data Item Restored Location Value The graph display a
47. in the Debug Manager panel Therefore the analysis tool also displays the dynamic analysis information regarding PEn Full spec emulator IECUBE E1 E20 RH850 Simulator Perform the following setting on the debug tool s Property panel to acquire the execution time correctly Debug Tool Settings tab gt gt Trace category gt gt Clear trace memory before running property gt gt Yes default E20 RX If Start Trace Stop Trace from the context menu on the Trace panel is selected during execu tion of a program then an invalid value will be displayed as the execution time E1 E20 RX EZ Emulator RX Since the trace time tag feature is not supported execution time of functions cannot be dis played The time information displayed in graphs through Trace data analysis will not be correct E20 RX In the debug tool s Property panel when the Trace data type property in the Trace category on the Debug Tool Settings tab is set to Branch the acquisition time of the dynamic analysis infor mation by trace data will increase because complement of instructions between branch instruc tions is performed If you focus only on variables we recommend selecting Data access in this property E1 E20 RL78 EZ Emulator RL78 Since branch origin addresses can only be acquired from the trace data only the Execution Count item in the Function List panel Call Graph panel is supported b RRM function RAM monitor
48. inside a function lt static local gt If the attribute other than the above nothing is displayed in this area Reference count Indicates the number of times of static references Read count Write count Indicates the number of times dynamic references R read accesses W write accesses have been made Note that this information appears only when the trace data exist This information is the cumulative value for each program execution when the Accumulate result of analysis property in the General category on the Settings tab of the Property panel is set to Yes Condition The current state of the target function is shown in the following background colors Green Not referenced Red purple Referenced PM Information RH850 If the selected microcontroller version supports multi core PE in which the target variable is assigned is shown in the following shadow colors Gray Common Red PM1 PE1 Green PM2 PE2 Blue PM3 PE3 Orange PM4 PE4 Remark By double clicking a variable box you can jump to the location of the source text where the vari able is defined see 2 7 Jump to Defined Location Note however that this function cannot be used while scrolling via the mouse dragging is being enabled by the button In this case disable the scroll function temporarily then double click the target variable c Connection line If a given function is called statically by anothe
49. locations referencing a function see 2 11 Dis ences play List of Referencing Location Default Yes Modifying Select from the drop down list Available Yes Displays the prototype declaration values No Does not display the prototype declaration R20UT3461EJ0100 Rev 1 00 ztENESAS Page 70 of 163 Aug 01 2015 CS V3 02 00 A WINDOW REFERENCE Refresh at program Select whether to update the contents of the Function List panel Variable List panel stop Analysis Chart panel Call Graph panel when the program stops executing Default Yes Modifying Select from the drop down list Available Yes Updates the contents of the panel after the program exe values cution is stopped No Does not update the contents of the panel even if the pro gram execution is stopped Specify Enables the button on each panel updates the con individually tents of the panel by clicking this button Unit of time Select the time unit for the analysis tool Default ns Modifying Select from the drop down list Available ns Displays the time in nanosecond units values The value is rounded to integer number us Displays the time in microsecond units The value is rounded to three decimal places ms Displays the time in millisecond units The value is rounded to three decimal places s Displays the time in second units The value is rounded to three decimal places h min s
50. names of the columns to display or drag and drop them directly from the dia log box to the information display area on the panel using the mouse Figure 2 11 Adding Columns to Display Clearing Check Boxes in Column Chooser Dialog Box Column Chooser Click this button to open the Column Fl Funcion Nama Ch dialog b a ooser dialog box File Name E File Path import CG ade z AD Read CG ade z AD Start CG adt w AD_Stop Select the check boxes of the items to display Click this button to open the Column Chooser dialog box 2 Function Name FS FileName TH R Se AD Irit CG ade void ow AD Read iteh zv AD Start OG aot E Arguments z v AD_Stop CG ade void Drag and drop using the mouse 2 6 2 Change the order of the columns to display You can change the display order of the items columns displayed on the Function List panel Variable List panel There are two ways to perform this operation as shown below There are two ways to perform this operation as shown below 1 Performing the operation from the panel 2 Performing the operation from the Column Chooser dialog box 1 Performing the operation from the panel Use the mouse to drag and drop the column name to move directly to an arbitrary column header area R20UT3461EJ0100 Rev 1 00 ztENESAS Page 27 of 163 Aug 01 2015 CS V3 02 00 2 FUNCTIONS
51. of trigger signal Select a channel between ch1 and ch16 default ch1 Trigger level Specify the threshold value for determining as a trigger signal The variable channel specified for Trigger source determines whether a trigger signal is recognized accord ing to whether the value exceeds the threshold set here R20UT3461EJ0100 Rev 1 00 ztENESAS Page 49 of 163 Aug 01 2015 CS V3 02 00 2 FUNCTIONS Directly enter a value with a decimal or hexadecimal number in the range minimum trigger source to maxi mum trigger source floating point decimals allowed default 0 Remark The trigger level is displayed on the right part of graphs as the trigger mark i The trigger level can be changed by dragging on this trigger mark note this operation is disabled during execution of a program Direction of trigger edge Select the direction of the threshold value specified with Trigger level The variable channel specified for Trigger source determines whether a trigger signal is recognized accord ing to whether the value exceeds the threshold in the direction set here Rising Generates a trigger signal when the value of Trigger source changes from less than Trig ger level to greater than or equal to Trigger level default Falling Generates a trigger signal when the value of Trigger source changes from greater than Trigger level to less than or equal to Trigger level Both Generat
52. only desired files can be selected as the files to be analyzed or files not to be analyzed to improve the efficiency of analysis The function information and variable information in the files not to be analyzed is not displayed in the panels except for the Analysis Chart panel provided by the analysis tool Only the function information and variable information in the files to be analyzed is displayed in the panels except for the Analysis Chart panel provided by the analysis tool Use any of the following methods to specify files to be analyzed and files not to be analyzed use a convenient method for the analysis purpose 1 When the files not to be analyzed are specified default On the Settings tab in the Property panel specify Files not to analyze with the Select specification method of files to analyze property in the Analysis Object category Inthe same category above click the button that appears at right edge in the column when Files not to ana lyze property is selected On the Select Files not To Analyze dialog box opened select the files not to be analyzed 2 When the files to be analyzed are specified On the Settings tab in the Property panel specify Files to analyze with the Select specification method of files to analyze property in the Analysis Object category Inthe same category above click the button that appears at right edge in the column when Files to analyze prope
53. pseudo RRM function This function permits you to read the contents of memory variables registers addresses in real time while exe cuting the program The RRM function RAM monitor pseudo RRM function provides the following Dynamic analysis information Graph data when the method for acquiring the graph data is Real time sampling analysis Note Caution Remark E1 E20 RL78 If the selected microcontroller incorporates a Smart Analog IC and the debug tool is in the Data collection mode graph data is not acquired through real time sampling analysis Instead a sam pling method specific to Smart Analog is used to acquire data and display graphs RH850 Variable values and addresses The address and value are determined based on the PC value in PEn currently selected in the Debug Manager panel Register values The value in PEn currently selected in the Debug Manager panel is acquired The area that can be read by this function The contents of memory can be read for access in all PEs In the Local RAM self area note that they can be read only for the access in PEn currently selected in the Debug Manager panel The target area from which you can read using the RRM function RAM monitor pseudo RRM function varies depending on the microcontroller being selected in the project and the debug tool used For details on the relationship between the RRM function RAM monitor pseudo RRM function and their target area see
54. see 3 3 Real time Sampling Analysis Cautions 3 When Trace data analysis is specified as the method for acquiring the graph data also see 3 4 Trace Data Analysis Cautions 4 E1 E20 RL78 To graph the collected data for Smart Analog a monitor program for collecting data must be linked to the execution program Remarks 1 See 4 Display graphs for details on when graphs on this tab are updated Remarks 2 You can restore graphs currently being displayed on this tab by loading the analysis chart data file mtac which saves the data of the graphs see 6 Save the graph data to restore the graph Remarks 3 If the acquired graph data exceeds the buffer capacity 10000 plots then the oldest graph data is over written by the new graph data ring buffer system In this case part of the graph rendering will be blank Remarks 4 The Channel information area and Cursor information area can be shown hidden by clicking the mark on the center of their splitter Figure A 11 Analysis Chart Panel Variable Value Changing Chart Tab BERT uh ghi ERE Foi Pabe Ha Dus Dening F bay e aae Cece A Page ED Gab eng B teni Y Eh v Tir a Ones Comer iihi Tru Tarna 4 7a 2T chi 2 1 jl a s T Splitter d an TELAN kuoria ona Splitter 3 T wn 5 ye ISS Gin T Varable Vabre harping Cheri li Berution TeeelPercertege art The following items are explained here How to op
55. select Function List File mtfl or Variable List File mtvl from the drop down list in the Files of type area R20UT3461EJ0100 Rev 1 00 ztENESAS Page 39 of 163 Aug 01 2015 CS V3 02 00 2 FUNCTIONS Next enter a file name of your choice for the information file in the File name area Note however that the file extension must be mifl for a function list file and mtvl for a variable list file Click the Save button to generate the information file in the specified folder with the specified file name Remark If you also need information about functions variables defined outside the active project specified here then generate a separate information file using the same procedure b Export information files automatically This operation will automatically generate information files with all the functions variables displayed in the Func tion List panel Variable List panel each time a build rebuild is executed To do this specify Yes with the Export the functions and variables property in the Import Export category on the Settings tab of the Property panel and then specify a file name of your choice for the information files in the Export file name for functions Export file name for variables property Note however that the file extension must be mifl for a function list file and mtvl for a variable list file If you specify a relative path specify the project folder as the base Figure 2 21 Imp
56. the Edit menu Description of each area 1 Search condition area Configure the search conditions If multiple search conditions are specified then only a function variable meeting all conditions will be searched a Function Variable Name Specify a function name variable name to search You can either type character strings directly into the text box up to 2046 characters or select one from the input history via the drop down list up to 10 items The previous specified function name variable name is displayed by default if it does not exist then this is left blank lt 1 gt Condition From the following drop down list select the condition for the character strings specified with Function Vari able Name equals Searches for the function names variable names that exactly matches the specified string begins with Searches for function names variable names starting with the specified string R20UT3461EJ0100 Rev 1 00 ztENESAS Page 155 of 163 Aug 01 2015 CS V3 02 00 A WINDOW REFERENCE ends with Searches for function names variable names ending with the specified string contains Searches for function names variable names containing the specified string default Remark You can also specify the function name variable name with any one of the following methods Drag and drop an arbitrary row of the Function List panel Variable List panel to this area Drag and drop an arbitrary character strin
57. the clipboard cannot be pasted to this panel Note RX For combination break events this item is valid only when the combination condition is OR R20UT3461EJ0100 Rev 1 00 ztENESAS Page 104 of 163 Aug 01 2015 CS V3 02 00 A WINDOW REFERENCE Analysis Chart panel This panel is used to display charts of the acquired function information and variable information including the data information for Smart AnalogN See 2 13 Display Analysis Information in Chart for details on how to display the chart in this panel Note E1 E20 RL78 This feature is supported only when the selected microcontroller incorporates Smart Analog IC Figure A 10 Analysis Chart Panel Toolbar E ape rettd jf Taping Sampling fates yoa Zm i Py j T Aao ahei E Ei Paie EA Dae eing Ebar r aaae palai A Faa E n Bann GO imaij Yit iia Tepe Ons ComerE diek Tra Taa W aT chi oh chl da oh iere Ti pete iut yu a Pe 1h Fey US Pye UTE Cerne Tre es Fa ea rare ren ae TD Varabbe Water Charging Chart Bertin Tien Feeria m The following items are explained here How to open Description of each area Toolbar File menu Analysis Chart panel dedicated items How to open On the toolbar in the Main window click the button From the View menu select Program Analyzer gt gt Analysis Chart Description of each area 1 Chart are
58. the detailed information are changed when each tab is selected In this panel a following tab is contained see the section explaining the tab for details on the display setting Settings tab Variable Value Changing tab Edit menu Property panel dedicated items The Edit menu for this panel provides the following items and functions Undo Undoes the latest property value editing being done Cut Deletes the selected character string s and copies them to the clipboard while edit ing the property value Copy Copies the contents of the selected range to the clipboard as character string s Paste Pastes the contents of the clipboard to the property value while editing the property value Delete Deletes the selected character string s while editing the property value Select All Selects all the character strings in the selected property while editing the property value Context menu The context menu displayed by right clicking on this panel provides the following items and functions 1 While not editing the property value Reset to Default Restores the selected setting of the property item to default value Reset All to Default Restores all the selected settings of the property items on the tab to default value 2 While editing the property value Undo Undoes the latest property value editing being done Cut Deletes the selected character string s and copies them to the clipboa
59. the file is write disabled the same operation is applied as the selection in Save Output Tab Name As Save Output Tab Name As Opens the Save As dialog box to newly save the contents that are displayed on the currently selected tab to the specified text file txt Edit menu Output panel dedicated items The Edit menu for this panel provides the following items and functions Copy Copies the contents of the selected range to the clipboard as character string s Select All Selects all the messages displayed on the currently selected tab Find Opens the Find and Replace dialog box Replace Opens the Find and Replace dialog box Context menu The context menu displayed by right clicking on this panel provides the following items and functions Copy Copies the contents of the selected range to the clipboard as character string s Select All Selects all the messages displayed on the currently selected tab Clear Deletes all the messages displayed on the currently selected tab Tag Jump Opens the Editor panel and jumps to the number of the corresponding line in the corresponding file of the message at the caret position Stop Searching Cancels the current search operation However this item is not displayed when a search is not being executed Help for Message Displays help for the message on the current caret position This item only applies to warning messages and
60. the memory of the host machine even when all panels provided by the analysis tool are closed The time required to open a panel of the analysis tool next time will be reduced Ask whether cancel the result of analysis or not when out of memory error occurred R20UT3461EJ0100 Rev 1 00 Aug 01 2015 Select whether to save the memory capacity by deleting the result of analysis or to display the incomplete result of analysis without deleting it when an insufficient mem ory error occurs during a processing of analysis Note however that the operation of CS may become unstable if the result of analy sis is not deleted Default Yes Modifying Select from the drop down list Available values Yes Displays a message dialog box prompting you to select whether or not to delete the result of analysis when an insufficient memory error occurs ztENESAS Does not display a message dialog box and deletes the result of analysis when an insufficient memory error occurs Page 72 of 163 CS V3 02 00 A WINDOW REFERENCE Notes 1 Notes 2 Notes 3 Table A 2 Micro controller The settings on the following property of your build tool s Property panel CC RH CC RL Common Options tab gt gt Output File Type and Path category gt gt Output cross reference infor mation property CC RX Compile Options tab gt gt Others category gt gt Output cross ref
61. using the RL78 microcontroller If sampling of the variable takes place between the two steps an incorrect value may be read out because the assign ment is not completed Example When using the RL78 microcontroller In this example if sampling takes place before 2 is executed the value of variable value_a in which only the assignment to the two lower order bytes has been completed is read out C source text long int value_a 0 Definition of a 4 byte variable void func void value_a 4000000000 Assignment to a 4 byte variable Assembly instructions for the assignment processing above MOVW AX 2800H MOVW _ value_a AX 1 Assignment to the two lower order bytes of variable value_a MOVW AX 0EE6BH MOVW _ value_a 2 AX 2 Assignment to the two upper order bytes of variable value_a R20UT3461EJ0100 Rev 1 00 7tENESAS Page 59 of 163 Aug 01 2015 CS V3 02 00 3 CAUTIONS 3 4 Trace Data Analysis Notes on acquisition of graph data through Trace data analysis are listed below It is not possible to display changes in values in the following case In sections where variables have been assigned to registers via compiler optimization because reads writes of variables in such sections cannot be acquired as trace data When a 2 byte region is written in units of 1 byte or a 4 byte region is written in units of 1 or 2 bytes When the debug tool or OCD internal t
62. variables Ho Analysis Chart The number of fanctiors displaying in the Executeon Time Pencentage Chart 10 The following items are explained here How to open Description of each area Edit menu Property panel dedicated items Context menu How to open On the Project Tree panel select the Program Analyzer Analyze Tool node and then select Property from the View menu On the Project Tree panel select the Program Analyzer Analyze Tool node and then select Property from the context menu Remark If the Property panel has been opened the detailed information on the analysis tool is displayed by selecting the Program Analyzer Analyze Tool node on the Project Tree panel Description of each area 1 Detailed information display change area In this area the detailed information on the analysis tool is displayed by category in the list Also you can directly change its settings The H mark indicates all the items in the category are expanded The H mark indicates all the items are shrink You can expand shrink the items by clicking these marks or double clicking the category name For details on the information how to setup in the category and property items contained in it see the section explaining the corresponding tab R20UT3461EJ0100 Rev 1 00 ztENESAS Page 67 of 163 Aug 01 2015 CS V3 02 00 A WINDOW REFERENCE 2 Tab selection area Categories for the display of
63. 0 Rev 1 00 tENESAS Page 46 of 163 Aug 01 2015 2 FUNCTIONS CS V3 02 00 2 FUNCTIONS Figure 2 29 Channel 7 16 Category E1 E20 RL78 4 Channel 1 VariableiAddress 1 AH_i Value per grid Val Div 1 25 5 Offset 1 2M8 Calor 7 E 192 255 10 79 2 Specify the method for acquiring the graph data There are three ways to acquire the data for graphing as shown below Select the method in the Analysis method property in the General category on the Variable Value Changing tab of the Property panel in accordance with the purpose Cautions 1 The method for acquiring the graph data cannot be changed during execution of a program Cautions 2 f graph data has already been acquired then changing this setting will cause the stored graph data to be deleted the graph being displayed will be erased Figure 2 30 Analysis method Property 4 General Anabysis method Siart stop real time sampling Reeltime sampling Auto adjustment Anahysis of trace data Time per gnd Time Dre nad from file Table 2 10 Method for Acquiring Graph Data Method for Acquiring Graph Description Data Real time sampling analysis Select Real time sampling in this property This method displays graphs based on the data acquired via the RRM func tion RAM monitor pseudo RRM function of the debug tool default E1 E20 RL78 If the debug tool is set in the Data collection mode then the data will be collected using a sampling met
64. 1 2015 CS V3 02 00 3 CAUTIONS 4 Class Member panel The updated static analysis information will be displayed The dynamic analysis information is not updated 5 Variable Value Changing Chart zoomed in panel The previous display contents will be displayed 3 6 When CC RX C Source Files Is Used 1 Function List panel The following cautions apply to template functions and member functions defined in template classes No Definition will appear in the File Name column Only the types will be displayed in the Arguments column The argument names will not be displayed will appear in the Start Address and End Address columns of member functions defined in template classes If appears in the Start Address column you will not be able to jump to the Editor panel Disas semble panel or Memory panel Find All References from the context menu does not display the locations of definitions Information about the referencing functions and variables is also not displayed This feature does not count the number of function references in template functions and member functions defined in template classes Similarly reference information does not appear via Find All References from the context menu It is not possible to set breakpoints at the start of member functions defined in template classes via Set Break to Function from the context menu Ifa member function defined in a class declaration is o
65. 1EJ0100 Rev 1 00 ztENESAS Page 111 of 163 Aug 01 2015 CS V3 02 00 A WINDOW REFERENCE i a Cursor These two cursors Cursor A and Cursor B are used to check the time and value on the X axis time or Y axis value Under Cursor selection buttons select the X axis Time button to perform a cursor measurement for the X axis time and the Y axis Value button to perform it for the Y axis value The measurement results are listed in the Cursor information area Use the following operations to show or hide the cursors the cursors are hidden by default Cursor Setting Show Clear Setting Hide Cursor A Ctrl key mouse click Ctrl key mouse double click Cursor B Ctrl key mouse right click Ctrl key mouse right double click Cautions 1 Cursor A and Cursor B are not displayed during execution of a program Cautions 2 When the X axis Time button is selected for the target axis you cannot set the cursors in the area on the left of Os regardless of whether the graph data exists Remark The color of each cursor can be changed via the Cursor A color Cursor B color property in the General category on the Variable Value Changing tab of the Property panel Zoom frame Indicates the zoom range displayed in the Variable Value Changing Chart zoomed in panel see c Zoom You can specify different zoom ranges for four different Variable Value Changing Chart zoomed in
66. 2 5 Pop up Display of Function Variable Information Pa ee 1 Variable box combination _ cale j URI V mane 256 Function box global_a i fs mainh 3 l gt Function name combinationfl_eallerdl Variable name global_a Location main c 256 Location main h 3 CA Testisre CATestsre Recursive call count 1 Execution 1 Times Circular call count combimatron_calll 1 Execution 1 Tomes Dynamic call count sub fpi 1 Times 5 Search for a function variable You can search for an arbitrary function variable existing in the call graph To do this click the Ea button on the Call Graph panel s toolbar to open the Call Graph Search dialog box In this dialog box follow the steps below R20UT3461EJ0100 Rev 1 00 tENESAS Page 21 of 163 Aug 01 2015 CS V3 02 00 2 FUNCTIONS Figure 2 6 Search for Functions Call Graph Dialog Box Cal Graph Search Seam onde FunciionVarails ane Gorim Specify Function Variable Name Specify a function name variable name to search You can either type character strings directly into the text box up to 2046 characters or select one from the input history via the drop down list up to 10 items Next to specify conditions for the specified character strings select the desired conditions in the Condition combo box contains is selected by default Searches are case insensitive if the Case sensitive check box is selected Remark You can also specify the function na
67. 2 7 Jump to Defined Location Note however that this function cannot be used while scrolling via the mouse dragging is being enabled by the E button In this case select the target function with the Target Function Name combo box then select Jump to Source from the context menu b Variable box In the details view mode a global variable a static variable inside a file or a static variable inside a function accessed from the target function is displayed in a box format The following information is displayed in a variable box R20UT3461EJ0100 Rev 1 00 Aug 01 2015 ztENESAS Page 120 of 163 CS V3 02 00 A WINDOW REFERENCE Figure A 22 Information of Variable Box Variable name t gt shahic_olobal_aa Read count Write count Definition t gt subli c 7 Condition PM information RH850 LOR wo lt _ Reference count stahco lt Attribute Variable name Indicates the name of the target variable If the target variable is a static variable inside a function then this will be displayed in the format of Variable name Function name Definition Indicates the location at which the target variable is defined with File name Line number Note however that if the definition information does not exist then this will display No Definition Attribute Indicates the attribute of the target variable Static variable lt static gt Static variable
68. 82 2 558 5141 2015 Renesas Electronics Corporation All rights reserved Colophon 4 0 CS V3 02 00 RENESAS Renesas Electronics Corporation R20UT3461EJ0100
69. A WINDOW A 1 Description Revision Record REFERENCE zeurera tia et btn Sobers oath ie EE e eer sees 62 CS V3 02 00 1 GENERAL 1 GENERAL This chapter describes an overview of the analysis tool Program Analyzer 1 1 Summary The analysis tool is a component provided by CS It supports the analysis of the behavior of programs developed for RH850 family RX family RL78 family 1 1 1 What is analyzed The analysis tool only analyzes C C source files including header files in a project being set to the active project in the Project Tree panel Consequently assembler source files are not analyzed Note however that symbols defined in assembler source files that are referenced from C C source files are analyzed Cautions 1 C source files are only supported by CC RX Cautions 2 If the target project to be analyzed satisfies the conditions shown below the analysis tool cannot be used A debug dedicated project A boot loader for multi core project RH850 A project in which a non supported build tool is registered A project in which no build tool is registered Remark It is possible to forcibly display the function variable information for C C source files and header files in a project other than the active project by importing information files function list file mtfl variable list file mtvl see 2 12 Import or Export Information File for details Among the above files that can be analyzed
70. A WINDOW REFERENCE Filter Settings dialog box This dialog box is used to set the filter conditions when filtering the display of analysis information on the Function List panel Variable List panel Caution The filtering configured via this dialog box and the Filtering results linked to panel are mutually exclusive functions For this reason the two filtering functions here cannot be enabled simultaneously when one of the filters is active setting the other filter will disable all filters set to date See 2 6 5 Filter the analysis information for details on the display filter Figure A 46 Filter Settings Dialog Box Filter Settings Filter conditions 2 AND OR 1 4 foul he companson value he FF or Function buttons The following items are explained here How to open Description of each area Function buttons How to open On the Function List panel Variable List panel click the filter icon 4 F and then select the Custom Description of each area Configure the filter conditions In the First condition setting area top Second condition setting area bottom you can specify up to two conditions Use the Logical operator buttons AND OR to set the two conditions as a single filter condition 1 First condition setting area top Second condition setting area bottom a Comparison value left combo box You can either type the comparison value o
71. FR p i Channel number j n Tra rE R Channel information area ie Variable name check box Ai Vora ble Vober OPPPRRRP Ee 7 pa a A a mp ai x Cautions 1 A graph is displayed based on trace data or real time RAM monitoring results acquired by the debug tool To display a graph see cautions of a Trace function or b RRM function RAM monitor pseudo RRM function Cautions 2 When Real time sampling analysis is specified as the method for acquiring the graph data see 3 3 Real time Sampling Analysis Cautions 3 When Trace data analysis is specified as the method for acquiring the graph data see 3 4 Trace Data Analysis Cautions 4 E1 E20 RL78 To graph the collected data for Smart Analog a monitor program for collecting data must be linked to the execution program Remark You can change the display range of the cursor information area and channel information area by moving the splitter with the mouse In addition these areas can be shown hidden by clicking the mark on the center of their splitters The procedure for displaying the chart is as follows 1 Register graphing targets Register the item to graph a When graphing variable register address other values b When graphing the data collected for Smart Analog E1 E20 RL78 Caution Graphing targets cannot be registered in the condition below During execution of a program When the Analysis method property in th
72. Inner Types node is displayed as necessary e Alphabet group This displays nodes in alphabetical order regardless of their classes or access specifiers AH Typedefs a Global Functions and Variables i Define Macros and Constants R20UT3461EJ0100 Rev 1 00 ztENESAS Page 130 of 163 Aug 01 2015 CS V3 02 00 A WINDOW REFERENCE Node Note ag Class name CC RX Ne 1 These are displayed in alphabetical order Interface name CC RX e 1 a Struct type name 1 4 Union type nameNte 2 gP Enum type name Notes 1 CC RX Base Types node Derived Types node and Inner Types node are displayed as necessary Notes 2 CC RX Inner Types node is displayed as necessary Cautions 1 Typedefs node Global Functions and Variables node Define Macros and Constants node is not dis played if no information displayed in the Functions Variables list area exist Cautions 2 CC RX When C source files are subject to analysis the alternative name of a namespace is not dis played Remarks 1 When the mouse cursor is hovered over a xxx name node except for a file name node the namespace name to which it belongs appears in a pop up However if it belongs to a global namespace or an anonymous namespace then or lt unnameds gt will appear If the mouse cursor is hovered over a namespace name node the namespace name to which it belongs upper namespace name will appear Remarks
73. NS 2 10 Register Watch Expressions You can register variables on the Variable List panel as watch expressions in the Watch panel Watch1 To do this drag and drop the row of the target variable multiple selections possible directly onto the Watch panel Watch1 Cautions 1 This operation is disabled while disconnecting from the debug tool Cautions 2 This operation is disabled for the Total row Remark The name of the watch expression registered in the Watch panel differs depending on the type of the tar get variable as follows Global variable variable name Static variable inside a file file name variable name Static variable inside a function file name function name variable name Class variable class name variable name R20UT3461EJ0100 Rev 1 00 RENESAS Page 37 of 163 Aug 01 2015 CS V3 02 00 2 FUNCTIONS 2 11 Display List of Referencing Location You can find and display a list of locations referencing a function variable on the Function List panel Variable List panel To do this select the row in which the target function variable is displayed multiple selections possible then from the context menu select Find All References The results of the search are output to the next Output panel s Find References tab Figure 2 19 Sample List of Locations Referencing Function Output Panel Start of Finding all fefecences Target subo1 1 Defisnttien eubdl e S ant tant arg int
74. Numeric representation Decimal XXXX Hexadecimal OxXXXXX All trademarks or registered trademarks in this document are the property of their respective owners TABLE OF CONTENTS 1 GENERAL r tate ori tern ete te oh Rite he Biro Lotshs Aad hte ole BIE okie nic lores ey GCA au a 6 1 1 SUMMA ets e a rte edt Stele A ee ie Mbit adr ohana Ste os r cae oie hate ti a r 6 1 1 1 What is analyZed ter ti ehoiaealeterdidcsie tet ohh eta desk Reh pia ea et ah aoa ees 6 1 1 2 Types of analysis information s s eate geiau eae Wee hehe See eae deta ee ee 7 1 2 Featuress edy 2 pte bal Gath all a a tin thd dela id ah ei bed Ae ee pol Bh Reet oe E 10 2 FUNG TIONS va rearua GS ah Reh d end ds Ape AURA aa Aish Arn Ane aE haaa 14 2 1 OVENVIEW 2 20 46 bad Ata el Bh hehe Lat bd CA ed BEES Chek ALE abe ah had 14 2 2 Display Function Information 0 0 0 eee ete 18 2 3 Display Variable Information 0 0c tnt tenes 19 2 4 Display Calling Relationships between Functions Call Graph 0 0 0 0 cc eee eee 20 2 5 Display Class Function Variable Information 000 c cece cette eee eae 24 2 6 Customize Display Method 0 ccc cece ttt 26 2 6 1 Set the columns to display wi e a tee ta nee ei ae el eed eb ei i eee 26 2 6 2 Change the order of the columns to display 000 cc cece tte 27 2 6 3 Lock the specific column to display 0 0 cece tnt 28 2 6 4 Sort the analysis information sasis mea tok et eee G Red
75. Output panel Program Analyzer The following cascade menus are displayed to open panels for the analysis tool R20UT3461EJ0100 Rev 1 00 2tENESAS Page 63 of 163 Aug 01 2015 CS V3 02 00 A WINDOW REFERENCE Function List Opens the Function List panel Variable List Opens the Variable List panel Analysis Chart Opens the Analysis Chart panel Call Graph Opens the Call Graph panel Class Member Opens the Class Member panel 2 Toolbar The toolbar for the analysis tool provides the following items and functions default Opens the Function List panel The function of this item is the same as that of Function List in the View menu Opens the Variable List panel The function of this item is the same as that of Variable List in the View menu Opens the Analysis Chart panel The function of this item is the same as that of Analysis Chart in the View menu Opens the Call Graph panel The function of this item is the same as that of Call Graph in the View menu Opens the Class Member panel The function of this item is the same as that of Class Member in the View menu 3 Panel display area This area consists of multiple panels each dedicated to a different purpose See the following sections for details on a panel used by the analysis tool Project Tree panel Property panel Function List panel Variable List panel Analysis Cha
76. Page 129 of 163 Aug 01 2015 CS V3 02 00 A WINDOW REFERENCE Note 2 Interface name Se Struct type name 2 s Union type nameN te 3 Enum type name Notes 1 Function classes and other elements that do not belong to any namespace including when they are in C source file are displayed in the same manner in the Global instead of Namespace name If an element is defined in an anonymous namespace its Namespace name will be Anonymous lt File name gt and it will be displayed in the same way Notes 2 CC RX Base Types node Derived Types node and Inner Types node are displayed as necessary Notes 3 CC RX Inner Types node is displayed as necessary d File group This classifies and displays the files in which the class or other elements are defined Nodes of the same type are displayed in the access specifier order see a Category group default and nodes with the same access specifier are displayed in alphabetical order c_ File nameNe 1 aH Typedefs a Global Functions and Variables Define Macros and Constants bars Class name CC RX e 2 Interface name CC RX Ne 2 qp Struct type nameN 2 a Union type nameN te 3 Enum type name Notes 1 The icon displayed differs depending on the type of the file Notes 2 CC RX Base Types node Derived Types node and Inner Types node are displayed as necessary Notes 3 CC RX
77. Page 150 of 163 Aug 01 2015 CS V3 02 00 A WINDOW REFERENCE Column Chooser dialog box This dialog box is used to sort show hide the items columns displayed on the Function List panel Variable List panel If the Customize Display Method operation has been performed on one of the panels then this dialog can also be used to reset these customizations to the default settings Figure A 43 Column Chooser Dialog Box For Function List Panel Amnibute Ratum Type Arguments Count Arguments Code SirefEytes Stack Size Byies Start Address End Address Relerence Couri Execution Count Execution Timefns Execuben TimelPercentage Execution Time verage n3 Code Coveragel s 1 Ei K F cal i E K gt Function buttons Venable Hama File Hame Fonction Hame Fite Path E import J Atnibute F Type Members 1 F Address F SizelBytes W Reference Coud J Read Count P is Count Readivinie Count Minimum Valor Maximum Vabue Dats Coverage Function buttons oes R20UT3461EJ0100 Rev 1 00 2tENESAS Page 151 of 163 Aug 01 2015 CS V3 02 00 A WINDOW REFERENCE The following items are explained here How to open Description of each area Function buttons How to open On the Function List panel click the E button On the Variable List panel click the E button Description of each area 1 Item list area This ar
78. Rev 1 00 Aug 01 2015 ztENESAS Page 95 of 163 CS V3 02 00 A WINDOW REFERENCE Edit menu Function List panel dedicated items The Edit menu for this panel provides the following items and functions Copy Copies the contents of the selected column multiple selections possible to the clipboard as character strings separated by tabs Note that the contents of the clipboard cannot be pasted to this panel Select All Context menu Selects all the columns being displayed in this panel The context menu displayed by right clicking on this panel provides the following items and functions Find All References Displays a list of the locations referencing the function s of the selected row s in the Output panel s Find References tab see 2 11 Display List of Referencing Location Set Break to Function Sets a breakpoint at the first line of the function at the current row the first execut able line in the target function see 2 9 1 Set a breakpoint to a function Note that this item is disabled while disconnecting from the debug tool Jump to Source Opens the Editor panel and displays the source file in which the function of the cur rent row is defined see 2 7 Jump to Defined Location Jump to Disassemble Opens the Disassemble panel Disassemble1 and displays the disassemble data corresponding to the start address of the function of the current row see 2 7 Jump to Defi
79. The display format is as follows Function name Execution time unit Function name Indicates the name of the target function CC RX If the target function is a member function then this will be displayed in the for mat of Class name Function name Execution time unit Indicates the execution time of the target function this is the same value as the Execution Time unit in the Function List panel The Unit can be changed by the Unit of time property in the General category on the Settings tab of the Property panel main 19 11 w subi 702 sub02 F 580000 ns Oilers 34 72 OW 7 48 oe SU b moin _subllistotic 550s Se subti subti G06 sub0 _sub01 605 R20UT3461EJ0100 Rev 1 00 ztENESAS Page 115 of 163 Aug 01 2015 CS V3 02 00 A WINDOW REFERENCE Call Graph panel This panel is used to display the tree structured chart call graph that indicates calling relationships between functions The following types of function variable are displayed in this panel Global function Static function Member function only when C source files are subject to analysis CC RX Global variable Static variable inside a file Static variable inside a function Class variable only when C source files are subject to analysis CC RX Note however that the function information and variable information in the files not to be an
80. The reference point of the relative path is the project folder Note that if this property is left blank no files will be generated This property appears only when the Export the functions and variables property is set to Yes Default ProjectName mttfl Modifying Directly enter from the keyboard Available values Up to 259 characters Export file name for vari ables R20UT3461EJ0100 Rev 1 00 Aug 01 2015 Specify the name of the variable list file mtvl generated The extension mtvl cannot be changed If the extension is omitted mtvl is appended Note that if this property is left blank no files will be generated The following placeholders are supported ProjectName ActiveProjectName Replaces itself with the project name Replaces itself with the active project name The reference point of the relative path is the project folder This property appears only when the Export the functions and variables property is set to Yes Default ProjectName mivl Modifying Directly enter from the keyboard Available values Up to 259 characters ztENESAS Page 76 of 163 CS V3 02 00 A WINDOW REFERENCE 4 Analysis Chart The detailed information on analysis graphs is displayed and its configuration can be changed For details on the analysis graph see 2 13 Display Analysis Information in Chart Caution The contents of the Analysis Chart
81. Use trigger function property is set to Yes Default Os Modifying Directly enter from the keyboard Note that changes cannot be made during execution of a program Available values The value in decimal number within the following range te 0 to the value of the Time per grid Time Div property x 10 Trigger mark color Note Specify the color of the trigger marks that indicate trigger level and the trigger posi tion This property appears only when the Use trigger function property is set to Yes Default Color Orange Modifying Specify with the color selection combo box or directly enter from the keyboard Note that changes cannot be made during execution of a program Available values When directly enter from the keyboard The value in decimal number hexadecimal number prefix 0x is needed or the color name see About the specification of the color If the unit s ms us us ns case insensitive is omitted it will be handled as ms If the specified value is greater than the value of Time per grid Time Div x 10 then the value of Time per grid Time Div x 10 is automatically specified to this property 3 Smart Analog E1 E20 RL78 The information on the Smart Analog function is displayed and its configuration can be changed Caution This category appears only when the selected microcontroller incorporates Smart Analog IC and
82. WINDOW REFERENCE Description of each area 1 Header area This area displays the column name File Name Category and Defined Symbol Count of the file information You can change the display order of the columns displayed by dragging and dropping the column name to an arbi trary column Furthermore you can sort the contents in the File information display area by clicking each column name clicking repeatedly cycles the sort order between ascending descending and the default display i e in the order on the project tree In this case if the items to sort are numbers decimal or hexadecimal then the file information is sorted by numerical value for other types of data e g strings the file information is sorted by character code Caution The display order of the columns and the order of the contents in the file information area cannot be restored This dialog box is always opened in the default condition 2 File information display area This area displays a list of C C source file names currently being registered in the project and their information a File Name Displays the C C source file name or the category name surrounded by Specify the check boxes of each file name to analyze that file Analyzes this file C Does not analyze this file Remarks 1 If a check box of a category name is cleared then all of the check boxes of the file names that belong to the category will be cleared Remarks
83. a This area displays a chart relating to the acquired function information variable information 2 Tab selection area The type of chart is switched when a tab is selected In this panel a following tab is contained see the section explaining the tab for details on the display setting Variable Value Changing Chart tab Execution Time Percentage Chart tab Remark A i mark is displayed on the tab if a message relating to the chart information has been output to the Output panel R20UT3461EJ0100 Rev 1 00 ztENESAS Page 105 of 163 Aug 01 2015 CS V3 02 00 A WINDOW REFERENCE Toolbar The toolbar provides the following items and functions Acquires the latest data from the debug tool and updates the contents of this panel Note that this item is disabled if no registered variables exist Displays the latest information automatically by acquiring the information each time program execution stops Note that this item is disabled if the Refresh at program stop property in the General cate gory on the Settings tab of the Property panel is set to other than Specify Individually this button is locked in accordance with the setting on the Property panel File menu Analysis Chart panel dedicated items The File menu for this panel provides the following items and functions Save Analysis Chart Data Overwrites the contents that are displayed on the currently selected tab to the pre viously s
84. a acquired by the debug tool For this reason you should enable Trace function RRM function RAM monitor pseudo RRM function or Cover age function IECUBE E20 RX Simulator to acquire dynamic analysis information The analysis tool does how ever provides the following property that automatically enables all of the above functions of the debug tool Property panel gt gt Settings tab gt gt General category gt gt Enable dynamic analysis information property By setting this property to Yes it is possible to use the above debug tool s functions regardless of the debug tool s configuration Note that if this property is set to No default the current setting in the debug tool will take precedence Cautions 1 You must connect to the debug tool after the completion of the setting above It is necessary to re connect to the debug tool if you change this setting during debugging Cautions 2 Functions that the debug tool does not support cannot be enabled For some debug tools the following functions are mutually exclusive In that case the priority is as follows Trace function gt RRM function RAM monitor pseudo RRM function gt Coverage function Cautions 3 The dynamic analysis information cannot be acquired when the program analyzer tool or task ana lyzer tool provided by RI series is used The dynamic analysis information that each debug tool s function provides to the analysis tool is as follows a Trace
85. a collection R20UT3461EJ0100 Rev 1 00 ztENESAS Page 50 of 163 Aug 01 2015 CS V3 02 00 2 FUNCTIONS a c channel property in the Smart Analog category on the Variable Value Changing tab of the Property panel and run the program again in the data collection mode the first transition point in the graph may be incorrect Remark There are limitations to the trace memory area of the debug tool Consequently if the graph is displayed via Trace data analysis then we recommend setting a Point Trace event for the graphing target in the Watch panel in order to display transitions of values over a wider range The display of this graph can be configured as follows Limitation of graphs displayed You can select the graph to be displayed In the default condition all graphs of channels where the graphing target is being registered are displayed To hide a graph clear the Variable name check box corresponding to its channel number Selection of the chart type When Real time sampling analysis is selected you can select the chart type to be displayed To change the chart type set the Chart type property in the General category on the Variable Value Chang ing tab of the Property panel note however that if Trace data analysis is selected then the chart type is fixed to Step line chart Line chart Creates a graph linking each plot via straight lines default Step line chart Creates a graph linkin
86. a displays a zoomed view of the range selected on the graph in the Variable Value Changing Chart tab of the Analysis Chart panel The function of each item displayed in this area is as follows a X axis time Displays the passage of time b Time Div Displays the time per grid unit 10 of the total time for the zoom range set in the Variable Value Changing Chart tab of the Analysis Chart panel This value cannot be changed c Latest time Displays the latest time corresponding to the zoom range set in the Variable Value Changing Chart tab of the Analysis Chart panel d Y axis value Displays the values of the registered graphing target The value per grid unit Val Div is 10 of the value difference between maximum and minimum for the zoom range set in the Variable Value Changing Chart tab of the Analysis Chart panel for each channel cannot be changed If the origin value 0 exists in the zoom range the axis line represented it will be displayed as a dotted line in the rendering color of each channel Caution If the graph data obtained from the data source exceeds the minimum maximum of the display range above then nothing will be displayed on the graph for that segment e Pop up display When the mouse cursor is hovered over a transition location on the graph the information about that location appears in a pop up See i Pop up display for details on its display format Caution This function is disable
87. able information Call Graph panel Displays calling relationships between functions call graph Class Member panel Displays the acquired class information CC RX function information and variable information in a tree structure Variable Value Changing Chart zoomed in panel Zooms in on the specified range on the chart Output panel Displays operation logs for various components provided by CS and the refer ence list for functions variables Select Files not To Analyze dialog box Specifies files not to analyze Select Files To Analyze dialog box Specifies files to analyze Column Chooser dialog box Changes the order of the display items and the setting of display non display for the Function List panel Variable List panel Call Graph Search dialog box Searches for a function variable exists in the call graph displayed in the Call Graph panel Filter Settings dialog box Note CC RX Specifies the filter conditions to display the information on the Function List panel Variable List panel The class information is provided only when C source files are subject to analysis R20UT3461EJ0100 Rev 1 00 Aug 01 2015 ztENESAS Page 62 of 163 CS V3 02 00 A WINDOW REFERENCE Main window This is the first window to open when CS is launched In this window you can open panels for the analysis tool rane A 1 Main Window Fie Bi Wow
88. able inside a function CC RX In addition to the above the argument types of the function are also dis played in parentheses If the function is a const member function volatile member function then const volatile is displayed immediately after the function name File PathN s 1 Static analysis Displays the absolute path of the C C source file where the variable is defined Note however that if it is not defined in a C C source file in project or if analysis was not completed then this will be blank If it is defined in a header file then the absolute path of the header file is displayed PM Information RH850 Static analysis Displays the following information about PE from which the variable can be accessed From PEn PMn From common PE Common Unknown Note that this item appears only when the selected microcontroller version supports multi core Static analysis Displays the following information about the source of the variable informa tion If it was acquired from inside an active project Original is displayed If it was acquired from an import file The names of all import files are displayed If it was acquired from inside an active project and an import file Original and the names of all import files are displayed See 2 12 Import or Export Information File for details on the import func tion Access Specifier CC RX R20UT3461EJ0100 Re
89. ables bit field structures are allocated to the same address these items above will display the same value Remarks 1 If static variables inside a function with the same name are declared in a function they are handled as follows Members Address Size Bytes Read Count Write Count Read Write Count Minimum Value Maximum Value Data Coverage The information of the variable that is first declared in a function is displayed Items other than listed above The information of the variable that is first declared in a function is displayed Remarks 2 If you define a static variable in a header file and include it from more than one source file informa tion for the header file and all source files is displayed on one line Remarks 3 The display of each type of information can be customized as follows Sort the analysis information Filter the analysis information Remarks 4 The current row mark j on the left edge of this area indicates that the column in question is the current row The following operations can be performed on the current row Jump to Defined Location Register Watch Expressions Display List of Referencing Location Graph transitions in values Toolbar The toolbar provides the following items and functions Acquires the latest data from the debug tool and updates the contents of this panel Displays the latest information automatically by acquiring the information each time pro
90. acters in not case sensitive default d Parent Count If required as a search parameter for a function you can specify the number of parent functions to search You can either type a value directly into the text box settable range 0 to 65535 or select one from the input history via the drop down list up to 10 items The previous specified value is displayed by default if it does not exist then this is left blank Condition From the following drop down list select the condition for the numeric value specified with Parent Count is greater than Searches for the names of functions with more greater than the specified number of parent functions is greater than Searches for the names of functions with at least as many greater than or equal to the or equals to specified number of parent functions equals to Searches for the names of functions with the same number of equal to the specified number of parent functions default is less than or Searches for the names of functions with at least as less greater than or equal to the equals to specified number of parent functions is less than Searches for the names of functions with less greater than the specified number of parent functions R20UT3461EJ0100 Rev 1 00 ztENESAS Page 156 of 163 Aug 01 2015 CS V3 02 00 A WINDOW REFERENCE e Child Count If required as a search parameter for a function you can specify the number of child
91. all Graph panel and Variable Value Changing Chart zoomed in panel to a file 1 Save function information To do this with the focus on the Function List panel select Save Function List Data As from the File menu The Save As dialog box opens perform the operation from this dialog The following file formats can be specified when saving the information Text file txt Text format CSV Comma Separated Variables csv CSV format Microsoft Office Excel Workbook xls Microsoft Office Excel book format Function List file mtfl File format to import the function information see 2 12 Import or Export Information File Caution Only the items analysis information currently displayed in the panel can be saved 2 Save variable information To do this with the focus on the Variable List panel select Save Variable List Data As from the File menu The Save As dialog box opens perform the operation from this dialog The following file formats can be specified when saving the information Text file txt Text format CSV Comma Separated Variables csv CSV format Microsoft Office Excel Workbook xls Microsoft Office Excel book format Variable List file mtvl File format to import the variable information see 2 12 Import or Export Information File Caution Only the items analysis information currently displayed in the panel can be saved 3 Save graph informa
92. alog Box Select Files not To Analyze Function buttons The following items are explained here How to open Description of each area Function buttons How to open On the Settings tab in the Property panel select the Files not to analyze property in the Analysis Object category and then click the button R20UT3461EJ0100 Rev 1 00 ztENESAS Page 147 of 163 Aug 01 2015 CS V3 02 00 A WINDOW REFERENCE Description of each area 1 a 3 Header area This area displays the column name File Name Category and Defined Symbol Count of the file information You can change the display order of the columns displayed by dragging and dropping the column name to an arbi trary column Furthermore you can sort the contents in the File information display area by clicking each column name clicking repeatedly cycles the sort order between ascending descending and the default display i e in the order on the project tree In this case if the items to sort are numbers decimal or hexadecimal then the file information is sorted by numerical value for other types of data e g strings the file information is sorted by character code Caution The display order of the columns and the order of the contents in the file information area cannot be restored This dialog box is always opened in the default condition File information display area This area displays a l
93. also not output by the search results from Find All References in the context menu Note however that this will display if analysis is not complete Read Count Full spec emulator IECUBE E1 E20 RH850 E1 E20 RX Simulator R20UT3461EJ0100 Rev 1 00 Aug 01 2015 Dynamic analysis Displays the number of times the variable was read in decimal number notationNte 3 4 For structures and unions reads are counted at the structure union variable level the number of reads at the individual member and element levels are not shown Note however that this will display if the debug tool s Trace function is disabled or if analysis is not complete ztENESAS Page 100 of 163 CS V3 02 00 A WINDOW REFERENCE Item Type Contents Write Count Dynamic Displays the number of times the variable was written in decimal number Note 3 4 Full spec emulator analysis notation IECUBE For structures and unions writes are counted at the structure union vari E1 E20 RH850 able level the number of writes at the individual member and element lev E1 E20 RX els are not shown Simulator Note however that this will display if the debug tool s Trace function is disabled or if analysis is not complete Read Write Count Dynamic Displays the number of times the variable was read written in decimal Note 1 analysis number notationNte 3 4 Full spec emulator For structures and
94. alyzed is not displayed in this panel see 1 1 1 What is analyzed See 2 4 Display Calling Relationships between Functions Call Graph for details on how to display the call graph Cautions 1 If the debug tool to use does not support the trace function or if the debug tool s trace function is not enabled then the Dynamic analysis information e g the execution count read count write count in the call graph cannot be displayed For the dynamic analysis information also see the caution of a Trace function Cautions 2 CC RX When C source files are subject to analysis also see 3 6 When CC RX C Source Files Is Used Remarks 1 A function variable whose source file does not exist in the project can be displayed in the call graph if the Display the function variable without definition at Call Graph panel property in the General category on the Settings tab of the Property panel is set to Yes Remarks 2 This panel can be zoomed in and out 10 to 109 by in the Panel control area or by moving the mouse wheel forward or backward while holding down the Ctrl key Figure A 18 Call Graph Panel Whole View Call Graph Toolbar a Ep 1 4 B B 6 B rn mean maine 55 man ub mana 165 mubil t subDt c 3 TH euki abii sublec 14 R20UT3461EJ0100 Rev 1 00 ztENESAS Page 116 of 163 Aug 01 2015 CS V3 02 00 A WINDOW REFERENCE The following items are explained here
95. am execution Man Does not synchronize to the start stop of a program execu ual tion It can be controlled via the Sampling button on the Variable Value Changing Chart tab Auto adjustment Select whether to calculate the optimum values from the obtained graph data and specify them in the Time per grid Time Div property and Value per grid Val Div 1 16 Offset 1 16 properties for the X and Y axes of the graph see c Setting the display range E1 E20 RL78 This property does not appear when the debug tool is set in the Data collection modeNote 1 Default Only during program stop Note that None is fixed to this property if the Analysis method prop erty is set to Load from file or the Use trigger function property is set to Yes Modifying Select from the drop down list Available values Always Always adjusts the graph display automatically Only during pro gram stop Automatically adjusts the graph display only when program execution stops None Does not adjust the graph display automatically Number of transition location for auto adjust ment Specify the number of value transition points to be displayed in the rendering area when the graph display is automatically adjusted This property does not appear when the Auto adjustment property is set to None Default 20 Modifying Directly enter from the keyboard Available value
96. ame of the target directly from the keyboard into the Variable Address 7 16 property in the Channel 7 16 category on the Variable Value Changing tab of the Property panel Figure 2 27 Channel 16 Category a ianng VariablaiAddress 1 qoicount Ime Type Size 1 Auta Value per grid Val Div 1 6553 5 Offset 1 i Color 7 Be i22 255 10 79 In addition the following detailed conditions can be specified with the Channel 1 16 category for each tar get see 4 Display graphs Type Size 1 16 Type and size Value per grid Val Div 1 16 Value per grid unit in graph Offset 1 16 Offset value of graph Color 7 16 property Rendering color of graph Remarks 1 To delete the registered graphing target delete the value of the above Variable Address 1 16 property Remarks 2 The registered graphing target name is displayed at the Variable name check box on the Vari able Value Changing Chart tab lt 2 gt Registering targets separately from the other panel From the following panel drag and drop the target directly onto the Channel number or Variable name check box in this tab Variable List panelete Editor panel CPU register panel IOR panel RH850 RX SFR panel RL78 Watch panel Note The name of the graphing target displayed differs depending on the type of the variable as fol lows Global variable variable name Static variable inside a file fi
97. aph Data As from the File menu The Save As dialog box opens perform the operation from this dialog The following file formats can be specified when saving the information Note that when Only the visible part is selected only the part currently being displayed in the panel will be saved Bitmap Only the visible part bmp Bitmap format 32 bit graphic file format JPEG Only the visible part jpg JPEG format graphic file format PNG Only the visible part png PNG format graphic file format Bitmap bmp Bitmap format 32 bit graphic file format JPEG jpg JPEG format graphic file format PNG png PNG format graphic file format EMF emf EMF format graphic file format Caution All part of the call graph may not successfully be saved as a graphic file format if the project is too big Remark If the zoom function has been applied then the image will be saved at the current zoom ratio except for EMF format R20UT3461EJ0100 Rev 1 00 ztENESAS Page 58 of 163 Aug 01 2015 CS V3 02 00 3 CAUTIONS 3 CAUTIONS This chapter describes cautions for using the analysis tool 3 1 Changing Active Project If you change the active project it is possible that nothing will be shown in the Function List panel Variable List panel Call Graph panel Class Member panel because no cross reference file has been generated If this happens rebuild after setting the Enable static analys
98. area Toolbar Edit menu Class Member panel dedicated items Context menu R20UT3461EJ0100 Rev 1 00 ztENESAS Page 126 of 163 Aug 01 2015 CS V3 02 00 A WINDOW REFERENCE How to open On the toolbar in the Main window click the button From the View menu select Program Analyzer gt gt Class Member Description of each area 1 Panel control area Calegery group View Setting combo box Left combo box Selects a classification method for the tree from the drop down list Category group default Access group Namespace group File group Alphabet group Selects the last node that was selected Note that this item is disabled if there are no node selections in the history or dur ing execution of a program Selects the node that was selected before the button was clicked Note that this item is disabled if there are no node selections in the history that were selected via button or during execution of a program Target Name combo box Left combo box Specifies the character strings to search via the gt button case insensi tive You can either type character strings directly from the key board up to 512 char acters or select one from the input history via the drop down list up to 10 items Note that this item is disabled during execution of a program Searches up in the last tree to have focus for nodes conta
99. arg_b izat arg iel BReterence subjil b 3 int iint int int J Reference subdz e120 3 2 z 3i Reference main c 102 remalt local_a lacal b lorail cts Reference main lt 436 resule Mifi igla a glebal_ b glebel_el al A list of the functions which are being called by function subo1 subdd_subod A liat of the variables ding a reference read write by Function subl ial glebal_a End of finding all references EGF _ AllMessages i The following information about the referencing locations is output to the list as the search results For details on the output format see the section of the Output panel s Find References tab Performing the operation from the Function List panel Location where target function is defined List of locations referencing the target function List of functions called within the target function List of variables referenced read write inside the target function Performing the operation from the Variable List panel Location where target variable is defined List of locations referencing the target variable Caution Code in C C source files that is referenced but is eliminated by the preprocessor during compilation e g via if or ifdef statements is not output as referenced locations Remarks 1 When the function name variable name on this panel is double clicked the Editor panel appears and th
100. ation Note Toolbar The toolbar provides th Indicates the location at which the target variable is defined Note however that if the definition information does not exist then this will display No Definition CC RX When the target variable is a global variable or static variable inside a file If the target variable belongs to a namespace except for a global namespace anonymous namespace then this will be displayed in the format of Namespace name Variable name When the target variable is a class variable If the target variable belongs to a namespace except for a global namespace anonymous namespace then this will be displayed in the format of Namespace name Class name Variable name Otherwise this will be displayed in the format of Class name Vari able name When the target variable is a static variable inside a function If the target variable belongs to a namespace except for a global namespace anonymous namespace then this will be displayed in the format of Namespace name Function name Variable name Otherwise this will be displayed in the format of Function name Variable name If the target variable is a class variable then this will be displayed in the format of Class name Function name Variable name e following items and functions Acquires the latest data from the debug tool and updates the contents of this panel Note that this item is disabled during executi
101. aved file see 2 14 Save Analysis Information Note that when the file has never been saved or the file is write disabled the same operation is applied as the selection in Save Analysis Chart Data As Save Analysis Chart Data As Opens the Save As dialog box to newly save the contents that are displayed on the currently selected tab to the specified file see 2 14 Save Analysis Information R20UT3461EJ0100 Rev 1 00 Aug 01 2015 ztENESAS Page 106 of 163 CS V3 02 00 A WINDOW REFERENCE Variable Value Changing Chart tab Use this tab to display the relationship between registered variable register address other values and time by a graph line chart Furthermore when the selected microcontroller incorporates Smart Analog IC by enabling Data collection mode on the debug tool it is possible to display the collected data for Smart Analog by a graph E1 E20 RL78 You can zoom in on the range specified in this panel using the Variable Value Changing Chart zoomed in panel See 2 13 1 Graph transitions in values for details on how to display graphs on this tab Cautions 1 A graph is displayed based on trace data or real time RAM monitoring results acquired by the debug tool To display a graph also see cautions of a Trace function or b RRM function RAM monitor pseudo RRM function Cautions 2 When Real time sampling analysis is specified as the method for acquiring the graph data also
102. bi function aubol ial aub t_ auhi A ligt of the variables doing a reference read Write by function gubod giobal_a Figure A 37 Example of List of Locations Referencing Function with Dynamic Analysis Information Targes sobtil Definition sabdl eSi int ER ine aeqla det arg b inc arg cil Heference Execution Counen Dh aubdl bizi ine Milii ans ine i Reference Eaeeusien Couns Oh main eitti eegule HMP i lccerl a local b lacal erip Daferemse Eubtunien Couns 10 Bain ellach resule Mfl ciebel a glabal b glabal el 4 A Lin ef uke funeticas whies are belag called by fuacelea aubbi subl a0 K A lin f the Vartabled d iag Fetarance lad weitel b fuacs aubbi globi 1_ J b Output format of list of locations referencing a variable The output search results consist of the location where the target variable is defined and a list of locations refer encing the target variable Figure A 38 Output Format of List of Locations Referencing Variable Start of finding all references Target Target variable name Definition File name Number of lines Line 1of the location Reference Read Write Count Number File name Number of lines Line 1of the location End of finding all references Target Indicates the name of the target variable Definition Indicates the location at which the target variable is defined Note that if the information cannot be acqui
103. bsolute path of the CS install folder The reference point of the relative path is the project folder Note that if the same file is specified only the file that is first specified will be imported The name of the file to import is displayed as the subproperty Default Import files 0 Modifying Specify with the Path Edit dialog box The Path Edit dialog box is opened by clicking the button that appears at right edge in the column when this property is selected no files can be specified on the Property panel Available values Up to 64 files Export the functions and variables Select whether to generate the information files function list file mtfl variable list file mtvl with the contents of the Function List panel Variable List panel when a build or rebuild is performed Default No Modifying Select from the drop down list Available values Yes Generates the information files No Does not Generate the information files Export file name for functions Specify the name of the function list file mtfl to be generated The extension mtfl cannot be changed If the extension is omitted mtfl is appended Note that if this property is left blank no files will be generated The following placeholders are supported ProjectName ActiveProjectName Replaces itself with the project name Replaces itself with the active project name
104. c Setting the display range The time display range depends on the method for acquiring the graph data see Table 2 11 Differences Depending on Method for Acquiring Graph Data Time Div Displays the value specified in the Time per grid Time Div property in the General category on the Variable Value Changing tab of the Property panel Note that only while program execution is stopped double clicking on this label automatically adjusts the Time per grid Time Div property to an optimum value so that the specified number of value transition points of the graph fit inside the rendering area between the left and right ends see c Setting the display range Latest time Displays the latest time corresponding to the graph data Y axis value Displays the values of the registered graphing target Grid lines divided in ten are displayed The value per unit grid Val Div for each channel can be specified with the Value per grid Val Div 7 16 property in the Channel 7 76 category on the Variable Value Changing tab of the Property panel While the program is stopped the axis line representing the origin Value 0 will be displayed as a dotted line in the rendering color of each channel Caution The display range of Y axis value depends on the Value per grid Val Div 1 16 property and Offset 1 16 property setting but if the obtained value is greater than the maximum or less than the minimum nothing is displayed
105. ccess Specifier CC RX Attribute Type Members Size Bytes Note This item appears only when the selected microcontroller version supports multi core The procedure for doing this is as follows 1 Generate Export information file a Export an information file manually This operation will generate an information file with only the functions variables needed to be imported To do this first make the project in which the target functions variables are defined the active project then dis play the necessary information of the target functions variables in the Function List panel Variable List panel Next select all the rows displaying the target functions variables in this panel multiple rows can be selected by holding down the Shift Ctrl key while selecting then from the File menu select Save Function List Data As Save Variable List Data As The following Save As dialog box opens Figure 2 20 Export Information File Manually Example of Function List File Oeganire Hew eider Ei ir Lf Favorites D Pefaultbubd E bekto d tte ip Darid l subpropectid2 gt Recent Places ae Libraries Documents a Nite tee Pictures H Videos sat File perme Fundist Sub2 mtil Save as ype Function List fle Purani Hide Felden Save Canoe In the Save in area of the above dialog box select a folder of your choice in which to save the generated infor mation file then
106. check boxes in File column is not being selected or all of the check boxes in File column is not being cleared Indicates that no check box in File column is being selected default Function buttons Function Sets the specified file s to the file s not to be analyzed then closes the dialog box Ignores the setting and closes this dialog box Displays the help of this dialog box R20UT3461EJ0100 Rev 1 00 7tENESAS Page 148 of 163 Aug 01 2015 CS V3 02 00 A WINDOW REFERENCE Select Files To Analyze dialog box This dialog box is used to specify the files to be analyzed by the analysis tool see 1 1 1 What is analyzed Only the function information and variable information in the files specified to be analyzed on this dialog box are dis played in the following panels Function List panel Variable List panel Call Graph panel Class Member panel Figure A 42 Select Files To Analyze Dialog Box Select Files To Analyze 3 E Al Select Al Deselect Function buttons Cancel Hp The following items are explained here How to open Description of each area Function buttons How to open On the Settings tab in the Property panel select the Files to analyze property in the Analysis Object category and then click the button R20UT3461EJ0100 Rev 1 00 ztENESAS Page 149 of 163 Aug 01 2015 CS V3 02 00 A
107. cify the number of child functions to search You can either type a value directly into the text box settable range 0 to 65535 or select one from the input history via the drop down list up to 10 items Next to specify conditions for the specified value select the desired conditions in the Condition combo box equals is selected by default Click the Search Backward Search Forward button When the Search Backward button is clicked the search uses the specified conditions starting from the func tion name variable name at the bottom of the call graph and proceeding upward The corresponding function box variable box is highlighted R20UT3461EJ0100 Rev 1 00 ztENESAS Page 22 of 163 Aug 01 2015 CS V3 02 00 2 FUNCTIONS When the Search Forward button is clicked the search uses the specified conditions starting from the function name variable name at the top of the call graph and proceeding downward The corresponding function box variable box is highlighted If a function box variable box has been selected on the Call Graph panel then the search starts from the corre sponding function moving upward downward Figure 2 7 Location Where Function Has Been Found main mane io Mark indicating found location cicularteerencell maine 40 Remarks 1 The display contents are updated each time program execution is stopped Note however that if the Refresh at program stop pr
108. clicking the mouse on Program Analyzer Analyze Tool node Function List Opens the Function List panel Variable List Opens the Variable List panel R20UT3461EJ0100 Rev 1 00 ztENESAS Page 65 of 163 Aug 01 2015 CS V3 02 00 A WINDOW REFERENCE Analysis Chart Opens the Analysis Chart panel Call Graph Opens the Call Graph panel Class Member Opens the Class Member panel Property Opens the Property panel containing the information for the analysis tool R20UT3461EJ0100 Rev 1 00 ztENESAS Page 66 of 163 Aug 01 2015 CS V3 02 00 A WINDOW REFERENCE Property panel This panel is used to display the detailed information on the analysis tool and change the settings of the information Figure A 3 Property Panel Property AD Progam Analyzer Property 4 General Enable static analyses information Enable dynamic analysis informatbon Accumulate reseh of amahysis Include the prototype declaration as references Refresh al propre stap Unit ed ime Delinnts arguments by mew ine Display the SFR IOR Ho Display the functon yariable without definition at Call Graph panel No 1 Frees memar of host machine when all panels are closed He Ask whether cancel the result of analysis or not when out of memory error occurred Yes Select specification method of files to analyze Files mot to anabe Files not to analyze Files ng to analyze importi Expert gt Import files import fle f Export the funchons and
109. ction execution times See 2 13 2 Chart the function execution time ratios for details on how to display graphs on this tab Cautions 1 If the debug tool used does not support the Trace function or if the debug tool s trace function is not enabled then this chart cannot be displayed Even if the trace function is enabled condition if there is no trace data in the trace memory no chart is displayed on this tab and then the following message will be displayed on the Output panel There is no execution time information Cautions 2 To display this chart also see cautions of a Trace function Cautions 3 E1 E20 RX EZ Emulator RX Because the trace time tag function is not supported this chart cannot be displayed Figure A 17 Analysis Chart Panel Execution Time Percentage Chart Tab main 13 11 Others 3 72 _ sub01 7 48 sub0 7 025 main sub static 5 56 i es FOE sub0S_sub01 6 05 J 4 asub i subi 6 99 sub02_sub01 605 Variable Value Changing Chart The following items are explained here How to open Description of each area How to open On the toolbar in the Main window click the button and then select the Execution Time Percentage Chart tab From the View menu select Program Analyzer gt gt Analysis Chart and then select the Execution Time Percent age Chart tab Description of each area 1 Chart area
110. d development environment for developing applications and sys tems for RH850 family RX family RL78 family and provides an outline of its features CS is an integrated development environment IDE for RH850 family RX family RL78 family integrating the neces sary tools for the development 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 3 CAUTIONS 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
111. d during execution of a program f Cursor These two cursors Cursor A and Cursor B are used to check the time and value on the X axis time or Y axis value Under Cursor selection button select the X axis Time button to perform a cursor measurement for the X axis time and the Y axis Value button to perform it for the Y axis value The measurement results are listed in the Cursor information area R20UT3461EJ0100 Rev 1 00 ztENESAS Page 136 of 163 Aug 01 2015 CS V3 02 00 A WINDOW REFERENCE Use the following operations to show or hide the cursors the cursors are hidden by default Cursor Setting Show Clear Setting Hide Cursor A Ctrl key mouse click Ctrl key mouse double click Cursor B Ctrl key mouse right click Ctrl key mouse right double click Caution Cursor A and Cursor B are not displayed during execution of a program 3 Channel information area The display range of this area can be changed by moving the splitter with the mouse In addition this area can be shown hidden by clicking the mark on the center of the splitter by default this area is hidden Figure A 29 Channel Information Area Hem slatic_char_val lt a Variable name check box Tuay 100 lt b Val Div a Variable name check box Displays the name of a variable including register name address expression currently being registered in a channel as a graphing tar
112. d inj 1 Data source From chart data fonline Zoom cote Save E OE TEE i H i 1 i i 1 1 1 i L T i i 1 i 1 i 1 i 1 t r 1 H r r r rj 1 1 1 i r 1 l 1 1 cee eee lee L 4 i 4 l H H 4 i H 4 A F H i H H H i 4 H 4 H H H H H 1 1 H H 1 L T H 1 H H H 1 1 1 H H F Mia 207ms900ps Remarks 1 You can set separate zoom ranges for each of four Variable Value Changing Chart zoomed in panel views R20UT3461EJ0100 Rev 1 00 ztENESAS Page 53 of 163 Aug 01 2015 CS V3 02 00 2 FUNCTIONS Remarks 2 You can change the color of each zoom frame via the Zoom 7 4 color property in the General category on the Variable Value Changing tab of the Property panel 6 Save the graph data to restore the graph You can restore the graph currently being displayed by loading the analysis chart data file mtac which saves the data of the graph The procedure for restoring the graph is as follows a Save the graph data For the graph on the Variable Value Changing Chart tab When the graph to be saved are being displayed on this tab select Save Analysis Chart Data As from the File menu to open the Save As dialog box On this dialog box select Analysis Chart Data mtac in the Save as type area and specify the name of new file in the File name area and then click the Save button note that the file extension must be mtac For the
113. dard Settings Necessary for Dynamic Analysis Trace Function to Table A 4 Standard Settings Necessary for Dynamic Analysis RRM Function Default No Modifying Select from the drop down list Available Yes Ignores the debug tool s property settings and enables values the debug tool s functions forcibly Also makes the stan dard settings necessary for dynamic analysis No Gives priority to the debug tool s property settings Accumulate result of Select whether to display the cumulative value for each program execution for the analysis execution count and execution time as the analysis information The target items for this property are as follows Function List panel Execution Count Execution Time unit Variable List panel Read Count Write Count Read Write Count Minimum Value Maximum Value Call Graph panel Execution count Read count Write count Default No Modifying Select from the drop down list Available Yes Displays the sum of the measurements from the last pro values gram execution and from this one No Displays the measurements for each program execution If the value is changed from Yes to No then the current analysis results will be cleared and the measured values displayed Include the prototype Select whether to target the prototype declaration as the information of the function declaration as refer references when displaying a list of
114. e General category on the Variable Value Changing tab of the Property panel is set to Load from file i e when graphs are restored from the analysis chart data file mtac a When graphing variable register address other values The following types of items can be registered Global variable Static variable inside a file Static variable inside a function Class variable only when C source files are subject to analysis CPU register R20UT3461EJ0100 Rev 1 00 ztENESAS Page 44 of 163 Aug 01 2015 CS V3 02 00 2 FUNCTIONS IOR RH850 RX SFR RL78 Address There are three ways to register graphing targets shown below When the registration is completed the name of the registered graphing target will be displayed at the Variable name check box corresponding to the channel number in the channel information area lt 1 gt Registering targets separately on the Property panel lt 2 gt Registering targets separately from the other panel lt 3 gt Reflecting the Watch panel auto registration Caution You can register graphing targets for up to 16 channels one target per channel Note however that there may be restrictions on the number and size of targets that can be graphed depending on the debug tool used and the method by which the graph data was acquired see 2 Specify the method for acquiring the graph data lt 1 gt Registering targets separately on the Property panel Enter the n
115. e caret moves to the line where the function variable is defined Remarks 2 You can save the contents displayed on this Output panel s Find References tab to a text file txt by selecting Save Output Find References As from the File menu R20UT3461EJ0100 Rev 1 00 ztENESAS Page 38 of 163 Aug 01 2015 CS V3 02 00 2 FUNCTIONS 2 12 Import or Export Information File Information for functions or variables defined outside the active project and which are never referenced from the active project is ordinary not displayed in the Function List panel Variable List panel In this case it is possible to force this information to be displayed by importing an information file that saves the informa tion about a function variable you need The following types of information files are available Table 2 9 Types of Information Files Information Flle Name Contents Function list file mtfl Stores the information about the following items on the Function List panel Function Name Class Name CC RX Namespace CC RX File Name File Path PM Information RH850 Access Specifier CC RX Attribute Return Type Arguments Count Arguments Code Size Bytes Variable list file mtvl Stores the information about the following items on the Variable List panel Variable Name Class Name CC RX Namespace CC RX File Name Function Name File Path PM Information RH850 A
116. e defined Alphabet group Displays nodes in alphabetical order R20UT3461EJ0100 Rev 1 00 ztENESAS Page 24 of 163 Aug 01 2015 CS V3 02 00 2 FUNCTIONS Remarks 1 The following operations can be performed on the node currently being selected Jump to Defined Location Jump to Declared Location Remarks 2 CC RX When the mouse cursor is hovered over a node except for a category node Namespace name to which the node belongs appears in a pop up R20UT3461EJ0100 Rev 1 00 ztENESAS Page 25 of 163 Aug 01 2015 CS V3 02 00 2 FUNCTIONS 2 6 Customize Display Method The following operations will enable you to customize the displaying of items columns and the analysis information on the Function List panel Variable List panel All operations refer to the header area of each panel the area where the column labels are displayed Set the columns to display Change the order of the columns to display Lock the specific column to display Sort the analysis information Filter the analysis information Remark In the Column Chooser dialog box click the Default button to return all the customizations you have per formed via the operations above to the default values 2 6 1 Set the columns to display You can show or hide any of the items columns displayed on the Function List panel Variable List panel 1 Restricting the columns displayed 2 Adding columns to display 1 Restricting the colu
117. e details view that displays the parent functions and child functions of the function currently being selected specified with the Target Function Name combo box toggle Note that this item is disabled during execution of a program Notes 1 RH850 If the selected microcontroller version supports multi core you can select PMn In this case the call graph will only be displayed for the functions executed in the selected PMn PEn Notes 2 The function name differs with the selected microcontroller as follows RH850 RL78 main RX reset 2 Call graph area This area displays a call graph indicating calling relationships between functions that have been acquired from the cross reference information A call graph has the following two view modes that can be toggled by clicking the button Whole view default By default the first function to appear named main reset start 1 or containing such word is considered to be the parent function and that function is placed on the left edge of the call graph the corresponding parent function name will be displayed in the Parent Function Name combo box If there is no corresponding func tion name then the functions in the program that are not called by any other functions reference count 0 will be considered to be parent functions and they will be placed on the leftmost edge the Parent Function Name combo box will be empty Next the child functions grandchild
118. e maximum value of the float type Approx 3 4028235e 38 Values with decimals can also be specified Color 1 16 Notes 1 Specify the rendering color of the graph Default Depends on the number 1 16 N 9te 3 Modifying Specify with the color selection combo box or directly enter from the keyboard Available values When directly enter from the keyboard The value in decimal number hexadecimal number prefix 0x is needed or the color name see About the specification of the color The input format is as follows same as the input format of the Watch panel Note the following however when registering items If the variable name of a structure union or array is registered it cannot be graphed For struc tures unions and arrays the member name or element must be specified Immediate addresses are registered with a size of 1 byte Input Format Value to be Acquired Variable name of C language Value of C language variable Variable expression Variable expression Element of array Variable expression Member name Member of structures unions Variable expression gt Member name Member of structures unions that pointer desig nates Variable expression R20UT3461EJ0100 Rev 1 00 Aug 01 2015 Value of pointer variable ztENESAS Page 86 of 163 CS V3 02 00 A WINDOW REFERENCE Input Format Value to be Acquired CPU regis
119. e ratios is displayed main 19 11 Others 34 72 b t 7 48 T subOd 7 02 main_ subs static 5 56 e aub 7 02 sub0a_ subd 05 7 asubO1_sub01 6 99 R20UT3461EJ0100 Rev 1 00 ztENESAS Page 13 of 163 Aug 01 2015 CS V3 02 00 2 FUNCTIONS 2 FUNCTIONS This chapter describes the main features and operating procedures of the analysis tool 2 1 Overview The analysis information acquired by the analysis tool is displayed on the following panels Table 2 1 Panels Displaying Analysis Information Panel Description Function List panel Displays the function information Variable List panel Displays the variable information Analysis Chart panel Displays charts of the function information and the variable information Variable Value Changing Chart tao Displays changes in values of variables or data collected for Smart Analog E1 E20 RL78 line chart Execution Time Percentage Chart Displays function execution time ratios pie tab chart Call Graph panel Displays calling relationships between functions call graph Class Member panel Displays the class information cc Rx e 2 function information and variable informa tion in a tree structure Variable Value Changing Zooms in on the chart displayed in the Variable Value Changing Chart tab Chart zoomed in panel Notes 1 E1 E20 RL78 Data collection for Smart
120. e template function int templatet_use void short result 0 short s 100 char ec 200 result template_func s c return result Definition of the template function template lt typename T1 typename T2 gt T1 template_func T1l t1 T2 t2 Tl result 10 result tl t2 return result Examples 1 Display contents for the line for the definition of the template function Return Type Arguments 3 Function Name Template_func lt T 2 gt Examples 2 Display contents for the line for the function using the template function Return Type short Arguments short t1 char t2 Function Name Template_func lt T 2 gt Remarks 3 The display of each type of information can be customized as follows Sort the analysis information Filter the analysis information Remarks 4 The current row mark on the left edge of this area indicates that the column in question is the current row The following operations can be performed on the current row Jump to Defined Location Set Break Events Display List of Referencing Location R20UT3461EJ0100 Rev 1 00 ztENESAS Page 94 of 163 Aug 01 2015 CS V3 02 00 A WINDOW REFERENCE Toolbar The toolbar provides the following items and functions Acquires the latest data from the debug tool and updates the contents of this panel Displays the latest information automatically by acquiring the informatio
121. e values loaded from the file are reflected to the properties in this category and these values cannot be changed Variable Address 7 16 Specify the name of a variable or an address expression that is registered as a graph ing target see 1 Register graphing targets Note that the values of all properties in this category will be changed to the default value if the value of this property is changed E1 E20 RL78 When the debug tool is in the Data collection mode character strings specified in this property are only displayed as a label for the Variable name check box they are not handled as a graphing target Default Blank Modifying Directly enter from the keyboard Note that changes cannot be made during execution of a program Available values Up to 2046 characters e 1 Type Size 1 16 Select the type and size of the variable address to register E1 E20 RL78 This property does not appear when the debug tool is in the Data collection mode Default Auto Modifying Select from the drop down list Note that changes cannot be made during execution of a program Available values Any one of the following AutoNote 2 signed 1byte 8bits signed 2bytes 16bits signed 4bytes 32bits unsigned 1byte 8bits unsigned 2bytes 16bits unsigned 4bytes 32bits R20UT3461EJ0100 Rev 1 00 Aug 01 2015 ztENESAS Page 85 of 163 CS V3 02 00 Val
122. ea displays a list of all items columns that can be displayed in the Function List panel Variable List panel the items columns that can be displayed differ according to the microcontroller and the debug tool used The display order of the items in this list and the state of checkboxes are the same as the current sort order and visible hidden status in the corresponding panel Specify the check boxes of each item to show or hide that item on the panel Displays this item on the panel Does not display this item on the panel Indicates that a message relating to information about this item has been output to the Output panel Hover the mouse over it to display a pop up with the last message to be output Function buttons Button Function Default Resets the display order and visible hidden settings for each item in the Function List panel Variable List panel to their default valuesNte Note that all display locking display filtering and other customization will be cleared Closes this dialog box Note The default display status for each item is as follows The order of Item in the table corresponds to the display order of items columns on each panel Note that items displayed differ depending on the microcontroller and debug tool used see 2 Informa tion area of the Function List panel 2 Information area of the Variable List panel Table A 5 Default Display Status Function List Panel Statu
123. ed with warnings about operations Error message AaBbCc Character color Red Background color Light gray Displayed when there is a critical error or when execution is not possible due to a operational mistake Remarks 1 When the output message is double clicked or the Enter key is pressed with the caret over the message the Editor panel appears and the destination line number of the file is displayed Remarks 2 Help with regard to the message in the line is shown by selecting Help for Message in the context menu or pressing the F1 key while the caret is in the line where the warning message or the error message is displayed Remarks 3 You can save the contents displayed on this tab to a text file txt by selecting Save Output All Messages As from the File menu R20UT3461EJ0100 Rev 1 00 Aug 01 2015 ztENESAS Page 141 of 163 CS V3 02 00 A WINDOW REFERENCE Program Analyzer tab This tab is used to display only operation logs for the analysis tool out of those for various components analysis tool design tool build tool debug tool etc provided by CS Figure A 33 Output Panel Program Analyzer Tab tha craca was filiead Ihara ia a possibility E T 2 pamela is inssrrecr H0812 0011 _ Find References The following items are explained here How to open Description of each area How to open From the View menu select O
124. eem ee Be Aad eke depen hae 29 2 6 5 Filter the analysis information 0 sanaaa eee 29 2 7 Jump to Defined Location nren sione ee eae We PE ee ee Se oe k 32 2 8 Jump to Declared Location roscri cee ae ba Abie dae bee aba ea ape beh eR eb Ps 34 2 9 Set Break Events 92 3 ick son hk pain it ae aidan E a a Gok ahinuS ear ata R Sas pes aes we hens Bates 35 2 9 1 Set a breakpoint to a function 0 0 c ce ete 35 2 9 2 Set a break event to avariable 0 tenet eee 35 2 10 Register Watch ExpressionS 0 0 eee tenet eee 37 2 11 Display List of Referencing Location 0 0 cect eee 38 2 12 Import or Export Information File 0 0 eect eens 39 2 13 Display Analysis Information in Chart 000 0 ttt 43 2 13 1 Graph transitions in valueS 2 0 0 teen t eee A E 43 2 13 2 Chart the function execution time ratios tte ete 55 2 14 Save Analysis Information 0 0 0 000 tent teens 57 3 CAUTIONS cia Bate Wat BS Oa a Wh pal E aa ea a A I Dee se Bape ind a na eh Dad 59 3 1 Ghanging Active Project 34 440i00 r ddd a aa E ee ee E aai 59 3 2 Coverage ResultS rip E E Pe ela Pe E EE EE ieee 59 3 3 Real time Sampling Analysis n a annaa cece eee nee eee 59 3 4 Trace Data Analysis en aeiiae ana So ea Sp khan aa Ea GEEN eine ea eee ee deep cea ee A 60 3 5 When the Panel Is Opened during Execution of Program 1 2 ee tees 60 3 6 When CC RX C Source Files Is Used 20 ete etee eee 61
125. egory on the Debug Tool Settings tab is set to Branch the acquisition time of trace data will increase because complement of instructions between branch instructions is performed If you wish to display graphs focusing only on variables we recommend selecting Data access in this property 3 5 When the Panel Is Opened during Execution of Program 1 Function List panel Variable List panel The updated static analysis information will be displayed The dynamic analysis information is not updated 2 Analysis Chart panel If this panel has been never opened since CS was launched Variable Value Changing Chart tab Nothing will be displayed Execution Time Percentage Chart tab Nothing will be displayed If this panel has been opened once since CS was launched Variable Value Changing Chart tab Real time sampling analysis The graph will be updated at the specified sampling interval Trace data analysis The previous display contents will be displayed Execution Time Percentage Chart tab The previous display contents will be displayed 3 Call Graph panel If this panel has been never opened since CS was launched The updated static analysis information will be displayed The dynamic analysis information is not updated If this panel has been opened once since CS was launched The previous display contents will be displayed R20UT3461EJ0100 Rev 1 00 ztENESAS Page 60 of 163 Aug 0
126. en Description of each area R20UT3461EJ0100 Rev 1 00 ztENESAS Page 107 of 163 Aug 01 2015 CS V3 02 00 A WINDOW REFERENCE How to open On the toolbar in the Main window click the button and then select the Variable Value Changing Chart tab From the View menu select Program Analyzer gt gt Analysis Chart and then select the Variable Value Changing Chart tab Description of each area 1 Graph control area Figure A 12 Graph Control Area a Analysis method b Sampling button c Reflect button d Zoom combo box Comes Dae tes a a GLE BED e Zoom 1 4 check box a Analysis method Displays the analysis method currently being specified with the Analysis method property in the General cat egory on the Variable Value Changing tab of the Property panel see 2 Specify the method for acquiring the graph data Display Contents Description Sampling Indicates that Real time sampling is selected Trace Indicates that Analysis of trace data is selected File Indicates that Load from file is selected b Sampling button Manually controls toggles the start stop of the real time sampling Note however that this button is available only when the following conditions are being satisfie The debug tool is connected to CS Real time sampling analysis is selected as the analysis method Manual is se
127. en branch instructions is performed If you focus only on variables we recommend selecting Data access in this property Cautions 2 CC RX When C source files are subject to analysis also see 3 6 When CC RX C Source Files ls Used Cautions 3 CC RX Unused variables deleted via compiler optimization are not displayed Remarks 1 You can set filters for displaying variable information on this panel see 2 6 5 Filter the analysis informa tion Remarks 2 This panel can be zoomed in and out by in the tool bar or by moving the mouse wheel for ey ward or backward while holding down the Ctr Remarks 3 RH850 See a Trace function for details on the relationship between the Dynamic analysis information in this panel and PEn currently being selected in the Debug Manager panel Figure A 8 Variable List Panel Variable List a Toolbar o ajte ge Ro oe 1 4 A Veneble Hame Te File Hame Tee Atinbute Te Type Fe Members Th Address To Ca man unsigned shai Celts ged finish CG maine unsigned char acounl_ lime CG maine unsigned int acounlins CG maine ungigned int 2 w g flag detect CG maine unsigrad short w a romp CG_systeninite z Total G_mainus Total CG_sysbeminitc w The following items are explained here How to open Description of each area Toolbar File menu Variable List panel dedicated items Edit menu Variable List panel dedicated items Conte
128. er a transition point on the graph information about that location appears in a pop up Note however that the content displayed will differ depending on the method for acquiring the graph data see i Pop up display Figure 2 33 Pop up Display at Transition Point Real time sampling analysis Trace data analysis chi global_c Value 625 lime chi global_c Value 660 Location main o L34 Time 78s Remark When the Location information is shown in a pop up you can display the applicable location in the Editor panel by double clicking the transition point except for a graph that was restored by loading the analysis chart data file mtac R20UT3461EJ0100 Rev 1 00 ztENESAS Page 52 of 163 Aug 01 2015 CS V3 02 00 2 FUNCTIONS b Cursor measurement You can check the time and value at the position of Cursor A Cursor B on the graph You can get a cursor measurement for the X axis time or Y axis value Measurements appear in a list in the cursor information area on this tab see 4 Cursor information area To perform this measurement first use the cursor selection button X axis Time button Y axis Value button to select the target axis to measure Then set Cursor A and Cursor B to the desired location on the graph by using the following operations the cursors are hidden by default Cursor Setting Show Clear Setting Hide Cursor A Ctrl key click Ct
129. erence information property This applies to the following debug tool s functions in the order of priority Trace function Real time display update function RRM function RAM monitor pseudo RRM function Coverage function The corresponding property settings differ depending on the selected microcontroller and debug tool For details on how to enable these functions see CS Integrated Development Environment User s Manual Debug Tool of the microcontroller used The same information as the content on the Function List panel is output to the STF information file Funclnfo csv including information for items that are currently hidden Standard Settings Necessary for Dynamic Analysis Trace Function Property of Debug Too Note Description Value to be Set When Yes is Selected for Enable dynamic analysis information Property RH850 RX RL78 Use trace function The value of this property automatically changes to Yes when the debug tool is connected if Yes is selected for the Enable dynamic analysis information property Yes RH850 Select trace data When acquiring only function information Select Branch PC When acquiring only variable information Select Data Access When acquiring function and variable information Select PC Data Access Trace data type When acquiring only function information Select Branch When acquiring only variable info
130. ermore when the selected microcontroller incorporates a Smart Analog IC E1 E20 RL78 by enabling the Data collection modeN on the debug tool it is possible to display the collected data for Smart Analog by a graph Graphs are displayed in the Analysis Chart panel s Variable Value Changing Chart tab See the Variable Value Changing Chart tab for details on each of the area displayed Note Data collection mode This mode is the debug tool s feature that is supported only when the selected microcontroller incorpo rates a Smart Analog IC E1 E20 RL78 When the debug tool is in this mode the data for Smart Analog can be collected while a program is exe cuted This mode becomes valid by performing the following setting on the debug tool s Property panel Debug Tool Settings tab gt gt Smart Analog category gt gt Collect data during the execution property gt gt Yes R20UT3461EJ0100 Rev 1 00 ztENESAS Page 43 of 163 Aug 01 2015 CS V3 02 00 2 FUNCTIONS Figure 2 26 Graph of Transition in Variable Values eval pain Chat Graph control area A ric Career petra Flt bay e aero cr ae A Page A Cla Geren a teim _ Cursor selection buttons Yis Te Tir I Cues Dumb 4 AB x Tu a BH aT ch j a2 p S Splitter oh E oh N ch 7 re Cursor information area ght A lt l icti fal chi liche Wi oeir har en pona Si litter d PE a n Pepis A
131. error messages R20UT3461EJ0100 Rev 1 00 ztENESAS Page 140 of 163 Aug 01 2015 CS V3 02 00 A WINDOW REFERENCE All Messages tab This tab is used to display operation logs for all components analysis tool design tool build tool debug tool etc pro vided by CS Figure A 32 Output Panel All Messages Tab EOF Program Analyzer 5 Stopped by user operation The following items are explained here How to open Description of each area How to open From the View menu select Output Description of each area 1 Message area Build Tool Debug Tool Find References This area displays operation logs for all components analysis tool design tool build tool debug tool etc pro vided by CS Note that messages that the analysis tool output during analysis are not displayed on this tab these messages are displayed only on the Program Analyzer tab The colors of message display differ with the type of message as shown below character colors and background colors depend on the configuration in the General Font and Color category of the Option dialog box Message Type Display Example Default Description Normal message AaBbCc Character color Black Background color White Displayed with information notices Warning message AaBbCc Character color Blue Background color Standard color Display
132. erty Yes Display update interval ms R20UT3461EJ0100 Rev 1 00 Aug 01 2015 Specify the update interval of RRM ztENESAS Page 74 of 163 CS V3 02 00 Micro controller Property of Debug Too Note Description A WINDOW REFERENCE Value to be Set When Yes is Selected for Enable dynamic analysis information Property RX Note Caution Select specification method of files to ana lyze Enable the auto Select Yes matic update of realtime display Set the property in the Access Memory While Running category on the Debug Tool Settings tab in the debug tool s Property panel The above settings are necessary when Real time sampling default is selected for the Analysis method property on the Variable Value Changing tab of the Property panel for the analysis tool 2 Analysis Object The detailed information on analysis objects is displayed and its configuration can be changed For details on the analysis objects see 1 1 1 What is analyzed Select the specification method of files to analyze by the analysis tool Default Files not to analyze Modifying Select from the drop down list Available values Files not to analyze Specifies files not to analyze Files to analyze Specifies files to analyze Files not to analyze Specify files that are not the subject of analysis This property appears only whe
133. es a trigger signal when both Rising and Falling Trigger position Specify the position on the X axis for rendering the location at which the trigger signal occurred i e position where the data is graphed after a trigger signal occurs Directly enter a value with a decimal number in the following range default 0s Note that if the unit s ms us ns case insensitive is omitted it will be handled as ms 0 to the value of the Time per grid Time Div property x 10 Remark The trigger position is displayed on the upper part of graphs as the trigger mark FF The trigger position can be changed by dragging on this trigger mark note this operation is dis abled during execution of a program Trigger mark color Specify the color of the trigger marks f F that indicate the trigger level and the trigger position Specify with the color selection combo box or directly enter the value in decimal number hexadecimal number prefix Ox is needed or the color name see About the specification of the color default Color Orange Display graphs After you have executed and stopped the program the latest graph for the registered graphing target is dis played default Note however that no graphs will be displayed if the corresponding data could not be acquired Graphs are updated when Real time sampling analysis Each time of the specified sampling interval even if a program is run
134. f for the filter number or string directly via the keyboard up to 2048 characters or select one from the input history via the drop down list maximum 10 items By default the comparison value set in the current target item is displayed b Condition right combo box Select the condition for the comparison value specified in a above from the drop down list By default the condition set in the current target item is selected R20UT3461EJ0100 Rev 1 00 ztENESAS Page 158 of 163 Aug 01 2015 CS V3 02 00 A WINDOW REFERENCE Comparison Value Numerical Value Character String no conditionN te Compared as numerical value Compared as character string equals does not equal is greater than is greater than or equal to is less than is less than or equal to begins with Compared as character string does not begin with ends with does not end with contains does not contain Note If no condition is selected then the comparison value will be ignored not set as a condition Caution Use the top condition specification area if you only wish to specify one filtering condition 2 Logical operator buttons Select the logical relationship holding between the conditions specified in the First condition setting area top Second condition setting area bottom via the following option button Only information meeting both condition 1 and condition 2 is displa
135. f the General category to Yes Functions called from variables referenced from template functions and member functions defined in template classes do not appear in this panel Aconstructor destructor of a class type that was implicitly called in C source files does not appear in this panel 4 Class Member panel Namespace aliases are not displayed Jump to Source or Jump to Declaration of Source from the context menu is disabled when template functions or member functions defined in template classes are selected R20UT3461EJ0100 Rev 1 00 2tENESAS Page 61 of 163 Aug 01 2015 CS V3 02 00 A WINDOW REFERENCE A WINDOW REFERENCE Appendix A provides detailed explanations of windows panels dialog boxes used by the analysis tool A 1 Description The analysis tool has the following windows panels and dialog boxes Table A 1 Window Panel Dialog Box Name Window Panel Dialog Box List Description Main window This is the first window to open when CS is launched Project Tree panel Displays the components of the project in a tree structure Property panel Displays detailed information on the analysis tool and changes the settings of the information Function List panel Displays the acquired function information Variable List panel Displays the acquired variable information Analysis Chart panel Displays charts of the acquired function information and vari
136. f the screen display is scrolled To do this use the mouse to click the lock display icons 3 M of the desired column name clicking repeatedly toggles the item display between locked and unlocked Columns configured for locked display are locked at the leftmost column so they will not be scrolled even if the user scrolls horizontally The meanings of the lock display icons are as follows Table 2 4 Lock Display Icons Description Indicates that the display is not locked default Indicates that the display is locked R20UT3461EJ0100 Rev 1 00 ztENESAS Page 28 of 163 Aug 01 2015 CS V3 02 00 2 FUNCTIONS Remarks 1 You can also lock the display of a column by dragging and dropping it between two items with locked dis plays or to the rightmost column Remarks 2 You can also unlock the display of a locked item by dragging and dropping it between two items with unlocked displays 2 6 4 Sort the analysis information You can sort the information values on the Function List panel Variable List panel by column and in ascending or descending order To do this use the mouse to click the desired column name clicking repeatedly toggles the sort order between ascend ing and descending If the items to sort are numbers decimal or hexadecimal then the information is sorted by numerical value For other types of data e g strings the information is sorted by character code The following mark appears
137. formation RH850 Non display Display Import Non display Non display Access Specifier Display Display Attribute Display Display Type Display Display Members Display Display Address Display Display Size Bytes Display Display Reference Count Display Display R20UT3461EJ0100 Rev 1 00 ztENESAS Page 153 of 163 Aug 01 2015 CS V3 02 00 A WINDOW REFERENCE Status While Disconnecting from While Connecting to Debug Tool Debug Tool Read Count Non display Display Write Count Non display Display Read Write Count Non display Non display Minimum Value Non display Display Maximum Value Non display Display Data Coverage Non display Display R20UT3461EJ0100 Rev 1 00 ztENESAS Page 154 of 163 Aug 01 2015 CS V3 02 00 A WINDOW REFERENCE Call Graph Search dialog box This dialog box is used to search for a function variable existing in the call graph displayed in the Call Graph panel Caution Searches can be performed only for functions variables function boxes variable boxes that appear in a call graph Figure A 45 Call Graph Search Dialog Box Cal Graph Search Search cardi Funcion Varies are Gone na m Function buttons The following items are explained here How to open Description of each area Function buttons How to open On the toolbar of the Call Graph panel click the button Focus the Call Graph panel and then select Find from
138. function This function is used to collect an execution history of the program as a trace data The trace function provides the following Dynamic analysis information Execution time including a proportion of total execution time and average execution time Execution count including access type read count write count and so on Variable values including maximum values and minimum values Graph data when the method for acquiring the graph data is Trace data analysis Cautions 1 RH850 Full spec emulator E1 E20 The contents of the dynamic analysis information differ depending on the Trace target setting property in the Trace category on the Debug Tool Settings tab of the debug tool s Property panel When Debug core only is selected The debug tool collects trace data regarding PEn currently selected in the Debug Manager panel Therefore the analysis tool also displays the dynamic analysis information regarding PEn When All core is selected The debug tool collects trace data in all PEs Therefore after collecting trace data the anal R20UT3461EJ0100 Rev 1 00 ztENESAS Page 7 of 163 Aug 01 2015 CS V3 02 00 1 GENERAL Cautions 2 Cautions 3 Cautions 4 Cautions 5 Cautions 6 ysis tool displays the corresponding dynamic analysis information by switching to another PEn in the Debug Manager panel Simulator The debug tool collects trace data regarding PEn currently selected
139. functions and so on will be placed on the call graph from left to right they will be arranged from top to bottom with the functions to appear first shown topmost If an arbitrary parent function is specified in the Parent Function Name combo boxN 2 then only the func tions called by that function will appear in the call graph If the combo box is empty then all functions in the pro gram will appear in the call graph Notes 1 The function name differs with the selected microcontroller as follows RH850 RL78 main RX reset Notes 2 RH850 If the selected microcontroller version supports multi core and PMn is selected in the Parent Function Name combo box the call graph will only be displayed for the functions executed in the selected PMn PEn Details view The parent functions and child functions of the function currently being specified with the Target Function Name combo box are displayed R20UT3461EJ0100 Rev 1 00 ztENESAS Page 118 of 163 Aug 01 2015 CS V3 02 00 A WINDOW REFERENCE The parent functions the target function and the child functions are placed on the call graph from left to right they will be arranged from top to bottom with the functions to appear first shown topmost Furthermore if global variables static variables inside a file or static variables inside a function accessed from the target function exist the variables also is placed immediately below the target function as
140. functions to search You can either type a value directly into the text box settable range 0 to 65535 or select one from the input history via the drop down list up to 10 items The previous specified value is displayed by default if it does not exist then this is left blank Condition From the following drop down list select the condition for the numeric value specified with Child Count is greater than Searches for the names of functions with more greater than the specified number of child functions is greater than or equals to Searches for the names of functions with at least as many greater than or equal to the specified number of child functions equals to Searches for the names of functions with the same number of equal to the specified number of child functions default is less than or equals to Searches for the names of functions with at least as less greater than or equal to the specified number of child functions is less than 2 Preview area Searches for the names of functions with less greater than the specified number of child functions This area displays all part of the call graph If the area currently displayed in the Call Graph panel is a portion of the entire call graph then that area is shown in a red frame Function buttons Button Function Search Backward The search uses the specified conditions starting from the function name var
141. g each plot via perpendicular lines step plot chart Figure 2 32 Chart Type Line chart Step line chart poner ene eee eee 1 1 N rr i Z H i H F a a Remark You can also specify the rendering color of a graph for each channel individually To make the setting set the Color 1 16 property in the Channel 7 16 category on the same tab Setting the display range The graph is displayed by dividing the X and Y axes into a 10 x 10 grid lt 1 gt Use the auto adjustment function default According to the obtained graph data optimum values are calculated for the time per unit grid Time Div for the X axis and the value per unit grid Val Div offset value for the Y axis as described below default to dis play a graph X axis time The grids are automatically adjusted so that the specified number of value transition points fit inside the rendering area between the left and right ends Note on the graph Y axis value The grids are automatically adjusted so that the upper and lower ends of the rendering area correspond to the maximum and minimum values of the graph data respectively Note In the default condition 20 points are specified This value can be changed via the Number of transition location for auto adjustment property in the General category on the Variable Value Changing tab of the Property panel Cautions 1 The auto adjustment function is disabled when the trigger function is used or the
142. get in a check box format none will be displayed if no graphing target is registered The character color of the variable name is the same as the rendering color of the graph Select the check box to display the graph corresponding to the variable multiple selections possible In the default condition the settings of the data source are reflected to these check boxes Note however that this operation is disabled during execution of a program b Val Div Displays the value per unit grid currently being specified with the Value per grid Val Div 7 16 property in the Channel 1 16 category on the Variable Value Changing tab of the Property panel 4 Cursor information area The display range of this area can be changed by moving the splitter with the mouse In addition this area can be shown hidden by clicking the mark on the center of the splitter by default this area is hidden Figure A 30 Cursor Information Area Cursor Getting an key mouse check Lef A Right 6B Gear Setting Cri key m a Cursor selection button T X ais Time Y exis Value b Measurement result Target Coreer A Gurece B A AB Tima 39 5851 6m Heim 1208me 0 1Hz ghi B chi s a e h3 z m ehd e ae a Cursor selection button Select the target axis to perform a Cursor measurement Note however that this button is disabled during execution of a program X axis T
143. gram execu tion stops Note that this item is disabled when the Refresh at program stop property in the General category on the Settings tab of the Property panel is set to other than Specify Individually this button is locked in accordance with the setting on the Property panel R20UT3461EJ0100 Rev 1 00 ztENESAS Page 102 of 163 Aug 01 2015 CS V3 02 00 A WINDOW REFERENCE Resets highlighting of values that have been changed by executing a program Note that this item is disabled during execution of a program Displays only the information for variables in a file s category s currently selected in the Project Tree panel see a Linking with the Project Tree panel Displays only the information for variables starting with the word at the caret position in the Editor panel see b Linking with the Editor panel Displays only the information for variables in the common region and PEn currently selected in the Debug Manager panel see c Linking with the Debug Manager panel RH850 Note that this item is disabled when the selected microcontroller version does not support multi core or while disconnecting from the debug tool File menu Variable List panel dedicated items The File menu for this panel provides the following items and functions Save Variable List Data Overwrites the contents of this panel to the previously saved file see 2 14 Save Analysis Information No
144. gs to this area b Class Name CC RX If required as a search parameter for a function variable you can specify the class name to which a member function member variable to search belongs You can either type character strings directly into the text box up to 2046 characters or select one from the input history via the drop down list up to 10 items The previous specified class name is displayed by default if it does not exist then this is left blank Condition From the following drop down list select the condition for the character strings specified with Class Name equals Searches for the function names variable names that belong to the class exactly match ing the specified string begins with Searches for function names variable names that belong to the class starting with the specified string ends with Searches for function names variable names that belong to the class ending with the specified string contains Searches for function names variable names that belong to the class containing the specified string default Remark You can also specify the class name with any one of the following methods Drag and drop an arbitrary character strings to this area c Case sensitive Specify whether to search for characters specified in Function Variable Name Class Name CC RX in case sensitive Searches with the specified characters in case sensitive Searches with the specified char
145. h as structure members and array indices are not registered Remarks 3 If a name matches a graphing target that has already registered then it will be registered twice When graphing the data collected for Smart Analog E1 E20 RL78 This feature is enabled only when the selected microcontroller incorporates a Smart Analog IC First set the debug tool used to the Data collection mode Next specify the channel numbers in which the data is received from a device with the Data collection channel property in the Smart Analog category on the Variable Value Changing tab of the Property panel In the drop down list select the check box of the channel number to be used up to 8 channels can be selected Caution The Smart Analog category appears only when the debug tool is set in the Data collection mode Figure 2 28 Smart Analog Category VariableiAddress 1 Value per geid Val Div 1 Offset 1 Color 7 Channel 2 Channel 3 Channel 4 Channel 5 hanad E In addition the following detailed conditions can be specified with the Channel 1 16 category on the Variable Value Changing tab of the Property panel for each channel see 4 Display graphs Variable Address 7 16 Character strings that are displayed at the Variable name check box Value per grid Val Div 7 76 Value per grid unit in graph Offset 7 16 Offset value of graph Color 7 16 property Rendering color of graph R20UT3461EJ010
146. he Classes Categories tree area Remarks 1 When the mouse cursor is hovered over a xxx name node except for a file name node the namespace name to which it belongs appears in a pop up However if it belongs to a global namespace or an anonymous namespace then or lt unnamed gt will appear If the mouse cursor is hovered over a namespace name node the namespace name to which it belongs upper namespace name will appear Remarks 2 Argument types are added to function names Examples 1 int main void main void Examples 2 void main_sub01 int local_a int local_b int local_c main_sub01 int int int Examples 3 int functionO1 int arg01 const function01 int const For template functions CC RX the line for the definition of a template function and the line for the function using a template function are displayed individually Examples 1 template lt class T gt T max T a T b on a line where a template is defined max lt T 1 gt Examples 2 int max int a int b on a line where a template is used max lt T 1 gt int int Remarks 3 CC RX These are displayed in the following access specifier order together with icons denoting the access R20UT3461EJ0100 Rev 1 00 ztENESAS Page 132 of 163 Aug 01 2015 CS V3 02 00 A WINDOW REFERENCE specifier type nodes with the same access specifier are displayed in alphabetical order However if the tree is classified by File group then they are all displayed
147. hild functions of the specified function By clicking the w button on the panel control area the call graph is switched to Details view that displays the parent functions and child functions of the function currently being specified with the Target Function Name combo box R20UT3461EJ0100 Rev 1 00 ztENESAS Page 20 of 163 Aug 01 2015 CS V3 02 00 2 FUNCTIONS In the details view when global variables static variables inside a file or static variables inside a function accessed from the target function exist these variables are also displayed as variable boxes To switch to Whole view default click the R button again Figure 2 4 Display Parent and Child Functions Call Graph Panel Details View AEETI subie 14 maine 55 Parent functions Child functions Variable box 3 Jump to defined location By double clicking on a function box variable box in the call graph you can jump to the location of the source text where that function variable is defined see 2 7 Jump to Defined Location 4 Pop up display of the function variable information When the mouse cursor is hovered over a function box variable box in the call graph information about that func tion variable appears in a pop up Caution This function cannot be used while scrolling via the mouse dragging is being enabled by the button on the panel control area Figure
148. his depends on the following setting on the Property panel Variable Value Changing tab gt gt General category gt gt Chart type property Notes 2 E20 JTAG RX600 Series Some restrictions apply to the size and the number of the target area for the RRM function Therefore CS automatically determines the target area within the restrictions For details on the target area for the RRM function see CS Integrated Development Environ ment User s Manual Debug Tool of the microcontroller used Notes 3 The number of events that can be set to valid state simultaneously differs depending on the microcontroller and the debug tool For details on Maximum number of enabled events see CS Integrated Development Environment User s Manual Debug Tool of the microcontroller used Notes 4 When RRM function RAM monitor pseudo RRM function is used Debug tool s Property panel gt gt Debug Tool Settings tab gt gt Access Memory While Running category gt gt Display update interval ms property When the debug tool is in the Data collection mode E1 E20 RL78 Property panel gt gt Variable Value Changing tab gt gt Smart Analog category gt gt Sampling inter val ms property R20UT3461EJ0100 Rev 1 00 Aug 01 2015 ztENESAS Page 48 of 163 CS V3 02 00 2 FUNCTIONS 3 a Use the trigger function If you specify Real time sampling analysis you can control the timi
149. hod for Smart Analog Therefore select this item When graphing the data collected for Smart Analog E1 E20 RL78 Trace data analysis Select Analysis of trace data in this property This method displays graphs based on the trace data acquired via the Trace function of the debug tool This item does not appear when any one of the following The debug tool does not support the trace function The debug tool does not support the trace time tag feature The debug tool is set in the Data collection mode E1 E20 RL78 Load from file Select Load from file in this property This method restores graphs by loading the analysis chart data file mtac that have been saved see 6 Save the graph data to restore the graph Note The following property setting on the Property panel is required Variable Value Changing tab gt gt Smart Analog category gt gt Sampling interval ms property The differences depending on the method for acquiring graph data are as follows R20UT3461EJ0100 Rev 1 00 ztENESAS Page 47 of 163 Aug 01 2015 CS V3 02 00 Table 2 11 Differences Real time Sampling Analysis 2 FUNCTIONS Differences Depending on Method for Acquiring Graph Data Trace Data Analysis Graph display Possible when the debug tool is in any of the following states RRM function RAM monitor pseudo RRM function is enabled Data collection mode E1 E20 RL78 Possible whe
150. iable name at the bottom of the call graph and proceeding upward The corresponding function box variable box is highlighted If a function box variable box has been selected on the Call Graph panel then the search starts from the corresponding function variable moving upward Note that if an illegal value is specified or the program is executing then a message will appear and the function variable search will not be performed If focus moves to this dialog box from a panel other than the Call Graph panel or the Call Graph panel is hidden then this button will be disabled Search Forward The search uses the specified conditions starting from the function name variable name at the top of the call graph and proceeding downward The corresponding function box variable box is highlighted If a function box variable box has been selected on the Call Graph panel then the search starts from the corresponding function variable moving downward Note that if an illegal value is specified or the program is executing then a message will appear and the function variable search will not be performed If focus moves to this dialog box from a panel other than the Call Graph panel or the Call Graph panel is hidden then this button will be disabled Cancels the function search and closes this dialog box Displays the help for this dialog box R20UT3461EJ0100 Rev 1 00 Aug 01 2015 ztENESAS Page 157 of 163 CS V3 02 00
151. ignal is received the data immediately prior to the trigger signal is graphed to the left of the trigger position and the data immediately after the trigger signal is graphed to the right of the trigger position When the graph reaches the right edge of the graph area the graph display stops updating and sampling e Only updates the graph display upon trigger signals When a trigger signal is received the data immediately prior to the trigger signal is graphed to the left of the trigger position and the data immediately after the trigger signal is graphed to the right of the trigger position When the graph reaches the right edge of the graph area the graph display stops updating Because sampling does not stop the graph display is updated upon the next trigger signal Note The sampling is stopped regardless of whether Sync or Manual is selected in the Start stop real time sampling property in the General category on the Variable Value Changing tab of the Property panel Remark Triggers are suspended while the graph is being updated in response to a trigger signal A trigger signal received during this time will not cause the graph display to be updated In Auto and Single modes trigger signals are ignored while triggers are suspended In Normal mode the graph is updated in response to the latest trigger signal when trigger suspension is lifted Trigger source Select the variable channel that is the source
152. ime Set the cursor measurement target to the X axis time default Y axis Value Set the cursor measurement target to the Y axis value b Measurement result This area displays the following measurement result from the cursor A and cursor B positions Note however that the information below disappears during execution of a program R20UT3461EJ0100 Rev 1 00 ztENESAS Page 137 of 163 Aug 01 2015 CS V3 02 00 A WINDOW REFERENCE When the target is the X axis time Shows the time indicated by cursor A the time indicated by cursor B and the difference between the two the cycle Hz calculated from the difference When the target is the Y axis value Shows Shows the value at the time when cursor A indicates the value at the time when cursor B indicates and the difference between the two If no value can be obtained will be displayed R20UT3461EJ0100 Rev 1 00 ztENESAS Page 138 of 163 Aug 01 2015 CS V3 02 00 A WINDOW REFERENCE Output panel This panel is used to display operation logs for various components analysis tool design tool build tool debug tool etc provided by CS and a list of locations that refer to the specified function variable See 2 11 Display List of Referencing Location for details on how to output lists of locations referencing a function or variable Remark This panel can be zoomed in and out by in the tool bar or by moving the mouse wheel f
153. in alphabetical order Access Specifier public protected private Remarks 4 You can jump to the location where the node currently being selected is defined or declared see 2 7 Jump to Defined Location 2 8 Jump to Declared Location Toolbar The toolbar provides the following items and functions Acquires the latest data from the debug tool and updates the contents of this panel Edit menu Class Member panel dedicated items The Edit menu for this panel provides the following items and functions Copy Copies the contents of the selected node to the clipboard as character strings Select All Selects all the nodes being displayed in the Functions Variables list area Context menu The context menu displayed by right clicking on this panel provides the following items and functions Jump to Source Opens the Editor panel and displays the source file in which the node currently being selected is defined see 2 7 Jump to Defined Location Jump to Declaration of Source Opens the Editor panel and displays the source file in which the node currently being selected is declared see 2 8 Jump to Declared Location Jump to Disassemble Opens the Disassemble panel Disassemble1 and displays the disassemble data corresponding to the start address of the nodeNote currently being selected in the Functions Variables list area see 2 7 Jump to Defined Location Note that this item is d
154. ining the string speci fied in the Target Name combo box and selects the node that is found Note that this button is disabled if the Target Name combo box is left blank or during execution of a program Remark Searches down in the last tree to have focus for nodes containing the string spec ified in Target Name combo box and selects the node that is found Note that this button is disabled if the Target Name combo box is left blank or during execution of a program After typing character strings to search to press the Enter key is the same function as clicking the gt button and to press the Shift Enter key is the same function as clicking the I button 2 Classes Categories tree area This area used to display the class and other information defined by the program in tree format Information about the node being selected in this tree appears in the Functions Variables list area You can use the View Setting combo box to classify the display into the following five groups Category group default Access group Namespace group File group Alphabet group The node name and their order in the tree are described below Note however that if information could not be obtained or there are no child nodes to display then that node will not appear in the tree You can expand shrink the node with a child node by double clicking it R20UT3461EJ0100 Rev 1 00 Aug 01 2015 ztENESAS
155. ion Active Project Dir C Teat Absolute path of the active peje AciveProjedMame TSKOR_LH3us Active pmject name F MainFroject Cir C Test Absolute path of the main projec MainProecdthame 7AKDA_LH3 uws Main project name Micom ToolPath Ciok W501 Abaolute path of the CS install ProgestOar 0 Tiest Absolute oath of the ormie folie 4 m 0 Gas Gow ee In the Path Edit dialog box in the Path One path per one line area specify the names of the information files generated in 1 including the path one path per line up to 259 characters per line up to 64 lines If you specify a relative path specify the project folder as the base You can also use the Browse button to specify information files After you have entered the names of all the files to import click the OK button The specified paths appear as sub properties of the Import files property Figure 2 24 Import files Property After Adding Import Files m Wr Imoo files Import files 2 C Tes Sample Func Liet Sub zma C Teat Sample WarLiet_ Subunit The above setting completes the import of the information file Remarks 1 The following placeholders are supported in the Path Edit dialog box ProjectName Replaces itself with the project name MicomToolPath Replaces itself with the absolute path of the CS install folder Remarks 2 The information files that have been exported by CubeSuite CubeSuite function list file csf
156. ion 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 Electronics products are ne
157. ion name Indicates the name of the target function Definition Indicates the location at which the target function is defined with File name Line number Note however that if the definition information does not exist then this will display No Definition Attribute Indicates the attribute of the target function Static function lt static gt Template function lt template gt CC RX Virtual function lt virtual gt CC RX Pure virtual function lt abstract gt CC RX If the attribute other than the above nothing is displayed in this area Condition The current state of the target function is shown in the following background colors Light blue Not executed Purple Executed PM Information RH850 Note CC RX If the selected microcontroller version supports multi core PE in which the target function is assigned is shown in the following shadow colors Gray Common Red PM1 PE1 Green PM2 PE2 Blue PM3 PE3 Orange PM4 PE4 If the target function is a overloaded function or a template function then the argument types of the function are also displayed in parentheses If the target function is a const member function or volatile member function then const or vol atile is displayed immediately after the function name Remark By double clicking a function box you can jump to the location of the source text where the func tion is defined see
158. ion name Count Function name Indicates the name of the target functionN Location Indicates the location at which the target function is defined Note however that if the definition information does not exist then this will display No Definition Recursive call This item is displayed only if the target function is a recursive call count Reference count Number of recursive calls made Execution count Number of executions only if there is trace data Circular call count This item is displayed only if there are circular function calls from the target function If there are multiple target functions that at most 4 will be listed Function name Name of function in circular call Reference count Number of circular calls made Execution count Number of executions only if there is trace data Dynamic call count This item is displayed only if there are only dynamic function calls and no static function calls If there are multiple target functions that at most 4 will be listed Function name Name of dynamic call function Count Number of executions Note CC RX When the target function is a global function or static function If the target function belongs to a namespace except for a global namespace anonymous namespace then this will be displayed in the format of Namespace name Function name Moreover if the target function is a overloaded function or a template function then this will be followed b
159. irectly enter from the keyboard Available values When directly enter from the keyboard The value in decimal number hexadecimal number prefix Ox is needed or the color name see About the specification of the color ztENESAS Page 81 of 163 CS V3 02 00 A WINDOW REFERENCE Foreground color Note 3 Specify the foreground color of the graph This property appears only when the Specify foreground color and background color property is set to Yes Default The setting of font color for the Default item in the Option dialog box Modifying Specify with the color selection combo box or directly enter from the keyboard Available values When directly enter from the keyboard The value in decimal number hexadecimal number prefix Ox is needed or the color name see About the specification of the color Cursor A B color Specify the color of the Cursor A and Cursor B Default Cursor A PaleGreen Cursor B PaleTurquoise Modifying Specify with the color selection combo box or directly enter from the keyboard Available values When directly enter from the keyboard The value in decimal number hexadecimal number prefix Ox is needed or the color name see About the specification of the color Zoom 7 4 color Specify the color of the Zoom 1 to the Zoom 4 Default Zoom 1 64 255 10 79 Zoom 2 64 91 228 22 Zoom 3 64 5 109
160. is information property in the General category on the Settings tab of the Property panel to Yes The contents of the panel will be updated 3 2 Coverage Results The results of code coverage and data coverage store the program s execution results If you repeatedly download execute and stop your program then the results for the repeated actions will be displayed To clear the coverage results select Clear Coverage Information from the context menu of the Editor panel Disassem ble panel and then click the button on the Function List panel Variable List panel If you change the program and execute a build the allocation addresses of the functions and variables may differ from those of the previous builds If this happens coverage ratio will appear for functions that have not been executed and for variables that have not been read or written 3 3 Real time Sampling Analysis Notes on acquisition of graph data through Real time sampling analysis are listed below It may not be possible to identify the sampling interval depending on the number of graphing targets registered It may not be possible to acquire graph data If acquiring data has failed lines between transition points are not displayed but only the time information is displayed see a Graph When graph data of a 2 4 or 8 byte variable is to be acquired the process of assigning a value to the variable may be divided into two steps see Example When
161. isabled while disconnecting from the debug tool Jump to Memory Opens the Memory panel Memory1 and displays the memory list corresponding to the start address of the nodeNoe currently being selected in the Functions Vari ables list area see 2 7 Jump to Defined Location Note that this item is disabled while disconnecting from the debug tool Jump to Function Variable List Opens the Function List panel Variable List panel and selects the function variable of the nodeN currently being selected Copy Copies the contents of the selected node to the clipboard as character strings Note CC RX This item is disabled if a node that indicates a instance variable is selected R20UT3461EJ0100 Rev 1 00 ztENESAS Page 133 of 163 Aug 01 2015 CS V3 02 00 A WINDOW REFERENCE Variable Value Changing Chart zoomed in panel This panel is used to zoom in on the specified range on the chart displayed in the Variable Value Changing Chart tab of the Analysis Chart panel Up to a maximum of four of these panels can be opened Each panel is identified by the names Variable Value Chang ing Chart zoomed in 7 4 on the title bar From these panels you can zoom in on the specified range individually See c Zoom for details on how to display the chart on this panel Cautions 1 The graph on this panel cannot be updated during execution of a program Cautions 2 The graphing target cannot be registered deleted on thi
162. ist of C C source file names currently being registered in the project and their information File Name Displays the C C source file name or the category name surrounded by Specify the check boxes of each file name not to analyze that file Does not analyze this file C Analyzes this file Remarks 1 If a check box of a category name is cleared then all of the check boxes of the file names that belong to the category will be cleared Remarks 2 When the mouse cursor is hovered over a file name the full path of the file and the path including the tree node name that is displayed in the project tree appear in a pop up Category Displays the category name to which the corresponding C C source file is registered in the project tree When a category name is displayed in the File Name File is displayed if it is a root category is dis played Defined Symbol Count Displays the total number decimal number of the functions and variables that are defined in the corresponding C C source file or category However if the number of the defined symbols cannot be obtained then will be displayed All Select All Deselect check box Select this check box to select all of the check boxes in File column Conversely remove the check of this check box to remove all of the checks in File column Indicates that all of the check boxes in File column is being selected Indicates that all of the
163. ither 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 Renesas Electronics
164. ken by the execution time of functions in the target file Code Coverage The code coverage rates of functions in the target file Note This item does not appear by default See 2 6 1 Set the columns to display for details on how to display this item Cautions 1 Items of the Dynamic analysis information do not appear while disconnecting from the debug tool default Cautions 2 IECUBE RL78 0 is output as the first trace data time tag during program execution For this reason if the user repeatedly starts and stops execution or performs step execution the R20UT3461EJ0100 Rev 1 00 ztENESAS Page 93 of 163 Aug 01 2015 CS V3 02 00 A WINDOW REFERENCE Execution Time uni Execution Time Percentage Execution Time Average uni items will be invalid Cautions 3 Values of the following items for the system library functions cannot be acquired Return Type Arguments Count Arguments Code Size Bytes End Address Execution Time unit Execution Time Percentage Execution Time Average unit Code Coverage Remarks 1 If you define a static function in a header file and include it from more than one source file informa tion for the header file and all source files is displayed on one line Remarks 2 CC RX The display contents of the line for the definition of a template function and the line for the function using a template function are as follows Function using th
165. l CubeSuite variable list file csvl can also be imported Remarks 3 If a function variable with the same name exists in a import file and an active project the determina tion is made according to the following rules When C source files are used If the file names are different and static only lower case is included in the attribute in the import file then it is interpreted as a static function static variable and loaded as different func tion information variable information R20UT3461EJ0100 Rev 1 00 ztENESAS Page 41 of 163 Aug 01 2015 CS V3 02 00 2 FUNCTIONS If the file names are the same and the function names are different and static only lower case is included in the attribute in the import file then it is interpreted as a static variable ina function and loaded as different variable information Functions variables other than the above are interpreted as a global function global variable or a static function static variable with the same name in a file and merged as identical function information variable information When C source files CC RX Class Name Namespace File Name and Arguments are compared If any one of these does not match then it is loaded as different function information Class Name Namespace Function Name File Name and Arguments are compared If any one of these does not match then it is loaded as different variable information
166. lationships between Functions Call Graph Display the Call Graph panel in order to validate the relationship between functions The Call Graph panel can be operated as follows in accordance with the purpose a Jump to Defined Location Jump to the location where the function variable on the call graph has been defined b Search for a function variable Search for an arbitrary function variable existing in the call graph 10 Display Class Function Variable Information Display the Class Member panel in order to validate the class information CC RX function information and vari able information The Class Member panel can be operated as follows in accordance with the purpose a Jump to Defined Location Jump to the location where the class function variable on the tree has been defined b Jump to Declared Location Jump to the location where the class function variable on the tree has been declared Remark CC RX The class information is provided only when C source files are subject to analysis 11 Display Analysis Information in Chart Display acquired function information variable information in a chart Note that if the program is modified during debugging the operation is repeated via 3 above R20UT3461EJ0100 Rev 1 00 ztENESAS Page 16 of 163 Aug 01 2015 CS V3 02 00 2 FUNCTIONS a Graph transitions in values Display the relationship between values of variable register address or of data collected for S
167. le name variable name Static variable inside a function file name function name variable name R20UT3461EJ0100 Rev 1 00 2tENESAS Page 45 of 163 Aug 01 2015 CS V3 02 00 Class variable class name variable name Remarks 1 Other than the above on the Variable List panel or the Editor panel you can also register the selected variable as a graphing target by selecting Register to Analysis Chart from the con text menu Remarks 2 To delete the registered graphing target delete the value of the Variable Address 7 16 prop erty in the Channel 7 16 category on the Variable Value Changing tab of the Property panel lt 3 gt Reflecting the Watch panel auto registration By clicking the Reflect button on the graph control area you can automatically register watch expressions currently being registered in the Watch panel Watch1 as graphing targets Up to 16 watch expressions in the Watch panel Watch1 from top to bottom can be registered If fewer than 16 watch expressions have been registered only the registered number are registered Caution Clicking the Reflect button will cause the information of graphing targets being registered to be deleted the graph being displayed will be erased Remarks 1 Categories themselves are not registered but variables and other elements within categories are Remarks 2 Ifa variable has child nodes e g arrays and structures expanded variables and the like suc
168. lected in the Start stop real time sampling property in the General category on the Variable Value Changing tab of the Property panel Caution If sampling is restarted the stored graph data will be deleted the graph being displayed will be erased c Reflect button Automatically registers watch expressions currently being registered in the Watch panel Watch1 as graphing target Up to 16 watch expressions in the Watch panel Watch1 from top to bottom are registered see lt 3 gt Reflect ing the Watch panel auto registration Note however that this button is available only when the following conditions are being satisfied The debug tool is connected to CS The program is halted Real time sampling analysis or Trace data analysis is selected as the analysis method E1 E20 RL78 Data collection mode is invalid on the debug tool Caution If this button is clicked the information on the registered graphing targets will be deleted the graph being displayed will be erased d Zoom combo box When selecting the zoom range select the number of the Variable Value Changing Chart zoomed in panel Zoom 4 see c Zoom Note however that this combo box is disabled during execution of a program R20UT3461EJ0100 Rev 1 00 ztENESAS Page 108 of 163 Aug 01 2015 CS V3 02 00 A WINDOW REFERENCE e Zoom 7 4check box Specifie
169. les Analysis Chart The number of fanctions displaying in the Executeon Time Pencentage Chart Ho Ho Yes Files mot fo anaye Files not to analyze No 10 Description of each category 1 General The general information on the analysis tool is displayed and its configuration can be changed Enable static analysis information Select whether the analysis tool should force output of cross reference information when performing a build in order to obtain the cross reference information necessary to acquire Static analysis information ignoring the property setting te 1 on the build tool specifying whether to output cross reference information Default No Modifying Select from the drop down list Available Yes Ignores the build tool s property settings and forces the values output of cross reference information No Gives priority to the build tool s property settings R20UT3461EJ0100 Rev 1 00 RENESAS Aug 01 2015 Page 69 of 163 CS V3 02 00 A WINDOW REFERENCE Enable dynamic analy Select whether the analysis tool should forcibly enable the debug tool s functionsNote sis information 2 and make the standard settings necessary for dynamic analysis ignoring the prop erty setting specifying whether to enable or disable the debug tool s functions neces sary to acquire Dynamic analysis information For the standard settings necessary for dynamic analysis see Table A 2 Stan
170. lete Address Static analysis Displays the variable s allocated address in hexadecimal number notation The number of digits to display is equivalent to the maximum address value of the selected microcontroller Note however that this will display if analysis is not complete Size Bytes Static analysis Displays the variable s size in decimal number notation Note however that this will display for bit variables or the like that can not be displayed in bytes or if analysis is not complete CC RX V1 xx xx Variables that are defined only and not referenced will be eliminated by compiler optimization For this reason this will display 0 for such vari ables Reference Count Static analysis Displays the number of times the variable is referenced in the program in decimal number notation The location where the variable is defined is also counted The totals for structures unions and arrays are displayed at the variable level refer ences to individual members and array elements are not shown In the definition of variables a line with an assignment statement e g int variable 10 is counted variable is interpreted as variable variable 1 Therefore this vari able is counted twice Code in C C source files that is referenced but is eliminated by the pre processor during compilation e g via if or ifdef statements is not included in the number of references it is
171. ling intersaljms Data collection channel Phi peha pehs Rihi Phen Reh Peh Ajeh E Channel 1 Variablaiiddress 1 Value per grid valiDiv 1 25 5 Offset i i Calor 1 E 192 255 10 79 Channel 2 Channel 3 Channel 4 Channa 5 4 Channa 6 Channel 7 Channa amp Channa 9 Channel 10 gt Channel ii Channel 12 Channel 13 gt Channel 14 Channel 15 R20UT3461EJ0100 Rev 1 00 ztENESAS Page 78 of 163 Aug 01 2015 CS V3 02 00 A WINDOW REFERENCE Description of each category 1 General The general information on graphs is displayed and its configuration can be changed Analysis method Select the method for acquiring the graph data see 2 Specify the method for acquiring the graph data Default Real time sampling Modifying Select from the drop down list Note that changes cannot be made during execution of a program Available values Real time sam Displays graphs based on the data acquired via pling the RRM function RAM monitor pseudo RRM function of the debug tool Note however that if the debug tool is set in the Data collection modeN 1 then the data will be collected using a sampling method for Smart Ana log Analysis of trace Displays graphs based on the trace data acquired data via the Trace function of the debug tool This does not appear when any one of the follow ing The debug tool does not support the trace func tion The debug tool d
172. location in question of lines exists The number in parentheses indicates the number of lines line number in the file Line 1 of the location Displays a 1 line excerpt from the file at the location At this time the target function name is highlighted A list of functions called within the target function name Calling function Lists the names of functions called within the target function If no functions are called then None is displayed A list of variables referenced read written inside the target function able n Reference vari Lists the names of variables referenced read written inside the target functionNe 2 ame If no variables are referenced then None is displayed Note When the File path item is being displayed on the Function List panel this item is not displayed by default the absolute path of the file appears R20UT3461EJ0100 Rev 1 00 ztENESAS Page 144 of 163 Aug 01 2015 CS V3 02 00 A WINDOW REFERENCE Figure A 36 Example of List of Locations Referencing Function without Dynamic Analysis Information Target subdi Definition subOl ec3 ine LAE arg_4 ine arg_b ine arg_cl l Reference sub l hi 3 int ins int ins zal Reference main c 1d2 result MMH locals lecai_b Lecel_c J Reference main e 196 j ewaule BRB igichel_a global b glebal_el A list of the functions which ace being called
173. lowing cascade menus are displayed to set a break eventNote with access condition see 2 9 2 Set a break event to a variable Note that this item is disabled while disconnecting from the debug tool Set Variable Read Break to Sets a break event with read access condition to the variable of the current row Set Variable Write Break to Sets a break event with write access condition to the variable of the current row Set Variable R W Break to Sets a break event with read write access condition to the variable of the current row R20UT3461EJ0100 Rev 1 00 Aug 01 2015 ztENESAS Page 103 of 163 CS V3 02 00 A WINDOW REFERENCE Register to Watch1 Registers the variable s of the selected row s to the Watch panel Watch1 as watch expression s see 2 10 Register Watch Expressions Note that this item is disabled while disconnecting from the debug tool Jump to Source Opens the Editor panel and displays the source file in which the variable of the cur rent row is defined see 2 7 Jump to Defined Location Jump to Memory Opens the Memory panel Memory1 and displays the memory list from the start address of the variable of the current row see 2 7 Jump to Defined Location Note that this item is disabled while disconnecting from the debug tool Copy Copies the contents of the selected row s to the clipboard as character strings separated by tabs Note that the contents of
174. luding subroutines Ne 3 4 The unit of time can be changed by selecting Unit of Time from the Tool bar or from the Property panel s Settings tab in the General category changing the Unit of time property see the Unit of time property in the Property panel for details on the time display format Note however that this will display if the debug tool s Trace function is disabled or analysis is not complete Execution Time Per centage Full spec emulator IECUBE RL78 E1 E20 RH850 Simulator Dynamic analysis Displays the proportion of total execution time range that could be obtained as trace data taken by the execution time of the target function rounded to the nearest two decimal places in the range 0 00 to 100 00N te 3 4 The level of shading of the cell s background color indicates the propor tion Note however that this will display if the debug tool s Trace function is disabled or analysis is not complete Execution Time Aver age unif Full spec emulator IECUBE RL78 E1 E20 RH850 Simulator R20UT3461EJ0100 Rev 1 00 Aug 01 2015 Dynamic analysis Displays the average execution time of the function execution time number of executions Ne 3 4 The results of calculation are displayed rounded to the nearest nanosec ond The unit of time can be changed by selecting Unit of Time from the Tool bar or from the Property panel s Settings
175. lue R20UT3461EJ0100 Rev 1 00 ztENESAS Page 35 of 163 Aug 01 2015 CS V3 02 00 2 FUNCTIONS Figure 2 17 Example of Setting Break Event on Variable After setting the variable global_b to the current row enter a value in Access Break gt gt Set Variable Write Break to from the context menu then press the Enter key Here the program will break when the value Oxb is writ siabe_alobal_ 33 he Register te Aap Chere s Static_global_be __ int static_global_se Gh Set Variable Read Break to a Register to Watehd Jump to Source FS Jump to Memory Cautions 1 This operation is disabled while disconnecting from the debug tool Cautions 2 For combination break events this function is available only when the combination condition is OR A break event set via this operation is managed in the Events panel as an event whose name is Access break to vari able Figure 2 18 Example of Setting Break Event Access Type in Events Panel ite Unconditional Trace E 5 Pium Bresk Timer i F WE Access break te vanablejgii Read gad data OxdiiOQe 3A 00d tet Remark If there is already a breakpoint set at the corresponding location the behavior is as follows If a break event in a valid state is set No effect If a break event in an invalid state is set Sets the break event to a valid state R20UT3461EJ0100 Rev 1 00 ztENESAS Page 36 of 163 Aug 01 2015 CS V3 02 00 2 FUNCTIO
176. ly provided in appear ance order R20UT3461EJ0100 Rev 1 00 2tENESAS Page 98 of 163 Aug 01 2015 CS V3 02 00 Item Type A WINDOW REFERENCE Contents Class Name CC RX Static analysis Displays the name of the class to which the variable belongs If it is a template class then the number of template arguments are also displayed in the format of class name lt T the number of template argu ments gt Note however that if the variable is not a member variable or if analysis was not completed then this will be blank Namespace CC RX Static analysis Displays the name of the namespace to which the variable belongs If the namespace is nested then it is displayed in the format of namespace name namespace name If it is an anonymous namespace then lt unnamed gt is displayed Note however that if analysis was not completed then this will be blank File Name Static analysis Displays the file name without path of the C C source file where the variable is definede 1 Note however that if it is not defined in a C C source file in project or if analysis was not completed then this will display No Definition If it is defined in a header file then the name of the header file is displayed Function NameNete 1 Static analysis Displays the name of the function where the variable is defined Note however this will be blank for other than a static vari
177. marks 1 See 1 Register graphing targets for details on how to register the graphing target Remarks 2 The color of the graph for each channel can be changed individually via the Color 1 16 property in the Channel 1 16 category on the Variable Value Changing tab of the Property panel Val Div Displays the value per unit grid currently being specified with the Value per grid Val Div 7 16 property in the Channel 1 16 category on the Variable Value Changing tab of the Property panel When the program is not running double clicking this label automatically adjusts the values of the Value per grid Val Div 1 16 and Offset 1 16 properties so that the graph for the selected channel will be shown in the entire rendering area see c Setting the display range R20UT3461EJ0100 Rev 1 00 ztENESAS Page 112 of 163 Aug 01 2015 CS V3 02 00 A WINDOW REFERENCE 4 a Cursor information area The display range of this area can be changed by moving the splitter with the mouse In addition this area can be shown hidden by clicking the mark on the center of the splitter Figure A 16 Cursor Information Area Cursor Getting K l key mouse che Lef A Righi B Gear Setting Cl key m X axis Time Y ani Wale a Cursor selection buttons b Measurement result Gurace B leans Target E CumoA Time e816ma ghi r eh eh
178. mart AnalogNe and time in a line chart Note E1 E20 RL78 This feature is supported only when the selected microcontroller incorporates a Smart Analog IC b Chart the function execution time ratios Display a pie chart of the function execution time ratios 12 Save Analysis Information Save the acquired analysis information to a file 13 Save the project file Save the setting information of the project to the project file Remark For details on how to save the project file see CS Integrated Development Environment User s Manual Project Operation R20UT3461EJ0100 Rev 1 00 ztENESAS Page 17 of 163 Aug 01 2015 CS V3 02 00 2 FUNCTIONS 2 2 Display Function Information Display the function information function name file name attribute reference count execution count code coverage etc in the program The latest function information that can currently be displayed see 1 1 2 Types of analysis information is displayed on the following Function List panel which is opened by clicking the button on the Main window s toolbar Note however that the function information in the files not to be analyzed is not displayed in this panel see 1 1 1 What is analyzed See the Function List panel for details on each of the function information items displayed Figure 2 1 Display Function Information Function List Panel Z Toolbar BS ES EE RE unit of Time Funchon Ham Wa FileName We Stinbute Y Retum Type
179. me Definition File name Number of lines Line 1of the location Reference Execution Count Number File name Number of lines Line tof the location A list of the functions which are being called by function Target function name Calling function name A list of the variables doing a reference read write by function Target function name Reference variable name End of finding all references The location at which the target function is defined and a list of locations referencing the target function Target Indicates the name of the target function Definition Indicates the location at which the target function is defined Note that if the information cannot be acquired from the cross reference file then None is displayed File name Number Indicates the file nameN te 1 at which the location in question of lines exists The number in parentheses indicates the number of lines line number in the file Line 1 of the location Displays a 1 line excerpt from the file at the location At this time the target function name is highlighted Reference Lists the locations referencing the target function If there is the Dynamic analysis information then the number of times the target function is executed is included in parentheses Note that if the information cannot be acquired from the cross reference file then None is displayed File name Number Indicates the file name 1 at which the
180. me variable name with any one of the following methods Drag and drop an arbitrary row of the Function List panel Variable List panel to this area Drag and drop an arbitrary character strings to this area Specify Class Name CC RX If required as a search parameter for a function variable you can specify the class name to which a member function member variable to search belongs You can either type character strings directly into the text box up to 2046 characters or select one from the input history via the drop down list up to 10 items Next to specify conditions for the specified character strings select the desired conditions in the Condition combo box contains is selected by default Searches are case insensitive if the Case sensitive check box is selected Remark You can also specify the class name with any one of the following methods Drag and drop an arbitrary character strings to this area Specify Parent Count If required as a search parameter for a function you can specify the number of parent functions to search You can either type a value directly into the text box settable range 0 to 65535 or select one from the input history via the drop down list up to 10 items Next to specify conditions for the specified value select the desired conditions in the Condition combo box equals is selected by default Specify Child Count If required as a search parameter for a function you can spe
181. member function then const volatile is displayed immediately after the function name Class Name CC RX Static analysis Displays the name of the class to which the function belongs If it is a template class then the number of template arguments are also displayed in the format of class name lt T the number of template argu ments gt Note however that if the function is not a member function or if analysis was not completed then this will be blank Namespace CC RX Static analysis Displays the name of the namespace to which the function belongs If the namespace is nested then it is displayed in the format of namespace name namespace name lf it is an anonymous namespace then lt unnamed gt is displayed Note however that if analysis was not completed then this will be blank File Name Static analysis Displays the file name without path of the C C source file where the function is defined Note however that if it is not defined in a C C source file in project or if analysis was not completed then this will display No Definition If it is defined in a header file then the name of the header file is dis played File Passote 1 Static analysis Displays the absolute path of the C C source file where the function is defined Note however that if it is not defined in a C C source file in project or if analysis was not completed then this will be blank
182. mns displayed There are two ways to perform this operation as shown below a Performing the operation from the panel Use the mouse to drag and drop the items to hide off of the panel Figure 2 9 Restricting Columns Displayed Operation from Panel j T di AeL SS unit of Time T G FunctionName Ye FileName Te Attribute V A Return Type 3w D rt C _ad t woud 3w AD Read CG_ade unsigned shor ze AD _Start Use mouse to drag and drop void w AD_Stop items to hide off panel void b Performing the operation from the Column Chooser dialog box On the left edge of the panel s header area click the El button to open the Column Chooser dialog box and then clear the check boxes of the names of the items to hide Figure 2 10 Restricting Columns Displayed Operation from Column Chooser Dialog Box Column Chooser Click this button to open the Column F Funetion Name Chooser dialog box i F File Name E Fille Path import CG sde cA Retum Type AD Read CG ad m iy A E Arguments Count z AD_Start CG ade i Arguments w AD_Stop Clear the check boxes of the items to hide Defaut Close R20UT3461EJ0100 Rev 1 00 ztENESAS Page 26 of 163 Aug 01 2015 CS V3 02 00 2 FUNCTIONS 2 Adding columns to display On the left edge of the panel s header area click the button to open the Column Chooser dialog box and then select the check boxes of the
183. n List panel Variable List panel Call Graph panel Class Member panel Set a break event at the specified function or variable Function List panel Variable List panel Register a watch expression for the specified variable Variable List panel View list of locations referencing function variable You can find and display a list of locations referencing a function variable Geart of Finding All Selerence Target sub l l Definition sub1 c 9 int ant arg_a int arg bB iat arg_e l Reference subl bhi int int int int iJ Reference subd2 lt 20 2 2 3d Reference main cl102 oresalt local_a lacal b lemal_el zl Reference main lt 136 jreeult Mff iglesia glabal b glebsl_el i d list of the functions which are being called by function sub0l subdi subtil A list of the variables daing a reference read write by function subt sl glowal_ a End of finding all references Graph analysis information A line chart indicating changes in values of variables or of data collected for Smart Analog E1 E20 RL78 is displayed Anaha Chart mja Arabs rated i arpg Seog oae tee eee m1 me a Trigger To uae thee tagger knon conige the gepet of Ieper patiga on Pe Faopety peared a a a Sey R20UT3461EJ0100 Rev 1 00 ztENESAS Page 12 of 163 Aug 01 2015 CS V3 02 00 1 GENERAL Apie chart indicating function execution tim
184. n Trace function of the debug tool is enabled Chart type One of the following 1 Step plot line chart Normal line chart Step plot line chart fixed Registration of graphing targets Before execution of a program Not dependent on the execution timing because analysis is based on trace data Number of targets that can be graphed Dependent on the size of the target area of RRM functionNe 2 If Point Trace events are used Dependent on the maximum number of enabled events 3 in the debug tool Size of targets that can be graphed Less than or equal to 4 bytes Less than or equal to 4 bytes CC RH RX Less than or equal to 2 bytes RL78 Time display range The execution time from the start to the end of program execution Run Break time Time registered as trace data Time display format XXXsXXXms XXXsXXXmsXXXusXXXns Trigger function Available see 3 Use the trigger func tion None Real time update Possible Impossible Transition points of value Not possible to identify accurate time change points because they depend on the specified sampling intervalNoe 4 Matches actual timing can be checked from Pop up display Target core RH850 See b RRM function RAM monitor pseudo RRM function See a Trace function Note Notes 1 See 3 3 Real time Sampling Analysis See 3 4 Trace Data Analysis T
185. n each time program execution stops Note that this item is disabled when the Refresh at program stop property in the General cat egory on the Settings tab of the Property panel is set to other than Specify Individually this button is locked in accordance with the setting on the Property panel Resets highlighting of values that have been changed by executing a program Note that this item is disabled during execution of a program ml Displays only the information for functions in a file s category s currently selected in the Proj ect Tree panel see a Linking with the Project Tree panel Displays only the information for functions starting with the word at the caret position in the Edi tor panel see b Linking with the Editor panel RH850 Displays only the information for functions in the common region and PE currently selected in the Debug Manager panel see c Linking with the Debug Manager panel RH850 Note that this item is disabled when the selected microcontroller version does not support multi core or while disconnecting from the debug tool Unit of Time The following cascade menus are displayed to specify the time unit for the analysis tool The setting of the Unit of time property in the General category on the Settings tab of the Property panel is specified by default The time unit set in this toolbar is reflected in the Property panel
186. n execution time ratios Display a pie chart of the function execution time ratios The chart is displayed in the Analysis Chart panel s Execution Time Percentage Chart tab based on the currently acquired Dynamic analysis information equivalent to Execution Time Percentage in the Function List panel See the Execution Time Percentage Chart tab for details on each of the area displayed Figure 2 37 Chart of Function Execution Time Ratios main 13 11 Others 3 72 _ sub0t 7483 sub02 7 02 main sub static 5 56 7 A A ash 7 02 subj _ subO1 605 a 2 p as 1_subO 6 9555 subO02_suibO1 6 05 _ Variable Value Changing Chart Cautions 1 When the debug tool to use does not support the Trace function or when the debug tool s trace function is not enabled this chart cannot be displayed Even if the trace function is enabled condition if there is no trace data in the trace memory no chart is displayed on this tab and then the following message will be displayed on the Output panel There is no execution time information Cautions 2 To display this chart see cautions of a Trace function Cautions 3 E1 E20 RX EZ Emulator RX Because the trace time tag function is not supported this chart cannot be displayed The following operations can be performed on the call graph displayed R20UT3461EJ0100 Rev 1 00 ztENESAS Page 55 of 163 Aug 01 2015 CS
187. n s code size in decimal number notation analysis Note however that this will display if analysis is not complete Start Address Static Displays the function s start address in hexadecimal number notation analysis The number of digits to display is equivalent to the maximum address value of the selected microcontroller Note however that this will display if analysis is not complete End Address t 1 Static Displays the end address of the function aligned in ROM in hexadecimal analysis number notation The number of digits to display is equivalent to the max imum address value of the selected microcontroller Note however that this will display if analysis is not complete R20UT3461EJ0100 Rev 1 00 ztENESAS Page 91 of 163 Aug 01 2015 CS V3 02 00 Item Type A WINDOW REFERENCE Contents Reference Count Static analysis Displays the number of times the function is referenced in the program in decimal number notation Prototype declarations are also counted as ref erences Code in C C source files that is referenced but is eliminated by the pre processor during compilation e g via if or ifdef statements is not included in the number of references it is also not output by the search results from Find All References in the context menu References to functions via assignment to function pointers are not included in the reference count Note however that thi
188. n the Select specification method of files to analyze property is set to Files not to analyze Default Files not to analyze 0 Modifying Specify with the Select Files not To Analyze dialog box The Select files not to analyze dialog box is opened by clicking the button that appears at right edge in the column when this property is selected no files can be specified on the Property panel Files to analyze Specify files that are the subject of analysis This property appears only when the Select specification method of files to analyze property is set to Files to analyze Default Files to analyze 0 Modifying 3 Import Export The detailed information on import export functions is displayed and its configuration can be changed For details on the import export function see 2 12 Import or Export Information File Specify with the Select Files To Analyze dialog box The Select files to analyze dialog box is opened by clicking the but ton that appears at right edge in the column when this property is selected no files can be specified on the Property panel R20UT3461EJ0100 Rev 1 00 Aug 01 2015 ztENESAS Page 75 of 163 CS V3 02 00 Import files A WINDOW REFERENCE Specify the file to import The following placeholders are supported ProjectName Replaces itself with the project name MicomToolPath Replaces itself with the a
189. nction information Static analysis information and Dynamic analysis information The timing when each type of information can be displays differs see 1 1 2 Types of analysis infor mation When the active project is changed while displaying the function information the function information of the target project is displayed Note however that if the cross reference information has not been generated in the project or the analysis tool is not supported by the project nothing is displayed on this panel The value of the information that has been changed because of the execution of a program is shown highlighted the color depends on the configuration in the General Font and Color category of the Option dialog box To reset the highlighting click the buton on the toolbar The items and details acquired as Tunction information are as follows R20UT3461EJ0100 Rev 1 00 ztENESAS Page 89 of 163 Aug 01 2015 CS V3 02 00 Item Type A WINDOW REFERENCE Contents Function Name Static analysis Displays the name of the global function the file internal static function or the member function function that is defined with class type that is defined referenced in the C C source file Up to 1024 characters can be displayed The meanings of an icon displayed is as follows W Function i Member function CC RX JT Template function CC RX CC RX If the function is a const member function volatile
190. nd Dynamic analysis information e g read count write count data coverage etc Et Variable Name Fa Fie Hame Ye Attnbute Fo Type Te Members Th Address To j 2d dats ip mane unsigned shart ged finish CG maine unsigned char g eoun Wms CG maine un igned int w g crunt imes Ca maine unsigned int go flagdetecst CG_maine unsigned sheet w _S_ rome CG_systeminite Total CG_maine Total CG_systeminite m R20UT3461EJ0100 Rev 1 00 ztENESAS Page 10 of 163 Aug 01 2015 CS V3 02 00 1 GENERAL Displaying the call graph A tree structured chart call graph indicating calling relationships between functions in the program is displayed a nse Twa Fncson fa 8 tsa Displaying class information function information variable information The class information CC RX function information and variable information in the program are displayed in a tree structure Define Macros and Constants mj Classes m Union Types Ha Enum Types l che lempuncleT 20 zw tampfuncl2 lt T 24tchar shot che LemphuncOZ lt T 24shart int zw bamplababaet OT fend Variables w AAA w emo R20UT3461EJ0100 Rev 1 00 ztENESAS Page 11 of 163 Aug 01 2015 CS V3 02 00 1 GENERAL Linked operation with debug tool The following operations can be performed on the debug tool from the various panels of the analysis tool Jump to the location where the specified function or variable is defined Functio
191. ned Location Note that this item is disabled while disconnecting from the debug tool Jump to Memory Opens the Memory panel Memory1 and displays the memory list corresponding to the start address of the function of the current row see 2 7 Jump to Defined Location Note that this item is disabled while disconnecting from the debug tool Copies the contents of the selected row s to the clipboard as character strings separated by tabs Note that the contents of the clipboard cannot be pasted to this panel R20UT3461EJ0100 Rev 1 00 Aug 01 2015 ztENESAS Page 96 of 163 CS V3 02 00 A WINDOW REFERENCE Variable List panel This panel is used to display the acquired variable information The following types of variable are displayed in this panel Global variable Static variable inside a file Static variable inside a function Class variable only when C source files are subject to analysis Note however that the variable information in the files not to be analyzed is not displayed in this panel see 1 1 1 What is analyzed See 2 1 Overview for details on how to display the variable information Cautions 1 E20 RX In the debug tool s Property panel when the Trace data type property in the Trace category on the Debug Tool Settings tab is set to Branch the acquisition time of the Dynamic analysis information by trace data will increase because complement of instructions betwe
192. ng with which the graph is displayed in response to the specified trigger You can use this trigger function to display the graph with the appearance of an oscilloscope The trigger function can be configured in the Trigger category on the Variable Value Changing tab of the Prop erty panel Your configuration contents will be listed on this tab as the trigger information Caution The properties in the Trigger category cannot be changed during execution of a program Figure 2 31 Setting of Trigger Function Trigger Category a Trigger Use trigger function Yee Trigger mode Auto Trigger source chi Trigger level oO Direction of bigger edge Rising Trigger position 0 Trigger mark color E orange Use trigger function Select whether to use the trigger function Select Yes to use the trigger function default No Trigger mode Select the trigger mode the timing at which graphs are updated Updates the graph display cyclically in real time default When a trigger signal is received the data immediately prior to the trigger signal is graphed to the left of the trigger position and the data immediately after the trigger signal is graphed to the right of the trigger position When the graph reaches the right edge of the graph area the graph resumes scrolling to the left and the graph display is updated Single Only updates the graph display upon the first trigger signal from the start of sampling When a trigger s
193. ning You can control toggle the start stop of a real time sampling manually via the Sampling button on this tab by performing the following setting on the Property panel Variable Value Changing tab gt gt General category gt gt Start stop real time sampling property gt gt Manual Trace data analysis Each time program execution is stopped Note however that if the Refresh at program stop property in the General category on the Seitings tab of the Property panel is set to other than Yes default the information will be updated in accordance with the setting on the Property panel Note E1 E20 RL78 Click the button on the debug toolbar to operate the debug tool in the Data collection mode all execution related buttons other than the g button are disabled For details on Smart Analog function see CS Integrated Development Environment User s Manual Debug Tool Cautions 1 If the acquired graph data exceeds the buffer capacity 10000 plots then the oldest graph data is overwritten by the new graph data ring buffer system In this case part of the graph rendering will be blank Cautions 2 When Real time sampling analysis is selected if acquiring graph data has failed lines between transition points are not displayed but only the time information is displayed see a Graph Cautions 3 E1 E20 RL78 If you run the program by the debug tool in the Data collection mode change the Dat
194. ning values from left to right to RGB Example 192 255 10 79 Three eight bit values delimited by commas assigning values from left to right to RGB Example 255 10 79 Using general English color words case insensitive Example Blue R20UT3461EJ0100 Rev 1 00 ztENESAS Page 87 of 163 Aug 01 2015 CS V3 02 00 A WINDOW REFERENCE Function List panel This panel is used to display the acquired function information The following types of function are displayed in this panel Global function Static function Member function only when C source files are subject to analysis Note however that the function information in the files not to be analyzed is not displayed in this panel see 1 1 1 What is analyzed See 2 1 Overview for details on how to display the function information Cautions 1 Cautions 2 Cautions 3 Remarks 1 Remarks 2 Remarks 3 Figure A 6 Toolbar yt E20 RX In the debug tool s Property panel when the Trace data type property in the Trace category on the Debug Tool Settings tab is set to Branch the acquisition time of the Dynamic analysis information by trace data will increase because complement of instructions between branch instructions is performed the processing time is proportional to the set value of the Trace memory size MByte property in the same category above CC RX When C source files are subject to analysis
195. nly declared and not used the filename will not be dis played It will be treated as a function with no defined location If you specify a function parameter with a class type will be displayed in the Start Address End Address and Code Size Bytes columns If you define a function with an argument of type signed char and an overloaded function with an argument of type char will be displayed in the Start Address End Address and Code Size Bytes columns 2 Variable List panel This feature does not display static variables defined in template functions or member functions defined in tem plate classes This feature does not count the number of variable references in template functions and member functions defined in template classes The compiler changes the types of const variables without an extern volatile declaration to constants As a result they will not appear in the Variable List as variables Global variables with the same name defined in anonymous namespaces in different files will be treated as hav ing the same type Address and Size Bytes of anonymous structures and anonymous unions cannot be displayed 3 Call Graph panel By default template functions and member functions defined in template classes do not appear in this panel To display them on the Settings tab of the Property panel set the Display the function variable without definition at Call Graph panel property o
196. ns Variables list area This area displays the information of the node currently being selected in the Classes Categories tree area e g function names variable names that are defined in the node The relationship between the selection in the Classes Categories tree area and the display contents of this area is as follows R20UT3461EJ0100 Rev 1 00 ztENESAS Page 131 of 163 Aug 01 2015 CS V3 02 00 A WINDOW REFERENCE Node Selection Display Contents of This area AH Typedefs g Alternative name al Global Functions and Variables Global function name Static function name amp Global variable name Static variable inside a file name Define Macros and Constants Macro name Constant ie Class name Alternative name Interface name h Member function name Class variable name a Struct type name C source file CC RX P Instance variable name Constant To Union type name C source file CC RX g Alternative name k Member function name P Instance variable name Constant Z gt Struct type name C source file o Member variable name p Union type name C source file if Member variable name Enum type name a4 Enum member name p Namespace name None c_ File name Other than above Caution Nothing is displayed in this area if functions variables to be displayed do not exist or nothing is being selected in t
197. ntidi Execuion CG _ad c61 waia Remarks 1 If there is already a breakpoint set at the corresponding location the behavior is as follows If a breakpoint in a valid state is set No effect If a breakpoint in an invalid state is set Sets the breakpoint to a valid state Remarks 2 CC RX If the target function is a template function and multiple addresses corresponding to its template function exist then the breakpoints will be set to all the addresses 2 9 2 Seta break event to a variable Set a break event with access condition to a variable on the Variable List panel To do this select the row in which the target variable is displayed make sure that the current row mark j appears to the left of the selected row then from the context menu select one of the following and then press the Enter key Access Break gt gt Set Variable Read Break to Sets a break event with read access condition Access Break gt gt Set Variable Write Break to Sets a break event with write access condition Access Break gt gt Set Variable R W Break to Sets a break event with read write access condition Note that at this time you can specify the value in the text box in the context menu In this case execution will only break if it is accessed with the specified value If you press Enter key without entering a value in the text box then execution will break when the target variable is accessed regardless of the va
198. nu Function List panel dedicated items Context menu How to open On the toolbar in the Main window click the button From the View menu select Program Analyzer gt gt Function List Description of each area 1 Header area a Column name The name of the item of the acquired function information is displayed Marks icons that are displayed at the name of the item indicate as follows Mark Icon Meaning oly Indicates whether there is a sort order setting see 2 6 4 Sort the analysis information wT Indicates whether there is a filter display setting see 2 6 5 Filter the analysis informa tion a g Indicates whether display is locked see 2 6 3 Lock the specific column to display 4A Indicates that a message relating to information about this item has been output to the Output panel Hover the mouse over it to display a pop up with the last message to be output Remark Columns to display can be customized via mouse operations in this area Set the columns to display Change the order of the columns to display Lock the specific column to display Opens the Column Chooser dialog box in order to sort and show hide the items col umns displayed in the panel and return customized settings to the defaults see 2 6 Customize Display Method 2 Information area This area displays the acquired function information The analysis tool acquires two types of fu
199. o gram Analyzer As from the File menu R20UT3461EJ0100 Rev 1 00 ztENESAS Page 142 of 163 Aug 01 2015 CS V3 02 00 A WINDOW REFERENCE Find References tab Use this tab to display a list of locations referencing the specified function variable See 2 11 Display List of Referencing Location for details on how to output lists of locations referencing a function or variable Cautions 1 This tab does not appear if the Display List of Referencing Location operation is never performed Cautions 2 Code in C C source files that is referenced but is eliminated by the preprocessor during compilation e g via if or ifdef statements is not output as referenced locations Cautions 3 Reference of a function that is assignment to function pointers is not output as referenced locations Cautions 4 Each time a search is made for referencing locations the output list of referencing locations is cleared Figure A 34 Output Panel Find References Tab Seact of Finding all feferences Target subl o Definition eubdl e S 4 a arg_a int arg_b int arg_e Reference gsubd1 n121 tint int inti Reference aubds e 70 lf 2 i EE Reference main c 103 gt result local a lacal h loral_ot l Reference sain e l36 y jremule Mi iglsbal_ a glabal b glabal el d A liat of the functions which ara being called by function abl subdi subti
200. ocation where the function variable or class CC RX etc on the Function List panel Variable List panel Call Graph panel Class Member panel is defined Cautions 1 If the target of the following operation is a member of an enumeration type then a jump will be made to the defined location of the enumeration type Note however that it is not possible to jump to the defined location of a member of an anonymous enumeration type via the member node Cautions 2 CC RX When C source files are subject to analysis the defined location information on member functions defined in a template function or a template class cannot be obtained Therefore the following operation is invalid for them except however when the template function is defined with a static declaration and defined outside a class 1 Jump to the Editor panel When the jump is executed the source file in which the target is defined opens in the Editor panel and the caret moves to the line where it is defined To do this perform the following operation Panel Target Operation Function List panel A line of function Double click Variable List panel A line of variable Call Graph panel A function box Double clickNe A variable box Class Member panel On the classes categories tree area Select Jump to Source from the context A namespace node CC RX ee A class name node CC RX An interface name node CC RX A struct type name node
201. oes not support the trace time tag feature The debug tool is set in the Data collection modeNote 1 Load from file Displays graphs by loading the analysis chart data file mtac that has been saved Analysis chart data file Specify the analysis chart data file mtac to restore graphs folder file The following placeholders are supported ProjectName Replaces itself with the project name MicomToolPath Replaces itself with the absolute path of the CS install The reference point of the relative path is the project folder This property appears only when the Analysis method property is set to Load from Default Blank Modifying Specify with the Open File dialog box The Open File dialog box is opened by clicking the button that appears at right edge in the column when this property is selected no files can be specified on the Property panel Available values One file mtac R20UT3461EJ0100 Rev 1 00 Aug 01 2015 ztENESAS Page 79 of 163 CS V3 02 00 Start stop real time sampling A WINDOW REFERENCE Select whether the start stop of the real time sampling synchronizes to the start stop of a program execution This property appears only when the Analysis method property is set to Real time sampling Default Sync Modifying Select from the drop down list Available values Sync Synchronizes to the start stop of a progr
202. of the Analysis Chart panel select the zoom 1 4 check box Description of each area 1 Graph control area Figure A 27 Graph Control Area a Data source Dala source From chert data feniine a Data source Displays the data source of the graph currently being displayed Display Contents Description From chart data online Indicates that the data source is the graph currently being displayed in the Vari able Value Changing Chart tab From file offline Zoom Indicates that the data source is the information form the loaded analysis chart data file mtac Indicates the color of the zoom frame currently being specified with the Zoom 17 4 color property in the Gen eral category on the Variable Value Changing tab of the Property panel R20UT3461EJ0100 Rev 1 00 Aug 01 2015 ztENESAS Page 135 of 163 CS V3 02 00 A WINDOW REFERENCE c Save button Opens the Save As dialog box to save the contents currently being displayed on this panel to the specified file see 2 14 Save Analysis Information 2 Chart area Figure A 28 Chart Area SS EE SEE EEE EEE PEE EEEEEES ee Pe po H i i i Pi i i i 4 eieiei a i Hi i H i ee d Yaxis value E a i a ee a necreanfereeseats EENEI Te E E A ERE EE j i f j E mrena 1 ee hH E TNE yi 1e40me 142 32 1m This are
203. og box to set detailed filtering conditions Only information matching the conditions specified in this dialog will be displayed Blanks Displays empty fields NonBlanks Does not display empty fields Information list All acquired information is displayed in a list as strings Only values matching the string selected from the list are displayed Select Custom to open the Filter Settings dialog box Use this dialog box to set up to two condition groups Both conditions can be linked into a single filtering condition via the logical operator buttons AND OR Use the top condition specification area if you only wish to specify one filtering condition R20UT3461EJ0100 Rev 1 00 ztENESAS Page 29 of 163 Aug 01 2015 CS V3 02 00 2 FUNCTIONS a Figure 2 15 Filtering via Custom Settings for Each Column Filter Settings Dialog Box Filter Settings Filter conditions Condition 1 Condition 2 Enter comparison values Select the condition for the comparison numbers strings directly value from the drop down list The meanings of the filter icons are as follows Table 2 7 Filter Icons Description Indicates that no filtering is taking place default Indicates that the information is being filtered Filtering results linked to panel a Linking with the Project Tree panel b Linking with the Editor panel c Linking
204. ointer if the debug Simulator tool s Trace function is disabled or if analysis is not complete Data Coverage Dynamic Displays the data coverage rates of the variable number of bytes IECUBE RL78 analysis accessed in the address range variable size x 100 see 3 2 Coverage Simulator Results The level of shading of the cell s background color indicates the data cover age Note however that this will display if the debug tool s Coverage function IECUBE E20 RX Simulator is disabled or if analysis is not complete Notes 1 This item does not appear by default See 2 6 1 Set the columns to display for details on how to display this item Notes 2 If including an alternative name by using define or typedef then not the alternative name but the original type is displayed Notes 3 Set the Accumulate result of analysis property in the General category on the Settings tab of the Property panel to Yes to display the cumulative value for each program execution Notes 4 The calculation is based on the acquired trace data So for example if one write to a 4 byte area was output in the trace data as the upper 2 bytes and the lower 2 bytes then two times will be dis played In the bottom of the Variable Name item the following information for each file is shown as Total Note that No Definition displayed in the File Name item is treated as one file Figure A 9 Total Di
205. on The analysis tool acquires two types of function information Static analysis information and Dynamic analysis information The timing when each type of information can be displays differs see 1 1 2 Types of analysis infor mation When the active project is changed while displaying the variable information the variable information of the target project is displayed Note however that if the cross reference information has not been generated in the project or the analysis tool is not supported by the project nothing is displayed on this panel The value of the information that has been changed because of the execution of a program is shown highlighted the color depends on the configuration in the General Font and Color category of the Option dialog box To reset the highlighting click the button on the toolbar The items and details acquired 4S variable information are as follows Item Type Contents Variable Name Static Displays the name of the global variable the static variable inside a file the analysis static variable inside a function or the class variable static member variable of a class type that is defined referenced in the C C source file Up to 1024 characters can be displayed The meanings of icons displayed are as follows fe Variable By Member variable CC RX CC RX If an anonymous union is used then this will display lt unnamed_N gt as the variable name N A number from 1 automatical
206. on of a program Displays the latest information automatically by acquiring the information each time program execution stops Note that this item is disabled if the Refresh at program stop property in the General cate gory on the Settings tab of the Property panel is set to other than Specify Individually this button is locked in accordance with the setting on the Property panel Opens the Call Graph Search dialog box to search for a function variable existing on this panel R20UT3461EJ0100 Re Aug 01 2015 v 1 00 ztENESAS Page 124 of 163 CS V3 02 00 A WINDOW REFERENCE File menu Call Graph panel dedicated items The File menu for this panel provides the following items and functions Save Call Graph Data Overwrites the contents of this panel to the previously saved file see 2 14 Save Analysis Information Note that when the file has never been saved or the file is write disabled the same operation is applied as the selection in Save Call Graph Data As Save Call Graph Data As Opens the Save As dialog box to newly save the contents of this panel to the spec ified text file see 2 14 Save Analysis Information Edit menu Call Graph panel dedicated items The Edit menu for this panel provides the following items and functions Find Opens the Call Graph Search dialog box to search for a function variable currently existing on this panel Context menu
207. on the graph for that segment R20UT3461EJ0100 Rev 1 00 ztENESAS Page 110 of 163 Aug 01 2015 A WINDOW REFERENCE CS V3 02 00 A WINDOW REFERENCE Regardless of a range of current graph display if a channel whose obtained values are always outside of the display range exists then the message will be displayed on the Output panel Remark The offset value for each channel can be specified in unit grids of Y axis with the Offset 7 76 property in the Channel 1 16 category on the Variable Value Changing tab of the Property panel Trigger information Displays the contents currently being set in the Trigger category on the Variable Value Changing tab of the Property panel if the trigger function is used see 3 Use the trigger function will be displayed in this area if the trigger function is not used Trigger level Indicates the trigger level when the trigger function is used see 3 Use the trigger function The value of the trigger level can be changed by dragging this trigger mark with the mouse Note however that this operation is disabled during execution of a program Trigger position Indicates the trigger position when the trigger function is used see 3 Use the trigger function The value of the trigger position can be changed by dragging this trigger mark with the mouse Note however that this operation is disabled during execution of a program Pop up display When the mouse c
208. operty in the General category on the Settings tab of the Property panel is set to other than Yes default the information will be updated in accordance with the setting on the Property panel Remarks 2 A function variable whose source file does not exist in the project can be displayed in the call graph if the Display the function variable without definition at Call Graph panel property in the General category on the Settings tab of the Property panel is set to Yes R20UT3461EJ0100 Rev 1 00 ztENESAS Page 23 of 163 Aug 01 2015 CS V3 02 00 2 FUNCTIONS 2 5 Display Class Function Variable Information You can display the class information CC RX function information and variable information in the program by using a tree structure These information is displayed on the following Class Member panel which is opened by clicking the button on the Main window s toolbar Note however that the class information CC RX function information and variable information in the files not to be analyzed is not displayed in this panel see 1 1 1 What is analyzed See the Class Member panel for details on the tree displayed Figure 2 8 Display Class Information Class Member Panel Toolbar View Setting combo box Panel control area ca G 9 a Typedels af Global Functions and Variables ag Define Macros and Constants H4 Namespaces ee Classas H4 Struct Types j Union Types L Enum Types
209. or ey ward or backward while holding down the Ctr Figure A 31 Output Panel Stopped by user operation EOF The following items are explained here How to open Description of each area File menu Output panel dedicated items Edit menu Output panel dedicated items Context menu How to open From the View menu select Output Description of each area 1 Message area This area displays operation logs for various components analysis tool design tool build tool debug tool etc provided by CS and a list of places that refer to the specified function variable For details on the contents displayed in this area see the section explaining the corresponding tab 2 Tab selection area The origin of messages is changed when each tab is selected The following tabs are available for the analysis tool All Messages tab Program Analyzer tab Find References tab Remark When the new message is output mark is displayed to the left of the tab name File menu Output panel dedicated items The File menu for this panel provides the following items and functions R20UT3461EJ0100 Rev 1 00 ztENESAS Page 139 of 163 Aug 01 2015 CS V3 02 00 A WINDOW REFERENCE Save Output Tab Name Overwrites the contents that are displayed on the currently selected tab to the pre ciously saved text file txt Note that when the file has never been saved or
210. ort Export Category a Import Export import Tiles Export the functions and variables Export file name for functions Export file name for variables The above setting completes the automatic export of the information file Execute a build rebuild to generate the information file automatically in the specified folder with the specified file name Caution Only the current active project is subject to this export Remark The following placeholders are supported in the Export file name for functions Export file name for variables property ProjectName Replaces itself with the project name ActiveProjectName Replaces itself with the active project name 2 Import the information file Import the information file you generated exported To do this set the Import files property in the Import Export category on the Settings tab of the Property panel When the Import files property is selected a button appears When this button is clicked the following Path Edit dialog box opens Figure 2 22 Import files Property in Import Export Category a Import Export gt AT inca ts R20UT3461EJ0100 Rev 1 00 ztENESAS Page 40 of 163 Aug 01 2015 CS V3 02 00 2 FUNCTIONS Figure 2 23 Specification of Import Files Path Edit Dialog Box Path Edit Path One path per one line G Active Preci e FuncList_ Sub mf Bowes Permit non existent paih Placeholder Placeholder Wale Descript
211. ox To reset the highlighting click the button on the toolbar Remarks 3 The current row mark gt indicates the current row The following operations can be performed on the function with the current row mark Jump to Defined Location Set Break Events Display List of Referencing Location Remarks 4 Information for functions defined outside the active project and which are never referenced from the active project is ordinary not displayed in the Function List panel For detailed instructions on displaying function information in this case see 2 12 Import or Export Infor mation File R20UT3461EJ0100 Rev 1 00 ztENESAS Page 18 of 163 Aug 01 2015 CS V3 02 00 2 FUNCTIONS 2 3 Display Variable Information Display the variable information variable name file name attribute read count write count data coverage etc in the program The latest variable information that can currently be displayed se 1 1 2 Types of analysis information is displayed on the following Variable List panel which is opened by clicking the button on the Main window s toolbar Note however that the variable information in the files not to be analyzed is not displayed in this panel see 1 1 1 What is analyzed See the Variable List panel for details on each of the variable information items displayed Figure 2 2 Display Variable Information Variable List Panel z Toolbar unsigned short DHE unsigned char CH i
212. panel is updated automatically if you change the setting of the property in this category The number of func Specify the number of the functions displayed on the Execution Time Percentage tions displaying in the Chart tab of the Analysis Chart panel Execution Time Per The function with a large ratio of the execution time is displayed in the graph by prior centage Chart ity and the remainder is collectively displayed as Others Default 10 Modifying Directly enter from the keyboard Available Integer number between 1 and 100 values R20UT3461EJ0100 Rev 1 00 ztENESAS Page 77 of 163 Aug 01 2015 CS V3 02 00 A WINDOW REFERENCE Variable Value Changing tab The Variable Value Changing tab is used to display the detailed information on graphs displayed in the Variable Value Changing Chart tab of the Analysis Chart panel categorized by the following and the configuration can be changed 1 General 2 Trigger 3 Smart Analog E1 E20 RL78 4 Channel 1 16 Figure A 5 Property Panel Variable Value Changing Tab Example of Using E1 RL78 Start stop real time sampling Number of transition location for auto adjustment Time per grid Time Div Chart type Specify foreground color and background color Cursor A color Cursor B color Zoom 1 color Zoom color Zoom 3 color Zoom color 2 gt Trigger Use trigger function 3 gt Smart Anabog Samp
213. panels by selecting the panel numbers in the Zoom combo box Remark The color of each zoom frame can be changed via the Zoom 1 4 color property in the Gen eral category on the Variable Value Changing tab of the Property panel Channel information area The display range of this area can be changed by moving the splitter with the mouse In addition this area can be shown hidden by clicking the mark on the center of the splitter Figure A 15 Channel Information Area Wen a Channel number R siatie ehar val 4 b Variable name check box F lg 100 c Val Div Channel number Displays the channel number ch1 to ch16 Remark E1 E20 RL78 If the debug tool is in Data collection mode the icon displayed here changes to ah from w Variable name check box Displays the name of a variable including register name address expression currently being registered in the channel as a graphing target in a check box format none will be displayed if no graphing target is registered The character color of the variable name is the same as the rendering color of the graph Select the check box to display the graph corresponding to the variable multiple selections possible In the default condition all check boxes where the graphing target is being registered are selected Caution E1 E20 RL78 When the debug tool is in Data collection mode the variable name displayed here is not target for graphing Re
214. 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 relating to militar
215. r function then the function boxes of the two functions will be shown linked by a connection line Connection lines are only displayed for static function calls Connection lines are not displayed for dynamic function calls The following information is displayed by each connection line R20UT3461EJ0100 Rev 1 00 Aug 01 2015 ztENESAS Page 121 of 163 CS V3 02 00 A WINDOW REFERENCE Figure A 23 Information of Connection Line Whole view Details view subl_subth lt main subl mubize 14 maine 165 main A maine 55 sublliic 9 Reference count Execution count Reference count Execution count Reference count Indicates the number of times of static calls Execution count Indicates the number of times dynamic calls have been made in parentheses Note that this information appears only when the trace data exist This information is the cumulative value for each program execution when the Accumu late result of analysis property in the General category on the Settings tab of the Property panel is set to Yes Recursive call A connection line and reference count is displayed as follows when a function calls itself y recuie Cone mane 28 Circular call As an example say that there are functions A B and C If A calls B which calls C which then calls A A gt B gt C gt A then although connection lines will be displayed for the
216. race cannot acquire trace data of the access type read write because the graph is rendered by analyzing trace data of the access type If you mix a Point Trace event and a Trace event specified sections then the instruction line at the end of the Trace event specified section may be applied to subsequent Point Trace event For this reason although Location in the pop up display on the graph should be an invalid file name and line number may appear bit type Boolean type and _Bool type variables and structure bit fields are analyzed in byte units In cases where bit type Boolean type and _Bool type variables and structure bit fields are allocated to the same address even a point where access to a single variable or structure bit field occurs is recorded as a transition point in the graph Double clicking on the transition point will jump to the source line of another variable that is allocated to the same address If a structure bit field is assigned to several bytes some of the information on the byte access is not included in the output trace data This portion is displayed as a lost section see a Graph in the graph since the value of the vari able cannot be analyzed E20 RX If Stop Trace Start Trace of the context menu on the Trace panel is selected during a program execution an invalid chart may be displayed E20 RX In the debug tool s Property panel when the Trace data type property in the Trace cat
217. rd while editing the property value Copy Copies the contents of the selected range to the clipboard as character string s Paste Pastes the contents of the clipboard to the property value while editing the prop erty value Delete Deletes the selected character string s while editing the property value Select All Selects all the character strings in the selected property while editing the property value R20UT3461EJ0100 Rev 1 00 ztENESAS Page 68 of 163 Aug 01 2015 CS V3 02 00 A WINDOW REFERENCE Settings tab The Setting tab is used to display the detailed information categorized by the following and the configuration can be changed Sao Re ee 1 2 3 4 Figure A 4 General Analysis Object Import Export Analysis Chart Property Panel Settings Tab 4 General Enable static analyses information Enable dynamic analysis infonmabon Accumulate result of analysis Include the prototype declaration as references Refresh al program stop Unit af tire Delimiis arguments by mew lone Display the SFR IQR Display the tuncionyanable without definition at Call Graph parel Freee memory of host machine when all panels are closed Ask whether cancel the result of analysis or not when out of memory error occurred Analysis Object Select specification method of files to analyze Files not io analyze import Export Import files Expor the funchons and variab
218. rea Time The channel information area Information about display or non display Values of properties on the Variable Value Changing tab in the Property panel Data Item Restored Location Time per unit grid General category gt gt Time per grid Time Div property R20UT3461EJ0100 Rev 1 00 ztENESAS Page 54 of 163 Aug 01 2015 CS V3 02 00 2 FUNCTIONS Data Item Restored Location The name of variable registered in each chan Channel 7 16 category gt gt Variable Address 1 16 prop nel erty Type size for each channel Channel 1 16 category gt gt Type Size 7 16 property Value per unit grid for each channel Channel 7 16 category gt gt Value per grid Val Div 7 16 property Offset value for each channel Channel 7 16 category gt gt Offset 7 16 property Sampling interval Smart Analog category gt gt Sampling interval ms property E1 E20 RL78 Note that saving is possible only when the selected microcon troller incorporates a Smart Analog IC and the debug tool has collected graph data in the Data collection mode Caution Channels without graph data are not saved regardless of whether the graph is visible In this case the default values of the properties for that channel are applied Remark See 2 14 Save Analysis Information for details about saving graph data for purposes other than restoring graphs 2 13 2 Chart the functio
219. red from the cross reference file then None is displayed File name Number of lines Indicates the file namete at which the location in question exists The number in parentheses indicates the number of lines line number in the file Line 1 of the location Displays a 1 line excerpt from the file at the location At this time the target variable name is highlighted Reference Lists the locations referencing the target variable If there is the Dynamic analysis information then the number of times the target variable has been read written is included in parentheses Note that if the information cannot be acquired from the cross reference file then None is displayed File name Number of lines Indicates the file namete at which the location in question exists The number in parentheses indicates the number of lines line number in the file Line 1 of the location Displays a 1 line excerpt from the file at the location At this time the target variable name is highlighted R20UT3461EJ0100 Rev 1 00 ztENESAS Page 145 of 163 Aug 01 2015 CS V3 02 00 Note A WINDOW REFERENCE When the File path item is being displayed on the Variable List panel this item is not displayed by default the absolute path of the file appears Remark A line with a variable described in extern declaration is handled as Reference Figure A 39 Example of List of Locations Referencing Variable
220. rent row mark indicates the current row The following operations can be performed on the function with the current row mark Jump to Defined Location Set Break Events Display List of Referencing Location Graph transitions in values Remarks 4 Information for functions defined outside the active project and which are never referenced from the active project is ordinary not displayed in the Variable List panel For detailed instructions on displaying function information in this case see 2 12 Import or Export Infor mation File R20UT3461EJ0100 Rev 1 00 ztENESAS Page 19 of 163 Aug 01 2015 CS V3 02 00 2 FUNCTIONS 2 4 Display Calling Relationships between Functions Call Graph You can display a tree structured chart call graph that represents calling relationships between functions in the pro gram based on the acquired function information The latest call graph that can currently be displayed see 1 1 2 Types of analysis information is displayed on the fol lowing Call Graph panel which is opened by clicking the button on the Main window s toolbar Note however that the function information and variable information in the files not to be analyzed is not displayed in this panel see 1 1 1 What is analyzed See the Call Graph panel for details on the call graph displayed Figure 2 3 Display Calling Relationships between Functions Call Graph Panel Whole View Toolbars E je Panel controls
221. rigger function property is set to Yes Default 0 Modifying Select from the drop down list Note that changes cannot be made during execution of a program Available The value in decimal number hexadecimal number within the following values range The minimum value of the trigger variable Trigger source to The maximum value of the trigger variable Trigger source Values in floating point notation can also be specified R20UT3461EJ0100 Rev 1 00 Aug 01 2015 ztENESAS Page 83 of 163 CS V3 02 00 Direction of trigger edge A WINDOW REFERENCE Select the direction of the trigger edge This property appears only when the Use trigger function property is set to Yes Default Rising Modifying Select from the drop down list Note that changes cannot be made during execution of a program Available values Rising Generates a trigger signal when the value of Trigger source changes from less than Trigger level to greater than or equal to Trigger level Falling Generates a trigger signal when the value of Trigger source changes from greater than Trigger level to less than or equal to Trigger level Both Generates a trigger signal when both Rising and Falling Trigger position Specify the trigger position i e the horizontal position that indicates the location at which a trigger signal has been generated This property appears only when the
222. rl key double click Cursor B Ctrl key right click Ctrl key right double click Remark You can change the color of each cursor via the Cursor A color Cursor B color property in the General category on the Variable Value Changing tab of the Property panel c Zoom You can zoom in on any location on the graph In the graph control area select the zoom 7 4 check boxes multiple selections allowed to open the Variable Value Changing Chart zoomed in panel for the checked number s and view the specified range in a zoomed display you can open up to four Variable Value Changing Chart zoomed in panels Figure 2 34 Zoom See El Bi 4 Zoom combo box Zoom 7 4 check box Zoom To set the zoom range select the number of the Variable Value Changing Chart zoomed in panel in the Zoom combo box then click and drag with the mouse to select the zoom area During this time you can reset the zoom range by using the same operation as long as Zoom frame appears indicating the drag region displayed on the graph To cancel the zoom range setting press the ESC key during dragging To clear the set range double click somewhere in the graph area a transition point is not included See the Variable Value Changing Chart zoomed in panel for details on zoomed views Figure 2 35 Zoom Variable Value Changing Chart zoom in Panel Variable Value Changing Chart zoome
223. rmation Select data access When acquiring function and variable information Select branch data access Note however that the selectable values depend on the device RX600 RX700 branch data access RX200 RX100 Branch RH850 RX RL78 Clear trace mem ory before running Select Yes Yes Operation after trace memory is full Select the operation to be carried out when the trace memory is full with the collected trace data Non stop and overwrite to trace memory Accumulate trace time R20UT3461EJ0100 Rev 1 00 Aug 01 2015 Select whether to accumulate trace time tags ztENESAS No Page 73 of 163 CS V3 02 00 Micro controller Property of Debug Too Note Description A WINDOW REFERENCE Value to be Set When Yes is Selected for Enable dynamic analysis information Property RH850 RX RL78 Trace memory size Select the trace memory size This property however is not displayed for a device that does not support the trace facil ity If a large value is selected a large amount of data can be collected but because of that it takes a longer time to acquire trace data RH850 Trace priority Select the priority for collecting trace data RX Note Table A 3 Micro controller Usage of trace function Select Trace Bus Master of data access Select the bus master that generated a data
224. rt panel Call Graph panel Class Member panel Variable Value Changing Chart zoomed in panel Output panel R20UT3461EJ0100 Rev 1 00 ztENESAS Page 64 of 163 Aug 01 2015 CS V3 02 00 A WINDOW REFERENCE Project Tree panel This panel is used to display components of the project microcontroller design tool build tool debug tool etc in a tree structure Figure A 2 Project Tree Panel s i MainProject Project if RSFSL115AeFL Microcontroller g er Code Generator Design Toal i CC RK Build Tool 1g RY Simulator Debug Tool i qh Program Analyzer Analyze Tool 6 File a 1 4 7 Heh src_auto h sub l h c subQ2 c h sub h main c h m inh e subtle The following items are explained here How to open Description of each area Context menu How to open From the View menu select Project Tree Description of each area 1 Project tree area Project components are displayed in tree view with the following given node Node Description Program Analyzer Analyze Tool This is the analysis tool to use Remark When the node is selected the detailed information property is displayed in the Property panel and you can change the settings The Property panel can be opened by double clicking on the node when the Property panel is not opened Context menu The following context menu items are displayed by right
225. rty is selected On the Select Files To Analyze dialog box opened select the files to be analyzed R20UT3461EJ0100 Rev 1 00 ztENESAS Page 6 of 163 Aug 01 2015 CS V3 02 00 1 GENERAL 1 1 2 Types of analysis information The analysis tool acquires analyzes and displays the following two types of information 1 Static analysis information This is the function information variable information that can be displayed when a build has completed without any compiler or assembler errors This is the result of analyzing the load module and cross reference information gen erated by the build tool For this reason in order to acquire static analysis information you should configure your build tool to generate cross reference information when performing the build The analysis tool does however provide the following property that forces the build tool to generate cross reference information Property panel gt gt Settings tab gt gt General category gt gt Enable static analysis information property By setting this property to Yes it is possible to generate cross reference information regardless of the build tool s configuration Note that if this property is set to No default the current setting in the build tool will take prece dence 2 Dynamic analysis information This is the function information or variable information provided as a result of analyzing trace data real time RAM monitoring or coverage dat
226. s The value in decimal number within the following range 1 to 1000 Time per grid Time Div R20UT3461EJ0100 Rev 1 00 Aug 01 2015 Specify the time for each of the 10 units grid segments that the grid area is divided into This property is enabled only when the Auto adjustment property is set to None Default ims Note that the value loaded from the file is set to this property if Load from file is specified with the Analysis method property Modifying Directly enter from the keyboard Available values Any one of the following ins to 10s in decimal number Note 2 1to 10s 1 to 10000ms 1 to 10000000ps 1 to 10000000000ns ztENESAS Page 80 of 163 CS V3 02 00 Chart type A WINDOW REFERENCE Select the chart type i e the format of lines between transition points Default Depends on the specification of the Analysis method property When Real time sampling is specified Line chart When Analysis of trace data is specified Step line chart fixed Modifying Depends on the specification of the Analysis method property When Real time sampling is specified Select from the drop down list When Analysis of trace data is specified Changes not allowed Available values Line chart Displays the graph in a normal line chart Step line chart Displays the graph in a step plot line chart Specify foreground color and
227. s While Disconnecting from While Connecting to Debug Tool Debug Tool Function Name Display Display Class Name Display Display Namespace Non display Non display File Name Display Display File Path Non display Non display PM Information RH850 Display Display R20UT3461EJ0100 Rev 1 00 ztENESAS Page 152 of 163 Aug 01 2015 CS V3 02 00 A WINDOW REFERENCE Status While Disconnecting from While Connecting to Debug Tool Debug Tool Import Non display Non display Access Specifier Display Display Attribute Display Display Return Type Display Display Arguments Count Non display Non display Arguments Display Display Code Size Bytes Display Display Start Address Display Display End Address Non display Non display Reference Count Display Display Execution Count Non display Display Execution Time uni Non display Display Execution Time Percentage Non display Display Execution Time Average unit Non display Display Code Coverage Non display Display Table A 6 Default Display Status Variable List Panel Status While Disconnecting from Debug Tool Debug Tool Variable Name Display Display Class Name Display Display Namespace Non display Non display File Name Display Display Function Name Non display Non display File Path Non display Non display PM In
228. s panel Remarks 1 The display contents of this panel are updated when Each time the graph displayed in the Variable Value Changing Chart tab of the Analysis Chart panel is updated except for the real time display update The zoom range is set or cleared The analysis chart data file mtac is loaded Remarks 2 You can restore graphs currently being displayed on this panel by loading the analysis chart data file mtac which saves the data of the graphs see 6 Save the graph data to restore the graph Figure A 25 Variable Value Changing Chart zoomed in Panel Default You can display hide the Channel information area and the Cursor information area by clicking the mark on the center of the splitter on this panel R20UT3461EJ0100 Rev 1 00 ztENESAS Page 134 of 163 Aug 01 2015 CS V3 02 00 A WINDOW REFERENCE Figure A 26 Variable Value Changing Chart zoomed in Panel Whole Area View Variable Yakar Changing Chart zoomed in 1 2 Ati H g ecut_ire 3 Pvp r Fas era Cinar Getin Gai bey nitude dailei A Fag B D Foes Time Y ea a Target E Tra ht a or Splitter Att nae El s_court_ ifs Fy IEA eke Pei g ners The following items are explained here How to open Description of each area How to open faira Cursor H i is Dai Oh chek E asdfs TAa 157 Pehk Parma On the Variable Value Changing Chart tab
229. s the Variable Value Changing Chart zoomed in panel to be displayed Select the check box of the corresponding number to open the Variable Value Changing Chart zoomed in panel Variable Value Changing Chart zoomed in 7 4 multiple selections possible In the default condition no check boxes are selected 2 Chart area Figure A 13 Chart Area Tigger Auto chd 588 L Faling Position 23092ms h Trigger position f Trigger information E 7 l i i etl ry i a asafassasaasaa ee aaaaaa Hpt S RA A Se Se 4 sasajen s a jatna N j d a Trigger level TINE de600me diskams This area displays the relationship between values Y axis value and X axis time in the registered graphing tar get in a line chart The function of each item displayed in this area is as follows a Graph The graph shows how the value of a target registered for each channel changes as the program execution pro ceeds If acquisition of graph data through Real time sampling analysis fails however only time information is provided with no connection lines Such period is called a lost section and appears in the graph after the pro gram has stopped as shown below the background color of graphs depends on the Background color Lost section property in the General category on the Variable Value Changing tab of the Property panel If the debug tool has failed to acquire any single unit of data regardless of the current display range of graphs the
230. s will display if analysis is not complete Execution Count Full spec emulator IECUBE E1 E20 RH850 E1 E20 RX E1 E20 RL78 EZ Emulator RL78 Simulator Dynamic analysis Displays the number of times the function was executed caled asa ote 3 result of program execution in decimal number notation This function counts the number of times that the instruction located at the address allocated to the function label is executed For this reason an invalid value may be displayed if the measurement starts midway through the execution of a function Note however that this will display if the debug tool s Trace function is disabled or analysis is not complete E1 E20 RL78 EZ Emulator RL78 The execution count is calculated according to the following conditions because only the branch origin address can be acquired from the trace data For this reason the execution count of a function whose size is unknown or a function which is being called from an interrupt process ing cannot be calculated If the result of disassembling the branch origin instruction is a CALL CALLT instruction then the execution count of the function containing the branch origin address of the next trace frame is added Execution Time unif Full spec emulator IECUBE RL78 E1 E20 RH850 Simulator Dynamic analysis Displays the execution time of the function the time executing the code in the function body not inc
231. space node CC RX menu A class name node CC RX An interface name node CC RX A struct type name node An union type name node An enum type name node On the functions variables list area A function name node A variable name node A macro name node An alternative name node An enum member name node Remark The line to which the caret moves may be the same as the line of the result of selecting Jump to Source see 2 7 Jump to Defined Location R20UT3461EJ0100 Rev 1 00 ztENESAS Page 34 of 163 Aug 01 2015 CS V3 02 00 2 FUNCTIONS 2 9 Set Break Events You can set a break event in the debug tool at a function variable on the Function List panel Variable List panel Set a breakpoint to a function Set a break event to a variable 2 9 1 Seta breakpoint to a function Set a breakpoint at the start of the function on the Function List panel the first executable line in the function To do this select the row in which the target function is displayed make sure that the current row mark appears to the left of the selected row then from the context menu select Set Break to Function Caution This operation is disabled while disconnecting from the debug tool A breakpoint set via this operation is managed in the Events panel as an event whose name is Break at start of func tion Figure 2 16 Example of Setting Breakpoint in Events Panel Pd a Break al stari of imetia
232. specification of the Analysis method property When Real time sampling is specified Select from the drop down list When Analysis of trace data or Load from file is specified Changes not allowed Note that changes cannot be made during execution of a program Available Yes Uses the trigger function values F 3 No Does not use the trigger function Trigger mode Select the trigger mode the timing at which graphs are updated This property appears only when the Use trigger function property is set to Yes Default Auto Modifying Select from the drop down list Note that changes cannot be made during execution of a program Available Auto Re renders the graph cyclically Also clears and re renders values the graph upon receipt of a trigger signal Single Only renders the graph upon the first trigger signal from the start of sampling Normal Only re renders the graph upon receipt of a trigger signal Trigger source Select the variable channel that is the source of a trigger signal This property appears only when the Use trigger function property is set to Yes Default chi Modifying Select from the drop down list Note that changes cannot be made during execution of a program Available Any one of the channels ch1 to ch16 values Trigger level Select the trigger level i e the threshold value for determining as a trigger signal This property appears only when the Use t
233. splay Variable List Panel Verrable Name Wee FileName Wee SizelByies 7 Reference Count V Read Count VS vime Count Y Tatal OG_ maine 13 i i 4 Total DG _systeminite g 1 1 0 R20UT3461EJ0100 Rev 1 00 ztENESAS Page 101 of 163 Aug 01 2015 CS V3 02 00 A WINDOW REFERENCE Item Contents File Name The target file name File PassNote File pass of the target file Size Bytes Total of the variable s size in the target file Reference Count Total number of times variables are referenced in the target file Read Count Total number of times variables were read in the target file Write Count Total number of times variables were written in the target file Read Write Count Total number of times variables were read written in the target file Data Coverage The data coverage rates of variables in the target file Note This item does not appear by default See 2 6 1 Set the columns to display for details on how to display this item Cautions 1 Items of the Dynamic analysis information do not appear while disconnecting from the debug tool default Cautions 2 The Read Count Write Count Read Write Count Data Coverage item for a bit type variable boolean type variable _Bool type variable bit field structure is measured by counting the number of accesses to the address that the variable is being allocated Consequently if bit type variables boolean type variables _Bool type vari
234. te that when the file has never been saved or the file is write disabled the same operation is applied as the selection in Save Variable List Data As Save Variable List Data As Opens the Save As dialog box to newly save the contents of this panel to the spec ified text file see 2 14 Save Analysis Information Print Opens the Windows dialog box to print the contents currently being displayed in this panel Edit menu Variable List panel dedicated items The Edit menu for this panel provides the following items and functions Copy Copies the contents of the selected column multiple selections possible to the clipboard as character strings separated by tabs Note that the contents of the clipboard cannot be pasted to this panel Select All Context menu Selects all the columns being displayed in this panel The context menu displayed by right clicking on this panel provides the following items and functions Find All References Displays a list of the locations referencing the variable s of the selected row s in the Output panel s Find References tab see 2 11 Display List of Referencing Location Register to Analysis Chart Registers the variable s of the selected row s to the Analysis Chart panel see 2 13 1 Graph transitions in values Note that this item is disabled while disconnecting from the debug tool Access Break The fol
235. ter name Value of the CPU register I O register name RH850 RX I O register value SFR register name RL78 SFR register value Label EQU symbol and immediate address Values of label EQU symbol and immediate address Bit symbol Bit symbol value Notes 2 A judgment is automatically made in order of address expression register name IOR SFR name variable name by the debug tool If a address expression is determined it will be handled as signed 1byte 8bits Notes 3 The relationship between channel numbers and colors is as follows Number aRGB value in 32 Number aRGB value in 32 bits bits Red OxCOFFOA4F Yellowgreen OxCOBEE02F Green 0xC05BE416 Blueviolet 0xC05510FF Blue OxCOO056DFF Pink OxCOFF97E4 Orange OxCOFF541C Brown 0xC0913A37 Lightblue OxC04FC1 FF Ocher OxCOC68E15 Purple OxCOA932FF Darkgreen 0xC0317FO0C Yellow OxCOFFD91C Darkbrown 0xC060493E Redviolet OxCOFF30A5 Grey 0xC072808E Remark About the specification of the color You can specify one of the following Note however that if you specify the alpha value indicating transparency then it is assumed that 255 Oxff opaque was specified 32 bit value assigning each 8 bit segment from high to low to the aRGB values Example OxCOFFOA4F 24 bit value assigning each 8 bit segment from high to low to the RGB values Example OxFFOA4F Four eight bit values delimited by commas assig
236. tion To do this with the focus on the Analysis Chart panel select Save Analysis Chart Data As from the File menu or with the focus on the Variable Value Changing Chart zoomed in panel click the Save button The Save As dialog box opens perform the operation from this dialog The following file formats can be specified when saving the information Text file txt Text format CSV Comma Separated Variables csv CSV format Microsoft Office Excel Workbook xls Microsoft Office Excel book format Analysis Chart Data mtac Ne 1 Analysis chart data file Bitmap bmp Bitmap format 82 bit graphic file format JPEG jpg JPEG format graphic file format PNG png PNG format graphic file format EMF emt Note 2 EMF format Graphic file format Notes 1 This format is only applied to the Variable Value Changing Chart tab of the Analysis Chart panel Notes 2 Only the area of graph rendering is saved trigger marks channel information etc cannot be saved Cautions 1 For the Analysis Chart panel only the contents of the currently displayed tab will be saved Cautions 2 When the graphic file format is selected only the part currently being displayed in the panel will be saved R20UT3461EJ0100 Rev 1 00 ztENESAS Page 57 of 163 Aug 01 2015 CS V3 02 00 2 FUNCTIONS 4 Save call graph information To do this with the focus on the Call Graph panel select Save Call Gr
237. ue per grid Val Div 1 16 A WINDOW REFERENCE Select the value for each of the 10 units grid segments that the grid area is divided into This property is enabled only when the Auto adjustment property is set to None Default The maximum value of the variable The minimum value of the vari able 10 Note that the value loaded from the file is set to this property if Load from file is specified with the Analysis method property E1 E20 RL78 When the debug tool is in the Data collection mode 409 5 Modifying Select from the drop down list Note that changes cannot be made during execution of a program Available values The value in decimal number hexadecimal number within the following range The minimum positive value of the variable to The maximum value of the variable The minimum value of the variable Values in floating point notation can also be specified Offset 1 16 Specify the offset of the graph The graph of the variable value to which this offset value is added is rendered This property is enabled only when the Auto adjustment property is set to None Default 0 E1 E20 RL78 When the debug tool is in the Data collection mode 2048 Modifying Directly enter from the keyboard Available values The value in decimal number within the following range The minimum value of the float type Approx 3 4028235e 38 to Th
238. unions reads writes are counted at the structure union IECUBE variable level the number of reads writes at the individual member and ele E1 E20 RH850 ment levels are not shown E1 E20 RX It may not be possible to analyze reads writes of variables in segments Simulator where variables have been assigned to registers via compiler optimization For this reason reads writes in such sections will not be counted Note however that this will display if the debug tool s Trace function is disabled or if analysis is not complete Minimum Value Dynamic Displays the minimum measurement time from the results of program exe Full spec emulator analysis cution in decimal number notationNote 3 IECUBE Only a variable less than or equal to 4 bytes can be displayed E1 E20 RH850 Note however that this will display if for bit type variables boolean type E1 E20 RX variables Bool type variables structures unions arrays pointer if the debug Simulator tool s Trace function is disabled or if analysis is not complete Maximum Value Dynamic Displays the maximum measurement time from the results of program exe Full spec emulator analysis cution in decimal number notationNote 3 IECUBE Only a variable less than or equal to 4 bytes can be displayed E1 E20 RH850 Note however that this will display if for bit type variables boolean type E1 E20 RX variables Bool type variables structures unions arrays p
239. ursor is hovered over a transition location on the graph the information about that location appears in a pop up The display format is as follows Real time sampling analysis chi 16 Value name Value Data value Time Data value Trace data analysis ch1 16 Value name Value Data value Location File name Line number Time Data value Real time sampling analysis Trace data analysis chl global_c chi global_c a rrr rer ire fon i i li i eee Value s Value 660 Location main ofL3N 1 i Times 0 Time TEs Caution This function is disabled during execution of a program Remarks 1 The Location information is only displayed both when the graph data is acquired via Trace data analysis and when the transition location information exists in the graph data if the information does not exist will be displayed In this case furthermore you can display the applicable location in the Editor panel by double clicking the transition point except for a graph that was restored by loading the analysis chart data file mtac Note however that the Location information may be invalid value when the graph data is acquired by simultaneously using a Trace event and a Point Trace event in the debug tool Remarks 2 The Time information is displayed in the following format Real time sampling analysis XXXsxXxXXms Trace data analysis XXXsXXXmsXXXusXXXns R20UT346
240. utput Description of each area 1 Message area This area displays only operation logs for the analysis tool out of those for various components analysis tool design tool build tool debug tool etc provided by CS The colors of message display differ with the type of message as shown below character colors and background colors depend on the configuration in the General Font and Color category of the Option dialog box Message Type Display Example Default Description Normal message AaBbCe Character color Black Displayed with information notices Background color White Warning message Character color Blue Displayed with warnings about operations Background color Standard color Error message Character color Red Displayed when there is a critical error or when execution is not possible due to a Background color Light gray operational mistake Remarks 1 When the output message is double clicked or the Enter key is pressed with the caret over the message the Editor panel appears and the destination line number of the file is displayed Remarks 2 Help with regard to the message in the line is shown by selecting Help for Message in the context menu or pressing the F1 key while the caret is in the line where the warning message or the error message is displayed Remarks 3 You can save the contents displayed on this tab to a text file txt by selecting Save Output Pr
241. v 1 00 Aug 01 2015 Static analysis Displays the access specifier being declared to the member variable Note however that this will display if analysis is not complete The following access specifiers can be displayed public private protected ztENESAS Page 99 of 163 CS V3 02 00 Item Type A WINDOW REFERENCE Contents Attribute Static analysis Displays the variable s symbol attributes symbol modifier attributes If there are multiple attributes then they are displayed separated by com mas Note however that this will display if analysis is not complete The following attributes can be displayed CC RH static ior const volatile CC RX static const volatile restrict CC RL static const volatile near far saddr Static analysis Note 2 Displays the type of the variable If including an alternative name by using define statement or typedef statement then not the alternative name but the type is displayed Note however that this will display if analysis is not complete There is no limit to display the number of pointers up to 4 dimensions for an array can be displayed Members Static analysis Displays the members of the structure union If there are multiple members then they are displayed separated by com mas Note however that this will display if other than structures unions or analysis is not comp
242. variable boxes when the multiple variables exist they will be arranged from top to bottom with the variables to appear first shown topmost Remark Any one of the following events will cause that the call graph is switched to whole view mode The value of the Parent Function Name combo box has been changed including the result of a build rebuild in the build tool Aclean has been executed in the build tool Figure A 19 Call Graph Panel Details View w 5 o aae Amn subi _ subile 3 Target function subti Cikan abie 14 th gbala manh 3 Parent functions N a Child functions Variable box The composition of the call graph is as follows Figure A 20 Composition of Call Graph Whole view Details view mar 1 naine F u aui aii abi c 14 abii 3 a Function box L1 c Connection line A ib c Connection line b Variable box Jaa a Function box manh H a Function box The function is displayed in a box format The following information is displayed in a function box R20UT3461EJ0100 Rev 1 00 Aug 01 2015 ztENESAS Page 119 of 163 CS V3 02 00 A WINDOW REFERENCE Figure A 21 Information of Function Box Function name Definition Condition PM information RH850 man subi marc TES static Attribute Funct
243. variable information of the last file to be imported is loaded If a value does not exist in either the active project or import file then it is left blank This item appears only when the selected microcontroller version supports multi core Page 42 of 163 CS V3 02 00 2 FUNCTIONS 2 13 Display Analysis Information in Chart You can display the acquired function information and variable information including the data information for Smart Analog in a chart To display a chart click the button on the Main window s toolbar to open the Analysis Chart panel The following content is graphed in the Analysis Chart panel Graph transitions in values Chart the function execution time ratios Note E1 E20 RL78 This feature is supported only when the selected microcontroller incorporates a Smart Analog IC Figure 2 25 Example of Graphs for Analysis Information Analysis Chart Panel Lien Aewiepe mation jp Farepdng Zemie ai a aa Sr i Ta ui ahei TE Farag Paie HAN Cir Demir E bar e a Cer A Fag Ge Sang B ieii Y Eik al Torg D Orel Umre 4 AB a Tatra IH TaT Bat Tet H E E ica brs PH 100 FS Py TEE Tra PEA Thr ri Part Li Varable Vater Changping Chari l ERAEN iei ee p cri 2 13 1 Graph transitions in values Display the relationship between registered variable register address other values and time by a graph line chart Furth
244. ver that this will display if analysis is not complete The following attributes can be displayed CC RH static interrupt inline CC RX static interrupt inline template virtual abstract CC RL static interrupt inline near far callt rtos task Return Type Static Displays the return type of the function 2 analysis Note however that this will display if analysis is not complete There is no limit to display the number of pointers Arguments CountNotet Static Displays the number of arguments of the function in decimal number analysis notation If the function has a variable argument parameter then the number of arguments defined at the location where the function is defined is dis played Note however that this will display if analysis is not complete Note Arguments Static Displays the argument type and formal argument name of the function analysis If there are multiple arguments then they are displayed separated by commas If the function has a variable argument parameter then the argument type and argument name defined at the location where the function is defined are displayed If there are no arguments then void is displayed Note however that this will display if analysis is not complete There is no limit to display the number of pointers the first dimension of an array is handled as a pointer Code Size Bytes Static Displays the functio
245. with the Debug Manager panel RH850 Caution If 1 Filtering via custom settings for each column is configured while the information is being fil tered via the method described below linking displays that have been taking place will be reset Remark The three filtering functions described below can be used simultaneously Linking with the Project Tree panel Only display values for functions variables in a file category selected in the Project Tree panel To do this click the S button on the Function List panel Variable List panel toolbar to enable this filtering func tion then from the Project Tree panel select the desired file s category s Click this button again to disable this function The relationship between the selections in the Project Tree panel and the filtered functions variables is as follows Table 2 8 Filtering Linked to Project Tree Panel Selection Display Single file in active project Functions variables defined in single file Multiple files in active project Functions variables defined in multiple files Single category in active project Functions variables defined in single category Multiple categories in active project Functions variables defined in multiple categories Combination of files and categories in Functions variables defined in the selected files and categories active project Other than the above All functions variables defined in files included in the active project
246. xt menu R20UT3461EJ0100 Rev 1 00 ztENESAS Page 97 of 163 Aug 01 2015 CS V3 02 00 A WINDOW REFERENCE How to open On the toolbar in the Main window click the button From the View menu select Program Analyzer gt gt Variable List Description of each area 1 Header area a Column name The name of the item of the acquired variable information is displayed Marks icons that are displayed at the name of the item indicate as follows Mark Icon Meaning Indicates whether there is a sort order setting see 2 6 4 Sort the analysis information Indicates whether there is a filter display setting see 2 6 5 Filter the analysis informa tion Indicates whether display is locked see 2 6 3 Lock the specific column to display Indicates that a message relating to information about this item has been output to the Output panel Hover the mouse over it to display a pop up with the last message to be output Remark Columns to display can be customized via mouse operations in this area Set the columns to display Change the order of the columns to display Lock the specific column to display b Button Opens the Column Chooser dialog box in order to sort and show hide the items col umns displayed in the panel and return customized settings to the defaults see 2 6 Customize Display Method 2 Information area This area displays the acquired variable informati
247. y 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 the CS integrate
248. y the argument types of the function in parentheses When the target function is a member function If the target function belongs to a namespace except for a global namespace anonymous namespace then this will be displayed in the format of Namespace name Class name Function name Otherwise this will be displayed in the format of Class name Func tion name Moreover if the target function is a overloaded function or a template function then Function name will be followed by the argument types of the function in parentheses R20UT3461EJ0100 Rev 1 00 ztENESAS Page 123 of 163 Aug 01 2015 CS V3 02 00 A WINDOW REFERENCE If the target function is a const member function or volatile member function then const or volatile is displayed immediately after the function name Remark The cumulative value for each program execution is displayed as the execution count when the Accumulate result of analysis property in the General category on the Settings tab of the Property panel is set to Yes Variable box IFLA globala mainh 3 l gt Vanable name global_s Locations main h 3 D CA Tesise Variable name Variable name Location File name Line number Variable name absolute path of the file Indicates the name of the target variableN If the target variable is a static variable inside a function then this will be displayed in the format of Function name Variable name Loc
249. yed This is mutually exclusive to the OR button Only information meeting either condition 1 or condition 2 is displayed This is mutually exclusive to the AND button Function buttons Button Function Displays the analysis information in the Function List panel Variable List panel under the specified filtering conditions If the Filtering results linked to panel was performed then all display filters linked to the panel conducted prior to this are deleted Cancel Ignores the setting and closes this dialog box Help Displays the help of this dialog box R20UT3461EJ0100 Rev 1 00 ztENESAS Page 159 of 163 Aug 01 2015 Revision Record Description Summary Aug 01 2015 First Edition issued CS V3 02 00 User s Manual Analysis Tool Publication Date Rev 1 00 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 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
250. ynamic analysis information property in the General category on the Settings tab of the Property panel to Yes in order to acquire the dynamic information necessary for the analysis tool without depending on the configuration of the debug tool being used see 2 Dynamic analysis information Remark For details on how to execute download see CS Integrated Development Environment User s Manual Debug Tool of the microcontroller used 5 Execute programs Execute the program on the debug tool Remark For details on how to execute programs see CS Integrated Development Environment User s Manual Debug Tool of the microcontroller used 6 Specify the files to be analyzed If necessary specify the files to be analyzed by the analysis tool see 1 1 1 What is analyzed R20UT3461EJ0100 Rev 1 00 ztENESAS Page 15 of 163 Aug 01 2015 CS V3 02 00 2 FUNCTIONS 7 Display Function Information Display the Function List panel in order to validate the acquired function information The Function List panel can be operated as follows in accordance with the purpose Note that if the program is modified during debugging the operation is repeated via 3 above a Customize Display Method Change the display method e g set which columns to display and the sorting order on the panels b Jump to Defined Location Jump to the location where the function on the panel has been defined c Seta breakpoint to a function Set

Download Pdf Manuals

Related Search

Related Contents

  Result  GE JKP16 User's Manual  Brochure SET Wärmepumpen FR/IT  GOS6413 Manual  Sony VGN-AR250G Safety Information  小型卓上遠心機 取扱説明書  The Trumpet 3 User Manual  Sony STR-DH520 A/V Receiver  SCU Stock Market Simulation Model  

Copyright © All rights reserved. Failed to retrieve file