Home

High-performance Embedded Workshop V.4.06 User`s Manual

1. C Functions C Classes G0 To Definition OF main al Navigation J resetprg c 3 Iftwo or more navigation items are found the Select Navigation Item dialog box appears File names and line numbers are listed in the dialog box Double click an item or select an item and press the OK button REJ10J2000 0100 Rev 1 00 Jun 16 2009 185 RENESAS High performance Embedded Workshop 12 Navigation Facilities Select Navigation Item Ei ES Select the location af sort Filename c workspace denosh4demosh4 demoask c c morkspace denosh4demosh4 demoask c Cancel 12 4 Drag and drop navigation items It is possible drag and drop navigation items of defines C functions or C classes shown in the Navigation tab of the workspace window The Category C Defines C Functions and C Classes Globals Folder and File items will not be draggable Drag and drop of navigation items into a file that s currently open in the editor This makes it easier for you to write code as you will be able to drag the relevant items into the file instead of having to type them Z zl INT OFFSET TOS TRE AM qa Documenti e Multiple items can be dragged at the same time these will appear on separate lines e The navigation item names will be inserted in alphabetical order e Note that if you drag a function only the function s name will be dragged REJ10J2000 0100 Rev 1 00 Jun 1
2. HEWDIR hmake exe gt Browse M Use makefile build system for this workspacel RAD EIRICIOS COO COON HSNO OR ED oO OC CoCo So A SOON oOUSoOCcCacoDoooT OoBo a a a E a a Generate makefile before build commences Makefile filename EW ORKSPDIR makesg PROJECTNAME L ICC Browse Initial directory 0 ORKSPDIR make gt Browse Makefile options gt Syster Clean options gt REJ10J2000 0100 Rev 1 00 Jun 16 2009 81 RENESAS High performance Embedded Workshop 3 Advanced Build Features 10 11 12 Enter the make tool name to execute the makefile in the Command excluding parameters edit box The default is hmake HEWDIR hmake exe Select the Use makefile build system for this workspace checkbox This means that the makefile should be executed rather than the internal build While the Generate makefile before build commences checkbox is selected the High performance Embedded Workshop will generate a makefile before executing the build This means the makefile will always be up to date with the High performance Embedded Workshop project system Enter the file name in the Makefile filename edit box The default file name is WORKSPDIR make PROJECTNAME _ CONFIGNAME mak Note This entry can be left empty if no makefile needs to be specified on the command line In the Initial directory edit box enter the current directory where the makefile is to be executed When this e
3. a Cancel A REJ10J2000 0100 Rev 1 00 Jun 16 2009 288 RENESAS High performance Embedded Workshop 17 Debugging Facility 3 Select a directory and then click the Open button Any files that could not be found in this directory will invoke the Locate Files dialog box allowing you to search for the unlocated files You can also relocate files via the pop up menu option shown for files To relocate a file to a different directory 1 Right click on a file in the Projects tab of the workspace window 2 Select the Relocate file s menu option Selecting this will bring up a standard Windows file open dialog box Please select new location of file EES Look ir E Debug_Emulator de jt re EE File name Files of type stdlib hy Cancel we 3 This dialog will only allow you to select a file of the same name 4 Select a file and then click the Open button You can select multiple files to be relocated this will bring up the Locate Files dialog box with the files to be relocated in the files to find section 17 1 5 5 Displaying main functions on download The High performance Embedded Workshop automatically displays the source file including main functions in source mode within the High performance Embedded Workshop editor after downloading modules To display main functions on download 1 Select Setup gt Options to open the Options dialog box 2 Select Debug tab 3
4. Example Exported linkage order for project Project_name configuration Debug c workspace workspace_name project_name debug main obj c workspace workspace_name project_name debug resetprg ob c workspace workspace_name project_name debug intprg ob c workspace workspace_name project_name debug runtime_library lib c workspace workspace_name project_name debug projectname lib c workspace workspace_name project_name debug user_edit_options lib Open the file e g in the Editor modify the linkage order and then save it in the text format Follow the procedures of To import the linkage order from the text file to load the new linkage order When you are using multiple configurations it is likely that the linkage order will be very similar To do this effectively you can copy the current settings in the dialog to other configurations This is described below To copy the linkage order from one configuration to another 2 gt Click Build gt Linkage Order The Linkage Order dialog box opens Select the Use custom linkage order check box Select the configuration you wish to copy in the Current configuration drop down list This defaults to the currently loaded configuration Click the Copy to button this displays the Select Configuration To Copy To dialog box and asks you which of the configurations in the current project you wish to copy the current linkage order to Select a configuration and click OK
5. Options Output Files Dependent Files Command CAT cole MyT ool exe Options bFULLFILE Placeholder File path name Inzert button for placeholder Insert REJ10J2000 0100 Rev 1 00 Jun 16 2009 79 RENESAS High performance Embedded Workshop 3 Advanced Build Features Note An error will be returned when the total number of characters of the command line options exceeds 256 3 4 2 Output Files tab This tab is where you can specify the output files that will be produced by the phase Before each file is passed into this phase the High performance Embedded Workshop checks that the output files are of a less recent date than the input file If so the phase will be executed for that file i e input files have been modified since the output file or files were last produced If the files are up to date then the phase will not be executed Note If no output files are specified the phase will execute regardless Options Gutput Files Dependent Files Output files Madis Remove To add an output file 1 Click the Add button The Add Output File dialog box will be invoked 2 Enter the file path or browse to it using the Browse button 3 Click the OK button to add this output file to the list To modify an output file 1 Select the output file that you would like to modify 2 Click the Modify button The Modify Output File dialog box opens 3 Modify the fields
6. REJ10J2000 0100 Rev 1 00 Jun 16 2009 387 RENESAS High performance Embedded Workshop 18 Synchronized Debugging While synchronized debugging the functionality of the Debug Settings dialog is different Instead of being able to set all the normally available options it is only possible to change the Download modules which are set in each Debugger s session It is possible to use multi select on the left side of the dialog to change the setup of multiple sessions at the same time This allows the same module to be added easily to several sessions ready for a synchronized download For each module in each session you can use the Modify button to specify that debug information only should be downloaded If a multi core target is being used with all cores sharing the same memory it is recommended that the full memory image is downloaded in one session and debug information only is downloaded in the others The functionality of the buttons on the dialog are the same as when debugging normally See section 17 1 4 3 Editing debug settings for details 18 2 2 Parallel mode functionality r L ilipi 1 5 u faci ole ale clos beet azi E ub Senn Fe Fa J FF W clin ole alg le General operation When running in parallel mode each Debugger is a separate High performance Embedded Workshop application These can be used independently exactly like when debugging normally just with the debugger operations synchronized High
7. The results of the search are shown in the Located Components list Select a component and click the Register button to register an individual component or click the Register All button to register all located components Click the Close button to exit the dialog box Search Disk for Components Select the directory in which to begin the search G tart C Program Files Renesas Hew Browse M Include subfolders Close Located components Version HAF Location a Register di Hewlangettever 1 07 00 C Program Files HenesassHew Syst FdT argetServer 1 00 00 C Program Files RenesassHewSust Register All Genene TCL Too 1 03 03 C Program Files Renesas HewsSyet Call Walker 1 07 00 C Program Files Henesas Hew T ool HeS He S00 Sta 6 2 1 0 C AProgram Files Renesas Hew T ool H Seres Libraria 7 03 00 C Program Files HenesassHew Tool Map viens 1 07 00 C Program Files RenesassHewsT ool Renesas M320 5 41 01 C Program Files Renesas Hew T ool Renesas MTIBC 5 44 00 C Program Files Renesas Hew Tool Super RISC en 9 1 1 0 CNProgram Files Renesas HewsT ool 4 Search status 99 files found REJ10J2000 0100 Rev 1 00 Jun 16 2009 111 RENESAS High performance Embedded Workshop 5 Tools Administration To register a single component 1 Click the Register button on the Tools Administration dialog box 2 Browse to the component s HRF file and click the OK button to register that com
8. W Search Equal Data Search Backward Cancel Enter a value you want to find in Data and select the data format in Search Data As If pattern is selected as the Search Data As a byte string of up to 256 bytes or less 512 characters or less can be searched for Specify the data for each byte with two characters Search conditions other than pattern search are data match mismatch and search direction Note that only data match and forward direction can be selected with pattern search If you did not drag the address range to be found you must enter the start end address The end address can also be prefixed by a plus sign which will use the entered value as a range If the data is found the data which has been found is highlighted in the Memory window If Search Next is selected from the pop up menu in the state where data has been found the search will continue from the next address Support for this function depends on the debugger 17 3 10 Changing the display address Use the scroll bar Page Up Page Down key and Up Down key to change the display position To change the display address directly follow the procedure below 1 In place edit in the Address column Ge ALm ILE ELT E Ne ogzi ogoi 2 To change the display address open the Display Address dialog box by selecting one of the following operations e Double click the Address column you want to change OR e Choose Address from the pop up
9. 15 5 2 27 Device Setting dialog box While a macro is being recorded the following operation will be recorded into a macro file Target Operation Function OK button Click on the button Selects a device and operation mode REJ10J2000 0100 Rev 1 00 Jun 16 2009 228 RENESAS High performance Embedded Workshop 15 Macro Recording Support Facility 15 5 2 28 Start Stop Function Setting dialog box While a macro is being recorded the following operation will be recorded into a macro file Target Operation Function OK button Click on the button Specifies the address of a work area and an executing routine 15 6 Playing a macro There are a number of ways to play a macro file in the High performance Embedded Workshop these options are discussed below To play a macro from the toolbar or menu 1 Click the Play Macro button or menu option on the Macros toolbar or the Tools menu 2 If there is only one macro defined it is automatically played If multiple macro functions exist in the current default macro file a dialog is displayed that asks you to choose which macro you wish to execute When b D playing the mouse cursor is modified to include the play icon 3 Click OK and the macro is executed When the macro is being executed the pause lM and stop O buttons D and menus are enabled When pausing the mouse cursor is modified to include the pause icon DD It is also easy to run a macro from the macro toolbar men
10. 2 Click the Remove button A dependent file s path can include placeholders 3 5 Controlling the build By default the High performance Embedded Workshop will execute all of the phases in a build and only stop if a fatal error is encountered You can change this behavior by setting the controls on the Build tab of the Options dialog box Select Setup gt Options to display the Options dialog box and then select the Build tab If you want to stop the build when a certain number of errors are exceeded then set the Stop build if the number of errors exceeds checkbox and specify the error count limit in the field to the right If you want to stop the build when a certain number of warnings are exceeded then set the Stop build if the number of warnings exceeds checkbox and specify the warning count limit in the field to the right Errors and warnings Stop build if the number of errors exceeds 0 0 W Stop build if the number of warnings exceeds In addition to specifying error and warning count limits the Build tab also allows you to request that the Command line Environment and Initial directory of each execution should be displayed Check the appropriate check boxes as necessary REJ10J2000 0100 Rev 1 00 Jun 16 2009 77 RENESAS High performance Embedded Workshop 3 Advanced Build Features Notes e Irrespective of what these controls are set to the build will always halt if a fatal error is encountered
11. Associate a project in a High performance Embedded Workshop workspace with a project inside a Microsoft Visual SourceSafe database e Select Microsoft Visual SourceSafe as the version control system to be connected with the High performance Embedded Workshop e Login Microsoft Visual SourceSafe e Specify the name and location of the project to be created in Microsoft Visual SourceSafe 2 Adding files Select the files in a High performance Embedded Workshop workspace that you would like to add to Microsoft Visual SourceSafe 3 Checking out a file Select the files that you would like to modify in the High performance Embedded Workshop workspace and check them out 4 Checking in a file Select the files modified in the High performance Embedded Workshop workspace and check them in 9 1 Attaching Visual SourceSafe to a workspace The following sections describe how you can associate Microsoft Visual SourceSafe with your current workspace First you need to select Microsoft Visual SourceSafe as the version control system to be connected with the High performance Embedded Workshop To attach Microsoft Visual SourceSafe to a workspace 1 Select Tools gt Version Control gt Select The Select Version Control System dialog box opens 2 Select the Microsoft Visual SourceSafe entry from the Microsoft Version control systems list Select Yersion Control System EAE Version control system Micro
12. Do NOT assume that any output from the tool you terminated is valid It is recommended that you delete any output files produced and ensure that the phase is executed again 2 8 5 Deleting intermediate and output files produced in building You can delete intermediate and output files produced in building included in the current configuration in the project To delete intermediate and output files included in the current configuration in the project Select one of the following operations e Select Build gt Clean Current Project OR e Right click on a project in the Projects tab of the workspace window Select Build gt Clean Current Project from the pop up menu A confirmation dialog opens for you to select whether or not to delete all intermediate and output files produced in building To delete all files select Yes Otherwise select No or Cancel Confirmation Request ki J 4 You are about to delete all intermediate files from project Demos HF Do pou wish to continue Don t ask this question again Ho Cancel If you do not wish to open this confirmation dialog box select the Don t ask this question again checkbox To open the confirmation dialog box again 1 Select Setup gt Options The Options dialog box opens 2 Select the Confirmation tab 3 Select the Clean project checkbox This checkbox is selected by default 4 Click OK To delete intermediate and output files in all projects of the workspa
13. Download Modules lt File name of the download module gt All Download Modules Unload Modules All Downloaded Modules lt File name of the download module gt CTRL F7 F7 F5 SHIFT F5 F11 F10 SHIFT F11 15 Macro Recording Support Facility SimDebug SH 3 x Sims essianSH 3 elt fo fr III o 2 a YY s Very aas Ir 0 f fee Setup Radix Hex Decimal Oct Bin Notes 1 This menu is not displayed while a debug only project Debugger only xxxxxx created by High performance Embedded Workshop V 4 01 or later is in use 2 Only options Offset File format Filename Access size and Perform memory verify during download can be recorded Download debug information only and Download automatically on target connection are not recordable 3 Support for this function depends on the debugger 4 Selections made from the Current configuration drop down list can be recorded 5 Selections made from the Current session drop down list can be recorded REJ10J2000 0100 Rev 1 00 Jun 16 2009 218 2CENESAS High performance Embedded Workshop e Windows 15 Macro Recording Support Facility While a macro is being recorded operations made in the windows listed below will be recorded into a macro file For information on the types of recordable operations see the descriptions of the respective windows Window Name Projects tab of the Workspace window Editor Disassembly
14. Error Message Example Output Syntax Example Description C Workspace SH SH resetprg c FULLFILE Placeholder of the file name with its full path 70 LINE Placeholder of the line number enclosed with parentheses C2225 i Wild card for and error message number E E E indicating an error Undeclared name a Wild card for error message There are some restrictions on these regular expressions For example it is not possible to define two unclear strings next to each other such as FILEDIR or FULLFILE It is also not possible to define and which are commonly used in filenames and directory names to separate placeholders for filenames and directory names from other characters such as FULLFILE LINE or FILENAME e When Error has been selected as the syntax type and the output message matches the definition of the syntax An error icon appears on the left to the message output as the result of building Double clicking on the line displays the corresponding source code in the editor e When Warning has been selected as the syntax type and the output message matches the definition of the syntax A warning icon A appears on the left to the message output as the result of building Double clicking on the line displays the corresponding source code in the editor e When Other has been selected as the syntax type and the output message matches the definition of the
15. High performance Embedded Workshop 14 Command Line If you modify the contents after the batch file has been specified the High performance Embedded Workshop shows a message telling that the batch file will be loaded again If you do not wish to open this confirmation dialog box select the Don t ask this question again checkbox To open the confirmation dialog box again 1 Select Setup gt Options The Options dialog box opens 2 Select the Confirmation tab 3 Select the Auto reload Batch File checkbox This checkbox is selected by default 4 Click OK 14 3 Executing a batch file Click the Play button in the Set Batch File dialog box or choose Play from the pop up menu to execute the batch file The Play menu is displayed in gray while the file is running and can be used when the batch file execution stops and control returns to the user The message box shown below appears when a user attempts to close the Command Line window during execution of a command file ecxcmdline x The batch file will be aborted Cancel To terminate the execution of the batch file and close the Command Line window click OK To continue the execution click Cancel This does not close the Command Line window 14 4 Stopping command execution Choose Stop from the pop up menu to stop command execution The Stop menu becomes valid during command execution 14 5 Specifying a log file Choose Set Log File from the pop up menu to open th
16. High performance Embedded Workshop 17 Debugging Facility 17 Debugging Facility This chapter describes the debugging operations and their related windows and dialog boxes See Chapter 1 Overview for the fundamental concepts of the High performance Embedded Workshop High performance Embedded Workshop For details on the functions available with the debugger in use refer to the user s manual or help of the emulator or simulator 17 1 Preparations for debugging This section describes the preparations for debugging your program You will learn how to select and configure a debugger with which to debug how to load the user program and what the debugger sessions are 17 1 1 Compiling for debug In order to be able to debug your program at C C source level your C C program must be compiled and linked with the Debug option enabled When this option is enabled the compiler puts all the information necessary for debugging your C C code into the absolute file or management information file which are usually called Debug Object Files When you create your project the initial setup will normally be configured for debug Notes e Make sure you have the debug option enabled on your compiler and linker when you generate an object file for debugging e If your debug object file does not contain any debugging information for example the S Record format then you can still load it into the debugger but you will only be able to
17. It is possible to disable scanning for certain navigation categories if you do not require the information To switch off a navigation category 1 If you right click anywhere inside the Navigation tab a pop up menu will be invoked 2 Select Select Categories The Select Categories dialog box is displayed Select Categories Please select the categories to scan for WIC Defines WC Functions C Classes Cancel 3 Un check any categories you are not interested in seeing definitions for 4 Click OK REJ10J2000 0100 Rev 1 00 Jun 16 2009 182 RENESAS High performance Embedded Workshop 12 Navigation Facilities To update the navigation view 1 If you right click anywhere inside the Navigation tab a pop up menu will be invoked 2 Select Refresh Notes e The navigation items are displayed gradually as the files are scanned This means it may take some time if there are many files to fully complete the Navigation view update e Files are re scanned when they are saved This means that navigation information will not be available for new classes and functions until the file or files are saved e Group By File and Group By Access cannot both be on at the same time Switching one on will switch the other one off 12 1 C function and define navigation component These components simply add the function and define definitions to the navigation view C define navigation Workspace Ea z categor
18. To close an individual file Select one of the following operations e Double click the Editor window s system menu located at the top left of each window OR e Click on the Editor window s system menu located at the top left of each window and select the Close menu option OR e Ensure that the window that you want to close is the active window and then press CTRL F4 OR e Ensure that the window that you want to close is the active window and then select File gt Close OR e Click on the Close button located at the top right of each window To close all files Select Window gt Close All If you attempt to close an edited file that is not saved a confirmation dialog box appears asking if you wish to save the file High performance Embedded Workshop AN Save changes to C Morkspace DemoSH4 DemoSH4 sbrk c e Clicking No closes the file without saving e Clicking Cancel returns to the editor window e Clicking Yes closes the file by overwriting the contents If the file has the read only attribute a confirmation dialog box appears asking if you wish to save the file as another name High performance Embedded Workshop CAWorkepace DemoSH4 DemoSH4 ebrk c This file ts read only Do you want to save it as another filename Ho Overvarnite Cancel e Clicking Yes opens the Save file dialog box Change the file name before saving e Clicking No closes the file without saving e Clicking Overwri
19. You may specify a comment for each file or if you would like to specify the same comment for all files check the Apply comment to all files checkbox before clicking the OK button 8 5 Executable return code While each version control command executes its output is redirected to the Version Control tab of the output window When the command s execution is complete its return code is obtained When defining a command you can determine whether this return code can be used to indicate that the command failed and that the remaining commands should not be executed i e abort The controls contained in the Executable return code group allow you to specify this behavior If the return code of the commands can be used to indicate a failure then you should select the Command has failed if the return code is option and set the drop down list and edit box as required If the Command has failed if the return code is option is selected then the High performance Embedded Workshop will check the return code of each command to determine whether a failure occurred If this is the case no further commands will be executed and any other processes which would follow the commands e g build will not be executed If the Return code of tool is not meaningful option is selected then the High performance Embedded Workshop will not check the return code of each command Consequently all commands will execute regardless REJ10J2000 0100 Rev 1 00 Jun 16 2009 1
20. Customizes toolbar buttons Note 1 Support for this function depends on the debugger 2 Available only when the debugger supports this function REJ10J2000 0100 Rev 1 00 Jun 16 2009 311 RENESAS High performance Embedded Workshop 17 Debugging Facility 17 3 2 Setting data at a desired address in the Memory window To set data at a desired address in the Memory window follow the procedure below e In place edit in the Data column e In place edit in the Code column e To change the contents of memory open the Set dialog box by selecting one of the following operations o Double click the Data column you want to change OR o Double click the Code column you want to change OR o Select the data you want to change and choose Set from the pop up menu Address fOn000000 Data m Data Type ie Value C String Length li byte ode ASCI x Werity Cancel Enter the value value or character to be set in the Data field Select the Verify check box Support for verify function depends on the debugger When setting the value Click the Value button in the Data Type group Specify the data length in the Length field When setting the character Click the String button in the Data Type group REJ10J2000 0100 Rev 1 00 Jun 16 2009 312 RENESAS High performance Embedded Workshop 17 Debugging Facility 17 3 3 Selecting a memory range If the memory address range is in the Memory view yo
21. Description Displays a list of available Debuggers This command is used to get a list of valid inputs for the previous command The list of Debuggers displayed will be the same as is displayed on the Debuggers Tab REJ10J2000 0100 Rev 1 00 Jun 16 2009 390 RENESAS High performance Embedded Workshop 18 Synchronized Debugging Syntax sac Parameter None Exceptions Type Description Displays a list of available Debuggers Some commands cannot be redirected to a different Debugger and will always be executed in the local Debugger no matter how the SET_CORE command is used The following commands have this limitation ASSEMBLE CLOSE_TEST_SUITE COMPARE_TEST_DATA MEMORY_EDIT OPEN_TEST_SUITE REFRESH_SESSION RUN_TEST SET_CORE SHOW_ALL_CORE SUBMIT Note If the parameter of a command to be executed on a Debugger specified with the SET_CORE command includes a filename this filename must be enclosed e g by as shown below file_load Elf Dwarf2 CONFIGDIR PROJECTNAME abs 0x0 p byte 18 4 Glossary of terms Term Core Debugger Debugger ID Internal Debugger ID Internal mode Local Debugger Multi core platform Parallel mode Platform SDO file Definition An individual CPU core on a multi core platform A combination of Workspace file project name and session name that can be opened in a High performance Embedded Workshop app
22. FULLFILE resetprg c E sbrk c B SH4demo c bese Default Options ome Fie path name Insert N If the phase selected was multiple then a list of project files is displayed on the left hand side of the dialog to enable you to specify the build options on a file by file basis If the phase selected was single then there is no project file list displayed In either case the three tabs below are available This is where you can set the options that you want to apply to the selected file s You can also choose which configurations are being viewed In the configuration list each configuration is listed along with a special entry named Multiple configurations If you select Multiple configurations then the Select project configurations to modify dialog box is displayed which allows you to select more than one configuration This method is used throughout High performance Embedded Workshop for modifying multiple configurations at once 3 4 1 Options tab This tab allows you to define the command line options that will be passed to the phase The Command field displays the command that was entered when you defined the phase Enter into the Options field the command line arguments that you would like to pass to the command If you want to insert a placeholder select the relevant placeholder from the Placeholder drop down list and then click the Insert button See Reference 5 Placeholders for more information on placeholders
23. Save As mj Saves the currently displayed contents Go To Memory ea Opens a Memory window for the address Toolbar display 5 Shows or hides the toolbar Customize toolbar Customizes toolbar buttons Notes 1 Available only when the debugger supports this function 2 Support for scope setting depends on the debugger in use and the debug format selected in the Debug Settings dialog box 2 Adding a watch item You can add watch items to the Watch window To add a watch item to a Watch window Select either of the following ways e Drag a watch item from the Editor or Disassembly window and drop it into the Watch window e Use Instant Watch in the Editor or Disassembly in source mode window REJ10J2000 0100 Rev 1 00 Jun 16 2009 367 RENESAS High performance Embedded Workshop 17 Debugging Facility e Open the Add Watch dialog box in either of the following ways o Select the Watch window and press the Insert key o Right click within the Watch window and select Add Watch from the pop up menu Add Watch ki ES Varable or expression Cancel i Enter the name of the variable that you wish to watch in the Variable or expression field and click OK The watch item is added to the Watch window The scope of the added watch item is Auto by default Watch items that you have set in the Watch window are saved in the session file Note If the variable that you have added is a local variable that is not c
24. Support for this function depends on the debugger 17 3 25 Saving an area of memory You can save an area of memory in the address space to a disk file using the Save Memory feature Select an address range to save in the Memory window by dragging the mouse Choose Save from the pop up menu of the memory window The Save Memory As dialog box opens This operation can also be achieved by selecting Debug gt Save Memory Save Memory As Ei File format Cancel Filename Start address ooo OOD a End address oom UFF El ACCESS S126 r If you did not drag the address range to be saved you must enter the start end address The end address can also be prefixed by a plus sign which will use the entered value as a range Enter the file format in File format file name in Filename and access size in Access size The File name drop down list contains the last four filenames used for saving memory Alternatively click the button to launch a standard Save As dialog box The access size for saving data can be selected from the Access size drop down list When the data is saved in memory with little endian the order of data depends on the access size When the file save is complete a confirmation message box will be displayed REJ10J2000 0100 Rev 1 00 Jun 16 2009 321 RENESAS High performance Embedded Workshop 17 Debugging Facility 17 3 26 Loading a memory area from a file A file can be loaded to t
25. Title bar ga Tutorial High performance Embedded Workshop resetprg c Menu bart e File Edit View Project Build Debug Setup Tools Test Window Help Tobas e D S i g S i s oh I HR D A HE El eG Tutorial Tutorial Et ra a ami source file typedefine h Workspace s o Intprg src stacksct h window ogo ee 5 vecttbl src i i ER E handler sre define SR_Init 0x000000FO Editor Ei E source file gdefine INT OFFSET ox1OOUL window 3 dbsct c Tez ol pesetpng c rae Output window Other component window e g os I amanen ai Status bare Ready pen Default desktop Read write F 1 2 1 Title bar The title bar displays the name of current activate project and file It also contains the standard Minimize Maximize and Close buttons Click the Minimize button to minimize the High performance Embedded Workshop on the Windows task bar Click the Maximize button to force High performance Embedded Workshop to fill the screen Click the Close button to close the High performance Embedded Workshop this has the same effect as selecting File gt Exit or pressing ALT F4 1 2 2 Menu bar The menu bar initially contains eleven menus File Edit View Project Build Debug Setup Tools Test Window and Help All of the menu options are grouped logically under these headings For instance if you want to open a file then the File menu is where you will
26. Trace data is not matching PTR 3 to PTR 1 Trace data at the beginning of difference PTR 3 Src 0000001879 0000107C F gt DEMMW MOV L R15 R1 R1 lt 00000010 Dest 0000001887 00000818 FD lt E JSR R5 PC lt 00001000 To make detailed setting with one trace type If you double click on a test item in the Create New Test Image dialog box a further dialog box for detailed setting opens k Edit Test Trace Ranges ki EJ Trace ranges start PTA End PTR OK Cancel i Add Modit Hemose iE e To add a trace range 1 Click on the Add button on the Edit Test Trace Ranges dialog box to open the Add Trace Range dialog box Add Trace Range Ei ES Start PTR PS End PTR Cancel 2 Specify Start PTR and End PTR to set a trace range to be saved into a test image file REJ10J2000 0100 Rev 1 00 Jun 16 2009 253 RENESAS High performance Embedded Workshop 16 Test Support Facility 3 Click OK e To modify a trace range 1 Click on the Modify button on the Edit Test Trace Ranges dialog box The trace range selected in the Trace ranges list will be modified Only one trace range is selectable in the list 2 The Modify Trace Range dialog box opens Modify Trace Range Ei Ed Start PTR End PTR 2 Cancel 2 Specify Start PTR and End PTR to set a trace range to be saved into a test image file 3 Click OK e To remove a trace range 1 Click on the Remove
27. Type your country or region in the Country Region edit box This item must be completed Once you are happy with your report choose the method of sending the report in the How would you like to submit the report drop down list box You can print it e mail it or save it to a disk This selection is required Then click Submit This will send the report When submitting a report via e mail you will see a confirmation message after clicking Submit Please type a description of the problem you wish to report ah be Name Company website your application Sultan County A egion How would you like to submit the report Print Cancel Fields marked with a are required Fields marked with an asterisk are required You can click the Submit button after these fields are completed REJ10J2000 0100 Rev 1 00 Jun 16 2009 393 RENESAS High performance Embedded Workshop Reference Reference REJ10J2000 0100 Rev 1 00 Jun 16 2009 394 RENESAS High performance Embedded Workshop 1 Main Menus 1 1 File Menu Options Menu Menu Option File New Open Close New Workspace Open Workspace Save Workspace Save Workspace As Close Workspace New Session Import Session Save Session Save Session As Refresh Session Download A New Module Save Save As Save All Page Setup Print Recent Files Recent Workspaces Recent Test Suites Recent Downloaded Modules Shortcut Key CTRL N CT
28. gt Get from VCS will have exactly the same effect as clicking the Get from VCS toolbar button As the toolbar buttons themselves are fixed the only operation that you can perform upon them is to define which commands should be executed when they are clicked In order to invoke commands from the toolbar or the system defined options of the Tools gt Version Control sub menu you must first define the associated commands that should be executed when they are activated The names of the options and their intended action are listed Option Description Add to VCS Add selected files to version control system Remove from VCS Remove selected files from version control system Get from VCS Get a read only local copy of the selected files from version control system Check out from VCS Get a writable local copy of the selected files from version control system Check in to VCS Put back i e update the selected files in version control system with the local copy Get VCS status View the status of the selected files REJ10J2000 0100 Rev 1 00 Jun 16 2009 138 RENESAS High performance Embedded Workshop 8 Custom Version Control System To define a command to be executed via the system menu or toolbar button l nA 8 1 2 Select Tools gt Version Control gt Configure The Version Control Setup dialog box opens Select a menu option in which you wish to define a command from System menu options and toolbar buttons list and click
29. gt Page Setup The Page Setup dialog box opens 2 Enter into the Header and Footer edit fields the text required to be displayed All normal placeholders are available along with page numbering text justification and date fields These are all expanded before the page is to be printed 3 Click the OK button for the new settings to take effect To set up print wrapping 1 Select File gt Page Setup The Page Setup dialog box opens 2 Click the Wrap Text check box This switches on the wrap text facility when printing so no text is truncated and everything is visible 3 Click OK for the new settings to take effect 4 7 2 Changing tabs W Use spaces as tabs Tab size 4 To change tab size 1 Select Setup gt Options The Options dialog box opens 2 Select the Editor tab 3 Enter into Tab Size the number of desired tabs 4 Click the OK button for the new tab settings to take effect When the TAB key is pressed in the editor a tab character is usually stored in the file However sometimes it is preferable to store spaces instead The representation of tab characters can be controlled via the Options dialog box REJ10J2000 0100 Rev 1 00 Jun 16 2009 97 RENESAS High performance Embedded Workshop 4 Editor To use spaces as tabs l 2 3 4 4 7 3 Select Setup gt Options The Options dialog box opens Select the Editor tab Set the Use spaces as tabs checkbox as appropriate Click the OK button
30. o aa E R 5 T3FFFBFO 73FFFFEF 00000400 Section 7 J E FSTHandler AUOUDO00 a00000is a0o igs Section Hame Start Address End Address Size Overlay The map information and section settings of the linkage editor The section settings after a build e The left pane shows the map information and section settings of the linkage editor Section settings of the linkage editor are displayed While in the edit mode each of subsection groups overlay groups and sections can be dragged and dropped User Operation Appearance of the Mouse Pointer while an Item is Position of the Dropped Item Dragged hi Copied to the next of the item Select a subsection group or section Kn oo ee dropped a PPE ___ and drag it while holding the Ctrl key __ Normal select pointer showing the item name and a a sign when placed over a destination where the item can Copied to the last of the items Select an overlay group and drag it be copied to while holding the Ctrl key Added before the item where Select a subsection group or section ITEM dropped E er l l and drag it while holding the Shift key Normal select pointer showing the item name and an upward pointing arrow when placed over a destination where the item can be moved to i Added to the next of the item Select a subsection group a or section ITEM where dropped r and drag it Normal select pointer showing the item name when Ha pla
31. s manual and help information just include descriptions of these debugging functions as the previous version did This section covers only some of the functions available with SuperH or H8SX H8S and H8 family debugger For other functions dependent on the debugger see the user s manual or help information packaged with the emulator or simulator 17 18 1 Looking at labels When the user program that includes the debugging information is loaded the labels are registered at that time The Disassembly window shows the first eight characters of each label instead of the corresponding address or as a part of an instruction operand Note When a label value matches an operand the corresponding instruction operand is replaced by the label If two or more labels have the same value the one that comes first in alphabetical order is displayed When an address or a value can be entered in the dialog box the labels can also be used 17 18 1 1 Listing labels To see a list of all the labels defined in the current debugger session choose View gt Symbol gt Labels or click the View Labels toolbar button g Window configuration Label x Toob Oty X Ms HMMs EIS Colunn_ Be tddress Name header ee e You can view symbols sorted either alphabetically by ASCII code or by address value by clicking on the respective column heading e You can quickly toggle a software break at the entry point of a
32. void main void char c short s tempfunc c tempfunc s When you set a breakpoint a dialog box appears to ask if you wish to apply this breakpoint to all addresses To apply the breakpoint to all addresses select Yes Otherwise select No If you do not wish to open this confirmation dialog box select the Don t ask this question again checkbox To open the confirmation dialog box again 1 Select Setup gt Options The Options dialog box will be displayed 2 Select the Confirmation tab 3 Select the Set multiple breakpoints checkbox This checkbox is selected by default 4 Click OK REJ10J2000 0100 Rev 1 00 Jun 16 2009 351 RENESAS High performance Embedded Workshop 17 Debugging Facility Note The line or instruction at which you set a PC breakpoint is not actually executed the program stops just before it is about to execute it If you choose to Go or Step after stopping at the PC breakpoint then the highlighted line will be the next instruction to be executed To change the PC breakpoint setting by using the Breakpoints dialog box The breakpoint dialog can be displayed by selecting Edit gt Source Breakpoints It allows you to view the current breakpoints set in the workspace and view the code associated with each one From this dialog it is also possible to remove one or all breakpoints To toggle PC breakpoints It is possible to toggle PC Breakpoints either by double clicking in the breakpoint
33. 3 9 2 4 Get fram WGS i Workepace Name hwe CAWork sp Project_Name hwp CWorkep _Vancel Froject_Name c CAWorksp Ii typedetineh CAWorksp i Jdbsctc ll T Pm an The Get from VCS dialog box opens Select the checkbox on the left to the name of the file that you wish to obtain and click the OK button Checking out writable copy of files from Visual SourceSafe Visual SourceSafe protects your source files and ensures that only one user can have a writable copy of a controlled file at any one time The check out operation takes a writable copy of the file from Visual SourceSafe and places it on your local drive This can only be done if another user has not already checked out a blue mark next to file name the files in question To check out writable copy of files from Visual SourceSafe iF Select the files that you would like to check out from Visual SourceSafe in the Projects tab of the workspace window You may also select a file folder project folder workspace folder or combination thereof Select one of the following operations xi Click the Check out from VCS toolbar button OR Select Tools gt Version Control gt Check out from VCS OR Right click to invoke a pop up menu and select Version Control gt Check out from VCS Check out from WGS Files Workspace Namehwe ic wWworksp Project_Name bwup CAWorksp Cancel Project Mame c oworksp I typedefineh o worksp Midb
34. 4 3 4 Opening a file To open a file 1 Select one of the following operations to open a File Open dialog box e Click the File Open toolbar button 4 OR e Press CTRL O OR e Select File gt Open 2 Use the directory browser to navigate to the directory in which the file you want to open is located Use the Files of Type combo box to select the type of file you want to open or set it to All Files to see every file in a directory 3 Once you have located the file select it and click Open To open a file drag the file from the Windows Explorer and drop it into the High performance Embedded Workshop main window To open a source file on the Projects tab of the workspace window select one of the following ways e Double click the file OR e Select the file and click the right hand mouse button Select Open lt file name gt from the pop up menu OR e If the file has already been selected focused press Enter You can also use another editor external editor to open files For details see section 6 9 Using an external editor REJ10J2000 0100 Rev 1 00 Jun 16 2009 89 RENESAS High performance Embedded Workshop 4 Editor The High performance Embedded Workshop keeps track of the last files that you have opened and adds them to the File menu under the Recent Files sub menu To open a recently used file Select File gt Recent Files and from this sub menu select the desired file 4 3 5 Closing files
35. A character signifies a comment When this character appears as the first character on a line the rest of the line up until the next new line character is ignored There follows examples of valid comments My hmake file Variable declaration OUTPUT c dir1 filel obj Descriptor OUTPUT c dirl filel c c dir1 file1 h set VARI valuel gcc c dirl filel c A comment must occupy its own line in the hmake file It is not possible to put comments on the end of other Statements 13 5 Message commands The message command is used to output a line of text to standard out whilst a make file is executing These text lines will be output in the order they appear in the make file in amongst output from any executables being executed as appropriate No buffering of output text will take place A message command has the following syntax IMESSAGE lt text to output gt A new line character is assumed to come after the last character in lt text to output gt Any white space between IMESSAGE and lt text to output gt will be ignored There follows an example of a valid message command IMESSAGE Executing C Compiler REJ10J2000 0100 Rev 1 00 Jun 16 2009 424 RENESAS High performance Embedded Workshop V 4 06 User s Manual Publication Date Jun 16 2009 Rev 1 00 l Sales Strategic Planning Div PUDISTE SY Renesas Technology Corp Edited by Microcomputer Tool Development Department Renesas Solutions Corp 20
36. Build from the pop up menu The Build All option compiles and assembles all source files irrespective of whether they have been modified or not and links all of the new object files produced To perform a build all operation Select one of the following operations e Click the Build All toolbar button OR e Select Build gt Build All OR e Right click on a project in the Projects tab of the Workspace window and select Build gt Build All from the pop up menu All output from a build or build all operation is redirected to the Build tab of the Output window Both the Build and the Build All operations will terminate if any project files produce errors REJ10J2000 0100 Rev 1 00 Jun 16 2009 51 RENESAS High performance Embedded Workshop 2 Build Basics 2 8 3 Building multiple projects The High performance Embedded Workshop allows you to build multiple projects and configurations at once To build multiple projects 1 Select Build gt Build Multiple The Build Multiple dialog box opens 2 The Build Multiple dialog box gives you the choice of which projects and configurations to build Select the check boxes next to the projects and configurations that you want to build For example in figure below if you wanted to build the entire hewtest2 project you would check the hewtest2 Debug and the hewtest2 Release selections and leave all other check boxes unchecked Build Multiple Ei pewtest Debug ll
37. C C floating point constant Specifies a complex or imaginary number Hexadecimal floating point constants are also floating point constant supported as the floating point constants in this expression only when a compiler that supports C99 specifications is in use 17 18 2 3 Supporting duplicate labels In some languages for example in C overloaded functions a label may represent more than one address Just entering the label name is ambiguous so the High performance Embedded Workshop will display the Select Function dialog box to display overloaded functions and member functions Select Function Select Function Mame Set Function Hame Address iSample changeflong 2006 5 ample 5 ample 2000 5 ample sort long t 2068 Counter All Function Select Function Set Function 2 Functions E Functions a Functions REJ10J2000 0100 Rev 1 00 Jun 16 2009 361 RENESAS High performance Embedded Workshop 17 Debugging Facility Select overloaded functions or member functions in the Select Function dialog box Generally only one function can be selected at one time except for setting breakpoints as multiple functions can be selected This dialog box has three areas Select Function Name Displays the same name functions or member functions and their detailed information Name Displays the names of the functions Address Displays the addresses of the functions Set Function Name Displays th
38. COW CW EV OW QU RA RSE REM SE SW TO Description Adds a file to the current project Sets the configuration to the specified configuration name Sets the specified project file as the current project Sets the specified session as the current session Clears the contents of the specified tab in the output window Closes the specified workspace file Evaluates an expression Opens the specified workspace file Exits High performance Embedded Workshop Sets the radix for the value Reloads the session file Removes a file from the current project Saves the current session Saves the current workspace Outputs the tool information Build Commands Available only when there is a toolchain installed Command Name BUILD BUILD ALL BUILD FILE BUILD MULTIPLE CLEAN GENERATE_MAKE_FILE UPDATE _ALL_DEPENDENCIES Abbreviation BU BL BF BM CL GM UD REJ10J2000 0100 Rev 1 00 Jun 16 2009 403 Description Performs a build on the current project Performs a build all on the current project Performs a build on the file Performs a build on the multiple projects and configurations Deletes intermediate and output files produced in building Generates a build makefile for the current workspace Updates the current projects build dependencies RENESAS High performance Embedded Workshop Command Line Operating Commands Command Name Abbreviation ASSERT 5 AUTO_COMPLETE AC ERASE ER HELP
39. Click a file as the start of the range Then keep pressing the SHIFT key and click another file as the end of the selected range 2 Take either of the two ways listed below The red cross will be removed from the file s icon 4 and the file will be included in build e Select Include Build lt file gt where lt file gt is the name of the selected file from the pop up menu opened by clicking the right mouse button lt file gt is not displayed if several files are selected e Select Build gt Include Exclude Build 2 4 User folders in the workspace In the High performance Embedded Workshop it is possible to add folders to the Projects tab of the workspace window This allows you to logically group your files into certain areas within a project The folder can be set to any name and this is entered in a dialog box The operations listed below are not allowed however for folders Download modules and Dependencies that are automatically displayed To add a user folder 1 Select the project on the Projects tab of the Workspace window 2 Right click and select Add Folder 3 Enter the name in Folder of the Add Folder dialog box 4 Click OK 5 You can now drag and drop files into this folder to group them logically To add a sub folder 1 Select the folder on the Projects tab of the Workspace window 2 Right click and select Add Folder 3 Enter the name in Folder of the Add Folder dialog box REJ10J2000 0100 Rev 1 00 J
40. Mame Tutorial cession file path Browse J Open and maintain link to session file W Make session file link read only 17 1 6 4 Removing a session To remove a session 1 Select Debug gt Debug Sessions The Debug Sessions dialog box opens 2 Select the session you would like to remove 3 Click the Remove button 4 Click the OK button to close the Debug Sessions dialog box It is not possible to remove the current session REJ10J2000 0100 Rev 1 00 Jun 16 2009 293 RENESAS High performance Embedded Workshop 17 Debugging Facility 17 1 6 5 Making a session read only To make a session read only oe E Read only Select Debug gt Debug Sessions The Debug Sessions dialog box opens Select the session you would like to view the properties for Click the Properties button The properties dialog is displayed Click the Read only checkbox This makes the link read only This is useful if you are sharing debugger setting files and you do not want data to be modified accidentally Click the OK button to close the Debug Sessions dialog box 17 1 6 6 Saving session information To save a session Select File gt Save Session If you have the Prompt before saving session checkbox checked a dialog box is displayed which asks you whether you wish to save the information Clicking No loses the changes you made in the session This checkbox is located in the Setup gt Options dialog box on the Workspa
41. Oooo so oo oo OO OO Of OO Of OO OO Of DO Of OO OF ltl nooo 40 oo oo Ooo OO Of OO Of OO OO Of DO Of OO OO ltl Oooo So no oo oOo Of OO Of OO Of OO OO Of DOO Of OO OF OO lll Big Address column Register column Data column Code column Label column e The Label and Register columns are hidden by default e The Label column shows the name of the label allocated to the first address of the memory data displayed on this row e The Register column shows the name of the register allocated to the first address of the memory data displayed on this row e n in the column header of the Data column means the offset value from the first address of the row e The column header of the Code column shows the code name e Double clicking the Address or Label column opens a dialog box which allows you to change first address to be displayed e Double clicking on the Data or Code column opens a dialog box which allows you to change the memory data at the selected address Changing of the value can be recorded in a macro Macro Recording e Values in the Address Data and Code columns can be changed by in place editing Macro Recording Options Right clicking displays a pop up menu containing available options A basic operation is allocated to the toolbar The Toolbar display and Customize toolbar options are also included in the pop up menu opened by right clicking on the toolbar Pop up Menu Option To
42. SH CrC Library Generator REJ10J2000 0100 Rev 1 00 Jun 16 2009 117 RENESAS High performance Embedded Workshop 6 Customizing the Environment 6 Customizing the Environment 6 1 Customizing the toolbars The High performance Embedded Workshop provides standard toolbars as detailed in the Toolbars topic In addition to these you may also construct your own toolbars Toolbars Toolbars if Show Tooltips New Reset Reset Positions Iw Version Control Default Window Iw Debug Aun oe Toolbar rane E ditor To create a new toolbar 1 Select Setup gt Customize The Customize dialog box opens 2 Select the Toolbars tab 3 Click the New button The New Toolbar dialog box opens 4 Enter the name of the new toolbar into the Toolbar Name field 5 Click the OK button to create the new toolbar Note When a new toolbar is created it will appear undocked 1 e floating and empty To add buttons to a toolbar 1 Select Setup gt Customize The Customize dialog box opens 2 Select the Commands tab 3 Browse the available buttons by selecting the button categories from the Categories list Select a button from the Buttons area to display information on its operation 4 Click and drag a button from the dialog box onto the toolbar REJ10J2000 0100 Rev 1 00 Jun 16 2009 118 RENESAS High performance Embedded Workshop 6 Customizing the Environment Commands Categories Def
43. Various combinations of buttons can be used here For example CTRL J or CTRL SHIFT 0 etc If the chosen shortcut is already in use it is displayed below the New keyboard shortcut field If you are happy with your selection click the Assign button 5 Changes are not saved until the OK button is clicked on the Customize dialog box To remove a keyboard shortcut 1 Select the main menu category of the command you wish to modify Itis only possible to modify the commands that have a menu Only some cases are special that allow modification these are named global 2 Select the command you wish to modify or add a new keyboard shortcut for in the Commands list The current shortcut is displayed in the Current keyboard shortcut field Click the Remove button 4 Changes are not saved until the OK button is clicked on the Customize dialog box To reset all the keyboard shortcuts 1 Click the Reset button All shortcuts revert to the default settings for the currently selected keyboard layout 2 Changes are not saved until the OK button is clicked on the Customize dialog box The keyboard shortcuts dialog box allows you to import and export keyboard settings to a defined file This allows you to easily transfer settings from one machine to another To import keyboard shortcuts 1 Select the keyboard layout you wish to replace with your imported settings in the Default keyboard layout drop down list 2 Click the Import button A
44. While a macro is being recorded the following operations will be recorded into a macro file Target Operation Function Value In place edit Modifies the I O register contents Make setting in the dialog box opened by double clicking a value 15 5 2 Recordable functions dependent on the debugger Recordable functions dependent on the debugger included in tool packages are listed in the table below e Handling menu options shortcut keys and toolbar buttons While a macro is being recorded if you handle a menu option shortcut key or toolbar button of those listed below these operations will be recorded into a macro file Menu Menu Option Shortcut Key Toolbar Button Supported Debugger Debug RTOS Go To Cursor i f e E100 emulator debugger Debug Step In Alt F11 Mh TE Step Over Alt F10 ry Step Out Shift Alf F11 rI e Windows and dialog boxes While a macro is being recorded operations made in the window or dialog box listed below will be recorded into a macro file For information on the types of recordable operations see the descriptions of the window or dialog box Window Dialog Box Name Opened by Supported Debugger Disassembly ian Se ospa na e Simulator debuggers for H8SX H8S and H8 families gt Label View ss Symbol Label e Emulator debuggers for SuperH family g Watch Wiews Svmbol s Watch View gt Symbol gt Watch e Emulator debuggers for H8SX H8S and H8 families eee l l Excluding the following debugger Loc
45. e WA Line Number column SAW Breakpoints column Source Source Address calum e Clicking another toolbar button switches the display mode To view disassembly codes in mixed mode click the View mixed mode button To view disassembly codes in disassembly mode click the View Disassembly button e The columns listed in the table below are on the left of the Source field Column Name Description Line Displays the line number for the source file Source Address After your program has been downloaded the editor window displays the addresses for the current source file S W Breakpoints Display the PC location breakpoints and bookmark Setting PC breakpoint by double click REJ10J2000 0100 Rev 1 00 Jun 16 2009 297 RENESAS High performance Embedded Workshop 17 Debugging Facility e The Source field includes codes highlighting the syntax Options Right clicking within the Source field opens a pop up menu containing available options Pop up Menu Option Build File lt File Names Open lt File Name gt Cut Copy Paste Add File To Project Go to definition of lt Navigation Item Name gt List Members Find Replace Goto Line Match Braces Bookmarks Toggle Bookmark Next Bookmark Previous Bookmark Clear All Bookmarks Define Templates Insert Template Toggle Breakpoint Enable Disable Breakpoint Define Column Format Columns Column name Turn Header On Off Instant Watch
46. e Select the module which you wish to download from the Debug gt Download Modules submenu OR e Double click the module in the Download modules folder on the Projects tab of the workspace window OR e Right click on the module in the Download modules folder on the Projects tab of the workspace window to display a pop up menu Select Download or Download Debug Data Only The High performance Embedded Workshop shows the most recently downloaded modules on the submenu of File gt Recently Download Modules This is useful when you wish to download a module that you recently used To download all modules Select one of the following operations e Select Debug gt Download Modules gt All Download Modules OR e Right click within the Download folder on the Projects tab of the workspace window to display a pop up menu Select Download all modules Select the Debug gt Debug Settings menu option The Debug Settings dialog box opens The files will be downloaded to the target in order of the Download modules list An existing module which is not yet added to the Download modules list can be automatically downloaded to the target when it is added to the Download modules list REJ10J2000 0100 Rev 1 00 Jun 16 2009 281 RENESAS High performance Embedded Workshop 17 Debugging Facility To automatically download an existing module to the target when adding it to the Download modules list if Select one of the following oper
47. e When projects are dependent on one another building stops if an error occurs in the child project and its parent project will not be built e Note the following descriptions when you check the Stop build if the number of errors exceeds check box and specify a number to the controls i The build will stop immediately once the maximum number of errors or warnings is exceeded It will not continue to the end of the current phase ii When the number of errors in one execution of a tool exceeds the specified number the number of error messages displayed on the Output window is the specified number plus one A message saying that the number of error has exceeded the specified number is NOT displayed on the Output window The same things as Stop build if the number of errors exceeds shown above hold also in Stop build if the number of warnings exceeds There is no correlation between Stop build if the number of errors exceeds and Stop build if the number of warnings exceeds They are independent 3 6 Logging build output The High performance Embedded Workshop allows you to write the results of each build to file To specify a log file 1 Select Setup gt Customize The Customize dialog box opens 2 Select the Log tab 3 Select the Generate build log checkbox 4 Enter the full path of the log file into the Path field or browse to it graphically by clicking the Browse button or click the placeholder button aj and select the pl
48. include lt stdio h gt stdio h will not be listed as a dependent file To view such system include files select the Show standard library includes checkbox as in figure jj below REJ10J2000 0100 Rev 1 00 Jun 16 2009 60 RENESAS High performance Embedded Workshop 2 Build Basics fl Dependencies Dependencies B lowerch Z sbrk h stackecth B vecth E builtin h Z lowerch E machine h sbrk h E smachineh stackecth stddefh stdioh stdlibh strine h E umachineh B vecth Show File Paths By default any files will not be shown with their full path as in figure K below If the Show file paths checkbox is selected all of the files in the Projects tab of the Workspace window are shown with their full path 1 e from a drive letter as in figure Kk below kk See G source file H G source file H E dbsct c en EDC AWorkspace Demo Demodbect c When Sort files in time order option is selected the workspace window is then sorted into file time stamp order The newest files are located at the top of list with the older files towards the bottom If files are updated after selecting this option manually update the order of these files To manually update the file order Select Refresh Order in the pop up menu on the Projects tab of the Workspace window 2 11 Inserting a project into the workspace When a workspace is created it contains only one project but after
49. mS ea ve 4 The Memory content at the address of an array is saved into the test image file Double click Memory xxxxxx under CPU in Available components The Edit Test Memory Ranges dialog box opens Click the Add button to display the Add Memory Range dialog box 6 Enter the start address of an array in Start address and end address in End address and select the size in Access size 7 Click the OK button Add Memory Range Ei Eg Start address ok gt Cancel End address _a 0x27 za ACCESS SIZE eo Click the OK button in the Edit Test Memory Ranges dialog box 9 The content of array element a 6 in the Watch1 sheet is saved into the test image file Double click Watch xxxxxx under Symbol in Available components of the Edit Comparison Settings dialog box The Edit Test Watch dialog box opens 10 Select the checkbox of a 6 in Symbols 11 Click the OK button REJ10J2000 0100 Rev 1 00 Jun 16 2009 31 RENESAS High performance Embedded Workshop 1 Overview Edit Test Watch Watch Sheet watch Symbols Cancel ignore address 12 Click the OK button in the Edit Test Image File dialog box In the state of current High performance Embedded Workshop system the test image specified in test item is acquired and the test image is saved to the test image file created at step 5 1 14 8 Step 7 Modifying the program before the test In this example the tar
50. or HPC The supported prefix depends on the debugger 17 7 13 Changing text colors The text color and font of the register or flag values shown in the Register window can be customized in the Format Views dialog box in the same manner as the color and font in other windows Now it is also possible to customize the color of the changed register or flag values in the Format Views dialog box The default foreground and background colors of the changed values are red and white respectively The color of the background will be the same as in cases where the text category is selected To change the look of the Register window 1 Select Setup gt Format Views The Format Views dialog box opens 2 Select the Register item in the tree and expand it 3 Select the Modified category 4 Modify the Foreground color selection on the Color tabbed page as desired 5 Click OK 17 8 Specifying the radix If no prefix e g Ox has been added to a numerical value entered in a dialog box window or command line specify the radix for the value Notes e If the dialog box or window has a field for selecting the radix e g a button or column the radix selected in this field will be applied e The radix in some dialog boxes windows and commands may be fixed To specify the radix select a submenu from Setup gt Radix or click on a button on the Debug toolbar Setup gt Radix Submenu Debug Toolbar Description Hex lb Se
51. selected Specifies the format of sampling valid when YCbCr is selected REJ10J2000 0100 Rev 1 00 Jun 16 2009 324 RENESAS High performance Embedded Workshop Buffer Information View Information Format Specifies the area to Data Address Palette Address Width Height Size Enable Redraw Continuously Image Data 17 Debugging Facility An example is shown below Original Data Sampling Data Size of an Image 4 4 pixels ampling Ratio 11 12 13 14 21 22 23 24 31 32 33 34 41 42 43 44 11 12 13 14 21 22 23 24 31 32 33 34 41 42 43 44 11 11 13 13 21 21 23 23 31 31 33 33 41 41 43 43 11 11 13 13 11 11 13 13 31 31 33 33 31 31 33 33 11 11 11 11 21 21 21 21 31 31 31 31 41 41 41 41 Specifies chunky planar valid when YCbCr is selected Format Order of data Chunky invalid when 4 2 0 is selected Y Cb Cr Y Cb Cr Y Cb Cr Y Cb Cr Y Y Y Y Cb Cb Cb Cb Cr Cr Cr Cr Y Y Y Y Cb Cr Cb Cr Cb Cr Cb Cr store data size and the address of the palette Specifies the first address in memory of the area for display as image data in hexadecimal notation planar planar2 Specifies the first address in memory of the color palette data in hexadecimal notation valid when 8Bit has been selected for RGB or BGR Specifies the width and height of the image Width Pixel Specifies the width of the image unless a prefix is included values are treated as
52. slash character e g Visual SourceSafe to divide directories then select the Use forward slash as version control directory delimiter checkbox 8 10 Specifying a user name and password Most version control tools will require you to pass a username and password on the command line in order to keep files secure and to keep a record of which files were changed by which users The custom version control support provides two placeholders User login name USERNAME and User login password PASSWORD When the command is executed these placeholders will be replaced with the current settings in the General tab of the Version Control Setup dialog box In order to give the USERNAME and PASSWORD fields a value you will first need to login If you have not logged in before a command is executed which uses either of these placeholders then you will be prompted to do so before the command can be executed To login i e specify a username and password 1 Select Tools gt Version Control gt Configure The Version Control Setup dialog box opens 2 Select the General tab User details User JHARE Be Password 3 Click the Log In button The Log in dialog box opens Log in eal User name JHARK Cancel Password ik Confirm password by retyping it below o Enter your username into the User name field Enter your password into the Password field Re type your password again into the Con
53. syntax An information icon O appears on the left to the message output as the result of building Double clicking on the line displays the corresponding source code in the editor REJ10J2000 0100 Rev 1 00 Jun 16 2009 72 RENESAS High performance Embedded Workshop 3 Advanced Build Features The total number of errors and warnings will also be displayed in the Build tab of the output window at the end of a build phase 10 Use the Add Modify and Remove buttons to add modify and remove output syntax line formats respectively 11 Click the OK button when all modifications have been made Note You can only change the environment of a system phase via the Tools Administration dialog box To remove a custom phase 1 Select the phase to be removed and click the Remove button 2 Click the OK button to confirm the new settings To import a custom phase 1 Click the Import button The Import Custom Phase dialog box is displayed which allows you to browse to an existing project from which you want to import a custom phase 2 Choose the location of the project from which you want to import a custom phase Once selected the Import Phase dialog box is displayed which lists the custom phases in the imported project 3 Once you have decided which phase to import highlight it in the list and click the OK button The phase will then be added to the Build Phases dialog box at the bottom of the build order 3 3 2 Build File
54. use a placeholder excluding TCL If you wish to specify a directory not included in the placeholder specify an absolute path After specifying the absolute path this file will not be correctly found when it is in another host computer or environment where the path content is different In such cases specify the file again Example FILE_LOAD ELF DWARF2 CONFIGDIR demo abs 14 1 Opening the Command Line window Choose View gt Command Line or click the Command Line toolbar button Ea to open the Command Line window If available the window title displays the current batch and log file names separated by colons The High performance Embedded Workshop command and TCL commands can be input in this window For information about the available commands see Reference 3 Commands and the on line help The Command Line window has two tabs Console and Debugger Window configuration e Console tab This pane allows the user to input text based commands to control the target platform The results of command execution shown on this pane are in synchronization with the lower pane of the Debugger tab Command Line C orkspace Command_hdc no log file E Toolb woe aoa AnDiatl4 BT Inout gt Command commands reset and the atep results of tep complete at ADQODOOOOE command execution gt AIE Console o The command can be executed by pressing the Enter key after the command is input at the prompt gt on
55. which is replaced at some subsequent time for the actual value For example one of the High performance Embedded Workshop placeholders is FULLFILE which represents a file with a full path Suppose that you have an editor in c myedit myeditor exe which can accept the file to be edited as a parameter When invoking the editor for example you may want to open the file FILE1 C from the directory c files the following shortcut could be made c myedit myeditor exe c files FILE1 C However what happens if you want to open any file through this editor The problem is that the command above is specific to c files filel c What we want to be able to do is to tell the High performance Embedded Workshop to use the editor specified but to open the file that we have chosen at that time To do this you can substitute the specific name of the file for a general Placeholder c myedit myeditor exe FULLFILE Now whenever the High performance Embedded Workshop launches the editor with a file it knows that it has to replace the FULLFILE placeholder with the file you have selected 5 2 Inserting a placeholder To insert a placeholder select in any of the following operations Example 1 1 Place the insertion cursor at the point you would like to insert the placeholder 2 Click the placeholder button A pop up menu will be displayed which lists all of the placeholders that are valid for the associated edit box 3 Selec
56. 00 00 00 0000000 oo OO 00 00 00 00 00 00 00 00 00 00 00 OO000020 00 00 OO OO OO OO OO OO OO OO OO OO OO OO OO OD 17 3 23 Changing the number of digits displayed Choose Column from the pop up menu of the memory window The Set Column dialog box opens iE Cancel Set Column Specify the number of digits in which you want data to be displayed 1 256 REJ10J2000 0100 Rev 1 00 Jun 16 2009 320 RENESAS High performance Embedded Workshop 17 Debugging Facility 17 3 24 Switching display or non display of measurement result In the memory window a display of coverage measurement is set to Disable by default To enable the display select Coverage gt Enable from the pop up menu of the memory window In the Memory window the background of the executed lines is displayed in sky blue and the background of the unexecuted lines is displayed in gray During coverage measurement the default foreground and background colors of the executed codes are black and light blue respectively while those of the codes not executed are black and gray The colors in both cases can be customized in the Format Views dialog box For detail see section 17 3 29 Changing text colors 0 2 3 4 h th 7 40 9 A 6 E D E F ASCII 00 OO OO Of 00 OO OO 00 O 00 OO OO 00 OC ee o0 OO OO Of OO OO OO 00 00 O00 OO ee 00 OO OO OO OO OO Oo 00 ee o0 OO OO Of 00 OO 00 00 00 00 00 00 00 Cee
57. 15 Macro Recording Support Facility 15 5 2 12 Trace window While a macro is being recorded the following operation will be recorded into a macro file Target Operation Function Acquisition pop up menu option toolbar Make setting in the dialog box opened by Configures trace acquisition parameters button clicking on the menu option or toolbar button 15 5 2 13 Event window While a macro is being recorded the following operations will be recorded into a macro file Target Operation Function Add pop up menu option toolbar button Make setting in the dialog box opened by Adds the break point or break condition Edit pop up menu option toolbar button clicking on the menu option or toolbar button Edits the break point or break condition Enable pop up menu option toolbar button Click on the menu option or toolbar button Enables the selected break points or break conditions Disable pop up menu option toolbar button Disables the selected break points or break conditions Delete pop up menu option toolbar button Removes the selected break points or break conditions Delete All pop up menu option toolbar button Removes all break points or break conditions 15 5 2 14 Code Coverage window While a macro is being recorded the following operation will be recorded into a macro file Target Operation Function Hardware Settings pop up menu Make setting in the dialog box opened by e Allocates code coverage memory option toolbar button clicking
58. 3 Visual SourceSafe command options You can control the way in which the history and status commands are displayed by selecting Tools gt Version Control gt Configure 1 Select Tools gt Version Control gt Configure The Version Control Setup dialog box opens 2 Select the General tab Visual Source Safe W Display dialog box for history Display dialog box for file status 3 To display the results of a history command in a dialog box then check the Display dialog box for history checkbox or clear it if you would rather display the output in the Version Control tab of the Output window 4 To display the results of a status command in a dialog box check the Display dialog box for file status checkbox or clear it if you would rather display the output in the Version Control tab of the Output window 9 4 Version Control setup You can view or modify the general settings for the High performance Embedded Workshop connected with Visual SourceSafe 1 Select Tools gt Version Control gt Configure The Version Control Setup dialog box opens 2 Select the General tab User details User UserQ Password aK Database C Program Files Microsoft Visual Studia Vos ercsate ini Contiguration file Current version control contizuration file Ce Mitorkspace Name workspace Name hye The User details group box shows the login user ID and password and database file in Visual SourceSafe 4 You can modif
59. 4 A confirmation dialog box appears Select No Confirmation Request P k 1 Would you want to display the static member on this expansion T Don t ask this question again The static member variables are hidden even when structures are expanded and this will save time taken for display Even after you have selected No it is still possible to view the static member variables by adding them to the Watch window 17 18 3 1 Tooltip watch Use this function to know the value of a variable defined in the source program Open the editor window or disassembly window in source mode to view the source program and rest the mouse cursor over the variable name that you want to examine A tooltip pop up window will appear showing the watch information To use Tooltip watch 1 Select Setup gt Options The Options dialog box opens 2 Select the Editor tab 3 Check the Enable tooltip watch check box 4 Click OK If Enable tooltip watch REJ10J2000 0100 Rev 1 00 Jun 16 2009 364 RENESAS High performance Embedded Workshop 17 Debugging Facility To view a tooltip watch on the editor window or disassembly window in source mode 1 Open the editor window or disassembly window in source mode showing the variable that you want to examine 2 Rest the mouse cursor over the variable name that you want to examine A tooltip will appear near the variable containing basic watch information for that variable Source Sorta
60. 49 2 amp 1 PRU configurations sreca AA aE A a Aaaa aera E e aa aea aTa 49 271 Selecting a build configuration asoccscessszedsinsncadveredscanncadenaconadsdeanandeepsodenoesenegiedsasnedainan sid ttanccabsegsmsssusesanededeaectdes 50 REJ10J2000 0100 Rev 1 00 Jun 16 2009 RENESAS High performance Embedded Workshop Contents 272 Adding a new build COnfiguration cssseesssseeecccececeeeeeeaaeessssssseesseeeeceeeeeeeeeeeaasaaeseeeeeeeeeeeeeeeeceeeaaaaaaeessees 50 2 7 3 Removing a build CONFI QUratION cc cccccsseeeeeeseeeeeceeeeeeeeeeeaaaaeseseeseeeeeeeeeeeeeeeeeaasaeeasaeeseaseeeeeeeeeeeeessaaaaeeesees 50 femme 1000 CULE SMe 10 8 a ee nnn ter ne nei taper Tern nnn ert te rt fer A Ore tern ee etre eee TTT cere mere rch tres 51 2 8 1 Building individual TINGS cs ou sn coacecesdacdsctecanaiuspaneecdadunuteandansecbatdaeceysetcacersenescaedeasedhncond sete imanieuneeconceadestacasaient 51 2 8 2 A UT aA OC C eE E E EE TE EE TE TE T 51 2 8 3 Building multiple projects cccccccccccccccccnsssssseeseeeeecceeeeeeeeeeaaeeseesseeeeeeeeeeeeeeeeeeeeeeeaaeaaseeseseeeeeeeeeeeeeaaaaageseeses 32 2 8 4 SLOPPING TOOL eeM Oranas EE E S E 52 2 8 5 Deleting intermediate and output files produced in building 2 0 0 cccecccnnseseeeeeseeeeeeceeeeeeeeeeaeaaeeeeeeees 53 2 8 6 Configuring the Build tab of the Output windoW ssssssssooeeensssssssssssssssseerrererrresssssssssssssceeeeresssssssseeeeeeree 54 2 8 7 Controlling the content o
61. 8 Searching for a label Choose Find from the pop up menu to open the Find Label dialog box Find Label Ei Address Cancel M Match whole word only Match case 1 Enter the label name that you wish to find into the Name field or select a label name that you have searched before from the drop down list box 2 Enter the address of the label that you wish to find into the Address field or select an address that you have searched before from the drop down list box 3 To find the label having the name entered in the Name field select the Match whole word only check box When this option is not selected the High performance Embedded Workshop searches for any labels that partly match the name entered in the Name field the Address field cannot be used When the label name must be case sensitive select the Match case check box Click the OK button to start the search Note Only the label is stored by 1024 characters of the start therefore the label name must not overlap mutually in 1024 characters or less 17 18 1 9 Searching for the next label Choose Find Next from the pop up menu to find the next occurrence of the label containing the text that you entered 17 18 1 10 Viewing the source code corresponding to a label Select a label and choose View Source from the pop up menu to open the source file containing the address corresponding to the label 17 18 2 Elf Dwarf2 support The High performance Embedded Workshop
62. Allows you to provide jumps to various textual constructs within your project s files What is actually displayed within the Navigation tab depends upon what components are currently installed The figure above shows C macro definitions C Defines and C functions C Functions conforming to the ANSI standard See Chapter 12 Navigation Facilities for more information about navigation e Test tab Allows you to setup or view test suites as part of the test support facility See Chapter 16 Test Support Facility for more information about the test support facility To allow the Workspace window or the Output window docking Right click anywhere inside the Workspace window or the Output window Then a pop up menu will be displayed E Allow Docking If the Allow Docking option is checked docking is allowed Otherwise docking is not allowed Select the Allow Docking option to check or un check it REJ10J2000 0100 Rev 1 00 Jun 16 2009 6 RENESAS High performance Embedded Workshop 1 Overview When the Allow Docking option is checked you can dock a window toolbar or menu bar to the edge of the High performance Embedded Workshop main window or to the edge of another docked window You can also float them above the other High performance Embedded Workshop windows or outside the High performance Embedded Workshop main window Figure 1 below shows a docked Workspace window and figure 11 below shows a floating Workspace wi
63. BP column of the line at which the PC breakpoint is set or by placing the caret on the line and using the F9 key The display will cycle through the available standard breakpoint types a red circle will be shown in the gutter 17 15 Viewing the current status To check the configuration and status of the debugger in the Status window choose View gt CPU gt Status or click the View Status button EH The Status window has three tabs Window configuration statuz status Memory Mode None Target Device Configuration OUODOUUOUDO O7FFFFFF EZT 20000000 27FFFFFF EXT 40000000 47FFFFFF Ext COOOOO000 COOOOFFF EXT FFFFSOOO FFFFBFFF KAM FFFFFEOO FFFFFFFF I O aystem Memory Resources QOO00000 OOO07FFF Read O 6000000 O6000FFF Read OTFFFOOO O 7FFFFFF Read FFFFFEOQO FFFFFFFF Read Program Name Memory Loaded Area se 4 Ap Memory A Platform j Events Tab Description Memory Contains information about the current memory status including the memory mapping resources and the areas used by the currently loaded object file Platform Contains information about the current status of the debugger typically including CPU series and mode run status and timing information Events Contains information about the current event breakpoint status including resource information REJ10J2000 0100 Rev 1 00 Jun 16 2009 352 RENESAS High performance Embedded Workshop 17 Debugging Facility 17 16 Viewing the function ca
64. Black White Build Error Build Warning Text Black White Build Warning Information Text Black White Build Information 4 Change the selection in the Foreground and Background lists of the Color tab Click the OK button REJ10J2000 0100 Rev 1 00 Jun 16 2009 11 RENESAS High performance Embedded Workshop 1 Overview 1 2 7 Status bar The status bar displays various information about the current state of the High performance Embedded Workshop The figure below shows the status bar Displays HE status messages Virtual desktop Line numberLines lngertionOvernvwite mode GUI command description Mum Lock Attributes Column number Caps Lock Ready fei EE EE Defaulti desktop Read write 62 87 4 INS NUM The customizable status bar feature allows the user to customize the display of the status bar area and its contents The status bar will also now show target related information where required by the specific target being used The bottom section of the status bar area shows the standard application based information as in previous version of High performance Embedded Workshop Above this is the target related information The information displayed here is completely target dependant and in some cases there may not be any target related information to display The status bar can be switched on and off via View gt Status Bar When any part of the status bar area is visible this main menu option will completely switch off the status b
65. C SE Files S E ASSEMBLER PROJECT a OE Files aM UNKER UNE he Files Files a module In the example shown in the figure above the Compiler is the first phase the Assembler is the second phase and the Linker is the third and final phase During the Compiler phase the C C source files from the project are compiled in turn During the Assembler phase the assembler source files are assembled in turn During the Linker phase all library files and output files from the Compiler and Assembler phases are linked together to produce the load module The build process can be customized in several ways For instance you can add your own phases disable phases delete phases and so on These advanced build issues are left to chapter 3 Advanced Build Features REJ10J2000 0100 Rev 1 00 Jun 16 2009 35 RENESAS High performance Embedded Workshop 2 2 2 Build Basics Configuring the Projects tab of the Workspace window The Projects tab shows the current workspace projects and files You can quickly open any project file or dependent file by double clicking on its icon Workspace Ey Workspace Workspace Elie Current_project Project o H E Assembly source file Current project Sa source file Folder o EB dbectc Project file ow LET lowere c o resetpre c sbrk c feer SH4 Demo c eee Download modules a Active_project abs B Dependencies seve Z envy Inc ca stackec
66. Click OK To remove the currently selected buttons from a toolbar 1 Select the toolbar button you wish to remove from the Current toolbar buttons list 2 Press the Remove button The toolbar is added to the Available toolbar buttons list 3 Click OK REJ10J2000 0100 Rev 1 00 Jun 16 2009 419 RENESAS High performance Embedded Workshop 12 To Build in Toolchain for High performance Embedded Workshop V 1 x 12 To Build in Toolchain for High performance Embedded Workshop V 1 x When a project created in High performance Embedded Workshop V 1 x is used without upgrading to new toolchain that has been registered in High performance Embedded Workshop V 2 x onwards the toolchain for the old version must be registered Select the HREF file for the old toolchain with the Register button by selecting Tools gt Administration Build can be executed on High performance Embedded Workshop V 2 x onwards by using the old toolchain However note that a workspace which has been opened in High performance Embedded Workshop V 2 x onwards cannot be opened in High performance Embedded Workshop V 1 x In High performance Embedded Workshop V 2 x onwards a new project for the old version cannot be created When a project for the old version in High performance Embedded Workshop V 1 x is created use High performance Embedded Workshop V 1 x Select HEY Registration File EES Look ir E BE Ua a File name eh _E60a0 hrf Files
67. Code button in the Breakpoints dialog box opened by selecting Edit gt Source Breakpoints e Selecting File gt Recent Files If you select a file in the Projects tab of the workspace window and right click to display a pop up menu the Open lt file name gt in external editor menu option is available under the Open lt file name gt menu option REJ10J2000 0100 Rev 1 00 Jun 16 2009 131 RENESAS High performance Embedded Workshop 6 Customizing the Environment Note When using an external editor be aware of the following issues e ach time you invoke the external editor in whichever way a separate instance of the editor will be launched e You must save your own files before you perform a Build Build All or Build File operation 6 10 Customizing the font in your views The High performance Embedded Workshop contains many components which you may wish to make look differently It is possible to change the font and text coloring for the views To change the look of your windows 1 Select Setup gt Format Views The Format Views dialog box opens 2 Select the view you are interested in changing the appearance of To change all views select the All views category Expand the item in the tree to see all items you can change the look of Select the item Notice the tab changes on the right of this dialog box Change the font or text color a oS Click OK to save the changes and the views will be automatically update
68. Current user password General tab Version control directory VCDIR Virtual version control mapping Projects tab Comment COMMENT Comment specified before command execution File path name FULLFILE Full path and name of the file involved in the operation Filename FILENAME Filename including extension of the file involved in the operation File leaf FILELEAF Filename excluding extension of the file involved in the operation File extension EXTENSION Extension of the file involved in the operation File directory FILEDIR Directory of the file involved in the operation Configuration directory CONFIGDIR Current configuration directory Project directory PROJDIR Current project directory Workspace directory WORKSPDIR Current workspace directory Temp Directory TEMPDIR Temporary directory Command directory EXEDIR Version control executable directory Windows directory WINDIR Directory where Windows is installed Windows system directory WINSYSDIR Directory where Windows system files exist Workspace name WORKSPNAME Current workspace name Project name PROJECTNAME Current project name Configuration name CONFIGNAME Current configuration name 8 4 Specifying comments If a version control command contains the placeholder COMMENT the High performance Embedded Workshop will request that you enter the comment when the command is executed via the Please Enter Comment dialog box
69. E A 342 17 7 5 Choosing a register to be displayed ccsssssssssseeececeeeeeeeeeeaaaseeessseeeeeeeeeeeeeeeeaaaaeeeeessseeeeeeeeeeeeeseeeeeaaaas 342 EO Modine MCT On E aE saccade dee neces saa eee E E 343 17 7 7 Sene he ae yaC E a setaaanecuasccuedasiasaanets 344 17 7 8 SPUIDE up he window display pages isereise ea ate daeoas ETTE 344 17 7 9 CA We SIS FOR COM TE E A T E E 344 REJ10J2000 0100 Rev 1 00 Jun 16 2009 Vil RENESAS High performance Embedded Workshop Contents 17 7 10 Refreshing the Register Wind OW sssessssseeeecceceeeeeeeeeeeeeaeeeeeseeeeeeeeeeeeeeeeeeaseeeeeeeseeeeeeeeeeeeeeeeeeeeaaaaaaeeesaes 344 17 7 11 Disabling refresh of the Register WIndOW cccccccccccccccecesesseseeeeeeecceeeeeeeeeeeeeaaaaeasseseeeeeeeeeeeeeeeseeaaaageeesees 344 712 Using recister content atin tecuace cence dea ae aa aa tosanceneeadscouteacnasureucauer 345 FD Chanem TEXT COOLS saccos N E N 345 IS SO OTM MNO AEE E E E T E 345 179 RCC Ur ine taret MCU a cccececciansiscc cds aes ER ce UE NE E EEEE E AEG EA EAA 346 17 10 Seting PC tothe address at OUT SON vies ecunsecsccetnewessecaaniaatenaranthas EEEn EUREEN RE EE EE ENE 346 I aae e a a E E EA A E E EE rrr eR eery te eer 346 D12 Connectno disconnectime Me OC CL orson ariin E EREE E EEEE A EEEE EEE A 346 AIS E a a a O a A E EA EE EEA E 346 IAIL Continuing TON acre asset st a ee cetacean reso e aaO a aai aia aa enie 346 Ii Running onmi Tese eeno O EEEE EERE EAEE EEEO EE 347 17 1
70. E AEI EER E EEE 322 To e a e T COONS ea E E E ends EN EER OE EA SOE 323 17 4 Displaying memory contents as an Mage ccccceecccccccccccceeeeceaeaeeeseeseseeececeeeeeeeeeessasessseseeeeeeeeeeeeeeeeeeeaaaaaagassses 323 17 4 1 Opening ihe Imate WING OW ccasasssaansaaces ssisdendnceesendseacwanerisieenasteadensnsetdqudspacdoawsnddanadtnaderdunwudautesadhaxnnbaaataadents 324 17 4 2 Regularly refreshing the Image Window cccccccccccccccccnceeeeessesseseeeeeeeeeeeeeeaaaaeeeeessesseeeeeeeeeeeeeeeeeeaagaesensees 327 17 4 3 Refreshing the Image WindOw cccccccccccccsssssssssssseeeeeeceeeeeeeeeeeasaeaaasseeesseeeeeeeeeeeeeeeeeeaaaaaesesseeeeeeeeeeeeeeeeeaaaas 327 17 4 4 Specifying the refresh interval n nnesenessssssssssseseeereresssssssssssssserterresssssssssssseeetereerossssssssssssseseeerereesesssse 327 17 4 5 Viewing Images as Consecutive Frames eesessssssssssseeeterrrrrsssssssssssseeeterresssssssssssssssseseeterreressssssssssees 328 17 4 6 Displaying the pixel information eeeseeeessssseseseeeeeressssssssssssssererererreerssssssssssesseetrrresssssssssssseeeererreseesssss 330 17 5 Displaying memory contents aS Waveforms ccccccccccccceceecceseessseseeseeeceeeeeeeeeeeaaassesssseseeeeeeeeeeeeeeeeeeaaaaaaeeaeeses 331 17 5 1 Opening the Waveform window ccccccccccccccsnssssssseeseseeeeeeeeeeeeeseeaaesessseseeeeeeeeeeeeeseeaaaeaaaaaeeseseseeeeeeeeeeeeeeaaaas 331 17 5 2 Regularly ref
71. Either the following can be specified ASCII Displays memory data as ASCII characters default SJIS Not supported JIS Not supported UNICODE UTF 8 Not supported UTF 16 Not supported EUC Not supported Float Float Displays memory data as single precision floating point values Double Displays memory data as double precision floating point values Complex Float Complex Displays complex numbers as single precision floating point values Double Complex Displays complex numbers as double precision floating point values Float Imaginary Displays imaginary numbers as single precision floating point values Double Imaginary Displays imaginary numbers as double precision floating point values Fixed 16bit Fixed Displays memory data as 16bit fixed 32bit Fixed Displays memory data as 32bit fixed 24bit Accum Displays memory data as 24bit accumulate 40bit Accum Displays memory data as 40bit accumulate 17 3 22 Setting the layout Select the layout from the followings in the pop up menu Layout of the memory window The followings can be selected Label Switches display or non display of the Label column Register Switches display or non display of the Register column Code Switches display or non display of the Code column When the label register or code is shown the option is checked When the Label Register and Code columns are hidden fddress 0 H 2 H 4 45 h 7 8 H 4 8 E 0 E F 00000000 oo 00 00 00 00 00 00 00 00
72. High performance Embedded Workshop are installed the files specific to each High performance Embedded Workshop are saved for each user account 1 13 Overview of Configurations and Sessions standard toolbar Current Configuration Current Session Standard x TH e E SimnsessionsH 4 SimsessionsH 4 Defaut ession Debug Helease Configuration Session The drop down list box on the Standard toolbar shows the current configuration and session This example shows the configuration and session in which the Renesas SuperH Standard toolchain was selected at creation of a project and SH 4 Simulator was selected as the target debugger You can switch between different configurations and sessions by selecting one in the drop down list box It is also possible to add or delete configurations or sessions as necessary e Configuration What is configuration Configurations are the build option settings e g output of debug information or optimization having their own names The term configuration can also be referred to as build configuration In the figure of the Standard toolbar shown as an example configurations SimDebug_SH 4 Debug and Release are available Configurations created by the High performance Embedded Workshop When a project is created after selection of the toolchain the High performance Embedded Workshop automatically creates configurations Debug and Release REJ10J2000 0100 Re
73. If this checkbox is selected a batch file will not be executed when Download Debug Data Only is selected in the pop up menu displayed by right clicking the module in the workspace window even in cases where Before download of modules or After download of modules has been selected for Command batch file load timing and a command batch file has been specified To not execute a batch file when a program containing only debug information is downloaded 1 Select Debug gt Debug Settings The Debug Settings dialog box opens 2 Select the Options tab 3 Select the Disable batch file execution when downloading debug information By default this checkbox is selected 4 Click OK 3 Downloading modules after build If this checkbox is selected the user program will be automatically downloaded after a build To download modules after build 1 Select Debug gt Debug Settings The Debug Settings dialog box opens 2 Select the Options tab 3 Select the Download modules after build By default this checkbox is selected 4 Click OK 4 Removing breakpoints on download If this checkbox is selected the breakpoints will be automatically removed after downloading the user program To remove breakpoints on download 1 Select Debug gt Debug Settings The Debug Settings dialog box opens 2 Select the Options tab 3 Select the Remove breakpoints on download Default for this checkbox depends on the target 4 Click OK 5 Dis
74. Interval The Auto Refresh Interval dialog box opens Auto Refresh Interval ki EJ Interval S00 9000rmsec 10mzec unit 1500 MEC Cancel 3 Specify the refresh interval in 10 ms units The default value and valid range vary depending on the debugger The refresh interval can be specified for each Memory window After Auto Refresh is activated the actual refresh interval is shown on the leftmost column header in the Memory window during execution of the user program The actual refresh interval may be longer than the specified value depending on the state of execution 17 3 19 Changing the data length Select the data length from the followings in the pop up menu Data Length of the memory window Either the following can be specified lbyte Displays in 1 byte units default 2bytes Displays in 2 bytes units A4bytes Displays in 4 bytes units Sbytes Displays in 8 bytes units 17 3 20 Changing the radix Select the data radix from the followings in the pop up menu Radix of the memory window Either the following can be specified Hex Displays in hexadecimal default Dec Displays in decimal Signed Dec Displays in signed decimal Oct Displays in octal Bin Displays in binary REJ10J2000 0100 Rev 1 00 Jun 16 2009 319 RENESAS High performance Embedded Workshop 17 3 21 Changing the code 17 Debugging Facility Select the code from the followings in the pop up menu Code of the memory window
75. Li Register Definitions File Modules BaseAcddress 0 Medulel Power Down Mode Registers tiled ues Module DNIA_ Channel _Commen Meadules DNA Oo Short Address Mode Meoduled2 Bus Contreller MeoduledS System Meduledd Interrupt Controller DMA Channel Commen reqdsre ql MAW ER fue ke regi reqOD MAT LA Definition rea re gD WAB CAH 3AM re g szre gD MAB CRALSAM re gd re gD MAB CAH FAM re g5 zre gD MAB CHALFA M dep zregaMisTFCRAH F 0 reg DMAE Id DMIAWWER toa B A H drnewer_bittlelcds Register name Address Sie Abaclute address flag Format Bites Idrrawer bittields Bitfields l Definition PTO W EGA bt2 W E14 bt WE1B REJ10J2000 0100 Rev 1 00 Jun 16 2009 411 RENESAS High performance Embedded Workshop 7 Symbol File Format 7 Symbol File Format In order for High performance Embedded Workshop to be able to understand and decode the symbol file correctly the file must be formatted as a Pentica B file L 2 s7 Note The file must be a plain ASCII text file The file must start with the word BEGIN Each symbol must be on a separate line with the value first in hexadecimal terminated by an H followed by a space then the symbol text The file must end with the word END Example BEGIN 11FAH Symbol_name_1 11FCH Symbol_name_2 11FEH Symbol_name_3 1200H Symbol_name_4 END Support for this function depends on the debugger REJ10J2000 0
76. Memory window or Disassembly window open on the I O area can have the same effect While Lock Refresh of the IO window is active no data will be read out even if an I O register display is expanded 17 6 3 Modifying the values of I O registers The values of I O registers can be modified in the IO window To modify the value of an I O register Select either of the following ways e In place edit in the Value column eo Bel IR dh Fly Memory Management Unit H E PTEH FFoOoOoOo oo0000ol E ASID mO All Register Selected Register e Double click on the line of the I O register or bit to open a dialog box in which the values can be changed Enter a Edit ASID at FFOOOOOO Ei ES Current value i New value Cancel value in New value REJ10J2000 0100 Rev 1 00 Jun 16 2009 336 RENESAS High performance Embedded Workshop 17 Debugging Facility 17 6 4 Refreshing the IO window The IO window contents can be forcibly refreshed Selecting Refresh from the pop up menu of the IO window 17 6 5 Disabling refresh of the IO window Automatic refresh of the IO window which is performed when user program execution stops and in other cases can be disabled Select Lock Refresh from the pop up menu of the IO window The contents of the IO window are grayed out but the text color of the I O register for which the value has been changed remains While Lock Refresh is active you cannot modify the I O register settin
77. OR e Click the placeholder button Then select Project directory or Workspace directory from the menu OR e Click the Browse button to open the Browse to Source Directory dialog box Select the directory and click the Select button 5 Enter the name of the Visual SourceSafe project directory to be mapped to the source directory in the Version Control Directory Mapping field 6 Click the OK button To modify a directory mapping 1 Select Tools gt Version Control gt Configure The Version Control Setup dialog box opens 2 Select the Mapping tab 3 Select the mapping to be modified from the list and then click the Modify button The Version Control Directory Mapping dialog box opens Version Control Directory Mapping Source directory C workspace Workspace_ Mame Proje gt Browse Ld Version control directory srw orkspace Name Cancel 4 To modify a mapping make the same setting as required for adding a mapping in the Version Control Directory Mapping dialog box 5 Click the OK button REJ10J2000 0100 Rev 1 00 Jun 16 2009 168 RENESAS High performance Embedded Workshop 9 Visual SourceSafe Version Control System To remove a directory mapping 1 Select Tools gt Version Control gt Configure The Version Control Setup dialog box opens 2 Select the Mapping tab 3 Select the mapping to be removed from the list and then click the Remove button 9 6 Adding Visual SourceSafe
78. Opens the editor or Disassembly window at the address of the PC Executes a block of user program before breaking Executes a block of user program before breaking If a subroutine call is reached then the subroutine will not be entered Executes sufficient user program to reach the end of the current function Opens the Step Program dialog box allowing the user to modify the settings for stepping Steps only one source line when the editor window is active When the Disassembly window is active stepping is executed in a unit of assembly instructions Executes stepping in a unit of assembly instructions Steps only one source line Stops the execution of the user program Disconnects the debugger and connects it again Connects the debugger Disconnects the debugger Saves the specified memory area data to a file Verifies file contents against memory contents High performance Embedded Workshop 1 Main Menus Download Modules Unload Modules Downloads the object program Unloads the object program 1 Operations with some menu options can be recorded as High performance Embedded Workshop command line commands by the macro recording support facility A macro record icon in the Macro Recording column of a menu option indicates that this function can be recorded into a macro file For details see section 15 5 1 Recordable functions common to all High performance Embedded Workshop products 2 Sup
79. Order tab If you were to select a C source file from the Workspace window and then activate Build gt Build File or click the Build File toolbar button E you would expect the file to be compiled Likewise 1f you were to select an assembly source file from the workspace window and then activate Build gt Build File you would expect the file to be assembled The connection between file group and which phase s to execute is managed by the Build File Order tab of the Build Phases dialog box The list displays all of the current phases that will be executed when the build file operation is selected upon the file group shown in the File group list box In figure below the C source file file group is selected and the Compiler and MyPhase phases are associated with it Entries in the Phase order list of the Build File Order tab are added automatically as new entries are added to the Build Order tab Build Order Build File Order File Mappings File group Phase order WISH OfC Compiler My Phase source file iS source tile l Linkage symbol tile For example if you were to add a phase which takes C source files as input then this phase will be automatically added to the list of phases to execute when a build file operation is applied to a C source file If you don t want a certain phase to execute when Build gt Build File is selected then clear the check box to the left of the pha
80. R mark shown to the left of each variable indicates whether the variable is updated in real time A pop up menu containing the following options is available in the Watch window Auto Update Marks the selected variable with a bold R and updates the variable in real time Auto Update All Marks all variables with bold Rs and updates all variables in real time Delete Auto Update Marks the selected variable with an outlined R and cancels real time update Delete Auto Update All Marks all variables with outlined Rs and cancels real time update The values of variables for which real time update has been enabled can be modified during execution of the program 12 Setting an update interval The interval to update the display contents of the Watch window during execution of the user program can be changed Support for this function depends on the debugger To set an update interval 1 Right click within the window to open a pop up menu 2 Select Update Interval The Update Interval Setting dialog box opens Update Interval Setting Interval 0 10000meec 10meec units oa nsec Cancel 3 Specify an update interval in 10 ms units for Interval The default value is 100 ms The valid range of values depends on the debugger in use 4 Click OK The specified update interval is applied to all panes of the Watch window The actual update interval may be longer than the specified value depending on the state of execution 13
81. REJ10J2000 0100 Rev 1 00 Jun 16 2009 122 RENESAS High performance Embedded Workshop 6 Customizing the Environment Log M Generate build log Path stwORKs POIR EIMOR RS PAAME bet Browse M Generate workspace log I Generate log for projects When the Generate workspace log check box is clicked any workspace changes will be logged to a file with the same name as the workspace with a log extension This file will be located in the same directory as the workspace file When the Generate log for projects check box is clicked any projects in the current workspace that have changes made to them will be logged to a file with the same name as the project with a log extension This file will be located in the same directory as the project file The log file is updated when the workspace is saved 6 5 Configuring the help system The High performance Embedded Workshop provides context sensitive help within the Editor window In other words if you select some text in the Editor window and then press F1 the High performance Embedded Workshop will attempt to locate help on that selected item The help files that will be searched are listed in the Help tab of the Setup Customize dialog box To add a new help file 1 Select Setup gt Customize The Setup Customize dialog box opens 2 Select the Help tab Help Help files i Add CrC Standard Library Help chew tools renesas
82. Recording the history of updating of values The history of updating of the values of watch items to which automatic update has been applied in the Watch window can be recorded into a file To start recording the history of updating of values 1 Right click within the window to open a pop up menu 2 Select Record Update Value and then Start Recording from submenus The Recording Settings dialog box opens REJ10J2000 0100 Rev 1 00 Jun 16 2009 373 RENESAS High performance Embedded Workshop 17 Debugging Facility Record Settings ki Recording Sheet OK Cancel File name a ee Append Timestamp In the Recording Settings dialog box specify how to record the history Select a sheet that you wish to record the history in Recording Sheet Only one sheet can be used for recording at one time Recording Sheet only lists the names of the sheets that include watch items to which automatic update has been applied Enter the file name in File name To insert a placeholder in File name click the Placeholder button and select Placeholder from the pop up menu To browse a file click the Browse button To append data to the specified file select the Append checkbox Select the Timestamp checkbox to record timestamps ms in the file This checkbox is not selected by default Clicking the OK button starts recording except in the following case The Append checkbox is selected but the watched items recorded in the
83. Register Memory lO Opened by View gt Workspace Double clicking on a file in the Projects tab of the workspace window View gt Disassembly View gt CPU gt Registers View gt CPU gt Memory View gt CPU gt IO 15 5 1 1 Projects tab of Workspace window While a macro is being recorded the following operations will be recorded into a macro file Target a Workspace Project Operation Clean All Projects pop up menu option Click on the menu option 1 Build pop up menu option 1 Build All pop up menu option 1 Clean Current Project pop up menu option 1 Set as Current Project pop up menu option Project file Download modules folder Download module Notes Build lt File name gt pop up menu option 1 Download all module pop up menu option Download A New Module pop up menu Make setting in the dialog box opened option by clicking on the menu option 2 Double click on a download module Download module pop up menu option Click on the menu option Download module debug data only pop up menu option Unload module pop up menu option Download A New Module pop up menu Make setting in the dialog box opened option by clicking on the menu option 2 1 Available only when there is a toolchain installed Function Deletes intermediate and output files from configurations in all projects in this workspace Builds out of date project files Builds projec
84. SHIFT CTRL SHIFT CTRL SHIFT CTRL SHIFT CTRL SHIFT CTRL SHIFT CTRL SHIFT SHIFT SHIFT SHIFT SHIFT SHIFT SHIFT SHIFT SHIFT SHIFT SHIFT SHIFT SHIFT SHIFT SHIFT SHIFT SHIFT ALT None None None None None None None None None None None None None None None None None None None None None None None None None Note Z Ty lt lt C o 3 SPACEBAR TAB HOME END LEFT ARROW RIGHT ARROW F1 F2 F3 F5 F8 F10 F11 F12 DELETE ESC TAB HOME END UP ARROW DOWN ARROW BACKSPACE F1 F2 F3 F4 F5 F7 F8 F9 F10 F11 F12 DELETE INSERT ENTER TAB ESC HOME END PAGE UP PAGE DOWN UP ARROW DOWN ARROW LEFT ARROW RIGHT ARROW ALT Mouse select 8 Keyboard Shortcuts Change the active Debugger to the next one in the Debuggers tab of the Workspace window Synchronized Debugging Facility Save all modified documents in the workspace Insert a template Change into a uppercase letter all the texts chosen in the editor Open the Waveform window Display PC position Search for the previous occurrence of the text chosen in the editor or open the Find dialog box Re shown the function name and parameter as a pop up window when the first open bracket is entered in the editor Switch windows in the editor Select from the cursor to the beginning of the file Select from the cursor to the end of the file Select the previous word in the
85. Saves the contents of the window into a text file Copy Copies the selected contents onto the Windows clipboard Toolbar display Shows or hides the toolbar aE S sa ER e Customize toolbar Customizes toolbar buttons The Build tab also shows an icon corresponding to the error message output by build execution Icon Name Icon Error Message Level Build Error a Error Build Warning iy Warning Information i Information REJ10J2000 0100 Rev 1 00 Jun 16 2009 9 RENESAS High performance Embedded Workshop 1 Overview Debug tab Shows the output from any debugger process Any debug component that needs to display information will send its output to this window Right clicking displays a pop up menu containing available options A basic operation is allocated to the toolbar The functions of Toolbar display and Customize toolbar are also included in the pop up menu displayed by right clicking the toolbar area Pop up Menu Option Toolbar Button Function Clear Window A Clears the contents of the window Save i Saves the contents of the window into a text file Copy Copies the selected contents onto the Windows clipboard Toolbar display Shows or hides the toolbar Customize toolbar Customizes toolbar buttons Find in Files 1 and Find in Files 2 tab Shows the results of the last Find in Files action To activate find in files select Edit gt Find In Files or click the Find In Files toolbar button For furt
86. Setting 2 Memory Resource Auto Allocate 2 Print Toolbar display Customize toolbar Gta BE Bee P S S S Notes Function Enters the edit mode Adds the section group Adds the section Adds the overlay group Automatically adds missing sections Edits the selected item Cuts the section information Copies the section information Pastes the section information Deletes the section information Moves up the section information Moves down the section information Changes primary section Sets a memory map Automatically allocates the memory resource Prints section setting tree view Shows or hides the toolbar Customizes toolbar buttons 1 This pane cannot be used when the linkage editor does not support overlay 2 Support for this function depends on the selected debugger SuperH and H8SX H8S and H8 family simulator debuggers support this function e Section settings after a build right pane Right clicking displays a pop up menu containing available options A basic operation is allocated to the toolbar The Toolbar display and Customize toolbar options are also included in the pop up menu opened by right clicking on the toolbar REJ10J2000 0100 Rev 1 00 Jun 16 2009 192 2CENESAS High performance Embedded Workshop 13 Map Pop up Menu Option Toolbar Button Function Show Unallocated Area Shows the unallocated area Show No Size Section Shows the no size sectio
87. Variable dialog opens 2 Enter the variable name into the Variable field 3 Enter the variable s value into the Value field 4 Click the OK button to add the new variable to the Environment tab To modify an environment variable 1 Select the variable that you want to modify from the Environment tab 2 Click the Modify button The Environment Variable dialog box opens 3 Make the required changes to the Variable and Value fields 4 Click the OK button to modify the environment variable REJ10J2000 0100 Rev 1 00 Jun 16 2009 113 RENESAS High performance Embedded Workshop 5 Tools Administration Environment Yarable x Variable Pet OF Value Placeholder s TOOLDIR bin pop up Feru To remove an environment variable 1 Select the variable that you want to remove from the Environment tab 2 Click the Remove button Note Placeholder pop up menus are included to ensure that the environment can be specified as flexibly as possible For further information about using placeholders see Reference 5 Placeholders 5 6 Technical support The Tools Administration dialog box is capable of displaying information regarding hidden system components These are part of the High performance Embedded Workshop itself and cannot be registered unregistered manually If you check the Show all components checkbox on the Tools Administration dialog extra component folders are displayed see the figure below Shen P
88. Version control directory mappings Source Director Version Control Director Add Moditi Renove Environment LOGMAME user path lt path lt C SACS T2sl57 9 Riadi Remove OF Cancel Esport Import 2 Click the Add button on Environment 3 The Environment dialog box appears REJ10J2000 0100 Rev 1 00 Jun 16 2009 147 RENESAS High performance Embedded Workshop 8 Custom Version Control System Environment Yariable Ei Warable OF Cancel Value path CARCS gt 4 Enter path in Variable and path C RCS in Value respectively 5 Click the OK button 6 Click the Add button Also enter the following environment variables in Environment LOGNAME user TZ JST 9 e Specifying actions 1 Select the General tab Yersion Control Setup ki xX Commands Projects General Executor Prompt before executing command lM Aun in DOS window Use forward slash as version control directory delimiter User details User Hone Password Hone Configuration file Current version control configuration file LAWorkSpacelrsc_sample rsc_ sample hye Cancel Esport Import 2 Deselect the Prompt before executing command checkbox Leave it selected however if you wish to see the file name before executing commands 3 Select the Run in DOS Window checkbox This is because the RCS commands must be input via the MS DOS prom
89. View Configures the workspace view Show Differences Compares files Properties Displays file properties For details on Current project Loaded project and Unloaded project see section 2 12 Setting the current project 2 3 Project files In order for the High performance Embedded Workshop to be able to build your application you must first tell it which files should be in the project and how each file should be built see the figure below REJ10J2000 0100 Rev 1 00 Jun 16 2009 38 RENESAS High performance Embedded Workshop 2 Build Basics 2 3 1 Add Project Files Remove Project Files Debug ON Optimize OF List File YES Set Compiler Optio ris Deb ug OF oS bet Assembler Options List File YES Asse robe Source Files E Debug OH Set Linker Options bhp File TES Adding files to a project Before building an application select files to configure the application To add files to a project l Files can be added to the active project only Select one of the following operations to open the Add files to project project name dialog box Select Project gt Add Files OR Right click on the project within the Projects tab of the workspace window and select Add Files from the pop up menu OR Press the Insert key when the Projects tab of the Workspace window is selected Select the file s you wish to add to the project A Relative Path checkbox is available at the bottom of this d
90. Watch Watch Sheet vant 3 syrnibols Cancel Ignore address 4 Click OK 16 6 2 2 Symbol Locals Locals window The following table shows information on the test image data to be saved into test image files and test results not matched Test group name Symbol Test item name Locals Test image data to be Values set as detailed information and the range of data in the Locals window acquired with this setting saved into test image files Checkboxes for all symbols are blank by default REJ10J2000 0100 Rev 1 00 Jun 16 2009 245 RENESAS High performance Embedded Workshop 16 Test Support Facility Test result details Failed at symbol Name of the unmatched symbol Src Content of the test image file Dest Data in the current High performance Embedded Workshop system or in another test image file to be compared with Example Failed at symbol i Src int H 00000001 R14 Dest int H 00000000 R 14 To make detailed setting If you double click on a test item in the Create New Test Image dialog box a further dialog box for detailed setting Edit Test Locals Symbols opens Curent Setting 1 To specify a symbol to be saved into the test image file select the checkbox for that symbol The selected symbol is shown in Current Setting Edit Test Locals Symbols Curent Setting ia 16 6 2 3 Symbol ASMWatch ASMWatch window 2 Click OK The following table shows information on th
91. a Before starting the test in this example array in the program code must be changed from a local to global variable e Before test First open a workspace and connect the High performance Embedded Workshop to the debugger 1 Create a new project workspace or open an existing project workspace For creation of a project workspace see section 17 1 2 Selecting a debugger 2 Select a session which you wish to use for connection with the debugger from the session list on the Standard toolbar For selection of a session see section 17 1 6 1 Selecting a session After some operations a Confirmation Request dialog box may appear If you have executed build all on the entire program a Confirmation Request dialog box appears by default asking if you wish to download the program To download the program click the Yes button Since the action of clicking on the buttons in this confirmation dialog box cannot be recorded into macros this dialog box will open next time you execute a macro To continue the macro execution you should click one of the buttons The execution must be continued if you are using the test support facility which is used to test a sequence of operations For this reason make the following setting so that the confirmation dialog box will not appear In this example select the Don t ask this question again check box in Confirmation Request dialog box Confirmation Request E x OE to download module C
92. a pointer with a question mark above it Whilst the mouse pointer is in this state click on the part of the dialog that you require assistance on Alternatively select the control for which you require help and press the F1 key REJ10J2000 0100 Rev 1 00 Jun 16 2009 12 RENESAS High performance Embedded Workshop 1 Overview 1 4 Launching the High performance Embedded Workshop To initiate the High performance Embedded Workshop open the Start menu of Windows select Programs select Renesas select High performance Embedded Workshop and then select the shortcut of the High performance Embedded Workshop The Welcome dialog box will be displayed after the start up screen Welcome b Create a new project workspace Cancel f Open a recent project workspace C workspace D emoSH4DemoSh4 hws Administration La Browse to another project workspace WE C Start synchronized session E E Default E If you have recently used a workspace Open a recent project workspace is selected by default Otherwise Create a new project workspace is selected To create a new workspace select the Create a new project workspace button and click the OK button To open one of the recent project workspaces select the Open a recent project workspace button select a workspace from the drop down list and click the OK button The Recent Workspace list displays the same content as that seen in the workspace most recently used File l
93. access by GUI when target is executing l 2i 3 Select Debug gt Debug Settings The Debug Settings dialog box opens Select the Options tab Select the Disable memory access by GUI when target is executing This checkbox is only enabled if the feature is supported by the selected target Selecting a new target will reset this option to the default setting for the target Default for this checkbox depends on the target Click OK It does not completely prevent memory access Operations in which memory accesses are prevented In the following operations handling of memory is disabled or no data will actually be read from or written to memory in the target if attempted Values to be shown are dummy values FF o Viewing tooltip watch information in the Editor or Disassembly window in the source mode o Viewing or modifying the disassembly code in the Editor or Disassembly window in the mixed or disassembly mode o Viewing or modifying the memory values in the Memory IO or MR window Operations in which memory accesses are not prevented Memory accesses are not prevented in the following operations o Executing commands in the Command Line window or command files o Viewing or modifying the memory values in the Watch window with real time update enabled o Viewing the memory values in the Monitor Image or Waveform window with real time update enabled o Viewing or modifying the memory values in the CWatch or ASMWatch
94. as required 4 Click the OK button to add the modified entry back to the list To remove an output file 1 Select the output file that you would like to remove 2 Click the Remove button An output file s path can include placeholders 3 4 3 Dependent Files tab This tab is where you can specify the dependent files that are needed by the phase Before each file is passed into this phase the High performance Embedded Workshop checks that the dependent files are of a more recent date than the input file If so the phase will be executed for that file G e dependent files have been modified since the input files was last modified If not the phase will not be executed REJ10J2000 0100 Rev 1 00 Jun 16 2009 76 RENESAS High performance Embedded Workshop 3 Advanced Build Features Options Output Files Dependent Files Dependent tiles Madii REMOTE To add a dependent file 1 Click the Add button The Add Dependent File dialog box opens 2 Enter the file path or browse to it using the Browse button 3 Click the OK button to add this output file to the list To modify a dependent file 1 Select the dependent file that you would like to modify 2 Click the Modify button The Modify Dependent File dialog box opens 3 Modify the fields as required 4 Click the OK button to add the modified entry back to the list To remove a dependent file 1 Select the dependent file that you would like to remove
95. as the active Debugger This allows you to debug several platforms or several cores on a multi core platform using one High performance Embedded Workshop application High performance Embedded Workshop window title The High performance Embedded Workshop window title will start with the display ID of the current Debugger This will change whenever the active Debugger is changed Switching the active Debugger There are several methods of switching the active Debugger Debuggers tab Right clicking on a Debugger in the tab and selecting Activate will make it the active Debugger Application toolbar When debugging in internal mode an extra drop list is added to the application toolbar This contains the project session combination that describes each synchronized Debugger The active debugger can be changed to a specific Debugger by selecting its session in the drop list Shortcut key combination Pressing the Ctrl Shift N Key combination will change the active Debugger to the next one in the Debuggers tab The Output Window When using Internal mode the Output Window displays a separate Debug tab for each synchronized Debugger Each tab includes the project name and session name of the Debugger it represents so that it can be identified REJ10J2000 0100 Rev 1 00 Jun 16 2009 389 RENESAS High performance Embedded Workshop 18 Synchronized Debugging Ol Of Al t 21 27 a Es Connected hd Build
96. based on the settings made so far are displayed as a list in Step 9 File Name File name To change a file name after selecting the file name by clicking on it enter the new file name Extension File extension Description Description of the file Clicking the Finish button in Step 9 displays the Summary dialog box REJ10J2000 0100 Rev 1 00 Jun 16 2009 270 RENESAS High performance Embedded Workshop Summary Ed Project Summary FPROJECT GENERATOR PAUJECT MAME Tutorial PROJECT DIRECTORY LWorkspace Tutorial Tutorial LPL SERIES SH 4 CPU TPE SH 50 TOOLCHAIN NAME Renesas SuperH RISC engine St TOOLCHAIN VERSION 9 2 0 0 GENERATION FILES Lrorkspace s Tutorial T utonal dbsct c Setting of B A Section CWrorkspace Tutorial T utoraltypedetine h Aliases of Integer Type CAWorkepace s Tutorial T utorialsbrk c Program of brk LWrorkspace Tutorials T utoraliodetine h Definition of 1 0 Register CWrorkspace Tutorial T utoralintprg sre Interrupt Frogram r H J Generate Readme tst as a summary file in the project directory Cancel Click OF to generate the project or Cancel ta abort 17 Debugging Facility 10 The project generator displays information on the project to be generated in the Summary dialog box After confirming the display contents click the OK button Clicking Cancel returns to the New Project wizard dialog box Checking Generate R
97. be nested specifies a range of characters e g a z or 0 9 The beginning character in the range must have a lower ASCII value than the ending character of the range matches a single character if it is not any one of the characters between and This pattern also matches newline characters unless the newline character is included within the brackets Example 1 AEIOU Finds every uppercase vowel Example 2 lt gt Finds a literal lt gt or Example 3 A Za z0 9 Matches an upper or lowercase letter a digit or an underscore Example 4 0 9 Matches any character except a digit Example 5 t n Matches a space a tab or newline Example 6 Matches a literal if is placed after This is the regular expression override character If the character following the backslash is a regular expression character it is treated as a normal character The backslash is ignored if it is followed by a normal non regular expression character Example 1 Searches for every occurrence of an asterisk Example 2 Searches for every occurrence of a backslash REJ10J2000 0100 Rev 1 00 Jun 16 2009 406 RENESAS High performance Embedded Workshop 5 Placeholders 5 Placeholders This section describes how to use the placeholders a feature provided by several of the High performance Embedded Workshop components 5 1 What is a placeholder A placeholder is a special string inserted into text
98. break occurs if the batch file has been executed with the Console tabbed pane open in the Command Line window e If you modify the contents of the batch file after it has been specified the information shown in the upper pane of the Debugger tabbed pane in the Command Line window will be updated The status of the batch file will be reset with all breakpoints deleted REJ10J2000 0100 Rev 1 00 Jun 16 2009 212 RENESAS High performance Embedded Workshop 15 Macro Recording Support Facility 15 Macro Recording Support Facility The macro recording support facility allows you to record operations which are associated with the High performance Embedded Workshop system applications 1 build 2 and debugging 3 as High performance Embedded Workshop command line commands or to execute these recorded commands Files to record the operations High performance Embedded Workshop macro files are command line batch files that have hdc as the extension and can be modified These files are stored in the Macros folder within the High performance Embedded Workshop management information folder under the application data folder for each user profile By default the file Default hdc is created Note however that High performance Embedded Workshop is not capable of recording all operations in the High performance Embedded Workshop system corresponding to the High performance Embedded Workshop command line commands For the operations that c
99. changes made will automatically be picked up by the High performance Embedded Workshop next time the macro is executed 15 8 Assigning a macro It is possible to assign a macro to either a custom menu option toolbar or keyboard shortcut This allows you to quickly access macros which you often use It is possible to assign a single macro to a Tools menu Macros toolbar and keyboard shortcut all at the same time if you want A custom menu and a toolbar button are shown in alphabetical order To assign a macro to a toolbar button L PAOA eS N Select Tools gt Macros The Macro dialog box opens Select the macro file which contains the function you want to assign Select the macro function in the Macro functions list that you want to assign Click the Assign button The Macro assign dialog box is displayed Select the Assign to Toolbar check box You can now modify the macro description in the Description field This will be used as the toolbar tool tip if you assign the macro to a toolbar button Now you can decide whether you will use the default macro toolbar button or specify your own toolbar button image from an existing bitmap file bmp To specify your own image simply click the browse button to open a standard file browser This will allow you to manually locate the file on your machine Click OK and the toolbar is added to the Macros toolbar To assign a macro to a menu L ae Se a Select Too
100. commands In the Custom Commands tab of the Version Control Setup dialog box you can add a menu defining a Visual SourceSafe command not included in the version control submenu Selecting this menu executes the defined command Output information on execution of this command will be shown in the Version Control tab of the Output window This section introduces the definition of Properties command as an example Custom Commands Mappings General Commands dd Madii Remove TLE Move up hare down Command Execution M Prompt before executing command T Run in DOS Window e Execution control of version control commands 1 Select the Prompt before executing command checkbox 2 Deselect the Run in DOS Window checkbox This is because the RCS commands must be input via the MS DOS prompt 3 Select the User forward slash as version control directory delimiter checkbox Visual SourceSafe uses this format For detail see section 8 9 Controlling execution of a Version Control System e Setting up commands 1 Click the Add button The Add Menu Option dialog box appears 2 Enter Properties in Option and click the Add button The Add Command dialog box appears REJ10J2000 0100 Rev 1 00 Jun 16 2009 169 RENESAS High performance Embedded Workshop 9 Visual SourceSafe Version Control System 4dd Command Command Version control executable E S Program Files Microsoft Visual Studiow S S win
101. contents of the Command Line window Selecting Clear window from the pop up menu of the Command Line window clears all of the information shown in the Console tabbed pane and in the upper pane of the Debugger tabbed pane of the Command Line window 14 14 Undoing the last operation Choose Undo from the pop up menu to undo the last operation at the latest cursor position on the text currently being input 14 15 Checking brace matching While the Brackets Opened Indicator toolbar button is displayed users can see if brackets match The button cannot be operated Once an opening bracket or is input and the nesting follows the Brackets Opened Indicator toolbar button is visible a until or is input as the closing bracket Example of a TCL Function Input in the State Toolbar Button is Visible Command Line Window gt set bit 1 None eo 1 None eal gt set value 1 None R 1 None a gt set r 1 None E 1 None T gt if bit amp value Opening brace is input T gt setr O r None al gt else Opening and closing braces are input H gt setr1 r None al gt Closing brace is input fa gt None T 14 16 Resetting the status of a batch file The status of a batch file can be reset on the Debugger tabbed pane of the Command Line window This feature is not available when no batch file has been specified A reset involves the following operations e The yellow arrow returns to the top of the batch
102. cursor location X Displays the Y coordinate of cursor location displays Y coordinate for both the upper and lower plots when Stereo is selected 17 6 Looking at I O memory As well as a CPU and ROM RAM a micro controller also contains on chip peripheral modules The exact number and type of peripheral modules differ between devices but typical modules are DMA controllers serial communications interfaces A D converters integrated timer units a bus state controller and a watchdog timer Accessing registers which are mapped to the micro controller s address space programs the on chip peripherals Since the setting up and use of these on chip peripheral registers is usually very important in an embedded micro controller application it is useful to be able to look clearly at the contents of these registers The Memory view only allows you to look at data in memory as byte word long word single precision floating point double precision floating point or ASCII values so the High performance Embedded Workshop also provides an IO window to ease the inspection and setting up of these registers REJ10J2000 0100 Rev 1 00 Jun 16 2009 334 RENESAS High performance Embedded Workshop 17 Debugging Facility 17 6 1 Opening the IO window To open the IO window choose View gt CPU gt IO or click the View IO toolbar button Bel Modules that match the on chip peripheral modules organize the I O register information The IO window h
103. debugger to integrate with High performance Embedded Workshop The following details the information required to setup an external debugger which is not Hitachi Debugging Interface or the PD debugger to integrate with High performance Embedded Workshop and launch from the external debugger option in High performance Embedded Workshop External debugger selected Other external debugger Debugger settings External debugger location P Browse Command line options Po Download module P Browse REJ10J2000 0100 Rev 1 00 Jun 16 2009 356 RENESAS High performance Embedded Workshop 17 Debugging Facility To configure an external debugger to integrate with High performance Embedded Workshop 1 Firstly the location of the debugger executable must be specified This may have been configured by the installation program or a project generation utility 2 The second item of data is the command line options This field allows additional options to be specified which can modify the behavior of the external debugger 3 Finally the location of the download module is required This allows the High performance Embedded Workshop to automatically switch to the debugger when the download module changes after a build 17 18 Debugging functions dependent on the debugger The debugging functions listed in this section are not common to all High performance Embedded Workshop products included in tool packages User
104. decimal numbers Height Pixel Specifies the height of the image unless a prefix is included values are treated as decimal numbers Buffer Size Hex Displays the size of the buffer required for image display as obtained from the width and height in hexadecimal notation Specifies the redraw continuously function has been enabled Specifies the number of frames to be redrawn image continuously Frame Count Buffer Full Size Hex Specifies the number of frames 2 or more Displays the size of the buffer required for images display as obtained from the width and height and the number of frames in hexadecimal notation Specifies whether display is on all or part of the screen in hexadecimal notation valid when 8Bit has been selected for RGB or BGR View Mode Start Position Position Specifies the entire part to be displayed in the image Full Size Part Size Specifies where the display of data is to start Top Bottom The image is displayed on the whole screen The image is displayed on part of the screen Display of data starts at the upper left position Display of data starts at the lower left position Specifies the start position of the image where part of the image is to be displayed Valid when Part Size is selected X Position Specifies the X coordinate of the start position unless a prefix is included values are treated as decimal numbers Y Position Specifies the Y coordinat
105. displays a pop up menu containing available options A basic operation is allocated to the toolbar The Toolbar display and Customize toolbar options are also included in the pop up menu opened by right clicking on the toolbar Pop up Menu Option Toolbar Button Macro Recording Function Set Batch File BAL Specifies a batch file Play Plays the current batch file Stop Stops execution of the current batch file Reset Resets the status of a batch file REJ10J2000 0100 Rev 1 00 Jun 16 2009 206 RENESAS High performance Embedded Workshop 14 Command Line Step p Single steps in a batch file Insert Remove Breakpoint Toggles a break point on the current line of a batch file Enable Disable Breakpoint Enables or disables the current breakpoint on the current line of a batch file Clear All Breakpoints Removes all breakpoints of a batch file Set Log File tod Specifies a log file Logging j Starts or stops output to log file Toolbar display Shows or hides the toolbar Customize toolbar Customizes toolbar buttons o Lower pane results of command execution Right clicking displays a pop up menu containing available options A basic operation is allocated to the toolbar The Toolbar display and Customize toolbar options are also included in the pop up menu opened by right clicking on the toolbar Pop up Menu Option Toolbar Button Macro Recording Function Clear Window af Clears the contents
106. down Move cursor up in the editor Move cursor down in the editor Move cursor left in the editor Move cursor right in the editor Select column in the editor Support for this function depends on the debugger REJ10J2000 0100 Rev 1 00 Jun 16 2009 414 RENESAS High performance Embedded Workshop 9 Drag and Drop in the Debugger 9 Drag and Drop in the Debugger When using the High performance Embedded Workshop debugger it is possible for each debug component to interact with the others This can be achieved simply by dragging objects from one view to another Some examples are listed below 1 Itis possible to drag a label from the labels view onto other debug views So for example if you drag a label onto the disassembly window it will scroll to the address that the label is located at 2 Itis possible to drag a watch variable from the editor into the watch window This adds the watch variable to the window 3 Dragging a function name from the editor into the disassembly should jump the disassembly view to the label location REJ10J2000 0100 Rev 1 00 Jun 16 2009 415 RENESAS High performance Embedded Workshop 10 Using Labels to View Your Code 10 Using Labels to View Your Code Labels are a useful way of navigating through your debug module It is possible to use labels in any edit field that allows addresses If you enter a label in such a field then the built in evaluator will check the label and then convert
107. even though these windows are not included in the list of menus For details see section 16 6 2 Functions that can be saved into test image files dependent on the debugger 3 Support for this function depends on the debugger 4 The data of the Build tab or the Debug can be saved 1 4 Project Menu Options Menu Menu Option Shortcut Key Toolbar Button Macro Recording 1 Function Project Set Current Project E a D Sets this project as the current project Insert Project w Inserts a project to the workspace Dependent Projects Shows dependent projects Edit Project Configuration 2 Edits the project configuration Create Project Type E Creates a new project type Add Files Adds files to project Remove Files Removes files from project File Extensions Displays current project file extensions Components Loads unloads components 1 Operations with some menu options can be recorded as High performance Embedded Workshop command line commands by the macro recording support facility A macro record icon in the Macro Recording column of a menu option indicates that this function can be recorded into a macro file For details see section 15 5 1 Recordable functions common to all High performance Embedded Workshop products 2 Support for this function depends on the debugger 1 5 Build Menu Options Menu Menu Option Shortcut Key Toolbar Button Macro Recording 1 Function Build 2 Toolc
108. facility View Logs Use the log command to view the changes 1 Select the file rcs_sample c in the Projects tab of the workspace window and select Tools gt Version Control gt Log 2 The MS DOS command prompt window appears and shows the log information Enter exit and press the Enter key This closes the MS DOS command prompt window 8 11 2 Connecting the High performance Embedded Workshop with CVS In this example the High performance Embedded Workshop is to be connected with CVS e CVS tool environment The following type of version control system can be used o CVS This procedure assumes that the version control system is located at C cvs 1 11 17 e Workspace Create a High performance Embedded Workshop workspace in the following folder C WorkSpace sampleCVS Then create a folder for CVS C src sampleC VS Note In this version control using the High performance Embedded Workshop and CVS only versions of source files can be controlled It cannot control versions of any other files such as workspace or project files The following pages describe the procedures to create a workspace make settings for version control create a repository register a module check out check the status compare register the result and view logs Step 1 Create a workspace Step 2 Selecting Custom Version Control System Step 3 Making settings for Version Control Step 4 Using the Version Control facility Create a R
109. file e The command interactive mode is exit e Ifa closing parenthesis is missing it will automatically be entered To reset the status of a batch file 1 Open the Debugger tabbed pane of the Command Line window 2 Right click on the upper pane to open the pop up menu 3 Select Reset REJ10J2000 0100 Rev 1 00 Jun 16 2009 210 RENESAS High performance Embedded Workshop 14 Command Line Notes e Information such as the name of the batch file and breakpoints in the batch file is saved in the session If you change the session on the Debugger tabbed pane of the Command Line window the pane now shows the contents of the batch file specified for the current session The status of the batch file is also automatically reset even in cases where the batch file includes any of the following commands o Setting the current project CHANGE_PROJECT o Selecting a session CHANGE_SESSION e If you change the configuration the status of the batch file is also automatically reset even in cases where the batch file includes the following command o Selecting a build configuration CHANGE_CONFIGURATION 14 17 Single stepping in a batch file Single stepping of command lines starting from the top of the batch file is possible on the Debugger tabbed pane of the Command Line window This feature is not available when no batch file has been specified Command Line C forkspace Command hdc no log file ES Toolbar I Contents
110. file selected in File name and those to be recorded contained in the sheet selected in Recording Sheet do not match or the radixes are different Once recording is started the values of variables are recorded into the file when Values are automatically updated in real time during execution Values are updated with the stop of execution Values are changed Display is refreshed by an operation in the window To stop recording the history of automatically updated values L 2 Right click within the window to open a pop up menu Select Record Update Value and then Stop Recording from submenus Recording is automatically stopped when A program is downloaded or unloaded Expansion of watched items to be recorded is collapsed The radix for watched items to be recorded is changed A new item to be watched is added to the sheet selected for recording The order of watched items to be recorded is changed Automatic update of watched items to be recorded is canceled REJ10J2000 0100 Rev 1 00 Jun 16 2009 374 RENESAS High performance Embedded Workshop 17 Debugging Facility 14 Changing text colors You can customize the font and text coloring for the Watch window through the Format Views dialog box the Text category in the table below It is also possible to use the Format Views dialog box to specify the color for memory with a specific attribute or changed values shown in the Value column of the Watch window To change
111. files Library files 2 5 1 Associating an application with a file group In addition to opening a file with the editor the File Extensions dialog box allows you to associate any application with any file group so that when you double click on a file in the Projects tab of the Workspace window the appropriate application is launched with the file REJ10J2000 0100 Rev 1 00 Jun 16 2009 45 RENESAS High performance Embedded Workshop File Extensions Ipp cpp L cpu wW doc B exp B hex ee E lib Ibp map X fay B obj Test editor Word processor Librarian No application To associate an application with a file group 2 Build Basics Tour 2 G list file C source file Cancel CPU information file Add Documents o Add Expanded assembly source file neee Hex file Library file pen ith Library information file Linkage map file Linkage symbol file Object file in 1 Select Project gt File Extensions The File Extensions dialog box opens 2 Select the file group that you want to associate from the file extensions list 3 Click the Open with button The Modify File Extension dialog box opens Modify File Extension File group Linkage map tile Cancel Associated application pen Linkage map file with i dd oa iti Remove 4 Select None to remove any association Editor to open this type of file in the internal external edito
112. find the right menu option if you want to set up a tool then the Tools menu is the correct selection File Edit View Project Build Debug Setup Tools Test Window Help Note If you use a debug only project Debugger only xxxxxx created by High performance Embedded Workshop V 4 01 or a later version the Build menu will not be displayed by default The Build menu is displayed however if the debug only project Debugger only xxxxxx has been created by High performance Embedded Workshop earlier than V 4 01 REJ10J2000 0100 Rev 1 00 Jun 16 2009 2 RENESAS High performance Embedded Workshop 1 Overview 1 2 3 Toolbars The toolbars provide a shortcut to the options that you will use the most often There are twelve default toolbars Editor Search Templates Bookmarks Default Window Standard Version Control Map Macros Debug Debug Run and System Tools as shown in the figures below With the default session the High performance Embedded Workshop does not initially display buttons of Version Control and peripheral functions on the toolbar If you use a debug only project Debugger only xxxxxx created by High performance Embedded Workshop V 4 01 or a later version Editor Search Templates Bookmarks Default Window and Standard will not be displayed by default Toolbars can be created modified and removed via Tools gt Customize see section 6 1 Customizing the toolbars for further information Editor
113. for the new tab settings to take effect Auto indentation When you press Enter the editor the insertion cursor will move to the next line down at the first column i e against the left hand side of the window Auto Indentation is a feature which when RETURN is pressed places the insertion cursor on the next line as before but under the first non whitespace character of the previous line This enables you to type neat C C or assembler code faster as you don t have to type leading spaces or tabs yourself The figure below illustrates two examples The first shows the effect of pressing Enter when the Auto Indentation feature is disabled the insertion cursor returns to the left hand side of the window on the next line When the int z 20 line is typed it is not aligned with the previous two lines The second example shows the effect of pressing Enter when Auto Indentation is enabled the insertion cursor drops underneath the i of the int word on the previous line Now when the int z 20 line is typed it is automatically aligned i e automatically indented void myFunction void Fold myFunction void ae TEE int int int y int int z 70 int zZ aie ab 20 i Auto Indentation Disabled ft Auto Indentation Enabled To enable disable Auto Indentation L 2 3 4 4 8 Select Setup gt Options The Options dialog box opens Select the Editor tab Set the Enable a
114. hwp ode mode ma H defaultsessionhst c demo demo M simsessionsh 3 c demo demo To recover the files check the checkbox alongside the filenames you wish to recover and click OK Clicking Cancel will discard the auto recovery files and load from the original files 6 8 8 Setting the projects to load on workspace open You can configure which projects are initially loaded on workspace open This is an application wide setting which is only relevant to workspaces that contain multiple projects To change the projects to load on workspace open 1 Select Setup gt Options The Options dialog box opens 2 Click the Workspace tab Project load on workspace oper Last Used current project Last loaded 3 To determine the action when a workspace is opened change the Project load on workspace open drop list to one of the following options e Last used current project Only the current project when you last closed the workspace will be loaded e All projects All projects belonging to the open workspace will be loaded e Last loaded projects Any project which was loaded when you last closed the workspace will be loaded 4 Click the OK button 6 8 9 Specifying a default directory for new workspaces When a new workspace is created the High performance Embedded Workshop invokes the New Project Workspace dialog box One of the fields on this dialog is the directory in which the new workspace will be created By defau
115. in the Define Commands dialog box You can define as many commands as you want to and specify the order in which they execute Existing commands can be modified or removed To define a new version control command 1 Click the Add button on the Define Commands dialog box The Add Command dialog box opens Add Command Ei Command Version control executable Vises WINNT Ss exe Browse Cancel Arguments History SCVODIRG CFILENAME YSCUSERNAME P gt Initial directory S FILEDIRS gt Browse Executable retum code Return code of executable is not meaningful C Command has failed if the return code is Not Equal To fo 2 Enter the full path of the command into the Version control executable field or browse to it graphically by clicking the Browse button 3 Enter the arguments for the command into the Arguments field Enter into Initial directory the directory from which you would like to run the executable or browse to it graphically by clicking Browse In most cases this should be set to the FILEDIR placeholder which means that the command should be executed from the same directory as the file Set the Executable return code options as appropriate see section 8 5 Executable return code 6 Click the OK button to define the new command To modify a version control command 1 Select the command to be modified from the Commands list of the Define Commands dialog box 2 Cl
116. invoked click the Keyboard tab Keyboard Default keyboard layout i Reset High performance Embedded Workshop default Category Assign Commands Current keyboard shortcut Remove Hew Upen Close Mew Workspace Mone Import Hew keyboard shortcut Export Save Workspace Close Workspace Mew Session Upen Workspace di Mone ey curently assigned to Import Session C ee Pl Description This dialog box allows instant selection of either the default High performance Embedded Workshop keyboard shortcuts or the PD debugger shortcuts To change the entire keyboard layout select an item in the Default keyboard layout drop down list By default it uses the High performance Embedded Workshop settings A number of operations are possible on this dialog box REJ10J2000 0100 Rev 1 00 Jun 16 2009 124 RENESAS High performance Embedded Workshop 6 Customizing the Environment To add a new Keyboard shortcut 1 Select the main menu category of the command you wish to modify It is only possible to modify the commands that have a menu Only some cases are special that allow modification these are named global 2 Select the command you wish to modify or add a new keyboard shortcut for in the Commands list The current shortcut is displayed in the Current keyboard shortcut field 3 Enter the new shortcut in the New keyboard shortcut field
117. it to an address This allows you to enter evaluations such as _main 100 or _MyFunction 100 This means that any times that labels are used the addresses which will be evaluated are not fixed This is especially useful if you are using a command line batch file to set a number of breakpoints The command line batch file might always need to set a breakpoint on a certain function and this can be achieved by using a label Using the label allows the code to change without affecting the batch file contents High performance Embedded Workshop V 3 1 onwards also supports a number of easy ways to use label completion Display Address Ei EI Address Lair al man _ sort OOOOO000 FFFFFFFF The dialog box above also shows an example of a label pick list This store the last twenty entries made into address fields throughout the entire High performance Embedded Workshop application This means if you are entering a label multiple times it should be much faster and efficient if you use this recently used address field list This control is available for all instances of the address edit field where the input is evaluated There is the browse button Zl right next to the edit field where an address can be entered If you click this button the Select Label dialog box will be displayed A label can be selected from the current list of labels in this dialog box REJ10J2000 0100 Rev 1 00 Jun 16 2009 416 RENESAS High performance Embedd
118. it is created you can insert new or existing projects into the workspace REJ10J2000 0100 Rev 1 00 Jun 16 2009 61 RENESAS High performance Embedded Workshop 2 Build Basics To insert a new project into the workspace Select Project gt Insert Project The Insert Project dialog box opens Select the New project radio button Click the OK button The Insert New Project dialog box opens at Enter the name of the new workspace into the Project Name field This can be up to 32 characters in length and contain letters numbers and the underscore character Especially do not use a minus sign or a space As you enter the project name the High performance Embedded Workshop will add a sub directory for you automatically This can be deleted if desired 5 Use the Browse button to graphically select the directory in which you would like to create the project Alternatively you can type the directory into the Directory field manually 6 The project type list displays all of the available project types e g Application Library etc Select the type of project that you want to create from this list 7 Click the OK button to create the project and insert it into the workspace To insert an existing project into a workspace f Existing project Browse Select Project gt Insert Project The Insert Project dialog box opens Select the Existing project radio button Click the Browse button to search for the project da
119. look at memory areas in the CPU s address space How to look at a memory area in different formats how to fill and move a memory block and how to load and verify a memory area with a disk file are described 17 3 1 Opening the Memory window The Memory window displays the contents of contiguous memory areas To open the Memory window choose View gt CPU gt Memory or click the Memory toolbar button i You can specify the display start address and the scroll range at opening The Display Address dialog box opens Enter the Display Address Scroll Start Address and Scroll End Address Display Address Ei Display Address ooo0o000 a Scroll Start Address Jooooo000 a Scroll End Address FFFFFFFF Fl Cancel Click the OK button or press the Enter key and the dialog box closes and the Memory window opens The display can be scrolled within the range of the entered display scroll start and end addresses REJ10J2000 0100 Rev 1 00 Jun 16 2009 309 RENESAS High performance Embedded Workshop 17 Debugging Facility Window configuration Memory 000000 x Toolbar poms 15 10210 38 lobe 4 dh de de oe a 26 32 TR Bddres Label Register 0 1 2 2 4 5 6 T 8 E ta zE FE n a p aser WLan FE ZE 1 00 OO Of OO OO oo 0D ere eee nooo 10 noo oo OO Of OO Of OO OO Of DOO Of OO lll apige no of OO Of OO Of OO OO Of DOO Of OO OO ltl
120. macro is being recorded the following operation will be recorded into a macro file Display Mode Target Operation Function Source mode Instant Watch pop up menu Make setting in the dialog box opened by clicking Adds a symbol option on the menu option e E8 emulator software V 2 10 Release 00 and later e E8a emulator software e E10A USB emulator software V 2 13 Release 00 and later H8SX Device group Target Operation Function Event Breakpoints column Double click on the column Sets or clears a hardware breakpoint 15 5 2 3 Label window While a macro is being recorded the following operations will be recorded into a macro file Target Operation Function Add pop up menu option toolbar button Make setting in the dialog box opened by Defines a symbol clicking on the menu option or toolbar button Delete pop up menu option toolbar button Click on the menu option or toolbar button Deletes a symbol Delete All pop up menu option toolbar button Deletes all symbols Load pop up menu option toolbar button Make setting in the dialog box opened by Defines symbols clicking on the menu option or toolbar button BP column Double click on the column Sets or clears a software breakpoint 15 5 2 4 Watch window While a macro is being recorded the following operations will be recorded into a macro file Target Operation Function Auto Update pop up menu option toolbar button Click on the menu option or toolbar button Sets real time check of a symbol
121. menu Display Address kl x Address ooooo000 al mea REJ10J2000 0100 Rev 1 00 Jun 16 2009 316 RENESAS High performance Embedded Workshop 17 Debugging Facility Specify the displaying address in the Address field Drag and Drop Manipulation Operation Select address on Memory Window s Address area and drop it into Changes the window s display start address to that address another Memory Window s Address column Select variable name text string and drop it into Memory Window s Changes the window s display start address to that address Address column 17 3 11 Changing the scroll area Select Scroll Area from the pop up menu of the memory window The Scroll Area dialog box opens Scroll Area ki Start Address ooo000 al End Address JOFFFFF al rea Specify the scroll range to be displayed By default the scroll range is set to O to the maximum address of MCU 17 3 12 Starting address to value of the register Select the register from the followings in the pop up menu Register of the memory window Support for this function depends on the debugger 17 3 13 Tracking the stack pointer position The memory window has a function that alters the display address while tracking the stack pointer position By default the display does not track the stack pointer position To track the stack pointer position choose Followed Stack Pointer from the pop up menu of the memory window The Followed Stack Pointe
122. menu option toolbar button Sets radix for octal for this value Radix gt Binary pop up menu option toolbar button Sets radix for binary for this value or sign Click on the sign Expands or collapses a symbol Watch item name Make setting in the dialog box opened by Deletes and adds a symbol double clicking a value Value In place edit Edits the value of a symbol Make setting in the dialog box opened by double clicking a value 15 5 2 5 Local window While a macro is being recorded the following operations will be recorded into a macro file Target Operation Function Edit pop up menu option toolbar button Make setting in the dialog box opened by clicking on the menu option Changes a local or toolbar button item s value Value Make setting in the dialog box opened by double clicking on a value In place edit 15 5 2 6 Simulated I O window While a macro is being recorded the following operation will be recorded into a macro file Target Operation Function Erase All pop up menu option toolbar Click on the menu option or toolbar button Clears the contents of the Simulated I O button window 15 5 2 7 ASMWatch window While a macro is being recorded the following operations will be recorded into a macro file Target Operation Function Set pop up menu option toolbar button Make setting in the dialog box opened by clicking on the Sets new data to selected menu option or toolbar button watch point Value Make setting in the dial
123. nu stinglEL Performs string manipule Enable all Disable all lt Back net gt Finish Cancel 4 Specify the configuration of the standard libraries used by the C C compiler in Step 4 The functions defined in the checked items and the runtime functions are included REJ10J2000 0100 Rev 1 00 Jun 16 2009 265 RENESAS High performance Embedded Workshop 17 Debugging Facility Enable all Selects all standard library functions Disable all Does not select all standard library functions Note that only the minimum required functions runtime and new are selected To move to Step 5 click the Next gt button in Step 4 Hew Project 5 9 Setting the Stack Area ki Ed What are the stack settings Stack Pointer Address power on reset Stack Size H an lt Back Next gt Finish Cancel 5 Specify the stack area in Step 5 This is done by setting the initial value of the stack pointer and the stack size The initial value of the stack areas depends on the CPU selected in Step 1 Note The stack area is defined by stacksct h which is generated by the High performance Embedded Workshop If stacksct h has been modified by an editor it cannot be modified from Project gt Edit Project Configuration in the High performance Embedded Workshop To move to Step 6 click the Next gt button in Step 5 REJ10J2000 0100 Rev 1 00 Jun 16 2009 266 RENESAS High performance Embedded
124. of the Chal 4 aa batch file es ee l command Line number allresert n ere 3 atep be executed 4 step oS step Breakpoint column Line number 4 H column gt command Yreset ee ee atep eee Step complete at AQQOOUDZ execution gt ENS Console Debugger To single step in a batch file 1 Open the Debugger tabbed pane of the Command Line window 2 Perform one of the following operations in the upper pane e Click on the Step toolbar button F e Right click within the pane to open the pop up menu and select Step e With a focus in the pane press the Ctrl F10 keys The yellow arrow 5 gt moves to the next command line If some errors have occurred however the arrow does not move to the next line Note If the batch file includes the commands listed below debugging of the batch file on the Debugger tabbed pane of the Command Line window cannot proceed Instead use the Console tabbed pane of the Command Line window to execute the batch file REJ10J2000 0100 Rev 1 00 Jun 16 2009 211 RENESAS High performance Embedded Workshop 14 Command Line e CLOSE WORKSPACE When a command is run the batch file will be closed e CHANGE_PROJECT or CHANGE_SESSION When a command is run the contents of the batch file specified for the current session will be shown in the pane e CHANGE_CONFIGURATION When a command is run the status of the batch file will automatically be reset 14 18 Setting a brea
125. of the Command Line window 14 2 Specifying a batch file It is useful to use a batch file when a series of predefined command lines need to be executed Create a batch file by a text editor and write necessary command lines The default extension of a batch file is hdc Choose Set Batch File from the pop up menu to open the Set Batch File dialog box in which the name of a batch file hdc can be specified Clicking the OK button displays the specified batch file name as the window title Clicking the Cancel button closes the dialog box without modifying the setting Batch File gt Browse After a batch file has been specified the upper pane of the Debugger tabbed pane in the Command Line window shows the contents of the batch file When saving the session the batch file name will also be saved Notes e The batch file is automatically closed if any of the GUI features or command listed below is run The information shown in the upper pane of the Debugger tabbed pane is cleared o Closing a workspace CLOSE_WORKSPACE o Creating anew workspace o Inserting a project into the workspace o Adding a session e If you modify the contents of the batch file after it has been specified the information shown in the upper pane of the Debugger tabbed pane in the Command Line window will be updated The status of the batch file will be reset with all breakpoints deleted REJ10J2000 0100 Rev 1 00 Jun 16 2009 207 RENESAS
126. of type HEW Registration Files hrf Cancel we REJ10J2000 0100 Rev 1 00 Jun 16 2009 420 RENESAS High performance Embedded Workshop 13 HMAKE User Guide 13 HMAKE User Guide 13 1 Command line The following section describes the command line that should be used to execute the hmake program on a file using none or more of the available options Basic structure The command line must be of the following syntax hmake lt make file you wish to execute gt lt parameter list gt If a file is specified without an extension then mak will be appended to it The parameter list may include none or more of the parameters listed in the following section The parameters list may appear before the make file name if you wish Each parameter must be separated by at least one white space character Parameters are not case sensitive If no parameters are given and no file is given then help information will be displayed Exit codes If there are any syntax errors in the make file being executed or if any process executed whilst running the make file returns an invalid error code then hmake will exit with code 1 Otherwise hmake will exit with code O See below for file syntax and how to specify exit code conditions Parameters The following table shows the available parameters and their function Parameter Function A Execute all commands regardless of input output file status Equivalent to a Build All N Use status o
127. on the menu option or toolbar button e De allocates code coverage memory 15 5 2 15 Data Coverage window While a macro is being recorded the following operation will be recorded into a macro file Target Operation Function Hardware Settings pop up menu Make setting in the dialog box opened by e Allocates data coverage memory option toolbar button clicking on the menu option or toolbar button e De allocates data coverage memory 15 5 2 16 Hardware Break dialog box While a macro is being recorded the following operation will be recorded into a macro file Target Operation Function Apply button Click on the button Changes the hardware break conditions REJ10J2000 0100 Rev 1 00 Jun 16 2009 226 RENESAS High performance Embedded Workshop 15 Macro Recording Support Facility 15 5 2 17 Trace conditions dialog box While a macro is being recorded the following operation will be recorded into a macro file Target Operation Function Apply button Click on the button Changes the trace conditions 15 5 2 18 Violation of access protection dialog box While a macro is being recorded the following operation will be recorded into a macro file Target Operation Function OK button Click on the button Sets the access violation area 15 5 2 19 Uninitialized area detection dialog box While a macro is being recorded the following operation will be recorded into a macro file Target Operation Function OK button Click on the button Sets th
128. or open the Find dialog box CTRL F4 Close the editor window CTRL F6 Switch windows in the editor CTRL F7 Build an individual file CTRL F9 Enable or disable a breakpoint on the current line CTRL SPACEBAR Re shown list members as a pop up window in the editor CTRL BACKSPACE Delete current word CTRL BREAK Stop tool execution CTRL INSERT Copy the selection to the clipboard CTRL TAB Switch windows in the editor CTRL HOME Return the cursor in the editor to the beginning of the current file CTRL END Send the cursor in the editor to the end of the current file CTRL UP ARROW Scroll window up and leave the cursor in the same place in the editor CTRL DOWN ARROW Scroll window down and leave the cursor in the same place in the editor CTRL LEFT ARROW Move the cursor to the previous word in the editor CTRL RIGHT ARROW Move the cursor to the next word in the editor CTRL ALT 1 4 Switch virtual desktop CTRL ALT PAGE UP Move to next tab For example the output or workspace window CTRL ALT PAGE DOWN Move to previous tab For example the output or workspace window CTRL SHIFT 8 Show white space and tab characters in the editor CTRL SHIFT G Open the Image window CTRL SHIFT K Open TCL toolkit CTRL SHIFT L Line deletion in editor CTRL SHIFT M Find a matching brace REJ10J2000 0100 Rev 1 00 Jun 16 2009 413 RENESAS High performance Embedded Workshop CTRL SHIFT CTRL SHIFT CTRL SHIFT CTRL SHIFT CTRL SHIFT CTRL SHIFT CTRL
129. or the default High performance Embedded Workshop macro function icon Once added the associated macros appear to the right of the standard macro buttons Clicking these buttons then automatically launches the associated macro function Play Macro Pause Macro User defined Record Macro Stop Macro betalt omol1 2 15 2 Using the Macro dialog box The Macro dialog box allows you to access and manager the macro files currently in use in the High performance Embedded Workshop system The Macro dialog box is shown below REJ10J2000 0100 Rev 1 00 Jun 16 2009 214 RENESAS High performance Embedded Workshop 15 Macro Recording Support Facility Curent macro file Dett OOO Macro functions Import Record Elay Edit Assam Remove F Show all available macro functions Initial directory SIFILEDIF Browse The Current macro file drop down list holds all of the macro files currently in use in the High performance Embedded Workshop system These files are stored in the Macros folder within the High performance Embedded Workshop management information folder under the application data folder for each user profile Any files that are copied into this directory are automatically added to the Current macro file drop down list The macros functions in the Current macro file selection are shown in the Macro functions list box Changing the Current macro file selection will automatically
130. pop up menu will allow the window contents to be refreshed while the user program is running To specify the refresh interval select Update Interval from the pop up menu This item is only selectable when it is supported by the debugger 17 4 3 Refreshing the Image window Selecting Refresh Now from the pop up menu immediately refreshes the window contents 17 4 4 Specifying the refresh interval You can specify the interval to refresh the Image window while the user program is running Support for this function depends on the debugger To specify the refresh interval 1 Right click within the window to open a pop up menu 2 Select Update Interval The Update Interval dialog box opens Update Interval ki x Interval 10 10000meec 1Omeec unit ULI 1000 MEC Cancel 3 Specify the refresh interval in 10 ms units The refresh interval is specifiable in the range from 10 to 10000 ms and the default value is 1000 ms The specified refresh interval is applied to all Image windows The actual refresh interval may be longer than the specified value depending on the state of execution REJ10J2000 0100 Rev 1 00 Jun 16 2009 327 RENESAS High performance Embedded Workshop 17 Debugging Facility 17 4 5 Viewing Images as Consecutive Frames The Image window can also show images as consecutive frames This allows you to view multiple images easily because it is not necessary to set addresses for all images After i
131. printt Sorting results cori 1 0 iflU i jf printt altd sld n 1 4 uin alO max ilong 0 70000000 mirn max change al 17 18 3 2 Instant watch Display the source file containing the variable that you want to examine on the editor window or disassemble window in source mode Rest the mouse cursor over the variable name that you want to examine and choose Instant Watch from the pop up menu the Instant Watch dialog box will appear and display the variable at the cursor location Instant Watch a 73FFFFB0 long 0 shown to the left of the variable name indicates that the information may be expanded by clicking on the variable name and indicates that the information may be collapsed Clicking Add registers the variable in the Watch window Clicking Close closes the window without registering the variable in the Watch window 17 18 3 3 Watch window The High performance Embedded Workshop allows you to open Watch windows which contain a list of variables and their values 1 Opening the Watch window To open a Watch window choose View gt Symbol gt Watch or click on the Watch toolbar button Al if it is visible A Watch window opens REJ10J2000 0100 Rev 1 00 Jun 16 2009 365 RENESAS High performance Embedded Workshop 17 Debugging Facility Window configuration R R e y Thx ee P e oe Toolbar utateh Watch Iten 1 7F000000 lo
132. project in the Projects tab of the Workspace window Visual SourceSafe is not necessarily controlling them Some of the files that are being controlled by Visual SourceSafe will be checked in and others will be checked out 1 e being edited by a user The Get VCS status command displays the current status of files The status of each file will be displayed in the Version Control tab of the output window or the File s Status dialog box For setting of location where the status is to be displayed see section 9 3 Visual SourceSafe command options To view the status of files in Visual SourceSafe 1 Select the files whose status you would like to view in the Projects tab of the workspace window You may also select a file folder project folder workspace folder or combination thereof 2 Select one of the following operations e Click the Get VCS status toolbar button 8 OR e Select Tools gt Version Control gt Get VCS status OR e Right click to invoke a pop up menu and select Version Control gt Get VCS status 3 The Version Control tab of the output window or the File s Status dialog box shows the status of files 9 2 7 Undoing a check out command in Visual SourceSafe Visual SourceSafe protects your source files and ensures that only one user can have a writable copy of a controlled file at any one time The check out operation takes a writable copy of the file from Visual SourceSafe and places it on your local driv
133. sampleCVS in Initial directory Add Command ki Command Version control executable C sows 1 11 1 cvs exe Browse Cancel Arguments j cc lrmlLrLLLCUC Initial directory C Aero sampleC S gt Browse Executable retum code Return code of executable is not meaningful Command has failed if the return code is Not Equal To lo REJ10J2000 0100 Rev 1 00 Jun 16 2009 153 RENESAS High performance Embedded Workshop 9 Click the OK button 10 Click the OK button in the Add Menu Option dialog box 8 Custom Version Control System Also set up the following six commands in the same way Command Option Name Characters to be Input Register Version control executable C cvs 1 11 17 cvs exe Argument import m New Source sampleCVS Renesas rel 20060228 Initial directory C src sampleCVS Check out Version control executable C cvs 1 11 17 cvs exe Argument checkout sampleCVS Initial directory C src Status Version control executable C cvs 1 11 17 cvs exe Argument status FILENAME Initial directory C src sampleCVS Diff Version control executable C cvs 1 11 17 cvs exe Argument diff FILENAME Initial directory C src sampleCVS Commit Version control executable C cvs 1 11 17 cvs exe Argument commit m modify FILENAME Initial directory C src sampleCVS Log Version control executable C cvs 1 11 17 cvs exe Argument log FILENAME Initial directory C src sampleCVS Preparation
134. source codes in source mode click the View Source button e The columns listed in the table below are on the left of the Disassembly field Column Name Description S W Breakpoints ASM Display the PC location 5 gt breakpoints Setting PC breakpoint by double click Disassembly Address Display the disassembly address Open the Set Address dialog box by double click Enter the address to jump to Obj code Display the object codes Label Display the Labels This column is not available if no module has been downloaded e Double clicking the Disassembly field in disassembly mode opens the Assembler dialog box Enter assembly language codes Options Right clicking within the Disassembly field opens a pop up menu containing available options Pop up Menu Option Macro Recording Function Refresh Acquires the latest disassembly information to update the contents of the window Lock Refresh It is possible to lock a memory range in the disassembly in disassembly mode so that it does not refresh View Source Launches editor at location in source Set Address Enters a new start address Go To Cursor CI Commences to execute the user program starting from the current PC address The program will continue to run until the PC reaches the address indicated by the text cursor not the mouse cursor or another break condition is satisfied Display PC Displays the disassembled codes at the PC location Set PC H
135. system environment checkbox can be used to alter the inheritance of the system environment Set The makefile will be executed in the standard environment Default Clear The makefile will be executed in a fresh environment Note Only the SystemRoot variable will be carried over into the new environment as it is needed to allow program to run in Windows In both cases additional environment variable can be set using the Environment variables controls Any values set here will override the value in the current system environment Click OK to save the changes and return to the Options dialog box Values will not be committed to the Workspace until the OK button in that dialog is also used REJ10J2000 0100 Rev 1 00 Jun 16 2009 82 RENESAS High performance Embedded Workshop 3 Advanced Build Features 3 10 Customizing the High performance Embedded Workshop linkage order Modules are usually linked in the alphabetical order in High performance Embedded Workshop However you can specify the linkage order if you wish to Note When the SuperH or H8SX H8S and H8 family toolchain is in use the Object order list box shows library files along with object files However only object files matter to the linkage order The order of library files 1s only used in searching for undefined symbols To manually change the linkage order 1 Click Build gt Linkage Order The Linkage Order dialog box opens 2 Select the Use custom
136. the Modify button The Define Commands dialog box opens Click the Add button to define a command in the selected menu option See section 8 2 Defining Version Control commands for further information Close the Define Commands dialog box by clicking the OK button Close the Version Control Setup dialog box by clicking the OK button User defined menu options You can create as many user defined menu options as you like name them how you want and define their order in the menu If you have already created user defined menu options definitions of the commands can be modified or deleted It is also possible to change the order of menu options being displayed User defined menu options do not appear on the version control toolbar To create a new user defined version control menu option L 2 3 4 z Select Tools gt Version Control gt Configure The Version Control Setup dialog box opens Click the Add button The Add Menu Option dialog box opens Enter the name of the menu option into the Option field Click the Add button The Add Command dialog box opens For details see section 8 2 Defining Version Control commands Click the OK button to close the Add Command dialog box Click the OK button to close the Add Menu Option dialog box Click the OK button to close the Version Control Setup dialog box To modify a user defined version control menu option L 2 Select Tools gt Version Control gt Con
137. the look of the Watch window 1 Select Setup gt Format Views The Format Views dialog box opens 2 Select the Watch item in the tree and expand it 3 Select the category of objects to be customized Category Objects to be Customized Foreground color default Background color default Text Text shown in the window Black White Read Memory that has been read Black Green Write Memory that has been written to Black Red Modified Variables whose value or position has been Red White changed Note Support for this function depends on the debugger Modify the Foreground and Background color selection on the Color tabbed page as desired Click OK 15 Selecting an encoding format If the values of variables are characters or strings and they should be displayed as UTF 8 code select Setup gt Options to open the Options dialog box Click on the Debug tab and select UTF 8 for Encoding Format The Watch window now shows the values of variables as UTF 8 code If Local Code Page default has been selected for Encoding Format the values are displayed as ASCII code Note The default font for display in the Watch window is Courier New which is not supported by UTF 8 Select another font compatible with UTF 8 in the Format Views dialog box in advance 17 18 3 4 Locals window The local variables and their values can be displayed in the Locals window 1 Opening the Locals window To open the Locals window choose View
138. the new type and the style of the Project Generation Wizard Once created these project types appear in the Tools Administration dialog box and are initially hidden in the System Components part of the Tools Administration tree To export one of the Custom Project Generators select the Export button on the Tools Administration dialog box The export functionality packages the Custom Project Generator into a binary file which includes an executable This can be given to another user who then runs the executable This installs the Project Generator into the correct location on the target user s machine Note A project template can be created by selecting Project gt Create Project Type based on the project in use This template includes the version information of the toolchain When a project is created by using this template after the toolchain version has been updated in your High performance Embedded Workshop system check that the toolchain version of the created project matches the using environment When the registered toolchain can be updated the toolchain version can be changed in the dialog box that is displayed by selecting Tools gt Change Toolchain Version REJ10J2000 0100 Rev 1 00 Jun 16 2009 116 RENESAS High performance Embedded Workshop 5 Tools Administration Change Toolchain Yersion EE TE SuperH RISC engine hd Renesas SuperH RISC engine Standard inhanmmatari OptLinker SH Assembler SH CtC Compiler
139. the problem There are two additional icons that can be displayed If a component is found but cannot be used due to it being an old version or another dependent component is not available then the icon in figure below is used to show this 4 H8S H8 300 Series Simulator Target Platform 3 0 dhion Embedded Monitor Platform 1 0 intel Hex Record Obiect Header LO Component not found icon If the component is not located where the registration file says it is then the icon in figure below is used to show this Registered components Component Toolchains ee HSS H8300 Standard Toolcha SuperH RISC engine Standard muner H RIRC eneimne Standard Incompatible component found icon Note If the tool has one of these errors then it is possible to get more information by the following method To get tool error feedback 1 Select Tools gt Administration The Tools Administration dialog box opens 2 Select the tool in the list that has an issue 3 Click Properties 4 Select the information tab and scroll the edit field to the bottom 5 The reason for the problem will be displayed in this area 5 7 Using On Demand components The High performance Embedded Workshop version 3 0 onwards has the concept of on demand components These components are not automatically loaded by the application or the debugger component These components can be loaded by the user or as part of the project generation process To load or
140. to use Selecting TCL command line batch file in the drop down list changes the Add Test Script dialog box so you can define the file to execute when the test is executed Clicking OK stores the results and adds it to the Add New Test dialog box Finally you must set the Debug system for test image comparison file This file stores the comparison data for the system to be compared to after the tests have executed This file can be created by using Test gt Create Test Image File Clicking OK adds the test to the Modify Test Suite dialog box REJ10J2000 0100 Rev 1 00 Jun 16 2009 235 RENESAS High performance Embedded Workshop 16 Test Support Facility Add Test Script Script type wi Macro Cancel Select macros to add to test File Path C Downoad Default C NewMacro Default 16 5 Creating a test image file The test image data is what is used for any comparison in the test system Only items that are saved in the test file can be compared For example you may only be interested in comparing data that is located in a small area memory not the memory for the entire device The more items that you compare for each test will slow down the comparison and this can make a big difference if you are executing many tests To create test image data to be saved into a test image file 1 Select the Test gt Create New Test Image File The Create New Test Image dialog box is then displayed Cre
141. toolbar Save File Copy Match Braces pen File Save All Cut Paste Print New File b a E 2 se ES Search toolbar Find In Files Find Find Previous Search String Find Newt a JA A D Templates toolbar Defne Templates Insert Selected Template Template Selection b Bookmarks toolbar Next Bookmark Previous Bookmark Toggle Bookmark Remove All Bookmarks fal LO d Ge ce Default Window toolbar TCL Toolkit View Workspace Compare View View Disassembly Command Line Files Output Toagle status bar B gt HAsO REJ10J2000 0100 Rev 1 00 Jun 16 2009 3 RENESAS High performance Embedded Workshop 1 Overview Standard toolbar Build File Build All Launch Clean All Build Stoo Tool Curent Configuration Curent Session External Ge Fae eution Debugger i Version Control toolbar This toolbar is only available when a version control tool is being used in the current project Check out from WES Remove from YCS Get Check into VCS Add to WCS mon ei Get eee statue SoS SA Map toolbar F ap Macros toolbar You can add a customized button to which a created macro has been assigned on the right to the standard macro buttons on the toolbar as shown below Play Macro Pause Macro Record vann Stop Macro C u0 O Debug toolbar This toolbar is only available when a session is being used which has a target attached Enable Disable Breakpoint Toggle Deci
142. unchecked by default Note that Group By File and Group By Access cannot both be on at the same time Switching one on will switch the other one off Another useful facility is the capability of viewing the base or derived classes for a certain selection To view the Base or derived classes 1 Right click on class on the Navigation tab to display a pop up menu 2 To see the derived classes for the selection click the Show Derived Classes menu option To see the base classes for the selection click the Show Base Classes menu option 3 Depending on the selection a dialog is displayed which shows the class structure selected in an expanded tree format 4 Click Close to close this dialog once you have the information you require 12 3 Jump to a definition from the editor It is possible to select navigation items of defines C functions or C classes from the source codes shown in the editor window and view the positions where these navigation items are defined Note however that these navigation items must be under the categories checked on the Navigation tab of the workspace window To jump to a definition 1 Right click on a navigation item which you wish to view where it is defined within the Source field of the Editor window 2 Select Go to Definition Of Navigation item from the pop up menu E Source ag extern void INTHandlerFPRG vo1id oid FowerON Reset void oid Manual Reset void old mais ifdet
143. utorial ta Import Makefile Directory gH Library gt Debugger only cx C AWorkspace T utorial Browse CPU family SuperH RISC endine Tool chain Fenesas SuperH Standard Properties Cancel The New Project Workspace dialog box allows you to select a project type for generation which matches your CPU target Project Type Description Application Project for generating an execution program that includes the initial routine file written in the C C language Assembly Application Project for generating an execution program that includes the initial routine file written in the assembly language Demonstration Project for generating a demonstration program written in the C language Renesas SuperH Standard Tool chain or Renesas H8S H8 300 Standard Tool chain C source startup Application Project for generating a startup program written in the C language Renesas M16C Standard Tool chain Renesas M32C Standard Tool chain or Renesas R32C 100 Standard Tool chain Empty Application Project for only setting the toolchain environment no generation file Import Makefile A project to create an executable program by importing an existing makefile Library Project for generating a library file no generation file Debugger only XXXXXX A debug only project no generation file In the example below the SH 4 simulator debugger is assumed For details on the functions available with the debugg
144. vertically divide the Register window display into two select Split from the pop up menu and move the split up bar To cancel the split up display select Split from the pop up menu again 17 7 9 Saving register contents To save register contents in a text file choose Save To File from the register pop up menu The Save As dialog box opens Specify the file name 17 7 10 Refreshing the Register window The Register window contents can be forcibly refreshed Selecting Refresh from the pop up menu of the Register window 17 7 11 Disabling refresh of the Register window Automatic refresh of the Register window contents which is performed when user program execution stops and in other cases can be disabled Select Lock Refresh from the pop up menu of the Register window REJ10J2000 0100 Rev 1 00 Jun 16 2009 344 RENESAS High performance Embedded Workshop 17 Debugging Facility The contents of the Register window are grayed out When two windows are open and this function is enabled in either of the windows values of registers and flags can be compared 17 7 12 Using register contents It can be useful to be able to use the value contained in a CPU register when you are entering a value elsewhere in the High performance Embedded Workshop for example when displaying a specified address in the Disassembly or Memory views You can do this by specifying the register name prefixed by the or character e g PC
145. w Sets or clears a software breakpoint at the line showing the address Enable Disable CTRL F9 CI Enables or disables the current software Breakpoint breakpoint Define Column Format Sets the status of editor columns Source Breakpoints CTRL B Opens the Breakpoins dialog box Evaluate Evaluates simple and complex expressions Operations with some menu options can be recorded as High performance Embedded Workshop command line commands by the macro recording support facility A macro record icon in the Macro Recording column of a menu option indicates that this function can be recorded into a macro file For details see section 15 5 1 Recordable functions common to all High performance Embedded Workshop products 1 3 View Menu Options Menu Menu Option Shortcut Key Toolbar Macro Saving into Test Function Button Recording 1 Image File 2 View Differences Opens the Difference window Map 3 Opens the map window Command Line CTRL L Opens the Command Line window TCL Toolkit CTRL SHIFT K see the Tcl Tk Additional document Workspace ALT K Ig W Opens the Workspace window Output ALT O E mj s Opens the Output window Status Bar ALT A Toggles the status bar on and off Disassembly CTRL D E C Opens the Disassembly window CPU Registers CTRL R w Opens the Registers window Memory CTRL M CI Opens the Memory window lO CTRL I T m Opens the IO window E Status CTRL U
146. will be added to the drop list and selected exactly as it would for a completely new configuration except that the dialogs controls will not be reset to default However the file can also be saved to a different location for example a network drive so that it can be shared with other High performance Embedded Workshop users in which case the configuration will not be added to the drop list To import configurations In order to import a configuration into High performance Embedded Workshop copy the configuration s SDO file into the Sync directory before opening the Synchronized Debug dialog box or follow the following method on the dialog box 1 Click the Import button 2 Browse to the configuration file you want to import REJ10J2000 0100 Rev 1 00 Jun 16 2009 379 RENESAS High performance Embedded Workshop 18 Synchronized Debugging 3 Click Import The file will be copied to the Sync directory and the configuration will be added to the drop list where it will be selected and then loaded To delete configurations In order to delete a configuration delete the configuration s file from the Sync directory before opening the Synchronized Debug dialog box or follow the following method 1 Select the configuration you want to delete from the drop list 2 Click the Delete button The configuration will be removed from the drop list The file will be deleted from the Sync directory The next alphabetically configurati
147. will switch back to the debugger to enable immediate debugging Whilst using an external debugger double clicking in any editor window will switch back to the High performance Embedded Workshop with the source file open at the line that was double clicked 17 17 1 Configuring the Hitachi Debugging Interface to integrate with High performance Embedded Workshop The following details the information required to setup the Hitachi Debugging Interface to integrate with High performance Embedded Workshop and launch from the external debugger option in High performance Embedded Workshop External debugger selected Hitachi Debugger Interface version 4 or greater Si Debugger settings HDI location Po Browse Session file P Browse Download module Po Browse To configuring the Hitachi Debugging Interface to integrate with High performance Embedded Workshop 1 Firstly the location of the debugger executable must be specified This must be version Hitachi Debugging Interface 4 0 or greater otherwise its behavior is not guaranteed This may have been configured by the installation program or a project generation utility 2 The second item of data is the session file This tells the debugger which session to load when it is launched Finally the location of the download module is required This allows the High performance Embedded Workshop to automatically switch to the debugger when the download module cha
148. window with real time RAM monitor function o Viewing the memory values in the RAM Monitor or MR window with real time RAM monitor function o Viewing or modifying the memory values in the CWatch or ASMWatch window o Viewing the memory values in the GUI I O Image or Waveform window Note Support for this function depends on the debugger 17 1 5 Downloading modules 17 1 5 1 Setting the downloading a program Once you have made sure that there is memory in your system in which to download your code you can then proceed to download a program to debug The initial selection of download module is automatic with regard to an application generator as it is the output from the linker However with regard to the debug only project generator it is possible for you to browse to the module that you wish to download This is outlined in the section 17 1 2 Selecting a debugger REJ10J2000 0100 Rev 1 00 Jun 16 2009 2 8 RENESAS High performance Embedded Workshop 17 Debugging Facility Debug Settings SimSessionSH 4 Target Options seen Tes Project Mame Target SH 4 Simulator Core Single Core Target Debug format EID warta Download modules Offset Address Format SICONFIGDIAY PAO OOOU0U00 EID wart eatin Bemare Cancel i It is also possible to manually choose download modules after the project creation This is achieved via the Debug Settings dialog
149. with File the current High performance Embedded Workshop system or with another test image file already on your disk The results are then displayed in the test browser Run Tests Runs tests allows you to run multiple tests that you have defined in the test suite and see the results of the comparisons in the test browser There are various options to configure the test run execution Test Result Browser Displays the test results for one or more test executions It shows the pass and fails results and the detailed reason why the test failed 1 10 Window Menu Options Menu Menu Option Shortcut Key Toolbar Button Function Window Cascade Arranges all open windows so that they overlap Tile Horizontally Arranges all open windows horizontally Tile Vertically Arranges all open windows vertically Arrange Icons Lines up all minimized windows Close All Closes all open windows Virtual Desktop Manager Renames your configuration to a more meaningful name desktop Default 1 4 Switches desktop configurations 1 11 Help Menu Options Menu Menu Option Shortcut Key Toolbar Button Function Help Help Topic Shows the main High performance Embedded Workshop help window Technical Create Bug Report gt Creates a High performance Embedded Workshop bug report Support Check Website For Checks for High performance Embedded Workshop product Updates updates or service packs License F Opens the License Management di
150. with this options dialog 7 Click Compare The Difference window is displayed Window configuration Difference E Toolbar Al dh a a t E Header Ci Workspace DemoSH4 DemoSH 4 dbsct c Source Safte version a pragma section DSEC pragma section DSEC Static const struct Static const struct I _UBYTE rom_ 3 f Start _UBYTE rom_ 3 Star _UBYTE rom_e f End ad _UBYTE ron e End UBYTE ram 3 f Start _UBYTE ram 3 i Star 1 DTBL b 1 DTEL se ctop Db secend D sectopr eb secend L te C te l GKI mm Reference file T arget file e In the Difference window the left and right panes respectively show the files to be compared e Their names are at the header of each pane e If you hover the mouse cursor on the boundary of the two panes the cursor turns into a double sided arrow To adjust the widths of the panes drag the mouse to a desirable position REJ10J2000 0100 Rev 1 00 Jun 16 2009 179 RENESAS High performance Embedded Workshop Options 11 Comparing Files Right clicking displays a pop up menu containing available options A basic operation is allocated to the toolbar The Toolbar display and Customize toolbar options are also included in the pop up menu opened by right clicking on the toolbar Pop up Menu Option Toolbar Button Macro Recording Compare cn Export results to file 7 Ignore white space Find Find previo
151. you wish to view three consecutive frames for example the operation will be as follows Image X Norrefresh E pr FLT He 10 e E 1 Click on the Next Image toolbar button to view the second frame REJ10J2000 0100 Rev 1 00 Jun 16 2009 328 RENESAS High performance Embedded Workshop 17 Debugging Facility Nonreftesh E pr an Me 110 e E 2 Click on the Next Image toolbar button to view the third frame Image x Nonreftesh E p oe e e lids Fjo 17 4 5 2 Regularly switching the frames While the function to show images as consecutive frames is enabled the pop up menu and toolbar items listed in the table below are available for regularly switching the frames Pop up Menu Option Toolbar Button Function Redraw Interval 0 5s fi z The image is redrawn continuously every 0 5 seconds 1 0s The image is redrawn continuously every 1 0 seconds 2 0s The image is redrawn continuously every 2 0 seconds 4 0s The image is redrawn continuously every 4 0 seconds Redraw Continuously ie Starts redrawing continuously Stop m Stops redrawing continuously Note Images may not be updated in the defined interval depending on the debugger in use and the image size Whether the pop up menu and toolbar items are active or not depends on which frame is currently displayed To regularly switch the frames While Redraw Continuously is enabled the frames are regularly switched If you wish to view thr
152. you would like this program to run i e where you want the current working directory to be set to before the tool is executed then enter it into the Initial directory field Hew Build Phase Step 3 of 4 LA Phase name M yPhase Command excluding parameters car oole MiT ool exe p Browse Default options S FULLFILE Initial directory S CONFIGDIR gt Browse Back Next gt Cancel REJ10J2000 0100 Rev 1 00 Jun 16 2009 68 RENESAS High performance Embedded Workshop 3 Advanced Build Features Step 4 The fourth and final step allows you to specify any environment variables that the phase requires New Build Phase Step 4 of 4 ki x sy Does the command require any environment yarnables to be set IF so enter them into the list belor Modit Remove Read Output On Fly lt Back Finish Cancel To add a new environment variable click the Add button the Environment Variable dialog is displayed Enter the variable name into the Variable field and the variable s value into the Value field and then click the OK button to add the new variable to the list To modify an environment variable select the variable from the list and then click the Modify button Make the required changes to the Variable and Value fields and then click the OK button to add the modified variable to the list To remove environment variables select the variable that you want to rem
153. 0 0x0 16 register get Rll 0x0 Ll register set Elz Ox0 15 register set R13 0x 19 register set R14 0x0 aU build all wait al file load ELf Dwarfe s CONFIGDIF 444 PROJECTNHAME ac memory Fill OxTOOOOOOO Ox TOOOOOe OxXOOO0 long nover 2d reset 24 qo till go Ox2Z0E4 25 atch add Watchl a 6 a0 Macro Demo End Modify the description as required and click the Save File button l on the Editor toolbar Close the High performance Embedded Workshop macro file Default hdc REJ10J2000 0100 Rev 1 00 Jun 16 2009 27 RENESAS High performance Embedded Workshop 1 Overview 1 14 4 Step 3 Playing a macro 1 Click the Play Macro button on the Macros toolbar The Select Macro Function dialog box opens 2 Selecting the macro Demo starts playing the recorded commands The mouse pointer is modified to include the play icon te gt 3 When the playback of a macro is completed the mouse cursor returns to be an arrow 1 14 5 Step 4 Creating a test suite 1 Select Test gt Create New Test Suite to invoke the Create New Test Suite dialog box Create New Test Suite EE Test suite name fT est Suite _ Demo Directory for test suite E Wwyorkspace D emosH4 Browse Enter Test_Suite_Demo in Test suite name Initially the workspace directory is shown in Directory for test suite This can be modified as required Click the OK button Displays the Test tab of the workspace window Shows the
154. 00 0100 Rev 1 00 Jun 16 2009 370 RENESAS High performance Embedded Workshop 17 Debugging Facility To set scope of a watch item Select either of the following ways e In place edit in the Scope column Click on the button on the right edge of the list box and select scope from the list Watch R E CRA tx gee H A Watch Item 1 7F000000 long 10 Auto Fl Watch Item 2 0 H o0000000 7F000028 longi DenosH3 c DemoH3 abs Auta Global dbsct c DemosHs aS Demo3H3 c DemoSH3 abs intprg sre Te ahs lowlyl ere DemosHs abe lowsre c DemosH3 abs resetpryg c DemosHs abs sbhrk c ibemosSH3 abs vectthl src DemosHs aba Vhandler src DemosHs3 aba POE watchs e Open the Set Scope dialog box in either of the following ways o Double click within the Scope column o Right click on the line of a watch item and select Set Scope from the pop up menu Set Scope Ei Ei Expression watch_Item_2 0 Scope dbsct c l NU sist lee emoSH 0 enics H a DemoSH3 c C space DemoSH sD er Intprg sre C TE emoSH SD emos lowlvlsrc l Workspace emoSH SD emos lows cl Workspace emos HAD emoSt resetprg cC Workspace emos H3 emot sbrk cll Ww orkespaceDemos H aD emos Ha vecttbl arc L workspaces emoSH sD ema F a l lomil mMm 1 Select scope for the variable shown in the Expression field REJ10J2000 0100 Rev 1 00 Jun 16 2009 371 RENESAS High performance Embedded Workshop 17 Debugging Fa
155. 00 Rev 1 00 Jun 16 2009 323 RENESAS High performance Embedded Workshop 17 4 1 Opening the Image window 17 Debugging Facility Choose View gt Graphic gt Image or click the Image toolbar button i to open the Image Properties dialog box The Image Properties dialog box is used to specify the display method of the Image window Image Properties Color Information Mode MONOCHROME C AGE C BGR Chr HERE 2a z Sampling a F Eormmat chunky F Butter Information Data Address ooooo0o0 Palete Address OUUMad e Wiidth Height Size Pisel Butter Size Hex width 0 00000000 Byte Height 0 l Enable Redraw Continuously Image Wata Buter Bull Seles Brame aurit 2 QUUOUUU0 Byte View Information View Mode Position f Full Size Py Position 0 C Part Size 7 Position I Start Position widi Height Slee ice Top width 0 Bottom Hearts 1 The following items are to be specified Color Specifies the color information of the image to be displayed Information Mode Bit Pixel Sampling Specifies the format MONOCHROME Black and white ei Ed Cancel RGB R red G green and B blue BGR B blue G green and R red YCbCr Y luminance Cb color difference for blue and Cr color difference for red Specifies bits pixel according to the selected mode valid when RGB or BGR is
156. 0100 Rev 1 00 Jun 16 2009 237 RENESAS High performance Embedded Workshop 16 Test Support Facility In some cases it is necessary to make detailed setting specific to each of the test items before saving test image data If you double click on a test item in the Create New Test Image dialog box a further dialog box for detailed setting opens When a test item has any detailed setting it is possible to customize test image data of this test item before saving On the other hand when a test item does not allow detailed setting and the checkbox for this test item is selected all test image data of this item will be saved into the file A save file icon l in the Saving into Test Image File column of an item listed in the View menu indicates that this data can be saved into a test image file 16 6 1 Functions that can be saved into test image files common to all High performance Embedded Workshop products Among the functions common to all High performance Embedded Workshop products test image data of the test items listed below can be saved into test image files The following table shows the test items in the Create New Test Image dialog box and the corresponding windows from which the data will be saved into test image files For more information on the test image data to be saved into test image files how to make detailed setting and test results see the descriptions of test items for the corresponding windows Create New Test I
157. 08 HA Sopu commnn O css EE AE EE E EE S 208 E ee me e e Does el CU 6 A E A E E E acon mn E E nt eee NE ee ere 208 HG Slane or sopir 0 890 10 oe EEA EEE EEE E 209 Hr Pon a a E ase rpc tts a E E E E T spate sonacauees 209 14 8 Pastine aplaceholdGi censat NON E REO AE E SE NORN N 209 14 9 Selecting all the window contents sseeeeeenensssssssssssssssseseeeeerrssssssssssssseeceeeresssssssssssssccreereeossssssssssssseeeeteeeesssess 209 14 10 Copying the selection onto the clipboard eeeenesssssssseseeeereeesssssssssssseererersssssssssssssseereerressssssssssssssssseerereeessssss 209 14 11 Cutting out the selection to the clipboard ccccccccccccccccccneeaeeeaeeseseseeeeeeeeeeeeeeeeeaeaeaseeesseseeeeeeeeeeeeeeeeeeeaaaaagsasases 209 14 12 Pasting the contents of the clipboard ec cecsssssssssseeeeeceeeeeeeeeeaaaeeesesseeeeeeeeeeeeeeeeeeeesssesseeeeseeeeeeeeeeeeeeeeeeaugaesassses 209 14 13 Clearing the contents of the Command Line windoW essessssssssssssseeterresssssssssssssseerrererreesssssssssssssseereresessssss 210 LANA Undone thelast Ope Lat OM seisis a e e e E E aa N EE 210 LAS Checkins brace miat Mng aisre E OE Ee EEEE ETE OEE 210 14 16 Resetting the status of a batch file 0 ccesesssssseeeeeeeeeeeeeeeeesaaeeaeeeeeseeeeeeeeeeeeeeeeeassaeeeeeeeeeeeeeeeeeeeeeseeaaaaesaesses 210 14 17 Single stepping in a batch Me vss ccsccivecversivsnccancacsawsosseesdeneawevsrncrseddencancnvdssvendsncnseadiloncsencans
158. 09 Renesas Technology Corp and Renesas Solutions Corp All rights reserved Printed in Japan High performance Embedded Workshop V 4 06 User s Manual CENESAS Renesas Electronics Corporation 1753 Shimonumabe Nakahara ku Kawasaki shi Kanagawa 211 8668 Japan REJ10J2000 0100
159. 0x00002f5a Dest 0x00002704 To make detailed setting If you double click on a test item in the Create New Test Image dialog box a further dialog box for detailed setting opens Edit Test Memory Ranges Memory ranges End address Cancel Modi Hemose REJ10J2000 0100 Rev 1 00 Jun 16 2009 241 RENESAS High performance Embedded Workshop 16 Test Support Facility e To add a memory range 1 Click on the Add button on the Edit Test Memory Ranges dialog box to open the Add Memory Range dialog box Add Memory Range Ei Ei address OK e Cancel End address ooo00000 E ACCESS SIZE ka 2 Specify Start address End address and Access size to set a memory range to be saved into a test image file 3 Click OK e To modify a memory range 1 Click on the Modify button on the Edit Test Memory Ranges dialog box The memory range selected in the Memory ranges list will be modified Only one variable is selectable in the list The Modify Memory Range dialog box opens Modify Memory Range Ei Ei a address e Cancel End address OO0000FF Access SIZE o 2 Specify Start address End address and Access size to set a memory range to be saved into a test image file 3 Click OK e To remove a memory range 1 Click on the Remove button on the Edit Test Memory Ranges dialog box The memory range selected in the Memory ranges list will be deleted Only one trace range i
160. 1 2 Defining the synchronized Debuggers cccccccccccccccceesesssseeeeeeeeeeeeeeeeeeeeeeeaaaesesesseeeeeeeeeeeeeeeeseaaaaaagaaeeeeses 380 18 1 3 Seline the syachromzaton op ONG seca stor isan cb ne fatale e RE EEE ER a 383 18 1 4 Setting the memory update option ssssssssssssssseeetreeterrrrssssssssssseserterrrssssssssssssseetereesessssssssssssssseerrereessessse 384 18 1 5 Sync hromzod de Di e no MOLE E E EE TE EA 384 18 1 6 Start synchronized debugging eeesssssssssssseeetrrerrosssssssssssecerrerreerressssssssssseeetrrreessssssssssseeseseeeerreeesessss 384 18 11 77 Update synchronized deDUgTing srciesraenrniresereiari in eeuse eE EET IEEE E Aii 385 18 1 8 StopSynchronized debug ging serseri eni EN ia E E EE N UUA E INS 385 18 2 Using High performance Embedded Workshop while synchronized nennneesssssessooeeeeesnsssssssssssseeeereessssssssssss 385 18 2 1 Common UC 110 OA srca tea onipaticauaiesd deat anedcawaGiecnon Sen ateeenotsuiesacdennsietdents 385 132 2 Parallelmod LONCUOMAMY srecen a EE AAGA A S AEE 388 18 2 3 Internal mode functionality ec ccccccccccccssssssseseseeeeeeceeeeeeeeeeaaaeaeaaaeeeeeeseeeeeeeeeeeeeeeeeaaeaeeessseseeeeeeeeeeeeeeaaaas 389 18 3 Using the command line window when Synchronized cccccsssssssseseeeececeeceeeceeeeceeaassesesseeeeeeeeeeeeeeeeeeauaaaegsaeaseses 390 Te ROSS A ON BU soars cccncaaneaeecstaa conan EE 391 REJ10J2000 0100 Rev 1 00 Jun 16 2009 viil REN
161. 100 Rev 1 00 Jun 16 2009 412 RENESAS High performance Embedded Workshop 8 Keyboard Shortcuts 8 Keyboard Shortcuts All major commands in the High performance Embedded Workshop application can be driven by the keyboard Below is a list of all keyboard commands in the application Function key Key Function ALT 0 9 Play a macro assigned to keyboard shortcut ALT A Toggle status bar ALT K Open the workspace window ALT O Open the output window ALT F4 Exit the application ALT BACKSPACE Undo alternative in the editor to CTRL Z CTRL 0 9 Reserved for use for template insertion CTRL A Select all in the editor May also work in other windows CTRL B Open the Breakpoints dialog box CTRL C Copy the selected items to the clipboard CTRL D Open the disassembly window CTRL F Open the Find dialog box CTRL G Go to source line CTRL H Open the Replace dialog box CTRL Open the IO window CTRL K Open the stack trace window CTRL L Open the command line window CTRL M Open the memory window CTRL N Create a new source file in the editor CTRL O Open the open file dialog box CTRL P Print the document CTRL R Open the registers window CTRL S Save the current file CTRL U Open the status window CTRL V Paste the clipboard contents CTRL X Cut the selection CTRL Y Redo the action CTRL Z Undo the last action CTRL F2 Toggle bookmark CTRL F3 Search for the next occurrence of the text chosen in the editor
162. 10J2000 0100 Rev 1 00 Jun 16 2009 402 RENESAS High performance Embedded Workshop SET_SOURCE_SOFT_BREAK SLEEP STATE_DISASSEMBLY_SOFT_BREAK STATE_SOURCE_SOFT_BREAK STEP STEP_MODE STEP_OUT STEP_OVER STEP_RATE SUBMIT TCL TOOL_INFROMATION UPDATE _ALL_DEPENDENCIES 1 Notes 1 Available only when there is a toolchain installed SSB TDB TSB ST SM SP SO SR SU TO UD 3 Commands Sets or deletes a software breakpoint at the source level Delays command execution Enables or disables a software breakpoint at the disassembly level Enables or disables a software breakpoint at the source level Steps through program by instructions or source lines Sets the step mode Steps out of the current function Steps through program without stepping into functions Sets rate of stepping Executes a file of commands Turns TCL commands on or off Outputs the tool information Updates the current projects build dependencies 2 Support for this command depends on the debugger For the syntax of each command refer to the online help 3 2 Command List Listed by Function High performance Embedded Workshop Application Control Commands Command Name ADD _ FILE CHANGE_CONFIGURATION CHANGE_PROJECT CHANGE_SESSION CLEAR OUTPUT WINDOW CLOSE_WORKSPACE EVALUATE OPEN_WORKSPACE QUIT RADIX REFRESH _ SESSION REMOVE_ FILE SAVE_SESSION SAVE_WORKSPACE TOOL_INFORMATION Abbreviation AF CC CP CS
163. 17 3 17 Regularly refreshing the Memory window If you select Auto Refresh from the pop up menu of the Memory window the Memory window will regularly be refreshed while the user program is running The actual refresh interval is shown on the leftmost column header in the Memory window Support for this function depends on the debugger Memory Watch 1 E ween E ottiam 15 10 40 38 2 lebe dp de de de a terest Len AST T JOOS O000HISE OOO0S4ER OON049SA OO0OSIAB awaa T popsin 00000255E 00002OCS O00020AF O0001208 a uu san sanan 0000420 0000IODO 0Q000O0Z0E Q0AAQOOO OO005400 s asssanssannn T OOOUS430 DISEBIFO OOOON000 AAOOOOOI ONODN00N 2 eee eee eee OO005440 00001404 OONNNNNN OOOOOOO OHNO Pee sie OOO05450 D32E561F 7B36C775 FIEACCFS 175BE4A2 V iB u Le 0 4 To specify the refresh interval select Refresh Interval from the pop up menu This item is only selectable when it is supported by the debugger Lock Refresh in the Memory window cannot be used with Auto Refresh REJ10J2000 0100 Rev 1 00 Jun 16 2009 318 RENESAS High performance Embedded Workshop 17 Debugging Facility 17 3 18 Specifying the refresh interval You can specify the interval to refresh the Memory window while the user program is running Support for this function depends on the debugger To specify the refresh interval 1 Right click within the window to open a pop up menu 2 Select Refresh
164. 2 or later 1 Locating files Files that cannot be found or do not exist after the initial search will be shown to the user in the Locate Files dialog box in the Files to find list Locate Files ki Ei Last searched director CA Wworkepaces DebuglinlysDebug Ernulator Files to find Search status 0 t 13 foundunfound hoc lib dbsch c machine h resetorg cpp sbrk c sbrk h Browse A Workspace Aa Debug Unly ce Debuglrly es Debug Ernulatar i wE Source H E DemoSH4 H Workspace Mame EE Compact Disc D T Look in subdirectories Do not show on download UF Cancel p ae REJ10J2000 0100 Rev 1 00 Jun 16 2009 284 RENESAS High performance Embedded Workshop 17 Debugging Facility To locate files l 2 The Last searched directory holds the last directory that was searched for these module files The Search status field shows the number of files that were found against the number that have not this is only relevant to the files in the dialog and do not account for any previous searches The Files to find list holds a list of all the files that could not be found they will appear in short filename format and will be searched for in this manner The Browse section allows the user to select a directory in which to search the remaining files for The Look in subdirectories check box will look for the files in all sub directories for the chosen directory The Do not show on download che
165. 2 3 1 Adding Miles tO A projeti sessen een a o aaa acia R EOE iaai 39 22 Drag and drop of files and fOIdeTS ce eeecessseeeeececeeeeeeeeeeseeeesseseeeeeeeeeeeeeeeeeeeeeasaeeseeeseeeeeeeeeeeseeeeeaaaaageeesses 40 2 3 3 Removing files from a Project ccccccceccsssssssssesseeeeceeeeeeeeeeeeseeeeeeeseseeeeeeeeeeeeeeeeaeeeseesaeseeseeeeeseeeeeeeaaaaageesnses 41 2 3 4 Excluding a project file from build ee eeeeeessseeecceeeeeeeeeeeaaaeeesesseeeeeeeeeeeeeeeeeaeaaaesseseeeeeeeeeeeeeeeeeaaaaagegsnses 42 23 Including a project file in UI isa desi aiccdacatesecnnnacecdeeshaasdaniaanedsesdaceewaseousdasdsnaddesaannednoatoaesensaoaeasedhanscenaconedoesiesades 43 2 4 User folders in the WOrKSP aCe aivixesccsancssactracssousesnousesevenensansnedeaciunowandsswasveassaaunnenseadhoereoddansealestwnheessancdumedteseeunsyeuseaeanes 43 293 File extensions aid Mile BrOUpS nc cuesaianoneecarncsscudesiaxvenavnnessicnemadameiueudamssenasteeuecaunnenekaahqeviowlensebenavbeasswedepiunessqebeaninnesemuates 44 2 5 1 Associating an application with a file group ccccccccccccccccssceeeesssssseeeececcccceeeesacaneesssssseeeeeeeeeeeeseeeseaaeeesssses 45 2522 Creating a new file extension and file QrOUP ccceccccccccccccsassseessseeeeeccceeceeceeeeeeeaaaassssssseseeeeeeeeeeeeeessaaagegesses 47 253 Me AU yd Us Ta Seacrest dupe sas A aceon tonearm E E N EE E A enna alae 48 2 6 SSUES Duld OPONE seese eiee e EEE EE e EEEa ENEE Eene aE E Sa EER R EET EE S EEEF ETEEN E
166. 3 3 Running program ignoring any breakpoints eneeeesssesssssssesseteereesssssssssssssseerreresssssssssssssserterereeesssesssss 347 FEIS RUNING to CUSO es E EES E N E EN ra EEN ii 347 17 13 5 Running from a specified address ccccscssseeecccceceeceeeeaeesssesseeeeseeeeeeeeeeeeeeeeassaeeeeeeeeeeeeeeeseeeeeaeeeaaaaaaeeesees 348 17 13 6 Continuing execution to a main function at a reset ssessssssseeeoeeeeresssssssssssssseererresssssssssssessssseeeererrssssssss 348 An MMO e e snc nacessccaned exe aanadonatenes ess soedasds nae aneaanenmenennsscactanuspanaenaanannseanedecuneeauceonstanesssceosuteoteioues 349 Wies PV MPU NC SC 08 E cenece cones sue dounieute sodas canes teeta sien toutes sama E E ssonee eed 350 17 14 Stopping your PLOT AIM poneesaciscnossttoge seve sasensnndeloerese oan E eE E A EEE S EEEN aaa EAEE Eaa raii 350 17 14 1 Stopping the program by the Halt toolbar button ec eeceessseeeeeceeeeeeeeeeaaeaeessseeeeeeeeeeeeeeeeeeeaaaaaaasaeesses 350 17 14 2 Standard breakpoints PC breakpoints cvcessewiccacsseneseaccoardedvcnas ssa sewatsetiowsnvedsewaddedeousdauaseuedicdhceomoeascwnriudivoauseeva 351 17 13 Viewing the current SLALUS ssiscisrmricerieiderroriiesinei tannanna RENo SESE EAEE EAE a E Eae reaa T eaei 352 17 16 Viewing the function Call WIStOry cc cccccccccccccccsnssssseeeeeeeeeeeeeeeeeeeeaaaeeeseeeeeeeeeeeeeeeeeseaeasaseeesaeeeeeeeeeeeeeeeeeaaagaaeanases 353 17 416 1 Opening the Stack Trace win
167. 4 4 Jumping to a specified line To jump to a line in a file 1 Ensure that the window whose contents you want to replace is the active window 2 Select one of the following operations to open the Goto dialog box e Press CTRL G OR e Select Edit gt Goto Line OR e Select Goto Line from the pop up menu in the Editor window Goto Line number il Cancel 3 Enter the number of the line that you want to jump to into the Line number box and then click the OK button The insertion cursor will be placed at the start of the line number specified 4 5 Bookmarks When working with many large files at a time it can become difficult to locate specific lines or areas of interest Bookmarks enable you to specify lines that you want to jump back to at a subsequent time One example of its use is in a large C file where you may want to set a bookmark on each function definition Once a bookmark has been set it exists until it is removed or the file is closed To set a bookmark 1 Place the insertion cursor on the line to mark 2 Select one of the following operations e Click the Toggle Bookmark toolbar button ble OR e Press CTRL F2 OR e Select Edit gt Bookmarks gt Toggle Bookmark OR e Right click and select Bookmarks gt Toggle Bookmark from the pop up menu 3 A bookmark icon LC will be placed on the bookmarked line to indicate that it is an active bookmark To remove a bookmark 1 Place the insertion c
168. 41 RENESAS High performance Embedded Workshop 8 Custom Version Control System 8 6 Specifying file locations When referring to a file s location be sure to use a placeholder otherwise the command will only relate to a hardwired file For example let s imagine that a version control executable has been selected which uses a GET command to obtain a read only copy of a file The Arguments field could be specified as GET c vc files project main c However when executed this command can only ever GET the file MAIN C To resolve this problem High performance Embedded Workshop uses a system of placeholders and directory mappings Directory mappings tell the High performance Embedded Workshop which working directories 1 e where source files are being worked on map to which controlled directories 1 e where the source files are stored in the version control system Mappings between these two directory systems can be specified via the Projects tab of the Version Control Setup dialog box Once the mappings have been defined you can use the Version control directory placeholder VCDIR to represent the directory in which the project file is stored Projects show detaile tor project Details Version control directory mappings i Add e C work Applications Project oschwe sw app project Co work S Application orc AVC LS Lapp Sere Modify G work ohared wesw hared Remove Environm
169. 5 3 1 1 MV TMA O a E Steere cases oa oarsmen see eaten O A S EE O 65 32 MIEN accustom biild este erases ere eaka vaca ocr i eaaa e toa bec cten UR aE aar e ESR nEn eaae Eae 66 3 3 Ordering build Phases siorssesrenniisnrennnen aa a E EERE Eaa eN necamonuaccuandateandemmehaneneteteesaeties 70 3 3 1 PUG Order aD a EA E ENORA 70 3 3 2 Boild al AO lcele ac see ne nn ee nn ee 73 3 3 3 File Mappe S CAD eseuen EE AE E SEEE 74 3 4 Setting custom build phase options eeeessesssssssessesseeeterersssssssssssssserrereresssssssssssesertereresssssssssssssseseetreeeeesssssssseees 75 3 4 1 OON Da E E E E 75 3 4 2 TU CS WAN AA E AE E E E A E EA EE NE A E 76 3 4 3 IG PCIe a P S TiD ecer E E A 76 3 5 COmt Ole the Dilios EN Ra A E aN 11 20 Lorine OU eE EEE E E EEEE EE EEE 78 3 7 Changing toolchain Versio ssrsarscreserie eao EEEE OSEERE ET E AE 78 3 8 ST A a makoi geye E E E OEE E O 19 3 9 Using a makefile inside the High performance Embedded Workshop System ssssseeeeeeeeeeeeeeeeeeeaaeeeeeeeees 81 3 10 Customizing the High performance Embedded Workshop linkage order cc cccccccccccsssseeseeseeeeeeeeeeeeeeeeeeeeeaaas 83 4 001 C0 a arene ar enn PEE AEE eR E A N A O E AN ee ee eC aa 86 4 1 Editor MAO WY sessenasessacvansonaeieaes wmecatusceiagzansnncesioaancnmaudunesetaaaaieniecmsncasuasawentoae masa taibabeaseuneoeaunebuntceutancenebasaneesbeqnsusmoaneantes 86 4 2 Working with multiple files cccsssssssssssseseeecccccceeeeessane
170. 6 2009 186 RENESAS High performance Embedded Workshop 12 Navigation Facilities 12 5 Smart edit capability Another feature of the High performance Embedded Workshop is its smart edit facility This is enabled by default for all C source files This feature allows the High performance Embedded Workshop editor to access C navigation information and provide auto completion help when using C functions defines C classes and member functions The High performance Embedded Workshop editor accesses C functions defines and C navigation information and shows the smart editor s list in a pop up window To use the Smart edit facilities 1 Select Setup gt Options The Options dialog box opens 2 Select the Editor tab 3 The Enable Smart edit should be checked 4 Click OK W Enable smart editor With this option switched on if you are working on C or C file the smart edit capability should be enabled Note When the navigation category C Defines C Functions or C Classes is unchecked in the Navigation tab of the workspace window the High performance Embedded Workshop s smart editor function is disabled During normal usage the following editor operations will make the smart edit facilities visible e If you are using an object and are trying to access the members using the or gt If you do this a pop up window will be displayed which may help you select the correct member more efficiently than typing
171. 8 Select another font compatible with UTF 8 in the Format Views dialog box in advance 17 17 Using an external debugger The High performance Embedded Workshop can launch an external debugger tool If you want to use another debugger then you must add it to the Tools menu The Debugger tab of the Setup Customize dialog box is where the external debugger related information is configured You may wish to use an older version of the debugger if certain targets are not currently supported in the new environment Invoke it by selecting Setup gt Customize and then selecting the Debugger tab The first choice to make is which debug tool you would like to use Once this has been selected the external debugger must be configured REJ10J2000 0100 Rev 1 00 Jun 16 2009 354 RENESAS High performance Embedded Workshop 17 Debugging Facility Hitachi Debugger Interface version 4 x or greater Configuring the Hitachi Debugging Interface to integrate with High performance Embedded Workshop Renesas PD debugger Configuring the PD debugger to integrate with High performance Embedded Workshop Other external debugger Configuring an external debugger to integrate with High performance Embedded Workshop Non selected Not use the external debugger Click the Launch External Debugger toolbar button 4 to invoke the debugger with the specified session file After a build if the download module has been updated the High performance Embedded Workshop
172. 9 1 14 3 Step 2 Editing a macro viewing records sccsvscasiuntsnnddannasonsannsianertaNeunhasedvansuseshvwhdiiaddannsdasitnin i EAE E Sa 27 1 14 4 SP P E a Oe E T E T E E 28 1 14 5 Step 4 Creating a test suite ssseeeeeeeeeeesssssssssssseessesettrrrrssssssssssseeeeetreresssssssssssseeeeteereoosssssssssseeeeereressssssss 28 1 14 6 Step 53 Edi ng a test SUITE moruso nae a a EA a ALANE aE TAA Eaa han Ai 28 1 14 7 Step 6 Creating a test image file is csdescennensawsamanvssictemecresreaudvonrenastindionnstioeantwessouls dereeesamenesanedstewestnitvessaatPacteqentes 30 1 14 8 Step 7 Modifying the program before the teSt ccccccccccceecceccceeaaeeeeeeesseeeeeeceeeeeeeeeeeeaeeaeseeeeeseeeeeeeeaaaas 32 1 14 9 Step 8 Viewing the test result unmatched cccccecccccccceccececeeeeeeaeessseeseeeeeeceeeeeeeeeeauaassseeseeeeeeeeeeeeeeeaaaas 33 1 14 10 Step 9 Modifying the program back and executing the test again sooooeeneesssssssssssssssssseeeereesssssssssssese 34 1 14 11 Step 10 Viewing the test result matched 00 0 ccccccccccccesseeeseeseeeeeeeeeeeeeeeeeeaaaaeeesseeseeeeeeeeeeeeeeeessaeaeeeesees 34 2 BUD AS OO e E cncntiaiteateens E E E EE E N 35 2 1 Te OO SS oats e E E E E E E E E E E T E E E 35 2 2 Configuring the Projects tab of the Workspace WINdOW cccccccccccsssssssssseseeeeecceeeeeeeeeeaaaaesseeeseeeeeeeeeeeeeeeeaaaaaaasnsses 36 2 3 PPO TA Seapets ns E E E E cu yedip ctew nse E E E E vances 38
173. Also Debuggers that are already connected to a platform will not be automatically added to the list Each entry in the list contains the following information Debugger ID A unique ID This should be set to something that identifies the Debugger Status Will be one of the following Not open The Debugger is not currently open in a High performance Embedded Workshop application It will be opened when the Sync button is clicked Not connected The Debugger is currently not connected to a platform REJ10J2000 0100 Rev 1 00 Jun 16 2009 380 RENESAS High performance Embedded Workshop 18 Synchronized Debugging Break The Debugger is connected to a platform and it is not running Running The Debugger is connected to a platform and it is running Options Platform specific option on how the Debugger will be used when synchronized debugging starts Select Debug for normal debugging Type Type of platform associated with the Debugger Will be one of the following Single core Normal single core platform Multi core Multi core platform Workspace The full name of the workspace file that contains the Debugger s session Session The name of the Debugger s session within the workspace Adding a Debugger to the list 1 Click the Add button Add Debugger ed Workspace file Browse Project Session E Enter or browse to a valid High performance Embedded Workshop workspace file Select a project within th
174. CWatch window acquired with this setting saved into test image files Checkboxes for all variables are blank by default Test result details Failed at xxx data value is Name of the unmatched variable different Src Content of the test image file Dest Data in the current High performance Embedded Workshop system or in another test image file to be compared with Example Failed at a 0 Global data value is different Src 1783 Dest 0 To make detailed setting If you double click on a test item in the Create New Test Image dialog box a further dialog box for detailed setting opens Edit Test C Variables Compared OF Cancel Delete e To add a variable 1 Click on the Add button on the Edit Test C Variables dialog box to open the Add Variables dialog box in which variables can be added in units of scopes Add Variables Scope C signed long 10 a C struct Sample st Cancel 2 The Scope drop down list contains Global Local and file names Variables shown in the Name list depend on the selection made in the Scope drop down list The Name list shows global variables when Global has REJ10J2000 0100 Rev 1 00 Jun 16 2009 249 RENESAS High performance Embedded Workshop 16 Test Support Facility been selected and local variables that can be viewed in the current scope at the position of the program counter when Local has been selected When you have selected a file name the Name l
175. Components View 11 Integrated Toolbars in a Components View The High performance Embedded Workshop V 4 0 onwards has the capability to include a toolbar in a views client area This toolbar allows the views functionality to be accessed quickly from this integrated toolbar Various views in the High performance Embedded Workshop system have this functionality One example is the Difference view This is shown below Difference Ei Pid gh i a t E LAWorkspace DemoSH4 DemoSH4 resetprg c extern woid INTHandlerPEGiwoid wold PowerON Reset void wold Manual Reset void Toolbar LAW orkspace DemoSH14DemoSH 1 resetprg c void PowerON Reset PC void wWoid Manual Reset PCl volid Wold maln yvoid Wold main yvoid ifdef cplusplus ifdef cplusplus I endif endif a Woo Ll EL d The toolbar allows access to key Difference view features It is also possible to customize the toolbar further This can be achieved via the pop up menu of the toolbar or the component itself If you right click on the toolbar itself the following menu is displayed w Toolbar Customize The top menu option named Toolbar switches showing hiding of the toolbar the toolbar is hidden in the figure below Difference x LAWorkspace DemoSH4 DemoSH4 resetprg c LCAWorkspace DemoSH 1 DemoSH 1 Wresetprg c extern void INTHandlerPRs void void PowerON Reset void wold Manual Reset void void Pow
176. Delete The Current configuration drop list The drop list at the top of the Synchronized debug dialog will have an entry for each configuration file in the Sync directory In order to change the settings on the dialog to a previously saved configuration you should select the configuration in the drop list When you select a configuration the current settings will automatically be saved to the file of the previously selected configuration To create new configurations To create a new empty configuration use the following method 1 Click the New button Enter Configuration Hame Configuration name Cancel ki Ei 2 Enter a name for the configuration You can only enter characters which are valid in a file name You are limited to 100 characters 3 Click OK A SDO file will automatically be created for the new configuration and stored in the Sync directory The new configuration will be added to the configuration drop list and become selected as the current configuration All other controls on the dialog will be reset to the default state To save an existing configuration to a different filename This is the equivalent of a Save As file operation To save the current dialog settings to a new configuration use the following method 1 Click the Save as button 2 Enter a new unique name for the configuration file 3 Click Save If the configuration was saved to the Sync directory then the configuration
177. ESAS High performance Embedded Workshop Contents DCMI All SPOR actors css E EA E E EA landiedacantavieds fomdlasnauctes 392 19 1 Viewing the version ImiormaliOn seve ssenvzcuwsnctuaseceiuresonewtsevaeseasasdaes iaer EEEE TT EENE E er E arisia Tri 392 192 Check Tor update pcer EE O EE E EEE 392 OS CAO a B OU asec e so ccccersas ec dnsave E E E E 393 FRG FES ennea EE EE E shove cusaugatieet he A E A E ENE E E E T eave ER EE ES 394 l Man N aa eo E E E a E E E S O E N E E 395 1 1 Pie NCU OP ODS eresie E dated E E E E E E E ET E T 395 e EN OO e E E E E E E E E E T EE 395 1 3 Te gly oir OO e E E E E E E er eer EE 396 e Po e Ma OO e E E EEE AE EEEE E E 397 1 5 e ERO ONG E che E A E E O oh ace home pa acess ON E E E EE E sense tonaeeens 397 e PDN AO a E EE AE E EE E EE 398 1 7 TUM TT OD O ea EE E er et TEE A EE EE 399 Bo TENTO aa E E EE E E ety ene E E 399 LI Tes Mem 018 0 1 eia R EE N RAER R ENa a a nee 400 1 10 Window Men Options wrsicotessdacteossussavedsdeeiacarscatsenekesbvaccsypadsbeeeilansnetvadiiavabudaaieaduecidbaoiee a EnaA Naana 400 LII Hep Mmm OPOS erea EN E R aias 400 2 WY TOW 6 psec cep ncantatere E E E E E 401 3 VAIN Secs ogists E orc ice E E E E S 402 3 1 Command List Alphabet e Order cescciscassccsneesasnevssevenctvontesaatactinedasessacnwadateendancsiqeesbactine A an E Eredi 402 3 2 Command List Listed by FUNCTION cccccssssseeeeeeeeeeeeeeeeeeeeeeeeeaeaeeeeeseeeeeeeeeeeeeeeeeaaaaaesssseseneeeeeeeeeeeeeeeeeaaas 403 4 FR A
178. Examples of the components are the debugger and builder components of High performance Embedded Workshop The debugger component adds all of the menus and toolbars associated with the debugger and the builder component does the same for the build functionality The components you have registered in the system will modify the look and feel of High performance Embedded Workshop In some cases you may not have some of the menus which you can see in this manual For instance if the builder component is not installed you will not have the toolchain menu option in the Build menu 1 12 Management information files of High performance Embedded Workshop The High performance Embedded Workshop has the following files containing management information necessary for its correct operation e A file in which application level setting is stored e A file in which the default positions of windows are recorded e High performance Embedded Workshop database files e Component s data files e Keyboard shortcut layout files e Macro information file and newly added macro files e Custom project type wizard files e Syntax highlighting files e Templates files e Synchronized debug option configuration files REJ10J2000 0100 Rev 1 00 Jun 16 2009 16 RENESAS High performance Embedded Workshop 1 Overview Note Support for this function depends on the debugger These files are specific to each user account on the host computer When multiple versions of the
179. Exp lines 6 1 modify revision 1 1 date 2006 02 28 02 46 30 author user state Exp branches 1 1 1 Initial revision revision 1 1 1 1 date 2006 02 28 02 46 30 author user state Exp lines 0 0 New Source Command s completed successfully REJ10J2000 0100 Rev 1 00 Jun 16 2009 157 RENESAS High performance Embedded Workshop 9 Visual SourceSafe Version Control System 9 Visual SourceSafe Version Control System The High performance Embedded Workshop provides specific support for the Microsoft Visual SourceSafe version control system The Visual SourceSafe version control system associates a project in your workspace with a project inside a Microsoft Visual SourceSafe database Select a menu option from the Tools gt Version Control submenu or click a Version Control toolbar button to quickly activate the commands most frequently used in the Microsoft Visual SourceSafe version control system For installation and option settings of Microsoft Visual SourceSafe refer to the online help or user s manual for Microsoft Visual SourceSafe In this section it is assumed that the login username and password have been set The outline of procedures for version control by the High performance Embedded Workshop connected with Microsoft Visual SourceSafe is described below For other functions available see section 9 2 Visual SourceSafe commands 1 Attaching Microsoft Visual SourceSafe to a workspace
180. HE LOG LO SLEEP SUBMIT SU TOL Test Supporting Facilities Commands Command Name Abbreviation CLOSE_TEST_SUITE CTS COMPARE_TEST_DATA CTD OPEN_TEST_SUITE OTS RUN_TEST RT 3 Commands Description Comment Checks if an expression is true or false Switches the auto completion Clears the Command Line window Displays help for Command Line or help on a command Controls command output logging Delays command execution Executes a file of commands Turns TCL commands on or off Description Closes the current test suite Compares test data and create results Opens a test suite Runs a test Execution Commands Available when the debugger is connected Command Name Abbreviation FREE _GO FG GO GO GO_RESET GR GO_TILL GT HALT HA RESET RE STEP ST STEP_MODE SM STEP_OUT SP STEP OVER SO STEP_RATE SR Note Description Runs program ignoring any breakpoints Runs program Runs program from reset Runs program until specified addresses Halts program Resets the microprocessor Steps through program by instructions or source lines Sets the step mode Steps out of the current function Steps through program without stepping into functions Sets rate of stepping Support for this command depends on the debugger Memory Operation Commands Available when the debugger is connected Command Name Abbreviation CACHE FILE LOAD FL FILE LOAD ALL LA FILE SAVE FS FILE UNLOAD FU FILE UN
181. Hemose Default help file C C Standard Library Help 3 Click the Add button The Add Help File dialog box opens Add Help File Ei ES Description K Programing m ANSI C C File name _ Cancel c FILES HELP ANSI HLP Browse REJ10J2000 0100 Rev 1 00 Jun 16 2009 123 RENESAS High performance Embedded Workshop 6 Customizing the Environment Enter a description of the help file into the Description field 5 Enter the full path of the help file into the File name field or browse to it graphically by clicking the Browse button 6 Click the OK button to add the new help file to the list To make a help file the default choice select it from the Default Help File drop down list or set it to None if you would like to be prompted for a help file whenever F1 is pressed To remove a help file 1 Select Setup gt Customize The Setup Customize dialog box opens 2 Select the Help tab 3 Select the help file to be removed and then click Remove 4 Click the OK button to confirm the new help file settings 6 6 Keyboard shortcut customization The High performance Embedded Workshop allows the keyboard shortcuts to be customized to your own preferences This means that major operations can be configured to different keys especially useful if you are migrating from a different tool To reach the keyboard shortcut customization dialog click Setup gt Customize Then when Customize dialog box is
182. II cL ss Remove Workspace wide custom placeholders Placeholder A Madiiy ik Remove To add a custom placeholder 1 Select Setup gt Customize The Tools Customize dialog box opens 2 Select the Placeholders tab 3 Choose whether you need to use an application wide or workspace wide placeholder 4 Click the Add button which is adjacent to the list you require The Add New Placeholder dialog box opens 5 In the fields provided choose a suitable name for the placeholder and a description of what the placeholder means 6 Choose a directory which relates to this placeholder Note In High performance Embedded Workshop V 2 01 or later version the user defined directory can be set as the custom placeholder which can be used for setting the toolchain option When the directory path is specified specify an absolute path in Directory as shown in figure below Hew Custom Placeholder Ei E4 Placeholder ook ju SERDIR Cancel Description User define directory Directory g zeh SIC Browse 6 4 Using the workspace and project log facilities The High performance Embedded Workshop has workspace and project logging facilities integrated into the application These facilities can be switched on via the log tab on the Customize dialog box This option is especially useful when the network database is in operation This is because user names and changes are logged to this file
183. Image window Refresh Stop Automatically refreshes the Image window when user program execution stops Real time Regularly refreshes the Image window Refresh Now Refreshes the Image window Update Interval Specifies the refresh interval Next Image ot Redraws the next image Previous Image oth Redraws the previous image Top Image E s Redraws the top image Last Image je Redraws the last image Redraw 0 5s fi z The image is redrawn continuously every 0 5 seconds Interval 1 0s The image is redrawn continuously every 1 0 seconds 2 0s The image is redrawn continuously every 2 0 seconds 4 0s The image is redrawn continuously every 4 0 seconds REJ10J2000 0100 Rev 1 00 Jun 16 2009 326 RENESAS High performance Embedded Workshop 17 Debugging Facility Redraw Continuously ie Starts redrawing continuously Stop m Stops redrawing continuously Properties pr Opens the Image Properties dialog box Toolbar display Shows or hides the toolbar Customize toolbar Customizes toolbar buttons Note Available only when the debugger supports this function 17 4 2 Regularly refreshing the Image window Selecting Auto Refresh gt Nonrefresh from the pop up menu will not refresh the window Selecting Auto Refresh gt Stop from the pop up menu will allow the window contents to be automatically refreshed when user program execution stops Selecting Auto Refresh gt Real time from the
184. Insert Template dialog box e Click the Insert Template toolbar button U OR e Select Edit gt Templates gt Insert Template OR e Right click in the editor window and select Templates gt Insert Templates from the pop up menu 2 Use the Template Name drop down list to select the name of the template to be inserted and then click the OK button The dialog box is closed and the chosen template is added to the current Editor window Alternatively you can press ALT along with the number of the template to be inserted e g ALT 4 to insert template 4 You can define these shortcuts on the Defile Templates dialog box A drop down list is available at the bottom of the Defile Templates dialog box 4 12 Brace matching Complicated source code can often become unwieldy especially when blocks of C C code are deeply nested within each other or when complex logic statements are expressed within a large if clause To help in such situations the High performance Embedded Workshop editor provides a Brace Matching feature which highlights text between braces of type and To find a matching brace 1 Either highlight the open brace to match from or place the cursor before it 2 Select one of the following operations e Click the Match Braces toolbar button OR e Press CTRL SHIFT M OR REJ10J2000 0100 Rev 1 00 Jun 16 2009 104 RENESAS High performance Embedded Workshop 4 Editor e Select Edit gt M
185. J5H 45H7750A Simulator Litthe endian Target type SH 4 Target CFU all CPUs lt Back Next gt Finish Cancel 7 Specify the debugger targets in Step 7 Targets Sets the debugger targets Select by checking the debugger targets No selection or a selection of more than one target is possible Target type Specifies the type of the targets displayed in Targets Target CPU Specifies the CPU of the targets displayed in Targets Note The endian type selected in step 2 will be applied to the compiler settings This is separate from the endian type of the debugger target selected in step 7 To move to Step 8 click the Next gt button in Step 7 REJ10J2000 0100 Rev 1 00 Jun 16 2009 268 RENESAS High performance Embedded Workshop 17 Debugging Facility Hew Propect 9 Setting the Debugger Options Target name SH 4 Simulator Core single core gt Configuration name SimUlebug SH 4 Detail options Simulator I0 disable Simulator O addr Ox Bus mode T Modit T Initial session lt Back Next gt Finish Cancel 8 Set the options for the debugger targets selected in Step 8 Core Configuration name Detail options Specifies the target core By default the High performance Embedded Workshop generates two configurations Release and Debug If a debugger target is selected a configuration for the selected target is also genera
186. LOAD ALL UA FILE VERIFY FV MEMORY COMPARE MC MEMORY DISPLAY MD MEMORY EDIT ME MEMORY FILL MF MEMORY FIND MI MEMORY MOVE MV MEMORY TEST MT Note Description Sets caching on or off Loads an object program file Loads all object program files Saves memory to a file Unloads an object file from memory Unloads all object program files from memory Verifies file contents against memory Compares memory contents Displays memory contents Modifies memory contents Fills a block of memory Finds a string in an area of memory Moves a block of memory Tests a block of memory Support for this command depends on the debugger REJ10J2000 0100 Rev 1 00 Jun 16 2009 404 RENESAS High performance Embedded Workshop 3 Commands Software Break Setting Commands Available when the debugger is connected Command Name Abbreviation Description SET DISASSEMBLY _ SOFT BREAK SDB Sets or deletes a software breakpoint at the disassembly level SET SOURCE SOFT BREAK SSB Sets or deletes a software breakpoint at the source level STATE_DISASSEMBLY SOFT BREAK TDB Enables or disables a software breakpoint at the disassembly level STATE_SOURCE_SOFT_BREAK TSB Enables or disables a software breakpoint at the source level Other Debugging Commands Available when the debugger is connected Command Name Abbreviation Description CONNECT CN Connects the debugger DISCONNECT DN Disconnects the debugger INITIALIZE IN Init
187. Oct Display in octal Bin Display in binary 17 7 3 Switching Register Bank Immediately after opening the Register window the register data for the bank corresponding to the value of flag is displayed To switch the bank you can also use the pop up menu which is displayed by clicking the mouse right button on the register display area in the Register window or change the value of flag If you change the value of flag the register bank also changes in response to the value To reference the register data of Bank1 select Bank1 from the pop up menu with the Register window active The register specific to Bank is displayed in the gray background Screenshot of the M16C family debugger 1 BANK Register Window Meme Value RU OOO R1 aoai Re OOO R3 aopa AQ OOO Al aood FE aai USP aona ISP aoai Pe OFOOOO 4 rex ul z ojs s z o e 0 OOUO0OUOdOUD To reference the register data of BankO select BankO from the pop up menu with the Register window active Through the operation of option BankO and Bank1 the value of flag does not change Support for this function depends on the debugger REJ10J2000 0100 Rev 1 00 Jun 16 2009 341 RENESAS High performance Embedded Workshop 17 Debugging Facility 17 7 4 Setting the layout To set the layout of the Register Window choose Layout from the register Window pop up menu The followings can be selected Radix Switch display or non display of radix FLAGs Switch
188. REJ10J2000 0100 Rev 1 00 Jun 16 2009 85 RENESAS High performance Embedded Workshop 4 Editor 4 Editor This chapter describes how to use the editor that is provided with the High performance Embedded Workshop 4 1 Editor window The editor window contains the file windows that are being viewed or edited The title bar of the active window will appear a different color from that of the others dbsct c is the active window in figure bellow All text operations such as typing pasting text and so forth only affect the active window To switch to another source file window i e to make some other window the active window there are a number of methods e Click on it if it is visible OR e Press CTRL TAB or CTRL SHIFT TAB to cycle through the windows one after another OR e Select the window by name from the Window menu OR e Select its tab at the bottom of the editor window lal rezetpig c FE C Wforkspace DemoSH4 DemoSH4idbsct c Read Only Miel E H r Toolbar Ei JE Column ap e Pee eae AAAA AAAA ARAARA AAA Column Sean FILE dbsct c H Tab e dbecte ai oo a 2 dbsche Title bar Shows information on files file name asterisk while editing and Read Only attribute If a file is included in a directory of the current project the file name is displayed on the title bar of the editor window Otherwise the title bar of the editor window displays the file name including its absolute path Toolba
189. RL O CTRL F4 CTRL S CTRL SHIFT S CTRL P Toolbar Button Macro Recording 1 Main Menus Function Creates a new document Opens an existing document Closes the active document Creates a new workspace Opens an existing workspace Saves the current workspace Saves this workspace with a different name or in an old format Closes the current workspace Creates a new session Imports an existing session Saves the current session Saves the current session with a new session name Reloads the session file for the current session Downloads a new module Saves the active document Saves the active document with a new file name Saves all modified documents in the workspace Changes the printing options Prints the active document Opens this document Opens this workspace Opens this test suite Downloads this module Exits High performance Embedded Workshop Operations with some menu options can be recorded as High performance Embedded Workshop command line commands by the macro recording support facility A macro record icon in the Macro Recording column of a menu option indicates that this function can be recorded into a macro file For details see section 15 5 1 Recordable functions common to all High performance Embedded Workshop products 1 2 Edit Menu Options Menu Menu Option Edit Undo Redo Cut Copy Paste Clear Select All Shortcut Key CTRL Z CTRL Y C
190. Remove from VCS toolbar button ie OR e Select Tools gt Version Control gt Remove from VCS OR e Right click to invoke a pop up menu and select Version Control gt Remove from VCS Remove fram Woo Workspace _Name hyws CAWorksp a Project_Name hwup CAWorkep Cancel W Project Name c CAwworkep typedetine h CAworkep i idbsctc acl Pa Cem en I p 3 The Remove from VCS dialog box opens Select the checkbox on the left to the name of the file that you wish to remove and click the OK button 9 2 3 Getting read only copy of files from Visual SourceSafe Visual SourceSafe protects your source files and ensures that only one user can have a writable copy of a controlled file at any one time However it is possible for any user to obtain a read only copy of any file To get read only copy of files from Visual SourceSafe 1 Select the files that you would like to get from Visual SourceSafe in the Projects tab of the workspace window You may also select a file folder project folder workspace folder or combination thereof 2 Select one of the following operations i e Click the Get from VCS toolbar button OR e Select the Tools gt Version Control gt Get from VCS menu option OR e Right click to invoke a pop up menu and select Version Control gt Get from VCS REJ10J2000 0100 Rev 1 00 Jun 16 2009 162 RENESAS High performance Embedded Workshop 9 Visual SourceSafe Version Control System
191. SAS High performance Embedded Workshop 13 HMAKE User Guide There follows some examples of valid variable declarations EXECUTABLE c dir prog exe OUTPUT c dir2 filel out INPUT c dir2 filel c DEPEND c dir2 file2 h c dir2 file3 h c dir2 file4 h In order to use a variable later in the hmake file write the variable name with added to the front and added to the back The variable name along with the characters will be substituted with the variables value For examples of this see later under description blocks Only alphanumeric characters and underscore characters are allowed in variable names It is possible to use a variable inside the declaration of a different variable but all variables must be declared before they are used 13 3 Description blocks Basic outline A description block specifies one or more targets zero or more dependants and a list of commands which should be executed if the newest dependent is newer than the newest target If none of the targets exist and or none of the dependants exist then the commands will always be executed It is not necessary to specify any dependants if you wish the commands to always be executed A description block has the following syntax lt targetl gt lt target2 gt lt dependantl gt lt dependant2 gt lt command1 gt lt command2 gt gt lt commandn gt Any number of white space characters are allowed between
192. Select a makefile type in Generate makefile for e the current configuration in the currently active project e all configurations in the currently active project e all configurations in all loaded projects in the current workspace 5 Enter the file name in the MakeFile name edit box To insert a placeholder place the cursor at the position where you wish to insert the placeholder click the placeholder button and select Placeholder from the pop up menu The default makefile names are as follows e When the current configuration in the currently active project is selected PROJECTNAME _ CONFIGNAME mak e When all configurations in the currently active project is selected PROJECTNAME mak e When all configurations in all loaded projects in the current workspace is selected WORKSPNAME mak 6 Select a makefile format in the Makefile format drop down list High performance Embedded Workshop is capable of generating GNUMake HMake and NMake compatible files 7 Inthe Relative paths drop down list select how directories within the makefile should be expressed Workspace directory and below only is the default option See the table below for details Option Workspace Directory and below Outside the Workspace Directory None Absolute path Absolute path Workspace directory and below only Relative path Absolute path All Relative path Relative path Note While a SuperH or H8SX H8S and H8 family toolchain is in use th
193. Select the Display main function on download checkbox By default this checkbox is not selected 4 Click OK 5 Download a module For details on download see section 17 1 5 2 Downloading modules REJ10J2000 0100 Rev 1 00 Jun 16 2009 289 RENESAS High performance Embedded Workshop 17 Debugging Facility 17 1 5 6 Unloading of modules It is possible to manually unload downloaded modules When a module is unloaded its symbols are erased from the High performance Embedded Workshop debugging system but the memory contents of the target remains unmodified After a module has been unloaded it cannot be debugged unless it is reloaded To unload modules Select one of the following operations e Select the module which you wish to unload from the Debug gt Unload Modules submenu OR e Right click on the module in the Download modules folder on the Projects tab of the workspace window to display a pop up menu Select Unload It is possible to select two or more modules To unload all modules Select Debug gt Unload Modules gt All Downloaded Modules Select Debug gt Debug Settings The Debug Settings dialog box opens This will unload the modules from the target in the order specified in Download modules list on the Target tab 17 1 6 Debugger sessions The High performance Embedded Workshop allows you to store all of your builder options into a configuration This means that you can freeze all of the options an
194. Suite dialog box and will allow you to add tests which will then be executable To add tests to a test suite L Select Test gt Edit Test Suite The Modify Test Suite is then displayed 2 Click Add The Add New Test dialog box is displayed Add New Test k E Test name Test D ema Test description Demonstration Tests to execute Cancel ip File Path Demo Default Hemose Howi vem Hove dwan Plave abot eae Mave bor bop Mave up Mare danm Mowe to bottoni Test image file C Sworkspace D emoSH4 Test Suite Demo _Test_Demo hi p Browse To add a new test you should setup the following data l 2 10 11 Enter the test name There can be no spaces in this name Enter the test description This should describe the test in a verbose way so you will understand it at a later date To setup the actual tests to execute you should click the Add button The Add New Test Script dialog box is displayed See below The Script type box allows you to select a High performance Embedded Workshop macro HEW macro or a High performance Embedded Workshop command line batch file TCL command line batch file Selecting HEW Macro in the Script type drop down list shows all of the registered macro in the Select macros to add to test list You can select multiple macro files to be executed for each test This is achieved by selecting the checkbox next to the macro names you wish
195. TRL X CTRL C CTRL V Delete Toolbar Button fe Macro Recording Function Reverses the last editing operation Repeats the last undone editing operation Removes highlighted text and places it on the Windows clipboard Places a copy of the highlighted text into the Windows clipboard Copies the contents of the Windows clipboard into the active window at the position of the insertion cursor Removes highlighted text it is not copied to the Windows clipboard Selects i e highlights the entire contents of the active window REJ10J2000 0100 Rev 1 00 Jun 16 2009 395 RENESAS High performance Embedded Workshop 1 Main Menus Find CTRL F Fay Finds text in the current file Find In Files F4 Cay Finds text in multiple files Replace CTRL H Replaces text in the current file Goto Line CTRL G Jumps to a line in a file Match Braces CTRL SHIFT M f l Finds a matching brace Bookmarks Toggle CTRL F2 WA Sets a bookmark at the current line or Bookmark clears a bookmark at the current line Next F2 E Jumps to the next bookmark in the current Bookmark file from the current line Previous SHIFT F2 ma Jumps to the previous bookmark in the Bookmark current file from the current line Clear All cr Clears all bookmarks in the current file Bookmarks Templates Define ots Defines a template Templates Insert CTRL SHIFT T qF Inserts a template Template Toggle Breakpoint F9 Ah
196. Target SH 4 Simulator Core Single Core Target Debug format EID warta Download modules Offset Address Format SICONFIGDIAY PAO OOOU0U00 EID wart eatin Bemare Cancel i Target Core Debug format or Download modules can be selected on the Target tab of the Debug Settings dialog box Note that Core can be specified by using Synchronized Debugging facility To change the target the following operations is necessary L 2 on Select the project that needs to be changed in the tree on the left of the dialog It defaults to the current project Select the session which is to be modified in the drop list above the tree Change the target using the target drop list control This removes any target specific setup options that have been previously been set Moreover the Options tab of the Debug Settings dialog box provides the following options Configuring the automatic command line batch file execution Not executing a batch file when a module containing only debug information is downloaded Downloading modules after build Removing breakpoints on download Disabling memory access until after target connection command file execution Limiting disassembly memory access Not performing automatic target connection Resetting CPU after download module Disabling memory access by GUI when target is executing REJ10J2000 0100 Rev 1 00 Jun 16 2009 274 RENESAS High performance Em
197. Templates Go To Cursor Set PC Here Display PC View Disassembly Properties Note Macro Recording Function Builds the selected files Opens a file shown in the editor window Removes highlighted text and places it on the Windows clipboard Places a copy of the highlighted text into the Windows clipboard Copies the contents of the Windows clipboard into the active window at the position of the insertion cursor Adds the file to a project Shows the positions where navigation items of defines C functions or C classes are defined While the smart editor function is enabled selecting this option displays an alphabetical list of C defines C functions or C classes as a pop up window Double clicking on an item copies this character string and pastes it to the current cursor position Finds text in the current file Replaces text in the current file Jumps to a line in a file Finds a matching brace Sets a bookmark at the current line or clears a bookmark at the current line Jumps to the next bookmark in the current file from the current line Jumps to the previous bookmark in the current file from the current line Clears all bookmarks in the current file Defines a template Inserts a template Sets or clears a software breakpoint at the line showing the address Enables or disables the current software breakpoint Sets the status of editor and disassembly columns Sets the status of editor and
198. Test_Suite_Demo test suite icon ogee lS Z zl jie Test _ Suite_Demo TA Project E Templates al Navigation 1 14 6 Step 5 Editing a test suite Select the macro recorded at step for running a test 1 Right click on the Test_Suite_Demo test suite icon to display a pop up menu 2 Select Edit Test Suite to open the Modify Test Suite dialog box 3 Click the Add button The Add New Test dialog box opens 4 Enter Test_Demo in Test name REJ10J2000 0100 Rev 1 00 Jun 16 2009 28 RENESAS High performance Embedded Workshop 1 Overview Enter Demonstration in Test description Click the Add button The Add Test Script dialog box opens Select the Demo checkbox in Select macros to add to test Click the OK button oe a Add Test Script 9 Test image file shows the test suite name entered at step 4 _ and test name Test_Demo entered in Test name test suite name_test name This can be modified as required Add New Test HE Tebeo OOS E Default E bist Cop E oe TT k 1 b i _ file PE TO WOOT C WorkspacesDemoSH4 Test_Suite_Demo_Test_Demo hif b 10 Click the OK button The test Test_ Demo is added to the Test cases list REJ10J2000 0100 Rev 1 00 Jun 16 2009 29 RENESAS High performance Embedded Workshop Modify Test Suite Ei Test cases Ok ipti Cancel Test Derma Demonstration Modi R
199. To our customers Old Company Name in Catalogs and Other Documents On April 1 2010 NEC Electronics Corporation merged with Renesas Technology Corporation and Renesas Electronics Corporation took over all the business of both companies Therefore although the old company name remains in this document it is a valid Renesas Electronics document We appreciate your understanding Renesas Electronics website http www renesas com April 1 2010 Renesas Electronics Corporation Issued by Renesas Electronics Corporation http Awww renesas com Send any inquiries to hitp www renesas com inquiry CENESAS 8 10 11 12 Notice All information included in this document is current as of the date this document is issued Such information however is subject to change without any prior notice Before purchasing or using any Renesas Electronics products listed herein please confirm the latest product information with a Renesas Electronics sales office Also please pay regular and careful attention to additional and different information to be disclosed by Renesas Electronics such as that disclosed through our website 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
200. VS c is modified 8 11 2 8 Step 8 Using the Version Control facility Check the Status 1 2 3 4 The status of the file sampleCVS c should be checked Select Tools gt Version Control gt Status Select the file in the Status dialog box and click the OK button The Version Control tab of the output window shows the following message Executing C cvs 1 11 17 cvs exe status sampleCVS c File sampleCVS c Status Locally Modified Working revision 1 1 1 1 Tue Feb 28 02 46 30 2006 Repository revision 1 1 1 1 C cvs 1 11 17 DATABASE sampleCVS sampleCVS c v Sticky Tag none Sticky Date none Sticky Options none Command s completed successfully The status of the file sampleCVS c is shown as Locally Modified 8 11 2 9 Step 9 Using the Version Control facility Compare 1 2 3 4 The changes made in the file sampleCVS c should be checked Select Tools gt Version Control gt Diff Select the file in the Diff dialog box and click the OK button The Version Control tab of the output window shows the following message Executing C cvs 1 11 17 cvs exe diff sampleCVS c Index sampleCVS c RCS file C cvs 1 11 17 DATABASE sampleCVS sampleCVS c v retrieving revision 1 1 1 1 diff rl 1 1 1 sampleCVS c 28c28 31 lt printf Data Input n REJ10J2000 0100 Rev 1 00 Jun 16 2009 155 RENESAS High performance Embedded Workshop 8 Custom Version Control System gt Noop g
201. Whilst typing the pop up window will keep track of the keys you have pressed to help your selection If you press return then the currently selected member will be added This pop up window is also used when using the method and it is displayed in figure below Pressing CTRL SPACE displays the pop up window This pop up window disappears when a member is added class Sample p sam Posam new Samples sa mnButton sam nDialog agm nF ile ag m nline jm nFage Sm nsheet Pirn ee a e Ifyou are trying to use C or C functions then the pop up window in Figure below is displayed when the first open bracket is entered This pop up window allows you to see what functions are available for the current object Selecting the function automatically enters the remaining parameters for you Pressing CTRL SHIFT SPACE opens this pop up window which is visible until a closing bracket is entered REJ10J2000 0100 Rev 1 00 Jun 16 2009 187 RENESAS High performance Embedded Workshop 12 Navigation Facilities class Sample p sam Posam new Sample Pp san gt changel fort 1 03 void changellong a J F if lt 0 soe ee ali J e Itis possible to select a C function define C class or member function in the pop up window and add it to the High performance Embedded Workshop editor window by either of the following ways o Right click within the High performance Embedded Workshop editor window to display a pop up menu an
202. Workshop 17 Debugging Facility Hew Project 6 9 Setting the Vector 6 Specify the vector in Step 6 lt Back Next gt Finish Cancel What supporting files would you like to create Powerdh Reset H OO0 Power Un Rese _Manual Reget H U20 Manual Reset E Vector Definition Files Checking generates a vector definition file and a vector table setting function definition file Vector Handlers Handler Vector Note Displays the handler program name of the reset vector To modify the handler program after selecting the handler program name by clicking on it enter the new handler program name Note that if the handler program is modified a reset program resetprg c is not generated Displays a description of the vector Since the generated reset program interrupt functions reset vector handlers and interrupt source register definitions are samples be sure to refer to the CPU hardware manual To move to Step 7 click the Next gt button in Step 6 REJ10J2000 0100 Rev 1 00 Jun 16 2009 267 RENESAS High performance Embedded Workshop 17 Debugging Facility Hew Project 9 Setting the Target System for Debugging SH 4 Functional Simulator 2 5H 4 Simulator C SH 4 Sinmnulator Litthe endian SH 4 with BSC Simulator SH 4 with BSC Sinmulator Litthe endian CJ5H 45H7 750A Functonal Simulator J5H 45H7 750A Functonal SimulatorfLit C 5H 45Hr 750A Simulator
203. Workspace To save the workspace in a previous version s format select File gt Save Workspace As If the current workspace has changed since it was last changed you will be prompted to save it to the current file and version The Save Workspace As dialog box will then be launched Save Workspace As Files Saved Filename Director Workspace Namehwe CA WorkSpace Workspace_ Mame Project Mame hwp CW WorkSpace Workepace NameSProject Name Defaults ession hef CA ork SpaceWworkespace Mame Project Name SimSessionSH Tksh CA WworkSpaceWorkepace Name Project Name Format Pretix HEW 4 06 00 Format current l HE 4 06 00 Format curent HEW 4 05 00 Format HE 4 04 00 Format HEW 4 03 00 Format HEW 4 02 00 Format HE 4 07 00 Format HE 4 00 00 Format This contains a list of all the files currently associated with the workspace a drop list control containing a list of available versions the current version is selected by default and an edit control where you can enter a short prefix that will be used to change the name of all the associated files When the prefix is changed the File list is updated to display the new names For example to save the workspace in a format that can be loaded from High performance Embedded Workshop V 4 02 00 1 Set the Format drop down list HEW 4 02 00 Format 2 Enter Prefix 402_ 3 Click OK REJ10J2000 0100 Rev 1 00 Jun 16 2009 15 RENESAS High performance Embed
204. XE Argument FILENAME Initial directory PROJDIR Log Version control executable C RCS RLOG EXE Argument FILENAME Initial directory PROJDIR Preparation for version control is now completed 8 11 1 4 Step 4 Using the Version Control facility Check in 1 Enter a keyword at line 12 in the file rcs_sample c so that you will be able to see the changes made in the file Id 2 Select the file rcs_sample c in the Projects tab of the workspace window and then select Tools gt Version Control gt Check in 3 The MS DOS command prompt window opens REJ10J2000 0100 Rev 1 00 Jun 16 2009 149 RENESAS High performance Embedded Workshop 8 Custom Version Control System 4 Enter a comment for check in after the prompt gt gt and press Enter 5 Enter one period and press Enter rcs_sample c v lt rcs_sample c enter description terminated with single or end of file NOTE This is NOT the log message gt gt initial revision 1 1 done C RCS gt 6 Enter exit and press Enter This closes the MS DOS command prompt window 7 A High performance Embedded Workshop confirmation dialog box appears Click Yes The keyword now includes the file name revision number date and user name Tip If you do not wish to see the result of command execution in the MS DOS command prompt window select the Close DOS Window on exit checkbox in the General tab of the Version Control Setup dialog box 8 11 1 5 St
205. Yorkspace DemoSH4 DemoSH4 Debug DemoSH4 abs ves Yes to all Ho to all Cancel Save the High performance Embedded Workshop environment setting that you wish to use for tests so that the environment for the tests will always be the same 1 Select File gt Save Workspace 2 Select File gt Save Session You can always use the same environment to start a test by loading the High performance Embedded Workshop environment setting that has been saved e Preparing a test script to be used in the example of test procedures In this example use the macro recording support facility to record the following combination of operations as High performance Embedded Workshop command line commands into a macro This macro should be used as a test script at execution of a test REJ10J2000 0100 Rev 1 00 Jun 16 2009 24 RENESAS High performance Embedded Workshop 1 Overview Classification Operation Preparation before the running the program Reload the session Initialize values See Step 1 2 Prepare a program Initialize register values See Step 1 3 Build the program for demonstration See Step 1 4 Download the program Download the program for demonstration See Step 1 5 Add variables run the program and check Use the memory fill function to set the memory value of array a to 0 the result See Step 1 6 Reset the CPU See Step 1 7 Run the program until a s
206. You can save an area of memory in the address space to a text file using the Save Memory Contents feature Select an address range to save in the Memory window by dragging the mouse Choose Save Memory contents from the pop up menu of the memory window The Save memory contents dialog box opens Select the output range in Memory Save Area data format in Data Length number of digits in Column radix in Radix It is possible to select showing hiding of the Label column and Register column by Output the label column and Output the register column respectively If you did not drag the address range to be saved you must enter the output range Save memory contents Save ihi E SH4demo fo ft ee Debug SimbDebug_ SH 4 Readme tet File name PO Save as Ippe Test Fies Cancel blemon Save Area jooooacno Bl foooooorF Gal Data Length byte Column i A adi Hex Code jasch H I Output the label column M Output the register column E REJ10J2000 0100 Rev 1 00 Jun 16 2009 315 RENESAS High performance Embedded Workshop 17 Debugging Facility 17 3 9 Finding a value in memory You can find a value in memory using the Search Memory feature Select an address range to search in the Memory window by dragging the mouse Choose Search from the pop up menu of the memory window The Search memory dialog box opens Start Address joonan End Address o000F F Data fi FEE search Data As 2byte x
207. a bold R this value will be updated in real time e Double clicking within the Name column opens the Edit Name dialog box in which you can change the name of the watch item Changing of the name can be recorded in a macro Macro Recording e Double clicking within the Value column opens the Edit Value dialog box in which you can change the value of the watch item Changing of the value can be recorded in a macro Macro Recording e Inthe Value column the values of watch items can be changed by in place editing Macro Recording e You can also watch variables in the selected scope The following choices are available Auto valid local variables Global global variables and scope specific to each file static variables within the file scope e Double clicking on the Scope column opens the Set Scope dialog box e Inthe Scope column the scope can be changed by in place editing Note Support for scope setting depends on the debugger in use and the Debug format selected in the Debug Settings dialog box When this feature is not supported the selection is Auto and this is not changeable REJ10J2000 0100 Rev 1 00 Jun 16 2009 366 RENESAS High performance Embedded Workshop 17 Debugging Facility Options Right clicking displays a pop up menu containing available options A basic operation is allocated to the toolbar The Toolbar display and Customize toolbar options are also included in the pop up menu opened by right clic
208. ab 3 Select the Prompt before saving session checkbox 4 Click the OK button Jf Prompt before saving session 6 8 7 Enabling auto backup facilities The High performance Embedded Workshop supports the facility to backup the workspace project and session files at regular intervals This means that if your application or development system should fail you will not lose so much work Any changes you have made will be saved to temporary files When re opening the workspace you will be prompted and asked if you wish to auto recover the files that were not saved during your last session To enable auto file backup facilities 1 Select Setup gt Options The Options dialog box opens 2 Select the Workspace tab 3 Select the Save Auto Recovery info checkbox as necessary 4 Select the number of minutes you wish the auto backup facility to be launched 5 Click the OK button J Save Auto Recovery info every fio minutes Restoring your files If you open your workspace and the following dialog is displayed it means that the last time the workspace was used problems were encountered REJ10J2000 0100 Rev 1 00 Jun 16 2009 128 RENESAS High performance Embedded Workshop 6 Customizing the Environment HEW workspace Auto Recovery HEW failed to shutdown correctly the last time vou used this workspace Would vou like to recover the following tiles rather than Use the saved versions Filename Director demo hws cc dema de mo
209. abling memory access until after target connection command file execution When this checkbox is selected if a command batch file to be automatically executed at connection to the target has been specified the memory in the target will not be accessed until execution of the command batch file is finished To disable memory access until after target connection command file execution 1 Select Debug gt Debug Settings The Debug Settings dialog box opens REJ10J2000 0100 Rev 1 00 Jun 16 2009 276 RENESAS High performance Embedded Workshop 17 Debugging Facility Select the Options tab Select the Disable memory access until after target connection command file execution This option is useful when initial setting of memory is necessary at connection to the target By default this checkbox is not selected 4 Click OK 6 Limiting disassembly memory access Disables reading data from memory outside the displayed range in disassembly mode To limit disassembly memory access 1 Select Debug gt Debug Settings The Debug Settings dialog box opens 2 Select the Options tab 3 Select the Limit disassembly memory access Default for this checkbox depends on the target 4 Click OK 7 Not performing automatic target connection If this checkbox is selected the target is not connected until you select Debug gt Connect Support for this function depends on the debugger To not perform automatic target connection 1 Sele
210. ace name WORKSPNAME Workspace name Project name PROJECTNAME Current project name Line number LINE First line number of template insertion Time TIME Current time Date text DATE_TEXT Current date in text form Date day month year DATE_DMY Current date in dd mm yy form Date month day year DATE_MDY Current date in mm dd yy form Date year month day DATE_YMD Current date in yy mm dd form User name USER Current Windows user Cursor position CURSOR Insertion cursor positions the cursor in this position after template has been inserted 6 Enter CURSOR to specify where the insertion cursor is to be placed after the template has been inserted If this is not specified then the insertion cursor will be placed after the last character in the template as in a normal paste operation 7 There are 10 shortcut keys reserved for templates If you want to designate one of these select the key in the drop down list at the bottom of the edit template dialog box These range from ALT 0 to ALT 9 User input When defining a template it is possible to define a user input field Using the following placeholder specifies this USERINPUT lt n 1 10 gt I lt some text gt The n is a number which identifies the user input identifier These placeholders can be added manually but the User Input button on the Define Templates dialog box adds these placeholders in an automated manner When the template is insert
211. aceholder from the pop up menu 5 Click the OK button to confirm the new log file settings MW Generate build log Path stWORKSPDIRMStWORKS PHAME txt Browse 3 7 Changing toolchain version If two or more versions of the same toolchain are registered in the High performance Embedded Workshop you can choose a version of the toolchain on the Change Toolchain Version dialog box To invoke the dialog select Tools gt Change Toolchain Version Choose one of the versions from the Toolchain version drop down list and click the OK button to enforce your choice REJ10J2000 0100 Rev 1 00 Jun 16 2009 78 RENESAS High performance Embedded Workshop 3 Advanced Build Features Change Toolchain Version Ed Toolchain name Renesas Super RISC engine Standard Current version 9 7 0 0 Cancel CPU Family SuperH RISC engine Toolchain Renesas SuperH RISC engine Standard Toolchan version EENI Toolchain build phases Informetion OptLinker SH Assembler r 01 02 SH CC Compiler 3 02 00 SH CrC Library Generator To show information about toolchain components select a tool from the Toolchain build phase drop down list on the Change Toolchain Version dialog box and click the Information button A tool information dialog box will show you information about the tool Click the Close button to close the dialog box 3 8 Generating a makefile The High performance Embedded Workshop
212. ads an I O file Selected IO Register R eta ne register s to be shown on the Select Register Print E Prints the current data of the window Save To File Saves the current data of the window to a text file REJ10J2000 0100 Rev 1 00 Jun 16 2009 335 RENESAS High performance Embedded Workshop 17 Debugging Facility Find ith Finds an I O register Find Next Finds the next I O register to match Toolbar display Shows or hides the toolbar Customize toolbar Customizes toolbar buttons 17 6 2 Expanding an I O register display To display the names addresses and values of the I O registers double click on the module name or select the module name by clicking on it or using the cursor keys and press the cursor right key The module display will expand to show the individual registers of that peripheral module and their names addresses and values Double clicking or pressing the cursor left key again on the module name will close the I O register display Note If you are using an emulator based debugger reading data from an I O register can sometimes affect the operation of your program For example reading a data register can cancel a pending interrupt Data is only read from I O modules that have been expanded in the IO window so that the register values are displayed Therefore as long as I O modules are collapsed when they no longer need to be displayed this will not cause a problem Also note that having a
213. age ranges that are currently available 2 Ifyou select coverage ranges in the Available Ranges list and click the gt gt button these coverage ranges then appear in the Ranges to be tested list 3 The Address checkbox among test options is always ON because addresses must be saved whenever coverage ranges are saved into test image files users cannot control this selection To set other test options Execution Path Execution Times and Pass select the check boxes for these options The Execution Path checkbox is selected by default Other check boxes are not selected by default 4 Click OK REJ10J2000 0100 Rev 1 00 Jun 16 2009 252 RENESAS High performance Embedded Workshop 16 Test Support Facility 16 6 2 7 Code Trace Trace window The following table shows information on the test image data to be saved into test image files and test results not matched Test group name Code Test item name Trace Test image data to be Values set as detailed information and the range of data in the Trace window acquired with this setting saved into test image files No trace range is specified by default Test result details Comparing PTR Compared trace range Trace type Trace type Trace data is not matching PTR Unmatched trace range Src Content of the test image file Dest Data in the current High performance Embedded Workshop system or in another test image file to be compared with Example Comparing PTR 3 to 1 Trace type Trace
214. ain 9 2 0 0 Properties EE Mame Super RISC engine Standard Toolchain Version 9 2 0 0 Location C Program Files Aenesas Hew T ools Henesas Shid 2 0 Select the Information tab to view any information about the component This may include copyright information enhancements and so on REJ10J2000 0100 Rev 1 00 Jun 16 2009 112 RENESAS High performance Embedded Workshop 5 Tools Administration SuperH RISC engine Standard Toolchain 9 2 0 0 Properties Ei Ed General Information Environment SUPE Information High performance Embedded workshop Super RISC engine Standard Toolchain V9 2 0 0 Super RISC engine C C Standard Library Generator 3 00 02 Super ASC engine C C Compiler M 9 02 00 If there is an issue with the component and it is working incorrectly additional information is displayed here Select the Environment tab if it exists to view and edit a component s environment settings This tab is most commonly used to modify the environment of a toolchain SuperH RISC engine Standard Toolchain 9 2 0 0 Properties EE Environment varables PATH Program Files sAenesas sHew T ools Henesas oh SHO INC C Program Files RenesassHews ools Renesas s SHC_LIB C Program Files enesas Hew Tools Henesas45 Moclitin SHL_TMP C 5DOCUME 150 ser LOCALS 15T emp el Fenove Add To add a new environment variable 1 Click the Add button The Environment
215. ain use conditions Further Renesas Electronics products are not subject to radiation resistance design Please be sure to implement safety measures to guard them against the possibility of physical injury and injury or damage caused by fire in the event of the failure of a Renesas Electronics product such as safety design for hardware and software including but not limited to redundancy fire control and malfunction prevention appropriate treatment for aging degradation or any other appropriate measures Because the evaluation of microcomputer software alone is very difficult please evaluate the safety of the final products or system 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 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 Electronic
216. allows you to generate a makefile associated with your workspace High performance Embedded Workshop is capable of generating hmake nmake and gnumake compatible files The make tool to execute makefiles is operated in the DOS command prompt and thus the use of makefiles allows you to build projects without High performance Embedded Workshop The generated makefiles can be executed in the High performance Embedded Workshop For details see section 3 9 Using a makefile inside the High performance Embedded Workshop system To generate a makefile 1 Open a workspace where you wish to generate a makefile if the workspace includes two or more projects the active project must be one in which you wish to generate a makefile 2 Select a configuration for generating a makefile 3 Select Build gt Generate Makefile The Generate Makefile dialog box opens REJ10J2000 0100 Rev 1 00 Jun 16 2009 79 RENESAS High performance Embedded Workshop 3 Advanced Build Features Generate Makefile Generate makefile for the current configuration in the currently active project C all configurations in the currently active project Cancel C all configurations in all loaded projects in the current workspace Makefile name PROJECTNAME _ CONFIGNAME mak gt Makefile format HM ake Z Relative paths Workspace directory and below only Use static sub command files M Scan dependencies whilst building make file 4
217. alog box Management To view the License Management help double click Tools Renesas DebugComp Ecx EcxLicMgr EcxLicMgr chm under the High performance Embedded Workshop installation directory About Opens the About High performance Embedded Workshop High performance Embedded dialog box allowing the user to view the version of High Workshop performance Embedded Workshop Debugger Help Shows the help window of the emulator or simulator when the debugger is connected REJ10J2000 0100 Rev 1 00 Jun 16 2009 400 RENESAS High performance Embedded Workshop 2 Windows Window Name Differences Map Section Information 1 Map Symbol Information 1 Command Line Console 2 Workspace Output Disassembly Registers Memory lO Status Image 1 Waveform 1 Stack Trace Test Browser Notes Opened by View gt Difference View gt Map View gt Map View gt Command Line View gt TCL Toolkit View gt Workspace View gt Output View gt Disassembly View gt Registers View gt Memory View gt CPU gt IO View gt CPU gt Status View gt Graphic gt Image View gt Graphic gt Waveform View gt Code gt Stack Trace Test gt Test Results Browser 1 Support for this function depends on the debugger 2 See the Tcl Tk Additional document REJ10J2000 0100 Rev 1 00 Jun 16 2009 401 RENESAS 2 Windows High performance E
218. als View gt Symbol gt Locals H8 300H Tiny series compact emulator debugger e E100 emulator debugger E8 emulator software e E8a emulator software Simulator debuggers for H8SX H8S and H8 families ASMWatch View gt Symbol gt ASMWatch e Simulator debuggers for M16C family CWatch Cie gt Symbol gt CWatch Simulator debuggers for 740 family S W Break Points View gt Break gt S W Break Points n Emulator debuggers for M16C family Excluding the following debuggers E100 emulator debugger E8 emulator software REJ10J2000 0100 Rev 1 00 Jun 16 2009 221 RENESAS High performance Embedded Workshop Address Interrupt Break Points View gt Break gt Address Interrupt Coverage Trace Event Code Coverage Data Coverage Hardware Break Trace conditions Violation of access protection Uninitialized area detection Violation of stack access Violation of task stack access Performance Analysis Conditions Trigger Output Conditions Realtime Profile Configuration Configuration properties Device Setting Start Stop Function Setting Break Points View gt Code gt Coverage View gt Code gt Trace View gt Code gt Eventpoints View gt Code gt Code Coverage View gt Code gt Data Coverage View gt Event gt Hardware Break View gt Event gt Trace Conditions Click the Detail button for Access Protect Violation in the Hardware Break or T
219. an be recorded a macro record icon is shown in the Macro Recording column of the menu list This indicates that this operation can be recorded into a High performance Embedded Workshop macro file Notes 1 Changing a project session or configuration 2 Compilation and build 3 Downloading a module changing a memory value or register value setting deleting a software breakpoint and running a program The macro recording support facility is available in the Tools menu and on the Macros toolbar The procedure from selection of Record Macro to that of Stop Macro consists one macro and one High performance Embedded Workshop macro file can record multiple macros a set of High performance Embedded Workshop command line commands A macro includes multiple High performance Embedded Workshop command line commands 15 1 Macro menu and toolbar The macro recorder has both a menu and toolbar integrated into the High performance Embedded Workshop The macro menu is available on the Tools menu It has the following standard menu options Macros Record Macro D Play Macro m Stop hacia The Macros menu option opens the Macro dialog box This allows management of the current macro files and functions The other menus options are the same as those seen on the Macros toolbar It is also possible to associate macro functions with a menu when you do this additional menu options are added underneath the standard macro me
220. and later o C Compiler package for M32C series V 5 41 Release 00 and later o C Compiler package for R32C series V 1 01 Release 00 and later e To view the information on sections and symbols To view the information on sections and symbols the following setting is required in advance 1 Select Build gt xxxxxx Standard Toolchain to open the build options dialog box 2 Select List for Category in the Link Library tab 3 Select the Generate list file checkbox This allows output of information on sections 4 Click the Enable all button This allows output of information on symbols 5 Select Build gt Build REJ10J2000 0100 Rev 1 00 Jun 16 2009 189 RENESAS High performance Embedded Workshop 13 Map C C Assembly Link Library Standard Library CPU _4 gt Category List W Generate list file Contents Show symbol Wl Show reference ao Disable all Iw Show cross reference Options LinkLibrary noprelink rom D A nomessage ist H CONFIGDIA AHPROJECTNHAME l map show symbol reference sreference nooptimize Note If a subcommand file is specified as shown below the section setting information of the linkage editor will not be shown in the Map Section Information window C C Assembly Link Library Standard Library CPU _4 gt Category Subcommand file ii M Use extemal subcommand file Subcommand file path CONFIGDIFYMilet sub Options LinkLi
221. and menus are enabled When the macro is being recorded the pause and stop buttons DI and menus are enabled 2 If you are using a debugger that does not support the macro facility a warning is displayed that states the following Warning The target does not support macros Recording will be limited Do you wish to continue If you click yes the record operation will continue 3 Recording will continue until you click Stop Macro For details see section 15 5 Functions that can be recorded into macro files 4 When Stop Macro is clicked a dialog is displayed that allows you to enter the macro name Clicking OK saves the name and adds it to the current macro file Clicking cancel dismisses the dialog box and loses the macro recording Another method is to launch the recording process via the Macro dialog box To record a macro from the macro dialog box 1 Select Tools gt Macros The Macro dialog box opens 2 Click the Record button The Macro dialog box is dismissed and the recording operation begins 15 5 Functions that can be recorded into macro files High performance Embedded Workshop is not capable of recording all operations in the High performance Embedded Workshop system into macro files as scripts For the operations that can be recorded Record Macro in the menu list shows a macro record icon This indicates that the operation can be recorded into a macro file e Recordable functions common to all High pe
222. ange all intibe_hoopeO del vacant_loopel See section 2 7 Build configurations for more information about a configuration e Session What is session Sessions which have their own names are the units to manage various settings such as High performance Embedded Workshop debugger options used for debugging with connection to the debugger and options specific to the debugger and information on the Memory and Register windows and their positions The term session can also be referred to as debugger session REJ10J2000 0100 Rev 1 00 Jun 16 2009 19 RENESAS High performance Embedded Workshop 1 Overview In the figure of the Standard toolbar shown as an example sessions SimSessionSH 4 and DefaultSession are available Information on each session is saved in an individual file in the High performance Embedded Workshop project Note There are various option settings such as the debugger to be connected with the High performance Embedded Workshop the object format for debugging download modules and the timing of connecting the High performance Embedded Workshop with the debugger or executing a command batch by the High performance Embedded Workshop Sessions created by the High performance Embedded Workshop When a project is created after selection of the toolchain the High performance Embedded Workshop automatically creates session DefaultSession If you have selected a target debugger at creation of the proje
223. ap list shows all symbol information in the right pane Selecting a section in the map list only shows symbol information of the selected section in the right pane e The right pane shows the symbol information of the linkage editor Clicking the column header sorts the listed items When the window is first opened the items are sorted by the value of Start Address The Attribute column shows the symbol attribute Entry Entry function Function Function name Data Variable name None Undefined label or assembly symbol The Scope column shows the scope attribute Global Global symbol Local Local symbol Window options e Map list of the linkage editor left pane Right clicking displays a pop up menu containing available options A basic operation is allocated to the toolbar The Toolbar display and Customize toolbar options are also included in the pop up menu opened by right clicking on the toolbar Pop up Menu Option Toolbar Button Function Print Prints section tree view Toolbar display Shows or hides the toolbar Customize toolbar Customizes toolbar buttons e Symbol information of the linkage editor right pane Right clicking displays a pop up menu containing available options A basic operation is allocated to the toolbar The Toolbar display and Customize toolbar options are also included in the pop up menu opened by right clicking on the toolbar Pop up Menu Option Toolbar Button Func
224. ar area When the status bar is completely hidden this main menu option will switch on the application based section of the status bar The status bar can also be switched off via the status bar pop up menu The pop up menu allows individual status bar items to be toggled on and off including both application and target related areas as well as individual items on each The pop up menu can be displayed by selecting the right mouse button over the status bar area Ez Default desktop Showing hiding the entire target related area Ter Debugger Showing hiding the entire application related area Lv Application Note The entire target related area of the status bar is hidden depending on the target being used All target related status bar items are switched off the entire target related area of the status bar will be hidden by default This can be re shown by switching on one or more target related individual status bar items 1 3 Help system The Help menu is the rightmost menu on the High performance Embedded Workshop menu bar It contains the Help Topics menu option which when selected takes you to the main High performance Embedded Workshop help window To obtain help on specific dialogs click the context sensitive help button which is located in the top right hand corner of each dialog as shown in the figure below Context Sensittve Help Suton B Close Button When this is clicked the mouse pointer will change to
225. arks OR e Right click and select Bookmarks gt Clear All Bookmarks from the pop up menu 4 6 Printing a file To print a file 1 Ensure that the window whose contents you want to print is the active window 2 Select one of the following operations e Click the Print toolbar button S OR e Press CTRL P OR e Select File gt Print 4 7 Configuring text layout 4 7 1 Page set up When you print a file from the High performance Embedded Workshop editor the settings in the print dialog affect the way the file is printed e g double or single sided Control over how the text is formatted on the page can also be controlled via the Page Setup option This allows you to specify the margins top bottom left and right of your printouts It is often necessary to set this because some printers cannot print to the edges of an A4 page Furthermore some users have their own layout requirements e g a large left hand margin so that code can be placed in an A4 binder REJ10J2000 0100 Rev 1 00 Jun 16 2009 96 RENESAS High performance Embedded Workshop 4 Editor To set up the page margins 1 Select File gt Page Setup The Page Setup dialog box opens 2 Enter the width of the margins required into the Left Right Top and Bottom fields 3 Set the Inch or mm option accordingly 4 Click the OK button for the new settings to take effect m ooo Bottom To set up the header and footer information 1 Select File
226. as opened the Unsync button will be enabled In order to stop using synchronized debugging click the Unsync button Any synchronized High performance Embedded Workshop applications will disconnect from their platform and function independently again The Debugger s tab will be removed form the Workspace Window Debugger operations will no longer be synchronized No High performance Embedded Workshop applications will be closed down 18 2 Using High performance Embedded Workshop while synchronized The main purpose of using High performance Embedded Workshop in synchronized debugging mode is to have the main Debugger options synchronized between different High performance Embedded Workshop debugging sessions usually connected to a multi core platform Many aspects of High performance Embedded Workshop functionality are the same when using Parallel or Internal mode however some things will be different 18 2 1 Common functionality ey Projects E Templates al Maviga et Debuggers Debug gers tab This tab is added to the Workspace Window when synchronized debugging begins It contains a separate item for each synchronized Debugger The text of each item will be the display ID specified on the Synchronized debug dialog The icon of each item indicates the current status of the Debugger The following status icons are possible et The Debugger is not connected to a platform The Debugger is connected to a platform which is currently s
227. as two tabs All Register and Selected Register When the IO window is first opened only a list of module names is shown on the All Register tabbed pane Window configuration Column Aedes a z Toolbar MOCLITE TE a caetanntammtemammettmtetatatanttaetatettaaaetaataceeaea eee aaaeenaraareaaia Register FFOOOOOO ooo0000d Bit 0 FFOOOOO4 o a FFOOOOOs OOOO0000 FFOOOOOC FFOOOO1O OOOO0000 Jj Interrupt Control ajh All Register Tab Description All Register Shows all I O registers Selected Register Shows selected I O registers This page is blank by default e O registers can be expended e If the value of an I O register is changed the value is displayed in red e Double clicking on the line of an I O register opens a dialog box in which you can change the value Changing of the value can be recorded in a macro Macro Recording e The values of I O registers and their bits can be changed in the Value column by in place editing Macro Recording Options Right clicking displays a pop up menu containing available options A basic operation is allocated to the toolbar The Toolbar display and Customize toolbar options are also included in the pop up menu opened by right clicking on the toolbar Pop up Menu Option Toolbar Button Macro Recording Function Refresh zl Refreshes the IO window Lock Refresh Ej Disables refresh of the IO window Load IO File Manually lo
228. atch Braces OR e Select Match Braces from the pop up menu To check the structure of an entire file place the cursor at its start and then repeatedly invoke the match brace operation The editor will successively highlight each pair of braces in turn until there are no more left to match 4 13 Setting the read only attribute for a file While using the High performance Embedded Workshop you can set a file to be read only When you attempt to save a read only file a confirmation dialog box appears asking if you wish to save the file as another name To set a file to be read only 1 Select one of the following operations e Right click on a file in the Projects tab of the workspace window to open a pop up menu You can even select multiple files OR e Right click within the editor window to open a pop up menu 2 Selecting Properties opens the Properties dialog box Select the Read only checkbox If you have selected two or more files including both read only and writable files the checkbox is gray intermediate state By default this checkbox is not selected 4 The title bar of the editor window shows Read Only When a file is open within the editor window and if you switch on off the read only attribute of the file via the Windows Explorer it does not match the attribute shown on the title bar of the editor window because the title bar is not updated The attribute shown on the title bar is not updated until you start m
229. atch items are selected 4 Expanding a watch item If a watch item is a pointer array or structure then you will see a plus sign expansion indicator to left of its name this means that you can expand the watch item To expand a watch item click on it The item expands to show the elements in the case of structures and arrays or data value in the case of pointers indented by one tab stop and the plus sign changes to a minus sign If the elements of the watch item also contain pointers structures or arrays then they will also have expansion indicators next to them To collapse an expanded watch item click on the item again The item s elements will collapse back to the single item and the minus sign changes back to a plus sign The watch item can be expanded for the number of levels when a numerical key from to 9 is pressed while a watch item is selected 5 Editing a watch item s value You can change the value of a watch item To edit a watch item s value Select either of the following ways REJ10J2000 0100 Rev 1 00 Jun 16 2009 369 RENESAS High performance Embedded Workshop 17 Debugging Facility e In place edit in the Value column RoE EW EA pS eee ee ilong l0 Auto ilong ilong e Open the Edit Value dialog box in one of the following ways o Double click within the Value column o Press the Enter key on the line of a watch item o Right click on the line of a watch item and sel
230. ate New Test Image EE Available components OK og se Stack Trace SimSessionSH 4 OEY Trace SimSessionSH 4 Cancel OS cru 2 De O SimSessionSH 4 C Memory SimSessionSH 4 Check All Ea Reaister SimSessionSH 4 QA Simulated 0 SimSessionSH 4 E Status SimSessionSH 4 settings OA Output OE Build Output window Import EERE Dee Symbol 8S Locals SimSessionSH 4 fne DX Watch SimSessionSH 4 2 Clicking the Check All button selects all checkboxes while clicking the Uncheck All button deselects all checkboxes REJ10J2000 0100 Rev 1 00 Jun 16 2009 236 RENESAS High performance Embedded Workshop 16 Test Support Facility 3 Click the Import button to open the Import the Test Image File dialog box Browse to the HIF file location The settings of an existing test image file are imported 4 Each component is listed in the dialog box Check the checkbox next to the component name to save data for that component Test Group Oe a O SimSessionSH 4 Testltem Session 5 Select the component in the dialog and then click the Settings button A dialog box will be displayed that is dependent on the selected component This will allow you to customize the data that is saved to the file For details see section 16 6 Functions that can be saved as test image data into test image files Clicking OK will dismiss the dialog and store the changes that you have set up The Save Test Image File dialog box
231. ate the testing procedure Then once the testing has been completed the results are displayed in an easy to understand format in the test browser window This can significantly reduce the work needed to execute many regression tests The test tool uses the TCL command line batch files as its method of executing the features and functions of High performance Embedded Workshop These functions can be created easily using the macro recorder feature or by manually editing them yourself If you need to automate the execution of the actual tests the test tool also supports command line operation Many commands are available that allow you to open and close suites run and compare test data The first step towards using the test tool is to create a test suite This is available on the main Test menu Then you must edit the test suite to create some actual tests Then you can execute the tests using the Run tests menu option Note however that High performance Embedded Workshop is not capable of acquiring test image information of all functions in the High performance Embedded Workshop system For the items from which test image information can be acquired see section 16 6 Functions that can be saved as test image data into test image files 16 1 Creating a test suite A test suite is a set of tests A test suite has a very similar concept to a workspace The test suite can contain many tests which in turn can contain many macros to be executed Te
232. atically shown in the Projects tab of the workspace window once the module has been downloaded The files for a download module are retrieved when the module is downloaded REJ10J2000 0100 Rev 1 00 Jun 16 2009 283 RENESAS High performance Embedded Workshop 17 Debugging Facility If the files are not full paths and are relative or short file names they will automatically be searched for relative to the download module directory Files that cannot be found after the initial search will be shown to you in the Locate Files dialog box However you can choose not to open the Locate Files dialog box at downloading To prevent opening of the Locate Files dialog box at downloading 1 Select Setup gt Options The Options dialog box will be displayed 2 Select the Confirmation tab 3 Select the Do not show Debug only workspace browse dialog on download checkbox This checkbox is not selected by default 4 Click OK e Debuggers supporting the feature of showing a source tree This feature is only supported by the debuggers that can create debug only projects The condition of the support however depends on the debugger as shown below Debugger Condition of the Support SuperH family emulator debugger The High performance Embedded Workshop has become V 4 02 or later due to an H8SX H8S H8 family emulator debugger update M16C family emulator debugger The High performance Embedded Workshop included in the product package is V 4 0
233. ations to open the Download Module dialog box Select File gt Download A New Module OR Right click on a module or within the Download modules folder on the Projects tab of the workspace window to display a pop up menu Select Download A New Module All fields must be setup for the download module to be configured correctly Offset ii ff File format ElOwaf Cancel Filename SICONFIGDIR I PROJECTNAME abs Browse ACCESS SIZE ho H T Download debug information only T Perform memory verify during download T Download automatically on target connection The Offset field specifies the memory address offset the module will be loaded at It defaults to O After the module has been added the offset value is shown on the right of the module name in the Debug gt Build submenu the Download modules folder on the Projects tab of the workspace window and the File gt Recently Downloaded Modules submenu The File format drop down list box contains a list of supported object format The file format of the download module is selected here So this does not have to match the debug format on the Debug Settings dialog box However the Stack Trace window will be supported for instance depending on the format specified in the Debug format field The Filename field can be specified with placeholders or as an absolute setting It is recommended to use placeholders The Access size field specifies the access size wh
234. ault Wind Search Editor Standard Debug Aun Debug Bookmarks Select a category then click a button to see its description Drag the button to any toolbar To remove buttons from a toolbar 1 Select Setup gt Customize The Customize dialog box opens 2 Select the Commands tab 3 Click and drag a button from the toolbar onto the Buttons area To modify the name of a user defined toolbar 1 Select Setup gt Customize The Customize dialog box opens 2 Select the Toolbars tab 3 Inthe Toolbars list select the user defined toolbar and whose name you want to modify 4 Modify the name of the toolbar in the Toolbar Name field 5 Click the OK button to save the toolbar s new name To remove a user defined toolbar 1 Select Setup gt Customize The Customize dialog box opens 2 Select the Toolbars tab 3 Select the user defined toolbar from the Toolbars list and the Reset button will change to a Delete button Click the Delete button To reset a standard toolbar back to its original state 1 Select Setup gt Customize The Customize dialog box opens 2 Select the Toolbars tab 3 Select the standard toolbar from the Toolbars list and then click the Reset button To reset the toolbar position back to its original state 1 Select Setup gt Customize The Customize dialog box opens 2 Select the Toolbars tab 3 Click the Reset Positions button The Reset Positions button re
235. bar 3 Right click on the Test_Demo test icon to display a pop up menu 4 Select Run Test Case to start the test 5 When the test is completed the Test Browser window opens 1 14 11 Step 10 Viewing the test result matched You can view the test result in the Test Browser window Make sure that the test result now matches the saved test image information x HEE JE Test Hame Description Result gt Test_Dermea Demonstration SUCCESS af Component Result Details fires CPU Memory SinsessionsH 4 SUCCESS ma Symbol Watch SimsessiansH 4 SUCCESS sj REJ10J2000 0100 Rev 1 00 Jun 16 2009 34 RENESAS High performance Embedded Workshop 2 Build Basics 2 Build Basics This chapter explains the general basic functions of the High performance Embedded Workshop whilst the more advanced features can be found in chapter 3 Advanced Build Features 2 1 The build process The typical build process is outlined in the figure below This may not be the exact build process that your installation of High performance Embedded Workshop will use as it depends upon the tools that were provided with your installation of High performance Embedded Workshop you may not have a compiler for instance In any case the principles are the same each phase of the build takes a set of project files and builds them if every file builds successfully then the next phase is executed INFFLUT C PHASE OUTPUT a COMPILER SE
236. bar Button Function Clear Window fa Clears the contents of the window Save mj Saves the contents of the window into a text file Copy Copies the selected contents onto the Windows clipboard Toolbar display Shows or hides the toolbar Customize toolbar Customizes toolbar buttons REJ10J2000 0100 Rev 1 00 Jun 16 2009 10 RENESAS High performance Embedded Workshop 1 Overview Test tab Shows the results and progress of the current test execution test support facility The test execution progress shows the current test being executed and the number of tests remaining If errors occur then these are displayed in this window For details on the test support facility see Chapter 16 Test Support Facility Right clicking displays a pop up menu containing available options A basic operation is allocated to the toolbar The functions of Toolbar display and Customize toolbar are also included in the pop up menu displayed by right clicking the toolbar area Pop up Menu Option Toolbar Button Function Clear Window CA Clears the contents of the window Save mj Saves the contents of the window into a text file Copy Copies the selected contents onto the Windows clipboard Toolbar display Shows or hides the toolbar Customize toolbar Customizes toolbar buttons Version Control tab Shows the results of version control actions The tab is only displayed if a version control system is in use For further details on version con
237. bedded Workshop 17 Debugging Facility 1 Configuring the automatic command line batch file execution The High performance Embedded Workshop debugger is tightly integrated with the TCL command line facilities This means that it is possible to write batch files for the High performance Embedded Workshop debugger which can be executed automatically at certain times The Command batch file load timing list displays the order in which the files will be executed It is possible to Add Modify Remove Up and Down the files 1n this list To configure the automatic command line batch file execution 1 Select Debug gt Debug Settings The Debug Settings dialog box opens 2 Select the Options tab 3 Select the Command batch file load timing This can be the following values At target connection Before download of modules After download of modules and After reset Command batch file load timing la target connection At target connection Before download of modules After download of modules After reset oe CL E Aaditi ma Emy E Up own i 4 Then click Add The debugger will then display the add Command Line File dialog box Command Line File El E4 Filename gt Browse TK Initial Directory gt Browse Cancel F Apply to all timings 5 Enter the command batch file name in the Filename field If you wish to insert a placeholder into the Filename field click the plac
238. bedded Workshop 8 Custom Version Control System 8 Custom Version Control System If you have selected Custom VCS as the version control system in section 7 1 Select a Version Control System the following definitions are necessary for connection of the High performance Embedded Workshop and Custom VCS e Version control menu options and locations of the associated command executables EXE command parameters how to control the execution result of version control commands etc e Locations of files for version control directory mapping and global variables e Execution control of version control commands user settings and other general options After defining this information you can execute a command of the custom version control system by selecting a High performance Embedded Workshop menu option or toolbar button and view the result in the High performance Embedded Workshop For installation and setting of the version control system refer to the user s manual for respective version control systems For details on operations of the High performance Embedded Workshop with the custom version control system see section 8 11 Usage example of the Custom Version Control System 8 1 Defining Version Control menu options The custom version control system allows you to invoke a version control command either by selecting an option from the Tools gt Version Control sub menu or by clicking a version control toolbar button Whe
239. bol Information in the Map drop down list Click OK Window configuration Map Symbol Information eW LIE cl Link map list 0000000 _INTHan OOO00so0 odda None Global IN whar as OOOOODSe eo QOOOOUSOO oddat None Local INT wvhar fen 00000p84 __ int term 00000858 QOOOOO000 Mone Local INT whar A 00000084 _TLBmis 00000800 ododd None Local INT vhar a 00001000 _IRGHan OOQOOODOO 0000000 None Local INT vwhar i 00002000 RESET 0000058 odda None Global VEC weet _INT MASK O00000TS4 QOOOO0000 None Global INTTBL wect eee ee INT Ve QOOO0DS4 ododd None Global INTTBL weet l OUD0GEaS A TBL Reset OO000D84 00000000 None Global IntPRG intp 2 UQODER4C Powero 00001000 00001049 OO00O004A Entry Global PRe rese 2 du 00006558 Manual 00001044 00000106F 00000026 Fu Global PRe rese OOOOZ000 OOOOZ0E Y 00000 0ES Fu Global F da 70000000 main H 4 DE THC be Symbol Hame NEL Address Address Attribute Section Name Symbol Size Toolbar Scope Attribute File Hame The map list of the linkage editor The symbol information of the linkage editor REJ10J2000 0100 Rev 1 00 Jun 16 2009 199 RENESAS High performance Embedded Workshop 13 Map e The left pane shows the map list of the linkage editor Nothing is displayed in this pane if there is no linkage list file map output by the linkage editor Selecting the root of the map list Linker m
240. box This dialog box allows you to control the debug settings throughout your workspace The tree on the left of the dialog contains all of the current projects Selecting a session in this tree will then show you the settings for that project and the session selection in the session drop down list In this list box it is possible to select multiple sessions or all sessions If you select multiple configurations you can choose to modify the settings for one or more configurations at once The Debug Settings dialog box displays the following debug options e Current debug target for the current project and configuration selection e Download modules for the current project and configuration selection Select the debug format in the Debug format list You can only debug modules that match the format specified here Even if there is a mixture of file formats in the Download modules list below only the one chosen here can be viewed The Download modules list displays the order in which the files will be downloaded to the target It is possible to Add Modify Remove Up and Down modules in this list To add a new download module 1 Select one of the following operations to open the Debug Settings dialog box e Select Debug gt Debug Settings OR e Right click on a module or within the Download modules folder on the Projects tab of the workspace window to display a pop up menu Select Debug Settings 2 Inthe project tree select the project and co
241. brary subcom mand LONFIGOIA S flet sub 13 1 Managing section settings You can add modify or delete information on sections on the GUI through the Map Section Information window It is also easy to check the section settings after modification 13 1 1 Opening the Map Section Information window To open the Map Section Information window 1 Select one of the following operations to open the Select Map Window Type dialog box e Select View gt Map OR e Click the Map toolbar button rad REJ10J2000 0100 Rev 1 00 Jun 16 2009 190 RENESAS High performance Embedded Workshop 13 Map 2 Select Map Section Information in the Map drop down list 3 Click OK Window configuration Map Section Information iii ae Se we EIEE El E w Linker section setting al Name st Enda size o Address da A0000000 INTHandler 00000800 O0000t57 00000558 Section 23 psTHandler VECTTBL goooonss ooooones ooooooze sii Ag ooooosad IntERG ooooope4 aoooone 00000004 89 ryruandler VECTTEL PResetPRG 00001000 0000106F 00000070 H A o0o01000 P 00002000 O0O0067ED 000047BE E 0000670 00006543 00000384 a e a CSBSEC 00006644 00006546 00000008 fo CSDSEC 0000664 oooo6BS ooooonoe Sub section Eraa F C CSBSEC CODSEC HME p OO006B58 DO006863 O00DOOOC TEN i POMA B C CSBSEC CSDSE PoverlayPRs 00002000 0000208F coo00090 P acu T W PoverlayPRG B 70000000 7OOO05EB OO0O0OSEC du panoe R 700005 700005F7 opoooooe
242. browser Run Tests Runs tests allows you to run multiple tests that you have defined in the test suite and see the results of the comparisons in the test browser There are various options to configure the test run execution You can also use this option to refresh the test image files automatically if you make a minor REJ10J2000 0100 Rev 1 00 Jun 16 2009 258 RENESAS High performance Embedded Workshop 16 Test Support Facility modification and they need to be updated Test Results Browser This menu displays the test results for one or more test executions It shows the pass and fail results and the detailed reason why the test failed Properties The Test Suite Properties dialog box is displayed It displays the test suite name test suite description test suite location and the last modified date Right clicking on a test icon Eh allows you the following options Pop up Menu Option Function Run Test Case Executes the selected test case Edit Test Case Modifies the selected test case Remove Test Case Deletes the selected test case Create New Test Image File Creates a test image file for the selected test case Compare Test Image File Compares the test image file with data in the current system Edit Test Image File Modifies the test image file Save Test Image File Saves the current setting in the High performance Embedded Workshop system into the test image file Save Test Image File As Saves the current setting in the High pe
243. bugger only xxxxxx created by High performance Embedded Workshop V 4 01 or later is in use 1 6 Debug Menu Options Menu Menu Option Shortcut Key Toolbar Button Macro Recording 1 Function Debug Synchronized z Debugging 2 Debug Sessions z Debug Settings Reset CPU Sit Go F5 fi Reset Go SHIFT F5 Free Go 2 Go to Cursor I mui m Set PC to Cursor I_ Run Display PC CTRL SHIFT r Y Step In F11 H Step Over F10 p Step Out SHIFT F11 34 Step Step Auto Mode Assembly Source gt Halt Program STOR Initialize a Connect 2 Dn r Disconnect 2 Ea Save Memory Verify Memory 2 REJ10J2000 0100 Rev 1 00 Jun 16 2009 398 RENESAS Configures synchronized debugging Opens the Debug Sessions dialog box to list add or remove the debug session Opens the Debug Settings dialog box to set the debugging conditions or download modules Resets the CPU Starts executing the user program at the current PC Executes the user program from the reset vector address Runs program ignoring any breakpoints Starts executing the user program at the current PC and continues until the PC equals the address indicated by the current text cursor position Changes the value of the Program Counter PC to the address at the row of the text cursor Opens the Run Program dialog box allowing the user to enter temporary breakpoints before executing the user program
244. button on the Edit Test Trace Ranges dialog box The trace range selected in the Trace ranges list will be deleted Only one trace range is selectable in the list Then click OK To make detailed setting with two or more trace types If you double click on a test item in the Create New Test Image dialog box a further dialog box for detailed setting opens Edit Test Trace Ranges ki EJ u Trace ranges Start PTR End PTR 0 Cancel Add Modit Remove e To add a trace range 1 Click on the Add button in the Edit Test Trace Ranges dialog box to open the Add Trace Range dialog box REJ10J2000 0100 Rev 1 00 Jun 16 2009 254 RENESAS High performance Embedded Workshop 16 Test Support Facility Add Trace Range Ei Ei Trace type Internal ALID AU sermenmorn trace Start PTA Pk End PTR Po Cancel 2 Specify Trace type Start PTR and End PTR to set a trace range to be saved into a test image file 3 Click OK e To change a trace range 1 Click on the Modify button on the Edit Test Trace Ranges dialog box The trace range selected in the Trace ranges list will be modified Only one trace range is selectable in the list The Modify Trace Range dialog box opens Modify Trace Range kd Ed Trace type Internal ALID U sermenmon trace Start PTR End PTR 2 Cancel 2 Specify Trace type Start PTR and End PTR to set a trace range to be saved into a test image file 3 Cli
245. can modify and update the workspace and project without making all of the other users reload their project and potentially lose all their changes This system is implemented by making one of the machines attached to the network the server machine All other client machines then use the service this machine is providing So if one of the client machines adds a new file the server machine is notified The server then notifies all other clients the action has taken place This procedure is shown below Networked workspace and project agi Networked Data Example Network AS Networked Data Example access a Debug H E SimBebuq SH 2 Server Network access All files are under the network service s control These include the workspace project session and source files Clients do not access data directly with the workspace and project files on the network The clients cannot directly communicate with each other ether All communication is directed Clients through the server machine The network system allows users to be given access rights to files This allows the project administrator to make sure the only people who can modify the project and source files are allowed to do so This might allow the administrator to limit each user to only have write capabilities for their own area of the project other areas would be read only This could limit any potential conflict or damage one user could do to other areas of the project These limita
246. ccess rights from this access level Read write file access Only the source files can be modified All project settings can only be viewed not modified Read only All source files and project files can only be viewed as read only Nothing can be modified When any user opens a network enabled project they must type in their user name and password Until this is done no access can be granted Once entered the user is given one of the levels of access as seen above To add a new user to the system 1 Log in with a user who has administrator access rights The process for doing this is described above 2 Select Setup gt Options The Options dialog box opens 3 Select the Network tab 4 Click the Access rights button The User access rights dialog is displayed 5 Click the Add button The Add new user dialog box opens This allows you as the administration user to add a new log in name and password Normally the password should be set to some default text or left blank Then click OK 6 Once OK is clicked the user is added with read only rights To change the access level select the user you wish to modify and then click the required radio button Then click OK to save the access rights changes To remove an existing user to the system 1 Log in with a user who has administrator access rights The process for doing this is described above Select Setup gt Options The Options dialog box opens Select the Network tab Click the Acces
247. ce Select one of the following operations e Click the Clean All Projects toolbar button Es OR e Select Build gt Clean All Projects OR e Right click on a workspace in the Projects tab of the workspace window Select Clean All Projects from the pop up menu A confirmation dialog opens for you to select whether or not to delete all intermediate and output files produced in building To delete all files select Yes Otherwise select No REJ10J2000 0100 Rev 1 00 Jun 16 2009 53 RENESAS High performance Embedded Workshop 2 Build Basics Confirmation Request ki J 4 You are about to delete all intermediate files from all projects in the workspace Do you wish to continue T Don t ask this question again Ho Cancel If you do not wish to open this confirmation dialog box select the Don t ask this question again checkbox To open the confirmation dialog box again 1 Select Setup gt Options The Options dialog box opens 2 Select the Confirmation tab 3 Select the Clean workspace checkbox This checkbox is selected by default 4 Click OK The Build tab in the Output window shows all projects and configurations in which intermediate and output files have been deleted You can select multiple configurations and delete intermediate and output files produced in building For details see section 2 8 3 Building multiple projects Note The High performance Embedded Workshop deletes relocatable and absolut
248. ce tab To save a session with a different name 1 f 3 4 5 Select Debug gt Debug Sessions The Debug Sessions dialog box opens Select the session you would like to save Click the Save as button The Save Session dialog box opens Browse to the new file location If you only want to export the session file to another location then leave the Maintain link checkbox unchecked If you would like High performance Embedded Workshop to use this location instead of the current session location then check the Maintain link checkbox Click the OK button To save a session with a different name using File gt Save Sessions As L Select File gt Save Sessions As The Session Name dialog box opens Session Hame Session name Cancel Ea ES 2 Enter the new session name 3 Click the OK button REJ10J2000 0100 Rev 1 00 Jun 16 2009 294 RENESAS High performance Embedded Workshop 17 Debugging Facility 17 1 6 7 Reloading session information To reload a session Select File gt Refresh Session Clicking this will lose any changes to your session currently and the reload the current session into High performance Embedded Workshop 17 2 Viewing a program This section describes how to look at your program as source code and assembly language mnemonics The source code will be shown in the source mode in two types of windows The main features are Editor Window e A source file ope
249. ced over a destination where the item can be moved Added to the last of the items Select an overlay group and drag it to REJ10J2000 0100 Rev 1 00 Jun 16 2009 191 RENESAS High performance Embedded Workshop e The right pane shows the section settings after a build 13 Map Nothing is displayed in this pane if there is no linkage list file map output by the linkage editor You can adjust the column width by dragging the mouse on a column header Moreover right clicking the column header displays a pop up menu A tick mark right next to an entry indicates that this column is displayed Clicking an entry will switch showing hiding the column Clicking the column header sorts the listed items When the window is first opened the items are sorted by the value of Start Address The Overlay column shows the name of the primary section Window options e Map information and section settings of the linkage editor left pane Right clicking displays a pop up menu containing available options A basic operation is allocated to the toolbar The Toolbar display and Customize toolbar options are also included in the pop up menu opened by right clicking on the toolbar Pop up Menu Option Toolbar Button Section Edit Mode Add Section Group Add Section Add Overlay Group 1 Section Auto Registration Edit Selected Item Cut Copy Paste Delete Move up Move Down Change Primary Section 1 Memory Map
250. cess Phase 1 Input Files Phase 1 Output Files Phase 2 Input Files Phase 2 Output Files Phases Input Files Phase amp Output Files The High performance Embedded Workshop provides the ability to change this build process via its Build Phases dialog box which can be accessed by selecting Build gt Build Phases On the left hand side are the phases that are defined in the current project REJ10J2000 0100 Rev 1 00 Jun 16 2009 65 RENESAS High performance Embedded Workshop 3 Advanced Build Features Build Order Build File Order File Mappings Build phase order iw SH C Compiler Add WISH Assembler Maditpa i ptLinker Hemore Mare Up Mave Dawn The remainder of this chapter details the various functions that the Build Phases dialog box provides 3 2 Creating a custom build phase If you want to execute another tool before during or after a standard build process then this can be achieved by creating your own i e custom build phase To create a new custom build phase 1 Select Build gt Build Phases to invoke the Build Phases dialog box 2 Click the Add button This will invoke the New Build Phase wizard dialog box 3 Follow the 4 steps below To move forward and backward between steps click the Next gt and lt Previous buttons respectively Step 1 The first step asks whether you want to create an entirely new phase or whether you want to add a system phase A syst
251. chine Select Server Location i Local C Remote Cancel Computer name BEranese If you have previously been the server of a workspace then the following message will be displayed when you attempt connection to another machine Clicking Yes then connects your machine to the new location REJ10J2000 0100 Rev 1 00 Jun 16 2009 176 RENESAS High performance Embedded Workshop 10 Sharing Projects by Network Facilities High performance Embedded Workshop You have modified the workspace Do you want to save the modifications AN To share this workspace requires the workspace to be closed and reloaded Note If the network is running multiple High performance Embedded Workshop workspaces with the network facilities to share projects enabled then a user can only access one of them at one time The only instance when this is not the case is if the same machine is serving all of the network workspaces REJ10J2000 0100 Rev 1 00 Jun 16 2009 177 RENESAS High performance Embedded Workshop 11 Comparing Files 11 Comparing Files The High performance Embedded Workshop has an integrated difference view You can perform a difference comparison with two files on your local drive or a local file and a file in the Microsoft Visual SourceSafe system 11 1 Opening the Difference window To perform a difference comparison with two files on your local drive L Select one of the following operations Se
252. cility 2 If you have selected a load module name in Scope select the corresponding file scope from the list in the File Scope section You can also filter scope names by the string not case sensitive entered in the Filter box before selecting a desired scope name Note If the scope for a variable selected in the Watch window does not match the download module the Scope column on the line of the variable is highlighted Set the correct scope for the variable 7 Deleting a watch item To delete a watch item select it from the Watch view and choose Delete from the pop up menu The item is deleted and the Watch view is updated To delete all watch items select it from the Watch view and choose Delete All from the pop up menu The all items are deleted and the Watch view is updated 8 Modifying the radix The radix for the selected variable display can be modified by choosing Radix from the pop up menu 9 Saving the Watch window contents in a file To save the contents of the Watch window choose Save As from the pop up menu the Save As dialog box opens It allows the user to specify the name of a file and to save the contents of the Watch window in the file If the Append check box is selected the window contents are appended to the existing file and if it is not selected the existing file is overwritten 10 Opening a Memory window The contents of the memory area to which the selected variable is assigned can be displayed i
253. ck OK e To remove a trace range 1 Click on the Remove button on the Edit Test Trace Ranges dialog box The trace range selected in the Trace ranges list will be deleted Only one trace range is selectable in the list Then click OK 16 7 Comparing a test image file To compare a test image file 1 Select Test gt Compare Test Image File The Compare dialog box opens REJ10J2000 0100 Rev 1 00 Jun 16 2009 255 RENESAS High performance Embedded Workshop 16 Test Support Facility Compare ed Test image file p Browse gt ETA Cancel Compare test image file to f Curent system Test image file LA Eee 2 Enter the test file location that you want to compare in Test image file field This is a HIF High performance Embedded Workshop test image file file and contains details about the test image data 3 Then select what you want to compare the file you have selected with You can choose either the Current system or another previously saved test image file The Current system option is useful if you have manually executed a script and want to check the current test image data with some you saved previously Click OK The results will be loaded into the test browser It is possible to compare test image file separately to test execution This allows you to compare manually the current system or two test image files at a later date to when the tests were actually executed You can also compa
254. ck box will not bring up this dialog box on download if there are files that can not be located This checkbox is also present in the Confirmation tab of the Options dialog box and can be turned off and on here Pressing Search will look for the files in the Browse list in the chosen directory files that have been found will be removed from the Files to find list Any searched directories in the Browse section will be shown by a folder and magnifying glass icon Gh Once the user has selected Search this button will be changed to a STOP button allowing the user to cancel a search Any files that had been found before the search was cancelled will return to the unlocated state Clicking OK then the files that were searched for and found will be located to that directory accept all searches and close the dialog box Clicking Cancel completely cancel all searches that have been done and close the dialog without changing anything If you had done some searches and they clicked on cancel a confirmation box will appear as below Confirmation Request 1 j Are you sure you want to cancel all file relocations and discard changes T Don t ask this question again If you select Yes this will invoke the Locate Files dialog box and close the dialog box If you select No the dialog box will remain open allowing you to select OK If the confirmation is selected not to be shown again the default behavior will be Yes To open the confirmation dial
255. ck the New File toolbar button 0 OR e Press CTRL N OR e gt Select File gt New The new window will be given an arbitrary name by default You can provide a new name when you save the file 4 3 2 Editing a file The High performance Embedded Workshop editor s standard editing functionality is available through the usual methods i e the menu toolbar and keyboard shortcuts and is additionally supported via a pop up menu that is local to each Editor window Right click in an open Editor window to invoke the pop up menu REJ10J2000 0100 Rev 1 00 Jun 16 2009 87 RENESAS High performance Embedded Workshop 4 Editor The table below outlines the basic operations that are provided by the editor Operation Effect Action Undo Reverses the last editing operation Select Edit gt Undo Press CTRL Z Redo Repeats the last undone editing operation Select Edit gt Redo Press CTRL Y Cut Removes highlighted text and places it on the Windows clipboard Click the Cut toolbar button d Press CTRL X Select Edit gt Cut Select Cut from the pop up menu Click the Copy toolbar button Ea Press CTRL C Select Edit gt Copy Select Copy from the pop up menu Copy Places a copy of the highlighted text into the Windows clipboard Paste Copies the contents of the Windows clipboard into the active window l A at the position of the insertion cursor Click the Paste toolbar button Press CTRL V Select Edit
256. component with High performance Embedded Workshop it must first be registered see section 5 3 Registering a component for further information The Tools Administration dialog box shows all currently registered components To access it ensure no workspaces are open and then select Tools gt Administration If you attempt to access the Tools Administration dialog box when a workspace is open the Tools Administration dialog box is opened but cannot be modified When High performance Embedded Workshop is installed any new tools are automatically registered Day to day usage of the High performance Embedded Workshop though may mean you need to know more about the tools registration process High performance Embedded Workshop stores tool information in a tool database file which is stored in the root of the tool installation directory By default this is set to the High performance Embedded Workshop application directory however if you are working in a network environment this directory may be set to another location It 1s possible to change the tool directory location and this causes a re scan of the tools that are registered in High performance Embedded Workshop REJ10J2000 0100 Rev 1 00 Jun 16 2009 110 RENESAS High performance Embedded Workshop 5 Tools Administration To change the tools directory location l pA 3 4 5 3 Select Tools gt Administration The Tools Administration dialog box opens Click the Modify button
257. ct Debug gt Debug Settings The Debug Settings dialog box opens 2 Select the Options tab 3 Select the Do not perform automatic target connection This checkbox is only enabled if the feature is supported by the selected target Selecting a new target will reset this option to the default setting for the target Default for this checkbox depends on the target 4 Click OK 8 Resetting CPU after download module If this checkbox is selected the target will be automatically reset after downloading the user program Support for this function depends on the debugger To reset CPU after download module 1 Select Debug gt Debug Settings The Debug Settings dialog box opens 2 Select the Options tab 3 Select the Reset CPU after download module This checkbox is only enabled if the feature 1s supported by the selected target Selecting a new target will reset this option to the default setting for the target Default for this checkbox depends on the target 4 Click OK 9 Disabling memory access by GUI when target is executing By setting this option the user can limit memory accesses from the High performance Embedded Workshop components during execution This prevents the target being overloaded providing memory data and degrading execution Support for this function depends on the debugger REJ10J2000 0100 Rev 1 00 Jun 16 2009 277 RENESAS High performance Embedded Workshop 17 Debugging Facility To disable memory
258. ct a session is automatically created for connecting the High performance Embedded Workshop with the selected debugger For example if you have selected SH 4 Simulator in Target at creation of a project session SimSessionSH 4 is automatically created How to set up High performance Embedded Workshop debugger options To set up High performance Embedded Workshop debugger options kept with a session select the session from the drop down list box in the Debug Settings dialog box opened from the Build menu Options can be set up in the Target and Options tabs HEW debugger options dialog box Selecting a session and setting up options in the Target and Options tabs Debug Settings s moecnonSH 4 Taget Options Se a torioH 4 D elauilSessem Lagat l Sessions SH Simulator Cone e Dore Teme Desig haima JeWe0 T Download mocuies Filename Cifteetacdimes Foma Add POONFIGBIAPAIPAQ O0000000 Eliit ro 1 Aas See section 17 1 6 Debugger sessions for more information about a Debugger sessions REJ10J2000 0100 Rev 1 00 Jun 16 2009 20 RENESAS High performance Embedded Workshop 1 Overview 1 14 Overview of Macro Recording Support facility and Test Support facility When coding is finished the program must be tested If a problem is found in testing you will need to correct the problem and re test the program Testing takes a significant number of steps in developm
259. ction Selects generation of a model main function Generates a main function file Project name c cpp I O Register Definition Files Checking generates an I O register definition file jodefine h written in the C language Generate Hardware Setup Selects generation of a model I O register initial setting program Function Generates a hardware setting file hwsetup c cpp or hwsetup src Note To include a main function that has already been made select None in Generate main Function and after making the project add the file containing the main function to the project Note that if the name of the function to be included is different the function calling section in resetprg c must be modified Be sure to refer to the hardware manual of the CPU for actual values of the sample file contents such as the vector table definition and I O register definition which are generated by the project generator To move to Step 4 click the Next gt button in Step 3 Hew Project 4 9 Setting the Standard Library Msuntime runtime routines Iw new Performs memory allocation ee ctype h Handles and checks charac math A Performs numencal calculatio matht h Performs numerical calculatie stdang h Supports access to variable Iw stdio h Performs input output handlir Iw stdlib k Performs C program standard Iw string hb Performs string comparison i jios EC Performs inputoutout proc jcomplesx E C Performs complex
260. d select List Members A pop up window opens Select an item you wish to add and press ENTER OR o Press CTRL SPACE to display a pop up window Select an item you wish to add and press ENTER REJ10J2000 0100 Rev 1 00 Jun 16 2009 188 RENESAS High performance Embedded Workshop 13 Map 13 Map Among the section settings of the linkage editor and the contents of the linkage list file output by the linkage editor information on sections and symbols are respectively shown There are the following features Sections A tree view in the form of address section group section Assignment of sections can be changed by drag and drop You can add modify or delete addresses section groups and sections The source file for the address in the selected line can be opened in the editor window The contents can be printed out Symbols Lists all symbol information or those for respective sections You can search for filter or sort this function is not supported by the evaluation version symbol information The source file for the address in the selected line can be opened in the editor window The contents can be printed out e Supported toolchains The toolchains included in the following compiler packages support the map function o C C Compiler package for SuperH family V 7 1 03 and later o C C Compiler package for H8SX H8S and H8 family V 5 0 05 and later o C Compiler package for M16C series V 5 42 Release 00
261. d Move Down buttons to move the phase up and down respectively Click the OK button to set the new ordering To view the properties of a system phase L 2 3 Select the system phase that you would like to view Click the Modify button The Command tab shows general information about the phase This may include copyright information version information and so on Select the Environment tab to view the environment settings of the phase Click the OK button to close the dialog box To modify a custom phase L 2A Select the custom phase that you would like to modify Click the Modify button The Modify Phase dialog box will be invoked with the Command tab selected Command Command excluding parameters CT ools MyT ool exe p Browse Initial directory S CONFIGDIR Tara Input file group for multi shot phases only Absolute file T Don t check for input file s existence before executing Read output on the fly Change the contents of Command and Initial directory as appropriate If there are multiple shot phases select the file type to execute a phase from the Input file group for multi shot phases only drop down list Select the Don t check for input file s existence before executing checkbox if you don t want the High performance Embedded Workshop to abort the execution of the phase if any of the input files do not exist Select the Read output on the fly checkbox if y
262. d Workshop 17 Debugging Facility 17 3 5 Copying an area of memory You can copy an area of memory using the memory copy feature Select a copy source address range in the Memory window by dragging the mouse Choose Move from the pop up menu of the memory window The Move dialog box opens start Address jononoooo End Address poooo07F l Move Address OOo ti izi SY Leneth Mbyte w D verify Cancel Enter the copy destination start address in the Move Address field Select the Verify check box Support for verify function depends on the debugger If you did not drag the copy source address range you must enter the start end address The end address can also be prefixed by a plus the end address will become the start address entered value Drag and Drop Type of dropped data Operation Selected range on the Memory Window s Data column Copy the contents of a selected range of data to an area starting from the dropped position 17 3 6 Comparing the memory contents The contents of two memory blocks can be compared Select a source address range in the Memory window by dragging the mouse Choose Compare from the pop up menu of the memory window The Compare Memory dialog box opens Compare Memory Start Address ponon Bll ind errors o000F F l Compare Address r kal ataLeneth fi byte x Cancel Enter the start address of the destination memory area in the Compare Address field an
263. d Workshop attempts to match the configuration in the dependent project with that of the current project This means that if the current configuration is Debug then the High performance Embedded Workshop will attempt to build the Debug configuration in the dependent project If this matched configuration does not exist then the High performance Embedded Workshop will use the configuration that was last used in the dependent project To make projects depend upon another 1 Select Project gt Dependent Projects The Dependent Projects dialog box opens 2 Select the project to which you would like to add dependents When you do this the Dependent projects list will display all of the projects in the workspace excluding the selected project Dependent projects 3 The Dependent projects list has a checkbox for each project listed Set the associated checkboxes to make those projects depend upon the selected project 4 Click on the OK button REJ10J2000 0100 Rev 1 00 Jun 16 2009 63 RENESAS High performance Embedded Workshop 2 Build Basics When there is a project dependent on the current project the High performance Embedded Workshop checks whether building of the dependent project should be executed earlier than that of the current project When the current project is a parent the dependency checking will be performed on its child project Even if another project is dependent on the child project this dependent p
264. d break point Delete All button Removes all break points Enable button Enables the selected break point All Enable button Enables all break points Disable button Disables the selected break point All Disable button Disables all break points Selected item in the Address Interrupt Break Point list Double click on the item Sets or clears a software breakpoint 15 5 2 11 Coverage window While a macro is being recorded the following operations will be recorded into a macro file Target Operation Function Enable All pop up menu option toolbar button Click on the menu option or toolbar Enables all the coverage functions Clear All pop up menu option toolbar button button Clears the coverage data for all functions Add Range pop up menu option toolbar button Make setting in the dialog box opened Adds a new coverage range Edit Range pop up menu option toolbar button by clicking on the menu option or Edits selected coverage range toolbar button Enable pop up menu option toolbar button Click on the menu option or toolbar Enables or disables coverage Clear Data pop up menu option toolbar button button Clears the coverage data Save Data pop up menu option toolbar button Make setting in the dialog box opened Saves the coverage data Load Data pop up menu option toolbar button by clicking on the menu option or Loads the coverage data from file toolbar button REJ10J2000 0100 Rev 1 00 Jun 16 2009 225 RENESAS High performance Embedded Workshop
265. d give them a name In a similar way High performance Embedded Workshop allows the user to store his debugger options in a session Later on you can select the session and all of the debugger options will be restored These sessions allow the user to specify target download modules and debug options This means that potentially each session can be targeted at a different debugger This facility can allow you to have many different sessions each with different debugger options defined For example it is possible to have each session using the same target but with slight variations in the session options This can mean it is very easy for the user to switch session and modify such things as register values or target settings such as clock speed The figure below shows this principle The five sessions share the same target but the sessions can be slightly different with regard to the options defined This means that both sessions can share the same download module and avoid an unnecessary rebuild This is because sessions are not directly related to the build configuration data Defaultsession ki DefaultSession Simsession System 01 Simsession System Oe Simsession System OS Sims essiorsH 4 Each session s data is stored in a separate file to the High performance Embedded Workshop project You can then manipulate the data to share or modify as is required in the project REJ10J2000 0100 Rev 1 00 Jun 16 2009 290 RENESAS High
266. d instructions are shown Type the new instruction or edit the old instruction in the Mnemonic field Pressing Enter will assemble the instruction into memory and move on to the next instruction Clicking the OK button will assemble the instruction into memory and close the dialog box Clicking the Cancel button or pressing ESC will close the dialog box Note The assembly language display is disassembled from the actual machine code in the debugger s memory If the memory contents are changed the dialog box and Disassembly view will show the new assembly language code but the source view will be unchanged This is true even 1f the source file contains assembler 17 2 2 10 Disassembly find in range The disassembly find in range can be used to find a certain text string in the disassembly view between two addresses Right click on the Disassembly field in disassembly mode or mixed mode and select Find in Range The Find in Range dialog box opens Find in Range Ei Ei in Doo Start Address 2 Bl Cancel End Address REJ10J2000 0100 Rev 1 00 Jun 16 2009 307 RENESAS High performance Embedded Workshop 17 Debugging Facility Enter your search string the start and end address that should be searched Click OK The view then selects the first instance of that string in the range Note Subsequent find operations will find strings only in the paged disassembly area not the complete range 17 2 2 11 Saving disassembly
267. d module Files will be grouped according to file type and shown under their relevant folder If no file type for that file exists they will be grouped under their extension folder When you double click on a file the external editor is launched with the file If you wish to open the file in the editor window see section 2 5 File extensions and file groups Files that could be located will be shown under the download module shown in a normal icon El REJ10J2000 0100 Rev 1 00 Jun 16 2009 286 RENESAS High performance Embedded Workshop 17 Debugging Facility Z zl Ey Debugl rly iy Debuginly sj aa 7 Et a EE file s E _h_e_lib h E machine h z sbrk h gt sort h stacksct h om stddef h stdio h stdlib h Ey a C source file D E dbect c PA zbrk c a a C source file gE resetprg cpp Heen sork cpp foo eee tutorial cpp E Dependencies E Ol Projecte Files that could not be located will be shown under the download module but will have a red icon To distinguish these files you can view the full path of the file To view the full paths of all files 1 Right click anywhere inside the Projects tab of the Workspace window 2 Select the Configure View menu option The Configure View dialog box will be displayed 3 Select the Show file paths check box 4 Click OK REJ10J2000 0100 Rev 1 00 Jun 16 2009 287 RENESAS High performance Embedded Workshop 17 Debugging Facilit
268. d the data length in the Data Length field If you did not drag the comparison source address range you must enter the start end address The end address can also be prefixed by a plus the end address will become the start address entered value If there is a mismatch the address where it was found is displayed in a message box When the contents of the two memory areas match at comparison the message Comparison successful appears Support for this function depends on the debugger REJ10J2000 0100 Rev 1 00 Jun 16 2009 314 RENESAS High performance Embedded Workshop 17 Debugging Facility 17 3 7 Testing an area of memory You can test an area of memory in the address space using the Memory Test feature Select an address range to test in the Memory window by dragging the mouse Choose the Test option from the pop up menu of the memory window The Test Memory dialog box opens Test Memory Start Address pooo kal ade o000F F ll Cancel If you did not drag the address range to be tested you must enter the start end address The end address can also be prefixed by a plus the end address will become the start address entered value Support for this function depends on the debugger Note The exact test is target dependent However in all cases the current contents of the memory will be overwritten YOUR PROGRAM OR DATA WILL BE ERASED 17 3 8 Saving memory contents in a text file
269. d when creating a project Directories corresponding to each of the configurations are created under the project directory These directories have the names of the configurations REJ10J2000 0100 Rev 1 00 Jun 16 2009 18 RENESAS High performance Embedded Workshop 1 Overview Note The project directory having the project name is created under the workspace directory used for creation of a new workspace Workspace window Hard disk Ey Workspace_Name 4 H A Project_Name J Project_Name Al Projects How to set up build options To set up build options kept with a configuration select the configuration from the drop down list box in the dialog box for set up build option opened from the Build menu Options such as the compiler assembler and optimizing linkage editor can be set up The figure below shows the dialog box used for setup of build options for the Renesas SuperH Standard toolchain Build options dialog box Selecting a configuration and setting up options such as the compiler and the optimizing SuperH RISC engine Standard Toolchain CiCes Assembly Link Liteay Standaid Libian CPU 4 Categow Source z Show entries For All Configurations Include hle cireschories r quratorrs H Assembly source file H Linkage symbol file Oplan CC cpussh object f OONFIGDIR AY FILELE SF obi debug gbr aute lt chgnepath roipath global_valahle 0 opt_r
270. d with the new coloring Format Wiews r i elas Selected Text al Font Text H Source Ear E Command Line A A Stack Trace Courier Mew Ee 10 Point Size H ES Register ho w H EE TOL Toolkit HA Status Hl EE Difference HEW Sample Text E Memory fl Ft Cutout kE E EE Madity Re nove ok Cancel The Format Views dialog box allows you to customize the color and font of text shown in the windows Item Category Objects to be Customized Source Selected Text A selected text shown in the editor window and disassembly window in source mode PC Line Highlight The line at the PC program counter in the editor window and disassembly window in source mode while the Enable line highlight for PC position checkbox is selected in the Editor tab of the Options dialog box Other keyword groups Comment or keywords shown in the editor window and disassembly window in source mode based on the syntax of Note respective file types Control Declaration Operator PreProcessor Value Directive Difference LHS Different Lines Unmatched text lines shown in the left pane in the Difference window LHS Moved Lines Moved text lines shown in the left pane in the Difference window RHS Different Lines Unmatched text lines shown in the right pane in the Difference window RHS Moved lines Moved text lines shown in the right pane in the Difference window Register Modified Text sections
271. dard Toolchain 5 44 00 Hnn Renesas M32C Standard Toolchain 5 41 01 i _ super RISC engine Standard Toalchain 4 2 0 0 O Registern A Sy System Tools ofe Cal walker 1 07 00 z H Seres Librarian Intertace 1 03 00 Properties De Mapview 1 01 00 ay J Utility Phases Erpat El Debugger Components a 5 40 Family CPU 1 03 00 Search disk Binary File Object Reader 1 05 00 se eel os a a a E Fe 4101 im wy eee Tool information T Show all components Current HE tools location C Program Files Renesas Hew Modify ELE There are five standard types of component Toolchain A Toolchain is a set of build phases e g compiler assembler linker and librarian These components provide the build capability System Tool A System Tool is an application EXE that can be launched from the Tools menu These are often provided as extra applications which support the toolchain e g an interactive graphical librarian etc Utility Phase A Utility Phase is a ready made build phase which supports some specific build functionality e g analyze complexity of source code count lines of source code etc These components provide added functionality to the build that is not toolchain specific Debugger Component A Debugger Component is a component that supports some specific debugger functionality e g CPU DLL Target platform Object reader etc Extension Component An Extension Component is a component tha
272. dd Bit button on the Edit Test ASM Watch Points dialog box to open the BitAdd dialog box REJ10J2000 0100 Rev 1 00 Jun 16 2009 247 RENESAS High performance Embedded Workshop 16 Test Support Facility BitAdd BitSymbol Address El Size Byte bd Bit Lancel 2 Specify BitSymbol Address Size and Bit to set a bit level watch point to be saved into the test image file 3 Click OK e To delete a watch point 1 Click on the Delete button on the Edit Test ASM Watch Points dialog box The watch point selected in the Compared watch list will be deleted Only one point is selectable in the list e To disable comparison of the addresses of watch points 1 Select the Ignore address for labels and symbols check box on the Edit Test ASM Watch Points dialog box The check box is not selected by default Edit Test ASM Watch Points EA E4 Compared watch Address OF Mzlze ete Word Cancel d Add Bit FEF EL Delete i Ignore address for lables and symbols Then click OK 16 6 2 4 Symbol CWatch CWatch window The following table shows information on the test image data to be saved into test image files and test results not matched REJ10J2000 0100 Rev 1 00 Jun 16 2009 248 RENESAS High performance Embedded Workshop 16 Test Support Facility Test group name Symbol Test item name CWatch Test image data to be Values set as detailed information and the range of data in the
273. dded Workshop system to be compared with the test image file HIF file that was attached to the relevant test case These results will then be added to the test browser and will give pass fail and failure details information to you The Refresh test image file option simply runs all of the test cases and updates the test image file HIF file with the system image after each test The Automatically save test results check box allows you to automatically save the results of each test execution to a text file in the same directory as the test suite The filename used is made up from the current test suite and the date of time of the test execution The Stop at first failure will stop the automated test execution when the first test failure is met This avoids running many tests when perhaps the first test causes all others to fail anyway The Test time out is for use when you may be executing user code In some cases if there is a bug the code many execute and never finish during the tests execution If any one test takes longer than the number of seconds in this box the test is terminated and is flagged as a failure You can also run test from the workspace window pop up menu 16 9 Using the test browser The test browser displays the results of the last test execution The test browser can be easily opened by selecting Test gt Test Results Browser x HL J Test Name Description Result A Tes_Oemo Demonstration FAIL Aoo e
274. de gt Coverage Trace Trace View gt Code gt Trace 16 Test Support Facility debugger E100 emulator debugger E8 emulator software E8a emulator software Simulator debuggers for M16C family Simulator debuggers for 740 family Emulator debuggers for M16C family Exclude the following debuggers E100 emulator debugger E8 emulator software E8a emulator software Emulator debuggers for 740 family Exclude the following debugger E8a emulator software H8 300H Tiny series compact emulator debugger Simulator debuggers for SuperH family Simulator debuggers for H8SX H8S and H8 families Simulator debuggers for SuperH family Simulator debuggers for H8SX H8S and H8 families Emulator debuggers for SuperH family Emulator debuggers for H8SX H8S and H8 families Test items cannot be selected when the High performance Embedded Workshop is not connected to a target Support of this function depends on the debugger in use For details refer to the user s manual help information and release notes for the emulator or simulator debugger 16 6 2 1 Symbol Watch Watch window The following table shows information on the test image data to be saved into test image files and test results not matched Symbol Watch Test group name Test item name Test image data to be saved into test image files Test result details Failed at symbol Src Dest Example To make detailed setting Name of the un
275. debug at the assembly language level 17 1 2 Selecting a debugger Selecting the debugger is very dependent on the installation of the High performance Embedded Workshop If the High performance Embedded Workshop has a toolchain installed then the application project generator will be able to set up both the toolchain and the debugger targets simultaneously This allows the options for targets and toolchain to be matched closely so that no inconsistencies occur If there is no toolchain installed you will only be able to select debug only project types By default High performance Embedded Workshop will display a debug only project generation type for each CPU family in the New Project Workspace dialog box Note The project generator in the High performance Embedded Workshop automatically generates sample source files for the microcomputer in use for some project types however no files are generated These files contain sample code and this does not indicate that the operations of all programs based on that code are guaranteed Please read the hardware manual for the microcomputer to check if the generated source code is applicable and modify the code as required REJ10J2000 0100 Rev 1 00 Jun 16 2009 261 RENESAS High performance Embedded Workshop 17 Debugging Facility Hew Project Workspace Ed Projects Project Workspace Hame Project Types We HT Tutorial Application Demonstration Project Name ry Empty Application IT
276. ded Workshop 1 Overview A copy of the workspace will be saved into the current directory so all the source files etc will remain in use but with the entered prefix e g C Workspace Workspace_Name 402_Workspace_Name hws C Workspace Workspace_Name Projet_Name 402_Projet_Name hwp C Workspace Workspace_Name Projet_Name 402_DefaultSession hsf C Workspace Workspace_Name Projet_Name 402_SimSessionSH 1 hsf Note that the current workspace remains loaded as the working copy 1 9 Closing a workspace To close a High performance Embedded Workshop workspace select the File gt Close Workspace menu option If there are any outstanding changes to the workspace or any of its projects you will be requested whether or not you wish to save them 1 10 Exiting the High performance Embedded Workshop The High performance Embedded Workshop can be exited by selecting File gt Exit pressing ALT F4 or by selecting the close option from the system menu which is opened by clicking the icon at the upper left corner of the High performance Embedded Workshop title bar 1 11 Component system overview The High performance Embedded Workshop allows the user to extend the High performance Embedded Workshop functionality by adding additional components to the system This is achieved by registering the component in the Tools Administration dialog box These components can add windows menus and toolbars to the High performance Embedded Workshop system
277. ded Workshop command line commands The figure below shows the High performance Embedded Workshop macro file and macros Macro File Record Macro gt fWacro Operations Start Reset CPU Elf reset Step In gt step Ox Stop Macro DO gt Macro Operations End Enter macro name Record Macro gt hacro Build Start Build Es gt build wait stop Macro o gt Wacro Build End Enter macro name The current records of macros are shown in the Macro tab of the Output window The Build macro in the figure above is outputted as follows Record Macro Recording Build hit build wait TOP MATA Finished recording Build Enter amacro name acre See section 1 14 1 Example of test procedures for an operation procedure e Test support facility The test support facility allows you to create a test image file of the selected test items test image data execute a macro created by the macro recording support facility or an existing High performance Embedded Workshop command batch file and compare a test image file with the current High performance Embedded Workshop system Test image data can be saved into a test image file HIF Note however that High performance Embedded Workshop is not capable of acquiring test image information of all functions in the High performance Embedded Workshop system For the items from which test image information can be acquired see section 16 6 Functions that can be saved as tes
278. der 22 00002000 long min max long J ine I oo00z006 printe Data 29 00002014 for i 0 ae WA Line Number column SAW Breakpoints column Source Source Address column e Clicking another toolbar button switches the display mode To view disassembly codes in mixed mode click the View mixed mode button To view disassembly codes in disassembly mode click the View Disassembly button e The columns listed in the table below are on the left of the Source field Column Name Description Line Displays the line number for the source file Source Address After your program has been downloaded the source view displays the addresses for the current source file S W Breakpoints Display the PC location 5 and breakpoints Setting PC breakpoint by double click REJ10J2000 0100 Rev 1 00 Jun 16 2009 303 RENESAS High performance Embedded Workshop 17 Debugging Facility e The Source field includes codes highlighting the syntax Options Right clicking within the Source field opens a pop up menu containing available options Pop up Menu Option Macro Recording Function Open Source File For Editing Opens an editor window containing the file for editing Open File in Source Mode Opens a file shown in the disassembly window Copy Places a copy of the highlighted text into the Windows clipboard Find Finds text in the current file Goto Line Jumps to a line in a file Toggle Breakpoi
279. disassembly columns Shows or hides the column header Launches the Instant Watch dialog box with the name extracted from the view at the current text cursor not mouse cursor position Starts executing the user program at the current PC and continues until the PC equals the address indicated by the current text cursor not mouse cursor position Changes the value of the Program Counter PC to the address at the row of the text cursor not mouse cursor Opens the source file or disassembly at the address of the PC Opens a Disassembly window at the address mating the current source line Displays file properties Support for this function depends on the debugger 17 2 1 2 Viewing assembly language code The Disassembly mode shows at the same address of the cursor line as the Source mode You can view assembly language codes only when the debugger is connected REJ10J2000 0100 Rev 1 00 Jun 16 2009 298 RENESAS High performance Embedded Workshop 17 Debugging Facility Window configuration at DemoSH4 c Disassembly View mixed mode View Source B View Disassembly Column Sa na 45M Disassembly Address header noooz000 OOOUOZ002 HOOoz004 Disassembly Address column Label column SAW Break poms ASM column Ob code column Disassembly e Clicking another toolbar button switches the display mode To view disassembly codes in mixed mode click the View mixed mode button To view
280. display or non display of flags display area When the radix or flag is shown the option is checked When the radix and flags are displayed Value Radix _ RO OOOO00LO Hex Rl QOOOOO00FO Hex Ra OOO40001 Hex ba MD RB EL FD M 0 IMSE Ds IMASE Iz 1 Ste Seer ae l 1 1 IMASE 11 IMASE IO 5 T FR S52 PR DN 1 l Old 1 CAUSE E CAUSE V CAUSE Z CAUSE 0 CAUSE U O 0 0 0 j CAUSE I ENABLE V ENABLE 4 ENABLE 0 T 0 T 0 ENABLE U EMNABLE I FLAG Y FLAG z FLAG O 0 0 j j j FLAG U FLAG I RM1L RAO O T 0 1 17 7 5 Choosing a register to be displayed To choose a register to be displayed in the Register window choose Settings from the register pop up menu This dialog box is shown in following figure REJ10J2000 0100 Rev 1 00 Jun 16 2009 342 RENESAS High performance Embedded Workshop 17 Debugging Facility Settings a Registers l Select all MAIO IMACH ee WAT if MAAC if 1 2 WPA WARTS Mf SSF WAT iw SPC iv 5 iv AO BANE ivf PC iw AT_ BANE WSR WA BANE if GBR iw BANE if BF WA 4_ BANE Unselect all Cancel tHE wL iM MASE S iw T Mf MASE 12 wf FF Wlas M4 MASE IO 17 7 6 Modifying register contents To change register contents follow the procedure below Enter a value in the Value field of the register you want to change MDORBARL To change a register s contents open the Set Value dialog by
281. dit box is empty the initial directory will default to WORKSPDIR Enter the options for building the makefile in the Makefile options edit box Enter the options for cleaning the makefile in the Clean options edit box Click on the OK button Once this system is setup the build button menu and keyboard shortcuts are linked to the makefile tool execution The clean all projects button menu and keyboard shortcut will also be linked to the makefile execution All output is directed to the Build tab of the output window as in the case of the normal build If you are using a build phase supported by High performance Embedded Workshop the line of an error message can be double clicked to jump to the source files The help link should also be supported Note when using the HMAKE exe system the Build All toolbar button E will pass a command to HMAKE to force a re build all operation To set up the makefile system environment By default the makefile will be executed in the default system environment the same environment used within High performance Embedded Workshop If this is not desirable the environment can be configured as described below L In the Build tab click the System button to the right of the Makefile options controls This will launch the Makefile System Environment dialog box Makefile System Environment I Inherit system environment Cancel Add Hodiy Environment variables The Inherit
282. dow You may also select a file folder project folder workspace folder or combination thereof 2 Select one of the following operations ic e Click the Check in to VCS toolbar button amp OR e Select Tools gt Version Control gt Check in to VCS OR e Right click to invoke a pop up menu and select Version Control gt Check in to VCS REJ10J2000 0100 Rev 1 00 Jun 16 2009 164 RENESAS High performance Embedded Workshop 9 Visual SourceSafe Version Control System Check in to YCS Workspace Mame hwg oAwWorkep Mw Project _Hame hwp oworksp Mw Project Name c oworksp typedetine h oworksp Midbsctc octal mie T Cancel Comment 3 The Check in to VCS dialog box opens Select the checkbox on the left to the name of the file that you wish to check back into Visual SourceSafe and click the OK button 4 When the operation is finished the file has a red mark next to its name This means you as the current user of High performance Embedded Workshop has checked it out 5 The red mark next to the file name is removed which indicates that the file has been checked into Visual SourceSafe If you select the Keep checked out checkbox in the Check in to VCS dialog box before you check the files into Visual SourceSafe these files can be writable even when they are checked out 9 2 6 Viewing the status of files in Visual SourceSafe Although files appear in your High performance Embedded Workshop
283. dow sccsaccantsnoocassnsnecsvarvesemnncdontsnnbdnatodadsauhssattantiedaddawbsuabDaascaumebvakbaanededienlsnoadaatinns 353 17 162 Viewing the soutce protam x siiceertncctneutsresensnsstuamnstatceniecadsentseadsowinacbvaneatagdeninsatwand EURE ATENa 353 716 3 Speciyins the view wer scs Gameaeceaaaacsteatanaaned Enen Eran AERES tenet EEO EEE EEA ENR EEE SERE ESERE 354 17 16 4 Selecting an encoding format ccssssssssssseeeccceeeeeeeeeaaeeseeesseeeeeeeeeeeeeeesesaeeeeeeeeeeeeeeeeeeeeeeeeeeeeaaaeaaagaasaesses 354 7 Usne aie i BO Ge i cays Seco aeaa anaE Eia E E e Eii 354 17 17 1 Configuring the Hitachi Debugging Interface to integrate with High performance Embedded Workshop 355 17 17 2 Configuring the PD debugger to integrate with High performance Embedded Workshop 066 355 17 17 3 Configuring an external debugger to integrate with High performance Embedded Workshop 356 17 18 Debugging functions dependent on the debugger nnnnnneeesssssssssssssssseeteeersssssssssssssseeteerrrssssssssssseeeerrerrereeessssss 357 EA E E aa e E E E EE E E 357 VAis2 EW Dwar SUP DOr sesseur E E E EEA E 360 eieo Loom a raabe r E r E r E E 364 tS SV MC MONI Ze TC US i S eisern E E E 378 18 1 The Synchronized Debug dialog DOK vessacidannsnnsceansseinteniaveiweanws Mioelamabenadenulnuennsdasteniaseaulsinteasieendirtasaglsacestndoaidasbweatans 378 18 1 1 Managing COnfiQurations siesena aN Ra NEEE NEE E EEA Raa a Eea TARNE Ra TaN Eiaa 379 18
284. dow to perform this operation If the project 1s Unloaded its icon appears grayed in the Projects tab of the workspace window and no actions can be performed upon it Unloaded projects can be loaded by the following operations To load all projects in the workspace 1 Select a workspace in the Projects tab of the workspace window 2 Right click to display the pop up menu and select the Load All Projects option To load a project in the workspace 1 Select the Unloaded project from the Projects tab of the workspace window 2 Right click to display the pop up menu and select the Load Project option It is possible to select multiple projects in the workspace window to perform this operation 2 13 Specifying dependencies between projects The projects within a workspace can be dependent upon one another so that when one project is built all its dependent projects are built first This is useful if one project uses another in the workspace For example imagine that a workspace contains two projects The first project is a library which is included by an application project In this case the library must have been built and up to date before the second application can build correctly To achieve this situation we can specify the library as a dependent 1 e child project of the application project This would then allow the library to be built first if it is out of date When a dependent project is built the High performance Embedde
285. ds files to a project Removes files from project Add folder to a project RENESAS High performance Embedded Workshop 2 Build Basics Expand Collapse g Expands or collapses the tree below a project icon Version Control Executes a version control system Configure View Configures the workspace view Properties Displays project properties Right clicking on a folder other than Download module and Dependencies opens a pop up menu containing the available options Pop up Menu Option Macro Recording Function Add Folder Add a custom folder Rename Folder Rename a folder Remove Folder Remove a folder Configure View Configures the workspace view Right clicking on a project file opens a pop up menu containing the available options Pop up Menu Option Macro Recording Function Open lt file name gt Opens a file in the High performance Embedded Workshop editor Open lt file name gt in external editor Opens a file in the external editor Build lt file name gt Cy Builds a file Build Options Sets build options Add File Adds files to a project Remove File Removes files from project Exclude Build Excludes a project file from build OR OR Include Build Includes a project file in build Version Control Executes a version control system Configure View Configures the workspace view Show Differences Compares files Properties Displays file properties Note This option is available o
286. e Test cases OF Modip Hemose 16 Test Support Facility The Modify Test Suite dialog box displays the currently defined test cases Each test case has a name and can have a detailed description that you have defined to explain the tests purpose Clicking the Add button on this dialog box displays the Add New Test dialog box this is shown below Add Hew Test Test name Test D ema Test description Demonstration Tests to execute File Path Demo Default lid Cancel Bemare Mave to tap Mave tp Move dawit Bemve Howi Hwe Hove dwn Hore abot Mowe to botton Test image file C wworkspace D emoSH4 Test Suite Deno _Test_Demo ht p Browse Selecting the test and clicking modify allows you to edit currently defined details for the selected test These details are also shown in the same dialog as that used for Add new test If you click Remove the test is removed The Add New Test dialog box allows you to configure tests for execution later This is discussed in Adding tests to the test suite You can also edit a test suite from the workspace window pop up menu REJ10J2000 0100 Rev 1 00 Jun 16 2009 234 RENESAS High performance Embedded Workshop 16 Test Support Facility 16 4 Adding tests to the test suite Once your test suite has been created the next step is to add some tests This operation allows you to access the Modify Test
287. e Jhewtest Release Build All hewtest Debug hewtest Felease Jhewtests Debug hewtest3 Release Check All Jhewtest4 Debug Uncheck ll Jhewtest4 Aelease Froject configurations Clean HEBER Cancel 3 When you are happy with your chosen selection click the Build button and the High performance Embedded Workshop will build the selected projects and configurations 4 If you want to build all of the projects click the Build All button This will automatically select all projects and configurations and build them all 5 If you also wish to delete intermediate and output files of the selected project or configuration click the Clean button This does not execute the build 6 Results from the build are displayed in the Build tab of the Output window in the same way as in a normal build process 7 If you use the dialog again it will restore the checked status from the last time you used it 2 8 4 Stopping tool execution The High performance Embedded Workshop allows you to halt the build process once it is under way To stop tool execution Select one of the following operations e Click the Stop Tool Execution toolbar button ea OR e Select Build gt Stop Tool Execution The Build Stopped by User message appears in the Build tab of the Output window REJ10J2000 0100 Rev 1 00 Jun 16 2009 52 RENESAS High performance Embedded Workshop 2 Build Basics Note
288. e Seen C source file 2 dbsct c ve Demo c s E intprg c E lowste c ve resetprg c w E sbrk c sew vecttbl c ae Dependencies When Build gt Build is selected a confirmation dialog box appears to ask if you wish to update the file dependencies before executing the build If you have not manually updated dependency data it may be out of date When you want dependency data to be updated prior to build select Yes If you select No it executes Build based on current dependency scanning data Confirmation Request ki 1 IF you have not manually updated dependency data it may be out of date Do pou want dependency data to be updated prior to build T Don t ask this question again If you do not wish to open this confirmation dialog box select the Don t ask this question again checkbox To open the confirmation dialog box again 1 Select Setup gt Options The Options dialog box opens Select the Confirmation tab 2 3 Select the Scan Dependencies Prior To Build checkbox This checkbox is selected by default 4 Click OK To manually update file dependencies in a project Select one of the following operations e Select Build gt Update All Dependencies OR e Right click on a project in the Projects tab of the Workspace window and select Build gt Update All Dependencies from the pop up menu REJ10J2000 0100 Rev 1 00 Jun 16 2009 59 RENESAS High performance Embedded Worksho
289. e Once a file is checked out it is edited and then checked back in so that the edits can be made available to REJ10J2000 0100 Rev 1 00 Jun 16 2009 165 RENESAS High performance Embedded Workshop 9 Visual SourceSafe Version Control System other users However if the check out operation was carried out by mistake or perhaps is no longer required then the operation can be undone To undo a check out of files from Visual SourceSafe L 9 2 8 Select the files upon which you would like to undo a previous check out operation in the Projects tab of the workspace window You may also select a file folder project folder workspace folder or combination thereof Select one of the following operations Select Tools gt Version Control gt Undo Check Out OR Right click to invoke a pop up menu and select Version Control gt Undo Check Out Undo Check Out kWlWworkspace_Mame hws Ework sp A W Project _Mame hwp CAWorksp Cancel Mw Project Name c Oworksp typedetine h oworksp Midbsctc orl a n r m ens I The Undo Check Out dialog box opens Select the checkbox on the left to the name of the file that you would like to undo a previous check out operation and click the OK button If the file has been modified the confirmation message box shown below appears To continue the check out operation click the Cancel button To load the unmodified file from the version control system click the Yes button If you clic
290. e Build tab along with the source file name and line number If you click on a toolbar button or pop up menu option associated with display of error messages the line of the error message will be highlighted and the editor will show the source code of that line if the line has any source code Double clicking the line of an error message will also show the source code in the editor When you attempt an operation to display an error or warning the status bar shows this error or warning message Right clicking displays a pop up menu containing available options A basic operation is allocated to the toolbar The functions of Toolbar display and Customize toolbar are also included in the pop up menu displayed by right clicking the toolbar area Pop up Menu Option Toolbar Button Function Ol Highlights the next occurrence of error and shows the source code in the editor GE Highlights the previous occurrence of error and shows the source code in the editor f Highlights the previous occurrence of warning and shows the source code in the editor Display next Displays the editor that generated the next build error or warning Error Warning Info Display previous Error Warning Info Help Displays the editor that generated the previous build error or warning Shows the help information about the line Goes to the associated source line Clears the contents of the window Go to Error Warning Info Clear Window Save
291. e EC SS LOIS a teen ete eenana cance E E E EE E 406 a PTAC COG C08 seca ssaessec pes terre E T E E 407 5 1 MA Oe E a E EE eatonennuceaaccicaseaueensee 407 we mare a pae OI Eeen E E 407 5 3 Available PlACENOIIETS se lt ninorcvessinonetenonenduearioemesdnensdsveronemendnenadeannuoncsansueidcasnnenetenoowsdbedwasedroneesdueanenenecnidbetuncutuanmesstennl 408 34 Placeholder UPS erasers cae cette cneewctseme consissuticnpwediea aed an oepeeeueaeidsertieunaladapice taneueweseud nese thannesenheannneptacudanitventesanaeecetseee 409 6 VORIT OU 55 caer cores RE E soon sade een crac sonesesanba pean EE EEEE E 410 7 DY OL Pee Ot WAU ea ni EE E A R E E E EE 412 8 Keyboard MOTI C1 i5ccicntvessssasscaeecntecnsensnadeatendsensssassdacececccnscnosataeiantceusiaasataaeensccusoantaddasendcceseanams 413 9 Drac and Drop mthe TS C0 oe sa cecerece scatter enccreantreninconassseeaaestandbaa nace namesineoesasdensanstanabeannadenates 415 10 Using Labels to View Your Code sj ercc dscsuescssanenctcasecnntsavetadbotinnctsmce det a ea eiai 416 11 Integrated Toolbars in a Components View ccccccccccccceessseeeeccecceaeeeseeeeceeeeeeaaeeseeeeeeeeeenaas 418 12 To Build in Toolchain for High performance Embedded Workshop V 1 X eee 420 I HMAFE Der Eep a E E en EE 421 D Command iE eserse E TA EE EEEE EEEE ET 421 MN a E A A N S A N N N AE E E EE E E A A 421 Ir Description DOCS essees EE RE EE EEE 422 Te OS e E EOE EENIA A A AEI EE AEN 424 TD Messace Comma
292. e Open Log File dialog box in which a log file to store the command execution results can be specified Open Log File Log File p Browse gt Cancel Enter the name of a log file log The logging option is automatically set and the name of the file is shown on the window title bar Opening a previous log file will ask the user if they wish to append or overwrite the current log REJ10J2000 0100 Rev 1 00 Jun 16 2009 208 RENESAS High performance Embedded Workshop 14 Command Line 14 6 Starting or stopping logging Choose Logging from the pop up menu to toggle logging to file on and off When logging is active the button becomes effective Note that the contents of the log file cannot be viewed until logging is completed or temporarily disabled by clearing the check box Re enabling logging will append to the log file 14 7 Entering a full path to the file It is recommended that the full path to a file is specified as a file name in the Command Line window because the current directory can be moved However care must be taken to enter the correct full path to a file when it is entered from the keyboard To save this trouble a full path can be easily specified by browsing through files Choose Browse from the pop up menu to open the Browse dialog box Select a file and click Open to paste the full path to the selected file to the cursor location This option can only be used when the cursor is located on th
293. e access violation area 15 5 2 20 Violation of stack access dialog box While a macro is being recorded the following operation will be recorded into a macro file Target Operation Function OK button Click on the button Sets the access violation area 15 5 2 21 Violation of task stack access dialog box While a macro is being recorded the following operation will be recorded into a macro file Target Operation Function OK button Click on the button Sets the access violation area 15 5 2 22 Performance Conditions dialog box While a macro is being recorded the following operation will be recorded into a macro file Target Operation Function Apply button Click on the button Changes the performance conditions 15 5 2 23 Trigger Output Conditions dialog box While a macro is being recorded the following operation will be recorded into a macro file Target Operation Function Apply button Click on the button Changes the trigger output conditions REJ10J2000 0100 Rev 1 00 Jun 16 2009 227 RENESAS High performance Embedded Workshop 15 Macro Recording Support Facility 15 5 2 24 Realtime Profile window While a macro is being recorded the following operations will be recorded into a macro file e E200F emulator software Target Operation Function Clear Data pop up menu Click on the menu option or toolbar button Clears all measurement data of real option toolbar button time profile Save To File pop up menu Make setting
294. e available See Chapter 9 Visual SourceSafe Version Control System To deselect a version control system 1 Select Tools gt Version Control gt Select The Select Version Control System dialog box opens 2 Select lt None gt from the Version control systems list 3 Click on the OK button 7 2 Importing and exporting a set up Each workspace can have a different version control setup The High performance Embedded Workshop allows you to store the version control settings independently so that you can import them into other workspaces This greatly reduces the amount of time it takes to configure the same version control settings across several workspaces To export a version control setup 1 Select Tools gt Version Control gt Configure The Version Control Setup dialog box opens 2 Click the Export button An Export current Version Control configuration dialog box opens 3 Browse to the directory in which you would like to save the configuration 4 Enter the name of the file and then click the Save button To import a version control setup 1 Select Tools gt Version Control gt Configure menu option The Version Control Setup dialog box opens 2 Click the Import button An Import a Version Control configuration dialog box opens 3 Browse to the HVC file that you would like to import 4 Select the file and then click the Import button REJ10J2000 0100 Rev 1 00 Jun 16 2009 136 RENESAS High performance Em
295. e commands are output to the Macro tab of the Output window However some operations open another tab 1 Click the Record Macro button on the Macros toolbar The mouse pointer is modified to include the record icon te The message Recording is shown in the Macro tab of the Output window 2 Select File gt Refresh Session Irhis records the refresh_session command 3 Click the Registers button E1 on the CPU toolbar to open the Register window Double click the register of which you wish to change the value to invoke the Set Value dialog box Enter 0 in Value IThis records the register_set command REJ10J2000 0100 Rev 1 00 Jun 16 2009 25 RENESAS 10 11 12 High performance Embedded Workshop 1 Overview ann records the build command Double click to download the program for demonstration within the Download modules folder in the Projects tab of the workspace window Eir his records the file _load command Click the Memory button Ee on the CPU toolbar to invoke the Display Address dialog box Enter the address of the data field in Display Address Then select Fill from the pop up menu Enter 0 as the data in the Fill dialog box IThis records the memory_fill command Click the Reset CPU button Et on the Debug Run toolbar to reset the CPU IThis records the reset command Open a source file including a main function in the editor window Right click on the last line of the main funct
296. e file and click Select The file is now imported It automatically becomes the default macro file in the Current macro file drop down list The file is also copied into the Macros folder within the High performance Embedded Workshop management information folder under the application data folder for each user profile 4 Then click Close on the Macro dialog box and the macro file is ready for use Another method is to simply copy the new macro file into the Macros folder in the High performance Embedded Workshop root directory High performance Embedded Workshop will automatically detect the new file and add its information to the High performance Embedded Workshop macros dialog box The new file will not be the default file for use so you will then have to enter the macro dialog box to switch the default macro file to the newly copied one 15 4 Recording a macro There are a number of ways to record a macro file in the High performance Embedded Workshop these options are discussed below REJ10J2000 0100 Rev 1 00 Jun 16 2009 216 RENESAS High performance Embedded Workshop 15 Macro Recording Support Facility To record a macro from the toolbar or menu 1 Click the Record Macro button or menu option on the Macros toolbar or the Tools menu To indicate that a recording operation is taking place the mouse cursor is modified to include the record icon When the macro is being recorded the Pause Macro Ml and Stop Macro O buttons
297. e files Linkage list files MAP and assembly program list files LIS are not deleted Also note that the extension for absolute files differs depending on the selected format 2 8 6 Configuring the Build tab of the Output window The Build tab shows the output from any build process e g compiler assembler and so on If an error is encountered in a source file an icon and the error message will be displayed in the Build tab along with the source file name and line number If you click on a toolbar button or pop up menu option associated with display of error messages the line of the error message will be highlighted with text in white and its background in dark blue and the editor will show the source code of that line if the line has any source code Double clicking the line of an error message will also show the source code in the editor When you attempt an operation to display an error or warning the status bar shows this error or warning message You can also customize the Build tab so that the texts in the lines of error messages will be highlighted in a color different from that of the texts in other lines The figure below shows the error messages in red and warnings in green as an example REJ10J2000 0100 Rev 1 00 Jun 16 2009 54 RENESAS High performance Embedded Workshop 2 Build Basics Joao aat Uele Phase SH C C Compiler starting Workspace DemoSH4 Demos dbsct c Workspace DemoSH4 DemosH4 lo
298. e function to be set and their detailed information Name Displays the names of the functions Address Displays the addresses of the functions Counter Displays the number of the functions having the same name All Function Displays the number of same name functions or member functions Select Function Displays the number of functions displayed in the Select Function Name list box Set Function Displays the number of functions displayed in the Set Function Name list box 1 Selecting a function Click the function you wish to select in the Select Function Name list box and click the gt button You will see the selected function in the Set Function Name list box To select all functions in the Select Function Name list box click the gt gt button 2 Deselecting a function Click the function you wish to deselect from the Set Function Name list box and click the lt button To deselect all functions click the lt button The deselected function s will be moved from the Set Function Name list box back to the Select Function Name list box 3 Setting a function Click the OK button to set the functions displayed in the Set Function Name list box The functions are set and the Select Function dialog box closes Click the Cancel button to close the dialog box without setting the functions 17 18 2 4 Debugging an overlay program Programs making use of the Overlay function can be debugged This section explains the settings for using t
299. e gt in external editor option from the pop up menu Clicking the Edit Code button in the Breakpoints dialog box opened by selecting Edit gt Source Breakpoints Drag and drop into the High performance Embedded Workshop window When a file is dragged from the Windows Explorer and dropped into the High performance Embedded Workshop window note that however a drag and drop of a file onto the current project and user folder into the Projects tab of the workspace window only adds this file to the project and does not open the file To specify an external editor 1 2 3 External editor Mad ligt Select Setup gt Options The Options dialog box opens Select the Editor tab Check the Use external editor checkbox The External Editor dialog box opens REJ10J2000 0100 Rev 1 00 Jun 16 2009 130 RENESAS High performance Embedded Workshop 6 Customizing the Environment External Editor lea Command Ok C WINNT NOTEPAD EXE Browse Cancel Arguments to open file FULLFILE Seenecel Arguments to open file at line siFu LLFILE Co 4 Enter the path of the executable without any arguments into the Command field Enter the arguments required to open a file into the Arguments to open file field Use the FULLFILE placeholder to represent the path of the file to be opened 6 Enter the arguments required to open a file at a specific line into Arguments to open file at line field Us
300. e last line 14 8 Pasting a placeholder Select a placeholder from the Placeholder submenu in the pop up menu to paste the selected placeholder to the cursor location This function is only available when the cursor is located on the last line Placeholder sub menu Placeholder Configuration directory CONFIGDIR Configuration name CONFIGNAME Project directory PROJDIR Project name PROJECTNAME Workspace directory WORKSPDIR Workspace name WORKSPNAME HEW Installation directory HEWDIR 14 9 Selecting all the window contents Choose Select All from the pop up menu to select all contents in the Command Line window 14 10 Copying the selection onto the clipboard Choose Copy from the pop up menu to copy the selected text block onto the Windows clipboard Only available if the test block is selected 14 11 Cutting out the selection to the clipboard Choose Cut from the pop up menu to remove the selected text block and copy them onto the Windows clipboard This option is available only when you have selected the text block currently being input at the latest cursor position 14 12 Pasting the contents of the clipboard Choose Paste from the pop up menu to insert the content of the Windows clipboard at the current cursor position This option can only be used when the cursor is at the last line REJ10J2000 0100 Rev 1 00 Jun 16 2009 209 RENESAS High performance Embedded Workshop 14 Command Line 14 13 Clearing the
301. e of the start position unless a prefix REJ10J2000 0100 Rev 1 00 Jun 16 2009 325 is included values are treated as decimal numbers RENESAS High performance Embedded Workshop 17 Debugging Facility Width Height Size Specifies the height and width of an image to be displayed on part of the screen Width Pixel Specifies the width of the display unless a prefix is included values are treated as decimal numbers Height Pixel Specifies the height of the display unless a prefix is included values are treated as decimal numbers After the settings have been made in the Image Properties dialog box clicking the OK button opens the Image window Even after the Image window is displayed the display contents can be modified by opening this dialog box by choosing Properties from the pop up menu The Image window shows the memory contents as an image Image Ed Toolbar Nonrefresh E E gt H Hj rhe m e Double clicking within the window displays information on the pixel on which the mouse pointer is located in the Pixel Information dialog box Options Right clicking displays a pop up menu containing available options A basic operation is allocated to the toolbar The Toolbar display and Customize toolbar options are also included in the pop up menu opened by right clicking on the toolbar Pop up Menu Option Toolbar Button Macro Recording Function Auto Nonrefresh Harrehesh i Disables refresh of the
302. e test image data to be saved into test image files and test results not matched Test group name Symbol Test item name ASMWatch Test image data to be Values set as detailed information and the range of data in the ASMWatch window acquired with this REJ10J2000 0100 Rev 1 00 Jun 16 2009 246 RENESAS High performance Embedded Workshop 16 Test Support Facility saved into test image files setting Checkboxes for all watch points are blank by default Test result details Failed at xxx data value is different Name of the unmatched watch point Src Content of the test image file Dest Data in the current High performance Embedded Workshop system or in another test image file to be compared with Example Failed at 414 data value is different Src 0000 Dest 0001 To make detailed setting If you double click on a test item in the Create New Test Image dialog box a further dialog box for detailed setting opens Edit Test ASM Watch Points EE Compared watch Address Size OF Cancel Add Bit Delete ile T Ignore address for lables and symbols e To add a watch point 1 Click on the Add button on the Edit Test ASM Watch Points dialog box to open the Add dialog box Add Address ad zal Size Byte bd Rade i Hex Dec f Bin Cancel 2 Specify Address Size and Radix to set a watch point to be saved into a test image file 3 Click OK e To add a bit level watch point 1 Click on the A
303. e the FULLFILE placeholder to represent the path of the file to be opened and the LINE placeholder to represent the line number at which the cursor should be initially positioned 7 Clicking the Advanced gt gt button allows you to select the external or internal High performance Embedded Workshop editor for use when you attempt to open a file by any of the following operations e File open menu When a file is selected in the Open File dialog box By default the internal editor is selected e Workspace window double click When a file in the Projects tab or an entry in the Navigation tab 1s double clicked in the workspace window By default the external editor is selected e Output window double click When an error or warning in the Build tab or an entry in the Find in Files 1 or Find in Files 2 tab is double clicked in the output window By default the external editor is selected e Drag and drop file into HEW main window When a file is dragged from the Windows Explorer and dropped into the High performance Embedded Workshop window note that however a drag and drop of a file onto the current project and user folder into the Projects tab of the workspace window only adds this file to the project and does not open the file By default the internal editor is selected 8 Click the OK button When the Use external editor checkbox is selected the following actions always select the external editor for use e Clicking the Edit
304. e tree underneath the Project name field shows the structure of the database specified in Step 5 Select the folder into which you would like to create the folder specified in Project name REJ10J2000 0100 Rev 1 00 Jun 16 2009 159 RENESAS High performance Embedded Workshop 9 Visual SourceSafe Version Control System 9 Click the OK button in the Create SourceSafe Project For Workspace dialog box The Create SourceSafe Project dialog box opens The example below shows that the High performance Embedded Workshop workspace Workspace_Name is added as a project Workspace_Name into Visual SourceSafe database The Project name field shows Poject_Name that is to be created next sourcesate Project Cancel 10 Click the OK button in the Create SourceSafe Project dialog box 11 Repeat step 10 for each of the projects in the current workspace The structure image of projects and sub projects in the Visual SourceSafe database High performance Embedded Workshop workspace and projects and the workspace directory in the hard disk is shown below Projects and sub projects in HEV workspace and Workspace directory in the Visual SourceSafe projects the hard disk database visual SourceSafe working tolder Ha Wor kapar 2 Mame E Work zp ace Ma the Work p ace Na ME a Project_Name E i Project_Name 4 Project_Name The High performance Embedded Workshop has now created the necessary projects within Visual SourceSafe and
305. e trying to debug your program you will want to be able to stop the program running when it reaches specific points in your code You can do this by setting a program counter PC breakpoint on the line or instruction at which to want the execution to stop The following instructions will show you how to quickly set and clear simple PC breakpoints To set a PC breakpoint in the Editor window 1 Make sure that the source or disassembly view is open at the place at which you want to set a PC breakpoint 2 Select the Toggle Breakpoint pop up menu option or press F9 at the line showing the address at which you want the program to stop You will see a red circle appear in the gutter to indicate that a PC breakpoint has been set 3 Itis possible to enable or disable the current breakpoint by selecting Enable Disable Breakpoint from the pop up menu 4 Now when you run your program and it reaches the address at which you set the PC breakpoint execution halts with the message PC Breakpoint displayed in the Debug pane and the source or disassembly view is updated with the PC breakpoint line highlighted Additional information When there are two or more instances of a template function breakpoints can even be set at the addresses corresponding to a single line of source code template lt typename T gt T1 tempfunc T t1 g iVal tl gt A breakpoint set here is also applied to tempfunc c and tempfunc s return g i1Val
306. e used as input to the compiler phase Additionally the High performance Embedded Workshop allows you to define your own extensions For example if the project you are developing uses assembler source files the default extension may be src If you would like to use a different extension instead of src e g asm then you can define a new extension and request that the High performance Embedded Workshop treats it in the same way as a src file File extensions and file groups can be viewed and modified via the File Extensions dialog box which is invoked by selecting Project gt File Extensions This dialog box displays all the extensions and file groups that are defined within the current workspace REJ10J2000 0100 Rev 1 00 Jun 16 2009 44 RENESAS High performance Embedded Workshop 2 Build Basics File Extensions Group Absolute tile Gssembly include tile Gesembly list tile Gesembly source file Hesembly source file Remove Gesembly source file Binary file Open with C header tile C list tile source file G header file i let file The File Extensions list is divided into two columns On the left are the file extensions and on the right are the file groups associated with the extensions Many file extensions can belong to the same group For example assembler source files may have several extensions in a single project e g src asm mar etc a ey et SFE AZM AMAF Assembler source files T source
307. e workspace Select a session within the project Click OK a ge E lS The combination of workspace project and session specifies a Debugger This is added to the list on the main dialog The Debugger is given an initial ID based on its platform name normal single core platform or core name multi core platform Note The specified workspace must be up to date with the current version of High performance Embedded Workshop and not have been copied to a new location after it was last opened in High performance Embedded Workshop Any such workspace must be opened and closed normally in High performance Embedded Workshop so that the workspace files are updated before it can be specified on this dialog Changing a Debugger s ID 1 Select the Debugger to be changed in the list 2 Click the Modify button REJ10J2000 0100 Rev 1 00 Jun 16 2009 381 RENESAS High performance Embedded Workshop 18 Synchronized Debugging Options Main Cancel CPU mode Debug 3 Enter a new unique ID for the Debugger 4 Click OK The Debugger s ID will be updated in the list It is not possible to modify Debugger Ds when synchronized Changing a Debugger s options There are two methods of changing a Debugger s options First method 1 Select the Debugger in the list 2 Click the Modify button 3 Select the new options from the drop list 4 Click OK Second method 1 Select the Debugger in the list 2 Click
308. eaaeae 98 49 Rela is GO COR BOM riese na a A E RE O aE oG iaaii 99 AO Sna Co A a E 99 4 10 1 CIM E Ea O i E E A E A E AEE A E I A P E E E O 100 4 10 2 Creating new keywordSs eeesssessssseseeeeteerressssssssssssseeterrerssssssssssssetereeerosssssssssssseeerrerressreessssssssssssseeeeeeeee 100 4 10 3 Enabling disabling syntax coloring 00ssseeeooeeeneesssesssssssssseeerrrrssssssssssssseeereeeessssssssssssseeeeeerressreessssssssssees 101 MTA A S E EA N AS A N AT E AS IAN NE IIE E N E A A T A 102 4 11 1 Deom arempi e Or E E 102 411 2 Deleting ASMP Ale sosoca ra nAra EEE E EER A EE SE SE 104 4 11 3 Inser me a We HVAC eiseres enasi aerae A EEE EEEn as ssesnussdecinpantevesoeecdetdeleivestooundtanecetsten 104 Ie Pao MMO a E E EE E E E E 104 4 13 Setting the read only attribute for a file oo ececccceecccccececceeceaeeeeseseeeeeeeeeeeeeeeeeeeeaeaeeeesseeeeeeseeeeeeeeeeeeeeeeaaaageensees 105 4 14 Preventing modification of files while debugging nennnssssssssseeeeeeerrsssssssssssssseeererssosssssssssssseerererrereeessssssssssses 105 4 15 Managing the editor COMM Ss c sicnsrnsancasnecnnonetaisasuanzesumvsnannanesesaesabamenvanaaennnsaiinnanodsne ghmecadalenneaenacuixennseanndesmenumaneneannans 105 4 16 Showing hiding the column header cccccc cccscsssvessvesseeesacessecencessdansoeeasssesesadecasedsaccnnccsduaesecevesaeeoeesennnecnensntenseeaesers 106 4 17 Opening a file within the editor wins asernsancsane omecetagnasedwauna
309. eadme txt as a summary file in the project directory will save the project information displayed in the Summary dialog box as a text file named Readme txt in the project directory 17 1 2 1 To create a new project having information from makefile High performance Embedded Workshop can analyze GNU make format and Hmake format High performance Embedded Workshop generated and create a workspace which has file information from makefile Open the New Project Workspace dialog box and select the Import Makefile as project type After supplying some fields e g Workspace Name and pressing OK button New Project Import Makefile dialog box opens REJ10J2000 0100 Rev 1 00 Jun 16 2009 271 RENESAS High performance Embedded Workshop 17 Debugging Facility Hew Project 1 6 Import Makefile P Makefile path CAH EW WorkspacesSH4 Dermot mal Import options Start Source files E a Project T H 2 C source file i E dbsct c Add beh lowsre c 7 resetprg c A Z sbrk c Rengyve By Assembly source fil ac intprg src DER E Fart Gd ere lt Back Hest gt Bine Cancel When a makefile is selected by Makefile path Source files shows source files in the makefile To view the source files in the makefile again click Start To apply toolchain options such as the compiler select the Import options check box If you want to remove a file from the project you can remove it by selecting the f
310. ebugging However you cannot modify data in this pane The contents of the selected batch file are displayed Single stepping of command lines can be performed in the selected batch file Execution can start from the top of the batch file A breakpoint can be set in the Breakpoint column on the left to the command line A yellow arrow 5 gt in the Breakpoint column indicates the command line where execution is to start The line where execution is to start 1 e the yellow arrow 5 can be returned to the top of the batch file The results of command execution can be output to a file o Lower pane results of command execution The lower pane shows the results of command execution This information is in synchronization with the contents of the Console tabbed pane However you cannot modify data in this pane You can clear the information shown in this pane The contents of the Console tabbed pane will also be cleared REJ10J2000 0100 Rev 1 00 Jun 16 2009 205 RENESAS High performance Embedded Workshop 14 Command Line Options e Console tab Right clicking displays a pop up menu containing available options A basic operation is allocated to the toolbar The Toolbar display and Customize toolbar options are also included in the pop up menu opened by right clicking on the toolbar Pop up Menu Option Toolbar Button Macro Recording Function Set Batch File BAL Specifies a batch file Play Play
311. ebugging Facility Note Fly Memory Management Unit H E PTEH FFOoOoOo ooooooon Selected Register This function cannot be used during execution of the user program 17 6 7 Loading an I O file I O files can be manually loaded to the IO window To load an I O file 2 gt Right click in the IO window to display a pop up menu Select Load IO File The Set I O File dialog box opens Specify an I O file you wish to load in the I O File field To insert a placeholder in the I O File field click the Placeholder button a and select a placeholder from the pop up menu To browse a file click the Browse button If the Save path name of the I O file checkbox is not selected the path name in the I O File field will not be saved when you save the session The next time this session is selected the contents to be loaded to the IO window depend on the debugger When the I O file has been automatically downloaded ensure that this checkbox is not selected The I O file dependent on the selected CPU is chosen by the debugger and automatically loaded If the Save path name of the I O file checkbox is selected the path name in the I O File field will be saved when you save the session The next time this session is selected the most recently loaded I O file will be loaded to the IO window This checkbox is not selected by default Click OK If the register names in the loaded I O file and those shown on the Select I O Registe
312. ecimal Displays in octal Displays in binary Places a copy of the highlighted text into the Windows clipboard the toolbar Pop up Menu Option Toolbar Button Macro Recording Function Edit Value Radix Hexadecimal 16 Decimal 10 Octal g Binary 2 Copy Toolbar display Customize toolbar 2 Editing a local item s value You can change the value of a local variable To edit a local item s value Select either of the following ways e In place edit in the Value column REJ10J2000 0100 Rev 1 00 Jun 16 2009 376 Shows or hides the toolbar Customizes toolbar buttons RENESAS High performance Embedded Workshop 17 Debugging Facility Locals Ea Flip i fz Name Value Type Fl Watch Item 1 FFOO0000 long 10 long ial H OOOOOO00 FFOOOOO4 long e Open the Edit Value dialog box in one of the following ways o Double click within the Value column o Right click on the line of a watch item and select Edit Value from the pop up menu Edit Value Ei E4 E spressioni fio Curent Value H OO000000 FFOCOOOD New Value Cancel Enter the new value in the New Value field and click OK The Locals window is updated to show the new value 3 Modifying the radix The radix for the selected variable display can be modified by choosing Radix from the pop up menu 4 Selecting an encoding format If the values of variables are characters or strings and they should be dis
313. ect Setup gt Options The Options dialog box will be displayed 2 Select the Confirmation tab 3 Select the Reload out of date download modules checkbox This checkbox is selected by default 4 Click OK 17 1 5 3 Check for changed source files before download The High performance Embedded Workshop can check to see if any of the source files have changed before the download module is downloaded in the current project If files have been modified then a confirmation is launched which asks the user if they wish to rebuild the code before the download takes place To rebuild the code before the download again select Yes To not rebuild the code before the download again select No Confirmation Request k x 2 The following download modules are out of date CoAWWorkspace SH4demo5 SH4demo5sDebugSH4demoa abs Do you wish to build the SH4derno project Don t ask this question again If you do not wish to open this confirmation dialog box select the Don t ask this question again checkbox To open the confirmation dialog box again 1 Select Setup gt Options The Options dialog box will be displayed 2 Select the Confirmation tab 3 Select the Build out of date download modules checkbox This checkbox is selected by default 4 Click OK 17 1 5 4 Showing a source tree on download debug only project While a debug only project e Debugger only xxxxxx is in use a tree of source files for a download module are autom
314. ect and other files in the server machine These files exist only in the server machine From the client machine the files are accessed via the network To open a workspace from the client machine To open a workspace on the network from the client machine search the network path and select the workspace in the Open Workspace dialog box 10 1 Sharing projects by network facilities in a PC with Windows XP Service Pack 2 or later Windows XP Service Pack 2 provides enhanced security measures In a PC with Windows XP Service Pack 2 or later you cannot share projects by network facilities if the Windows operating system is in its default state Before invoking the High performance Embedded Workshop you should take the procedures listed below to change the settings of the PC so that High performance Embedded Workshop system will be accessed via network When your server machine and client machine have Windows XP Service Pack 2 or later the settings are required for both machines e Fora server machine with Windows XP Service Pack 2 or later Step1 Firewall 1 Select Control Panel from the Windows start menu 2 Click Network and Internet Connections in the Control Panel 3 Click Windows Firewall in the Network and Internet Connections The Windows Firewall dialog box is invoked Click the Exceptions tab Click the Add Program button to open the Add a Program dialog box 6 Click the Browse button and select System Sec He
315. ect Edit Value from the pop up menu Edit Yalue Expression a Current H OOO00000 i FOOOO0N Value New Value Enter the new value in the New Value field and click OK The Watch window is updated to show the new value 6 Setting the scope of watch items The Watch window has the Scope column that shows the scope for registered symbols When a symbol is registered the default scope for the symbol is Auto The scope for child items is the same as that for their parent symbol and is not shown in the window In the Scope column you can select the scope for each of the watch items that have been registered Even when there are two or more variables with the same name scope can be separately specified to distinguish them Support for scope setting depends on the debugger in use and the Debug format selected in the Debug Settings dialog box When this feature is not supported the selection is Auto and this is not changeable The available types of scope are listed below Auto This scope covers all variables that can be watched from the address indicated by the program counter default Global This scope covers global variables in all load modules Global variables declared as static cannot be watched File scope name Load module name This scope covers static variables within the specified file scope Static variables declared within functions and global variables watched in the Global scope cannot be watched REJ10J20
316. ecution of Tools gt Macro Recording to Tools gt Stop Macro It is also possible to view this information while recording Ol Of A at 20 2t 7 Es bel 2 Record Macro Recording eee Build build wait Stop Macro Enter a macro name Finished recording Build acre Right clicking displays a pop up menu containing available options A basic operation is allocated to the toolbar The Toolbar display and Customize toolbar options are also included in the pop up menu opened by right clicking on the toolbar Pop up Menu Option Toolbar Button Function Clear Window a Clears the contents of the window Save Ei Saves the contents of the window into a text file Copy Copies the selected contents onto the Windows clipboard Toolbar display Shows or hides the toolbar Customize toolbar Customizes toolbar buttons REJ10J2000 0100 Rev 1 00 Jun 16 2009 231 RENESAS High performance Embedded Workshop 16 Test Support Facility 16 Test Support Facility The High performance Embedded Workshop provides regression testing facilities for your application by the test support facility Regression test 1s re execution of a previous test after modification of the program to verify the result The test tool allows High performance Embedded Workshop macro and batch files to be executed and the system can then be compared to see if it matches the original captured data It is possible to create many tests and scripts and autom
317. ed To check that the Add to VCS operation was carried out as you expected or to quickly review the status of all of the files in a project L 2 Select the project folder whose files you want to check in the Projects tab of the workspace window Select one of the following operations Click the Get VCS status toolbar button 8 OR Select Tools gt Version Control gt Get VCS status OR Right click the selected item to invoke a pop up menu and select Version Control gt Get VCS status The status of each file will be displayed in the Version Control tab of the output window or the File s Status dialog box For setting of location where the status is to be displayed see section 9 3 Visual SourceSafe REJ10J2000 0100 Rev 1 00 Jun 16 2009 161 RENESAS High performance Embedded Workshop 9 Visual SourceSafe Version Control System command options The information shown includes whether the file is added to the project if the file is checked out and if it is checked out and who did so 9 2 2 Removing files from Visual SourceSafe If you wish to take files out of Visual SourceSafe the files must be removed To remove files from Visual SourceSafe 1 Select the files that you would like to remove from Visual SourceSafe in the Projects tab of the workspace window You may also select a file folder project folder workspace folder or combination thereof 2 Select one of the following operations e Click the
318. ed Workshop 10 Using Labels to View Your Code Select Label Filter Label Address Cancel m Fa gh x __add DOOOE55s __allzera OUO05 244 __alocbut OOO05250 __calcnpw 0000S _ CLOSEALL OO002400 _ cmpegb4 OUU0450 0 __ompgeb4 OUO045E S _ empathy OUO04608 __cmpneb4 OUUU4620 __convb4 DOOU4640 _convbdu OUUU46 40 __convib4 OOOU4644 __convub OUO0465C __chype OUO0bR44 _ dive OOOO5E 70 __ divbdu OOO046 0 dil OOO04400 __divlu OOO04408 _ duchek ODOOUEO6O enna FUOOOSC0 __ficlose 000r C4 flopper OU002888 __flshbut OOO04644 __fmtout _ free In this dialog box the labels are initially listed in alphabetical order and their addresses are displayed on the right If you click a column header of names or addresses the labels will be sorted by the label name or the address value The Filter edit box can be used to help you search for a specific label in the list When the contents of the edit box are changed the label list is updated to display only the labels that contain the string entered not case sensitive So in the above dialog example if you entered conv6 as the filter the list box would be set to only contain __conv641 and 66 __conv64u This is a useful feature for when you have a large number of labels in your project REJ10J2000 0100 Rev 1 00 Jun 16 2009 417 RENESAS High performance Embedded Workshop 11 Integrated Toolbars in a
319. ed Workshop 17 Debugging Facility Options Right clicking within the Disassembly field opens a pop up menu containing available options Pop up Menu Option Macro Recording Function Open File in Source Mode Opens a file shown in the disassembly window Refresh Acquires the latest disassembly information to update the contents of the window Lock Refresh It is possible to lock a memory range in the disassembly so that it does not refresh View Source a Launches editor at location in source Set Address Enters a new start address Go To Cursor I Commences to execute the user program starting from the current PC address The program will continue to run until the PC reaches the address indicated by the text cursor not the mouse cursor or another break condition is satisfied Display PC Displays the disassembled codes at the PC location Set PC Here C Changes the value of the PC to the address indicated by the text cursor not the mouse cursor Edit Modifies the instruction at that address Find in Range Searches the range for the specified text string Copy Places a copy of the highlighted text into the Windows clipboard Define Column Format Sets the status of editor and disassembly columns Turn Header On Off Shows or hides the column header Save Disassembly Text a Saves the specific range Print Prints the specific range Toggle Breakpoint i Sets or clears a software breakpoint at the line showing the add
320. ed into a file a dialog is displayed which allows you to enter some custom text for each of these fields This text is then inserted instead of the placeholder You can define ten of these user input fields REJ10J2000 0100 Rev 1 00 Jun 16 2009 103 RENESAS High performance Embedded Workshop 4 Editor 4 11 2 Deleting a template To delete a template 1 Select one of the following operations to display the Define Templates dialog box e Click on the Define Template toolbar button Cr OR e Select Edit gt Templates gt Define Templates OR e Right click on the Templates in the Templates tab of the workspace window and select Edit from the pop up menu OR e Right click in the editor window and select Templates gt Define Templates from the pop up menu 2 Use the Template Name drop down list to select the name of the template you wish to remove and then click the Remove button 3 Clicking the OK button saves the changes and closes the dialog box To remove selected templates using the Templates tab of the Workspace window 1 Select the templates that you want to remove in the Templates tab of the Workspace window Multiple templates can be selected by holding down the SHIFT or CTRL key 2 Right click on the Templates within the Templates tab of the workspace window and select Remove from the pop up menu 4 11 3 Inserting a template To insert a template 1 Select one of the following operations to display the
321. editor Select the next word in the editor Display context sensitive help Previous bookmark Search for the previous occurrence of the specified text Run from reset Displays the editor that generated the previous build error or warning Show context menu Same as right click pop up menu Step out of the current function Refresh all windows Cut the selection in the editor alternative in the editor to CTRL X Hide the output window Move the tab back in the editor Selects from the cursor to the beginning of the current line in the editor Selects from the cursor to the end of the current line in the editor Select the next line up Select the next line down Redo the action alternative in the editor to CTRL Y Display context sensitive help Jump to the next bookmark Search for the next of the specified text Find text in multiple files Start or continue the program Build the project Display the editor that generated the next build error or warning Set or remove a breakpoint on the current line Step over the next statement Step into the next statement Refresh the contents of the window Clear Toggle insert and overwrite mode Carriage return in the editor Insert a tab in the editor Stop running the program Move the cursor to the beginning of the current line in the editor Move cursor to the end of the current line in the editor Move the page in the editor up Move the page in the editor
322. edterdzedsbeet 136 8 Custom Version Control Syste suise i0sssacvessasaaesasanedodecdusencesauaentsdauSeevcseandeecduvavessaueextetseSeenaseant 137 8 1 Defining Version Control menu options ccccccccccccccceeeeessssseeeecccceeeeeeeeeeeeeaaaaeseseeeeeeeeeeeeeeeeeeeasaaessausesseeeeeeeeeess 137 8 1 1 System defined MENU OPTtlONS sessirnir arao aa Na EE EENE EAA NEn NO EAREN 138 8 1 2 Uset defined mMenu opting pi casssscxesnncrencesnansanctadossauadongdsmunstenpsdeneneododnse ieaddeanactengiahocedvadetedsansaaadeiaansienesacess 139 8 2 Defining Version Control commands ccccccccccccccececeeeeaessssesseseeeecceeeeeeeeeeasasaeesseseeeeeeeeeeeeeseeeesessusaasssssseseeeeeess 140 8 3 Specifying are WTA ES sercas nna an EE E EEEE aE aE EE AEA EROE OE NEEE 141 s4 MECH 1S COMME IIS erse A ENE EaR E raa a NAA OE EEO ONEEN E E 141 8 5 Executable ruri COE ernn o E ORE E AE EEA AEREE EE A EE eA 141 8 6 SCCM 1S ME JOC AMONG serorei a RE E T EE ERE 142 8 7 Specifying Nle locations example seors td endeicetooanedtoutn ak daaeieddtianiaisetccanohaadwinbalsahOacteatiadanutainbcaubetteataddaamedadianieastccatahs 143 8 8 POS Ty ine envi onie escea a iaa a E E 144 8 9 Controlling execution of a Version Control System cccccsssseeeccccceececeeeaasasessseeeececceeeeeeeeeeeeessaaasasesseeeeeeeeess 144 8 10 Specifying a user name and password ssssssseseeeeeeesssssssssssssseetteerresssssssssssseeeterrrereresssssssssseeeeteeeerosssssssseeeeee
323. ee consecutive frames for example the operation will be as follows 1 On the first frame select an update interval from the Redraw Interval drop down list box and click on the Redraw Continuously toolbar button REJ10J2000 0100 Rev 1 00 Jun 16 2009 329 RENESAS High performance Embedded Workshop 17 Debugging Facility Image Redraw Continuously 3 When the specified time has elapsed the third frame is automatically displayed The automatic switching of frames has ended Image Nonveftesh KE fist gt e e fio e e m 17 4 6 Displaying the pixel information Double clicking within the window displays information on the pixel on which the mouse pointer is located in the Pixel Information dialog box Pixel Information REJ10J2000 0100 Rev 1 00 Jun 16 2009 330 RENESAS High performance Embedded Workshop 17 Debugging Facility This dialog box displays pixel information on the cursor location Color Mode Displays the format of the image Pixel Displays color information of the cursor location Displayed in decimal Position Displays the cursor location in X and Y coordinate Displayed in decimal X Displays the X coordinate of the cursor location Y Displays the Y coordinate of the cursor location Buffer Size Displays the buffer size Displayed in decimal Width Displays the buffer width Height Displays the buffer height Image Size Displays the width and height of the display Displayed in decimal Width Di
324. eeaaesseseeeeeeeeeeaaeeseeeeeeeeeeeeaaeesees 118 6 1 SOT meine COON AUS se E E E E E 118 62 C stomiznsihe Tools mMeMiesi eisean r T EES EEEE RIE 120 6 3 Usne euso p AC CONCH rrean EER EIE E E sate E EEE 121 6 4 Using the workspace and project log facilities 0sononnenneeessssssssssssssssesttteresssssssssssssseererrresssssssssssssssseseerereesssssse 122 6 5 Con eunn ihe help Syse Merer E S E E E T EEE 123 6O Keyboard shorncutcustomiza ON sisisi nar rE E AI EESE A EEEE EEEE OSIE 124 6 7 O a ro a lea lt 1 T eR E Neer tnt enter e Terr Te 125 6 7 1 Scope of a control in the Customize dialog DOX ccccccccccccececcecccceeaeeaesseesseeeeeceeeeeeeeeeasaaaassseseeeeeeeseeeeess 125 6 7 2 Scope of a control in the Options dialog DOX ce eeesessssseeeeceeceeeeeeeaaeeeeaaaeessesseeeeceeceeeeeeeeasaaaassgseeeseeeeeeess 126 6 8 SPECIE YING Workspace OP OMS secrecions reisan eirean EA ES OENES EEN EASE TOENN 126 6 8 1 Opening the last workspace at Start Up cssessssseeeeeceeeeeeeeecaaeeessessessseeeeeeeeeeeeeeeseaeeaeseesseeeeeeeeeeeeeeeeeeeaaaas 126 6 8 2 Restoring files on opening a workspace eesssssssssssssssseeetrerrressssssssssssseererrrresssssssssseseeterereesssesssssssseeees 126 6 8 3 Displaying workspace information on opening a WOLKSPACE cccccccccceccecceeaaeeeeeeeeeeeeeceeeeeeeeeeeaaaaeeeeees 127 6 8 4 Saving the workspace before executing any tools esssssssssssssseteerrsssssssssssssscererr
325. eeeee 145 8 11 Usage example of the Custom Version Control System ccccccccccccccccccceeesseeseseeseececeeeeeeeeeeseaaeaeassesseseeeeeeeeeess 146 8 11 1 Connecting the High performance Embedded Workshop with RCS cccccccssssssseeseseeeseeeeeeeeeeeeeeeaaas 146 8 11 2 Connecting the High performance Embedded Workshop with CVS ccccccccccccccceceeeeeeeeeesseeseeeeeeeeeess 151 9 Visual SourceSafe Version Control System cisssccsscasscanrecedaceaadancannssmeseneacecuons savanitacesatasuennensens 158 9 1 Attaching Visual SourceSafe to a workspace eeeessssssssssesseeereressssssssssssssettrrrrereresosssssssssseetrreeeesssssssssesseeeeeeee 158 9 2 Vis al SourceSafe COmMand 6 a2 s5os5ccacsansdanesessaaaasansdagasecessdetantannaiosseaaaiostdaaaiecmasaetonsaagaseseaaaatanedaasbaadessesaaeetagsuaaniaeds 160 9 2 1 Adding files to Visual SourceSafe ccccccsssessssseseeeeceeeceeeeeeeeeeeaaeeseeeseeeeeeeeeeeeeeeeeaaasaeeeseseeeeeeeeeeeeeeeeeeeeeaaaas 161 Pee Removing Tiles from Visual SourceSafe istic sccescssinsentaacadeveeadncdncend sddindeduncbacnealdeegendacdualdbedoasnsbutbacndeudeddansacintes 162 9 2 3 Getting read only copy of files from Visual SourceSafe ccc cceessessssseeecececeeeeeeeeaaaesesseeeeeeceeeeeeeeeeeeeaqaas 162 9 2 4 Checking out writable copy of files from Visual SourceSafe cccccccceccceceeceeeeeeaeeesesseeeeeeeeeeeeeeeeeeaaaas 163 92 5 Checking in writable copy of file
326. eeeeeeeeeeeeeeeseeeeeeeeeeees 231 WG Eo SU PORE a a R A AE E AE E E RO RE ZZ TOM CCRC ACII atest Ulle cerren ee E NE E E Ee REONE E EEr Ear EE 232 16 2 Opening and closing test SUITES 0 cccccccccssssseeeeseeeeeeeeeeeeeeeeeeeeeaaee ees eeeeeeeeeeeeeeeeeeeaaaseeeeesseeeeeeeeeeeeeeeeeeeeeaaagaaeaanses 233 163 Editing atest SUG essor a EE EEEE OSEE 233 16 4 Adding tests to the test suite cccccccccccccccccceceeeeeeeeeseeeeeeeeeeeeeeeeeasseeeeseeeeeeeeeeeeeeeeeeeeaeaseaeeeaseeeeeeeeeeeeeeeeeeaagaagaesses 235 16 3 Creating atestimage file eae cae cncou cats dcinaticinirssute ara bomen toiauab Taaa EAA EE EEE T Sn 236 16 6 Functions that can be saved as test image data into test image files nn snsnsesssssesseeeeeerresssssssssesssssseeereressssssss 237 16 6 1 Functions that can be saved into test image files common to all High performance Embedded Workshop products 238 16 6 2 Functions that can be saved into test image files dependent on the debugger cccccececcceeeeeeeeeeeeeeees 243 16 7 Comparing atestimage file seeriaid ikenien Ra R SEa KARAKE EAE EE bes seabed earaasienswesnedsareoinceieleadals 255 WG RU E a E E E E E E EE EE E E E 256 16 9 Urme the Te SD EO Wel sent sence ccevsi cane Dra ns TE OEE TE EAE EE EEE E EEA 257 16 10 Configuring the Test pane of the Workspace WINdOW ccccccccssssssssssseseeeccceecececeeasaeeessseeeeeeceeeeeeeeeseaeeeaeeesgsessees 258 16 11 Configuring the Test tab of the Output windo
327. eeeseeeeeeeeeeeeeeeeeaaaaeeeseeeeeeeeeeeeeeeeeesuaeaaagageeesses 336 17 6 3 Modifying the values of I O registers cccceeeesseeecccceeeeeeeeeaaeeeeeseseeeeeeeeeeeeeeeeeaaeaeeeseeeeeeeeeeeeeeeeeeeeeeaaaas 336 17 6 4 Refreshing the IO Window cccccccccccssssssseeeseeceeeeeeeeeeeeeaeeeeeeesseeeeeeeeeeeeeeeeaaaaeeeeaseeessseeeeeeeeeeaaaeqsagagseesses 337 17 6 5 Disabling refresh of the IO Window cccssssssesssseeeeececeeeeceeeeaaaessesseseeeeeeeeeeeeeeeeeeeeeaaauaeaeseeeeeeeeeeeeseeeeeaaaas 337 17 6 6 Selecunt eTO ren SENS O VEW eee ee eT eer ee E EEE E E TEE TE 337 WO7 Lonne am oop ene acs ee aa Sew E E 338 17 6 8 Printing the currently displayed contents cccccccecccceececcceeeaeeseseeeeeeeeceeeeeeeeeeeasaesseeeseeeeeeeeeeeeeeeeeeeeeaaaas 339 17 6 9 Saving the currently displayed Contents sycs cevs lt demntansceanadudvanasunbulennthandeetanadsnsendedimniivadtwiaNdnnhenetduabaduatwiesiniosantes 339 17010 Pigdine an VOTee S arser E A E TS 339 IOJ BOAO TAS TC TAS OU es e a EEE a EE 339 r COOR E oa E E E E E E A E E E E E ee 340 17 7 1 Opening the Register wWindowW ssssesessssssssssseseeterrrrssssssssssssssstreerresssssssssssseeeseeerrreessssssssssseereereeeesessss 340 17 7 2 Changing the register display radix ccceeesssssssccccccccceceeeaaeesssssseeeeeeeeeeeeeeeeeeeasaaeeseaseseeeeeeeeeeeeeeeaaaaaaaeesnes 341 17 7 3 Swit hne Ren Ser Bink eein aa ree o e EREE 341 17 7 4 Selin he LAY GUL rar E E
328. ees against any and all damages arising out of such applications You should use the products described herein within the range specified by Renesas especially with respect to the maximum rating operating supply voltage range movement power voltage range heat radiation characteristics installation and other product characteristics Renesas shall have no liability for malfunctions or damages arising out of the use of Renesas products beyond such specified ranges Although Renesas endeavors to improve the quality and reliability of its products IC products have specific characteristics such as the occurrence of failure at a certain rate and malfunctions under certain use conditions Please be sure to implement safety measures to guard against the possibility of physical injury and injury or damage caused by fire in the event of the failure of a Renesas 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 applicable measures Among others since the evaluation of microcomputer software alone is very difficult please evaluate the safety of the final products or system manufactured by you In case Renesas products listed in this document are detached from the products to which the Renesas products are attached or affixed the risk of accident such as swallowing by infants and small children is very high You should im
329. eesssssseeesececeeeeessaesaeeesssaesseeseeeceesessssaagesgssseeeeeeeeeees 87 4 3 SETA FACOG ETE A A TT naganacsedi santas autereac AE T TE A E E T ETET 87 4 3 1 Creanne anew TING cresson Eeo n aE Ua EEEE TOES SESA AA EEA 87 4 3 2 PA WN E D E E E E E E A T EE 87 4 3 3 Savine aTe e a S A N 88 4 3 4 A I ost essen eseen ae otter onsets E teens ner orem ge de ves E EE EE E 89 4 3 5 H sa E ce ese E E E A A E A E pease ats ees en ences tne cio E AEA 90 4 3 6 Pop up menu to close the window sssesssseeeeecceeeeeeeeeeaaaesseesseeeeeeeeeeeeeeeeeeeeeaaaeaeeeeeseeeeeeeeeeeeeeeeeaaaaaeeeesses 91 44 Searching and navigating through files cc eccescsssecccccccececeeeeaesssseseeeececeeeeeeeeeeessseesseseeeseseeeeeeeeesesaaaaasasseeeeseeeeess 91 4 4 1 PaA E A E A E E EE es 91 4 4 2 PUG Ge eh WET ple MeS sersa EEEa 92 4 4 3 MSP FAG HIN a EET ET E E EE A A T A TAE N E T IE T E EAT 94 4 4 4 Jopin to aspeciied HNE aesae Ee E NEEE E E EE 95 4 5 BOOKA S rennen EEEE es cae EEEE EE NAESSENS 95 REJ10J2000 0100 Rev 1 00 Jun 16 2009 i RENESAS High performance Embedded Workshop Contents dO ol oes iy Od ogee eee enn eee a Me een nn em te ee eT ee ere mer eee ee tre ee er er eee ere 96 Ad COMMoUPAe text Ay OU ocan a NENEN E NAE 96 4 7 1 UU E TEIA IA NE S A IA T I A TE I N E T A T T O E 96 4 7 2 CANIS aE E E E A E ae bacestoobaani E E ETE EE 97 4 7 3 PRUE TACHI EEE O 98 4 8 SPUIDE AW UNC OW ct sc oaredsnscanessageanen son a iar o a i E A EE canst tai
330. eholder button a and select the placeholder from the pop up menu To browse a file click the Browse button 6 Inthe Initial Directory field enter the name of the directory where you wish to execute the command batch file By this setting you can also use command batch files that have relative paths If you wish to insert a placeholder into the Initial Directory field click the placeholder button p and select the placeholder from the pop up menu To browse a directory click the Browse button 7 Selecting the Apply to all timings check box adds the batch file to every timing At target connection Before download of modules After download of modules and After reset Click OK to add the batch file 9 Once added it can moved into the correct place in the order by using the Up and Down buttons This is only valid if you are adding multiple command line batch files 10 Click OK REJ10J2000 0100 Rev 1 00 Jun 16 2009 275 RENESAS High performance Embedded Workshop 17 Debugging Facility Notes e If you use the FILE_LOAD or FILE_LOAD_ALL command to download a module the command batch file specified for Before download of modules or After download of modules is not executed e If you use the RESET command to reset the CPU the RESET command written in the command batch file specified for After reset is not executed 2 Not executing a batch file when a module containing only debug information is downloaded
331. el D Step over calls M Source level step il Steps Number of steps to be executed By default this value is 1 Delay Delay between steps when the program is automatically stepped No Refresh Prevents the update of the windows or 0 to 3 seconds can be selected in 0 5 second units By default this value is 2 5 seconds Step over calls Selecting this box steps over function calls By default this checkbox is not selected Source level step Selecting this box steps the program at the source level By default this checkbox is selected Click the OK button or press Enter to start stepping 17 14 Stopping your program This section describes how you can halt execution of your application s code This section describes how to do this directly by using the Halt toolbar button eS and by setting breakpoints at specific locations in your code 17 14 1 Stopping the program by the Halt toolbar button When your program is running the Halt toolbar button is enabled and when the program has stopped it is disabled gni REJ10J2000 0100 Rev 1 00 Jun 16 2009 350 RENESAS High performance Embedded Workshop 17 Debugging Facility To stop the program e Click on the Halt toolbar button OR e Choose Debug gt Halt Program When the program has been stopped a information including the cause of a stop 1s displayed in the Debug pane of the Output window 17 14 2 Standard breakpoints PC breakpoints When you ar
332. el REJ10J2000 0100 Rev 1 00 Jun 16 2009 173 RENESAS High performance Embedded Workshop 10 Sharing Projects by Network Facilities 10 2 Enabling network facilities to share projects To use network facilities to share projects 1 Select Setup gt Options The Options dialog box opens 2 Select the Network tab 3 Click the Enable network data access checkbox This should add an administrator to the system without a password The administrator is the only user that can add additional users to the system and change user access rights The administrator has the highest level of access 4 Before leaving the network dialog the administrator must set their password It is not possible to leave this dialog box until this is completed This is described in the following section Close the Options dialog box When the dialog box is closed you are asked if you want to save the workspace and then re open it This is because the workspace must be re opened in the shared access mode If the changes are not saved then they will be lost Click OK to share projects by network facilities 7 When you re open the workspace and log into the system a dialog is displayed showing your current access rights For example if you are the admin user the level will be administrator When this dialog is closed the High performance Embedded Workshop server window is opened and the network facilities to share projects are enabled Hetwrork N
333. elected line within a main function is reached See Step 1 9 Add the array which stores random data to the Watch window See Step 1 10 Note Support for this function depends on the debugger e Example of test procedures Invoke the test support facility and select the data in an array memory content at the address of an array as the target of the test Save test image information to the test image file that you wish to use for comparison and modify the program so that the number of times to store data into the array will be reduced Execute the test and see that the data stored in the array has changed Then modify the program again to restore the number of times to store data and execute the test Make sure that data in the array is the same that in the saved test image file Step 1 Recording a macro Step 2 Editing a macro viewing records Step 3 Playing a macro Step 4 Creating a test suite Step 5 Editing a test suite Step 6 Creating a test image file Step 7 Modifying the program before the test Step 8 Viewing the test result unmatched Step 9 Modifying the program back and executing the test again Step 10 Viewing the test result matched 1 14 2 Step 1 Recording a macro In this example use the macro recording support facility to record the following combination of operations as High performance Embedded Workshop command line commands Recorded High performance Embedded Workshop command lin
334. em phase is a ready made phase which is already defined within the toolchain you are using e g compiler assembler linker librarian etc or a utility phase e g file copy complexity analyzer etc The Add an existing system phase button is inactive if no more system phases are available Select the Create a new custom phase button to create your own build phase REJ10J2000 0100 Rev 1 00 Jun 16 2009 66 RENESAS High performance Embedded Workshop 3 Advanced Build Features Hew Build Phase Step 1 of 4 What type of phase would pou like to add Create anew custom phase f 2dd an existing system phase system Phase Cancel Step 2 The second step asks what type of phase you would like to create There are two choices multiple or single When a multiple phase is executed the command is applied to each file in the project of a certain file group For example if you set the input file group to be C source files then the command will be executed once for each C source file in the project A single phase is executed once at most during a build New Build Phase Step 2 of 4 ki x La What type of phase would you like to create f Multiple phase The command is applied to each file in a file group An example of this type of tool it a compiler or assembler Select input file group C source file C Single phase The command is only ever executed once per build An example of this type of tool is a
335. embly source file oe Intpre sre vee lowly larc vee vecttblerc oo he E vhandler sre AS C source tile oo he H dbscte 3 ee de mo c lowerc c l g 2 resetpre c oe sbrk c gt l Projects To display out of date files in the workspace window L 2 3 4 2 9 Select Setup gt Options The Options dialog box opens Select the Build tab Check the Mark out of date files check box Click OK oha l Command line hitial directory Environment File dependencies 2 Build Basics A typical project will contain dependencies between files For example a C file may include one or more header files In complex projects source files will include or depend upon others and this can quickly become difficult to manage However the High performance Embedded Workshop provides a dependency scanning mechanism whereby all files in a project are checked for dependencies Once complete the Projects tab of the Workspace window will display an up to date list with all the project file dependencies Initially the dependencies for all files are contained within the Dependencies folder although this can be modified by configuring the projects tab REJ10J2000 0100 Rev 1 00 Jun 16 2009 57 RENESAS High performance Embedded Workshop 2 Build Basics at Workspace oe Sie Assembly source file n E dbsctc Demo c s E intprg c lowere c resetpr
336. emory window ccccsssssssssssssesseeeecceceeeeceeeaaaaasssseseseeeeeeeeeeeees 312 17 3 3 Selecting a memory TANCE iocindccxsveseveswansdvovwsencerneenttencueuiaspuendednmne piven Ee nsr EEn asne et teenstonseienveesdeavereiiags 313 17 3 4 Filling an area of memory with constant data cc cccccccsssssssssseeeecceeeeeeeeeeaaeeeeeessseseeeeeeeeeeeeeeeeeeaaaaeeeesees 313 17 3 5 Copyine an area Ol TIC MOLY sossen iue Enn a a E Era EAE AEE Ta aiora 314 A30 Comparing Tie Ti MOL CON MG sorsra a iS EEE T E EEEE AEE 314 17 37 Tesine an area Of Memory ecopet rE 315 17 3 8 Savine Memory coments m a Le KE TNC seia a NEE epie danas aaueueebedian 315 17 3 9 PAGING avalue in MEMOTY sisirin R e aE EEE AE OS EEEE TIEN 316 P7380 AC Watieime the display Address ssi05 sontnsacsent stnseasataaren e N i E 316 IAL Chanting the serol Irede ra S E EOE EAEEREN RANEES ai 317 17 3 12 Starting address to value of the register ccccccccccccccccceeeseesseeeeeeeeeceeeeeeeeeeaauaeessseeeeeeeceeeeeeeeeaeeeeqagaaeeesses 317 17 3 13 Tracking the stack pointer position esessssssssseesseeeerersssssssssssssssrereresssssessssssssssseetrereressssssssssseerereeeessesssss 317 17 3 14 Changing the program display position immediately after downloading ccccccecceeeeeeeeeeeeeeeaeeeeeeeees 318 17 3 15 Refreshing the Memory WIndOw ccccsccseeececeeeeeeeeeeeaeeeseeeeeeeeeeeeeeeeeeeeaeaeeeeeseeeeeeeeeeeeeeeeeeeesaaaeaaaaaaea
337. emove 1 Overview 11 Click the OK button The Test_Demo test icon appears under the Test_Suite_Demo test suite icon z xl e Ea Test Dem mE TE Projects Ternplates ad Mawvigation 1 14 7 Step 6 Creating a test image file To compare the Memory content at the address of an array or the contents of the Watch window the range of data acquisition must be selected The test image of a test item is saved to the test image file Test_Suite_Demo_Test_Demo hif specified at step 5 L 2 Right click on the Test_Demo test icon to display a pop up menu Select Edit Test Image File to invoke the Edit Test Image File dialog box The title of the dialog box includes the test name Test_Demo and test image file name Test_Suite_Demo_Test_Demo hif REJ10J2000 0100 Rev 1 00 Jun 16 2009 30 RENESAS Select the checkboxes Memory xxxxxx under CPU in Available components and Watch xxxxxx under High performance Embedded Workshop 1 Overview Edit Test Image File Test_Demo Test_Suite_Demo_Test_Demo Ei EA Available components mm E Stack Trace SimSessionSH 4 oE Trace SimSessionSH 4 Cancel o et q 10 SimSessionSH 4 BE Memory SinsessionsH 4 Check All C Register SimSessionSH 4 SpF Simulated 0 SimSessianSH 4 3 CIs Status SimSessionSH 4 settings Oe Output s C Build Output window Import gw Debug Output Window SimsessionsH 4
338. en the memory is accessed If the memory needs to be accessed by a specific access size specify the access size by using this option The Download debug information only checkbox will download the debug information only without downloading the code The Perform memory verify during download checkbox can be used to do additional checks when downloading the module to ensure it was correctly downloaded to the target device The Download automatically on target connection checkbox can be used to automatically download the module when the target is being connected Click the OK button Select Debug gt Debug Settings The Debug Settings dialog box will be invoked The module is added to the bottom of the Download modules list on the Target tab If a module previously downloaded is modified outside the High performance Embedded Workshop a confirmation dialog box appears asking if you wish to download this module again To download the module again select Yes Otherwise select No or Cancel REJ10J2000 0100 Rev 1 00 Jun 16 2009 282 RENESAS High performance Embedded Workshop 17 Debugging Facility Confirmation Request Ei Download module c workepace sh sh debugsshd abs has changed Do vou want to reload it T Don t ask this question again Ho Cancel If you do not wish to open this confirmation dialog box select the Don t ask this question again checkbox To open the confirmation dialog box again 1 Sel
339. ent falaik Remove To define a new directory mapping 1 Select Tools gt Version Control gt Configure The Version Control Setup dialog box opens 2 Select the Projects tab 3 Click the Add button which is next to the Version Control Directory Mappings list The Version Control Directory Mapping dialog box opens 4 Specify a High performance Embedded Workshop workspace directory or project directory in the Source directory field Select one of the following operations e Enter the directory name OR e Click the placeholder button Then select Project directory or Workspace directory from the menu OR e Click the Browse button to open the Browse to Source Directory dialog box Select the directory and click the Select button Enter the version control directory into the Version Control Directory field 6 Click the OK button REJ10J2000 0100 Rev 1 00 Jun 16 2009 142 RENESAS High performance Embedded Workshop 8 Custom Version Control System To modify a directory mapping 1 Select Tools gt Version Control gt Configure The Version Control Setup dialog box opens Select the Projects tab 2 Select the mapping to be modified from the Version Control Directory Mappings list and then click the Modify button The Version Control Directory Mapping dialog box opens 3 Make the necessary changes to the two directories and then click the OK button to confirm the new settings Version Control Directory Mapp
340. ent of programs To ease the process of testing the High performance Embedded Workshop provides the macro recording support and test support facilities e Macro recording support facility The macro recording support facility allows you to record operations which are associated with the High performance Embedded Workshop system applications 1 build 2 and debugging 3 as High performance Embedded Workshop command line commands or to execute these recorded commands Files to record the operations High performance Embedded Workshop macro files are command line batch files that have hdc as the extension and can be modified These files are stored in the Macros folder within the High performance Embedded Workshop management information folder under the application data folder for each user profile By default the file Default hdc is created Note however that High performance Embedded Workshop is not capable of recording all operations in the High performance Embedded Workshop system corresponding to the High performance Embedded Workshop command line commands For the operations that can be recorded a macro record icon is shown in the Macro Recording column of the menu list This indicates that this operation can be recorded into a High performance Embedded Workshop macro file Notes 1 Changing a project session or configuration 2 Compilation and build 3 Downloading a module changing a memory value or reg
341. ep 5 Using the Version Control facility Compare To compare with the checked in file modify the file rcs_sample c and save it 2 Select the file rcs_sample c in the Projects tab of the workspace window and select Tools gt Version Control gt Diff The MS DOS command prompt window appears and shows the result of comparison 4 Enter exit and press the Enter key This closes the MS DOS command prompt window RCS file res_sample c v Working file res_sample c head 1 1 branch locks strict user 1 1 access list symbolic names keyword substitution kv total revisions 1 selected revisions 1 description revision 1 1 locked by user date 2006 03 14 07 22 42 author user state Exp Initial revision REJ10J2000 0100 Rev 1 00 Jun 16 2009 150 RENESAS High performance Embedded Workshop 8 Custom Version Control System 8 11 1 6 Step 6 Using the Version Control facility Check out Use the check out command to undo the changes made in the file 1 Select the file rcs_sample c in the Projects tab of the workspace window and select Tools gt Version Control gt Check out 2 The MS DOS command prompt window appears and shows the result of check out Enter exit and press the Enter key This closes the MS DOS command prompt window 4 A High performance Embedded Workshop confirmation dialog box appears Click Yes The file has returned to its original state 8 11 1 7 Step 7 Using the Version Control
342. epository Step 5 Using the Version Control facility Register a Module Step 6 Using the Version Control facility Check out Step 7 Using the Version Control facility Modify the File Step 8 Using the Version Control facility Check the Status REJ10J2000 0100 Rev 1 00 Jun 16 2009 151 RENESAS High performance Embedded Workshop 8 Custom Version Control System Step 9 Using the Version Control facility Compare Step 10 Using the Version Control facility Register the Result Step 11 Using the Version Control facility View Logs 8 11 2 1 Step 1 Create a workspace r oo a oA 10 Select the file you wish to control and click the Add button Select File gt New Workspace to open the New Project Workspace dialog box Create a workspace with the following conditions Workspace Name sampleCVS Project Name sampleCVS Directory C WorkSpace sampleCVS Exit the High performance Embedded Workshop Create a folder for CVS C src sampleCVS Move the file you wish to control from C WorkSpace sampleCVS sampleC VS to C src sampleCVS Start up the High performance Embedded Workshop and open the created workspace sampleCVS Select Project gt Remove Files to open the Remove Project Files dialog box Select the file you wish to control and click the Remove button Click OK button Select Project gt Add Files to open the Add files to project sampleCVS dialog box 8 11 2 2 Step 2 Selecting Custom Ver
343. er in use refer to the user s manual or help of the debugger REJ10J2000 0100 Rev 1 00 Jun 16 2009 262 RENESAS High performance Embedded Workshop 17 Debugging Facility Hew Propect 1 9 Select Target CPU_Toolchain version Toolchain version 9 2 00 Which CPU do you want to use for this project CPU Seres SH 750R SH 75I SH 751F SH7760 IF there is no CPU type to be selected select the CPU Type that a similar to hardware specification or select Other lt Back Next gt Finish Cancel 1 Select the CPU and Toolchain version in Step 1 The CPU types CPU Type are classified according to the CPU series CPU Series Select the CPU corresponding to the program to be developed because the generation file differs according to the CPU Series and CPU Type settings If there is no corresponding CPU select a CPU with similar hardware specifications or Other The following buttons at the bottom of the dialog box are the same as those in the New Project wizard dialog box Next gt Moves to the next display lt Back Returns to the previous display Finish Opens the Summary dialog box selections followed by this button are default Cancel Returns to the New Project Workspace dialog box To move to Step 2 click the Next gt button in Step 1 REJ10J2000 0100 Rev 1 00 Jun 16 2009 263 RENESAS High performance Embedded Workshop 17 Debugging Facility Hew Project 2 9 Option Settin
344. erON Reset PC l woid void Manual Reset PCl woid void mainl yvoid Wold mainl yvoid et ifdef cplusplus ifdef cplusplus 1 i endif endif Hifderf un liian ls H Hifderf un liian 1113 a d REJ10J2000 0100 Rev 1 00 Jun 16 2009 418 RENESAS High performance Embedded Workshop 11 Integrated Toolbars in a Components View The final menu option named Customize launches the Customize Toolbar dialog box This is shown below Customize Toolbar Available toolbar buttons Current toolbar buttons Separator Compare files ii nore white space j Cancel Add gt PA Find Ta a Find nest occurence of searc Reset 4 Henare A Find previous occurence of se t Find previous difference Mave lip Find nest difference Move Down Lebe This dialog box allows you to modify the displayed buttons and change the ordering The list on the left named Available toolbar buttons displays all toolbar buttons not currently in use on the toolbar The list named Current toolbar buttons displays all of the toolbars currently added to the components toolbar To add the currently selected buttons to a toolbar 1 Select the toolbar button you wish to add from the Available toolbar buttons list 2 Press the Add button 3 Click OK To move the currently selected buttons 1 Select the toolbar you wish to move in the Current toolbar buttons list 2 Click Move Up or Move Down until it is in the desired position 3
345. ere E Changes the value of the PC to the address indicated by the text cursor not the mouse cursor Edit Modifies the instruction at that address Find in Range Searches the range for the specified text string Copy Places a copy of the highlighted text into the Windows clipboard Define Column Format Sets the status of editor and disassembly columns Turn Header On Off Shows or hides the column header Save Disassembly Text Saves the specific range Print Prints the specific range Toggle Breakpoint C Sets or clears a software breakpoint at the line showing the address Enable Disable Breakpoint i Enables or disables the current software breakpoint REJ10J2000 0100 Rev 1 00 Jun 16 2009 299 RENESAS High performance Embedded Workshop 17 Debugging Facility 17 2 1 3 Refreshing the disassembly view Even if some external operation changes the memory contents shown in the Disassembly view the High performance Embedded Workshop cannot detect the change For example if you use the external flash utility to program the range of memory being displayed the Disassembly view will not be reflected Right click on the Disassembly filed in disassembly mode and select Refresh This acquires the latest information of the data being displayed and updates the contents of the view 17 2 1 4 Disassembly lock refresh It is possible to lock a memory range in the disassembly view so that it does not refresh This function is cal
346. ersssssosssssssssseetrereessssss 127 6 8 5 Prompting before saving a workspace eseeeeessssessssssssssettrrrerssssssssssssseeteeresssssssssssseesseeeeterreresssssssseseee 127 6 8 6 Promping Dororekavine a SESSO e r E E E E 128 6 8 7 Enabling auto backup facilities sasnssancsnceesenadainewe duanadanvadumvanasnnedeaniaba doen nuda siaatndanomuseiesenedaneonuanadeneaasduenasinnideanees 128 6 8 8 Setting the projects to load ON workspace open sssssseeeecccececceceecesssssseeseeeeececeeeeeeeeeeesesaaasasssneeeceseeeess 129 6 8 9 Specifying a default directory for new workspaces ccccccccccecccccceceeessesesseeeeeceeeeeeeeeeaseeeaaaaassssneeeeeeeeeess 129 T O ari ON O amen te ere ee eee ee ret rer eer er ee eee E eer ene er err 130 REJ10J2000 0100 Rev 1 00 Jun 16 2009 i RENESAS High performance Embedded Workshop Contents GAO Customizine ihe tont n yO EV Wy Socata pee raat TNE tent odes tas nese EEEE dens E 132 611 Using the virwmal desktop si ciercidnedacesnstvedsaensdecwaneianccdaahedesaveduedebveodenenedeecubbosueuduedubvosiecsaneddlocdaabeestadeuvedeargodiavaweoseaies 133 7 e OLE a PEE E E EE E A EE E E T E E 134 7 1 Selecting a Version Control System cccccccccccccssssssssesseeeeeeeeeeeeeeeeeeeaeseeeseseseeeeeeeeeeeeeeeeeaaaaseesseseeeeeeeeeeeeeeeeeeaaas 135 7 2 Importing and exporting a Set Up rxccuseersacvnnerancieeawdosrouatsedeneesiianctaincdaeasinetnes deudansnssacnnedtuncdneevboudeueduedvasasbactz
347. es 1 Select one of the following operations to display the Global Editor Column States dialog box Select Edit gt Define Column Format OR Right click in the editor window and select Define Column Format from the pop up menu Global Editor Column State Ei E4 Line Number SAW Break ports Mw SY Breakpoints 45M Cancel Source Address 2 If the column s checkbox is checked then the column is enabled if the column s checkbox is gray then this means that the column is enabled in some files and disabled in others 3 Click the OK button for the new column settings to take effect To switch off a column in one source file 1 Open the editor window of the file which you wish to remove a column from 2 Select one of the following operations e Right clicking the column header displays a pop up menu A tick mark right next to an entry indicates that this column is displayed Clicking an entry will switch showing hiding the column OR e Right click in the editor window and select Columns The cascaded menu option appears Each column is displayed in this pop up menu If the column is enabled it will have a tick next to its name Clicking on the entry will toggle whether the column is displayed or not You can adjust the column width by dragging the mouse on a column header 4 16 Showing hiding the column header The editor window has a column header You can select to show or hide the column header To switch showing hidi
348. esaes 318 17 3 16 Disabling refresh of the Memory window ccccccccccccccceeeesseesseeeeeeeeeeeeeeeeeaasaaeeeseeeeeeeeeeeeeeeeeesaaaaeeeseesesses 318 17 3 17 Regularly refreshing the Memory window cccccccccccccccceeeeeeeesseseeeeeceeeeeeeeeaaaaasesseeeeeeeeeeeeeeeeeeaaaaaaeassessses 318 73 13 Specifying NS TEMCSH Interval os5 2 c0hccscnc2stonednagemacssnannedennedsostoaoeeavaeueanesiane a aoia aae iaai 319 REJ10J2000 0100 Rev 1 00 Jun 16 2009 VI RENESAS High performance Embedded Workshop Contents 17 3 19 Changing the data length cccssssssseseeeeeeeeeeeeeeeeeeeeaeseeeeesseeeeeeeeeeeeeeeeeaaeaeeeesseeeeeeeeeeeeeeeeeseaaaaaaaeeenses 319 F320 C hank ima TS TA cs asa ccaccuvetssoaeiaeleseaaie ne E EDEA AEO AEO EEE EEEE Ee 319 32l Chanoine the Code sses e a e aaa 320 A22 DEMIS THC layou e A E A 320 17 3 23 Changing the number of digits displayed ccccccccccccccccccsessseeeeeeeeeeceeeeeeeeeeaaaaesssceeeeeeeeeeeeeeeeseaaaaaagaaeensees 320 17 3 24 Switching display or non display of measurement resull cceccccccccccceceeceeseeessseseeeeeeeeeeeeeeeeeeeaaaaeeeesses 321 P7329 Savine an area Ol Memoli y cisien onai aii a a aa a aipate naiai aniis 321 173 20 Loadins memory aea Momi a BI aero access ESTEE E ETEA EEEE EEEE 322 17 3 27 Spltt ng up The window display sccicassccscs crsacagasccaszgadncananennccaaas dogsoadaonbansaamnneszaanessicnoscdganseagnaeanaasagaoatacasagnannes 322 ETOCS venne ANON ANC reeni ERE
349. esas Electronics does not warrant that such information is error free Renesas Electronics assumes no liability whatsoever for any damages incurred by you resulting from errors in or omissions from the information included herein Renesas Electronics products are classified according to the following three quality grades Standard High Quality and Specific The recommended applications for each Renesas Electronics product depends on the product s quality grade as indicated below 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 categorized as Specific without the prior written consent of Renesas Electronics Further you may not use any Renesas Electronics product for any application for which it is not intended without the prior written consent of Renesas Electronics 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 an application categorized as Specific or for which the product is not intended where you have failed to obtain the prior written consent of Renesas Electronics The quality grade of each Renesas Electronics product is Standard unless otherwise expressly specified in a Renesas Electronics data sheets or data books etc Standard Computers office equ
350. ested in changing the font for If it is the editor expand the Source in the tree on the left hand side of the dialog box 3 Select the file type for which you want to edit syntax coloring from the File group list and then expand and select it 4 Select the category are interested in The tabs on the right side of the dialog box change depending on the selection Select the Color tab 6 Modify the Foreground and Background color lists as desired The System color refers to the current window foreground and background settings in Control Panel 7 Click the OK button for the new color settings to take effect El EE Source a Color Font Keywords Comments D Selected Text ree k Test Foreground oP PC Line Highlight i H E CPU information file E Absolute file Stack information file Background Profile file SYSTEM C list file Linkage map file C source file C header file File type C source file PY Comments keyword woup e k Control Operator PreProcessor oY 4 10 2 Creating new keywords HEW Sample Text To create new keyword groups 1 Select Setup gt Format Views The Format Views dialog box opens Expand the Source view icon in the tree 2 Select the file type for which you want to create a new keyword group from the tree on this dialog box Click the Add button underneath the tree The Add Category dialog box then opens Enter the name of the group i
351. etwork database access User Login Password Secese Wohl Select server Bassma 10 3 Setting the administrator user s password To set the administrator users password 1 Continue from the previous sections step 4 2 Click the Password button This should have been enabled when the network data access was enabled 3 The Change password dialog box opens Change password EE Admin Fassword Cancel Confirm Password 4 The user name is read only in the top field In this case it should be Admin REJ10J2000 0100 Rev 1 00 Jun 16 2009 174 RENESAS High performance Embedded Workshop 10 Sharing Projects by Network Facilities 5 Type the new password into both of the fields and click OK 6 This should set the user and password on the Network tab of Options dialog box 10 4 Adding new users to the system The initial setting of the network database adds an administrator user and a guest user to the system The following levels of access are possible in the High performance Embedded Workshop system Administrator Full access to every aspect of High performance Embedded Workshop The user can add and remove users from the projects and change access rights The administration user can change the workspace and project files and also the source files Full read write access The workspace and project files can be modified as can the source files But it is not possible to change user a
352. evbscasecdeooreasdancasecdeesreuuiess 211 14 18 Setting a breakpoint in a batch file eececssssseeeeeceeeeeeeeeeeeeaaaeeesseseeeeeeeeeeeeeeeeseseeeesesseeeeeeeeeeeeeeeeeeeeaaagageaesses 212 l gt Macro Recording Support Facili scasnncou ssn daseamnvessssandaenamaonsunsosseneamnweessiaoadameamnecesuasentaceamninds 213 lat Ma o an O O asie N E AE E EIEEE A E OENE ONE EIE ONE T OAE AO 213 15 2 Using the Macro dialog bOX eeeeeesessssssesesseseereresssssssssssssserrerrrssssssssssssseerrrerresssssssssssseererrreossssssssssssssseeerereeessssss 214 15 3 Importing a macro file with existing Macros ccccccccccceccccceceaeeesssssseeseeeeeeceeeeeeeeeeeaasseseseeeeeeeeeeeeeeeeeeeseaauaaagaseses 216 DA Ro oda E aa O E nsdaputesnnamncesaeusaceeessuaconte 216 15 5 Functions that can be recorded into macro files ec cccccceeccececeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeees 217 15 5 1 Recordable functions common to all High performance Embedded Workshop products 217 REJ10J2000 0100 Rev 1 00 Jun 16 2009 v RENESAS High performance Embedded Workshop Contents 15 5 2 Recordable functions dependent on the debugger ce seeeessssseeeccceeeeecceeaaeeseesseeeeeeceeeeeeeeeaaeaaeeeseeeeeees 221 Do PE MAC n a aces as pucantasancereesyacessacsada E E 229 L T a O a E E E 229 De A M8 TNA T E E E 230 15 9 Configuring the Macro tab of the Output Window cccecccccccccccecccceceeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee
353. exists This file is a formatted text file that describes the I O modules and the address and size of their registers You can edit this file with a text editor to add support for memory mapped registers or peripherals you may have specific to your application e g registers in an ASIC device mapped into the microcomputer s address space File format Each module name must be defined in the Modules definition section and the numbering of each module must be sequential Each module corresponds to a register definition section and within the section each entry defines an I O register The BaseAddress definition is for devices where the location of I O registers moves in the address space depending on the CPU mode In this case the BaseAddress value is the base address of the I O registers in one specific mode and the addresses used in the register definitions are the address locations of the registers in the same mode When the I O register file is actually used the BaseAddress value is subtracted from the defined register address and the resultant offset added to the relevant base address for the selected mode Each module has a section that defines the registers forming it along with an optional dependency the dependency is checked to see if the module is enabled or not Each register name must be defined in the section and the numbering of each register must be sequential The dependency is entered in the section as dep lt reg gt lt bit gt lt
354. f Component Result Details Ea CPU Memorn SimSessionSH 4 FAIL Failed in memor range Oe FO000000 0s 70000027 i Symbol Watch SimSessionSH 4 FAIL Symbol data i not matching pe CPU I0 5imSession5H 4 SUCCESS i The top pane of the test browser lists all of the tests that were executed during the last test run A green icon to the left of the test name indicates the test was successful A red icon indicates the test failed Selecting a test in the top pane shows the test details in the pane below The bottom pane of the test browser lists all of the components that were checked A green icon to the left of the component name indicates the test was successful A red icon indicates the test failed If a test fails the details are shown in this window REJ10J2000 0100 Rev 1 00 Jun 16 2009 257 RENESAS High performance Embedded Workshop 16 Test Support Facility Double clicking on the component displays more information on why the test data comparison failed This can also be viewed by selecting the test and then clicking the details button on the toolbar The results of the tests can be exported to file The two options are Export and Export All Export only saves the results of the currently selected test Export All saves the results of all the tests executed The results can be saved as text or as a comma delimited file for importing into other tools for analysis You can also display Test Browser from the workspace window pop
355. f input output files to calculate wnat commands need to be executed as normal and then display the commands but do not execute them Displays help info 13 2 File syntax There are four basic types of statement used in a hmake file the variable declaration the description block the comment and the message command These can be combined in any order to produce a hmake file but a variable must be declared in a variable declaration before it is used in a description block or other variable declaration The first all statement used in nmake files is not required in a hmake file Commands are executed in order as they appear in the make file Note the character is used to show were a tab character must be used in order to keep the make file syntactically correct Variable declarations A variable declaration declares a variable which can then be used in any statement throughout the rest of the hmake file A declaration has the following syntax lt variable name gt lt value gt Any number of white space characters are allowed between the variable name and the sign and the value and the sign The value may be split over several lines using a V character If the value contains V characters within the main text then these are taken literally Only V characters followed by a new line are considered to indicate a value wrapping over more than one line REJ10J2000 0100 Rev 1 00 Jun 16 2009 421 RENE
356. f tests Running batch lt Macro Name gt Macro_01 file macro Macro_02 X of Y 1 of 2 X is the current test number and 2 of 2 Y is the total number of tests REJ10J2000 0100 Rev 1 00 Jun 16 2009 259 RENESAS High performance Embedded Workshop 16 Test Support Facility 4 o ot al at 21 2t 7 G a Starting tests test suite TestSuite comparing a Running test Test U1l 1 of Running batch file macro Macro Ul l of 2 Bateh file macro finished successfully Running batch file macro Macro Ue 4 of 2 Batch file macro finished successfully Running test Test Us 4 of d Running batch file macro Macro Ul 1 of 2 Batch file macro finished successfully Running batch file macro Macro Us 2 of 4 Batch file macro finished successfully All tests completed Test Right clicking displays a pop up menu containing available options A basic operation is allocated to the toolbar The Toolbar display and Customize toolbar options are also included in the pop up menu opened by right clicking on the toolbar Pop up Menu Option Toolbar Button Function Clear Window a Clears the contents of the window Save Saves the contents of the window into a text file Copy Copies the selected contents onto the Windows clipboard Toolbar display Shows or hides the toolbar Customize toolbar Customizes toolbar buttons REJ10J2000 0100 Rev 1 00 Jun 16 2009 260 RENESAS
357. f the Build tab of the Output windoW ccccccccccccccceeeseeeeeeeeseeeeeeeeeeeeeeeeeeeenaaas 56 2 8 8 Displaying out of date files in the Workspace WINdOW ssssssseeeeececeeeecceeeaaeeesssseseeeeeceeeeeeeeeeeeeaaaaaaases 56 P BANC AS NS S T deuce se dalvenmacnttienmennete sbiosa de nn E A E E 57 2 10 Configuring the Workspace WINdOW ccccccccssssssssessssssseeeeeccccceeeeeeaaaaessssseeeeeeeeeeceeeesesaaaaeesssseeeeeseeeeeeeesessaaaggsssases 60 2 11 Inserting a project into the workspace 00 cccccssssseeeeeeeeeeeeeeeeeeeeeeeeaeeeeseeseeeeeeeeeeeeeeeeeeeeeaaaaseeeeeeeeeeeeeeeeeeaeaaaaaeasesaes 61 212 Sete the current PEO CC Fivetca neon ccusaseesacnsinacaweremadonmadaidaersidonnsdiaeedaaeddwne aa Eaa E a EEEa SDAA TENER 62 2 13 Specifying dependencies between projects ccccsssseccceeececeeeeeeeeeeaaesssseseeeeeeeeeeeeeeeeesaasaeeeesseeeeeeeeeeeeeeeeeeasaaeeesnsses 63 2 14 Removing a project from the workspace ccceseesseseeeccceeeeeeeeeeeeeeaaeeeseseeeeeeeeeeeeeeeeeeaaaaaeeesssseeeeeeeeeeeeeeeeaaaaaeaansses 64 2 15 Relative projects paths in the workspace ccssessseseeseeeeeeeeeeeeeeeeeeeaeeeseseeeeeeeeeeeeeeeeeeeeaaseeesseeeeeseeeeeeeeeeeeaaaaaaaesaases 64 3 Advanced Build PCAtires lt cccccxccsccsdaSacssesncesastdadaeanesncasimedaieeswesncccdsebacdesnesnanaeentndesswaanacctabinsaeacieaadee 65 3 1 Fhe INGE process Bey 151 UC Gg areetrse secescenarmc cent ae mena E Sete IS dance mia EEE 6
358. f the unmatched sheet Line Unmatched line number Src Content of the test image file Dest Data in the current High performance Embedded Workshop system or in another test image file to be compared with Example Status differs Sheet Platform Line 6 Src Execute From Pipeline Reset Dest Execute From EX Stage To make detailed setting If you double click on a test item in the Create New Test Image dialog box a further dialog box for detailed setting opens REJ10J2000 0100 Rev 1 00 Jun 16 2009 240 RENESAS High performance Embedded Workshop 16 Test Support Facility Edit Test Status Ei ES Cancel 1 To specify the sheet to be compared in the test image file select the Memory Platform or Events checkbox These checkboxes are not selected by default 2 Click OK 16 6 1 5 CPU Memory Memory window The following table shows information on the test image data to be saved into test image files and test results not matched Test group name CPU Test item name Memory Test image data to be Values set as detailed information and the range of data in the Memory window acquired with this setting saved into test image files No memory range is specified by default Test result details Failed at address Unmatched address Src Content of the test image file Dest Data in the current High performance Embedded Workshop system or in another test image file to be compared with Example Failed at address 0x70000014 Src
359. figure The Version Control Setup dialog box opens Select the menu option to be modified from the User menu options list and then click the Modify button The Define Commands dialog box opens Select the menu option to be modified from the Commands list and then click the Modify button The Modify Commands dialog box opens For details see section 8 2 Defining Version Control commands Click the OK button to close the Modify Commands dialog box Click the OK button to close the Define Commands dialog box Click the OK button to close the Version Control Setup dialog box To remove a user defined version control menu option L 2 5 Select Tools gt Version Control gt Configure The Version Control Setup dialog box opens Select the menu option to be removed from the User menu options list and click the Remove button Close the Version Control Setup dialog box by clicking the OK button REJ10J2000 0100 Rev 1 00 Jun 16 2009 139 RENESAS High performance Embedded Workshop 8 Custom Version Control System To change the ordering of user defined version control menu options 1 Select Tools gt Version Control gt Configure The Version Control Setup dialog box opens 2 Select the menu option to be moved and then click the Move up and Move down buttons as necessary 3 Close the Version Control Setup dialog box by clicking the OK button 8 2 Defining Version Control commands Version control commands are listed
360. file FILE UNLOAD FU Unloads an object program file from memory FILE _UNLOAD_ALL UA Unloads all object program files from memory FILE VERIFY 2 FV Verifies file contents against memory FREE GO 2 FG Runs program ignoring any breakpoints GENERATE_MAKE_FILE 1 GM Generates a build makefile for the current workspace GO GO Runs program GO_RESET GR Runs program from reset GO_TILL GT Runs program until specified addresses HALT HA Halts program HELP HE Displays help for Command Line or help on a command INITIALIZE IN Initializes the debugger LOG LO Controls command output logging MEMORY_COMPARE 2 MC Compares memory contents MEMORY_DISPLAY MD Displays memory contents MEMORY_EDIT ME Modifies memory contents MEMORY_FILL MF Fills a block of memory MEMORY_FIND 2 MI Finds a string in an area of memory MEMORY_MOVE MV Moves a block of memory MEMORY_TEST 2 MT Tests a block of memory OPEN TEST SUITE OTS Opens a test suite OPEN_WORKSPACE OW Opens the specified workspace file QUIT QU Exits High performance Embedded Workshop RADIX RA Sets the radix for the value REFRESH_SESSION RSE Reloads the session file REMOVE_FILE REM Removes a file from the current project RESET RE Resets the microprocessor RUN_TEST RT Runs a test SAVE_SESSION SE Saves the current session SAVE_WORKSPACE SW Saves the current workspace SET_DISASSEMBLY_SOFT_BREAK SDB Sets or deletes a software breakpoint at the disassembly level REJ
361. firm password by retyping it below field 1 o Click the OK button to set the new username and password If there is any inconsistency between the two versions of the password that you entered you will be requested to type your password again REJ10J2000 0100 Rev 1 00 Jun 16 2009 145 RENESAS High performance Embedded Workshop 8 Custom Version Control System 8 11 Usage example of the Custom Version Control System The custom version control system includes any version control system in which command line commands should be executed via the MS DOS command prompt The usage examples in this section use the following version control systems to be connected with the High performance Embedded Workshop e Connecting the High performance Embedded Workshop with RCS e Connecting the High performance Embedded Workshop with CVS 8 11 1 Connecting the High performance Embedded Workshop with RCS In this example the High performance Embedded Workshop is to be connected with RCS e RCS environment The following types of version control system can be used o GNURCS o GNU diff This procedure assumes that the version control system is located at C RCS e Workspace Create a High performance Embedded Workshop workspace in the following folder C WorkSpace rcs_sample Then create a folder for RCS C WorkSpace rcs_sample rcs_sample RCS The following pages describe the procedures to create a workspace make settings for version control check in c
362. for version control is now completed 8 11 2 4 L 2 Step 4 Using the Version Control facility Create a Repository Select Tools gt Version Control gt Initialize Select the file in the Initialize dialog box and click the OK button Executing C cvs 1 11 17 cvs exe init Command s completed successfully 8 11 2 5 Step 5 Using the Version Control facility Register a Module Select Tools gt Version Control gt Register Select the file in the Register dialog box and click the OK button Executing C cvs 1 11 17 cvs exe import m New Source sampleCVS Renesas rel 20060228 N sampleCVS dbsct c Omit No conflicts created by this import Command s completed successfully 8 11 2 6 Step 6 Using the Version Control facility Check out 1 Zz 3 Select Tools gt Version Control gt Checkout Select the file in the Checkout dialog box and click the OK button The Version Control tab of the output window shows the following message REJ10J2000 0100 Rev 1 00 Jun 16 2009 154 RENESAS High performance Embedded Workshop 8 Custom Version Control System Executing C cvs 1 11 17 cvs exe checkout sampleCVS U sampleCVS dbsct c Omit cvs exe checkout Updating sampleCVS Command s completed successfully 8 11 2 7 Step 7 Using the Version Control facility Modify the File Use the High performance Embedded Workshop editor to modify the file and save it In this example the file sampleC
363. formance Embedded Workshop macro file Default in which a macro has been recorded is listed in Current macro file 2 Select the macro Demo in Macro functions and click the Edit button The editor window shows the High performance Embedded Workshop macro file Default hdc in which a macro has been recorded Within a High performance Embedded Workshop macro file the High performance Embedded Workshop command line commands of the operations listed below are included between the lines showing information to identify macros When a macro includes operations such as running a program the Debug tab of the Output window shows information including the cause of a stop This may cause difference in comparison of test results To clear the contents of the tabs in the Output window the High performance Embedded Workshop command line command clear_output_window is available It is possible to add the line at the next line of Macro Demo Start to clear the information in the Debug tab of the Output window clear_output_window debug a C Documents and Settings 4Macros Default hdc BaS 1 2 Macro Demo Start 3 refresh session 4 Clear output window debug 5 register set RO 0x0 6 register set Rl Oxo r register set Re Oxo g register set E3 Oxo 5 register set E4 Oxo 10 register set R5 0x0 LI register set Ro Ox le register set RY Oxo 13 register set Roa Oxo 14 register set RY OXU l5 register set RK1
364. function by double clicking in the BP breakpoint column Alternatively right click to show the pop up menu and select Break REJ10J2000 0100 Rev 1 00 Jun 16 2009 357 RENESAS High performance Embedded Workshop 17 Debugging Facility Options Right clicking displays a pop up menu containing available options A basic operation is allocated to the toolbar The Toolbar display and Customize toolbar options are also included in the pop up menu opened by right clicking on the toolbar Pop up Menu Option Toolbar Button Macro Recording Function Add pan i Adds a label Edit Ei Edits a label Delete C Deletes a label Delete All E Deletes all labels Load pe a Loads labels from a file Save El Saves labels into a file Save As ja Saves labels into a file Find ih Finds a label Fine Next di Finds the next label to match View Source Views the source corresponding to a label Print es Prints the currently displayed contents Toolbar display Shows or hides the toolbar Customize toolbar Customizes toolbar buttons 17 18 1 2 Adding a label Choose Add from the pop up menu and open the Add Label dialog box to add a label Add Label Ei EJ Address 00000000 kal Cancel Enter the new label name into the Name field and the corresponding value into the Address field and press OK The Add Label dialog box closes and the label list is updated to show the new label When an overloaded function or a class name is en
365. g Specify global options Division EPN Endian FPL Mis Round to Zero Denorrmalized number allower as a result Position independent code PIC Treat double as float Bit field s members are allocated trom the low Pack struct union and class JUse try throw and catch of C Enabledisable runtime information lt Back Next gt Finish Cancel 2 Specify the options common to all project files in Step 2 The specifiable items depend on the CPU selected in Step 1 To move to Step 3 click the Next gt button in Step 2 Hew Propect 3 9 Setting the Contents of Files to be Generated What kind of initialization routine would you like to create Humoer ot vil Stearns U M Use Heap Memory Heap Size H an Generate maini Function zd E source file M 1 0 Register Definition Files Generate Hardware Setup Functor None lt Back Next gt Finish Cancel REJ10J2000 0100 Rev 1 00 Jun 16 2009 264 RENESAS High performance Embedded Workshop 17 Debugging Facility 3 Specify the generation file in Step 3 Use I O Library Checking enables use of standard I O libraries Number of I O Streams Specifies the number of I O streams that can be used simultaneously Use Heap Memory Checking enables use of the heap area management function sbrk Heap Size Specifies the unit of the size of the heap area to be managed Generate main Fun
366. g box Select the font type from the Font list Select the font size from the Point Size list When this is being modified the sample text below shows what the font will look like Click the OK button NS SS Fort Font Cour ier Mew Point Size 10 HEW Sample Text 4 10 Syntax coloring To enhance code readability the High performance Embedded Workshop editor can display specific strings 1 e keywords in different colors For instance C source code comments could be shown in green and C types e g int could be shown in blue The coloring method used can be specified on a file group by file group basis For example you can define different color schemes for C source file C header file Assembly source file or Assembly include file Note When you create a new file syntax coloring will not be active as a new file does not initially have an extension new files are named arbitrarily by the editor without an extension In order to activate syntax coloring you must save the new file with a name and extension that the High performance Embedded Workshop recognizes See section 2 5 File extensions and file groups for information on file extensions REJ10J2000 0100 Rev 1 00 Jun 16 2009 99 RENESAS High performance Embedded Workshop 4 Editor 4 10 1 Changing text colors To change existing colors 1 Select Setup gt Format Views The Format Views dialog box opens 2 Select the view you are inter
367. g c w E sbrk c o vecttblc Ey Dependencies lowerc h E sbrk h z B stackect h 2 B vect h Note Some include files may include other files Up to 31 nesting levels of dependent files are displayed in the Dependencies folder File dependencies in a project are automatically updated at the following operation timings Operation Timing Specific Operation Open workspace Select option in the Welcome dialog box Select File gt New Workspace Select File gt Open Workspace Add a project to workspace Select Project gt Insert Project Set the current project Select Project gt Set Current Project Add files to a project Select File gt Add Files Save files Select File gt Save Build Select Build gt Build Automatic dependency scanning Deselect the Disable automatic dependency scanning checkbox To prevent automatic scanning of file dependencies in a project 1 Select Setup gt Options The Options dialog box opens 2 Select the Build tab 3 Select the Disable automatic dependency scanning checkbox This checkbox is not selected by default 4 Click OK Note Selecting this option clears all file dependencies in a project To manually update file dependencies in a project see To manually update file dependencies in a project REJ10J2000 0100 Rev 1 00 Jun 16 2009 58 RENESAS High performance Embedded Workshop 2 Build Basics at Workspace oe Sa Assembly source fil
368. get of the test is a selected range of memory data in arrays Then modify the program to reduce the number of times to store data into the array so that the saved test image information and the actual memory data will not match aE 21 22 a a 25 426 ae 4 ao 30 a1 da 3a 3g ao 36 a Fi 35 39 4 SO DemoSHh4c OOO002000 OOOO02Z006 OOU00zZ01a OO00e0ee OOO00eOs2 OOO02Z03 6 OOOO02Z036 OOO0z044 long a 1i0 REJ10J2000 0100 Rev 1 00 Jun 16 2009 32 oid mainiwoid long min max long j IE Ue printf i Data Input n fori i 0 E eae j rand itn O woa ati J printt alsd sldin i afli i r e RENESAS High performance Embedded Workshop 1 Overview 1 Open a source file including a main function in the editor window and modify the program to reduce the number of times to store data into the array 2 Click the Save File button l on the Editor toolbar Right click on the Test_Demo test icon to display a pop up menu 4 Select Run Test Case to start the test The progress and result of the test are shown in the Test tab of the Output window 4 al Ol Of al at 2 21 7 Ea ed Starting tests test suite Test suite Demo co Running test Test Demo 1 af 1 Running batch file macro Demo 1 of 1 Batch file macro finished successfully All tests completed Test 5 When the test is completed the Test Browser windo
369. gs expanded on the All Register and Selected Register tabbed panes of the IO window 17 6 6 Selecting the I O register s to view You can select the I O register s to be shown on the Select Register tabbed pane of the IO window To select the I O register s to view 1 Right click within the window to open a pop up menu 2 Select Select I O Register The Select IO Register dialog box opens The figure given below is an example of the Select I O Register dialog box for the SH 4 simulator debugger Select 1O Register Ei ES Available Registers Io ra Cancel Check all Uncheck all Interrupt Control Cache Control Direct Memon Access Controller Bus State Controller Timer Unit 3 Each of the items in the Available Registers list has a checkbox that is unselected by default Clicking on expands the collapsed item while clicking on collapses the expanded item If you select the checkbox for an item with or the checkboxes for all of its elements are also selected Similarly if you deselect the checkbox for an item all of its elements are also deselected You should select the checkboxes for the I O register s you wish to view 4 Clicking OK closes the Select IO Register dialog box The selected I O registers are shown on the Select IO Register tabbed pane of the IO window REJ10J2000 0100 Rev 1 00 Jun 16 2009 337 RENESAS High performance Embedded Workshop 17 D
370. gt Paste Select Paste from the pop up menu Clear Removes highlighted text it is not copied to the Windows clipboard Select Edit gt Clear Press Delete Select All Selects i e highlights the entire contents of the active window Select Edit gt Select All Press CTRL A If you edit the file the title bar of the editor window shows an asterisk e g filename c This asterisk remains until you save the file If you undo all the changes made in the file the asterisk disappears Selecting text in the editor It is possible to select text in the same manner as all editors However to access column selection hold down the ALT key while you are selecting the text with the mouse This changes the selection technique from line to column selection 4 3 3 Saving a file To save the contents of an editing window 1 Ensure that the window whose contents you want to save is the active window 2 Select one of the following operations Click the Save File toolbar button a OR Press CTRL S OR Select File gt Save 3 Ifthe file has not been saved before a File Save dialog box will be displayed Enter a filename specify a directory and then click the OK button to create the file with the name given in the directory specified If the file has been saved before then the file will be updated no dialog box will be displayed To save the contents of an editing window under a new name 1 Ensure that the window whose con
371. gt Symbol gt Locals or click the Locals toolbar button 2 REJ10J2000 0100 Rev 1 00 Jun 16 2009 375 RENESAS High performance Embedded Workshop Window configuration Locals Toolbar f 0 e 2 Column Name Value Type E header 73FFFFB0 long i0 3 p H 00040001 i R2 ilong mirn oumeooee mAr H OOO40001 Ez longi 17 Debugging Facility z e The local variables and their values can be displayed As you debug your program the Locals window will be updated If a local variable is not initialized when defined then the value in the Locals window will be undefined until a value is assigned to the local variable e The contents of this window are blank unless the current PC can be associated to a function containing local variables in the source files via the debugging information available in the absolute file abs e Double clicking the Value column opens a dialog box which allows you to change the value of a local variable Macro Recording e The value of a local variable can be changed by using in place editing Macro Recording Options Right clicking displays a pop up menu containing available options A basic operation is allocated to the toolbar The Toolbar display and Customize toolbar options are also included in the pop up menu opened by right clicking on Launches a dialog box to modify the selected variable s value Displays in hexadecimal Displays in d
372. hain Sets build options Build File CTRL F7 pE W Builds the selected file Build F7 ik a Builds out of date project files Build All CI Builds project files regardless of whether the project files are out of date Build Multiple Ve Builds multiple projects Clean Current C Cleans the current configuration in this project Project Clean All Projects W Cleans all configurations in all projects in this workspace Update All Updates a project s dependencies Dependencies Stop Tool Execution CTRL Break Stops tool execution Include Exclude Excludes a file from build or cancels the REJ10J2000 0100 Rev 1 00 Jun 16 2009 397 RENESAS High performance Embedded Workshop Build Build Phase 2 z Build Configurations s Linkage Order Generate Makefile 1 Main Menus exclusion Adds removes and modifies a phase Selects the current configuration Customizes the High performance Embedded Workshop linkage order Generates a makefile 1 Operations with some menu options can be recorded as High performance Embedded Workshop command line commands by the macro recording support facility A macro record icon in the Macro Recording column of a menu option indicates that this function can be recorded into a macro file For details see section 15 5 1 Recordable functions common to all High performance Embedded Workshop products 2 This menu is not displayed while a debug only project De
373. han gt Modulo Bitwise exclusive OR Less than or equal to lt Greater than or equal to gt Note Support for this function depends on the debugger Register names It can be useful to be able to use the value contained in a CPU register when you are entering a value You can do this by specifying the register name prefixed by the or character e g PC or PC The supported prefix depends on the debugger Character Constants Characters enclosed in single quote marks may be use as character constants For example A etc These character constants are converted to ASCII code and used as 1 byte immediate values Character String Literals Character strings enclosed in double quote marks may be use as character string literals Examples are abc etc Note Support for this function depends on the debugger REJ10J2000 0100 Rev 1 00 Jun 16 2009 108 RENESAS High performance Embedded Workshop 5 Tools Administration 5 Tools Administration You can control the components that are used by the High performance Embedded Workshop via the Tools Administration dialog box which is invoked by selecting Tools gt Administration The Tools Administration dialog box is only accessible when no workspace is open Tools Administration Registered components Cialis Version al Cancel Elsa Toolchains H8S H8300 Standard Toolchain 6 2 1 0 2 Renesas M16C Stan
374. hanges not saved If an address included in the address range of a source file is then shifted to be in the range of another source file in View Disassembly mode selecting View Source mode or View mixed mode displays the Confirmation Request dialog box shown below To open the new source file for the address click Yes To view the source code in the previous mode click No If you do not wish to select View Source mode or View mixed mode click Cancel REJ10J2000 0100 Rev 1 00 Jun 16 2009 296 RENESAS High performance Embedded Workshop 17 Debugging Facility Confirmation Request Ed Your curent disassembly address does not correspond to the original file Do pou with to open the file which comesponds to the curent disassembly address T Don t ask this question again Ho Cancel If you do not wish to open this confirmation dialog box select the Don t ask this question again checkbox To open the confirmation dialog box again 1 Select Setup gt Options The Options dialog box opens 2 Select the Confirmation tab 3 Select the Switch from disassembly to new source checkbox This checkbox is selected by default 4 Click OK 17 2 1 1 Viewing the code To view a source file s code click the View Source button Window configuration a DemoSH4 c OR Yew mined mode View Source View Disassembly Column header long min max long j ine i OO00zZ006 Printe Data 29 00002014 for i 0
375. he Overlay function 1 Displaying section group When the Overlay function is used i e when several section groups are assigned to the same address range the address ranges and section groups are displayed in the Overlay dialog box Open the Overlay dialog box by choosing Debug gt Overlay This dialog box has two areas the Address list box and the Section Name list box REJ10J2000 0100 Rev 1 00 Jun 16 2009 362 RENESAS High performance Embedded Workshop 17 Debugging Facility Overlay Address Section Mame OO2000 OO0e2008 The Address list box displays the address ranges used by the Overlay function Click to select one of the address ranges in the Address list box The Section Name list box displays the section groups assigned to the selected address range Address HOLOOO O010e2 3 Psectol Psectil Psect0e Psectle OO2000 002008 i Psect 03 FPsecti aeS Section Name 2 Setting section group When using the Overlay function the highest priority section group must be selected in the Overlay dialog box otherwise the High performance Embedded Workshop will operate incorrectly Firstly click one of the address ranges displayed in the Address list box The section groups assigned to the selected address range will then be displayed in the Section Name list box Click to select the section group with the highest priority among the displayed section groups Overlay Address Sec
376. he Go will only occur on CORE1 Example 2 Four Debuggers are synchronized with IDs COREO CORE1 CORE and CORE3 Two way synchronizations exist for the Go debug operation between each Debugger and every other Debugger When a Go is executed in any Debugger the Go will occur on all Debuggers By changing the configuration SDO file in a text editor see lt html link gt many synchronizations can be setup in as complex a pattern as required however the GUI only allows the most commonly required styles of synchronizations to be specified Synchronization style C None All debuggers synchronized Master debugger E Uperations executed on any debugger wil Operations executed on the master debugger also be executed on all other debuggers will be esecuted on all other debuggers D E Synchronization options V Reset m Go MW Break Halt M Step Set by platform l Connection l Download modules Initialize uoo Synchronization style Three basic styles of synchronization can be set using the dialog None No synchronizations All debuggers synchronized Two way synchronizations between each Debugger and every other Debugger for the checked operations Master debugger One way synchronizations from the specified master Debugger to every other Debugger for the checked operations The drop list next to this option specifies which Debugger will be the master Debugger Sync
377. he High performance Embedded Workshop allows you to control several aspects of a workspace via the Options dialog box To invoke it select Setup gt Options and select the Workspace tab 6 8 1 Opening the last workspace at start up When you exit the High performance Embedded Workshop the last workspace you had open is stored On subsequently launching the High performance Embedded Workshop you may want the last workspace to be opened automatically To open the last workspace at start up 1 Select Setup gt Options The Options dialog box opens 2 Select the Workspace tab 3 Select the Open last workspace at start up checkbox if you would like the High performance Embedded Workshop to automatically open the last workspace when it is launched 4 Click the OK button W Open last workspace at start up 6 8 2 Restoring files on opening a workspace When you close a workspace the High performance Embedded Workshop stores the names of the files that were open at that time When you open a workspace the High performance Embedded Workshop can restore i e open the same files so that you can continue your session in exactly the same state as when you left it If you would like the files associated with a workspace to be opened when the workspace is opened then set this checkbox REJ10J2000 0100 Rev 1 00 Jun 16 2009 126 2CENESAS High performance Embedded Workshop 6 Customizing the Environment To restore files on open
378. he debugger s memory Choose Load from the pop up menu of the memory window The Load Program dialog box opens Load Program ki File format Filename O Offset address fooooo000 l ACCESS S126 i T Perform memor verify during download Enter the file format in File format file name in Filename offset address in Offset address and access size in Access size To verify memory check Perform memory verify during download If the load address value is to be changed enter the offset value in the Offset field otherwise enter 0 17 3 27 Splitting up the window display To vertically divide the Memory window display into two select Split from the pop up menu and move the split up bar To cancel the split up display select Split from the pop up menu again 17 3 28 Verifying a memory area A memory area in the address space can be verified using the memory verify function Choose Debug gt Verify Memory The Verify Memory dialog box opens Yernty Memory ki File format Cancel Filename O Offset address Rafal ACCESS Sze r REJ10J2000 0100 Rev 1 00 Jun 16 2009 322 RENESAS High performance Embedded Workshop 17 Debugging Facility Enter the file format in File format file name in Filename offset address in Offset address and access size in Access size The message File verified OK appears when verification is successful If the verification failed Verify failed appea
379. he editor window is fixed If you wish to continue step in Disassembly mode of the Disassembly window select Debug gt Step mode gt Assembly 17 2 2 5 Viewing assembly language code The Disassembly mode shows at the current PC location You can view assembly language codes only when the debugger is connected Window configuration at Disassembly Yew mired mode View Source B View Disassembly Column header OOO02z000 OOOO0z002 OOoOO0z004 Disassembly Address column Label column SAW Break points ASM column Ob code column Disassembly e Clicking another toolbar button switches the display mode To view disassembly codes in mixed mode click the View mixed mode button To view source codes in source mode click the View Source button e The columns listed in the table below are on the left of the Disassembly field Column Name Description S W Breakpoints ASM Display the PC location G breakpoints Setting PC breakpoint by double click Disassembly Address Display the disassembly address Open the Set Address dialog box by double click Enter the address to jump to Obj code Display the object codes Label Display the Labels This column is not available if no module has been downloaded e Double clicking the Disassembly field opens the Assembler dialog box Enter assembly language codes REJ10J2000 0100 Rev 1 00 Jun 16 2009 305 RENESAS High performance Embedd
380. he files will be sorted by the file name or type You can select multiple files by clicking If you then click on one of the checkboxes for the selected files or press the Space key checkboxes for all of the selected files will be switched ON or OFF depending on the previous state If the Show files in subfolders checkbox is selected the dialog box also shows the files within subfolders under the folder that was dropped Otherwise the dialog box only shows the files within the folder that was dropped By default this checkbox is selected If the Show source files only checkbox is selected the dialog box only shows the files having the extension specified for the source files in this project e g C source files Otherwise the dialog box shows all files If the High performance Embedded Workshop cannot recognize the file type Unknown type will be shown in the File Type column By default this checkbox is selected If the Create folder structure in project checkbox is selected files are added to the tree where the folder was dropped For example when a folder data containing some files 1s dropped onto the tree the files are added into a user folder data which is newly created If the Create folder structure in project checkbox is not selected when you drop a folder onto a user folder files in the folder are added into this user folder When a folder is dropped onto the active project tree files in the folder are added i
381. he following table describes the operations that can be synchronized The synchronized operations are determined by the selections on the Synchronized Debug dialog box The table columns contain the following data Operation Name of the operation Option s The check box option or options that must be checked on the Synchronized Debug dialog for the operation to be synchronized Method How the operation is executed in High performance Embedded Workshop Effect The effect in all synchronized Debuggers of executing the operation initial platform means the platform connected to the Debugger where the operation was started Sometimes the effect in this Debugger can be different from the others depending on the operation executed Operation Option s Method Effect Reset CPU Reset Debug gt Reset CPU menu Resets all synchronized platforms Reset CPU toolbar button reset command After download when Reset CPU after download option is enabled Go Go Debug gt Go menu Runs all synchronized platforms Go toolbar button go command Go Until Go Debug gt Run menu Runs initial platform with a specific set of After reset when Run to main on reset option is enabled temporary breakpoints Editor pop up Go to Cursor menu Runs all other synchronized platforms normally Reset Go Resetand Debug gt Reset Go menu Resets and then Runs all synchronized Go Reset Go toolbar button platf
382. he horizontal coordinate reduced 17 5 7 Resetting the zoom display Selecting Reset Zoom from the pop up menu displays the waveforms in its original size 17 5 8 Setting the zoom magnification In the Zoom Magnification submenu of the pop up menu the zoom magnification can be selected from 2 4 or 8 REJ10J2000 0100 Rev 1 00 Jun 16 2009 333 RENESAS High performance Embedded Workshop 17 Debugging Facility 17 5 9 Setting the horizontal scale In the Scale submenu of the pop up menu the size of the X coordinate can be selected from 128 256 or 512 pixels 17 5 10 Non display of cursor Selecting Clear Cursor from the pop up menu hides the cursor display 17 5 11 Displaying the sampling information When anywhere within the graph is clicked a cursor green vertical line appears The cursor can be moved by pressing the left or right arrow key Right click in the window to display a pop up menu Selecting Sample Information from the pop up menu displays the Sample Information dialog box If you double click the coordinate where you wish to view the sampling information the Sample Information dialog box appears Sample Information Data Size obit Channel Jo Mong oe ooe s FF Value Displays the sampling information of the cursor location in the Waveform window The following information is displayed Data Size Displays 8bit or 1 6bit Channel Displays the data channel Value X Displays the X coordinate of
383. heg CGreatwhitel E CGreatwhitel Navigation The Navigation tab of the workspace window contains categories for all supported navigation types In High performance Embedded Workshop the following navigation components are supported as standard Class members Navigation Type Category Function C Defines All defines for C and C source files are displayed C Functions All ANSI C standard functions are for C source files displayed C Class All classes functions and members are displayed for C source files By default it is possible to display the navigation items grouped by a navigation category Underneath each category the navigation items belonging to the active project are displayed in the alphabetical order To group the display of navigation items by a navigation category 1 If you right click anywhere inside the Navigation tab a pop up menu will be invoked 2 Un check the Group By File menu option This option is unchecked by default The Navigation view lets you see the navigation items on a file by file basis Each file in the active project is shown in the tree and the navigation items belonging to each file are displayed below it in the alphabetical order To group the display of navigation items by a file 1 If you right click anywhere inside the Navigation tab a pop up menu will be invoked 2 Check Group By File REJ10J2000 0100 Rev 1 00 Jun 16 2009 181 RENESAS 12 Navigation Facilit
384. hen click the OK button M Enable syntax coloring REJ10J2000 0100 Rev 1 00 Jun 16 2009 101 RENESAS High performance Embedded Workshop 4 Editor 4 11 Templates When developing software it is often necessary to enter the same text repeatedly for instance when typing a function definition for loop or a comment block for a function The High performance Embedded Workshop editor allows you to specify a block of text or template which can be inserted into the currently active Editor window Thus once a template has been defined it can be automatically inserted without the need to re enter it manually Figure below shows a list of templates which is located on the Templates tab of the Workspace window E Templates Any new templates which have been added to the High performance Embedded Workshop are displayed under the Templates folder The Toolchain Templates folder is for templates which are read only and have been provided for use in the High performance Embedded Workshop system by the current toolchain Templates in this view can be dragged for insertion into an editor file It is also possible to drag an area of text from the editor into the templates folder for quick template creation Right clicking on the Templates folder opens a pop up menu containing the available options Pop up Menu Option Function Add Adds a new template Remove Removes the current selection Edit Edits the current selection 4 11 1 Defi
385. her details on using Find in Files see section 4 4 2 Finding text in multiple files Right clicking displays a pop up menu containing available options A basic operation is allocated to the toolbar The functions of Toolbar display and Customize toolbar are also included in the pop up menu displayed by right clicking the toolbar area Pop up Menu Option Toolbar Button Function Go to Occurrence Go to the associated source line Clear Window CA Clears the contents of the window Save Saves the contents of the window into a text file Copy Copies the selected contents onto the Windows clipboard Toolbar display Shows or hides the toolbar Customize toolbar Customizes toolbar buttons Macro tab Shows the current records of macros macro recording support facility You can view information such as High performance Embedded Workshop command line commands recorded into a High performance Embedded Workshop macro file from execution of Tools gt Macro Recording to Tools gt Stop Macro It is also possible to view this information while recording For details on the macro recording support facility see Chapter 15 Macro Recording Support Facility Right clicking displays a pop up menu containing available options A basic operation is allocated to the toolbar The functions of Toolbar display and Customize toolbar are also included in the pop up menu displayed by right clicking the toolbar area Pop up Menu Option Tool
386. 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 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 When exporting the 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 You should not use Renesas Electronics products or the technology described in this document for any purpose relating to military applications or use by the military including but not limited to the development of weapons of mass destruction 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 Renesas Electronics has used reasonable care in preparing the information included in this document but Ren
387. hronization options The check boxes here show the debug operations which can be synchronized The state of the following operations can be synchronized as required Reset Go Break Halt and Step The following operations can also be synchronized but their state is always set by the platform being debugged Connection Download and Initialize For non multi core platforms they will always be off REJ10J2000 0100 Rev 1 00 Jun 16 2009 383 RENESAS High performance Embedded Workshop 18 Synchronized Debugging Platform settings When debugging a multi core platform some synchronizations that are normally user configurable may be automatically enabled If an option check box is checked and grayed out this means that the platform has specified that the operation must always be synchronized Notes e Platform settings cannot be overridden by editing the SDO configuration file e Platform settings override your style selection These operations will always be synchronized between all Debuggers even when None or Master debugger is selected 18 1 4 Setting the memory update option I Update the views in all debuggers when platform memory is changed When this option is checked all High performance Embedded Workshop views which display memory data e g the memory view the watch view etc in all Debuggers will update 1 e read memory from the platform whenever the memory is changed in any synchronized Debugger If the option is
388. i zed REJ10J2000 0100 Rev 1 00 Jun 16 2009 49 RENESAS High performance Embedded Workshop 2 Build Basics 2 7 1 Selecting a build configuration To select the current configuration 1 Select Build gt Build Configurations The Build Configurations dialog box opens 2 Select the build configuration that you want to use from the Current Configuration drop down list Debue z 3 Click the OK button You can also select a different build configuration by selecting it from the Current Configuration drop down list on the Standard toolbar 2 7 2 Adding anew build configuration To add a new build configuration 1 Select Build gt Build Configurations The Build Configurations dialog box opens 2 Click the Add button The Add Configuration dialog box opens 3 Enter the new build configuration name into the Configuration name field As you enter the new build configuration name the directory underneath changes to reflect the configuration directory that will be used Configuration name Port ie Based on configuration Debug 4 Select one of the existing build configurations on which you want to base the new build configuration from the Based on configuration drop down list 5 Click the OK buttons on both dialogs to complete the creation of the new build configuration 2 3 Removing a build configuration To remove a build configuration 1 Select Build gt Build Configurations The Build Conf
389. ializes the debugger Note Support for this command depends on the debugger For the syntax of each command refer to the online help REJ10J2000 0100 Rev 1 00 Jun 16 2009 405 RENESAS High performance Embedded Workshop 4 Regular Expressions 4 Regular Expressions The High performance Embedded Workshop editor allows you to include special characters in search strings when performing a find replace or find in files operation These characters are listed in the table below and explained underneath Character t Function This character matches any single character except the newline character For example t p matches top tip but not trap This character matches any number of occurrences 0 or more of any character except a newline Thus this character will not match across new lines The character will match as few occurrences as are necessary to make the rest of the pattern match For example t o matches the to of too the tro of trowel and the ty o of sporty orange but not smart orange because the character does not match across a new line This character matches the tab character Example 1 t8 Finds every occurrence of a tab character followed by an 8 Example 2 init t Finds every occurrence of a tab character following init This matches any one character or a range of single characters listed within the brackets Brackets cannot
390. ialog box Selecting this checkbox allows the files to be relative project files These project files are relative to the workspace file and can also be placed outside the workspace structure Even if you re allocate the entire source tree the High performance Embedded Workshop is able to check the relative position of the files to find them By default this checkbox is selected A Hide Project Files checkbox is available at the bottom of this dialog box Selecting this checkbox only shows the files not added to the current project By default this checkbox is not selected Click the Add button There are other ways to add files to a project Right clicking on an open file in the Editor window displays a pop up menu If the file is already in the project then the Add File To Project menu option is disabled Select the Add File To Project menu option to add the file to the current project In the High performance Embedded Workshop it is also possible to drag and drop files from Windows Explorer onto the Projects tab of the workspace window For details see section 2 3 2 Drag and drop of files and folders REJ10J2000 0100 Rev 1 00 Jun 16 2009 39 RENESAS High performance Embedded Workshop 2 Build Basics Note If you add a file that has an unrecognized file type to the project then the file will be added to the project but certain functions will be disabled for this file When you double click on a file with an unrecogni
391. ialog box will be displayed REJ10J2000 0100 Rev 1 00 Jun 16 2009 300 RENESAS High performance Embedded Workshop 17 Debugging Facility Assembler Address Code OO002408 01 5F Mnemonic Cancel MOL fa H 01 0 8 P CAT The address machine code and disassembled instructions are shown Type the new instruction or edit the old instruction in the Mnemonic field Pressing Enter will assemble the instruction into memory and move on to the next instruction Clicking the OK button will assemble the instruction into memory and close the dialog box Clicking the Cancel button or pressing ESC will close the dialog box Note The assembly language display is disassembled from the actual machine code in the debugger s memory If the memory contents are changed the dialog box and Disassembly view will show the new assembly language code but the source view will be unchanged This is true even if the source file contains assembler 17 2 1 7 Disassembly find in range The disassembly find in range can be used to find a certain text string in the disassembly view between two addresses Right click on the Disassembly field in disassembly mode and select Find in Range The Find in Range dialog box opens Find in Range Ed ES rn O ff Start Address al Cancel End Address El Enter your search string the start and end address that should be searched Click OK The view then selects the first instance of that string i
392. ick the Modify button The Modify Command dialog box will be displayed 3 Modify the information as necessary and then click the OK button To remove a version control command 1 Select the command to be removed from the Commands list of the Define Commands dialog box 2 Click the Remove button REJ10J2000 0100 Rev 1 00 Jun 16 2009 140 RENESAS High performance Embedded Workshop 8 Custom Version Control System To change the ordering of version control menu options 1 Select the menu option to be moved from the Commands list of the Define Commands dialog box 2 Click the Move up and Move down buttons as necessary 8 3 Specifying arguments It is obvious that arguments must be specified correctly otherwise the version control tool executed will not function as intended However it is also important when using custom version control support to specify the arguments in a flexible way as a single version control command can be applied to more than one file To facilitate this the Arguments field has a placeholder button see Reference 5 Placeholders for an in depth discussion of placeholders which when clicked on invokes a pop up menu of all available placeholders An explanation of each version control placeholder and how their values are derived can be found in the table below Pop up menu Placeholder Value And How It Is Determined User login name USERNAME Current user login General tab User login password PASSWORD
393. ies High performance Embedded Workshop DR aj ay OR a FLMAX zy FLMIN a HEAPSIFE a INT OFFSET 4 OSTREAM LF ay O RDONLY ag 0 RDWA D WRONLY a SR it STDERR 4 STDIN STDOUT 2 0 C Funetions amp CLOSEALLWod 9 INIT LOU vod E change lone a E chore SINT tilena E beck i SINT iileno SOWORD offset SINT base E maniro E Manual Peset yoid a openi SBTTE nare SINT mode SINT fig PowerQh_Reset vod read SINT tileno SBYTE buf UINT count aj hrk Gret sre soritlone a g write SINT fileno SBYTE buf INT count 9 Get Glasses wa _lineemed_ da _lnanemendd_ 2 es HEAP TYPE R Globals Sg CLOSEALL void a IMT JOUR void E lob Ea niles a 2lptr Group By File OFF I ih hy ih HE dbh CDemosHd e ari inc intorg are lahele lyase G Det ines HL C Functions Get Glasces iy Cilobals OLOSEALL iad INIT OLB oid Sq ob a Miles a chercettvod a cherput SBYTE close SINT filers a tmed free CSINT ilero SOWORD oftse SINT bese ag cpen_SBYTE name SINT mode SINT fle ag read SINT fileno SBYTE bul UINT court egy sml but 4 rei SINT fileno SEYTE buf UINT count H E lowsreh H E resetpree H 0 C Defines j NT OFFSET 0 A hit H 0 G Functions E PowertQ h_Reesetivoidt E Manual Resetyordh H 0 G Glasses sbrkuc shirk h etackecth typedefineh wet ire wecttolerc vriarid lorcre E rel ia in vn i ns os os og ng ea Navigation Group By File OW
394. igurations dialog box opens 2 Select the build configuration to remove and click the Remove button 3 Click the OK button to close the Build Configurations dialog box REJ10J2000 0100 Rev 1 00 Jun 16 2009 50 RENESAS High performance Embedded Workshop 2 Build Basics 2 8 Building a project 2 8 1 Building individual files The High performance Embedded Workshop lets you build project files individually To build an individual file 1 Select the file to build from the Projects tab of the Workspace window 2 Select one of the following operations e Click the Build File toolbar button E OR e Select Build lt file gt from the pop up menu OR e Select the Build gt Build File menu option OR e Press CTRL F7 All output is redirected to the Build tab of the Output window 2 8 2 Building a project The Build option only compiles or assembles those files that have changed since the last build Additionally it will rebuild source files if they depend upon a file that has changed since the last build For instance if the file TEST C include s the file HEADER H and the latter has changed since the last build the file TEST C will be recompiled To perform a build operation Select one of the following operations Click the Build toolbar button E OR e Press F7 OR e Select Build gt Build OR e Right click on a project in the Projects tab of the Workspace window and select Build gt
395. ile and pressing Remove button And if you want to add a file to the project you can add it by pressing Add button Selecting the Show file path check box shows the full path of the file 17 1 3 Editing project configuration If you are using the SuperH or H8SX H8S and H8 family toolchains then it is possible to configure the simulator again using the project generator This feature is not enabled for the demonstration project type 1 Select Project gt Edit Project Configuration The Edit Project Configuration dialog box opens 2 Click on the Target tab 3 Select the target you wish to use and then click OK 17 1 4 Configuring the debugger Before you can load a program into your debugger you must set it up to match your application s system The items that must be set up are typically device type operating mode clock speed and the memory map It is particularly important to set up the memory map as you must have memory in the debugger into which your user code will be loaded In the High performance Embedded Workshop the project generation process will have completed much of this work However if you are using a different configuration of board from the standard types then some customization will be essential REJ10J2000 0100 Rev 1 00 Jun 16 2009 272 RENESAS High performance Embedded Workshop 17 Debugging Facility 17 1 4 1 Setup To set up the debugger configuration choose Setup gt Simulator or Setup gt Emulat
396. ile pressing the CTRL key REJ10J2000 0100 Rev 1 00 Jun 16 2009 7 RENESAS High performance Embedded Workshop 1 Overview To hide the Workspace window or the Output window Select one of the following operations e Click on the close button which is located in the top right corner of the window OR e Right click anywhere inside a floating window and select the Hide option on the pop up menu Hide To show the Workspace window or the Output window Select View gt Workspace or View gt Output respectively 1 2 5 Editor window The editor window is where you will work with the files of your project The High performance Embedded Workshop allows you to have many files open at one time to switch between them to arrange them and to edit them in whichever order you want to By default the editor window is displayed in a notebook style This means that each file has a separate tab associated with it to aid in navigating between files see the figure below include typedefine h pragma section DSEC Stacie Const SCEE _UBYTE ron 3 AtCart address GE the _UBYTE ron e End addressa of the in _UBYTE ram 3 f Start addressa GE the DTBLE i H The editor contains a gutter column on the left hand side of the window The standard column allows the user to configure the position of bookmarks and software breakpoints quickly and easily If you are unsure what purpose a column has
397. in the dialog box opened by clicking on the Saves real time profile measurement option toolbar button menu option or toolbar button results to a file e E100 emulator debugger Target Operation Function Set pop up menu option toolbar Make setting in the dialog box opened by clicking onthe Allocates real time profile memory button menu option or toolbar button e De allocates real time profile memory e Sets real time profile measurement mode e Enables or disables each task ID individually Clear Data pop up menu Click on the menu option or toolbar button Clears all measurement data of real option toolbar button time profile Save To File pop up menu Make setting in the dialog box opened by clicking onthe Saves real time profile measurement option toolbar button menu option or toolbar button results to a file 15 5 2 25 Configuration dialog box While a macro is being recorded the following operation will be recorded into a macro file Target Operation Function OK button Click on the button Sets the emulator operation conditions 15 5 2 26 Configuration properties dialog box While a macro is being recorded the following operation will be recorded into a macro file Target Operation Function OK button Click on the button Selects the operating clock Sets up the debugger Selects a switching function Allocates emulation memory Sets on overwriting of the internal flash memory Sets the warning of exceptional events
398. information The version information of the High performance Embedded Workshop can be viewed To view the version information 1 Select Help gt About High performance Embedded Workshop The About High performance Embedded Workshop dialog box opens Information including the copyright and version number is shown in this dialog box 2 Clicking the More gt gt button shows Installed package information which contains various information on the Renesas tool packages associated with the High performance Embedded Workshop installed on your personal computer e g version number About High performance Embedded Workshop ki High pertormance Embedded Workshop Copyright C2007 Renesas Technology Corp High performa nce Copyright C 2007 Renesas Solutions Corp Copyright CJZ007 Renesas Technology Europe Ltd E mbedded All rights reserved Workshop Version 4 0 AA Aes Installed package information MI BLED SOL Tin 2010 ASC Tiny Senes C Compiler v5 43 Release 00 10 26 2007 27 55 MS2C 90 30 M1T6C 80 70 Seres C Compiler v5 47 Release 01 10 26 2007 21 10 33 LC compiler package for SuperH RISC engine family Vo9 01 Release 01 Update Utility 10 26 2 m Hoe ss 3 Click on the OK button to close the dialog box 19 2 Check for updates To check for High performance Embedded Workshop product updates or service packs 1 Select Help gt Technical Support gt Check Website For Updates 2 Your default web br
399. ing Source directory OK C vwork Vohared p Browse Version control directory _Cancel fetve we shared To remove a directory mapping 1 Select Tools gt Version Control gt Configure The Version Control Setup dialog box opens Select the Projects tab 2 Select the mapping to be removed from the Version Control Directory Mappings list and then click the Remove button 8 7 Specifying file locations example Consider the scenario shown in the figure below It shows three directories which are mapped from a shared version control drive X to a local drive where the development is being done C LOCAL Ci ma Cwyvorkapplicationiprojectt cWwieclsw app project Mapped To coMwvork application src WCE Ww applerc ma E c work shared WC Sy lapplehared Now let s imagine that a version control executable has been selected which uses a GET command to obtain a read only copy of a file In order to get all of the files in a project we need to use the following command GET VCDIR FILENAME When the High performance Embedded Workshop executes the command for a given project file it will replace VCDIR for the equivalent version control directory in the file mapping For example suppose FILE1 C is located at c work application project1 FILE1 C If the GET command is applied to FILE1 C then 1 x vc sw app project1 is substituted for VCDIR as this is the ve
400. ing a workspace 1 Select Setup gt Options The Options dialog box opens 2 Select the Workspace tab 3 Select the Restore files on opening workspace checkbox if you would like the files associated with a workspace to be opened when the workspace is opened 4 Click the OK button W Restore files on opening workspace 6 8 3 Displaying workspace information on opening a workspace When many workspaces are being used it is sometimes difficult to remember exactly what is contained within each workspace The High performance Embedded Workshop allows you to enter a textual description of each workspace This description can be displayed whenever a workspace is opened To enter a workspace description 1 Select the workspace icon from the Projects tab of the workspace window 2 Right click to invoke the pop up menu and then select Properties The Workspace Properties dialog box opens Enter the description into the Information field 4 Select the Show workspace information on workspace open checkbox if you want a Workspace Properties dialog box to be launched on opening a workspace This checkbox has the same role as the Display workspace information dialog on opening workspace checkbox on the Workspace tab of the Options dialog box 5 Click the OK button W Display workspace information dialog on opening workspace 6 8 4 Saving the workspace before executing any tools It is possible to force the High performance Embedded Wor
401. ing the replace operation the selected text will be automatically placed into the Find what field 9 Enter the text that you want to replace the search string with or select a previous replace string from the drop down list box 10 If you would like to search for character string as a whole word then click the Match whole word only checkbox When this option is not selected the search will be for any string that is matched by the search string 11 If you would like your search to be case sensitive 1 e to distinguish between upper and lower case letters then check the Match case checkbox 12 If your search string uses regular expressions then check the Regular expressions checkbox See Reference 4 Regular Expressions for further information 13 If you clicked the Find Next button the editor will search for the first occurrence of the search string Click the Replace button if you want to replace it Click Replace All button to replace all occurrences or click the Cancel button to stop the replace action If you select Selection in the Replace In field the replace action will be performed in the range of the selected text If you select Whole file the replace action will be performed on the whole file If you select All open files all files that are currently open in the editor will have the replace operation carried out on them REJ10J2000 0100 Rev 1 00 Jun 16 2009 94 RENESAS High performance Embedded Workshop 4 Editor 4
402. ion Control System The General tab of the Version Control Setup dialog box allows you to control the way in which the version control system is executed It also shows the full path to the current version control configuration file The execution of a version control system can be modified via the following three checkboxes e Prompt before executing command If this checkbox is selected then before any version control commands are executed a dialog is displayed which lists all of the files involved in the operation Files may be deselected by clearing the associated checkbox Clicking the OK button will apply the command to each of the selected files Clicking the Cancel button will abort the operation REJ10J2000 0100 Rev 1 00 Jun 16 2009 144 RENESAS High performance Embedded Workshop 8 Custom Version Control System e Run in DOS window By default the output of the version control commands is redirected to the Version Control tab of the output window If you would rather run each command in a separate DOS window then set this checkbox Select Close DOS window on exit checkbox if you wish the DOS window to close after execution has been completed e Use forward slash as version control directory delimiter By default when the High performance Embedded Workshop substitutes the VCDIR placeholder it uses the backward slash character V to divide directories However if the version control system you are using uses a forward
403. ion and select Go To Cursor from the pop up menu lEThis records the go_ till command Add the array element a 6 storing random data to the Watch window IThis records the watch_add command Click the Stop Macro button O on the Macros toolbar The mouse pointer returns to be an arrow The Add New Macro Function dialog box opens Enter a macro name e g Demo The message Finished recording Demo is shown in the Macro tab of the Output window To view the recorded High performance Embedded Workshop command line commands be sure to select the Macro tab of the Output window x a Ol Of al at 2 21 G tal 2 Recording refresh session register set RO Oxo register set Ri Oxo register set Re Oxo register set R3 Oxo register set R4 Oxo register set Ro Oxo register set R Oxo register set RY Oxo register set RE Oxo register set R9 Oxo register set R10 Oxo register set Ril Oxo register set Eiz Oxo register set Rls 0x0 register set R14 Oxo build wait file load Elf Dwvarfz CONFIGDIRI PFPROJECTNAME abs Ox0 p byte memory fill OxYOOOOOOO x7 ZT OxOO00 long nowerify reset go till go xz0E4 watch add Watchl al6 i Finished recording DPemo lacro REJ10J2000 0100 Rev 1 00 Jun 16 2009 26 RENESAS High performance Embedded Workshop 1 Overview 1 14 3 Step 2 Editing a macro viewing records 1 Select Tools gt Macros to invoke the Macro dialog box The High per
404. ions on the English version of the High performance Embedded Workshop application Document Conventions This user s manual uses the following typographic conventions Convention Meaning Menu gt Menu Option gt is used to indicate menu options for example File gt Save As FILENAME C Uppercase names are used to indicate filenames Key Key Used to indicate required key presses For example CTRL N means press the CTRL key and then whilst holding the CTRL key down press the N key Figures Some figures in this user s manual may differ from the objects they represent Trademarks Microsoft MS DOS Visual SourceSafe Windows and Windows Vista are either registered trademarks or trademarks of Microsoft Corporation in the United States and or other countries All other company and product names are registered trademarks or trademarks of their respective companies For inquiries about the contents of this document or product email to your local distributor Renesas Tools Homepage http www renesas com tools REJ10J2000 0100 Rev 1 00 Jun 16 2009 RENESAS High performance Embedded Workshop Contents Contents l OD aa a a N E E E E N E N E oud adaeates l 1 1 Workspaces projects and TES sessu E E e a O Ee Eae EEE AE l A E E A A A E A N E O O A O A A A l 1 2 1 AEn A e R E E E serene ec cea A A E T EEE A A O E E 2 L22 MD A A E feceaeeces 2 1 2 3 TOGDA a ee ee en E E ne eee ee 3 1 2 4 Workspace windoW ite
405. ipment communications equipment test and measurement equipment audio and visual equipment home electronic appliances machine tools personal electronic equipment and industrial robots High Quality Transportation equipment automobiles trains ships etc traffic control systems anti disaster systems anti crime systems safety equipment and medical equipment not specifically designed for life support Specific Aircraft aerospace equipment submersible repeaters nuclear reactor control systems medical equipment or systems for life support e g artificial life support devices or systems surgical implantations or healthcare intervention e g excision etc and any other applications or purposes that pose a direct threat to human life 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 cert
406. is file again after you have created it previously you can use the following operation To open a test suite 1 Select Test gt Open Test Suite The Open Test Suite dialog box opens 2 Select the test suite file Then click Select The test suite is loaded This then enables a number of other items on the Test menu and opens the test suite contents in the Test tab of the workspace window When test suites are opened the filename of the suite is added to the Recently used test suite list on the File menu This allows access to open your test suites after the initial Open test Suite menu operation To close a test suite Select Test gt Close Test Suite Once clicked the current test suite is closed and all items are removed from the workspace tab There are TCL command line commands for these operations that can be used via the command line window These commands are named open_test_suite and close_test_suite You can also close a test suite from the workspace window pop up menu 16 3 Editing a test suite Once your test suite has been created the next step is to add some tests This operation allows you to access the Modify Test Suite dialog box and will allow you to add tests which will then be executable REJ10J2000 0100 Rev 1 00 Jun 16 2009 233 RENESAS High performance Embedded Workshop To edit a test suite I Select Test gt Edit Test Suite The Modify Test Suite dialog box is displayed Modify Test Suit
407. is option is fixed to Workspace directory and below only 8 Selecting the Use static sub command files checkbox will generate separate command files in the make destination directory By default this checkbox is not selected Note While a SuperH or H8SX H8S and H8 family toolchain is in use the Use static sub command files checkbox has a fixed tick if you have selected GNUMake in Makefile format 9 Selecting the Scan dependencies whilst building make file checkbox will execute a dependency scan before creation of a makefile This checkbox is selected by default 10 Click OK REJ10J2000 0100 Rev 1 00 Jun 16 2009 80 RENESAS High performance Embedded Workshop 3 Advanced Build Features The High performance Embedded Workshop will create a subdirectory called make within the current workspace directory and then generate the makefile into it The executable HMAKE EXE located in the High performance Embedded Workshop installation directory is provided for you to execute the makefiles generated by HMake selected in Makefile format If you wish to modify makefiles see Reference 13 HMAKE User Guide Note If the name of the High performance Embedded Workshop installation directory includes a space the GNU Make command may not work correctly when GNU Make is selected as the makefile format with the makefile generating function To execute a makefile HMake 1 Open a DOS Command Prompt window and move to the ma
408. ist This list also appears on the File menu To open a workspace by specifying a workspace file HWS file select the Browse to another project workspace button and click the OK button To open the Synchronized Debug dialog box select the Start synchronized session button and select a configuration from the drop down list and click the OK button This item is only available when a synchronized debugging facility has been used To register or un register a tool from the High performance Embedded Workshop click the Administration button Click the Cancel button to use the High performance Embedded Workshop without opening a workspace If you do not wish to open the Welcome dialog box next time you launch the High performance Embedded Workshop select Setup gt Options The Options dialog box opens Remove a tick mark from the Display Welcome Dialog checkbox in the Confirmation tab If you do not wish to view the start up screen when launching the High performance Embedded Workshop remove a tick mark from the Display Splash Screen checkbox in the Confirmation tab of the Options dialog box 1 5 Creating a new workspace To create a new workspace 1 Select the Create a new project workspace option from the Welcome dialog box and click the OK button or select File gt New Workspace The New Project Workspace dialog box will be displayed 2 Enter the name of the new workspace into the Workspace Name field This can be up to 32 cha
409. ist shows the file local variables included in the compilation unit to which the selected file belongs 3 Each of the variables in the Name list has a check box By default the check boxes are not selected A sign shown next to a variable in the Name list indicates that the variable can be expanded by double clicking However double clicking on a sign does not collapse the expanded variable Even if the check box for a variable with is selected the boxes for its elements are still blank 4 Select a scope and check the boxes for variables as required Click OK To delete a variable 1 Click on the Delete button on the Edit Test C Variables dialog box The variable selected in the Compared list will be deleted Only one variable is selectable in the list Edit Test C Yariables Compared Cancel Add Delete Global Then click OK 16 6 2 5 CPU Simulated I O Simulated I O window The following table shows information on the test image data to be saved into test image files and test results not Test image data to be matched Test group name CPU Test item name Simulated I O Values set as detailed information and the range of data in the Simulated I O window acquired with this saved into test image files setting No I O simulation range is specified by default Test result details Failed at Line Unmatched line number Src Content of the test image file Dest Data in the c
410. ister value setting deleting a software breakpoint and running a program The macro recording support facility is available in the Tools menu and on the Macros toolbar Macros toolbar rae If the Macros toolbar is hidden select Setup gt Customize to open the Customize dialog box Select the Macros checkbox on the Toolbars tab of the Customize dialog box Tools Menu Macros Toolbar Function Macros g Opens the Macro dialog box This dialog box has the following features and lists the macro names recorded in each of the selected High performance Embedded Workshop macro files Creating a new blank macro file Importing an existing macro file Starting a macro record operation Starting a macro play function Editing a current macro file Assigning the selected macro Removing the selected macro Macro Recording w Starts a macro record operation Play Macro D The Select Macro Function dialog box opens Choose which macro you wish to execute 0 Pauses the current macro operation Stop Macro oO Stops the current macro operation REJ10J2000 0100 Rev 1 00 Jun 16 2009 21 RENESAS High performance Embedded Workshop 1 Overview The procedure from selection of Record Macro to that of Stop Macro D consists one macro and one High performance Embedded Workshop macro file can record multiple macros a set of High performance Embedded Workshop command line commands A macro includes multiple High performance Embed
411. j Debug Demo Corel i Debug Demo Corel i Find in Files 1 F Restricted operations All Debugger operations that change the active session are not allowed when in internal mode and will be disabled This includes the following Set Current Project Remove Project Unload Project Change Session Change Configuration The standard build operations can be used but they will only affect the active configuration in the active project which cannot be changed If you want to build projects and configurations which are not active then you can use the Build Multiple dialog 18 3 Using the command line window when synchronized Overview Two new commands are provided when using synchronized debugging These allow the Debugger that commands will be executed on to be changed so a command file executed in one Debugger can execute commands on a different Debugger SET_CORE command Abbreviation SMC Description Sets the current Debugger from the perspective of the command line ECX All debugger commands from now on will be sent to the requested Debugger Note This does not effect operations invoked from the GUI Syntax smc lt Debugger ID gt Parameter Type Description lt Debugger ID gt String Debugger ID If empty the perspective will be changed back to the local Debugger Example smc SH X core 1 From now on debugger commands will be directed to the SH X core 1 Debugger SHOW_ALL_ CORE command Abbreviation SAC
412. k the No button the contents of the local file will be different from those of the file in the version control system High performance Embedded Workshop CAWoorkepace Workspace Mame Projects Mame lowenc c File was modified externally Would vou like to reload it Viewing the history of files in Visual SourceSafe Visual SourceSafe controls the edits to the files in its projects and allows you to view the complete history of these edits right back to the time that the file was first added to the project The status of each file will be displayed in the Version Control tab of the output window or the File s History dialog box For setting of location where the status is to be displayed see section 9 3 Visual SourceSafe command options To view the revision history of files in Visual SourceSafe Select the files whose history you would like to view in the Projects tab of the workspace window You may also select a file folder project folder workspace folder or combination thereof Select one of the following operations Select Tools gt Version Control gt Show History OR Right click to invoke a pop up menu and select Version Control gt Show History REJ10J2000 0100 Rev 1 00 Jun 16 2009 166 RENESAS High performance Embedded Workshop 9 Visual SourceSafe Version Control System 3 The Version Control tab of the output window or the File s History dialog box shows the revision history of files 9
413. kad x mj Opens the Status window Graphic Image 3 CTRL SHIFT G Opens the Image window Waveform 3 CTRL SHIFT V Opens the Waveform window Code Stack Trace CTRL K ins Opens the Stack Trace window REJ10J2000 0100 Rev 1 00 Jun 16 2009 396 RENESAS High performance Embedded Workshop 1 Main Menus Notes 1 Operations in some windows can be recorded as High performance Embedded Workshop command line commands by the macro recording support facility A macro record icon in the Macro Recording column of a menu option indicates that this function can be recorded into a macro file For details see section 15 5 1 Recordable functions common to all High performance Embedded Workshop products Note that a function of another window dependent on the debugger can also be recorded as a command even though this window is not included in the list of menus For details see section 15 5 2 Recordable functions dependent on the debugger 2 Data in some windows can be saved as test image data into test image files by the test support facility A save file icon in the Saving into Test Image File column of a menu option indicates that this data can be saved into a test image file For details see section 16 6 1 Functions that can be saved into test image files common to all High performance Embedded Workshop products Note that some functions of other windows dependent on the debugger can also be saved into test image files
414. ke directory where the makefile was generated 2 Execute HMAKE Its command line is HMAKE EXE lt makefile gt Note The degree of portability of a generated makefile is entirely dependent upon how portable the project itself is For example any compiler options that include full paths to an output directory or include file directory will mean that when given to another user with a different installation the build will probably fail In general use placeholders wherever possible using a full specific path should be avoided when possible 3 9 Using a makefile inside the High performance Embedded Workshop system The High performance Embedded Workshop also allows you to configure the internal build to use a particular make tool hmake nmake or gmake as well as the internal High performance Embedded Workshop system The build procedures using makefiles are listed below nmake and gmake tools must be prepared by the user while hmake is installed in the High performance Embedded Workshop installation directory To set up the internal makefile execution 1 Create a High performance Embedded Workshop workspace 2 If you want to use a High performance Embedded Workshop generated makefile select Build gt Generate Makefile to generate a makefile For details see section 3 8 Generating a makefile Select Setup gt Options The Options dialog box opens 4 Click the Build tab Maketile Build Command excluding parameters
415. king on the toolbar Pop up Menu Option Toolbar Button Macro Recording Description Auto Update R C Marks the selected variable with a bold R and updates the variable in real time Auto Update All W Marks all variables with bold Rs and updates all variables in real time Delete Auto Update E i Marks the selected variable with an outlined R and cancels real time update Delete Auto Update All T Marks all variables with outlined Rs and cancels real time update Update Interval 1 Sets an update interval Record Update Start pR T Opens the Recording Settings dialog box and starts Value Recording recording the history of updating of values Stop pe i Stops recording the history of updating of values Recording Add Watch EH C Launches the Add Watch dialog box allowing the user to enter a variable or expression to be watched Edit Name TH C Launches the Edit Name dialog box allowing the user to change the watch item s name D Edit Value F Launches the Edit Value dialog box allowing the user to change the variable s value Set Scope Sets the scope for the selected symbol Delete x Removes the variable indicated by the text cursor from the Watch window Delete All F Removes all the variables from the Watch window Radix Hexadecimal fj 5 Displays in hexadecimal Decimal 10 5 Displays in decimal Octal O Displays in octal Binary F C Displays in binary Copy Places a copy of the highlighted text into the Windows clipboard
416. kpoint in a batch file Breakpoints can be set on command lines in a batch file on the Debugger tabbed pane of the Command Line window This feature is not available when no batch file has been specified To set a breakpoint in a batch file 1 Open the Debugger tabbed pane of the Command Line window 2 Perform one of the following operations in the upper pane e Double click on the Breakpoint column for the line where the execution should stop e Place the cursor on the line where the execution should stop Then right click to open the pop up menu and select Insert remove breakpoint A breakpoint icon appears on the Breakpoint column This indicates that a breakpoint has been set 3 To switch enabling and disabling of the breakpoint that has been set right click and select Enable disable breakpoint from the pop up menu To delete the breakpoint right click and select Insert remove breakpoint or double click on the column To delete all breakpoints right click and select Clear all breakpoints from the pop up menu Execute the batch file with the Debugger tabbed pane open in the Command Line window At a break the execution stops before the command line where the breakpoint has been set If you select Step or Play after the break the execution restarts at the command line indicated by the yellow arrow 5 Up to 256 breakpoints can be set When saving the session all breakpoints that have been set are also saved Notes e No
417. kshop into saving the current workspace before executing any build phases i e build build all or build file operations or version control commands To save the workspace before executing any tools 1 Select Setup gt Options The Options dialog box opens 2 Select the Workspace tab 3 Select the Save workspace before executing any tools checkbox 4 Click the OK button W Save workspace before executing any tools 6 8 5 Prompting before saving a workspace If you are using the Save workspace before executing any phases function you may want the High performance Embedded Workshop to prompt you before saving the workspace For further information about saving a workspace before executing phases see section 6 8 4 Save workspace before executing any phases REJ10J2000 0100 Rev 1 00 Jun 16 2009 127 RENESAS High performance Embedded Workshop 6 Customizing the Environment To display a prompt before saving the workspace 1 Select Setup gt Options The Options dialog box opens 2 Select the Workspace tab 3 Select the Prompt before saving workspace checkbox 4 Click the OK button If Prompt before saving workspace 6 8 6 Prompting before saving a session Checking this option will force the High performance Embedded Workshop into displaying a prompt before the session is saved to disk To display a prompt before saving the session 1 Select Setup gt Options The Options dialog box opens 2 Select the Workspace t
418. l information You can view the filtered symbol information of the linkage editor To filter the symbol information 1 Right click within the right pane to open a pop up menu 2 Select Filter The Filter Symbol dialog box appears REJ10J2000 0100 Rev 1 00 Jun 16 2009 201 RENESAS High performance Embedded Workshop 13 Map Filter Symbol Ei W Enable Filter a saree seas Filter Column Attribute Set All Clear All Cancel Select the Enable Filter checkbox By default this checkbox is not selected Select a column in Filter Column Select a filtering condition in Filter Item Filter Column Filter Item Function Attribute symbol attribute Function Filter by functions Data Filter by data symbols Entry Filter by positions to start execution None Filter by other symbols such as labels Scope scope attribute Global Filter by global symbols Normal Filter by local symbols Section sections containing symbols Section name Filter by section names File files containing symbols File name Filter by file names Clicking the Set All button selects the check boxes of all filtering conditions Clicking the Clear All button de selects the check boxes of all filtering conditions Click OK Symbol information of the linkage editor shown in the right pane is filtered by the selected condition For further filtering by combining a different condition select another column and then select a filtering condition in the col
419. ld option is set When a module is modified externally to High performance Embedded Workshop Initialize Initialize Debug gt Initialize menu All synchronized platforms will be initialized initialize command Regarding stepping the style of step performed source or instruction in a synchronized Debugger will be determined by the program counter step mode and editor cursor position in that Debugger and not the Debugger where the operation was initiated Each individual Debugger will effectively act as if the step operation had been executed locally by the normal High performance Embedded Workshop method e g toolbar button Regarding download the operation will only be synchronized with Debuggers that have modules with the same filename as the module in the initiating Debugger If a Debugger contains more than one module then only the one with the matching filename will be downloaded Unless specifically mentioned all other Debugger operations and other non Debugger High performance Embedded Workshop operations are possible while synchronized debugging But they will only be executed on the initiating platform and not synchronized with other platforms Debug Settings dialog box Debug Settings Ei Ed Target Target bore Webia hornet Download modules Offset Address Format Add HCONFIGDOIRRHPRO 00opoong El Dwat l Mioditin i Hemave Up Down i Cancel i
420. ld Basics If Editor is selected the Open File function in the workspace window causes the file to be opened in the High performance Embedded Workshop editor If None is selected then the Open File operation is disabled when it is attempted Selecting Other allows you to configure another tool for the Open File operation See section 2 5 1 Associating an application with a file group for more details If Windows default is selected then the Open File function in the Workspace window passes the Open File operation to the Windows operating system This then selects the default behavior for this file extension as defined in Windows Explorer 6 Click the OK button to add the extension to the File Extensions list 2 5 3 Creating a new file extension If your files use a different extension from those accepted by the High performance Embedded Workshop for a given phase e g your assembler source files are asm but the High performance Embedded Workshop only recognizes src then you need to create a new extension and add it to an existing file group This process is described below To create a new file extension in an existing file group 1 Select Project gt File Extensions The File Extensions dialog box opens 2 Click the Add button The Add File Extension dialog box opens Add File Extension File extension 7 k asm Cancel File group f Extension belongs to an existing group Assembly source file C E
421. lect Debug gt Display PC This will open the editor or disassembly at the current PC 17 2 4 Highlighting the line at the PC In the Editor and Disassembly windows an icon in the S W Breakpoints column indicates the PC location The source or assembly language code at the PC can be highlighted REJ10J2000 0100 Rev 1 00 Jun 16 2009 308 RENESAS High performance Embedded Workshop 17 Debugging Facility To highlight the line at the PC location 1 Select Setup gt Options The Options dialog box opens 2 Select the Debug tab 3 Select the Enable line highlight for PC position checkbox By default this checkbox is selected 4 Click OK The color of the line can be customized in the Format Views dialog box The text foreground is in black and the background color is yellow by default To change the colors of the line at the PC 1 Select Setup gt Format Views The Format Views dialog box opens 2 Select an item for which you wish to change the color from the left hand tree in the dialog box and expand it e If you are opening the editor window or disassembly window in source mode select Source and expand it e Ifyou are opening the editor window or disassembly window in mixed mode or disassembly mode select Disassembly and expand it Select the PC Line Highlight category Change the selection in the Foreground and Background lists of the Color tab Click OK 17 3 Operating memory This section describes how to
422. lect a file in the Projects tab of the workspace window Right click on the selected file to open a pop up menu Select Show Differences OR Click the Compare Files toolbar button Pld OR Select View gt Differences Right click within the window to open a pop up menu Select Compare The Compare Files dialog box opens Compare Files Reference tile Jorkspace DemoSH4 DemoSH4 dbsct c Browse 5 ance f Compare with file on drive Target file Gdyvanced Browse M Gormpare with version contral Ensure the Compare with file on drive radio button is enabled Enter the name of a file to be compared to in Reference file If you have opened the Compare Files dialog box via the workspace window at step 1 the file name is already entered in Reference file Select a previously used file from the drop down list box or click the Browse button to browse a file Clicking the Advanced button displays the Compare Files Advanced Options dialog box This allows you to perform the difference comparison without taking white space into account Click OK when you are finished with this options dialog box Compare Files Advanced Options Advanced gnore blanks Cancel 6 Click Compare To perform a difference comparison with a local file and a file in Visual SourceSafe system il The High performance Embedded Workshop must be connected to the Visual SourceSafe system Add the two files you
423. led the disassembly lock refresh Right click on the Disassembly field in disassembly mode and select Lock Refresh The Lock Refresh dialog box will be displayed Lock Refresh Ei Eg Start Address ooon2o00 E ance End Address 00002014 Check the Locked check box The controls should now enable Select the start and end address that should be locked and cached so that no updates are displayed Click OK The view refreshes to only show the locked area 17 2 1 5 Looking at a specific address When you are looking at your program in a Disassembly view you may want to look at another area of your program s code Rather than scrolling through a lot of code in the program you can go directly to a specific address Right click on the Disassembly field in disassembly mode and select the Set Address option The Set Address dialog box will be displayed Set Address eax Cancel Enter the address or label name in the edit box and either click the OK button or press the Enter key The Disassembly view updates to show the code at the new address When an overloaded function or a class name is entered the Select Function dialog box opens for you to select a function Support for this function depends on the debugger 17 2 1 6 Modifying assembly language code You can modify the assembly language code in the disassembly view in disassembly mode by double clicking on the instruction that you wish to change The Assembler d
424. les If you wish hmake to generate a sub command file for you then the command part of the description block should be specified as follows this replaces lt commandn gt above lt command start gt lt lt lt sub command gt lt sub command gt lt sub commandn gt lt lt lt command end gt This will generate a sub command file in the Windows temporary directory which will contain the lines lt sub command 1 gt lt sub command2 gt etc This command file will be deleted once the make process has completed The name of the command file will be substituted for all the text between the two lt lt s You do not have to worry about the name of the sub command file This is generated by hmake For example c dir1 filel obj c dirl filel c c dirI filel h gcc lt lt c oc dirl filel obj c dirl1 filel c lt lt If the sub command file generated has the name c temp hmk111 cmd then the following would be executed by hmake assuming c dirl filel obj is out of date gcc c temp hmk111 cmd The command file c temp hmk111 cmd would contain c o c dirl filel obj c dir1 filel c It is possible to include more than one command in the description block and to use combinations of the standard and sub command file commands REJ10J2000 0100 Rev 1 00 Jun 16 2009 423 RENESAS High performance Embedded Workshop 13 HMAKE User Guide 13 4 Comments
425. lication to debug a specific target When running in synchronized debug mode it is used as a generic term to refer to a synchronized High performance Embedded Workshop application when in parallel mode or session when in internal mode The string ID that uniquely identifies a Debugger within the High performance Embedded Workshop GUI The string ID that uniquely identifies a Debugger internally inside High performance Embedded Workshop Only needs to be understood when editing SDO files Using synchronized debugging with all Debuggers open in one High performance Embedded Workshop application The Debugger that the user is currently interacting with A hardware or simulator device that has two or more CPU cores The main purpose of the synchronized debugging feature is to help the user debug multi core platforms Using synchronized debugging with each Debugger in a separate High performance Embedded Workshop application Hardware or simulator device that is connected to High performance Embedded Workshop Could be a single core platform or an individual core on a multi core platform The synchronized debug configuration file Contains all the information needed by High performance Embedded Workshop to start a synchronized debug session Saved from the Synchronized Debug dialog REJ10J2000 0100 Rev 1 00 Jun 16 2009 391 RENESAS High performance Embedded Workshop 19 Technical Support 19 Technical Support 19 1 Viewing the version
426. linkage order check box 3 The Object order list box allows you to specify the linkage order of modules Each module has a different icon depending on where it originated from This is shown below Linkage Order Ei M Use custom linkage order OF Object order A Cancel main obj eee Uwe GO i Intprg aby runtime library lib Move up projectname lib ge user_edit_options lib Move down Intermediate file File in project User library from options Move to bottom Import Export Curent configuration Debug Copy to EEk You can change the linkage order in the following ways e To move a single or consecutive modules Move to top Moves the selected module s to the top Move up Switches the selected module s and the previous module REJ10J2000 0100 Rev 1 00 Jun 16 2009 83 RENESAS High performance Embedded Workshop 3 Advanced Build Features Move down Switches the selected module s and the next module o gt DD i ae Move to bottom Moves the selected module s to the bottom e To move non consecutive modules Move to top Moves all of the selected modules to the top Group up Moves all of the selected modules to the position of the first one among them Group down Moves all of the selected modules to the position of the last one among them Move to bottom Moves all of the selected modules to the bottom
427. linker lt Back Nest gt Cancel The input file group list contains the current file groups defined for the project It is possible to define multiple input file groups by selecting the Multiple Groups entry in the input file group list REJ10J2000 0100 Rev 1 00 Jun 16 2009 67 RENESAS High performance Embedded Workshop 3 Advanced Build Features Select Groups JC header file CJC list file WJC source file j Cancel C header file C C list file Wel C source file J CPU information file Expanded assembly source file Once this choice has been made the input file group selection is displayed as Multiple Groups This dialog box allows the user to choose multiple input file groups for the custom phase being added to the project To select a file group check the box next to the file group s name One or more file groups can be selected in this dialog box Step 3 The third step requests the fundamental information about the new build phase Enter the name of the phase into the Phase name field Enter the location of the program file into the Command field do not insert any command line options as these options are specified via the Options menu of the High performance Embedded Workshop menu bar Specify the default options for the phase 1 e what options you would like new files to take when added to the project into the Default Options field If you have a preferred directory in which
428. ll be displayed in the Find in Files 1 or Find in Files 2 tab of the Output window To stop a Find In Files action once it is under way select the Edit gt Stop Find in REJ10J2000 0100 Rev 1 00 Jun 16 2009 93 RENESAS High performance Embedded Workshop 4 Editor Files menu option Once the Find In Files operation is complete you may jump to an instance of the search string by double clicking on the desired entry in the Output window 4 4 3 Replacing text Replacing text is similar to finding text as discussed in the previous section The difference is that when the text is found you have the option to replace it with other text To replace text in a file 1 Ensure that the window whose contents you want to replace is the active window 2 Position the insertion cursor at the point from which you want to start your search 3 Select one of the following operations to open the Replace dialog box e Press the CTRL H key OR e Select Edit gt Replace OR e Select Replace from the pop up menu in the Editor window Replace Find what hd Find Next Replace with a Replace F Match whole word only Match case Regular expression Replace In C Selection whole file C All open files Replace All Cancel Adi 8 Enter the text that you want to search for into the Find what field or select a previous search string from the drop down list box If you select text before invok
429. ll history The Stack Trace window shows the function call history 17 16 1 Opening the Stack Trace window To open the Stack Trace window choose View gt Code gt Stack Trace or click the Stack Trace toolbar button a Window configuration le Stack Trace Fijn E4 Eina Name Value F tuned i short j t OxODOOCR0US4 P param 3 OxsOC0003 ta OUxDOOUStEaS short I local 3 D3 GxOO00S3fd4 unsigned long F tfuncz short i GxB0O0000T2 P param lt OxO0000Stta 0x00003 fe fahort L Loacal 2 D Z 000003 fe0 unsigned Long F funci short t 0x0000003e P param i Ox00cO3tts OxD0003E LO short L local 1 D1 000003 fec unsigned long F mariri t x000gd i L start D103 OxDO003Eta short The following items are displayed Kind Indicates the type of the symbol F Function P Function parameter L Local variable Name Indicates the symbol name Value Indicates the value address and type of the symbol Note Support for this function depends on the debugger Options Right clicking displays a pop up menu containing available options Pop up Menu Option Macro Recording Function Go to Source Go to the associated source line View Setting Specifying the Stack Trace window settings Copy Places a copy of the highlighted text into the Windows clipboard 17 16 2 Viewing the source program Select a function and choose Go to Source from the pop up menu to di
430. lling through a lot of code in the program you can go directly to a specific address REJ10J2000 0100 Rev 1 00 Jun 16 2009 306 RENESAS High performance Embedded Workshop 17 Debugging Facility Right click on the Source field or the Disassembly field and select the Set Address option The Set Address dialog box will be displayed Set Address EE Address Enter the address or label name in the edit box and either click the OK button or press the Enter key The Disassembly view updates to show the code at the new address When an overloaded function or a class name is entered the Select Function dialog box opens for you to select a function Support for this function depends on the debugger When the Disassembly window is in source mode and an address is entered which is source related but not in the currently open source file the related source file will automatically be opened in the source mode If an address is specified which is not source related Disassembly view will switch mode to disassembly mode in order to view the specified address 17 2 2 9 Modifying assembly language code You can modify the assembly language code in the disassembly view in disassembly mode or mixed mode by double clicking on the instruction that you wish to change The Assembler dialog box will be displayed Assembler Address Code 0002408 01 5F Mnemonic Panel MoL mfH 017C 8 PC A The address machine code and disassemble
431. ls gt Macros The Macro dialog box opens Select the macro file which contains the function you want to assign Select the macro function in the Macro functions list that you want to assign Click the Assign button The Macro assign dialog box is displayed Select the Assign to Menu Name check box You can now modify the macro description in the Description field This will be used as the menu tool tip if you assign the macro to menu Enter the menu name as you want it to appear on the tools menu Click OK and the menu is added to the Tools menu To assign a macro to a keyboard shortcut L i a ae a Select Tools gt Macros The Macro dialog box opens Select the macro file which contains the function you want to assign Select the macro function in the Macro functions list that you want to assign Click the Assign button The Macro assign dialog box is displayed Select the Assign to Keyboard Shortcut check box Select the keyboard shortcut you wish to assign to the macro in the drop down list Click OK and the shortcut is now available for use REJ10J2000 0100 Rev 1 00 Jun 16 2009 230 RENESAS High performance Embedded Workshop 15 Macro Recording Support Facility 15 9 Configuring the Macro tab of the Output window Shows the current records of macros You can view information such as High performance Embedded Workshop command line commands recorded into a High performance Embedded Workshop macro file from ex
432. lt this is the Workspace directory However it is also possible to set this default directory to another location REJ10J2000 0100 Rev 1 00 Jun 16 2009 129 RENESAS High performance Embedded Workshop 6 Customizing the Environment To change the default directory for new workspaces I 2i 3 6 9 Select Setup gt Options The Options dialog box opens Select the Workspace tab Enter the directory in which to create new workspaces into the Default directory for new workspaces field or browse to it graphically by clicking the Browse button Click the OK button Default directory for new workspaces ic Wwork space Browse Using an external editor The High performance Embedded Workshop allows you to use an external editor Once an external editor has been specified it will be launched when the following actions are performed Selecting a file in the Open File dialog box opened by selecting File gt Open Selecting File gt Recent Files Double clicking on a file in the Projects tab of the workspace window Double clicking on an entry in the Navigation tab of the workspace window Double clicking on an error warning in the Build tab of the output window Double clicking on an entry in the Find in Files 1 tab of the output window Double clicking on an entry in the Find in Files 2 tab of the output window Right clicking on a file within the Projects tab of the workspace window and selecting the Open lt fil
433. mage Dialog Box Window Tab Name Opened by Test Group Name Test Item Name Output Build Output Window Build tab of the Output window View gt Output Debug Output Window Debug tab of the Output window CPU Register Register View gt CPU gt Registers lO lO View gt CPU gt IO Status Status View gt CPU gt Status Memory Memory View gt CPU gt Memory Code StackTrace StackTrace View gt Code gt Stack Trace Note Test items cannot be selected when the High performance Embedded Workshop is not connected to any target 16 6 1 1 Output Build Debug Output window The following table shows information on the test image data to be saved into test image files and test results not matched Test group name Output Test item name Build Output Window Test image data to be All information in the Build tab of the output window saved into test image files Test result details Original Content of the test image file New Data in the current High performance Embedded Workshop system or in another test image file to be compared with Example Original New Building New Debug Test group name Output Test item name Debug Output Window Test image data to be All information in the Debug tab of the output window saved into test image files Test result details Original Content of the test image file REJ10J2000 0100 Rev 1 00 Jun 16 2009 238 RENESAS High performance Embedded Workshop 16 Test Suppor
434. mages have been loaded into consecutive addresses in memory as equal sized frames you can view the images by switching the frames in order To enable the function to show images as consecutive frames 1 Take either of the following ways to open the Image Properties dialog box e When the Image window is currently open right click on the window and select Properties from the pop up menu e When no Image window is open select View gt Graphic gt Image or click on the Image toolbar button m 2 Select the Enable Redraw Continuously checkbox in the Image Properties dialog box In the Frame Count edit box enter the number of frames 2 or more that you wish to view 4 Click on the OK button After this function has been enabled you can view the images by either manually or automatically switching the frames 17 4 5 1 Manually switching the frames While the function to show images as consecutive frames is enabled the pop up menu options and toolbar buttons listed in the table below are available for manually switching the frames Pop up Menu Option Toolbar Button Function Next Image ole Redraws the next image Previous Image ath Redraws the previous image Top Image 4 Redraws the top image Last Image Redraws the last image Whether the pop up menu options and toolbar buttons are active or not depends on which frame is currently displayed To manually switch the frames Clicking on Next Image goes to the next frame If
435. mal Binary Disconnect Breakpoint Hex Uctal Connect Am i 1 8 g pA Debug Run toolbar This toolbar is only available when a session is being used which has a target attached Reset CPU Goto Cursor Step In Halt lo Rezet Go Step Over Set PC to cursor Free Go Step Out Display PC ET Sl Ei EL ET OF OF be Ye REJ10J2000 0100 Rev 1 00 Jun 16 2009 4 RENESAS High performance Embedded Workshop 1 Overview System Tools toolbar You can add an external tool button to which an external tool menu has been assigned on the right to the system tool button on the toolbar as shown below Renesas ai Walker When the Standard toolbar is docked it has a Control bar as shown in the figure below If you want to move the docked Standard toolbar click and drag its Control bar to the new location The figure below shows the Standard toolbar when itis docked and also when it is floating 3 nan Debug SimSessionSH 4 wt Control bar Diocked Toolbar sts hha Debug SimSessionSH 4 Ft Floating Toolbar To dock a toolbar Select one of the following operations e Double click on the title bar of a floating toolbar OR e Drag the title bar of a floating toolbar and draw it toward an edge of a docked window menu bar toolbar or the High performance Embedded Workshop main frame on whose edge you would like to dock the window until the shape of the floating bar changes To float a toolbar Select one
436. matched symbol Content of the test image file Values set as detailed information and the range of data in the Watch window acquired with this setting Check boxes for all symbols are blank by default Data in the current High performance Embedded Workshop system or in another test image file to be compared with Failed at symbol a 6 Src long H 00002704 70000018 Dest long H 00000daa 70000018 If you double click on a test item in the Create New Test Image dialog box a further dialog box for detailed setting opens The scope for all watch items to be tested must be Auto If any other scope has been selected the items are not shown in the Symbols list REJ10J2000 0100 Rev 1 00 Jun 16 2009 244 RENESAS High performance Embedded Workshop 16 Test Support Facility Edit Test Watch Watch Sheet ham Sembol Cancel afb Curent Setting Ignore address 1 The Watch Sheet drop down list contains Watch1 Watch2 Watch3 and Watch4 Symbols shown in the Symbols list depend on the selection made in the Watch Sheet drop down list 2 Each of the symbols in the Symbols list has a check box By default the check boxes are not selected Select a watch sheet and check the boxes for symbols as required The selected symbol is shown in Current Setting 3 Select the Ignore address check box to disable comparison of the addresses of watch points The check box is not selected by default Edit Test
437. mbedded Workshop 3 Commands 3 Commands 3 1 Command List Alphabetic Order Command Name Abbreviation Description Comment ADD_FILE AF Adds a file to the current project ASSERT Checks if an expression is true or false AUTO _COMPLETE AC Switches the auto completion BUILD 1 BU Performs a build on the current project BUILD ALL 1 BL Performs a build all on the current project BUILD_FILE 1 BF Performs a build on the file BUILD MULTIPLE 1 BM Performs a build on the multiple projects and configurations CACHE 2 Sets caching on or off CHANGE_CONFIGURATION CC Sets the configuration to the specified configuration name CHANGE_PROJECT CP Sets the specified project file as the current project CHANGE_SESSION CS Sets the specified session as the current session CLEAN CL Deletes intermediate and output files produced in building CLEAR_OUTPUT_ WINDOW COW Clears the contents of the specified tab in the output window CLOSE_TEST SUITE CTS Closes the current test suite CLOSE_WORKSPACE CW Closes a workspace COMPARE_TEST_ DATA CTD Compares test data and create results CONNECT 2 CN Connects the debugger DEFAULT OBJECT FORMAT DO Sets the object format to be used by default DISCONNECT 2 DN Disconnects the debugger ERASE ER Clears the Command Line window EVALUATE EV Evaluates an expression FILE LOAD FL Loads an object program file FILE LOAD _ALL LA Loads all object program files FILE SAVE FS Saves memory to a
438. menu 2 Select Add Section 3 The Add Section dialog box appears REJ10J2000 0100 Rev 1 00 Jun 16 2009 194 RENESAS High performance Embedded Workshop 13 Map Add Section Section Hame Section Cancel k E mea 4 Enter a section name in Section Name In the tree of the left pane the new section is added under the section group subsection group or overlay group 13 1 5 Adding an overlay group In the edit mode you can add an overlay group 1 under a section group subsection group or section 2 To add an overlay group 1 Right click on a section group subsection group or section to open a pop up menu 2 Select Add Overlay Group 3 The Add Overlay Group dialog box appears Add Overlay Group Section List Sections Section Sectone Cancel E a e l x Overlay Group Name Section 4 Enter an overlay group name in Overlay Group Name In the tree of the left pane the new overlay group is added under the section group subsection group or section Notes 1 This item cannot be used when the linkage editor does not support overlay 2 Will be supported by SuperH family C C compiler package V 9 00 Release 04 and H8SX H8S and H8 family C C compiler package V 6 01 Release 02 or later 13 1 6 Automatically registering the unregistered section In the edit mode if any of the sections listed in the right pane is missing in the left pane this section can automatically be added t
439. move button REJ10J2000 0100 Rev 1 00 Jun 16 2009 280 RENESAS High performance Embedded Workshop 17 Debugging Facility To remove selected download modules using the Projects tab of the Workspace window 1 Select the download modules that you want to remove in the Projects tab of the Workspace window Multiple download modules can be selected by holding down the SHIFT or CTRL key 2 Select one of the following operations e Select Remove from the pop up menu opened by right clicking OR e Press Delete key 3 A confirmation dialog box opens for you to select whether or not to remove the selected download modules from the project To delete the selected download modules select Yes Otherwise select No or Cancel If you do not wish to open this confirmation dialog box select the Don t ask this question again checkbox To open this dialog box again select Setup gt Options to open the Options dialog box Select the Remove download module s from project checkbox on the Confirmation tab By default this checkbox is selected To change the order of a module to be downloaded to the target 1 Open the Debug Settings dialog box 2 Select a module in the Download modules list and click the Up or Down button Any changes made in the Debug Settings dialog box are only changed when you click OK 17 1 5 2 Downloading modules Download the object program to be debugged To download modules Select one of the following operations
440. mparison Then select some test items to be saved a test image file Acquire and save test image of the selected test items which you wish to use for comparison After completion of the test macros the selected test items are compared The result is displayed in the test browser window If there is any difference between the test result and the saved the test image file the result of the test item is shown as FAIL You can view the details of the error by double clicking the line of this test item Test Browser Ba J Test Name Description Result I TEST A Load and Reset and Step FAIL Aoo ef Component Result Details Reel CPU Mernory SimSessionSH 4 FAIL H Failed in memory range UxQO000000 x Q REJ10J2000 0100 Rev 1 00 Jun 16 2009 23 2CENESAS High performance Embedded Workshop 1 Overview 1 14 1 Example of test procedures This page introduces an example of test procedures which is a sequence through build and debugging using the macro recording support facility and test support facility This example uses a program that sorts ten random data items written in C language which are typically included in the Tutorial project in an emulator debugger or in a project for which Demonstration has been selected as the project type in the SuperH family simulator debugger in ascending descending order This example lets you see a difference in data stored in an array 66
441. n View source Views the source code for the address in the selected line Print Prints section list view lin Os al a 13 1 2 Entering exiting the edit mode To edit the section information shown in the left pane the High performance Embedded Workshop must enter the edit mode By default the edit mode is not selected To enter the edit mode 1 Right click within the left pane to open a pop up menu 2 Select Section Edit Mode This allows the High performance Embedded Workshop to enter the edit mode 3 There is a tick mark on Section Edit Mode While the High performance Embedded Workshop is in the edit mode the options listed in the table below are available Right click on an item in the left pane The following options with in the table can be selected Pop up Menu Option Toolbar Item Button Root Address Section group Subsection group Overlay group Section Add Section Group ag na p p p p p Add Section 4 p p p be i Add Overlay Group 1 ae ie ie W x0 Section Auto Registration i ie if i i Edit Selected Item ria ie be i i Cut ah ie be i Copy W W w Paste A p p i i Delete x be i be Move up t ie Move Down F p Change Primary Section 1 GP p Notes 1 This pane cannot be used when the linkage editor does not support overlay 2 Will be supported by SuperH family C C compiler package V 9 00 Release 04 and H8SX H8S and H8 family C C compiler package V 6 01 Release 02 or later To exi
442. n either of these actions is performed the associated commands are executed and the output is displayed in the Version Control tab of the output window To execute a command by a version control menu option or toolbar button 1 Select the items to which you want to apply the version control command from the Projects tab of the workspace window This may include a workspace projects folders and files Right click to invoke a pop up menu You can select a menu option you have defined from the Version Control submenu A command associated with this menu option will be executed on the files contained in the workspace project or folder or file itself selected in the workspace window 2 For example if you select the workspace icon all of the files in all of the projects will be passed to the version control command this will include any High performance Embedded Workshop system files 3 Select the required menu option from the Tools gt Version Control sub menu or click the desired version control toolbar button The custom version control support allows you the highest degree of flexibility in specifying how a version control system is to be used To configure it select Tools gt Version Control gt Configure The Version Control Setup dialog box opens REJ10J2000 0100 Rev 1 00 Jun 16 2009 137 RENESAS High performance Embedded Workshop 8 Custom Version Control System Commands Projects General System menu opti
443. n octal Bin E Data is displayed in binary Code ASCII dbc Displays memory data as ASCII characters default SJIS Not supported JIS UNICODE UTF 8 UTF 16 EUC Float Float ati a memory data as single precision floating point values Double d Displays memory data as double precision floating point values Complex Float Complex Ta Displays complex numbers as single precision floating point values Double Complex da Displays complex numbers as double precision floating point values Float Imaginary fI Displays imaginary numbers as single precision floating point values Double Imaginary AI Displays imaginary numbers as double precision floating point values Fixed 16bit Fixed 16 Displays memory data as 16 bit fixed 32bit Fixed 3 Displays memory data as 32 bit fixed 24bit Accum Displays memory data as 24 bit accumulate 40bit Accum Displays memory data as 40 bit accumulate Layout Label m Switches display or non display of Label area Register P Switches display or non display of Register area Code Switches display or non display of Code area Column T gt Changes the number of digits displayed Coverage 1 Enable cB Switches display or non display of measurement result Save D Saves memory contents in a file Load pe D Loads a memory area contents from a file Split Splits up the window display Toolbar display Shows or hides the toolbar Customize toolbar
444. n the Memory window Choosing Go To Memory from the pop up menu opens the Memory window If you drag an item in the Watch window and drop it into the Address column of the Memory window the address of the watch item will be the first address shown in the Memory window Drag and drop Memory SIM_ID x 0 11222244 TFooOoO0 m 0 nogoooo0 noOooooOoo OOOO OOOO ooOo Oooo oo a 4 noodoood t nogooood BOCIT Ta H 1 Dogsso0z 40094001 D1l02201C REE TET faa 1 Hiogogooog i TFrOQ long k 00090000 FFFFFFD4 ooo00ns4 oooooooo a Zz H ooogoo00 i TFOGOOOe ilong E ddadda d onoooooo jee 2 H o0000000 i TFOGGOOC ilong d L jeee 4 H oogaaa00 i TFo00010 ilong bess 5 H o0000000 FFOG0014 ileng fesse E H oogaaaaa i TF00001S ilong fesse 7 H oggaaa0da i TFoGGg1c long Besse 8 H oggaaa0a i TFo000ZO long Besse 9 H ooggaaa0a i TFo000Z4 long address TI Watchi A tiatche f watchs f atch ll 2244 oON000000 ooo00000 ogopgog noodoooo If two or more watch items with the same name are assigned to different scope the Memory window shows the memory area that can be watched from the address indicated by the program counter REJ10J2000 0100 Rev 1 00 Jun 16 2009 372 RENESAS High performance Embedded Workshop 17 Debugging Facility 11 Setting real time update The
445. n the range Note Subsequent find operations will find strings only in the paged disassembly area not the complete range 17 2 1 8 Saving disassembly text The contents of the disassembly view can be saved by using the Save Disassembly Text menu from the Disassembly field in disassembly mode pop up menu When Save Disassembly Text is selected the Save Disassembly Text dialog box is displayed that asks you the range of addresses to save Save Disassembly Text Ei Ei Start Address ooonzo00 End Address ooon2014 Bl Cancel Filename Browse REJ10J2000 0100 Rev 1 00 Jun 16 2009 301 RENESAS High performance Embedded Workshop 17 Debugging Facility Both a start and end address should be supplied You also need to specify the full filename to save the information to If needed you can browse to the file to use Click OK 17 2 1 9 Printing the disassembly view The disassembly view can be printed by using File gt Print or the Print toolbar button S when it is in focus or by using the menu Print on the Disassembly field in disassembly mode pop up menu When Print is selected the Disassembly Print Range dialog box is displayed that asks you the range of addresses to Disassembly Print Range ki Ed Start Address ooooz000 End Address 00002014 Jaj a print Both a start and end address should be supplied Clicking OK on this dialog box then passes the print selection to the standard print fo
446. name including full path FILEDIR File directory FILENAME Filename excluding path including extension FILELEAF Filename excluding path and extension EXTENSION File extension WORKSPDIR Workspace directory WORKSPNAME Workspace name PROJDIR Project directory PROJECTNAME Project name CONFIGDIR Configuration directory CONFIGNAME Configuration name HEWDIR High performance Embedded Workshop installation directory TCINSTALL Toolchain install directory on the options setting dialogs and the New Build Phase dialog step 3 TOOLDIR Tool installation directory Tools Administration TEMPDIR Temp directory WINDIR Windows directory WINSYSDIR Windows system directory EXEDIR Command directory USERNAME User login Version control REJ10J2000 0100 Rev 1 00 Jun 16 2009 408 RENESAS Expanded placeholder example c workspace project file src c workspace project file src file src c workspace workspace c workspace project project c workspace project debug debug c Program Files Renesas Hew c Program Files Renesas Hew Tools Renesas Sh 9_ 0 1 1 c Program Files Renesas Hew Tools Renesas Sh 9_0 1 1 c temp c windows c windows system v ve win32 JHARK High performance Embedded Workshop 5 Placeholders PASSWORD User password Version control 214436 VCDIR Virtual version control directory c project is mapped to x vc pr
447. nce Embedded Workshop 2 Build Basics Remove Project Files OK Ei Cancel Hemose Froject files DemoSH4 c Co Workspace D emoSH4 DemoSH Intprg src C Workspace emoSH44 DemoSH lowly sre Co WYorkepace DemoSH44 0 emoaSH lowerc c C Wrorkspace D emoSH4 DemoSH reselprg c C Wrorkspace D emoSH4 DemoSH sbrk c Co WYorkepaceDemoSH44 0 emoSH Remove All wecttbl sre C Workspace D emoSH4 DemoSH vhandler src C Wrorkspace D emoSH4 DemoSH To remove selected files from a project using the Projects tab of the Workspace window 1 Select the files that you want to remove in the Projects tab of the Workspace window Multiple files can be selected by holding down the SHIFT or CTRL key 2 Press Delete A confirmation dialog box opens for you to select whether or not to delete the selected files from the project To delete the selected files select Yes Otherwise select No Confirmation Request Ei J e pou sure you want to delete these files from the project l T Don t ask this question again If you do not wish to open this confirmation dialog box select the Don t ask this question again checkbox To open this dialog box again select Setup gt Options to open the Options dialog box Select the Delete file from project checkbox on the Confirmation tab By default this checkbox is selected 2 3 4 Excluding a project file from build A file in a project can be excluded from build on a config
448. nches the wizard you have selected to guide you through the creation process Note It is not possible to create a workspace if one already exists in the same directory 1 6 Opening a workspace To open a workspace 1 Select Browse to another project workspace option from the Welcome dialog box and click the OK button or select File gt Open Workspace The Open Workspace dialog box will be displayed 2 Select the workspace file HWS file that you want to open Click the Select button to open the workspace If the High performance Embedded Workshop is set up to display information when a workspace is opened the Workspace Properties dialog box will be displayed Otherwise the workspace will be opened Note that whether the Workspace Properties dialog box is shown depends on the setting of either the Show workspace information on workspace open check box in the Workspace Properties dialog box or the Display workspace information dialog on opening workspace check box on the Workspace tab of the Options dialog box The Options dialog box can be invoked via Setup gt Options Click the OK button in the Workspace Properties dialog box to open the workspace Click the Cancel button to stop opening the workspace M Show workspace information on workspace open The High performance Embedded Workshop keeps track of the last workspaces that you have opened and adds them to the File menu under the Recent Workspaces submenu This gives y
449. nd ossein eon eN r ERE RERE EE NEESER S 424 REJ10J2000 0100 Rev 1 00 Jun 16 2009 IX RENESAS High performance Embedded Workshop 1 Overview 1 Overview The functions for High performance Embedded Workshop are explained in this manual This chapter describes the fundamental concepts of the High performance Embedded Workshop 1 1 Workspaces projects and files High performance Embedded Workshop has a concept of Workspace and Project e Workspace Workspace is a largest unit when you make the program with High performance Embedded Workshop Workspace can have several projects When you create a workspace more than one project is needed and one project is automatically made when you create the workspace e Project s When you make the program sometimes you make a certain function as a library and make hierarchical levels between several modules In such cases you can also create the library project and insert it to a workspace WORKSPACE 1 2 Main window There are three main windows the workspace window the editor window and the output window The workspace window shows the projects and files that are currently in the workspace the editor window provides file viewing and editing facilities and the output window shows the results of a various processes e g build version control commands and so on REJ10J2000 0100 Rev 1 00 Jun 16 2009 1 RENESAS High performance Embedded Workshop 1 Overview
450. ndow i eg i Workspace Ag utorial El Ty Tutorial Assembly source file ra se source file se intpresre re Intpre src vecttblerc o E vecttbl src vhandler zre E vhandlerere source file G source file LE dbsete E dbsctc n resetpre c E resetpre c a Projects sOrk c When the Workspace window or the Output window is docked it has a control bar as shown below If you want to move a docked window click and drag its control bar to the new location Close button a Control bar To dock the Workspace window or the Output window 1 Ensure that the Allow Docking option is checked on the window s pop up menu 2 Select one of the following operations e Double click on the title bar of a floating window OR e Drag the title bar of a floating window and draw it toward an edge of a docked window menu bar or toolbar or the High performance Embedded Workshop main frame on whose edge you would like to dock the windows To float the Workspace window or the Output window 1 Ensure that the Allow Docking option is checked on the window s pop up menu 2 Select one of the following operations e Double click on the control bar of a docked window OR e Drag the control bar of a docked window and draw it away from the edge of the High performance Embedded Workshop main frame and from an edge of the other docked windows menu bar or toolbar e Drag the control bar of a docked window wh
451. ned in the editor window can be edited e When debugging and stepping through source code each source file which contains the current PC address will be opened in a separate window as you step through code from one file to another When stepping into an area of disassembly that has no associated source code line the source mode will switch to disassembly mode Disassembly Window e Any source file opened in the Disassembly window is read only and cannot be edited The Disassembly window pop up menu will contain a menu item to open the current file for editing e When debugging and stepping through source code the Disassembly window will automatically switch to the relevant source file which contains the current PC address making this simple for you when debugging Whilst the Disassembly window is open there will be no standard editor windows opened the source files will be opened within the Disassembly window view as necessary When stepping into an area of disassembly that has no associated source code line the source mode will switch to disassembly mode e You can use disassembly source mode as primary debug view If this facility is available the following actions will be performed e If the Disassembly window is open and in Disassembly mode then when a break occurs at a known source address the Disassembly window will switch to source mode e If the Disassembly window is open then when a break occurs no other editor windows are o
452. nedgeatecoeuassanedoasdannieageosudsoitonoeeas 198 r y WO CALC ARC AG a E E E E EEA E 198 BLIS Viewing SEC OIG OTsSiZe oe scares tnce rane snce ca Eo Ea eOr Eiaa 198 13 1 14 Viewing the source code for the Address sssccccissoccesaccoascedvcnasosaseuadsetsewancessevandedecusasuasecebicdscennoedsewatnensnauaseeys 198 13 1 15 Printing out the SECHOMTISE nrdscsxsnasentsiinadentttotientasandaaashedtenbiinndsntsstadaonisenndent shestnndsanasantieammcbiaalennsdeddsnisanavaatinnn 199 HZ Vows Sy MONS senie RESE E REESE E 199 13 2 1 Opening the Map Symbol Information WindOw ccccccccccccccceeceesssseeseseeecceeeeeeeeeaaaaaaesneeeeeeeeeeeeeeeeeaqaaaaas 199 322 SATIS map isieerssen n A E OE EEEn EEEE E 201 13 2 3 Finding symbols csersaeei a a E E 201 13 2 4 Filtering the symbol information ssssseeeeeeeeeeeeennnennnnsnnceaeceeeceeeeeeeeceeeeeeeeeeeeeeeeeeeeeeeeeeeeceeeeeeeeeeeeeees 201 13 2 5 Viewing the source code for the address ccccsccceccececccccceeeeesesssesseeeeeeceeeeeeeeeeaaaaeeeesseeeeeeeeeeeeeeseeeeeaaaas 202 13 2 6 Printing out the symbol information cccccccccccccccceeeeeceeeeseeseseeeeeceeeeeeeeeaaaaseesesseeeeeeeeeeeeeeeeseuaaeagsaesnsnes 203 E E Ea ANG E i E E T T E E E A A E N 204 14 1 Opening the Command Line Window seseeeeessssssssssssseeeereerrssssssssssssseetereressssssssssssssseesetreeeossssssseeseeeeeeeeeesssesss 204 MR e A INS A A E T T E E A A E ENE 207 Ao E a E a E E AE ert E E TE Teeter 2
453. new users 1O INES VST CIM ei ersaszzsonncaadezsniensne qu awsadiwasnidsnncnnecabognvecsnalasesuat vnasnsionneaameusnnasbequandhensekoanedeseetabaneeeesnacs 175 10 5 Changing your password sores ne neces sgaananraesannnteeetonapesoawaeciessnesaadanaecet ogeceasna auausenaasnensne camontboqanatnns sumvesanuinnesseenmmeneneasnacs 176 10 6 Note on using the network facilities to share Projects ccccsssssssesssesseseeeccceeeeeeeeeeesaessesseeeeeeceeeeeeeeeeaeseeaaaaegesnees 176 LE COMMA AUT CS aoe ceeatee caters es T E snes ses toes astannecoseuscoaassaneecsousiecaassacete 178 11 1 Opeming the Difference Widow ocisscasssssncrsccaostacesascane saaasenannsanananncoreasmucoanaabatdesaanusantannesedeangignasgadaniancastaiestacssameennns 178 Ze INAV ALO E aa a E R E EA E E R AR 181 12 1 C function and define navigation component ccc cccccccccceeseesssseesessseseeececeeeeeeeeeaaaasessseeeeeeeeeeeeeeeeeeaaeeeaaaageessess 183 12 2 C navigation component eseeessssesssssseeseteeeeessssssssssseeecrreeeossssssssssececrrrerrssssssssssseecrteeeressessssssssssseeeeereeeeesseess 183 12 3 Jump to a definition from the editor nnnnennnsesssessssssssseeteersssssssssssssssesseerrrerrssssssssssssserrerrrrssssssssssssssssseereeeeessesss 185 REJ10J2000 0100 Rev 1 00 Jun 16 2009 iv RENESAS High performance Embedded Workshop Contents jE Sa Dr anditop navi aon ETS eriin Treen tem Tne er ecm reer cnn emer E amy neta ne mente nner remy Tree no
454. nfigurations to which you want to add a download module Click the Add button The Download Module dialog box is displayed All fields must be setup for the download module to be configured correctly REJ10J2000 0100 Rev 1 00 Jun 16 2009 279 RENESAS High performance Embedded Workshop 17 Debugging Facility 10 11 Offset i i Fi File format EDwat O Cancel Filename CONFIGDIR S PROJECTNAME abs Browse ACCESS SIZE ho F Download debug information only T Perform memory verify during download T Download automatically on target connection The Offset field specifies the memory address offset the module will be loaded at It defaults to O After the module has been added the offset value is shown on the right of the module name in the Debug gt Build submenu the Download modules folder on the Projects tab of the workspace window and the File gt Recently Download Module submenu The File format drop down list box contains a list of supported object format The file format of the download module is selected here So this does not have to match the debug format on the Debug Settings dialog box However the Stack Trace window will be supported for instance depending on the format specified in the Debug format field The Filenames field can be specified with placeholders or as an absolute setting It is recommended to use placeholders The Access size field specifies the access size when the mem
455. ng 10 Auto item oo E nogoo0oo FFOOOOOO long Child fi BOL H o0000000 7F000004 long tem ve R 2 H ooo00000 7Fo00008 long A 3 H o0000000 7FO00000C long E 4 H o0o00000 7F000010 long BOS H ooooo000 7F000014 long E 6 H ooo00000 7F000018 long R 7 H o0000000 7FO00O01C long oA 8 H o0o00000 7F000020 long E 9 H o0000000 7FO000024 long ae R Watch Item 2 0 H o0000000 TFOO00Z8 longi Auto AE watcha Mame of a watch item Value and assigned location Type Scope The assigned location if enclosed by 7 e This window shows data only when the debugging information available in the load module abs includes the information on the C C source program No data is shown in the window if information on the source program is excluded from the debugging information due to optimization by the compiler No variables declared as macros also can be displayed e Each variable can be dragged from the Editor or Disassembly window and dropped into the Watch window e The order of the watch items can be changed by dragging and dropping items onto desired positions e If you drag an item in the Watch window and drop it into the Address column of the Memory window the address of the watch item will be the first address shown in the Memory window e The R mark indicates that the value of the variable can be updated while the user program is running When a value is marked with
456. ng the column header 1 Right click within a field in the editor window showing source or disassembly codes 2 A pop up menu opens Select Turn Header On Off REJ10J2000 0100 Rev 1 00 Jun 16 2009 106 RENESAS High performance Embedded Workshop 4 Editor 4 17 Opening a file within the editor The High performance Embedded Workshop allows you to open a file within the editor window To open a file shown in the editor window 1 Right click on the file name in the Source field in the editor window Source inc lude hemes inc lude Fstackeact h Open typedetine H define SR Init 0x000 2 Select Open lt file name gt from the pop up menu 4 18 Tooltip watch Use this function to know the value of a variable defined in the source program Open the editor window or disassembly window in source mode to view the source program and rest the mouse cursor over the variable name that you want to examine A tooltip pop up window will appear showing the watch information To use Tooltip watch 1 Select Setup gt Options The Options dialog box opens 2 Select the Editor tab 3 Check the Enable tooltip watch check box 4 Click OK W Enable tooltip watch To view a tooltip watch on the editor window or disassembly window in source mode 1 Open the editor window or disassembly window in source mode showing the variable that you want to examine 2 Rest the mouse cursor over the variable name that you want t
457. ng the primary section In the edit mode you can set a selected overlay group as the primary section To set the primary section 1 Right click on an overlay group in the left pane to open a pop up menu 2 Select Change Primary Section In the tree of the left pane the selected overlay group is set as the primary section Note This function cannot be used when the linkage editor does not support overlay REJ10J2000 0100 Rev 1 00 Jun 16 2009 196 RENESAS High performance Embedded Workshop 13 Map 13 1 9 Setting a memory map While the High performance Embedded Workshop is connected with a debugger you can set a memory map To set a memory map 1 Right click within the left pane to open a pop up menu 2 Select Memory Map Setting 3 The memory map setting dialog box opens The current mapping of the address space is shown as a list Set a memory map or memory resource as necessary 4 Click the OK button Support for this function depends on the debugger 13 1 10 Automatically allocating the memory resource When there is a linkage list file map output by the linkage editor the memory resource can be automatically allocated according to the memory map and linkage map information While the High performance Embedded Workshop is connected with a debugger you can allocate a memory resource To automatically allocate the memory resource 1 Right click within the left pane to open a pop up menu 2 Select Memory Resou
458. nges after a build 17 17 2 Configuring the PD debugger to integrate with High performance Embedded Workshop The following details the information required to setup the PD debugger to integrate with High performance Embedded Workshop and launch from the external debugger option in High performance Embedded Workshop REJ10J2000 0100 Rev 1 00 Jun 16 2009 355 RENESAS High performance Embedded Workshop 17 Debugging Facility External debugger selected sas P debugger Debugger settings PO debugger location PD Browse PO profile file location Po Browse Command line options Po Download module Pb Browse To configure the PD debugger to integrate with High performance Embedded Workshop L Firstly the location of the debugger executable must be specified This may have been configured by the installation program or a project generation utility The second item of data is the profile file This tells the debugger which profile file to load when it is launched This file stores the debug setup information The third item of data is the command line options This field allows additional options to be specified which can modify the behavior of the external debugger Finally the location of the download module is required This allows the High performance Embedded Workshop to automatically switch to the debugger when the download module changes after a build 17 17 3 Configuring an external
459. ning a template To define a template 1 Select one of the following operations to display the Define Templates dialog box e Click the Define Template toolbar button als OR e Select Edit gt Templates gt Define Templates OR e Right click on the Templates in the Templates tab of the workspace window and select Edit from the pop up menu OR e Right click in the editor window and select Templates gt Define Templates from the pop up menu REJ10J2000 0100 Rev 1 00 Jun 16 2009 102 RENESAS High performance Embedded Workshop 4 Editor Define Templates shortcuts EJ 2 Click the Add button The Add Template dialog box is displayed which asks you to enter your chosen template name This name must be unique otherwise a duplicated template name message will be displayed and the template will not be added 3 If you want to modify an existing template use the Template Name drop down menu to select which template you want to modify 4 Enter the desired text into the Template Text area You can copy text from another Editor window and then paste it into this dialog box using CTRL V 5 Enter the following placeholder to insert special information when the template is inserted Menu Entry Placeholder Replaced With File path name FULLFILE Filename including full path File name FILENAME Filename excluding path including extension File leaf FILELEAF Filename excluding path and extension Worksp
460. nly when the Use external editor checkbox is selected in the Editor tab of the Options dialog box opened via Setup gt Options Right clicking on the Download modules folder opens a pop up menu containing the available options Available when the debugger is connected Pop up Menu Option Macro Recording Function Download all module a Downloads all modules in the Download modules list on the Target tab of the Debug Settings dialog box i e download modules shown under the Download Modules folder in the Projects tab of the workspace window Download A New Module C Opens the Download Module dialog box which allows you to add download modules Debug Settings Opens the Debug Settings which allows you to modify the debug settings Configure View Configures the workspace view Right clicking on a download module opens a pop up menu containing the available options Available when the debugger is connected Pop up Menu Option Macro Recording Function Download C4 Downloads modules Download Debug Data Only ca Downloads modules debug data only Unload W Unloads modules Download A New Module W Opens the Download Module dialog box which allows you to add download modules Remove Removes the selected modules REJ10J2000 0100 Rev 1 00 Jun 16 2009 37 RENESAS High performance Embedded Workshop 2 Build Basics Debug Settings Opens the Debug Settings dialog box which allows you to modify the debug settings Configu
461. not set then only the memory views in the local Debugger will update when memory is changed If memory is shared between Debuggers a manual refresh will need to be performed in the memory related windows of the other Debuggers in order for them to display the correct memory Memory is usually only shared between Debuggers when debugging a multi core platform If memory is not shared between Debuggers e g when debugging several single core platforms then actions in one Debugger cannot change the memory in another so the state of this check box is not important 18 1 5 Synchronized debugging mode Synchronized debugging mode Parallel ntermal Farallel Select the mode to be used while Debugging Internal The specified Debuggers will be opened in one High performance Embedded Workshop application This mode is only available when all the Debugger s Session s are in the same High performance Embedded Workshop workspace Parallel The specified Debuggers will be opened in separate High performance Embedded Workshop applications Note The Internal mode option will only be available if all the sessions in the Available Debuggers list are from the same workspace It is not possible to use the Internal mode option when sessions from separate workspaces are selected 18 1 6 Start synchronized debugging Once the synchronized debug configuration has been set up click the Sync button to begin debugging If Parallel mode ha
462. nt C Sets or clears a software breakpoint at the line showing the address Enable Disable Breakpoint he Enables or disables the current software breakpoint Turn Header On Off Shows or hides the column header Define Column Format Sets the status of editor and disassembly columns Columns Column name Sets the status of editor and disassembly columns Instant Watch Launches the Instant Watch dialog box with the name extracted from the view at the current text cursor not mouse cursor position Set Address Enters a new start address Go To Cursor CI Starts executing the user program at the current PC and continues until the PC equals the address indicated by the current text cursor not mouse cursor position Set PC Here D Changes the value of the PC to the address at the row of the text cursor not mouse cursor Display PC Opens the source file or disassembly at the address of the PC Properties Displays file properties Note Support for this function depends on the debugger 17 2 2 2 Opening a source file for editing The Disassembly source mode allows only to view and debug source files and no editing is permitted from within this view To edit a source file that is currently open in the Disassembly source mode view the pop up menu option Open Source File for Editing must be selected This will open an editor window containing the file for editing Alternatively you may open the file for editing manually via the Work
463. nt to a source file mixed mode Instead of showing the continuous disassembly it shows the disassembly that is related to each line of source code This view can be edited the assembly language code and is only available when the module is downloaded This view allows breakpoints address object codes labels and disassembled codes to be viewed Disassembly mode The disassembly mode shows the true continuous disassembly code in address order This view can be the assembly language code and is only available when a target is attached to the session This view allows breakpoints address object codes labels and disassembled codes to be viewed 17 2 2 1 Viewing the code When switching to the source mode from within the disassembly window the source file relating to the current PC address will be opened if available Otherwise either the most recently open disassembly window source file will be re opened where possible or a prompt will be given to select a source file to be opened Any text based files may be opened in the disassembly window and not just project source files Any source file opened in the disassembly window is read only and cannot be edited it is only intended for the viewing and debugging of source files This view is only available when the module is downloaded Window configuration a Disassembly DemoSH4 c Of x Yiew mised mode mL EEE OO View coc Agl View Disassembly Column Source Address 5 yf hea
464. nto the Category Title field Click the OK button to add a keyword group To modify the name of the group Select the keyword group and click the Modify button underneath the tree Modify Category dialog box then opens Enter the name of the group into the Category Title field To remove a keyword group from the tree select the keyword group and click the Remove button underneath the tree REJ10J2000 0100 Rev 1 00 Jun 16 2009 100 RENESAS High performance Embedded Workshop 4 Editor Add Category Ei Category Title To create new keywords 1 Select Setup gt Format Views The Format Views dialog box opens 2 Select the desired keyword group to be modified 3 Click the Keywords tab Color Font Keywords Comments break Case catch p continue SMEs 4 Click the Add button to add a keyword Then the Add Keyword dialog box opens Specify a keyword in the Keyword field and click the OK button to close the dialog box To remove a keyword from the Keywords list select the keyword and click the Remove button Add Keyword Ei Note On the Keyword field of the Add Keyword dialog box specify a keyword which consists of only alphanumeric an underscore and the character 4 10 3 Enabling disabling syntax coloring To enable disable syntax coloring 1 Select Setup gt Options The Options dialog box opens 2 Select the Editor tab 3 Set the Enable syntax coloring checkbox as necessary and t
465. nto the group folder of the file type e g a file main c is added into the group folder C source file If a suitable group folder does not exist the High performance Embedded Workshop creates it Files of an unknown type dropped onto the project are directly added to the project By default this checkbox is not selected Clicking the Uncheck All button deselects all checkboxes while clicking the Check All button selects all checkboxes Clicking the OK button adds all selected files which have tick marks in their checkboxes to the project Next time this dialog box is opened it shows the most recently used setting Removing files from a project There are three ways of removing files from a project Files can be individually removed from a project A selection of files can be removed All files can be removed To remove a file s from a project L Select one of the following operations to open the Remove Project Files dialog will be displayed Select Project gt Remove Files OR Right click on the project within the Projects tab of the workspace window and select Remove Files from the pop up menu Select the file s that you want to remove from the Project files list Click the Remove button to remove the file s or click the Remove All button to remove all files from the list Click the OK button to remove the files from the project REJ10J2000 0100 Rev 1 00 Jun 16 2009 41 RENESAS High performa
466. nu options This is shown below REJ10J2000 0100 Rev 1 00 Jun 16 2009 213 RENESAS High performance Embedded Workshop 15 Macro Recording Support Facility Macros Record Macro gt Play Macro le Stop hacia A Build Macro functors D load ee associated Memory_fill with menu options Reset CPU Items that also have an associated toolbar have their icons displayed alongside the menu options The standard buttons on the Macros toolbar are shown below Play Macro Pause Macro Record waco Stop Macro C u U e The Record Macro button starts the macro recording process After this button is clicked debugging and High performance Embedded Workshop management operations are recorded This operation is the same as the Record macro menu on the Tools menu e The Play Macro button starts a macro function playback If more than one macro is defined the select macro function dialog is displayed to ask you to select specific macro for playback e The Pause Macro button is only enabled when recording or playing back a macro function This pauses the current operation so that you can return to it later e The Stop Macro button is only enabled when recording or playing back a macro function This halts the current macro operation that is being carried out In the same way you can associate macros with a menu you can associate them with a toolbar When you associate the macro you can decide to use a user defined toolbar icon
467. nu will allow the window contents to be refreshed while the user program is running REJ10J2000 0100 Rev 1 00 Jun 16 2009 332 RENESAS High performance Embedded Workshop 17 Debugging Facility To specify the refresh interval select Update Interval from the pop up menu This item is only selectable when it is supported by the debugger 17 5 3 Refreshing the Waveform window Selecting Refresh Now from the pop up menu immediately refreshes the window contents 17 5 4 Specifying the refresh interval You can specify the interval to refresh the Waveform window while the user program is running Support for this function depends on the debugger To specify the refresh interval 1 Right click within the window to open a pop up menu 2 Select Update Interval The Update Interval dialog box opens Update Interval ed Interval 10 10000rnisec 10mzec unit fioo mzer Cancel 3 Specify the refresh interval in 10 ms units The refresh interval is specifiable in the range from 10 to 10000 ms and the default value is 1000 ms The specified refresh interval is applied to all Waveform windows The actual refresh interval may be longer than the specified value depending on the state of execution 17 5 5 Zoom in display Selecting Zoom In from the pop up menu displays the waveforms with the horizontal coordinate enlarged 17 5 6 Zoom out display Selecting Zoom Out from the pop up menu displays the waveforms with t
468. o examine A tooltip will appear near the variable containing basic watch information for that variable Source Sorta printt Sorting results fori 1 0 1410 itt jf printf altd sld n 1 a4 uin alO max llong 0 70000000 mirn nax change a Wak afO REJ10J2000 0100 Rev 1 00 Jun 16 2009 107 RENESAS High performance Embedded Workshop 4 Editor 4 19 Evaluate an expression Launches the Evaluate dialog box allowing the user to enter a numeric expression e g 205 2 and display the result in all currently supported radices To evaluate an expressions 1 Select Edit gt Evaluate The Evaluate dialog box opens 2 Enter the expression that you wish to evaluate and click the Evaluate button Provides a calculator function evaluating simple and complex expressions with parentheses and symbols All operators have the same precedence but parentheses may be used to change the order of evaluation The operators have the same meaning as in C C Expressions can also be used in any command where a number is required The result is displayed in all supported radix types Valid operators Addition Subtraction Multiplication Division Logical AND amp amp Logical OR Logical NOT Equal to Bitwise AND amp Bitwise OR Bitwise NOT Unequal to Left arithmetic shift lt lt Right arithmetic shift gt gt Less than lt Greater t
469. o gt If the top module is selected the Move to top and Move up buttons will be disabled If the bottom module is selected the Move to bottom and Move down buttons will be disabled The current linkage order can be saved in a text format You can modify the linkage order saved in the file and load it to apply the new linkage order To load the linkage order from a text file 1 Click Build gt Linkage Order The Linkage Order dialog box opens 2 Select the Use custom linkage order check box 3 Click on the Import button The Import Linkage Order dialog box opens 4 Choose a file and click on the Select button The Linkage Order Import Report dialog box opens 5 To load the linkage order saved in the file click on the Continue button The listbox will be updated with the new linkage order Note This will overwrite your current linkage order 6 Click on the Cancel button to close the dialog box without modifying your current linkage order REJ10J2000 0100 Rev 1 00 Jun 16 2009 84 RENESAS High performance Embedded Workshop 3 Advanced Build Features To save the linkage order in a text file l 2 as 4 Click Build gt Linkage Order The Linkage Order dialog box opens Select the Use custom linkage order check box Click on the Export button The Export Linkage Order dialog box opens Choose a file and directory and click on the Save button The current settings in the list box are saved in the specified text file
470. o the left pane REJ10J2000 0100 Rev 1 00 Jun 16 2009 195 RENESAS High performance Embedded Workshop 13 Map To automatically add missing sections 1 Right click within the left pane to open a pop up menu 2 Select Section Auto Registration e If some sections are missing in the left pane and the right pane includes a section group whose address value is smaller than the smallest address among the missing sections all of these sections will be added to the last in the section group e If some sections are missing in the left pane and none of the addresses of section groups listed in the right pane is smaller than the smallest address among the missing sections all of these sections will be added as a section group at the smallest address among the missing sections Note If an overlay section is missing this will be added as a normal section 13 1 7 Editing a selected item In the edit mode you can also modify the address value and the name of a section group subsection group overlay group or section To modify the selected item 1 Select either of the following operations e Right click on an item in the left pane to open a pop up menu Select Edit Selected Item OR e Double click to modify a value 2 The Edit Selected Item dialog box appears Enter a string or integer value into an edit field Edit Selected Item Section Start Address dij Cancel Section Group Hamne AST Handler 13 1 8 Setti
471. o the new view Three different modes are possible these are listed below Mode Function Source mode This mode is the standard High performance Embedded Workshop editor It allows source file editing and keywords are highlighted correctly if you are viewing source files This view allows line numbers addresses breakpoints bookmarks and source codes to be viewed Mixed mode The mixed mode facility in a source file is different to the disassembly window mixed mode Instead of showing the continuous disassembly it shows the disassembly that is related to each line of source code This view cannot be edited and is only available when the module is downloaded This view allows line numbers breakpoints address object codes labels and mixed codes for showing both source and disassembly to be viewed Disassembly mode The disassembly mode shows the true continuous disassembly code in address order This is the same as clicking View gt Disassembly This view is only available when a target is attached to the session This view allows breakpoints address object codes labels and disassembled codes to be viewed Notes It is not possible to switch from the source view to the mixed display under the following conditions 1 The target is not connected to the current session 2 No download modules have been downloaded 3 No debug information is available for the current project 4 The currently displayed file has been edited and the c
472. odifying the contents or re open the file 4 14 Preventing modification of files while debugging Use this option if you wish to prevent modification of files while debugging with High performance Embedded Workshop and a debugger connected This prevents modification of all files that are open in the High performance Embedded Workshop editor To prevent modification of files while debugging 1 Select Setup gt Options to open the Options dialog box 2 Select the Editor tab 3 Selecting the Do not allow file editing when target is connected checkbox prevents modification of files while the High performance Embedded Workshop is connected to a debugger In other words if the High performance Embedded Workshop is not connected to a debugger files can be modified By default this checkbox is not selected 4 Click OK 4 15 Managing the editor columns The editor in High performance Embedded Workshop has the ability to manage columns apart from the main editor column These can be added and used by any component in the High performance Embedded Workshop system Examples of this functionality might include a hardware breakpoint column added by the target or possibly an address REJ10J2000 0100 Rev 1 00 Jun 16 2009 105 RENESAS High performance Embedded Workshop 4 Editor information column added by the debugger The global column states feature 1s also accessible from the main edit menu To switch off a column in all source fil
473. of changed values shown in the Register window Memory Accessed Text sections of executed codes at coverage measurement shown in the Memory window Not Accessed Text sections of codes not executed at coverage measurement shown in the Memory window REJ10J2000 0100 Rev 1 00 Jun 16 2009 132 RENESAS High performance Embedded Workshop 6 Customizing the Environment Unknown Text outside the coverage range shown in the Memory window No Memory Text outside the memory range shown in the Memory window Modified Text sections of changed values shown in the Memory window Output Build Error Lines of error messages shown in the Build tab of the Output window Build Warning Lines of warning messages shown in the Build tab of the Output window Information Lines of information messages shown in the Build tab of the Output window Disassembly PC Line Highlight The line at the PC program counter in the editor window and disassembly window in mixed mode or disassembly mode or Disassembly window while the Enable line highlight for PC position checkbox is selected in the Editor tab of the Options dialog box Source Lines Source codes shown in the editor window and disassembly window in mixed mode All Text Text shown in the windows 6 11 Using the virtual desktop High performance Embedded Workshop has implemented the concept of the virtual desktop This allows window configurations to be defined that can be switched with the click of a button When a particular but
474. of the following operations e Double click on the control bar of a docked toolbar OR e Drag the control bar of a docked toolbar and draw it away from the edge of the High performance Embedded Workshop main frame and from an edge of the other docked windows menu bar or toolbars 1 2 4 Workspace window The Workspace window has four tabs Projects Templates Navigation and Test Fey E Tutorial A Assembly source file io intpre sre H E wecttblsrc ba vhandlerzerc be dbsctc resetpre c ebrk c REJ10J2000 0100 Rev 1 00 Jun 16 2009 5 RENESAS High performance Embedded Workshop 1 Overview e Projects tab Allows you to show the current workspace projects and files You can quickly open any project file or dependent file by double clicking on its icon See section 2 2 Configuring the Projects tab of the Workspace window for more information on the Projects tab If you hover the mouse pointer over a file in the Projects tab then the file s full path will be displayed in a tool tip a Dems CWWorkepace SDemoSH4 DemoSH4 dbsct c HE lowsre c Ea ob few resetprg c e Templates tab Allows you to display template settings See section 4 11 Templates for more information about a template e Navigation tab C Functions gJ abort void gJ maintvoid gJ Manual Reset tvoid EJ PowerON Resethvoid gJ sbrktsize t size od Projects LE Templates Navigation
475. og box again 1 2 3 Select Setup gt Options The Options dialog box will be displayed Select the Confirmation tab Select the Show dialog to search on OK for directory browse dialog checkbox This checkbox is selected by default Click OK If you select the OK button after selecting a directory and not selecting search a confirmation box will be shown as below REJ10J2000 0100 Rev 1 00 Jun 16 2009 285 RENESAS High performance Embedded Workshop 17 Debugging Facility Confirmation Request ki The directory CA Wworkspace Debug Debugl nlysSource has been selected but not searched Would wou like to search this directory for the remaining tiles T Don t ask this question again If you select Yes a search will be made and the Locate Files dialog box will remain open allowing you to stop the search if needed Selecting No will invoke the message box and close the Locate Files dialog box If the confirmation is ticked not to be shown again the default behavior will be No To open the confirmation dialog box again 1 Select Setup gt Options The Options dialog box will be displayed 2 Select the Confirmation tab 3 Select the Show message when canceling for directory browse dialog checkbox This checkbox is selected by default 4 Click OK 2 Showing a source tree Files retrieved from the download module will be shown in the workspace window The files will be shown under the downloa
476. og box opened by double clicking a value In place edit REJ10J2000 0100 Rev 1 00 Jun 16 2009 224 RENESAS High performance Embedded Workshop 15 Macro Recording Support Facility 15 5 2 8 CWatch window While a macro is being recorded the following operations will be recorded into a macro file Target Operation Function Set pop up menu option toolbar Make setting in the dialog box opened by clicking on the menu Sets new data to selected C button option or toolbar button watch point Value Make setting in the dialog box opened by double clicking on a value In placeedit 000 15 5 2 9 S W Breakpoints window While a macro is being recorded the following operations will be recorded into a macro file Target Operation Function Add buiton Click on the button Adds the break point Delete button Removes the selected break point Delete All button Removes all break points Enable button Enables the selected break point All Enable button Enables all break points Disable button Disables the selected break point All Disable button Disables all break points Selected item in the S W Break Point list Double click on the item Enables or disables the selected software breakpoint 15 5 2 10 Address Interrupt Break Points dialog box While a macro is being recorded the following operations will be recorded into a macro file Target Operation Function Add buiton Click on the button Adds the break point Delete button Removes the selecte
477. oject COMMENT Comment Version control Please Enter Comment dialog box opens LINE Line number of an error warning 12 In the table above we are assuming that Note a file path is c workspace project file src a workspace named workspace is located at c workspace a project named project is located at c workspace project a configuration named debug has a configuration directory located at c workspace project debug HEW2 EXE is installed in c Program Files Renesas Hew a HRF file of a toolchain i e compiler assembler linker is located in c Program Files Renesas Hew Tools Renesas Sh 9_0_1_1 This is referred to as TCINSTALL on the options setting dialogs and the New Build Phase dialog step 3 of the Build menu and as TOOLDIR on the Tools Administration dialog box the Windows operating system is installed in c windows and the Windows system directory is located at c windows system a version control executable path is v vc win32 ss exe a user name and its password to login to the version control system are JHARK and 214436 respectively COMMENT is specified in a command line to the version control executable c project is mapped to x vc project on the Projects tab of the Version Control Setup dialog box which is invoked via Tools gt Version Control gt Configu
478. olbar Macro Function Button Recording Set i Sets data at specified address Fill oy a Fills specified memory block with data Move j w Moves specified memory block to Compare 1 O Compares the contents of two memory blocks r Test 1 Tests an area of memory Save Memory contents Search 1 Saves memory contents in a text file Finds a value in memory Search Next 1 Finds a next value in memory Address e Specifies the display start address Scroll Area i Specifies scroll range 49 EE SA Register 1 XXXXX Starts address to value of the register Followed Stack Pointer 1 Keeps tracking of the stack pointer position Set Start Up Symbol T Changes the program display position immediately after downloading Refresh Refreshes the Memory window REJ10J2000 0100 Rev 1 00 Jun 16 2009 310 RENESAS High performance Embedded Workshop 17 Debugging Facility Lock Refresh Disables refresh of the Memory window Auto Refresh 2 rh Regularly refreshes the Memory window a Refresh Interval 2 aa Specifies the refresh interval Data Length 1byte I Data is displayed in 1 byte unit 2bytes T Data is displayed in 2 bytes units 4bytes TTT s Data is displayed in 4 bytes units 8bytes nunn s Data is displayed in 8 bytes units Radix Hex 16 Data is displayed in hexadecimal Dec 10 Data is displayed in decimal Signed Dec 101 Data is displayed in signed decimal Oct Data is displayed i
479. ompare check out and view logs Step 1 Create a workspace Step 2 Selecting Custom Version Control System Step 3 Making settings for Version Control Step 4 Using the Version Control facility Check in Step 5 Using the Version Control facility Compare Step 6 Using the Version Control facility Check out Step 7 Using the Version Control facility View Logs 8 11 1 1 Step 1 Create a workspace 1 Select File gt New Workspace to open the New Project Workspace dialog box 2 Create a workspace with the following conditions e Workspace Name rcs_sample e Project Name rcs_sample e Directory C WorkSpace rcs_sample 3 Create a folder for RCS C WorkSpace rcs_sample rcs_sample RCS REJ10J2000 0100 Rev 1 00 Jun 16 2009 146 RENESAS High performance Embedded Workshop 8 Custom Version Control System 8 11 1 2 Step 2 Selecting Custom Version Control System 1 Select Tools gt Version Control gt Select The Select Version Control System dialog box opens Select ersion Control System EAE Version control system Custom WES 2 Select Custom VCS 3 Click the OK button 8 11 1 3 Step 3 Making settings for Version Control Select Tools gt Version Control gt Configure to open the Version Control Setup dialog box e Setting environment variables 1 Select the Projects tab Yersion Control Setup Ei EI Commands Projects General Show detalls for project rcs sample Details
480. on in the drop list will be selected and then loaded 18 1 2 Defining the synchronized Debuggers Available debuggers Debugger ID i Workspace Session Add Main Not open Debug Multicore CoAWorkspace Demo Demo Corel Video Notopen Debug Multicore C workspace Demo Demo Core Hodiy Hemove The Debuggers list The list box in the middle of the dialog shows information on the synchronized Debuggers essentially a debug session within a High performance Embedded Workshop workspace When the dialog is first opened the list will be set to contain details of all debug sessions open in any High performance Embedded Workshop application running on the local PC The same also occurs when you change your configuration selection or create a new empty configuration This is to help with multi core configuration setup For example it is possible to open several sessions in separate High performance Embedded Workshop applications open the Synchronized Debug dialog in one of the applications and then proceed with synchronized Debugging without having to individually add each session to the Debuggers list A platform or a core on a multi core platform cannot be synchronized without first creating a High performance Embedded Workshop debug session for it Note If any Debugger in the Debuggers list is currently connected to its platform then the Debuggers list will be read only It will not be possible to add modify or remove any Debugger
481. ons and toolbar buttons Se eee eee eee Sere isle Check out from WCS Check into WCS let VCS status User menu options Mase tp Move dawn The Commands tab has two lists of menu options e System defined menu options System menu options and toolbar buttons System menu options and toolbar buttons lists the menu options always shown as the Tools gt Version Control sub menus These menu options also have an associated toolbar button on the Version Control toolbar This contains the six menu options associated with the most frequently used version control commands e User defined menu options User menu options User menu options lists user defined menu options Menu options defined in this list will be added to the end of Tools gt Version Control sub menus If you wish to add menu options not included in the system menu options they must be defined in this list User defined menu options are not shown on the version control toolbar 8 1 1 System defined menu options There are six version control toolbar buttons They provide you with a shortcut to the most commonly used version control commands Initially when you first create a workspace these toolbar buttons are inactive because you have not yet associated any version control commands to them The toolbar buttons are equivalent to the six menu options on the Tools gt Version Control sub menu In other words selecting Tools gt Version Control
482. ontinuing execution to a main function at a reset The High performance Embedded Workshop has a function to continue execution of the program at a reset until it reaches the top of a main function Then the High performance Embedded Workshop sets a temporary software breakpoint at the main function When execution of the program is stopped this breakpoint is deleted To continue execution of the program to the top of a main function at a reset 1 Select Setup gt Options to open the Options dialog box 2 Select the Debug tab 3 Select the Run to main function on reset checkbox By default this box is not selected 4 Reset the target microcomputer Select one of the following operations e Click Reset CPU toolbar button Ett OR e Select Debug gt Reset CPU REJ10J2000 0100 Rev 1 00 Jun 16 2009 348 RENESAS High performance Embedded Workshop 17 Debugging Facility Note The Run to main function on reset feature requires a temporary breakpoint if you have already used all those available then the feature will not work 17 13 7 Single step When you are debugging your code it is very useful to be able to step a single line or instruction at a time and examine the effect of that instruction on the system In the source view a step operation will step a single source line In the disassembly view a step operation will step a single assembly language instruction If the instruction calls another function or subroutine yo
483. ools that have EXE commands the button s image will be the same as the Windows icon for the EXE If no such image is available the default image H will be used 6 3 Using custom placeholders Throughout the High performance Embedded Workshop the user can use a number of pre defined placeholders for directory definitions For example the user can use the PROJDIR variable to signify the current High performance Embedded Workshop project directory This makes it much easier to relocate projects and keep all of the paths correct The High performance Embedded Workshop also has the ability to define custom placeholders This means you can enter your own custom placeholder definition and decide upon its directory value Once defined this placeholder becomes available throughout the rest of the High performance Embedded Workshop system The placeholders can be defined on an application wide level so the placeholders are available to all workspaces and projects that use the High performance Embedded Workshop The other method of defining the placeholders is using the workspace wide custom placeholders This means the placeholders can only be used in the current workspace This list is only available when you have a workspace open REJ10J2000 0100 Rev 1 00 Jun 16 2009 121 RENESAS High performance Embedded Workshop 6 Customizing the Environment Placehoalders Application wide custom placeholders Placeholder Modit
484. oosing Debug gt Halt Program Note The program will start running from whatever address is stored in the Reset Vector location Therefore it is important to make sure that this location contains the address of your startup code 17 13 3 Running program ignoring any breakpoints Sometimes when you are debugging your application you may need to start running continuously but have breakpoints configured Instead of disabling all the breakpoints you can quickly execute the code using the Free Go feature To run from the current PC address but ignore any both software and hardware breakpoints e Click the Free Go toolbar button Ele OR e Choose Debug gt Free Go Note Support for this function depends on the debugger 17 13 4 Running to cursor Sometimes as you are going through your application you may only want to run a small section of code that would require many single steps to execute In this case it would be useful to be able to run to a particular point You can do this by using the Go To Cursor feature How to use the Go To Cursor feature 1 Make sure that an editor or disassembly view is open showing the address at which you wish to stop 2 Position the cursor on the line containing the address at which you wish to stop 3 Choose Go To Cursor from the pop up menu The debugger will run your code from the current PC value until it reaches the address indicated by the cursor s position REJ10J2000 0100 Re
485. opens Save the data into the High performance Embedded Workshop test image file selected in the Add New Test dialog box or a new High performance Embedded Workshop test image file Only test image data of the selected test items with tick marks in checkboxes will be saved into the file You can also edit a test image file from the workspace window pop up menu 16 6 Functions that can be saved as test image data into test image files Create New Test Image El Ei Available components oP Stack Trace SimSessianSH 4 0E Trace SimSessionSH 4 Lancel Og CPU De 0 SimSessionSH 4 oO eel Memory SimSessionSH 4 Check All E Register SimSessionSH 4 gA Simulated O SimsessionaH 4 A Status SimSessionSH 4 Settings OR Output ven Of Build Output Window Import 7 Bl Debug Output Window SimSessionSH 4 ee Symbol 8S Locals SimSessionSH 4 ae Dee watch SimSessionSH 4 High performance Embedded Workshop is not capable of saving all High performance Embedded Workshop functions as test image data For details on the functions that can be saved into test image files see the topics below These topics also include information about failed test items FAIL shown after test or at comparison of test image files e Functions that can be saved into test image files common to all High performance Embedded Workshop products e Functions that can be saved into test image files dependent on the debugger REJ10J2000
486. opens Click the Use an existing session file radio button Enter a name for the session Browse to an existing session file location which you would like to import into the current project a YY Click the Open and maintain link to session file checkbox This means the session will not be imported into the project directory but instead the High performance Embedded Workshop will link to the session location This file location was entered in step 5 and it will save all of the session data in this location 7 Click the OK button to close the Debug Sessions dialog box It is possible to make the link to session file read only This is useful if you are sharing debugger setting files and you do not want data to be modified accidentally To import a link to an existing session file and make it read only 1 Select Debug gt Debug Sessions The Debug Sessions dialog box opens Click the Add button The Add new session dialog box opens Click the Use an existing session file radio button Enter a name for the session Browse to an existing session file location which you would like to import into the current project Click the Open and maintain link to session file checkbox A oS oS Click the Make session file link read only checkbox This means that the High performance Embedded Workshop will be unable to save changes to this session and will only be able to read the data when the session is opened f Use an existing session file
487. or Under this sub menu will be the menus which can be used to configure your debug platform In the case of the SuperH family Simulator the available menus are the System and Memory resource These options both allow the simulator to be customized and setup to your requirements You will be presented with a set up dialog specific to the debugger that you chose in the Debug Settings dialog For a detailed description of the features available in your debugger please refer to the separate Debugger User Manual 17 1 4 2 Memory mapping For the debugger to correctly represent your user system the memory map must be set up It needs to know which areas in the device s address space are RAM ROM on chip registers or areas where there is no memory When you select the device type and mode in the project generator the High performance Embedded Workshop will automatically set up the map for that device and the mode in which the processor is operating For example in a device with internal ROM and RAM the areas where these are located in the device s memory map will be set by default If you are using a device that does not have internal memory or a device with external memory instead of or in addition to the internal memory then you must tell the debugger that you have memory there Tip If you are trying to debug code with an emulator and need some memory available that does not exist either on chip or externally in your hardware then y
488. or hides the toolbar eS fsa ES e Customize toolbar Customizes toolbar buttons The Build tab also shows an icon corresponding to the error message output by build execution Icon Name Icon Error Message Level Build Error oy Error Build Warning fi Warning Information a Information You can also customize the Build tab of the Output window so that the texts in the lines of error messages will be highlighted in a color different from that of the texts in other lines To customize the current colors 1 Select Setup gt Format Views to open the Format Views dialog box 2 Select the Output item from the tree in the left hand section of the dialog box and expand it REJ10J2000 0100 Rev 1 00 Jun 16 2009 55 RENESAS High performance Embedded Workshop 2 Build Basics 3 Select the category for which you wish to change the color from the table below Category Foreground Color of the Background Color of the Tab s tobe Type of Output to be Color Tab Default Color Tab Default Applied Applied Text SYSTEM SYSTEM All tabs All Build Error Text Black White Build Error Build Warning Text Black White Build Warning Information Text Black White Build Information Change the selection in the Foreground and Background lists of the Color tab Click the OK button 2 8 7 Controlling the content of the Build tab of the Output window It is often useful to display extra information such as the command line options that are being ap
489. or version control Configuration file hvc Common Source file C source file C Common C source file cpp e SuperH family e H8SX H8S H8 family Assembly source file a30 e M16C family e R8C family ASM SuperH family Mar H8SX H8S H8 family src Include file C header file h Common C header file hpp e SuperH family e H8SX H8S H8 family Assembly include file inc Common REJ10J2000 0100 Rev 1 00 Jun 16 2009 134 RENESAS High performance Embedded Workshop 7 Version Control Other types of files can also be supported once they are added to the project e Version Control System that can be Connected with the High performance Embedded Workshop High performance Embedded Workshop does not provide the version control system itself It must be installed in your PC in advance The High performance Embedded Workshop can be connected to the version control system via the GUI interface First select a version control system which you wish to connect with the High performance Embedded Workshop Either of the followings can be selected Type Version Control System Description Name Displayed on Screen Version control by custom settings Custom VCS Any version control system in which command line commands should be executed via the MS DOS command prompt Such as RCS CVS or PVCS The commands in the version control system must be defined as being associated with the GUI interface of the High performance Embedded Workshop Version control b
490. or what the information it is displaying is if you place the mouse pointer over the column a tool tip pop up window is displayed showing its identity The editor window can be customized via the Format Views dialog box which can be invoked via Setup gt Format Views This dialog box allows you to configure fonts colors tabs and so on for the editor window It also allows the user to change the look of other views which have been installed by High performance Embedded Workshop If you would prefer to use your favorite editor rather than the High performance Embedded Workshop internal editor then specify your alternative in the Options dialog box which can be invoked via Setup gt Options For further details on how to use the editor see Chapter 4 Editor Note Allows you to set software breakpoints only when the debugger is connected REJ10J2000 0100 Rev 1 00 Jun 16 2009 8 RENESAS High performance Embedded Workshop 1 Overview 1 2 6 Output window The Output window by default has seven tabs Build Debug Find in Files 1 Find in Files 2 Macro Test and Version Control on display z ol of a at 21 21 2 H Build Finished O Errors 0 Warnings 4 a 4 Build Find in Files 1 Find in Files 2 version Control Build tab The Build tab shows the output from any build process e g compiler assembler and so on If an error is encountered in a source file an icon and the error message will be displayed in th
491. ormation the Sample Information dialog box appears Options Right clicking displays a pop up menu containing available options Pop up Menu Option Auto Refresh Nonrefresh Stop Real time Refresh Now Update Interval Zoom In Zoom Out Reset Zoom Zoom Magnification X2 X4 X8 Scale 128 256 512 Clear Cursor Sample Information Properties Note Macro Recording Function Disables refresh of the Waveform window Automatically refreshes the Waveform window when user program execution stops Regularly refreshes the Waveform window Refreshes the Waveform window Specifies the refresh interval Zoom in display Zoom out display Resets the zoom display The zoom magnification is 2 The zoom magnification is 4 The zoom magnification is 8 The size of the X coordinate is 128 pixels The size of the X coordinate is 256 pixels The size of the X coordinate is 512 pixels Hides the cursor display Displays the sampling information of the cursor location Opens the Waveform Properties dialog box Available only when the debugger supports this function 17 5 2 Regularly refreshing the Waveform window Selecting Auto Refresh gt Nonrefresh from the pop up menu will not refresh the window Selecting Auto Refresh gt Stop from the pop up menu will allow the window contents to be automatically refreshed when user program execution stops Selecting Auto Refresh gt Real time from the pop up me
492. orms Note This may not be the same as go_reset command performing a reset and go separately depending on your platform Break Break Halt Breakpoint is reached Stops all synchronized platforms running Halt Break Halt Debug gt Halt Program menu Stops all synchronized platforms running Halt toolbar button halt command REJ10J2000 0100 Rev 1 00 Jun 16 2009 386 RENESAS High performance Embedded Workshop 18 Synchronized Debugging Step In Step Debug gt Step In menu Performs step in on all synchronized platforms Step In toolbar button step command Step Over Step Debug gt Step Over menu Performs step over on all synchronized Step Over toolbar button platforms step_over command Step Out Step Debug gt Step Out menu Performs step out on all synchronized platforms Step Out toolbar button step_out command Connect Connection Debug gt Connect menu Connects to the platform in all synchronized Connect toolbar button Debuggers connect command or platform specific command Download Download Debug gt Download Modules menu item Downloads the module to all synchronized file load modules Workspace tab Download modules folder platforms The module filename must be the file_load command same in each Debugger On connection when Download automatically on target connection option is set After build when Download modules after bui
493. ory in which you would like the tool to run into the Initial directory field Click the OK button to add the menu option to the Tools menu Add Tool ki Name Ok Notepad Cancel Command CAWINNTS4NOTEPAD EXE p Browse Arguments siFu LLFILE Co Initial directory fo Browse REJ10J2000 0100 Rev 1 00 Jun 16 2009 120 RENESAS High performance Embedded Workshop 6 Customizing the Environment New menu options are added to the bottom of the list i e bottom of the Tools menu To modify a menu option 1 Select Setup gt Customize The Customize dialog box opens 2 Select the Menu tab 3 Select the menu option that you would like to modify and then click the Modify button 4 Make the desired changes on the Modify Tool dialog box and then click the OK button Modify Tool Ei Notepad Cancel Command CAWINNTSNOTEPAD EXE p Browse Arguments siFu LLFILE Initial directory fo Erwe To remove a menu option 1 Select Setup gt Customize The Customize dialog box opens 2 Select the Menu tab 3 Select the menu option that you would like to remove and then click the Remove button When you have one or more tools added the System Tools toolbar will be available in High performance Embedded Workshop This will have one toolbar button for each tool Clicking on a tools button will launch the tool exactly as if it had been selected from the Tools menu For t
494. ory is accessed If the memory needs to be accessed by a specific access size specify the access size by using this option The Download debug information only checkbox will download the debug information only without downloading the code The Perform memory verify during download checkbox can be used to do additional checks when downloading the module to ensure it was correctly downloaded to the target device The Download automatically on target connection checkbox can be used to automatically download the module when the target is being connected When you click the OK button the debug download module is added to the bottom of the list For automatically downloading an existing module to the target when adding it to the Download modules list see section 17 1 5 2 Downloading modules To change the setting of a download module L Select one of the following operations to open the Download Module dialog box Open the Debug Settings dialog box and select a module for which you wish to modify the setting in the Download modules list and click the Modify button OR Right click on the download module or within the Download modules folder on the Projects tab of the workspace window and select Properties from the pop up menu Change the setting and click the OK button To remove download modules L 2A Open the Debug Settings dialog box Select a module which you wish to remove in the Download modules list and click the Re
495. ou a shortcut to opening workspaces which you have used recently To open a recently used workspace Select Open a recent project workspace in the Welcome dialog box select the name of the workspace from the drop down list and then click the OK button Another way is to select File gt Recent Workspaces and then from this submenu select the name of the workspace Note The High performance Embedded Workshop only permits one workspace to be open at a time Consequently if you attempt to open a second workspace the first will be closed before the new one is opened REJ10J2000 0100 Rev 1 00 Jun 16 2009 14 RENESAS High performance Embedded Workshop 1 Overview 1 7 Using old workspaces The High performance Embedded Workshop can open any workspace that was created on a previous version of the High performance Embedded Workshop This should be automatically upgraded when the workspace is opened A back up version of the initial workspace or project file must be saved in the current directory of the file that has been upgraded 1 8 Saving a workspace The amount of information on workspaces and projects to be saved increases as the High performance Embedded Workshop is upgraded Thus the format in which workspaces can be saved is slightly different depending on the version of the High performance Embedded Workshop To save a High performance Embedded Workshop workspace in the current version s format select File gt Save
496. ou can map some emulation memory from the emulator to the address space for your application to use The details will be specific to the debugger that you chose in the new project Additional information about the memory mapping can be viewed in the System Status view s Memory pane The Device Configuration area shows how the memory in the device s address space Note Due to page length limitations in some emulators the range addresses may not exactly match the entered addresses 17 1 4 3 Editing debug settings Normal operation of the High performance Embedded Workshop debugger means that your target and download modules will be automatically configured in the project generation process However in some cases it may be necessary for you to manually configure your debug session This is often the case when using old toolchains and project generators that do not support the latest High performance Embedded Workshop interfaces To check your debug session setup display the Debug Settings dialog box Select one of the following operations e Select Debug gt Debug Settings OR e Right click on the download module or within the Download modules folder on the Projects tab of the workspace window and select Debug Settings from the pop up menu REJ10J2000 0100 Rev 1 00 Jun 16 2009 273 RENESAS High performance Embedded Workshop 17 Debugging Facility Debug Settings SimSessionSH 4 Target Options Tes Project Mame
497. ou want to display build output as it happens rather than showing the output at the end of each phase execution Select the Environment tab to edit the environment settings for the phase Environment Environment settings es eee PAaTH C 4T ools SHOW ALL FALSE REJ10J2000 0100 Rev 1 00 Jun 16 2009 71 RENESAS High performance Embedded Workshop 3 Advanced Build Features Use the Add Modify and Remove buttons to add modify and remove environment variables respectively Select the Output Syntax tab and define the error warning and information for the custom phase Messages that include filenames can only be handled as syntax Thus all syntax defined on the Output Syntax page should include filenames Always use a placeholder to specify a filename Output Syntas Line formats Error FULLFILE JEEHLINE JIE Wearing IFULLFILEILHLIME N i When the lines showing error messages in the Build tab of the output window match the definition of Output Syntax you can find icons on the left to the error messages and view the source code in the editor If the Renesas SuperH C C compiler is used for example the following error message may be output to the Build tab of the output window C Workspace SH SH resetprg c 70 C2225 E Undeclared name a To define this error type the following syntax FULLFILE LINE E The correspondence between an error message and its syntax is as shown below
498. ourceSafe Check out from VCS a Checks out a writable copy of a file from Visual SourceSafe Check in VCS a Checks in your edits to a file into Visual SourceSafe Get VCS status 5 a Views the status of a file in Visual SourceSafe Launch External Debugger Launches an external debugger tool Macros Opens the Macro dialog box Record Macro Starts recording of a macro Play Macro Plays a macro Stop Macro Stops a macro System tools Invokes system tools e g Renesas Call Walker woe y REJ10J2000 0100 Rev 1 00 Jun 16 2009 399 RENESAS High performance Embedded Workshop 1 Main Menus Notes 1 Custom menu options to which recorded macros have been assigned are shown between Stop Macro and system tools 2 Further menu options for external tools added by customizing the Tools menu are shown under the menu options for system tools 1 9 Test Menu Options Menu Menu Option Shortcut Key Toolbar Button Function Test Create New Test Suite Creates a new blank test suite so you can begin adding and running tests Open Test Suite Opens an existing test suite Edit Test Suite Edits the current test suite Allows you to add and remove tests to the test suite Close Test Suite Closes the current test suite Create New Test Setups and customizes the test image data saved to the test image file Image File HIF Compare Test Image Compares test image file allows you to compare a test image file
499. ove from the list and then click the Remove button Environment Yarable Vanable ram o OF Value Cancel gt If the tool you are adding can display its output whilst the tool is running then use the Read Output on Fly option This will display the tool output as each line of output happens If this option is set to off then the High performance Embedded Workshop will store all output that is being displayed by the tool and display it in the Output window when the tool has finished its operation This can be a problem when the tool is running an operation that might take many minutes as it is difficult to see the progress of the current execution Note Using Read Output on Fly can cause problems when using certain tools on certain operating systems If you are having problems with tools locking up or freezing in High performance Embedded Workshop then un check the Read Output on Fly option Click the Finish button to create the new phase By default the new phase is added to the bottom of the Build phase order list in the Build Order tab of the Build Phases dialog box REJ10J2000 0100 Rev 1 00 Jun 16 2009 69 RENESAS High performance Embedded Workshop 3 Advanced Build Features 3 3 Ordering build phases In a standard build shown in figure below you could add a phase at four different positions before the compiler 1 before the assembler 2 before the linker 3 or after the linker 4 You may place your own c
500. owser is invoked and defaults to the High performance Embedded Workshop download page for your region 3 Browse this area for High performance Embedded Workshop updates to fix bugs or add new features REJ10J2000 0100 Rev 1 00 Jun 16 2009 392 RENESAS High performance Embedded Workshop 19 Technical Support 19 3 Creating a bug report Occasionally you may experience some unforeseen problems with the High performance Embedded Workshop application If a problem does occur that results in an application crash the High performance Embedded Workshop bug tracking program will be invoked automatically This allows you to compile a bug report and this can then be sent to your technical support contact in a variety of ways It is also possible to invoke this tracker program manually This is described below To create and send a High performance Embedded Workshop bug report L 2 Note Select Help gt Technical Support gt Create Bug Report Detailed information is generated from your High performance Embedded Workshop system This may take some time The Submit a Bug Report dialog box is then displayed Write the description of your problem in the Please type a description of the problem you wish to report edit box This item must be completed Type your name in the Name edit box Type your company URL or purpose of the product being developed in the Company website Your application edit box This item must be completed
501. p 2 Build Basics 2 10 Configuring the Workspace window If you right click anywhere inside the Projects tab of the Workspace window a pop up menu will be invoked Select the Configure View menu option to modify the way in which information is displayed The following four sections detail the effect of each option on the Configure View dialog box Show Dependencies Under Each File If you check the Show dependencies under each file checkbox the dependent files are shown under the including source file as a flat structure i e the files themselves become folders as in figure ii below If this option is not selected then a separate folder contains all dependencies as in figure 1 below at Workspace OP E4 Ww at Workspace OF x bere u Dena Assembly source file Ej a Assembly source file as 2 lowlyLerc pb 2 lowlyL sre 5 ra C source file a a C source file dhect c bn dbsct c m E Demo c n E Demo c l ar FE intprg c 2 intprg c H E lowsre c E vecth gt resetprg c H E lowste c i 4 shirk c B lowenc A ee 2 vecttblic E resetprg c H E Dependencies a stackact h lowere h a sbrk c a E sbrk h o sbrk h L E stackect h vecttbl c ce E vech ae E vecth Show Standard Library Includes By default any dependent files found in standard include paths will not be shown as in figure j below For example in C code if you write a include statement such as
502. pened e When a break occurs the window order will not be changed automatically e The position of the source file in the editor window is fixed If you wish to continue step in Disassembly mode of the Disassembly window select the Debug gt Step mode gt Assembly Note After a break occurs the High performance Embedded Workshop displays the location of the program counter PC In some cases for example if a project has been moved from its original path the source files may not be automatically found In this case the High performance Embedded Workshop will open a source file browser dialog to allow you to manually locate the file this path will then be used to update any other source files in this debug project REJ10J2000 0100 Rev 1 00 Jun 16 2009 295 RENESAS High performance Embedded Workshop 17 Debugging Facility 17 2 1 Opening the Editor window To view a source file s code double click on its icon in the file tree or right click on the source file and click the Open option on the pop up menu The High performance Embedded Workshop opens the file in the editor Toolbar View Source View mised mode Wiew Disassembly Source old main void i long min Wax The editor in version 4 00 onwards has been enhanced to include an integrated disassembly view This integrated view has a toolbar which allows the switching of mode When each mode is available it is possible to click the button and change t
503. performance Embedded Workshop 17 Debugging Facility 17 1 6 1 Selecting a session To select a session 1 Select Debug gt Debug Sessions The Debug Sessions dialog box opens 2 Select the session that you want to use from the Current session drop down list box 3 Click the OK button Detaultsess ton Eee e A You can also select a different debug session by selecting it from the Current Session drop down list on the Standard toolbar 17 1 6 2 Adding a session You can now create a session with a target attached and setup ready for use This session can be given a name and the target chosen To create a new session with a target attached and setup 1 Select File gt New Session The New Session dialog box opens Hew Session Session name pat o ooo Create a new session ore SHA Simulator Cancel E Fan gl i x Using internal core Single Core Target Session generator to use Renesas SH Project Generator 2 Enter the name of a new session into the Session name field This can be up to 32 characters in length and contain letters numbers and the underscore character Especially do not use a minus sign or a space 3 Select the target you wish to use in the Create a new session on list Select the core in the Using internal core list This item is only available when a synchronized debugging facility has been used 5 Select the generator in the Session generator to
504. performance Embedded Workshop window title The High performance Embedded Workshop window title will start with the display ID of the Debugger open in the application This will not change while the application is Synchronized Automatic un sync If an operation is performed that changes the current debug session the High performance Embedded Workshop application will be removed from the synchronized debug system and will no longer be synchronized with the other High performance Embedded Workshop applications The following operations will cause the session to change New workspace Open workspace Close workspace Set current project Change session REJ10J2000 0100 Rev 1 00 Jun 16 2009 388 RENESAS High performance Embedded Workshop 18 Synchronized Debugging 18 2 3 Internal mode functionality Tert BIAI brick es rearea laaie Merde Eola bl Rr E eL kF AA SD LE ME FoF FF a F ii TH D ae a i 8 ii LIWEERS cee es er Ae Alaaa F a th PL EE 1 I ej eed PL ees be ee Se oe oe tuk fant ei I pj i a a General operation When using internal mode all Debuggers are opened in the one High performance Embedded Workshop application The state of the GUI can be switched by various methods to debug the different open Debuggers When the GUI is switched to a Debugger the debug views will change to show data on that Debugger and any operations executed from then on will be executed on that Debugger referred to
505. played as UTF 8 code select Setup gt Options to open the Options dialog box Click on the Debug tab and select UTF 8 for Encoding Format The Locals window now shows the values of variables as UTF 8 code If Local Code Page default has been selected for Encoding Format the values are displayed as ASCII code Note The default font for display in the Locals window is Courier New which is not supported by UTF 8 Select another font compatible with UTF 8 in the Format Views dialog box in advance REJ10J2000 0100 Rev 1 00 Jun 16 2009 377 RENESAS High performance Embedded Workshop 18 Synchronized Debugging 18 Synchronized Debugging The synchronized debugging system is designed to help with debugging multi core devices It allows you to run programs on multiple CPU cores and synchronize common debug operations Go step halt etc between the cores The Synchronized Debug dialog box is the main entry point for configuring and initiating the synchronized debugging system Options related to synchronized debugging are saved in SDO files These are always located in the Sync directory This is defined as lt Local settings directory gt Renesas HEW hew_001 Sync The local settings directory is set by Windows and is normally Window 2000 operating system or Windows XP operating system C Documents and Settings lt user name gt Local Settings Application Data Window Vista operating system C U
506. plement safety measures so that Renesas products may not be easily detached from your products Renesas shall have no liability for damages arising out of such detachment This document may not be reproduced or duplicated in any form in whole or in part without prior written approval from Renesas Please contact a Renesas sales office if you have any questions regarding the information contained in this document Renesas semiconductor products or if you have any other inquiries High performance Embedded Workshop Introduction Introduction The High performance Embedded Workshop is a powerful development environment for embedded applications targeted at Renesas micro controllers The main features are A configurable build engine that allows you to set up compiler assembler and linker options by using GUI An integrated text editor with user customizable syntax coloring to improve code readability A configurable environment which allows you to run your own tools An integrated debugger which allows you to build and debug in the same application Version control support Operating Environment for the High performance Embedded Workshop This user s manual online help and release notes do not indicate that the correct operation of the High performance Embedded Workshop is guaranteed for any types of host computers or peripheral devices Note on the Sample Source Files Generated by the High performance Embedded Workshop When a new work
507. plied to a file during a build The High performance Embedded Workshop allows you to specify whether or not you want such options displayed in the Build tab of the output window during a Build Build All or Build File operation via the Options dialog box To view or hide extra information during a build 1 Select Setup gt Options The Options dialog box opens 2 Select the Build tab 3 Set the three check boxes in the Show group as follows e Command line controls whether the command line is shown as each tool is executed e Environment controls whether the environment is shown as each tool is executed e Initial directory controls whether the current directory is shown as each tool is executed showy MW Command line W hitial directory W Environment Mark out of date files 2 8 8 Displaying out of date files in the Workspace window Files updated later than the file generated by the previous build e out of date files are marked in the workspace window In the window below the file demo c is out of date When you click Build next time these files will be re built This is also displayed for dependent projects of the current project The view of these files is updated whenever something that affects the build occurs e g options changing file addition dependencies changing files modified etc REJ10J2000 0100 Rev 1 00 Jun 16 2009 56 RENESAS High performance Embedded Workshop Workspace x E demo omm A 4 Ass
508. points column Double click on the column 15 5 1 3 Disassembly window 15 Macro Recording Support Facility Runs program until the PC reaches cursor Sets PC to the address at cursor Sets or clears a software breakpoint Sets or clears a software breakpoint Enables or disables the current software breakpoint Runs program until the PC reaches cursor Sets PC to the address at cursor Sets or clears a software breakpoint While a macro is being recorded the following operations will be recorded into a macro file Display Mode Target Operation Source mode Toggle Breakpoint pop up menu option Click on the Enable Disable Breakpoint pop up menu Menu option option Go To Cursor pop up menu option Set PC Here pop up menu option S W Breakpoints column Double click on the column Mixed disassembly Go To Cursor pop up menu option Click on the mode Set PC Here pop up menu option menu option Toggle Breakpoint pop up menu option Enable Disable Breakpoint pop up menu option S W Breakpoints column Double click on the column 15 5 1 4 Register window Function Sets or clears a software breakpoint Enables or disables the current software breakpoint Runs program until the PC reaches cursor Sets PC to the address at cursor Sets or clears a software breakpoint Sets or clears a software breakpoint Enables or disables the current software breakpoint Runs program until the PC reaches cursor Sets PC to the address a
509. ponent Note The High performance Embedded Workshop registration file is located in the root directory of a component s installation 5 4 Unregistering a component The components that are registered with the High performance Embedded Workshop affect the way it behaves For example every compatible system tool that is registered will be added to the Tools menu when a new project is created Sometimes this may not be desirable If this is not required open the Tools Administration dialog box select the undesired component from the Registered Components list and click the Unregister button A dialog box will be invoked which asks you to confirm this action Click Yes to unregister the component Note Unregistering a component does not remove its installation from the hard disk It simply removes the information that the High performance Embedded Workshop was storing about that component i e it disconnects it from the High performance Embedded Workshop The action can be easily reversed at any time by registering the tool manually see section 5 3 Registering a component 5 5 Viewing and editing component properties To view information regarding a component select it from the Registered Components list on the Tools Administration dialog box and click the Properties button The Properties dialog box opens The General tab displays the name version and location of the selected component SuperH RISC engine Standard Toolch
510. port for this function depends on the debugger 1 7 Setup Menu Options Menu Menu Option Shortcut Key Toolbar Button Macro Recording Function Setup Customize Customizes the High performance Embedded Workshop application Sets option of the High performance Embedded Workshop application Configures fonts colors keywords and so on for the window Options Format Views Radix Hex 16 Sets radix to hexadecimal Decimal 10 a Sets radix to decimal Oct g Sets radix to octal Bin z i Sets radix to binary Operations with some menu options can be recorded as High performance Embedded Workshop command line commands by the macro recording support facility A macro record icon in the Macro Recording column of a menu option indicates that this function can be recorded into a High performance Embedded Workshop macro file For details see section 15 5 1 Recordable functions common to all High performance Embedded Workshop products 1 8 Tools Menu Options Menu Menu Option Shortcut Key Toolbar Button Function Tools Administration Controls the components Change Toolchain Version Changes a toolchain version Version Select Selects a version control system Control Configure Setups the version control system Add to VCS ice Adds files to Visual SourceSafe Remove from VCS ce Gets a read only copy of a file from Visual SourceSafe Get from VCS a Gets a read only copy of a file from Visual S
511. pt 4 Deselect the Close DOS Window on exit checkbox This is because errors must be viewed in the MS DOS prompt e Setting up commands 1 Select the Commands tab 2 Click the Add button on User menu options 3 The Add Menu Option dialog box appears 4 Enter Initialize in Option and click the Add button REJ10J2000 0100 Rev 1 00 Jun 16 2009 148 RENESAS High performance Embedded Workshop 8 Custom Version Control System 5 The Add Command dialog box appears Add Command a Command Version control executable C NRCSACLEXE Browse Cancel Arguments f HFILENAME gt Initial directory SIPROJDIR P Browse Executable return code Return code of executable is not meaningful C Command has failed if the return code is Not Equal To 0 6 Enter C RCS CI EXE in Version control executable 7 Enter FILENAME in Arguments 8 Enter PROJDIR in Initial directory 9 Click the OK button 10 Click the OK button in the Add Menu Option dialog box Tip It is recommended that you only register some commands frequently used for version control Other commands should be used via the MS DOS command prompt Also set up the following tree commands in the same way Command Option Name Characters to be Input Check out Version control executable C RCS CO EXE Argument f FILENAME Initial directory PROJDIR Diff Version control executable C RCS RCSDIFF E
512. r or select Other to open this type of file with a specific application If you select Other you can either specify a new application or select any previously defined application from the drop down list Click the Add button to define a new application The Add Application dialog box opens Add Application Name pore Cancel Command excluding parameters p Browse Parameters a hitial directory PY Brose REJ10J2000 0100 Rev 1 00 Jun 16 2009 46 RENESAS High performance Embedded Workshop 2 Build Basics Enter the name of the tool into the Name field Enter the full path to the tool in the Command field do not include any parameters Enter the parameters that are required to open a file into the Parameters field Be sure to use the FULLFILE placeholder to specify the location of the file see Reference 5 Placeholders for more information on placeholders Enter the initial directory in which you would like the application to run into the Initial directory field Click the OK button to finish creating the application Click the Modify button to modify an application The Modify Application dialog box will be displayed This dialog is the same as the Add Application dialog box described above except that the Name field is read only Modify the settings as desired and then click the OK button 5 Click the OK button to set the application for the selected file group 2 5 2 Creating a new file exten
513. r The toolbar is only shown while the debugger is connected When one display mode is active clicking another toolbar button switches the display mode If you place the mouse pointer on a toolbar button the name of the button pops up Column You can adjust the column width by dragging the mouse on a column header Moreover right clicking header the column header displays a pop up menu A tick mark right next to an entry indicates that this column is displayed Clicking an entry will switch showing hiding the column If you place the mouse pointer on a column header the name of the column pops up You can also select showing hiding the column header itself Column There are several spaces columns on the left of the source code field If you place the mouse pointer on a column the name of the column pops up Source This field includes codes highlighting the syntax The maximum number of characters per line shown code field in the editor is 8 192 Right clicking within this field displays a pop up menu containing available options Tab Shows information on files file name and asterisk while editing If you place the mouse pointer on a tab the file name including its absolute path pops up Right clicking within this field displays a pop up menu containing available options REJ10J2000 0100 Rev 1 00 Jun 16 2009 86 RENESAS High performance Embedded Workshop 4 Editor 4 2 Working with multiple files The file area is where you will wo
514. r dialog box opens Followed Stack Pointer ga EA Mot Follow fi Stack Pointer Cancel Select the stack pointer to track from the drop down list box The Memory Window has its display addresses automatically altered by tracking the selected stack pointer position Selecting Not Following in the Followed Stack Pointer dialog box causes the debugger to stop tracking the stack pointer position Support for this function depends on the debugger REJ10J2000 0100 Rev 1 00 Jun 16 2009 317 RENESAS High performance Embedded Workshop 17 Debugging Facility 17 3 14 Changing the program display position immediately after downloading To specify the source file position select Set Start Up Symbol option from pop up menu of the memory window The Set start up symbol dialog box opens Set start up symbol Ei ES o Aal nea Input start up symbol to drop down list box 17 3 15 Refreshing the Memory window The Memory window contents can be forcibly refreshed Selecting Refresh from the pop up menu of the Memory window 17 3 16 Disabling refresh of the Memory window Automatic refresh of the Memory window which is performed when user program execution stops and in other cases can be disabled Select Lock Refresh from the pop up menu of the Memory window While Lock Refresh is active the contents of the Memory window are grayed out Auto Refresh in the Memory window cannot be used with Lock Refresh
515. r tabbed pane of the IO window do not match an Z icon appears on the items as shown below Jae Unit H 5 pTEH bess ASID All Register Selected Register See Reference 6 I O File Format for more information about an I O file format REJ10J2000 0100 Rev 1 00 Jun 16 2009 338 RENESAS High performance Embedded Workshop 17 Debugging Facility 17 6 8 Printing the currently displayed contents The contents currently displayed on the selected pane of the IO window can be printed in a text file Select Print from the pop up menu 17 6 9 Saving the currently displayed contents The contents currently displayed on the selected pane of the IO window can be saved in a text file Select Save to File from the pop up menu 17 6 10 Finding an I O register You can search for an I O register shown in the IO window To find an I O register 1 Right click within the window to open a pop up menu 2 Select Find The Find dialog box opens Find ei Ed Column Name OK fit Cancel aSID T Match whole word 3 Select the column in which you wish to search for an I O register Address Address of the I O register Name Name of the I O register 4 In Find enter the string to be found in the selected column The characters are not case sensitive 5 To find the I O register that completely matches the string entered in Find select the Match whole word checkbox When this option is not selected all I O regi
516. r test image file to be compared with Example Failed at IPRC register value is different Src 0000 Dest FFFF To make detailed setting If you double click on a test item in the Create New Test Image dialog box a further dialog box for detailed setting opens REJ10J2000 0100 Rev 1 00 Jun 16 2009 239 RENESAS High performance Embedded Workshop 16 Test Support Facility Edit Test I0 registers EE Compared ID registers Name Address J C FTEH FF0000 C FTEL FFOUOUO4 C TTE FFOUOUUS CI TEA FFOUOUOL C MMUCR FFOUOO 0 C CER FFOUOUTC CI TRA FFOUOU20 DV FPF YT FFA 4 hd Curent Setting P T lonore address 1 Selecting the checkbox for an I O register in the Compared I O registers list allows this I O register to be saved into the test image file These check boxes are not selected by default The selected I O register is shown in Current Setting 2 If you do not wish to compare the address of the selected register select the Ignore address checkbox This checkbox is not selected by default 3 Click OK 16 6 1 4 CPU Status Status window The following table shows information on the test image data to be saved into test image files and test results not matched Test group name CPU Test item name Status Test image data to be Values set as detailed information and all data in the Status window No sheet is specified by default saved into test image files Test result details Sheet Name o
517. race conditions dialog box Click the Detail button for Read from anuninitialized memory in the Hardware Break or Trace conditions dialog box Click the Detail button for Stack access violation in the Hardware Break or Trace conditions dialog box Click the Detail button for Task stack access violation in the Hardware Break or Trace conditions dialog box View gt Event gt Performance Analysis Conditions View gt Event gt Trigger Output Conditions View gt Performance gt Realtime Profile Setup gt Emulator gt System Setup gt Emulator gt Device Setting Setup gt Emulator gt Start Stop Function Setting 15 Macro Recording Support Facility E8a emulator software E30A emulator debugger Emulator debuggers for 740 family Excluding the following debugger E8a emulator software H8 300H Tiny series compact emulator debugger M32C PC7501 emulator debugger V 1 03 Release 00 and later M32C compact emulator debugger V 1 03 Release 00 and later M16C R8C PC7501 emulator debugger V 1 03 Release 00 and later M16C R8C compact emulator debugger V 1 03 Release 00 and later Simulator debuggers for SuperH family Simulator debuggers for H8SX H8S and H8 families Simulator debuggers for SuperH family Simulator debuggers for H8SX H8S and H8 families Emulator software for the E200F emulators ROEO200FOEMUO0 and ROEO200F2EMU00 revised to V 1 08 Release 00 and later Simulator debugger
518. racters in length and contain letters numbers and the underscore character Especially do not use a minus sign or a space As you enter the workspace name the High performance Embedded Workshop will add a sub directory and Project Name for you automatically This can be changed if desired This allows the workspace and REJ10J2000 0100 Rev 1 00 Jun 16 2009 13 RENESAS High performance Embedded Workshop 1 Overview project name to be different To select the directory in which you would like to create the workspace use the Browse button or type the directory into the Directory field manually Select the CPU family and Tool chain upon which you would like to base the workspace When a new workspace is created the High performance Embedded Workshop will also automatically create a project with the name specified in the Project Name field and place it inside the new workspace The project types list displays all of the available project types e g Application Library etc Select the type of project that you want to create from this list The project types displayed will be all valid types for the current pair of CPU family and Tool chain The project types are classified in three classes toolchain only debug only Debugger only xxxxxx and full project generator that configures both the debugger and toolchain aspect of the High performance Embedded Workshop 5 Click the OK button to create the new workspace and project This then lau
519. rce Auto Allocate The dialog box shown below appears ecxmap Ci Is the memory resource allocated Cancel 3 To continue processing click OK 4 When allocation is completed the dialog box shown below appears ecxumap a The allocation of the memory resource was completed Support for this function depends on the debugger REJ10J2000 0100 Rev 1 00 Jun 16 2009 197 RENESAS High performance Embedded Workshop 13 Map 13 1 11 Printing out the section settings tree You can also print out the section settings tree in the left pane To print out the section settings tree 1 Right click within the right pane to open a pop up menu 2 Select Print 3 The standard print formatting and selection dialog box opens From here you can choose your printer and page setup options 13 1 12 Viewing unallocated areas You can view areas where no section is allocated By default this function is not selected To view unallocated areas 1 Right click within the right pane to open a pop up menu 2 Select Show Unallocated Area 3 There is a tick mark on Show Unallocated Area The right pane shows all areas where no section is allocated which is indicated by Unallocated Area in the Name column 13 1 13 Viewing sections of size 0 You can view sections of size 0 By default this function is not selected To view sections of size 0 1 Right click within the right pane to open a pop up menu 2 Select Sho
520. rch You can also search for text in multiple files 4 4 2 Finding text in multiple files To search for text in multiple files 1 Select one of the following operations to open the Find In Files dialog box e Click the Find In Files toolbar button as OR e Press the F4 key OR e Select Edit gt Find in Files REJ10J2000 0100 Rev 1 00 Jun 16 2009 92 RENESAS High performance Embedded Workshop 4 Editor Find In Files 7 Findwhet fran Infiles types abs asm bin ble c cal co cp c Y Cancel Match case T Match whole word only Regular expressions Qutput to Find in Files 2 Location f Directory C workspace D emoSH4 DemoSH4 Browse W Search sub directories Active project C All loaded projects 2 Enter the text that you want to search for into the Find field or select a previous search string from the drop down list box If you selected text before invoking the find operation the selected text will be automatically placed into the Find what field 3 Enter the file extensions of the files you would like to search into the In files types field If several extensions are specified be sure to separate them with a semicolon e g C H 4 If you would like your search to be case sensitive 1 e to distinguish between upper and lower case letters then check the Match case checkbox 5 If you would like your search to match a whole word as opposed to matching all occ
521. re an error of compiler or assembler occurred at line 12 Not all of the placeholders are relevant in every field For example the LINE placeholder has no meaning when specifying a dependent file s location USERNAME PASSWORD VCDIR and COMMENT placeholders are acceptable only in version control If you enter a placeholder into an edit field where it is not acceptable you will be informed 5 4 Placeholder tips Placeholders are there to allow you to create flexible paths to the various files used by the system If there is a placeholder pop up menu a next to an edit field into which you are about to enter a path or file you should consider how you can use a placeholder to make that path or file definition flexible If you use several configurations then the CONFIGDIR placeholder is very useful to ensure that files can be written to and from the current configuration s directory Wherever possible use a placeholder They can always be removed or added later so don t be afraid to experiment REJ10J2000 0100 Rev 1 00 Jun 16 2009 409 RENESAS High performance Embedded Workshop 6 I O File Format 6 I O File Format High performance Embedded Workshop formats the IO window based on information it finds in an I O Register definition file When you select a debugger High performance Embedded Workshop will look for a lt device gt IO file corresponding to the selected device and load it if it
522. re View Configures the workspace view Relocate Module Opens a dialog box which allows you to select one directory for relocating all files retrieved from the download module Properties Shows the selected download module setting in the Download Module dialog box This download module setting can be modified The download module will be unloaded if it has already been downloaded Note If you use a debug only project i e Debugger only xxxxxx this menu option will be displayed Right clicking on a file retrieved from the download module opens a pop up menu containing the available options Available only when you use the debug only project Pop up Menu Option Macro Recording Function Open lt file name gt Opens a file in the High performance Embedded Workshop editor Add File Adds files to a project Configure View Configures the workspace view Relocated file s Opens a dialog box which allows you to select the same short filename retrieved from the download module at a new location Properties Displays file properties Right clicking on the Dependencies folder opens a pop up menu containing the available options Pop up Menu Option Macro Recording Function Configure View Configures the workspace view Right clicking on a dependence file opens a pop up menu containing the available options Pop up Menu Option Macro Recording Function Version Control Executes a version control system Configure
523. re test image file from the workspace window pop up menu 16 8 Running tests This allows you to select tests and automate their execution To run tests 1 Select Test gt Run Tests The Run Tests dialog box opens Run Tests Test Suite Demo Test cases Ok Tes Demo Demonstration Cancel Mase up LL EEE Mowe danm Action after test execution Compare apstem against sawed test image file M Automatically save test results Test timeoutia fio Stop at first failure 2 All tests currently defined in the High performance Embedded Workshop test system are listed in the Test cases list REJ10J2000 0100 Rev 1 00 Jun 16 2009 256 RENESAS High performance Embedded Workshop 16 Test Support Facility 3 Clicking the check box selects the test for execution in this test run It is also possible to modify the order a test is executed in by selecting the test and clicking the Move up and Move down buttons 5 When one or more tests have been selected the Run button is enabled Clicking this Run button starts the test run Information will be shown in Test tab of the output window as the tests are executed 6 Once completed the test browser will be displayed and will show the test results for all tests executed The Action after test case execution drop down list allows you two options The Compare system against saved test image file is the normal operation and allows the current High performance Embe
524. rectly added to the project To drag and drop folders Drag and drop of a folder from the Windows Explorer opens the Add Files From Folder dialog box which allows you to select the files in the folder that you wish to add to the project This dialog box shows the names of all files included in the folder that was dropped Filename and File Type show the full paths of files and file types respectively Add Files From Folder Ei E4 Select the files to add Filename O CidSCWF le Type LWWorkspace DemoSH4 DemoSH4sintorg src Assembly source file Lancel CWWorkspace DemoSH4 DemoSH4slowlylarnc Assembly source fle LWorkspace DemoSH4 DemoSH4vectbl Assembly source file Uncheck All CWoorkepacesDemoSH4 DemoSH4yvhandl Assembly source file LWorkspace DemoSH4 DemoSH4dbsctc C source file LWWWorkspace DemoSH4 DemoSH4 Demos C source file LWorkspace DemoSH4 DemoSH4slowsre c C source file LWWorkspace DemoSH4 DemoSH4 resetor C source file CWorkspace DemoSH4 DemoSH4ebrk c C source file CAWWorkspace DemoSH4 DemoSH4 Debug Library file CWWrorkspace DemoSH44 DemoSH4 Debug Object file M Show files in subfolders M Show source files only Create folder structure in project REJ10J2000 0100 Rev 1 00 Jun 16 2009 40 RENESAS High performance Embedded Workshop 2 Build Basics 2 3 3 In the dialog box the files are initially sorted by the file type in alphabetical order If you click a column header of file names or types t
525. reshing the Waveform window cccccccccsccccssssesssssseeeeeeeeeeeeeeeeaaeeeeesseeeeeeeeeeeeeeeeeeaaaaaaaaaeeesees 332 17 5 3 Refreshing the Waveform window ssssssssesseeeeeeeeeeeeeeeeaeeeeeeeseeeeeeeeeeeeeeeeeeeeeeeaaseeeeeesaeeeeeeeeeeeeeeeeeeeeaaaas 333 17 5 4 PP ley A MDS 0 Tt Ae Ey A a E E E E E 333 17 5 5 FSO GIS A saaes arcasteeoatecone E sas nea dacaenaneesaeneanncesageniac ducausasantereeanacosss 333 Io OOM OMG CISA e snes aunnsaCuenabeues tan snes cap buon IE E T E 333 173 7 BRC SCT thezoomdisplay sssrini a E a Ea EEA EEEIEE 333 17 5 8 Set ne the Zoomi IA CHITIC AL OM eas cowersiccamastatidontasesaeahedentuaacaajeniedeiantesadsaiinebcsawansdsdowawhnis OAE 333 17 5 9 Seltine The honzontal scale cre caneessauvasasinctsrmesinsadusctqeasbooreuddansensnssastinneduastivensbausnenniudeeamstineedametmeadbooraadduoetactsneds 334 17 5 10 Non display Of CUTSOT eenneneeeseeeeeeeeeeeesssssssssssssssererrreerressssssssssssseeeteererssssssssssssseteerresssssssssssseeeeereressesssss 334 17 5 11 Displaying the sampling information cccccccccccccceeeeeeesseeseeeseeeeeeceeeeeeeeeaaaaesssssseeeeeeeeeeeeeeseeaaeaaagaagaesees 334 170 Looks a VO ih yt s se rata eg este eset cna vas RN E EEUE EENI EN E EEEE E PE EERI EESE NEE 334 17 6 1 Qpenine the 1O Window atcvtsorcieecongasansaituta sce iaetcace arena tee aeaa an eda t aai e aneii eaaeo 335 17 6 2 Expanding an I O register display ccccccccceeeeececeeeceeeeeeeese
526. ress Enable Disable Breakpoint w Enables or disables the current software breakpoint 17 2 2 6 Refreshing the disassembly view Even if some external operation changes the memory contents shown in the Disassembly view the High performance Embedded Workshop cannot detect the change For example if you use the external flash utility to program the range of memory being displayed the Disassembly view will not be reflected Right click on the Disassembly filed in disassembly mode or mixed mode and select Refresh This acquires the latest information of the data being displayed and updates the contents of the view 17 2 2 7 Disassembly lock refresh It is possible to lock a memory range in the disassembly view so that it does not refresh This function is called the disassembly lock refresh Right click on the Disassembly field in disassembly mode or mixed mode and select Lock Refresh The Lock Refresh dialog box will be displayed Lock Refresh a P Looked Start Address ooonzo00 pa a Cancel End Address Jooon20 A Check the Locked check box The controls should now enable Select the start and end address that should be locked and cached so that no updates are displayed Click OK The view refreshes to only show the locked area 17 2 2 8 Looking at a specific address When you are looking at your program in a Disassembly window you may want to look at another area of your program s code Rather than scro
527. rformance Embedded Workshop products e Recordable functions dependent on the debugger 15 5 1 Recordable functions common to all High performance Embedded Workshop products Recordable functions common to all High performance Embedded Workshop products included in tool packages are listed in the table below e Handling menu options shortcut keys and toolbar buttons While a macro is being recorded if you handle a menu option shortcut key or toolbar button of those listed below or make any setting in a dialog box opened these operations will be recorded into a macro file Menu Menu Option Shortcut Key Toolbar Button File Open Workspace i 3 Save Workspace Close Workspace New Session Import Session Save Session Refresh Session Download A New Module 2 Recent Workspaces Recent Downloaded Modules gt Edit Toggle Breakpoint F9 EG Enable Disable Breakpoint CTRL F9 REJ10J2000 0100 Rev 1 00 Jun 16 2009 217 RENESAS High performance Embedded Workshop Project Set Current Project Insert Project Edit Project Configuration 3 Build 1 Build File Build Build All Build Multiple Clean Current Project Clean All Project Build Configurations 4 Debug Debug Sessions 5 Reset CPU Go Reset Go Free Go 3 Go to Cursor Set PC to Cursor Run Step In Step Over Step Out Step Step Mode Auto Assembly Source Halt Program Initialize Connect 3 Disconnect 3 Save Memory Verify Memory 3
528. rformance Embedded Workshop system as another test image file Properties The Test properties dialog box opens It displays the test name test description test location and the last modified date 16 11 Configuring the Test tab of the Output window The Test tab of the output window displays the results and progress of the current test execution The test execution progress shows the current test being executed and the number of tests remaining If errors occur then these are displayed in this window Starting tests test suite lt Test Suite Name gt lt Compare Conditions gt lt Save Conditions gt continue on failure timeout 10 Running test lt Test Name gt X of Y Running batch file macro lt Macro Name gt X of Y Classification Item Run Tests dialog box Example Figure below Starting tests lt Test Suite Name gt TestSuite test suite lt Compare Conditions gt Action after test execution Compare system against comparing results drop down list box saved test image file Refresh test image file refreshing results lt Save Conditions gt Automatically save test ma Default saving results results E not saving results lt Error Condition gt Stop at first failure ma stop on failure E Default continue on failure lt Time out gt Test timeout Optional Default 10 timeout 10 Running test lt Test Name gt Test_01 Test_02 Xof Y 1 of 2 X is the current test number and 2 of 2 Y is the total number o
529. rformance Embedded Workshop then loads the windows in the new configurations style Another method of changing the desktop configuration is as follows 1 Select Window gt Virtual Desktop 2 Select is cascaded menu 3 Then select the desktop configuration you wish to view on this menu The selected option is ticked REJ10J2000 0100 Rev 1 00 Jun 16 2009 133 RENESAS High performance Embedded Workshop 7 Version Control 7 Version Control The High performance Embedded Workshop provides facilities for connecting to version control system Some of the reasons why version control systems are used with a project are e To maintain the integrity of a project e To store each stage of a project e To enable different users to co develop a project by controlling revisions to its source files Figure below illustrates a typical project where a version control system is in use This shows three users who all use the same shared network drive to exchange source code The version control system provides access and updates to the source files NETWORK _ 1 m Tat r Fr T e e Files Supported for Version Control by the High performance Embedded Workshop Version control by the High performance Embedded Workshop basically supports the following types of files File type Extension Group File Extension Supported CPU Type Workspace file HEW Workspace hws Common Project file HEW Projects hwp Common File f
530. rk with the files of your project The editor allows you to have many files open at one time to switch between them to arrange them in different configurations and to edit them in whichever order you want to The operations that you can perform upon the windows are typical of most Windows applications and they can be found under the Window menu Menu Option Operation Window gt Cascade Arrange all open windows so that they overlap with the top left of each Editor window visible Window gt Tile Horizontally Arrange all open windows horizontally so that they occupy the entire Editor window without any overlaps Window gt Tile Vertically Arrange all open windows vertically so that they occupy the entire Editor window without any overlaps Window gt Arrange Icons Line up all minimized windows at the bottom of the Editor window Window gt Close All Close all open Editor windows The files within the editor can be displayed in a notebook style This means that each file has a separate tab associated with it to aid in navigating between files To show files in a notebook style M Show files in notebook 1 Select Setup gt Options The Options dialog box opens 2 Select the Editor tab 3 Select the Show files in notebook checkbox as appropriate 4 Click the OK button 4 3 Standard file operations 4 3 1 Creating a new file To create a new editing window Select one of the following operations e Cli
531. rkshop 16 Test Support Facility e To remove a simulated I O range 1 Click the Remove button on the Edit Test Simulated I O dialog box The simulated I O range selected in the Simulated I O list will be removed Only one simulated I O range is selectable in the list Then click OK 16 6 2 6 Code Coverage Coverage window The following table shows information on the test image data to be saved into test image files and test results not matched Test group name Test item name Test image data to be saved into test image files Test result details To make detailed setting Code Coverage Values set as detailed information and the range of data in the Coverage window acquired with this setting No test range is specified by default Range Coverage range Instruction Execution Unmatched test option mismatch at Unmatched address Image Content of the test image file System Data in the current High performance Embedded Workshop system or in another test image file to be compared with Example Range DemoSH4 c Instruction Execution Time mismatch at 0x20E4 Image 1 System 0 If you double click on a test item in the Create New Test Image dialog box a further dialog box for detailed setting opens Edit Test Coverage Ei Ei Available Flanges Ranges to be tested Test Options I Address M Execution Path ve poe Execution Times Pass Cancel The Available Ranges list shows the cover
532. rmatting and selection dialog box From here you can choose your printer and page setup options 17 2 2 Opening the Disassembly window If you wish to view code at assembly language level then select one of the following operations e Choose View gt Disassembly OR e Press CTRL D OR e Click on the View Disassembly toolbar button SA The Disassembly window opens at the current program counter PC location Toolbar View Source Views mired mode View Disassembly Z c S Disassemb Obj Label amp 00020000 ooooz002 ooooz004 Disassembly The disassembly window in version 4 02 onwards has been enhanced to include a source view This integrated view has a toolbar which allows the switching of mode When each mode is available it is possible to click the button and change to the new view REJ10J2000 0100 Rev 1 00 Jun 16 2009 302 RENESAS High performance Embedded Workshop 17 Debugging Facility Three different modes are possible these are listed below Mode Function Source mode The source file relating to the current PC address will be opened if available It allows keywords are highlighted correctly if you are viewing source files This view is read only and cannot be edited This view is only available when the module is downloaded This view allows line numbers address breakpoints and source codes to be viewed Mixed mode The mixed mode facility in the disassembly window is differe
533. roject Generators le HO8S H84300 Project Generator HE A enesas SH Project Generator 4 00 00 9 Project Generators Custom Sia Version Control System Custom WCS MW Show all components When seeking technical support you may be asked to give details about some or all of these components To do so open the respective folder select a component and click the Properties button The Properties dialog box will be invoked The High performance Embedded Workshop also has a feature that outputs tool information regarding the registered components to a file This allows you to retrieve information about the entire High performance Embedded Workshop system This information can then be sent to your technical support contact if you are experiencing problems with the High performance Embedded Workshop To output tool information 1 Select Tools gt Administration The Tools Administration dialog box opens 2 Click the Tool information button A Save tool information file dialog box is displayed 3 Choose the location of the output file and click the OK button 4 A file is created in the chosen location with the current registered tool setup of the High performance Embedded Workshop REJ10J2000 0100 Rev 1 00 Jun 16 2009 114 RENESAS High performance Embedded Workshop 5 Tools Administration If any of the components have problems these can be seen in the tools administration dialog If the icon has an additional icon this explains
534. roject will not be checked 2 14 Removing a project from the workspace To remove a project from a workspace 1 Select the project that you wish to remove in the Projects tab of the workspace window 2 Right click on the selected project to invoke a pop up menu 3 Select Remove Project Note You cannot remove the Current project from the workspace 2 15 Relative projects paths in the workspace In the High performance Embedded Workshop when you add a project you can choose to add the project to the workspace using a relative path This allows you to position a file above the workspace directory and it will still be relocated correctly if you relocate the High performance Embedded Workshop workspace The project is always relative to the workspace so if the project is one directory above the workspace before it is moved the High performance Embedded Workshop will try to find the project in the same relative location after the relocation procedure This is especially useful if you are using a project shared between more than one workspace In older versions of High performance Embedded Workshop this project would not have been relocated and would have still tried to access the original file path The older version of High performance Embedded Workshop could only relocate the projects which were in a sub directory of the workspace directory This is still the standard behavior for the High performance Embedded Workshop To add the project
535. rs Support for this function depends on the debugger 17 3 29 Changing text colors The color and font of the data or codes shown in the Memory window can be customized in the Format Views dialog box in the same manner as the color and font in other windows Now it is also possible to customize the color of the changed values or accessed memory which are shown in the data or code field of the Memory window in the Format Views dialog box To change the look of the Memory window 1 Select Setup gt Format Views The Format Views dialog box opens 2 Select the Memory item in the tree and expand it 3 Select the category of objects to be customized Category Objects to be Customized Foreground Background color default color default Normal Text shown in the windows Black White Accessed During coverage measurement Executed codes Black Sky blue Not Accessed During coverage measurement Codes not executed Black Gray Unknown During coverage measurement The outside in coverage area Black White No Memory The outside in memory area Gray Gray Modified Changed values Red White Note Support for this function depends on the debugger Modify the Foreground and Background color selection on the Color tabbed page as desired Click OK 17 4 Displaying memory contents as an Image The memory contents can be displayed as an image in the Image window Support for this function depends on the debugger REJ10J2000 01
536. rsion control directory mapping for c work application project1 2 FILE1 C is substituted for FILENAME REJ10J2000 0100 Rev 1 00 Jun 16 2009 143 RENESAS High performance Embedded Workshop 8 Custom Version Control System Project File c work application projectl filel c T Arguments Aa VCDI FILENAME e C E OJ Y g command xi vchswiapp projectl filel c 8 8 Specifying environment Select the Projects tab of the Version Control Setup dialog box to view the current settings To add a new environment variable 1 Click the Add button beside the Environment list the Environment Variable dialog box will be invoked Environment ariable Ei ES Varnable Ok k Value Cancel i Placeholder popup menu 2 Enter the variable name into the Variable field 3 Enter the variable s value into the Value field 4 Click the OK button to add the new variable to the Environment list To modify an environment variable 1 Select the variable that you want to modify from the Environment list 2 Click the Modify button beside the list 3 Make the required changes to the Variable and Value fields 4 Click the OK button to add the modified variable back to the list To remove an environment variable 1 Select the variable that you want to remove from the Environment list 2 Click the Remove button beside the list 8 9 Controlling execution of a Vers
537. s been selected one Debugger will be opened in the High performance Embedded Workshop application from which the Synchronized Debug dialog box was launched and new High performance Embedded Workshop applications will be opened for the remaining Debuggers If Internal mode was selected the workspace that is common to all the REJ10J2000 0100 Rev 1 00 Jun 16 2009 384 RENESAS High performance Embedded Workshop 18 Synchronized Debugging Debuggers will be opened in the High performance Embedded Workshop application from which the Synchronized Debug dialog box was launched See section 18 2 Using High performance Embedded Workshop when synchronized for details on how to use High performance Embedded Workshop while synchronized 18 1 7 Update synchronized debugging If synchronized debug mode was already running when the Synchronized Debug dialog was opened there will be an Update button instead of a Sync button After the Update button is clicked the system will update according to the new settings that have been specified since opening the Synchronized Debug This might include opening additional High performance Embedded Workshop applications when using Parallel mode See section 18 2 Using High performance Embedded Workshop when synchronized for details on how to use High performance Embedded Workshop while synchronized 18 1 8 Stop synchronized debugging If already running in synchronized debug mode when the Synchronized Debug dialog w
538. s for SuperH family Simulator debuggers for H8SX H8S and H8 families Emulator software for the E200F emulators ROEO200FOEMUOO and ROEO2Z00F2EMUOO revised to V 1 08 Release 00 and later E8 emulator software V 2 10 Release 00 and later E8a emulator software E10A USB emulator software V 2 13 Release 00 and later H8SX Device group E100 emulator debugger E200F emulator software E100 emulator debugger Emulator software for E200F emulators ROEO200FOEMUOO0 and ROEO200F2EMUOO revised to V 1 08 Release 00 and later E100 emulator debugger Support of this function depends on the debugger in use For details refer to the user s manual help files or the release notes for the emulator or the simulator debugger REJ10J2000 0100 Rev 1 00 Jun 16 2009 222 CENESAS High performance Embedded Workshop 15 Macro Recording Support Facility 15 5 2 1 Editor window While a macro is being recorded the following operation will be recorded into a macro file Display Mode Target Operation Function Source mode Instant Watch pop up menu Make setting in the dialog box opened by clicking Adds a symbol option on the menu option e E8 emulator software V 2 10 Release 00 and later e E8a emulator software e E10A USB emulator software V 2 13 Release 00 and later H8SX Device group Target Operation Function Event Breakpoints column Double click on the column Sets or clears a hardware breakpoint 15 5 2 2 Disassembly window While a
539. s into Visual SourceSate ccccccccecccceecceccecaeeeeeeseeseececeeeeeeeeeeeaaaaaas 164 9 2 6 Viewing the status of files in Visual SourceSafe 2 0 ccccsssssssssssseseeeeccceeeeeeeeeeaaeaeessseeeeeeeeeeeeeeeeeeaaeaqaas 165 F2 Undoing a check out command in Visual SourceSafe 20 0 ccessssesseseeeececeeeeeeeeeeaaaaeessseeeeeeeeeeeeeeeeeeaaaaaaas 165 9 2 8 Viewing the history of files in Visual SourceSafe 2 0 0 ccccccsssssssseseeeececeeceeeeeeeaaaaeesseseeeeeeeeeeeeeeeeeeeeeeaaas 166 9 3 Visual SourceSafe command options ccessseeeeccccceceeeeeeeeaessssssseeeeeeeeeeeeeeeeeeeeaaesesssseeeeeeeeeeeeeeeeaaaaseesnseeeseeeeees 167 OA Vet OM COMO SCOP aera a E EE E E E A E E E EAEN EE AEE R 167 9 5 SPee yine AEO ONS ae e E E E E E EEE 167 9 6 Adding Visual SourceSafe COMMANAS cccccccssssssssseeeseeeeeceeeeeeeeeeaaeseeseeseeeeeeeeeeeeeeeeeeaasesessesseeeeeeeeeeeeeeeeeeeeeaaas 169 10 Sharing Projects by Network Facilities ceecccccccceccceesseeeeecceeeeeeaeessseeceeeeeesseeeeeeeeeeeeenaas 171 10 1 Sharing projects by network facilities in a PC with Windows XP Service Pack 2 or later eeeeeeeeees 172 10 2 Enabling network facilities to share projects cccccccccccccccccceeceeaeeessesseseeeceeeeeeeeeseesaasseesseeeeeeeeeeeeeeeeeeeeeaaaaaesesesss 174 10 3 Setting the administrator user s password seeeeesseseeecccceeeeeeeaaeeeeeeseeseeeeeeeeeeeeeeeessaseseeeeeeeeeeeeeeeeeeeeesauaaaaeaensees 174 10 4 Adding
540. s 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 C D me lt Q 5 Cc Q High performance Embedded Workshop V 4 06 User s Manual Renesas Microcomputer Development Environment System Renesas Electronics Rev 1 00 2009 06 WWW Frenesas com 10 11 12 13 Notes regarding these materials This document is provided for reference purposes only so that Renesas customers may select the appropriate Renesas products for their use Renesas neither makes warranties or representations with respect to the accuracy or completeness of the information contained in this document nor grants any license to any intellectual property rights or any other rights of Renesas or any third party with respect to the information in this document Renesas shall have no liability for damages or infringement of any intellectual property or other rights arising out of the use of any information in this document including but not limited to product data diagrams charts programs algorithms and application circuit examples You should not use the products or the technology described in this document for the purpose of military applications such as the development of
541. s rights button The User access rights dialog is displayed Select the user you wish to remove in the users list Press the Remove button oo oy ot Soe e Then click OK to save the access rights changes REJ10J2000 0100 Rev 1 00 Jun 16 2009 175 RENESAS High performance Embedded Workshop 10 Sharing Projects by Network Facilities User access rights ki ES User access rights Access level Add Remove Administrator Full read write access C Read write file access only f Read only access 10 5 Changing your password To change your password 1 Log into the High performance Embedded Workshop network database you are changing your password for Select Setup gt Options The Options dialog box opens Select the Network tab Click the Password button Enter your new password and confirm it in the second edit box Click OK Then click OK to save the password change YS YS 10 6 Note on using the network facilities to share projects When you share a networked project for the first time the High performance Embedded Workshop automatically connects you to the correct network High performance Embedded Workshop service This is defined using machine name If the workspace cannot be found using the machine name then the dialog below appears Simply type or browse the location of the machine and click OK If you want to be the server machine then leave the radio button on its default selection use local ma
542. s selectable in the list Then click OK 16 6 1 6 Code StackTrace StackTrace window The following table shows information on the test image data to be saved into test image files and test results not matched REJ10J2000 0100 Rev 1 00 Jun 16 2009 242 RENESAS High performance Embedded Workshop 16 Test Support Facility Test group name Code Test item name StackTrace Test image data to be Values set as detailed information and data within nested function calls in the StackTrace window The saved into test image files default value in Nest level is 10 Test result details Src Content of the test image file Dest Data in the current HEW system or in another test image file to be compared with Example Value differs Src F PowerON_Reset_PC 0000080E Dest F PowerON_Reset_PC 0000081C To make detailed setting If you double click on a test item in the Create New Test Image dialog box a further dialog box for detailed setting opens Edit Test StackTrace ki E4 Nest level 1 64 li T Symbol Pararneter Local Variable Cancel Ignore address 1 The range of stack trace information to be saved into the test image file is determined by the number of nest levels specified in Nest level 2 To compare parameters or local variables select checkbox Parameter or Local Variable These checkbox are not selected by default 3 If you do not wish to compare the address of the selected regi
543. s the current batch file Stop Stops execution of the current batch file Set Log File tod Specifies a log file Logging j Starts or stops output to log file Browse Enters a full path to the file Placeholder Configuration Configuration Directory Pastes the CONFIGDIR placeholder directory D Configuration Pastes the CONFIGNAME placeholder name Project directory Pastes the PROJDIR placeholder Project name gt Pastes the PROJECTNAME placeholder Workspace Pastes the WORKSPDIR placeholder directory Workspace Pastes the WORKSPNAME placeholder name HEW Installation Pastes the HEWDIR placeholder directory Select All Selects i e highlights the entire contents of the active window Copy Places a copy of the highlighted text into the Windows clipboard Cut Removes the selected text block and copy them onto the Windows clipboard Paste Copies the contents of the Windows clipboard into the active window at the position of the insertion cursor Clear Window Clears the contents of the Command Line window mS BB a Aa Undo Undoes the last operation Once an opening bracket or is input and the nesting follows this button is visible This button selection is impossible Toolbar display Shows or hides the toolbar Customize toolbar Customizes toolbar buttons e Debugger tab o Upper pane contents of the batch file Right clicking
544. s24 55 EXE Browse Gancel Greuments Properties VEIUSERNAMEVEPASSWORD i BOVCDIRI SCF ILI hitial directory E FILEDIF Browse Environment Command return code f Return code of command is not meaningful C Command has failed if the return code is Not Equal To r i Enter the executable file SS EXE for version control system in Version control executable Enter Properties y USERNAME PASSWORD i VCDIR FILENAME in Arguments Enter FILEDIR in Initial directory Click the OK button Click the OK button in the Add Menu Option dialog box For detail see section 8 2 Defining Version Control commands eo e Command Execution 1 Select Tools gt Version Control gt Properties 2 Select the file in the Properties dialog box and click the OK button 3 Output information on execution of this command will be shown in the Version Control tab of the Output window REJ10J2000 0100 Rev 1 00 Jun 16 2009 170 RENESAS High performance Embedded Workshop 10 Sharing Projects by Network Facilities 10 Sharing Projects by Network Facilities The High performance Embedded Workshop is capable of sharing workspaces and projects across a network This allows users to concurrently work on shared projects and see each other s changes as they happen This system can be used in conjunction with version control The major difference with using this system is that each user
545. sacnmecesacanzartesnnnanteneceanasonasaaulaopuawauidananaeXeanbicmarsedudanearasamswanneaeisanedeoaeatiahensapheennnsetageseensdeaaesh 5 1 2 5 Eor NOW e EE A E EE EE E E EEE EA E EE EEE E E 8 1 2 6 Output W111 OWN arses dress tastivunncancasteedncceriamondaused etuentnasntastofucisuaatietdactatadannsemanGastasedsenicotsleaadndoantemeseastanudsoucakeaskabonens 9 1 2 7 PEELS I T E E T E A A A T A E 12 1 3 HIS a E E E es 12 1 4 Launching the High performance Embedded Workshop cc ssssesssssesseeeeceeeeceeeeeeaaaaasseseeeeeeeceeeeeeseeeeaaaaaseeees 13 1 5 Ga WOU SAG E E E N AE N A E E T 13 1 6 Oon A WOR SACS E E E A A E E E E T E 14 k UEO work Pai ES en E E 15 1 8 SAV O E aa E E 15 E NSTI OTS CC E E E A E A E 16 1 10 Exiting the High performance Embedded Workshop ccccccccccccccsssssssseseseeeccceecceceeeeeeeeeaaeeessseseeeeeeeeeeeessueaesensnss 16 Ill Component System OV EL VICW bererin aeie ea AE eE O E Re a ariet 16 1 12 Management information files of High performance Embedded Workshop cccccsssssssssseeeeeeeeeeeeeeeeeeeeaeeeeees 16 1 13 Overview of Configurations and Sessions ii siicats cotescastessnseacadesdadandensohedchege SanabaceieacSeceddacbidedeadyedadanteediaanduacenenabacedaaae 17 1 14 Overview of Macro Recording Support facility and Test Support facility ccsssssssseeseeeeeeeeeeeeeeeaeeseeeeeeeees 21 1 14 1 Pa ample of test Procedures ore vad agahacaanne s EE a EEEo Eiei 24 1 14 2 PER O E a T E E E EA 2
546. sct c oWorkep 4 mand ee ae Comment ig The Check out from VCS dialog box opens Select the checkbox on the left to the name of the file that you wish to obtain and click the OK button When the operation is finished the file has a red mark next to its name This means you as the current user of High performance Embedded Workshop has checked it out REJ10J2000 0100 Rev 1 00 Jun 16 2009 163 RENESAS High performance Embedded Workshop 9 Visual SourceSafe Version Control System Fy Workspace Mame El fey Project Name v A 2 Assembly source file a ntprge sre lowlvilsrc v vectiblerc w vHandlersrc w lowerc c w FProject_Name c w resetpre c w abrk c w Download modules Project_Name abs OOO00000 Dependencies erv inc w B lowerc h w sbrk h w stackscth w B typedefine h w E vectine w 9 2 5 Checking in writable copy of files into Visual SourceSafe Visual SourceSafe protects your source files and ensures that only one user can have a writable copy of a controlled file at any one time The check out operation takes a writable copy of the file from Visual SourceSafe and places it on your local drive Once a file is checked out it is edited and then checked back in so that the edits can be made available to other users To check in edits made to files in Visual SourceSafe 1 Select the files that you would like to check back into Visual SourceSafe in the Projects tab of the workspace win
547. se name in the Phase order list REJ10J2000 0100 Rev 1 00 Jun 16 2009 73 RENESAS High performance Embedded Workshop 3 Advanced Build Features 3 3 3 File Mappings tab By default the files input to a build phase are only taken from the project 1 e all project files of the type specified in the Select input file group drop down list on the New Build Phase dialog box Select Build gt Build Phases The Build Phases dialog box will be displayed If you would like a build phase to take files output from a previous build phase these files are called intermediate files then you must define this in the File Mappings tab of the Build Phases dialog box Build Order Build File Order File Mappings hter mediate file mappings ftor build Add SH Assembler Opt Linker Object file SH G Com SH Assembler Assembly source file Modify SH G G Gom OptLinker Object file SH G Libra OptLinker Library file 5 RenGve A File Mapping means that you would like the output files of a certain type produced by one build phase referred to as the Source phase to another build phase referred to as the Destination phase Such intermediate files are then passed in addition to the project files To add a file mapping 1 Click the Add button The Define File Mapping dialog box opens 2 Select an existing file group to use for the new mapping from the File group drop down list 3 Select the source phase i e
548. selecting one of the following operations e Double click the register you want to change OR e Select the register you want to change and choose the Edit option from the pop up menu PO Set Value hole Register Cancel You can enter a number or C C expression in the Value field You can choose the radix from the Radix drop down list box You can choose whether to modify the entire contents of the register a masked area floating bits or flag bits by selecting an option from the Set As drop down list box the contents of this list depends on the CPU and selected register REJ10J2000 0100 Rev 1 00 Jun 16 2009 343 RENESAS High performance Embedded Workshop 17 Debugging Facility When you have entered the new number or expression click the OK button or press Enter The dialog box closes and the new value is written into the register 17 7 7 Setting the flag value When the flag itself is displayed Click the button of the flag to be changed Every time you click the button the flag status 1 0 is switched If a flag is composed of multiple bits a dialog is opened where you can enter a value to be changed Screenshot of the SH 4 debugger Register FLAG 2 Fuac opiac ufFiac trm ao When the flag is displayed in the register Double click the FLG line A dialog opens Enter the value to be changed Screenshot of the SH 4 debugger FLG line FPSCR 17 7 8 Splitting up the window display To
549. sers lt user name gt AppData Local 18 1 The Synchronized Debug dialog box Select Synchronized Debugging from the Debug menu to open the Synchronized Debug dialog box This can be done when High performance Embedded Workshop initially starts up or when there is a workspace open There is also an option to open the dialog from the High performance Embedded Workshop Welcome dialog box Synchronized Debug Ei Curent configuration Defaut New Import Jave AS Delete Available debuggers Debugger ID Workspace Session Add Main Not open Debug Hulk core LAWorkspacesDemo Demo Corel Video Not open Debug Multi core CAWoorkepacesDemo lemo Corel arity Hemose Synchronization style Synchronization options C None M Reset All debuggers synchronized C Master debugger fain hi gc Operations executed on any debugger will Operations executed on the master debugger 7 also be executed on all other debuggers will be executed on all other debuggers W Break Halt I Step Set by platform D o D Connection l Download modules Initialize ug M Update the views in all debuggers when platform memory is changed Synchronized debugging mode Parallel Update Spe REJ10J2000 0100 Rev 1 00 Jun 16 2009 378 RENESAS High performance Embedded Workshop 18 Synchronized Debugging 18 1 1 Managing configurations Current configuration New Import Save as
550. set up the version control toolbar and menu for immediate access 9 2 Visual SourceSafe commands The following eight commands are available via the version control toolbar or menu Tools gt Version Control menu Version Control Toolbar Function Add to VCS Adding files to Visual SourceSafe Remove from VCS Removing files from Visual SourceSafe Get from VCS Getting read only copy of files from Visual SourceSafe Check out from VCS Checking out writable copy of files from Visual SourceSafe Check in to VCS Checking in writable copy of files into Visual SourceSafe J G3 Dm dpe Get VCS status Viewing the status of files in Visual SourceSafe Undo Check Out Undoing a check out operation in Visual SourceSafe Show History Viewing the history of files in Visual SourceSafe REJ10J2000 0100 Rev 1 00 Jun 16 2009 160 RENESAS High performance Embedded Workshop 9 Visual SourceSafe Version Control System 9 2 1 Adding files to Visual SourceSafe In the previous section a mapping between the workspace directory on your hard disk i e the working directory and the project directory in Visual SourceSafe 1 e the directory controlled by Visual SourceSafe has been established However the project directory and any subdirectories on your hard disk may contain many source files whereas the directory it is mapped to in Visual SourceSafe will be initially empty You need to add files to the Visual SourceSafe project To add files to Vi
551. sion Control System iy 2 3 4 Select Tools gt Version Control gt Select Select ersion Control System EAE Version control system Custom WCS Cancel The Select Version Control System dialog box opens Select Custom VCS Click the OK button 8 11 2 3 Step 3 Making settings for Version Control Select Tools gt Version Control gt Configure to open the Version Control Setup dialog box L pA 3 4 Setting environment variables Select the Projects tab Click the Add button on Environment The Environment dialog box appears Enter CVSROOT in Variable and C cvs 1 11 17 DATABASE in Value respectively REJ10J2000 0100 Rev 1 00 Jun 16 2009 152 RENESAS High performance Embedded Workshop 8 Custom Version Control System Yersion Control Setup Ei Ei Commands Projects General Show details for project samplely S Details Version control directory mappings Source Director Version Control Director Moditi Hemose Environment lelin Rew Cancel Esport Import 5 Click the OK button e Setting up commands Select the Commands tab Click the Add button on User menu options The Add Menu Option dialog box appears Enter Initialize in Option and click the Add button The Add Command dialog box appears Enter C cvs 1 11 17 cvs exe in Version control executable Enter init in Arguments A T Oom AA eS Sl Enter C src
552. sion and file group If you want to manage files that are not by default recognized by the High performance Embedded Workshop e g documents then you need to create a new extension and a new file group To create a new file extension in a new file group 1 Select Project gt File Extensions The File Extensions dialog box opens 2 Click the Add button The Add File Extension dialog box opens Add File Extension File extension txt x Cancel File group f Extension belongs to an existing group Absolute file f Extension belongs to a new group Text Sssociated application Open Text with windows default gda Madin Remove EL 3 Enter the extension that you want to define into the File extension field Use only alphanumeric and an underscore as characters of a file extension string The drop down list contains all extensions that are undefined in the current project Selecting one of these extensions will add the text to the file extension field automatically 4 Select the Extension belongs to new group option and enter a description that defines this new file group 5 At this stage it is possible to change the associated application There are four available choices in the Open lt extension group gt with drop down list Editor None Other Windows default REJ10J2000 0100 Rev 1 00 Jun 16 2009 47 RENESAS High performance Embedded Workshop 2 Bui
553. sott Visual SourceSafe Ponce 3 Click OK The SourceSafe Login dialog box opens REJ10J2000 0100 Rev 1 00 Jun 16 2009 158 RENESAS High performance Embedded Workshop 9 Visual SourceSafe Version Control System SourceSafe Login Username User0i Password au Database path Login Cancel 4 Enter your Visual SourceSafe username into the Username field and password into the Password field 5 For the Database path field specify the Visual SourceSafe database file SRCSAFE INI into which you would like to add this project Select either of the following operations e Click the Browse button to open the Select Visual SourceSafe database dialog box Select the Visual SourceSafe database file and click the Select button OR select VWisual Sourcesate database Look in B vss t data mind netzetup x86 ercsafe ini Ci E SFC setup temp Template USES File name ercsafe ini Files of type Visual SourceSafe databases srcsate ini Cancel Ae e Enter the full path of the Visual SourceSafe database file in the Database path field 6 The Create SourceSafe Project For Workspace dialog box was displayed Cancel 7 The Project name field shows the name of the High performance Embedded Workshop workspace The Project name field displays the name of the project i e folder to be created in the database If necessary you can change this name to another 8 Th
554. space Window or by the main menu File gt Open 17 2 2 3 Opening a source file in the Disassembly window Opening a source file is possible by selecting Open File in Source Mode from the pop up menu in Disassembly window This menu option is available on the pop up menu in all view modes within the Disassembly window Upon selecting this menu option a file browse dialog will be displayed prompting for the source file to be opened Any text based file may be selected and not just source files 17 2 2 4 Using disassembly source mode as primary debug view It is possible to use disassembly source mode as primary debug view To use disassembly source mode as primary debug view 1 Select Setup gt Options The Options dialog box opens 2 Select the Debug tab REJ10J2000 0100 Rev 1 00 Jun 16 2009 304 RENESAS High performance Embedded Workshop 17 Debugging Facility 3 Select the Use disassembly source mode as primary debug view checkbox By default this checkbox is not selected 4 Click OK If this option is set the following actions will be performed e If the Disassembly window is open and in Disassembly mode then when a break occurs at a known source address the Disassembly window will switch to source mode e If the Disassembly window is open then when a break occurs no other editor windows are opened e When a break occurs the window order will not be changed automatically e The position of the source file in t
555. space is created sample source files for the microcomputer in use are automatically generated These files contain sample code and this does not indicate that the operations of all programs based on that code are guaranteed Please read the hardware manual for the microcomputer to check if the generated source code is applicable and modify the code as required REJ10J2000 0100 Rev 1 00 Jun 16 2009 RENESAS High performance Embedded Workshop Introduction About This User s Manual This user s manual describes the High performance Embedded Workshop system This user s manual describes information on the basic look and feel of the High performance Embedded Workshop and customizing the High performance Embedded Workshop environment and detail the build and the debugging functions common to the High performance Embedded Workshop products The figures in this document show the High performance Embedded Workshop operating with a debugger for the SuperH family For details on the debugger refer to the user s manual or help information for the emulator or simulator included in the package This user s manual does not intend to explain how to write C C or assembly language programs how to use any particular operating system or how best to tailor code for the individual devices These issues are left to the respective user s manuals The High performance Embedded Workshop is customized in various languages This user s manual gives descript
556. splay then the source program corresponding to the function which has been selected by opening the editor window is displayed REJ10J2000 0100 Rev 1 00 Jun 16 2009 353 RENESAS High performance Embedded Workshop 17 Debugging Facility 17 16 3 Specifying the view Choose View Setting from the pop up menu to open the Stack Trace Setting dialog box which allows the user to specify the Stack Trace window settings stack Trace Setting Nest level 1 64 fio Display symbol Parameter Local Variable Diaplay Radix Hexadecimal C Decimal C Octal C Binary Cancel Nest level Specifies the level of function call nesting to be displayed in the Stack Trace window Display symbol Specifies the symbol types to be displayed in addition to functions Display Radix Specifies the radix for displays in the Stack Trace window Note Support for this function depends on the debugger 17 16 4 Selecting an encoding format If the values of variables are characters or strings and they should be displayed as UTF 8 code select Setup gt Options to open the Options dialog box Click on the Debug tab and select UTF 8 for Encoding Format The Watch window now shows the values of variables as UTF 8 code If Local Code Page default has been selected for Encoding Format the values are displayed as ASCII code Note The default font for display in the Watch window is Courier New which is not supported by UTF
557. splays the width Height Displays the height 17 5 Displaying memory contents as Waveforms Memory contents can be displayed as wave forms in the Waveform window Support for this function depends on the debugger 17 5 1 Opening the Waveform window Choose View gt Graphic gt Waveform or click the Waveform toolbar button E3 to open the Waveform Properties dialog box Waveform Properties Ei Data Address ooooo0og al OF Data Size Ebit Cancel Channel Mono Stereo Buffer SizelHex 00000000 Specifies the waveform format The following items can be specified Data Address Specifies the start address of data in memory Displayed in hexadecimal Data Size Selects 8bit or 16bit Channel Specifies Mono or Stereo Buffer Size Hex Specifies the buffer size of data Displayed in hexadecimal After the settings have been made in the Waveform Properties dialog box clicking the OK button opens the Waveform window Even after the Waveform window is displayed the display contents can be modified by opening this dialog box by choosing Properties from the pop up menu Displays the memory contents as waveforms The X coordinate shows the number of sampling data and the Y coordinate shows the sampling value REJ10J2000 0100 Rev 1 00 Jun 16 2009 331 RENESAS High performance Embedded Workshop 17 Debugging Facility e If you double click the coordinate where you wish to view the sampling inf
558. ssion dialog box 10 Click the Edit Limits button in the Launch and Activation Permission area to open the Launch Permission dialog box 11 Select Everyone in the Group or user names list 12 Select the Allow checkbox for Local Launch in the Permission for Everyone list Select the Allow checkbox for Remote Activation in the Permission for Everyone list 13 Click the OK button and close the Launch Permission dialog box 14 Click the OK button on the My Computer Properties dialog box 15 Close the Component Services window e Fora client machine with Windows XP Service Pack 2 or later Firewall L A gt 10 11 2 13 Select Control Panel from the Windows start menu Click Network and Internet Connections in the Control Panel Click Windows Firewall in the Network and Internet Connections The Windows Firewall dialog box is invoked Click the Exceptions tab Click the Add Program button to open the Add a Program dialog box Click the Browse button and select HEW2 exe under the High performance Embedded Workshop installation directory Click the OK button and close the Add a Program dialog box Click the Add Port button to open the Add a Port dialog box Enter DCOM in Name and 135 in Port Number and select TCP option button Click the OK button and close the Add a Port dialog box Click the OK button in the Windows Firewall dialog box Close the Network and Internet Connections Close the Control Pan
559. st Suite Test suites are independent to the current High performance Embedded Workshop workspace This allows your test suite to work with multiple workspaces and projects to test different situations in one test suite The open_workspace and change_project commands all work with the test suite feature so allow you to control which workspace is currently in use REJ10J2000 0100 Rev 1 00 Jun 16 2009 232 RENESAS High performance Embedded Workshop 16 Test Support Facility To create a test suite 1 Select Test gt Create New Test Suite The Create New Test Suite dialog box opens Create New Test Suite Ei Ed Test suite name Cancel Directory for test suite E Workspace D emosH4 Browse 2 Enter the test suite name 3 Initially the workspace directory is shown in Directory for test suite This can be modified as required 4 Clicking OK The test suite is then created This then enables a number of other options on the Test menu Once the test suite is created the Test tab of the workspace window has the test suite added to it This tab allows quick navigation around your test suite and fast access to the tests A file is located in the destination location with the filename HTS High performance Embedded Workshop test suite 16 2 Opening and closing test suites Once a test suite is created it is saved to a file with the extension HTS High performance Embedded Workshop test suite To open th
560. standard file dialog box opens Choose the filename to load the keyboard layout from 4 Click OK To export keyboard shortcuts 1 Click the Export button A standard file dialog is displayed 2 Choose the filename to save the settings of the currently selected keyboard layout to 3 Click OK 6 7 Scope of a control in the setup 6 7 1 Scope of a control in the Customize dialog box The scope of each control in the Customize dialog box which is launched via Setup gt Customize differs This can be confusing so these have been listed below REJ10J2000 0100 Rev 1 00 Jun 16 2009 125 RENESAS High performance Embedded Workshop Tab Control Toolbar All Command All Menu Application wide tools Workspace wide tools Placeholders Application wide custom placeholder Workspace wide placeholder Debugger Debugger tool Debugger location Command line options Session file Download module Log All Help All Keyboard All 6 7 2 Scope of a control in the Options dialog box 6 Customizing the Environment Scope Each workspace The whole system The whole system Each workspace The whole system Each workspace Each project Default whole system and each project basis Each project Each project Each project Each workspace Each workspace The whole system Scope of each control of each tab of the Options dialog box which is launched via Setup gt Options affects the whole system 6 8 Specifying workspace options T
561. ster select the Ignore address checkbox This checkbox is not selected by default 4 Click OK 16 6 2 Functions that can be saved into test image files dependent on the debugger Among the High performance Embedded Workshop functions dependent on the debugger test image data of the test items listed below can be saved into test image files The following table shows the test items in the Create New Test Image dialog box and the corresponding windows from which the data will be saved into test image files For more information on the test image data to be saved into test image files how to make detailed setting and test results see the descriptions of test items for the corresponding windows Create New Test Image Dialog Box Window Name Opened by Supported Debugger Test Group Name Test Item Name Symbol Watch Watch Visita Symbol gt Simulator debuggers for SuperH family ee EEES e Simulator debuggers for H8SX H8S and H8 Locals Locals View gt Symbol gt families Locals Emulator debuggers for SuperH family Emulator debuggers for H8SX H8S and H8 families Exclude the following debugger H8 300H Tiny series compact emulator REJ10J2000 0100 Rev 1 00 Jun 16 2009 243 RENESAS High performance Embedded Workshop ASMWatch ASMWatch View gt Symbol gt ASMWatch CWatch CWatch View gt Symbol gt CWatch CPU Simulated I O Simulated I O View gt CPU gt Simulated O Code Coverage Coverage View gt Co
562. sters that partially match the entered string will be found 6 Clicking OK starts the search from the first line When an I O register is found this line is highlighted To find the next I O register to match select Find Next in the pop up menu 17 6 11 Finding the next After an I O register in the IO window has been found you can also use Find Next to find the next I O register that meets the requirement REJ10J2000 0100 Rev 1 00 Jun 16 2009 339 RENESAS High performance Embedded Workshop 17 Debugging Facility 17 7 Looking at registers If you are debugging at assembly language level using the Disassembly view you will probably find it useful to see the contents of the CPU s general registers You can do this by using the Register window 17 7 1 Opening the Register window The Register window displays the register data and flag data You can change a register flag value from the window To open the Register window choose View gt CPU gt Registers or click the Registers toolbar button E9 The Register window opens showing all of the CPU s general registers and values Window configuration Screenshot of the SH 4 debugger Column header OOOOO0LO QOOOO000FO OOO40001 e Double clicking the register display line opens a dialog box which allows you to change a register value Macro Recording e The register s contents can be changed by using in place editing Macro Recording e You can change a flag
563. sual SourceSafe 1 Select the files that you would like to add to Visual SourceSafe in the Projects tab of the workspace window You may also select a file folder project folder workspace folder or combination thereof When selecting the project or workspace folder the High performance Embedded Workshop system files will be added to the selected file list For example selecting the project folder will also add the project file HWP to the Files list If the project file is then checked out and the version is newer than when it was last loaded you will be asked whether you want to reload the project Select one of the following operations Click the Add to VCS toolbar button ies OR Select Tools gt Version Control gt Add to VCS OR Right click to invoke a pop up menu and select Version Control gt Add to VCS The Add to VCS dialog box opens Select the checkbox on the left to the name of the file that you wish to add and click the OK button Add to Vos iM Workspace Name hws CAworksp a Mw Project Wamehwp C wworksp Mw Project Name c C worksp i typedetineh C worksp idbsctc sonal ee Pe ana Cancel Comment When you add files to Visual SourceSafe the local versions in your working directory will become read only If you select the Keep checked out checkbox in the Add to VCS dialog box before you check the files into Visual SourceSafe these files can be writable even when they are add
564. supports the Elf Dwarf2 object file format for debugging applications written in C C and assembly language for Renesas microcomputers Key Features e Source level debugging e C C operators e C C99 C expression casting pointers references etc e Ambiguous function names e Overlay memory loading e Watch locals and user defined e Stack trace REJ10J2000 0100 Rev 1 00 Jun 16 2009 360 RENESAS High performance Embedded Workshop Note It is only possible when a compiler that supports C99 specifications is in use 17 18 2 1 C C operators The C C language operators are available amp l l gt gt lt lt C lt gt lt gt I amp amp Il Buffer_start 0x 1000 R1 I B 10001101 pointer 2 increment_size amp H FFFF0000 gt gt D 15 flag ER4 17 18 2 2 C C99 C expressions Expression examples 17 Debugging Facility Object value Specifies direct reference of a member C C p Object gt value Specifies indirect reference of a member C C Class value Specifies reference of a member with class C value Specifies a pointer C C amp value Specifies a reference C C array 0 Specifies an array C C Object value Specifies reference of a member with pointer C g_ value Specifies reference of a global variable C C Class function short Specifies a member function C struct STR value Specifies a cast operation
565. t Debug gt Step Mode Sub menu Function Auto default Automatically chooses the step mode Assembly Steps through assembly instructions Source Steps through source code REJ10J2000 0100 Rev 1 00 Jun 16 2009 349 RENESAS High performance Embedded Workshop 17 Debugging Facility While performing Step In in source mode within the High performance Embedded Workshop editor you may wish to keep the source mode display of the library functions e g printf containing no debugging information By default the execution jumps to the Disassembly window and steps every assembly language instruction You can select not to actually step in addresses where no debugging information exists even when the Step In execution reaches such addresses To select not to step into addresses where no debugging information exists 1 Select Setup gt Options The Options dialog box opens 2 Select the Debug tab 3 Select the Only step in when debug information is available checkbox By default this checkbox is not selected Note Support for this function depends on the debugger 17 13 8 Multiple steps Sometimes you may find it useful to step through several instructions at a time You can do this by using the Step Program dialog box The dialog box also provides an automated step with a selectable delay between steps Open it by choosing Debug gt Step The Step Program dialog box opens Step Program Sheps i Delay 25 seconds Canc
566. t while 1 gt gt printf Data Input n loop 49a53 54 gt oop gt Command s completed successfully You can see the changes made in the file sampleCVS c 8 11 2 10 Step 10 Using the Version Control facility Register the Result 1 Select Tools gt Version Control gt Commit Select the file in the Commit dialog box and click the OK button The Version Control tab of the output window shows the following message Executing C cvs 1 11 17 cvs exe commit m modify sampleCVS c Checking in sampleCVS c C cvs 1 11 17 DATABASE sampleC VS sampleCVS c v lt sampleCVS c new revision 1 2 previous revision 1 1 done Command s completed successfully 8 11 2 11 Step 11 Using the Version Control facility View Logs 1 Select Tools gt Version Control gt Log 2 Select the file in the Log dialog box and click the OK button The Version Control tab of the output window shows the following message Executing C cvs 1 11 17 cvs exe log sampleCVS c RCS file C cvs 1 11 17 DATABASE sampleCVS sampleCVS c v Working file sampleCVS c head 1 2 branch locks strict access list symbolic names rel 20060228 1 1 1 1 Renesas 1 1 1 keyword substitution kv total revisions 3 selected revisions 3 description revision 1 2 REJ10J2000 0100 Rev 1 00 Jun 16 2009 156 RENESAS High performance Embedded Workshop 8 Custom Version Control System date 2006 02 28 03 39 22 author user state
567. t Facility New Data in the current High performance Embedded Workshop system or in another test image file to be compared with Example Original Connected New Step Normal End No detailed setting specific to the test item can be made 16 6 1 2 CPU Register Register window The following table shows information on the test image data to be saved into test image files and test results not matched Test group name CPU Test item name Register Test image data to be All information in the Register window saved into test image files Test result details Failed at register Name of the unmatched register Src Content of the test image file Dest Data in the current High performance Embedded Workshop system or in another test image file to be compared with Example Failed at register R11 Src 0x00000000 Dest 0x00000fff No detailed setting specific to the test item can be made 16 6 1 3 CPU IO IO window The following table shows information on the test image data to be saved into test image files and test results not matched Test group name CPU Test item name lO Test image data to be Values set as detailed information and the range of data in the lO window acquired with this setting No saved into test image files 1 O register is specified by default Test result details Failed at Name of the unmatched I O register Src Content of the test image file Dest Data in the current High performance Embedded Workshop system or in anothe
568. t cursor Sets or clears a software breakpoint While a macro is being recorded the following operations will be recorded into a macro file Function Edit pop up menu option Make setting in the dialog box opened by clicking on the menu option Changes a register s content Target Operation Flag register Click on the flag register Value In place edit Make setting in a dialog box opened by double clicking a value Note Support for this function depends on the debugger 15 5 1 5 Memory window While a macro is being recorded the following operations will be recorded into a macro file Target Operation Function Set Pop up menu option toolbar button Make setting in the dialog box opened Modifies memory contents Fill Pop up menu option toolbar button by clicking on the menu option or Fills a block of memory Move Pop up menu option toolbar button t0Olbar button Compare Pop up menu option toolbar button Save Pop up menu option toolbar button Load Pop up menu option toolbar button REJ10J2000 0100 Rev 1 00 Jun 16 2009 220 RENESAS Moves a block of memory Compares memory contents Saves memory to a file Loads a memory area contents from a file High performance Embedded Workshop 15 Macro Recording Support Facility Value In place edit Modifies memory contents Make setting in the dialog box opened by double clicking a value Note Support for this function depends on the debugger 15 5 1 6 1O window
569. t files regardless of whether the project files are out of date Deletes intermediate and output files from the current configuration in this project Sets this project as the current project Builds a file Loads all object program files Loads an object program file Unloads an object program file from memory Loads an object program file 2 Only options Offset File format Filename Access size and Perform memory verify during download can be recorded Download debug information only and Download automatically on target connection are not recordable 15 5 1 2 Editor window While a macro is being recorded the following operations will be recorded into a macro file Display Mode Source mode Target Operation Function Build lt File name gt pop up menu option Click on the Builds the selected file Toggle Breakpoint pop up menu option menu option Sets or clears a software breakpoint Enable Disable Breakpoint pop up menu option REJ10J2000 0100 Rev 1 00 Jun 16 2009 219 RENESAS Enables or disables the current software breakpoint High performance Embedded Workshop Go To Cursor pop up menu option Set PC Here pop up menu option S W Breakpoints column Double click on the column Mixed disassembly Go To Cursor pop up menu option Click on the mode Set PC Here pop up menu option menu option Toggle Breakpoint pop up menu option Enable Disable Breakpoint pop up menu option S W Break
570. t image data into test image files The typical test procedure is outlined in the figure below See section 1 14 1 Example of test procedures for a test procedure REJ10J2000 0100 Rev 1 00 Jun 16 2009 22 RENESAS High performance Embedded Workshop JL Create Hew Test Suite Save specifyed information on edit of a test suite JL Edit Test Suite Add Test Specifies playing macro Specities HEY Test Image File for comparison after test execution J Create Hew Test Image File Test tem The memory value of range U FF The register value All the texts of Debug tab etc 7 Run Test Play Macro specified with Edit Test Suite JL Test Result Browser Display a comparison result on Test Browser 1 Overview HEW Test Suite File HTS cu jc ee ee ey 3 I 2 TELTET HEW Macro File HEW Test limage File HIF Test Image Test Image Test Image Test Image Test Image Test Image HEW Test Image File HIF The test support facility is available in the Test menu and in the pop up menu of the Test tab of the workspace window The first step towards using the test support facility is to create a test suite a set of tests This is available on the Test menu Once a test suite 1s created following operations can also be done in the Test tab of the workspace window Modify the test suite and specify macros to be executed during the test and the test image file for co
571. t provides key functionality in a certain area of the High performance Embedded Workshop system These components cannot be unregistered when installed e g The High performance Embedded Workshop builder debugger and flash support 5 1 Tool locations The High performance Embedded Workshop maintains the locations of High performance Embedded Workshop compatible components automatically as each new tool is installed After installation the High performance Embedded Workshop stores information about the component including its location This is referred to as Registration REJ10J2000 0100 Rev 1 00 Jun 16 2009 109 RENESAS High performance Embedded Workshop 5 Tools Administration Although initial registration is automatic during the course of development or if you want to manage the tools being used in your projects more effectively you may need to register components yourself 5 2 High performance Embedded Workshop registration files When a High performance Embedded Workshop compatible component i e toolchain system tool or utility phase is installed part of its installation will include a file with the extension HRF This file describes the component to the High performance Embedded Workshop see the figure below a hiYTOOLHRF Ma a ig a a bee ee i l Z The process of registration refers to loading a component s HRF file into the Tools Administration dialog box see the figure below In order to use a
572. t the desired placeholder from the pop up menu The equivalent placeholder will be inserted into the edit box Filename i Configuration directory Project directory Workspace directory HEW installation directory Workspace name Project name Configuration name Example 2 1 Select the required placeholder other than Custom directory from the drop down list box and specify a sub directory relative to the directory shown by the placeholder 2 If you select Custom directory specify an absolute directory path in the Sub Directory field REJ10J2000 0100 Rev 1 00 Jun 16 2009 407 RENESAS High performance Embedded Workshop Relative to 5 Placeholders Configuration directory Sub D irector pem o ooo Example 3 1 Place the insertion cursor at the point you would like to insert the placeholder 2 Select the required placeholder from the drop down list box 3 Click Insert Placeholder Configuration directory Example 4 Inzert 1 Alternatively if you know the placeholder already type it into the field directly Ensure that you type the placeholder name in uppercase and that it is preceded by and followed by y This is correct FILEDIR These are incorrect Filedir FILEDIR FILEDIR 5 3 Available placeholders The table below lists the available placeholders and their meanings along with an example of their use Placeholder Meaning FULLFILE File
573. t the edit mode 1 Right click within the left pane to open a pop up menu 2 Select Section Edit Mode REJ10J2000 0100 Rev 1 00 Jun 16 2009 193 RENESAS High performance Embedded Workshop 13 Map 3 The confirmation dialog box shown below opens To reflect the changes to the section settings of the linkage editor select Yes eckmap G Set the edited linker section mformation 4 The High performance Embedded Workshop exits the edit mode The tick mark on Section Edit Mode has disappeared 13 1 3 Adding a section group In the edit mode you can add a section group To add a section group 1 Right click within the left pane to open a pop up menu 2 Select Add Section Group 3 The Add Section Group dialog box appears Add Section Group Section Start Address fo Cancel Section Group Hame s echon Section ij 4 Enter the start address of a section in Section Start Address Enter a section group name in Section Group Name If you specify section names separated by a comma each of them will be added as a section In the example above Section and Section2 are added as sections In the tree of the left pane the new section group is added under the address 13 1 4 Adding a section In the edit mode you can add a section under a section group subsection group or overlay group To add a section 1 Right click on a section group subsection group or overlay group to open a pop up
574. tabase file HWP file E a E Click the OK button to insert the existing project into the workspace 2 12 Setting the current project A project can be in three states the Current project a Loaded project or an Unloaded project Since a workspace can contain many projects only one of them can be the Current project at any time This project is the one that build actions and debug operations can be performed on e g clicking the Build toolbar button will build the Current project To set a project as the current project Select one of the following operations e Select the project that you want to make active from the Project gt Set Current Project sub menu OR e Select the project from the Projects tab of the workspace window Right click to display the pop up menu and select the Set as Current Project option If the project is Loaded it is possible to open the project s directory and view the files It is also possible to change the builder or debugger options for the project A Loaded project can also have tool executions performed on it from the Tools menu REJ10J2000 0100 Rev 1 00 Jun 16 2009 62 RENESAS High performance Embedded Workshop 2 Build Basics To unload a project from the workspace 1 Select the Loaded project from the Projects tab of the workspace window 2 Right click to display the pop up menu and select the Unload Project option It is possible to select multiple projects in the workspace win
575. tance and press F1 2 7 Build configurations The High performance Embedded Workshop allows you to store all of your build options into a build configuration 1 e you can freeze all of the options and give them a name Later on if you select that configuration all options for all of the build phases will be restored These configurations also allow the user to specify debugger settings for a build configuration This means that each configuration can be targeted at a different end platform The figure below shows three configurations Default MyDebug and MyOptimized In the first configuration Default each phase compile and assemble is set to its standard settings In the second configuration MyDebug each file is being built with debug information switched on In the third configuration MyOptimized each file is being built with optimization on full and without any debug information The developer of this project can select any of those configurations and build them without having to return to the options dialogs to set them again Default Mir Deb ug thy Optinnzed Corfiquratori Configurator Conf guration a Debug OH Debug OH Debug OHF S Optimize OIF Optimize OIF Optimize OH C Source Files La File TES Lit File WO Liat File HO TY Debug OHF Debug OH Debug OHF Liat File YES Liat File HO Liat File HO Assembler Source Files Coty Froje ct Defaut Cht Froe ctt Debug Cute Proje cth Op trn
576. te closes the file by overwriting the contents e Clicking Cancel returns to the editor window REJ10J2000 0100 Rev 1 00 Jun 16 2009 90 RENESAS High performance Embedded Workshop 4 Editor 4 3 6 Pop up menu to close the window 14 f include typedefi 15 16 pragma section I 17 staci Const SeEruc 16 _UBYTE rom 3 19 _UBYTE rom E 20 _UBYTE ram 3 al t DTBL i 4 _ Cc cle dbschec be ae Close In the High performance Embedded Workshop editor window it is possible to save and close editor file window via the related tab s pop up menu Right clicking on the tab of the Editor window opens a pop up menu containing available options Pop up Menu Option Function Save Saves the contents of an editing window Close Closes an individual file In the Disassembly window it is possible to close window via the related tab s pop up menu Right clicking on the tab of the Disassembly window opens a pop up menu containing available options Pop up Menu Option Function Close Closes the Disassembly window 4 4 Searching and navigating through files 4 4 1 Finding text To search for text in the current file 1 Ensure that the window whose contents you want to search is the active window 2 Position the insertion cursor at the point from which you want to start your search 3 Select one of the following operations to open the Find dialog box e Click the Find toolbar button a OR e Press the CTRL F ke
577. ted an abbreviation including the target name This configuration name can be changed in Configuration name Sets the debugger target options To modify an option select Item and click Modify If the selected item cannot be modified Modify remains gray even when Item is selected Simulator I O System call for standard I O or file I O from the user program is enabled Enable or disabled Disable Simulator I O addr Address for above system call Bus mode Currently cannot be used by the simulator debugger Initial session If Initial session is checked this session becomes an initial session To move to Step 9 click the Next gt button in Step 8 REJ10J2000 0100 Rev 1 00 Jun 16 2009 269 RENESAS High performance Embedded Workshop 17 Debugging Facility Hew Project 9 9 Changing the File Names to be Created The following source files will be generated Ext Description dbsct C Setting of B A Section tpedetine h Aliases of Integer Type sbrk C Program of brk lodetine h Definition of 170 Aegis Intprg smc Interrupt Program wecttbl smc Initialize of Wector Tab vec Inc Definition of Yector envy IIc Define Interuput Ever vhandler sre Resetelnterupt Handl resetprg C Reset Program Tutorial C Main Program sbrk h Header file of brk file stackect hi Setting of Stack area West gt Finish Cancel 9 The files to be generated by the High performance Embedded Workshop
578. tents you want to save is the active window 2 Select File gt Save As 3 A File Save dialog box will be displayed Enter a filename specify a directory and then click the OK button to create the file with the name given in the directory specified REJ10J2000 0100 Rev 1 00 Jun 16 2009 88 RENESAS High performance Embedded Workshop 4 Editor To save the contents of every open editor window 1 Select one of the following operations e Click the Save All toolbar button al OR e Select File gt Save All 2 If any of the files has not been saved before a File Save dialog box will be displayed Enter a filename specify a directory and then click the OK button to create the file with the name given in the directory specified If any of the files have been saved before then that file will be updated no dialog will be displayed When you attempt to save a read only file a confirmation dialog box appears asking if you wish to save the file as another name High performance Embedded Workshop AN CAWorkepacesDemoSH4 DemoSH4 sbrk c This file ts read only Do vou want to save it as another filename Ho Overvarnite Cancel e Clicking Yes opens the Save file dialog box Change the file name before saving e Clicking No closes the file without saving e Clicking Overwrite saves the file by overwriting the contents The file is no longer read only e Clicking Cancel cancels the attempt to save the file
579. tered in the Address field the Select Function dialog box opens for you to select a function For details see section 17 18 2 3 Supporting duplicate labels 17 18 1 3 Editing a label Choose Edit from the pop up menu and open the Edit Label dialog box to edit a label Edit Label head Address O0FFB420 kal Cancel Edit the label name and value as required and then press OK to save the modified version in the label list The list display is updated to show the new label details When an overloaded function or a class name is entered in the Address field the Select Function dialog box opens for you to select a function For details see section 17 18 2 3 Supporting duplicate labels REJ10J2000 0100 Rev 1 00 Jun 16 2009 358 RENESAS High performance Embedded Workshop 17 Debugging Facility 17 18 1 4 Deleting a label To delete a label select the label and choose Delete from the pop up menu A confirmation message box appears Confirmation Request mo 7 fre you sure you want to delete the label _ main Don t ask this question again If you click OK the label is removed from the list and the window display is updated If the message box is not necessary then check the Don t ask this question again check box 17 18 1 5 Deleting all labels To delete all the labels from the list choose Delete All from the pop up menu A confirmation message box appears Confirmation Request d p Gre vou sure
580. text The contents of the disassembly view can be saved by using the Save Disassembly Text menu from the Disassembly field in disassembly mode or mixed mode pop up menu When Save Disassembly Text is selected the Save Disassembly Text dialog box is displayed that asks you the range of addresses to save Save Disassembly Text Ei Ei Start Address ooonzo00 End Address ooon2074 Cancel Filename Browse Both a start and end address should be supplied You also need to specify the full filename to save the information to If needed you can browse to the file to use Click OK 17 2 2 12 Printing the disassembly view The disassembly view can be printed by using File gt Print or the Print toolbar button S when it is in focus or by using the menu Print on the Disassembly field in disassembly mode or mixed mode pop up menu When Print is selected the Disassembly Print Range dialog box is displayed that asks you the range of addresses to Disassembly Print Range kl E4 Start Address ooooz000 End Address 00002014 Jaj ama print Both a start and end address should be supplied Clicking OK on this dialog box then passes the print selection to the standard print formatting and selection dialog box From here you can choose your printer and page setup options 17 2 3 Looking at the current PC position To automatically display the program counter PC click the Display PC toolbar button Fe or se
581. th n E vectine H Project AN Unload project Ol Projecte Download modules Folder Download module Dependencies Folder Dependent file Loaded project Unloaded project Right clicking on a workspace opens a pop up menu containing the available options Pop up Menu Option Insert Project Load All Projects Collapse Clean All Projects Version Control Configure View Properties Macro Recording Function Adds a project to workspace Loads all projects to workspace Collapses the tree below a workspace icon Deletes intermediate and output files from configurations in all projects in this workspace Executes a version control system Configures the workspace view Displays workspace properties Right clicking on a project opens a pop up menu containing the available options Pop up Menu Option Build Build Build All Clean Current Project Update All Dependencies Set as Current Project Remove Project Unload Project OR Load Project Add Files Remove Files Add Folder Macro Recording E E REJ10J2000 0100 Rev 1 00 Jun 16 2009 36 Function Builds out of date project files Builds project files regardless of whether the project files are out of date Deletes intermediate and output files from the current configuration in this project Updates all dependencies Sets this project as the current project Removes a project from workspace Unloads a project OR Loads a project Ad
582. the last line in the window o Pressing the CTRL UP ARROW or CTRL DOWN ARROW keys on the last line in the window displays the previously executed command line o A series of command lines can be called from a batch file and the results can be output to a file The contents of the selected batch file are shown in the upper pane of the Debugger tab o You can clear the information shown on this pane The contents of the lower pane of the Debugger tab will also be cleared REJ10J2000 0100 Rev 1 00 Jun 16 2009 204 RENESAS High performance Embedded Workshop 14 Command Line e Debugger tab This pane allows the user to perform single stepping or set breakpoints in the selected batch file to control the target platform When a batch file has been loaded placing the mouse cursor on the line dividing the panes turns the mouse cursor into a double headed arrow Click and drag the mouse cursor to a desired position to adjust the size of the panes Command Line C forkspace Command hdc no log file ES Toolbar 1 _ ee lel le EN Contents of the batch file a I l command Line number 2 reset F aN 3 step urrent line to he executed ajs tep 5 jatep Breakpoint column Line number 4 In column gt COMMand reset STep he etal Step complete at A0DOOOOZ execution gt EY console j Debugger o Upper pane contents of the batch file The upper pane shows the contents of the selected batch file and allows d
583. the Debugger s Options entry This will display a drop list Options Type en Debug i Multi core a Mult core 3 Select the new options from the drop list It is not possible to modify options when synchronized Removing a Debugger from the list 1 Select the Debugger you want to remove 2 Click the Remove button The Debugger will be removed from the list REJ10J2000 0100 Rev 1 00 Jun 16 2009 382 RENESAS High performance Embedded Workshop 18 Synchronized Debugging 18 1 3 Setting the synchronization options Overview In this context synchronization refers to a virtual link from one Debugger core to another Debugger core for a specific debug operation e g Go While debugging is synchronized these virtual links are examined whenever a debug operation is executed If a synchronization exists for the operation from the Debugger where the operation is executed to another Debugger then the operation will be executed on both Debuggers The synchronizations are followed through multiple Debuggers to find out which Debuggers the operation needs to be executed on Synchronizations can be one way or two way Example 1 Two Debuggers are synchronized with IDs COREO and CORE1 Only one synchronization exists and it is one way for the Go debug operation from COREO to CORE1 When a Go is executed in the COREO Debugger the Go will occur on both Debuggers When a Go is executed in the CORE1 t
584. the last target and the character and the first dependant and the character No white space is allowed before the first target Each target and each dependant must be separated by at least one white space character A tab character must be present at the start of a line containing a command Variables may be used in a description block using the syntax specified above under variable declarations There follows some examples of valid description blocks one of which uses the variable specified above under variable declarations c dirl filel obj c dirl filel c c dir1 filel h gcc c dirl filel c OUTPUT UNPUT DEPEND EXECUTABLE INPUT REJ10J2000 0100 Rev 1 00 Jun 16 2009 422 RENESAS High performance Embedded Workshop 13 HMAKE User Guide Special commands There are two special commands which can be used in a description block The cd command changes the current directory and the set command sets an environment variable which will then be in use for the duration of the make file execution Both are used in the same way as the DOS equivalents There follows some examples of valid description blocks which use these commands CHANGEDIR cdc dirl dir2 SETENV set VARI valuel set VAR2 value2 set VAR3 value3 It does not matter that CHANGEDIR and SETENV are not file names They will be treated as files that do not exist and so the commands will always be executed Sub command fi
585. the phase that generates the files from the Source phase drop down list 4 Select the destination phase i e the phase that takes these files from the Destination phase drop down list 5 Click the OK button to create the new mapping Define File Mapping o Ib SOURCE phase Cancel SH Sesembler Destination phase OptLinker To modify a file mapping 1 Select the mapping to be modified 2 Click the Modify button The Define File Mapping dialog box opens 3 Modify the options as necessary 4 Click the OK button to commit the changes To remove a file mapping 1 Select the mapping to be removed 2 Click the Remove button 3 Click the OK button to commit the changes REJ10J2000 0100 Rev 1 00 Jun 16 2009 74 RENESAS High performance Embedded Workshop 3 Advanced Build Features 3 4 Setting custom build phase options Once you have defined a custom phase you will want to specify the command line options that should be used when it is executed Each defined phase has a menu option in the Build menu To specify options for that phase select it The dialog that will be displayed depends on whether the custom phase selected was multiple or single according to the selection of phase type when it was created in the New Build Phase wizard HyPhase Options Ei ES Debug Options Output Files Dependent Files EBET SH ddema Command o source file C ATools MpT ool exe ak B dbect c Options PLu
586. tion Find ih Finds a symbol Find Next dA Finds the next symbol that matches the search text Filter is Filters the symbol information View source r Views the source code for the address in the selected line Print Prints section list view REJ10J2000 0100 Rev 1 00 Jun 16 2009 200 RENESAS High performance Embedded Workshop 13 Map 13 2 2 Printing out the map list You can also print out the map list in the left pane To print out the map list 1 Right click within the left pane to open a pop up menu 2 Select Print 3 The standard print formatting and selection dialog box opens From here you can choose your printer and page setup options 13 2 3 Finding symbols You can search for the linkage editor symbols To search for symbols 1 Right click within the right pane to open a pop up menu 2 Select Find The Find Symbol dialog box appears Find Symbol E Ed Mame _main Match case Cancel Wild card 3 Enter a symbol name you wish to find in Name or select one from those you have previously searched for in the drop down list box To distinguish uppercase and lowercase characters select the Match case checkbox To use wild cards or select the Wild card checkbox lg A character ge A string 6 Click OK When a symbol is found a line that contains the symbol is highlighted in the right pane To find the next occurrence of the symbol select Find Next 13 2 4 Filtering the symbo
587. tion Mame oOo1000 001023 PsectOl Psectil OO2000 002008 PsectOe Psectie2 Psectus Psectls After selecting a section group clicking the OK button stores the priority setting and closes the dialog box Clicking the Cancel button closes the dialog box without storing the priority setting REJ10J2000 0100 Rev 1 00 Jun 16 2009 363 RENESAS High performance Embedded Workshop 17 Debugging Facility Note Within the address range used by the Overlay function the debugging information for the section specified in the Overlay dialog box is referred to Therefore the same section of the currently loaded program must be selected in the Overlay dialog box 17 18 3 Looking at variables This section describes how you can look at variables in the source program If you are debugging ELF DWAREF2 load modules created by using Renesas SHC or H8S compiler static member variables can be displayed together with other member variables when structures are expanded in the Watch or Locals window However it will take time to display the variables if the window contains a large amount of debugging information To select not to display static member variables when structures are expanded in the Watch or Locals window 1 Select Setup gt Options to open the Options dialog box 2 Select the Confirmation tab 3 Select the Display static member on the variable expansion in the Watch Locals checkbox By default this checkbox is not selected
588. tions can be set to a number of different levels This is outlined later in this section Notes e Sharing projects by network facilities is not possible under the Windows Vista operating system e Certain operations are locked when other clients are carrying them out This means that if one user is currently changing the toolchain options all of the other users can only see read only versions of this data e The performance of High performance Embedded Workshop does suffer when using the network facilities If working in a small team it might be more suitable to use the single user mode and version control Procedures necessary before invoking the High performance Embedded Workshop on a PC with Windows XP Service Pack 2 or later See the following section 10 1 Sharing projects by network facilities in a PC with Windows XP Service Pack 2 or later REJ10J2000 0100 Rev 1 00 Jun 16 2009 171 RENESAS High performance Embedded Workshop 10 Sharing Projects by Network Facilities To setup a project file on the server machine 1 Create a project file for the network 2 As the directory of the New Project Workspace dialog specify a network path that can be recognized by both the server machine and the client machine Example WorkGroup Severl ShareDirectory Sharing workspaces The directory specified by the above procedure step 2 must be shared The High performance Embedded Workshop s network facilities share the source obj
589. tnsanninnsesnesabapervanaaaunnsatiananeasne gmesesassautdunenmvensnbanneseetumeneneannacs 107 4 18 Tooltip watch essneessssssseeeereeresssssssssssssecerrerssssessssssssssseseceeeeeosssssssssssseecereeerosssssssssseeeetteerosssssssssseeeeereeeesssssssssseees 107 P WV alate aie pes Oa E EN 108 a Toob Administ AUO ators assess se eeeneceassacsereteatsoc soccnsataeebeeisnadsveseneroecsseucsuaaceutonsitandaveastacseetoieuseee 109 5 1 TOON TOC AMO IS ea E A O E A atauseanaiecueteastassaecna stcesaaeacegonagecaccs 109 5 2 High performance Embedded Workshop registration files cccccccccsssssssessseeeecceeeeeeeeeceaaeeessseeeeeeceeeeeeeeeeeeaaaaaas 110 5 3 Registering a COMPONCING i ocasascvectauncs necendsenueroneswinsedslovnsnananetsawstinendsauensedxenmnnnsienetenduei KEETE EREE E AEON EEn R nRT 111 54 Unresisterine a COmMponeNtsseseseerrciciers ecrin tunrida ras eier CAEN Eeen eiaa Een EEs aE ANETE E i r esia asite 112 5 5 Viewing and editing component properties esessssssssssssesstteerresssssssssssseeetterersssssssssssseterereresssssssssssssseeeeeeeeeo 112 Di CUCU OT e T E E E E E E E E S E E 114 5 7 Using On Demand components ssesesesessssssestesse etetett tetetete tetette ettette netee neee ata cienasiensedtdsnoarsoneseuinswedanaenatenedteds 115 5 8 Custom project iy PES sass sec seisaeeeadauaece sasyateaaa E EEEE AAE AEE EAEAN 116 6 Customizing the Environment cccccccesssssseeccccccccaeeeeseeececee
590. to enable Auto Update All pop up menu option toolbar button Sets real time check of all symbols to enable REJ10J2000 0100 Rev 1 00 Jun 16 2009 223 RENESAS High performance Embedded Workshop 15 Macro Recording Support Facility Delete Auto Update pop up menu option toolbar Sets real time check of a symbol to button disable Delete Auto Update All pop up menu option toolbar Sets real time check of all symbols button to disable Record Update Value gt Start Recording pop up Make setting in the dialog box opened by Starts to record the updated values menu option toolbar button clicking on the menu option or toolbar button Record Update Value gt Stop Recording pop up Click on the menu option or toolbar button Stops recording the updated values menu option toolbar button Add Watch pop up menu option toolbar button Make setting in the dialog box opened by Adds a symbol Edit Name pop up menu option toolbar button clicking on the menu option or toolbar Deletes and adds a symbol Edit Value pop up menu option toolbar button button Edits the value of a symbol Delete pop up menu option toolbar button Click on the menu option or toolbar button Deletes a symbol Delete All pop up menu option toolbar button Deletes all watch items Radix gt Hexadecimal pop up menu option toolbar Sets radix for hexadecimal for this button value Radix gt Decimal pop up menu option toolbar button Sets radix for decimal for this value Radix gt Octal pop up
591. to the workspace using a relative path 1 Select the project in the workspace window 2 Right click on the selected project to invoke a pop up menu 3 Select Properties 4 Click the Project file specified as a relative path in the HWS file checkbox to switch the relative file path feature 5 Click OK Project file specified as a relative path in the HWW file REJ10J2000 0100 Rev 1 00 Jun 16 2009 64 RENESAS High performance Embedded Workshop 3 Advanced Build Features 3 Advanced Build Features This chapter explains the advanced build concepts 3 1 The build process revisited Chapter 2 Build Basics began by describing the build process in terms of a compiler an assembler and a linker This will be the case for most installations of the High performance Embedded Workshop However if you want to begin changing the build process e g adding and removing phases then it is important to understand more about the way in which a build functions 3 1 1 What is a build Building a project means applying a set of tools upon certain input files in order to produce the desired output Thus we apply a compiler upon C C source files in order to create object files we apply an assembler upon assembler source files in order to create object files and so forth At each step or phase of the build we apply a different tool upon a different set of input files The figure below presents a different view of the build pro
592. ton is clicked the windows are hidden or displayed depending on the current settings of that window configuration It is possible to have a maximum of 4 desktop configurations in use When the session is saved the window positions for each configuration are saved to the session file You can then switch simply between each configuration to gain access to the other windows The toolbars and windows are dependent on the virtual desktop configuration Source files are independent of the virtual desktop system and will remain in view To rename your configuration to a more meaningful name 1 Select Window gt Virtual desktop gt Desktop Manager The Desktop manager dialog box opens 2 Select the window configuration you wish to change the name for 3 Click Rename 4 Enter the new meaningful name in the edit field and click OK 5 Click OK to keep the changes and revert to the High performance Embedded Workshop main window To switch desktop configurations There are a number of ways to switch desktop configuration The first and easiest method is using the virtual desktop buttons located on the status bar These are shown below f Build desktop Read write 25187 4 In this example the selected desktop is number 1 This has been given the name Build by the user Its description is seen in the edit box to the right on the buttons Clicking a different desktop selects that button and changes the description control Once clicked High pe
593. topped i e not running H The Debugger is connected to a platform which is currently running REJ10J2000 0100 Rev 1 00 Jun 16 2009 385 RENESAS High performance Embedded Workshop 18 Synchronized Debugging When you right click on a Debugger ID the following menu will be displayed Reset CPU Go Reset Go Step In Step Out Step Over Halt Program Allow Docking Hide Properties When an operation is selected it will be executed on the selected Debugger s only All synchronizations are ignored when an operation is executed from the Debuggers tab When debugging a multi core platform some operations will be disabled These are operations that are always synchronized by the hardware which means that the operation cannot be executed on the platform s cores separately Menu items will also be disabled if the operation is not possible on the selected Debugger For example if you right click on a Debugger which is running only the Halt Program menu item will be enabled The Properties menu item is used to find out information on a Debugger When selected a dialog will be displayed containing the following items Workspace file workspace name project name and session name The Activate menu item is only enabled when debugging in Internal mode When selected this will make the selected Debugger the currently active one See section 18 2 3 Internal mode functionality for more information Debugger operations T
594. tre 186 125 Smart edi CAPA Ly sacascesvecadeeitecstwosvedesxgiedinacedetestaoneccaeduidab vecknassnedsteabeabee NO 187 O IMD recast creat gnaonncenscccuce E E tora bentaationebeecsaeesalaneuebores sueneaticn 189 131 Managing section SCUIMSS opecccsic ssc cet wesvedidnnonxarsteucednobacateabveurand sacue ts E AORA a eE E ENE EE EE re NAR Kaaa iai 190 13 1 1 Opening the Map Section Information window ccccccccccccccccccaaeessesseeseeecceeeeeeeeeaaaeassssueeeeeeeeeeeeeeeeeaqaqaaas 190 13 1 2 Ent ring exitine the edit INOUE wesisnaranedenatozaneda dice dasenbenasienseeisiinddantudadsonbsdadtont aeaa aaaea a a aa aa 193 13 1 3 Addim Ay SC ON 8 OO eee E E E E 194 i ATTN O E E E E 194 13 15 Adding an overlay SOUDP ccccscceccccccccccceaceesssssseseececcceeeseeesaaeaesssssseeeeeeeeeceeeeesssaaaeessssseeesseeeeeeeeeeeseeaqaaas 195 13 1 6 Automatically registering the unregistered section cc cceeeesssssseeeeeceeeceeececaaeeeessseeeeeeeeeeeeeeeeaaaaaeeeeeseeeees 195 i7 BGS SIC Ct Meieres E EEE 196 13 1 8 Setine the primary SECO serisine A a E ANAKREON R SSi 196 13 1 9 Sene a memory IMAP eselsexesanevesecertnepcseresesevaneannduavweeseben D EEE EE ee EE oi NETE OSNES ER RENEE EEES 197 13 1 10 Automatically allocating the memory resource eesssessssssseseeeeeeresssssssssssseeeereeressssssssssssssssseeereeressesssss 197 13 1 11 Printing out the section settings tree cctcserscsccesssceasseinandesdennedacstoceseasseneaasdeasanan
595. trol see Chapter 7 Version Control Right clicking displays a pop up menu containing available options A basic operation is allocated to the toolbar The functions of Toolbar display and Customize toolbar are also included in the pop up menu displayed by right clicking the toolbar area Pop up Menu Option Toolbar Button Function Clear Window fa Clears the contents of the window Save Ei Saves the contents of the window into a text file Copy Copies the selected contents onto the Windows clipboard Toolbar display Shows or hides the toolbar Customize toolbar Customizes toolbar buttons Press the SHIFT ESC key and the Output window closes The color of text or background and font shown in the Output window can be customized in the same manner as in other windows You can also customize the Build tab of the Output window so that the texts in the lines of error messages will be highlighted in a color different from that of the texts in other lines To customize the current colors 1 Select Setup gt Format Views to open the Format Views dialog box 2 Select the Output item from the tree in the left hand section of the dialog box and expand it 3 Select the category for which you wish to change the color from the table below Category Foreground Color of the Background Color ofthe Tab s to be Type of Output to Color Tab Default Color Tab Default Applied be Applied Text SYSTEM SYSTEM All tabs All Build Error Text
596. ts the radix to hexadecimal default Decimal 10 Sets the radix to decimal Octal g Sets the radix to octal Binary Sets the radix to binary REJ10J2000 0100 Rev 1 00 Jun 16 2009 345 RENESAS High performance Embedded Workshop 17 Debugging Facility 17 9 Resetting the target MCU To reset the target MCU click the Reset CPU toolbar button it or select Debug gt Reset CPU Resetting the target MCU initializes the on chip I O registers and makes the program counter jump to the address set in the reset vector 17 10 Setting PC to the address at cursor To changes the value of the PC to the address at the row of the text cursor click the Set PC to cursor toolbar button Tee or select Debug gt Set PC to Cursor 17 11 Initializing the debugger Select Debug gt Initialize It will close down any open child windows and shut down the link to the debugger If this is successful an attempt to re establish the link to the debugger will be made 17 12 Connecting disconnecting the debugger To connect the debugger Select one of the following operations an e Click the Connect toolbar button OR e Select Debug gt Connect To disconnect the debugger Select one of the following operations e Click the Disconnect toolbar button el OR e Select Debug gt Disconnect Support for this function depends on the debugger 17 13 Executing your program This section describes how you can execute
597. u can select the range by clicking on the first memory unit depending on your Memory view display choice and dragging the mouse to the last unit The selected range is highlighted 17 3 4 Filling an area of memory with constant data You can set the contents of a range of memory addresses to a value using the memory fill feature Select an address range to fill in the Memory window by dragging the mouse Choose Fill from the pop up menu of the memory window The Fill dialog box opens Fill Start Address faooo0000 End Address pooo F Data Data Type fe Value C String Leneth fi byte es verify Cancel Enter the data value or character to be filled in the Data field Select the Verify check box Support for verify function depends on the debugger If you did not drag the address range to be filled you must enter the start end address The end address can also be prefixed by a plus the end address will become the start address entered value When specifying the value Click the Value button in the Data Type group Specify the data length in the Length field When setting the character Click the String button in the Data Type group When the display data length is two bytes two bytes worth of a character can be specified Please use the Set dialog box to specify the character string Select menu Set REJ10J2000 0100 Rev 1 00 Jun 16 2009 313 RENESAS High performance Embedde
598. u have the option to either step into or step over the function If the instruction does not perform a call then either option will cause the debugger to execute the instruction and stop at the next instruction If you choose to step into the function the debugger will execute the call and stop at the first line or instruction of the function To step into the function e Click the Step In toolbar button 4 OR e Select Debug gt Step In If you choose to step over the function the debugger will execute the call and all of the code in the function and any function calls that function may make and stop at the next line or instruction of the calling function To step over the function e Click the Step Over toolbar button P OR e Select Debug gt Step Over During debugging there are occasions when you may have entered a function finished stepping through the instructions that you want to examine and would like to return to the calling function without tediously stepping through all the remaining code in the function Alternatively you may have stepped into a function by accident when you meant to step over it and so want to return to the calling function without stepping all the way through the current function You can do this with the Step Out feature To step out of the current function e Click the Step Out toolbar button dP OR e Select Debug gt Step Out To choose the step mode to use while stepping Selec
599. u or via a keyboard shortcut if you have set up macro function assignments in the Macro dialog box For information on this area read the Assigning a macro information Another method is to launch the macro function via the Macro dialog box To play a macro from the macro dialog box 1 Select Tools gt Macros The Macro dialog box opens 2 Select the macro file which contains the function you want to play 3 Select the macro function in the function list that you want to play 4 Click the Play button 5 The Macro dialog box is dismissed and the macro function executed 15 7 Editing a macro It is also possible to edit macros in the following way To edit a macro 1 Select Tools gt Macros The Macro dialog box opens 2 Select the macro file which contains the function you want to edit 3 Select the macro function in the Macro functions that you want to edit 4 Click the Edit button 5 The Macro dialog box is dismissed and the file opened in the High performance Embedded Workshop editor The Macros are stored in the Macros folder within the High performance Embedded Workshop management information folder under the application data folder for each user profile These files are just text based TCL files that REJ10J2000 0100 Rev 1 00 Jun 16 2009 229 RENESAS High performance Embedded Workshop 15 Macro Recording Support Facility can also be manually edited in the High performance Embedded Workshop editor window Any
600. umn To disable filtering de select the Enable Filter checkbox in the Filter Symbol dialog box 13 2 5 Viewing the source code for the address The source file for the address in the selected line will be opened in the editor window To view the source code for the address Select one of the following operations e Right click on the symbol list line in the right pane to open a pop up menu Then select View Source OR e Double click on the symbol list line in the right pane REJ10J2000 0100 Rev 1 00 Jun 16 2009 202 RENESAS High performance Embedded Workshop 13 Map 13 2 6 Printing out the symbol information You can also print out the symbol information in the right pane To print out the symbol information 1 Right click within the right pane to open a pop up menu 2 Select Print 3 The standard print formatting and selection dialog box opens From here you can choose your printer and page setup options REJ10J2000 0100 Rev 1 00 Jun 16 2009 203 RENESAS High performance Embedded Workshop 14 Command Line 14 Command Line The High performance Embedded Workshop Command Line Interpreter allows the user to control the debugger by sending text based commands instead of the window menus and commands It is especially useful if a series of predefined commands need to be sent to the debugger by calling them from a batch file and optionally recording the output in a log file Note To specify a file in the command line
601. un 16 2009 43 RENESAS High performance Embedded Workshop 2 Build Basics 4 Click OK 5 You can now drag and drop files into this folder to group them logically To drag and drop a folder Drag a folder in the active project from the Projects tab of the Workspace window e If the folder is dropped onto the active project the folder is directly added into the project e Ifthe folder is dropped onto a user folder in the active project the folder is added into the user folder You can also drag folders from the Windows Explorer and drop it into the Projects tab of the workspace window For details see section 2 3 2 Drag and drop of files and folders To remove a user folder 1 Select the folder on the Projects tab of the Workspace window 2 Select one of the following operations the folder must be empty e Press the Delete key e Right click and select Remove Folder from the pop up menu To modify a user folder name 1 Select the folder on the Projects tab of the Workspace window 2 Right click and select Rename Folder from the pop up menu 3 Enter the new name in Folder of the Rename Folder dialog box 4 Click OK 2 5 File extensions and file groups The High performance Embedded Workshop can identify files by their extension The system defines certain extensions depending upon the tools that are being used For example if you are using a compiler then the c extension will be in the C source file group and will b
602. unload an on demand component manually 1 Click Project gt Components The Component Gallery dialog box opens 2 Select the component you wish to load Click the Load button The components image should change to the loaded state 3 If you wish to unload a component Select the component Click the Unload button The components image should change to the unloaded state 4 Click OK to verify the changes REJ10J2000 0100 Rev 1 00 Jun 16 2009 115 RENESAS High performance Embedded Workshop 5 Tools Administration Component Gallery EES Project Fl Application Extensions ITRON component Custom memory View component SL Pin view component Loaded component Unloaded component Intermediate state component Load LEE Unload Note Each project in your workspace can have different components loaded and unloaded If you have multiple projects you can use the Multiple projects and All projects items to change a components load status over more than one project If you select a combination which means the component is loaded in one project and not anther then the intermediate state icon is displayed 5 8 Custom project types The Project gt Create Project Type menu option in High performance Embedded Workshop and allows you to create a template for your project This menu option takes the settings of the current project and then creates a project type for you The user can specify the name of
603. up menu e Tests top pane Right clicking displays a pop up menu containing available options Pop up Menu Option Toolbar Button Function Export mj Exports the result Export All il Exports all results Clear Clears all results e Test items bottom pane Right clicking displays a pop up menu containing available options Pop up Menu Option Toolbar Button Function Details ll Displays the details of the result 16 10 Configuring the Test pane of the Workspace window The Test pane was created to allow fast access to the tests in your test suite When the test suite is opened the test suite is added to the Test tab of the workspace window and the tests in the test suite are added underneath them This is shown below Workspace i TestSuite Test Suite hA Download Memory Check Test Right clicking on either the test suite name or the test gives fast access to the test facilities features Right clicking on the test suite icon Hf allows you the following options Pop up Menu Option Function Edit Test Suite Edits the current test suite Allows you to add and remove tests to the High performance Embedded Workshop test system Close Test Suite Closes the current test suite Compare Test Image File Compares test image file allows you to compare a test image file with the current High performance Embedded Workshop system or with another test image file already on your disk The results are then displayed in the test
604. up menu this option is unchecked by default When this option is checked double clicking a navigation item jumps you to the associated navigation items definition To jump to the definition Select either of the following ways e Right click on navigation items on the Navigation tab to display a pop up menu and check that Jump To Definition On Double Click is checked Double click a navigation item on the Navigation tab e Right click on navigation items on the Navigation tab to display a pop up menu Select Go to Definition To jump to the declaration Select either of the following ways e Right click on navigation items on the Navigation tab to display a pop up menu and check that Jump To Definition On Double Click is unchecked Double click a navigation item on the Navigation tab e Right click on navigation items on the Navigation tab to display a pop up menu Select Go to Declaration REJ10J2000 0100 Rev 1 00 Jun 16 2009 184 RENESAS High performance Embedded Workshop 12 Navigation Facilities To list the member variables and functions in the alphabetical order 1 Right click on navigation items on the Navigation tab to display a pop up menu 2 Un check Group by Access This option is unchecked by default To group the display of public private and protected member variables and functions together 1 Right click on navigation items on the Navigation tab to display a pop up menu 2 Check Group by Access This option is
605. update this list If you check the Show all available macro functions check box then all macros currently defined are displayed in the list When selected this option ignores the value of the Current macro file drop down list box It can be useful to use multiple macro files to logically hold related areas For example you might like to create a different macro file for use with different debugger targets To execute macro files that have relative paths specify the initial directory in Initial directory Change the directory in the same way as using the change directory command and execute macro files in the initial directory To create a new blank macro file 1 Select Tools gt Macros The Macro dialog box opens 2 Click the New button 3 Enter the new macro file name 4 Click OK The new file name is added to the Current macro file drop down list To import an existing macro file 1 Select Tools gt Macros The Macro dialog box opens 2 Click the Import button 3 Browse to the existing macro file 4 Click Select The new file name is added to the Current macro file drop down list 5 When you select the macro file name in the list the available macros are displayed It is possible to manually edit any of the macro files The files are text based High performance Embedded Workshop command batch files REJ10J2000 0100 Rev 1 00 Jun 16 2009 215 RENESAS High performance Embedded Workshop 15 Macro Recording Support Facilit
606. uration by configuration basis To exclude a project file from build 1 Click on the file that you want excluded from build in the Projects tab of the Workspace window It is also possible to select several files by using a mouse or inputs through the keyboard as follows e To select several files Click the files while pressing the CTRL key REJ10J2000 0100 Rev 1 00 Jun 16 2009 42 RENESAS High performance Embedded Workshop 2 Build Basics e Select several files as a range Click a file as the start of the range Then keep pressing the SHIFT key and click another file as the end of the selected range 2 Take either of the two ways listed below A red cross will appear on the file s icon and the file will be excluded from build e Select Exclude Build lt file gt where lt file gt is the name of the selected file from the pop up menu opened by right clicking lt file gt is not displayed if several files are selected e Select Build gt Include Exclude Build 2 3 5 Including a project file in build A file that has been excluded from build can be included again To include a project file in build 1 Click on a file that has previously been excluded from build in the Projects tab of the Workspace window It is also possible to select several files by using a mouse or inputs through the keyboard as follows e To select several files Click the files while pressing the CTRL key e Select several files as a range
607. urrences then check the Match whole word only checkbox Note this option is mutually exclusive with the Regular expressions only one of these two options can be used at any given time 6 If your search string uses regular expressions then check the Regular expressions checkbox See Reference 4 Regular Expressions for further information 7 Ifyou would like your search results to appear in the Find in Files 2 tab in the Output Window instead of the Find in Files 1 tab check the Output to Find in Files 2 checkbox this enables two different sets of search results to be available in the Output Window 8 Select a search location type e Directory Selecting this option will enable searching a directory or directory structure for the given search string For this options set the Search sub directories checkbox if you also wish to search all sub directories of the given directory If you just want to search the specified single directory in Directory field then ensure that this checkbox is not checked e Active project Selecting this option will enable you to search the files belonging to the currently active project in the workspace e All loaded projects Selecting this option will enable you to search the files belonging to all loaded projects in the workspace Note that the Active project and All loaded projects options will not search project dependencies include files 9 Click Find to begin the search Any matches found wi
608. urrent High performance Embedded Workshop system or in another test image file to be compared with Example Failed at Line 1 Src Data Input Dest a 1 21468 To make detailed setting If you double click on a test item in the Create New Test Image dialog box a further dialog box for detailed setting opens REJ10J2000 0100 Rev 1 00 Jun 16 2009 250 RENESAS High performance Embedded Workshop 16 Test Support Facility Edit Test Simulated 1 0 Ei Simulated 70 Stark Line End Line Cancel a Add Hodiy jem dd Modit Renove e To add a simulated I O range 1 Click on the Add button on the Edit Test Simulated I O dialog box to open the Add Simulated I O dialog box Add Simulated 1 0 ea Options i all Cancel C Line No 2 Specify All or Line No to set a I O simulation range to be saved into a test image file 3 Click OK e To modify a simulated I O range 1 Click on the Modify button on the Edit Test Simulated I O dialog box The simulated I O range selected in the Simulated I O list will be modified Only one variable is selectable in the list The Modify Simulated I O dialog box opens Modify Simulated 1 0 ki Options F al Cancel C Line No 2 Specify All or Line No to set the I O simulation range to be saved into a test image file 3 Click OK REJ10J2000 0100 Rev 1 00 Jun 16 2009 251 RENESAS High performance Embedded Wo
609. urrently in scope the High performance Embedded Workshop will add it to the Watch window but its value will be Not available now 3 Editing a watch item s name You can change the name of a watch item Even if watch items can be expanded e g structures or pointers however the names of their child items are not changeable To edit a watch item s name Open the Edit Name dialog box in either of the following ways e Double click within the Name column e Right click on the line of a watch item and select Edit Name from the pop up menu RE O BA Bee El A Watch Item 1 7F000000 3 ilong l0 auto ve R 0 H dd FFOOUOOO lon i R 1 H 00000000 FTFO00004 ilong aT 08 long Edit Hame ki EJ Oc lone Variable or expression OF 10 long long long long E 8 H 00o00000 7FFO00O020 long A 9 H 00000000 FTFO00024 ilong ep watcha Enter the new name in the Value or expression field and click OK REJ10J2000 0100 Rev 1 00 Jun 16 2009 368 RENESAS High performance Embedded Workshop 17 Debugging Facility Edit Name Varable or expression watch tem_1 1 Cancel iil The Watch window is updated to show the new name R R Cheba 7 fx ge e e Fan R Watch Item 1 1 H ooo00000 7FOO0004 ilong Auto A Eh watchs Note Names of watch items cannot be changed in the following cases e The user program is running e Two or more w
610. ursor on the marked line 2 Select one of the following operations e Click the Toggle Bookmark toolbar button el OR e Press CTRL F2 OR e Select Edit gt Bookmarks gt Toggle Bookmark OR e Right click and select Bookmarks gt Toggle Bookmark from the pop up menu 3 The bookmark icon will be removed from the line REJ10J2000 0100 Rev 1 00 Jun 16 2009 95 RENESAS High performance Embedded Workshop 4 Editor To jump to the next bookmark in a file 1 Ensure that the insertion cursor is somewhere within the file to be searched 2 Select one of the following operations e Click the Next Bookmark toolbar button Hel OR e Press F2 OR e Select Edit gt Bookmarks gt Next Bookmark OR e Right click and select Bookmarks gt Next Bookmark from the pop up menu To jump to the previous bookmark in a file 1 Ensure that the insertion cursor is somewhere within the file to be searched 2 Select one of the following operations e Click the Previous Bookmark toolbar button Hal OR e Press SHIFT F2 OR e Select Edit gt Bookmarks gt Previous Bookmark OR e Right click and select Bookmarks gt Previous Bookmark from the pop up menu To remove all bookmarks 1 Ensure that the window whose bookmarks you want to remove is the active window 2 Select one of the following operations e Click the Clear All Bookmarks toolbar button H OR e Select Edit gt Bookmarks gt Clear All Bookm
611. us Find next Previous difference Next difference Wmi op oe BE E Refresh comparison Toolbar display Customize toolbar REJ10J2000 0100 Rev 1 00 Jun 16 2009 Function This opens a new compare window so that some new files can be compared and the differences displayed This opens a dialog which allows you to choose a file to export the current difference results to a textual format The ignore white space option which is on the advanced options dialog can be toggled via this menu option Displays a standard find dialog This uses the same find dialog as the High performance Embedded Workshop editor Finds the next previous string that meets the find requirements Finds the next string that meets the find requirements Automatically jumps the view to the next previous difference Automatically jumps the view to the next difference Refreshes the view to manually run the difference comparison again This can be used if either file has been modified since the last comparison Shows or hides the toolbar Customizes toolbar buttons 180 2CENESAS High performance Embedded Workshop 12 Navigation Facilities 12 Navigation Facilities The High performance Embedded Workshop has a number of new integrated navigation facilities Workspace Ea Navigation entries Navigation category Fl gy CFish Class E CFishi E CFishi ve ag GetllassN arme yoid sl m_nLivein ater D S CGreathhite oo
612. use list This should default to the correct selection However sometimes there may be multiple generators that support the same target 6 Click the OK button This should launch the generation process the process depends on the generator that was selected At this point an additional dialog box may be displayed for target setup options 7 When finished a new session is added to the current project It should be available in the sessions drop down list box on the main toolbar You can create a new empty session in the project directory The session will use the session name as its new file name If the file name already exists then an error is displayed REJ10J2000 0100 Rev 1 00 Jun 16 2009 291 RENESAS High performance Embedded Workshop 17 Debugging Facility To add a new empty session 1 Select Debug gt Debug Sessions The Debug Sessions dialog box opens 2 Click the Add button The Add Session dialog box opens 3 Click the Add New Session radio button 4 Enter a name for the session 5 Click the OK button f Add anew session Hame NewSession You can import session data from another file and create a new session file in the project directory All information is an exact copy of the file the data was imported from To import an existing session into a new session file 1 Select Debug gt Debug Sessions The Debug Sessions dialog box opens Click the Add button The Add Session dialog box opens Click the Use an e
613. ustom phases or move system phases to any position in the build order It is important to remember that if the output of your custom phase can be input into another phase then the phase order must be correct if the build is to behave as intended COMPILE ASSEMBLE Select Build gt Build Phases The Build Phases dialog box will be displayed The build phase dialog box provides facilities for ordering build phases via the Build Phases dialog box It has two tabs which are concerned with the ordering of phases Build Order and Build File Order And then you can click OK button 3 3 1 Build Order tab The Build Order tab displays the current order in which phases will be executed when the Build EE or Build All ES buttons is selected The check box to the left of each phase indicates whether or not the phase is currently enabled A phase can be toggled on off by checking unchecking its corresponding checkbox respectively Build Order Build File Order File Mappings Build phase order WSH O G Library Generator Add System ISH G G Compiler Modify phase WISH Assembler OptLinker Remove Custom Pa My Phase Weve Le phase Mare Won Import REJ10J2000 0100 Rev 1 00 Jun 16 2009 70 RENESAS High performance Embedded Workshop 3 Advanced Build Features To change the order of phases system custom in a build or build all operation 2 Select the phase to be moved and then click the Move Up an
614. uto indentation checkbox By default this checkbox is selected Click the OK button for the new settings to take effect W Enable auto indentation Splitting a window The High performance Embedded Workshop editor allows you to split an editor window into two The split bar button is located just underneath the maximize button at the top right hand corner of any editor window as shown below __ Pale Split Bar REJ10J2000 0100 Rev 1 00 Jun 16 2009 98 RENESAS High performance Embedded Workshop 4 Editor To split a window Double click the split bar button to split the window in half or click on the split bar button keep the button pressed drag the mouse down and then release the mouse button at the point you want to split the window To adjust the position of the split bar Click on the split bar itself keep the button pressed then move the bar to the new position and then release the button To remove the split bar Double click on the split bar or move the split bar to the top or bottom of the window 4 9 Changing the editor font The High performance Embedded Workshop allows you to specify the font to be used in its internal editor All editor windows regardless of the file type use the same font To change the editor font 1 Select Setup gt Format Views The Format Views dialog box opens 2 Select the Source icon in the tree The Font tab should be available on the right of the Format Views dialo
615. v 1 00 Jun 16 2009 1 RENESAS High performance Embedded Workshop Selecting SuperH RISC engine from CPU family and Renesas SuperH RISC engine from Tool chain respectively New Project Workspace EES Projects Wikspace Mame I Application Workspace Mame ERE Demonstration Project Han EN mpy Application Project Hame Ley Import bakelse z D E Library Directary Debugger only cceunec C Aworkspace workspace_Neme Browse FPL fariu Super AIST egine Tool chair Renesas Supe Starndad 1 Overview If you have selected a target debugger at creation of the project the High performance Embedded Workshop creates a configuration suitable for the debugger If you have selected SH 4 Simulator in Targets at creation of the project configuration SimDebug_SH 4 is created Selecting SH 4 Simulator in Targets as the debugger connected with the HEY New Project 779 5 etting the Target System for Debugging 1SH 4 Funcional Simulator SH 4 Funchonal SimulatoeLithe endian fo H 4 Sinwatar ae sens CISH 4 Simulato Litle endian SH 4 with BSC Simulata SH 4 wath BSC Simulater Little endiar 1SH 4 5H 7 50R Functional Simulator CISH 4SH 750A Functional Simadato Lit OSH HSH7750A Sinulaber CISH 4 SH7750R SimulstorlLitle endian Target type EH 4 Target CPU A CPUs Configuration names can be change
616. v 1 00 Jun 16 2009 347 RENESAS High performance Embedded Workshop 17 Debugging Facility Notes e If your program never executes the code at this address the program will not stop If this happens you can stop code execution by pressing ESC choosing Debug gt Halt Program or clicking the Halt toolbar button a e The Go To Cursor feature requires a temporary breakpoint if you have already used all those available then the feature will not work 17 13 5 Running from a specified address The Run Program dialog box allows the user to run the program from any address Choose Debug gt Run to open the Run Program dialog box Run Program ki Program counter Go jannono00 jannono00 Temporary PC breakpoints Reset go Cancel The following execution conditions can be specified in this dialog box Program counter Instruction address to start execution The initial value is the current PC value Temporary PC Breakpoints A temporary PC breakpoint When execution started by this dialog box stops this breakpoint is cleared Clicking the Go button starts execution according to the settings Clicking the Reset Go button starts execution from the reset vector Clicking the Cancel button closes this dialog box without executing instructions Note The Temporary PC Breakpoints feature requires a temporary breakpoint if you have already used all those available then the feature will not work 17 13 6 C
617. value by clicking the button corresponding to the flag Macro Recording e The right click menu allows you to change the display radix point and the register bank Change of the register bank can be selected only when the debugger supports this function Options Right clicking displays a pop up menu containing available options Pop up Menu Option Macro Recording Function Radix Hex Displays in hexadecimal Dec Displays in decimal Oct Displays in octal Bin Displays in binary Banko Displays registers of bank 0 Bank1 Displays registers of bank 1 Layout Radix Switches display or non display of radix FLAGs E Switches display or non display of flags display area Settings Chooses a register to be displayed Edit w Changes a register s contents Refresh Refreshes the Register window Lock Refresh Disables refresh of the Register window Split Splits up the window display Save To File Saves register contents in a text file Note Support for this function depends on the debugger REJ10J2000 0100 Rev 1 00 Jun 16 2009 340 RENESAS High performance Embedded Workshop 17 Debugging Facility 17 7 2 Changing the register display radix You can change the display radix by register To do this click the mouse right button on the register to be changed and select the display radix from the pop up menu which is opened The followings can be selected Hex Display in hexadecimal Dec Display in decimal
618. value gt 1 lt reg gt is the register id of the dependency 2 lt bit gt is the bit position within the register 3 lt value gt is the value that the bit must be for the module to be enabled The Register definition entry is entered in the format 1d lt name gt lt address gt lt size gt lt absolute gt lt format gt lt bitfields gt 1 lt name gt register name to be displayed 2 lt address gt address of the register 3 lt size gt which may be B W or L for byte word or long word default is byte 4 lt absolute gt which can be set to A if the register is at an absolute address This is only relevant if the I O area address range moves about on the CPU in different modes In this case if a register is defined as absolute the base address offset calculation is not performed and the specified address is used directly A lt format gt Format for register output Valid values are H for Hexadecimal D for decimal and B for binary 6 lt bitfields gt section defining the bits within the register Bitfield sections define the bits within a register each entry is of the type bit lt no gt lt name gt 1 lt no gt is the bit number 2 lt name gt is a symbolic name of the bit 66 99 Comment lines are allowed and must start with a character REJ10J2000 0100 Rev 1 00 Jun 16 2009 410 RENESAS High performance Embedded Workshop 6 I O File Format Example Comment SH7034 Family
619. verts all toolbars back to their original factory default positions Be careful as this will reset any custom positions that you may have setup during your session REJ10J2000 0100 Rev 1 00 Jun 16 2009 119 RENESAS High performance Embedded Workshop 6 Customizing the Environment To show or hide toolbar tooltips 6 2 l 2 3 Select Setup gt Customize The Customize dialog box opens Select the Toolbars tab Set the Show Tooltips checkbox as desired Customizing the Tools menu The Tools menu can be customized to include your own menu options To add a new menu option L 2 oo a E E Select Setup gt Customize The Customize dialog box Select the Menu tab The first thing you need to decide is whether you are adding a global application wide tool which will be available to all of your workspaces or whether you wish to add a workspace wide tool which is only valid for the current workspace Once you have chosen choose the relevant section of the dialog box Menu Application wide tools Hame Version Modit Hemose workspace wide tools Mame Version Add Miah mil Remove Click the Add button The Add Tool dialog box opens Enter the name of the tool into the Name field Enter the command excluding arguments into the Command field Enter any arguments that you would like to pass to the command into the Arguments field Enter the initial direct
620. w cccccccccccccccccsessesesseseeececeeeeeeeeasaaasessseeeeeceeeeeeeeeseaaeaaaaaaesassnes 259 Ce Deon i TN e E E E E uetesdeoaenscdeen 261 17 1 Preparations for CEDUS SUNS cxscnaccuiassarerzeamancadlacsencansonaucumesetivannbqnmesaneieneaekasnensennssileanzeamnnaubabenuiateetebeganeanndesesansuoomsdaaess 261 17 1 1 Compin Tor CC DUG sarao R a E EEO E E 261 ITN Seeonee a de i eea En rE EE EA E Eri 261 17 1 3 Edun proj ercon a AON n EE EEE EEE E EE AEE EE 272 I4 Se OMIA SUI Be DN BSF crsrscicosoriniiipsti iian aaee aaaea r aieiai niis 212 17 1 5 Boalo mne modo Si eeeeeenenene ne een E E men r nr Rent EE erence cCr rt ere ere 278 et Debugger BOSS INS anssen a a N a EAR TE ONE 290 12 ME MIN apros UI er EEE E E RE EAT RE 295 17 2 1 ROC MI ihe Editor window seeccrsisriesreisa ina E N E seats 296 17 2 2 Opening the Disassembly Wino W sri cocascienocsnocnsnanebecedt es nnsabobeneackeqeneaunusdeanitgineanpelatiastacemneaedsidesavanmebenoenhact 302 17 2 3 Lookie atthe current PE POSITION si ccnsieuss eresiaren ea EEEE E EEEE ENEA I REEE RENEE 308 17 2 4 Highlighting the line at the PC neeeessssesssssssssssssesererssssssssssssssssereeeessssssssssssececrreresreesssssssssssseeeeeeeeessssssss 308 o O O aa A E E E ae te cer er Cen rere 309 17 3 1 Opening the Memory WINdOW ccccccccccccccccesseseeessseeeeeeeeeeeeeeeeeaaeeseesseseeeeeeeeeeeeseeaaaaaeeesssseeeeeeeeeeeeeeeeeeaaaas 309 17 3 2 Setting data at a desired address in the M
621. w No Size Section 3 The right pane shows all sections of size 0 At this time the End Address column does not show the end addresses 13 1 14 Viewing the source code for the address The source file for the address in the selected line will be opened in the editor window To view the source code for the address Select one of the following operations e Right click on the section list line in the right pane to open a pop up menu Then select View Source OR e Double click on the section list line in the right pane REJ10J2000 0100 Rev 1 00 Jun 16 2009 198 RENESAS High performance Embedded Workshop 13 Map 13 1 15 Printing out the section list You can also print out the section list in the right pane To print out the section list 1 Right click within the right pane to open a pop up menu 2 Select Print 3 The standard print formatting and selection dialog box opens From here you can choose your printer and page setup options 13 2 Viewing symbols You can view symbols in each of the sections in the Map Symbol Information window Even if there are too many symbols the search or filtering function can be used to view necessary information only 13 2 1 Opening the Map Symbol Information window To open the Map Symbol Information window 1 Select one of the following operations to open the Select Map Window Type dialog box e Select View gt Map OR e Click the Map toolbar button a 2 Select Map Sym
622. w opens 1 14 9 Step 8 Viewing the test result unmatched You can view the test result in the Test Browser window a gL Test Name Description Result Ea Test Demo Demonstration FAIL J ef Component Result Details ey CPU Mernorn SimSessionSH 4 FAIL Failed in memory range Ue 0000000 Ox F000002 iS Symbol Wratch SimSessinSH 4 FAIL Symbol data ie not matching E w 1 To view the details of unmatched data double click a test item with a red icon in the bottom tab 2 When Symbol Watch xxxxxx is double clicked for example the Test Comparison Details dialog box appears as shown below This dialog box shows the values of both the saved test image information Src xxxxxx and the result of this test Dest xxxxxx regarding elements in arrays REJ10J2000 0100 Rev 1 00 Jun 16 2009 33 RENESAS High performance Embedded Workshop 1 Overview Test Comparison Details Ei Ei Test Suite _ Demo Symbol Wwatch SimSessionSH 4 Esport Informatior Failed at symbol a 6 Sre flong H 00002 70417000001 8 Dest longlH 0000i 3 Clicking the Export button saves the test result into a text file 4 Click the OK button 1 14 10 Step 9 Modifying the program back and executing the test again Modify the program to restore the number of times to store data in the array and then execute the test 1 Return the number from 8 to 10 and build the program 2 Click the Save File button l on the Editor tool
623. wServer Hew3Server exe under the High performance Embedded Workshop installation directory Click the OK button and close the Add a Program dialog box Click the Add Port button to open the Add a Port dialog box 9 Enter DCOM in Name and 135 in Port Number and select TCP option button 10 Click the OK button and close the Add a Port dialog box 11 Click the OK button in the Windows Firewall dialog box 12 Close the Network and Internet Connections 13 Close the Control Panel REJ10J2000 0100 Rev 1 00 Jun 16 2009 172 RENESAS High performance Embedded Workshop 10 Sharing Projects by Network Facilities Step2 DCOM 1 Select Run from the Windows start menu The Run dialog box is invoked 2 Enter dcomcnfg in the Open field and click the OK button The Component Services window opens 3 Expand the tree If the Window Security Alert dialog box appears at expansion click the Keep Blocking button Console Root gt Component Services gt Computers gt My Computer 4 Right click on My Computer and select Properties from the pop up menu The My Computer Properties dialog box is invoked 5 Click the COM Security tab 6 Click the Edit Limits button in the Access Permissions area to open the Access Permission dialog box 7 Select ANONYMOUS LOGON in the Group or user names list 8 Select the Allow checkbox for Remote Activation in the Permission for ANONYMOUS LOGON list 9 Click the OK button and close the Access Permi
624. weapons of mass destruction or for the purpose of any other military use When exporting the products or technology described herein you should follow the applicable export control laws and regulations and procedures required by such laws and regulations All information included in this document such as product data diagrams charts programs algorithms and application circuit examples is current as of the date this document is issued Such information however is subject to change without any prior notice Before purchasing or using any Renesas products listed in this document please confirm the latest product information with a Renesas sales office Also please pay regular and careful attention to additional and different information to be disclosed by Renesas such as that disclosed through our website http www renesas com Renesas has used reasonable care in compiling the information included in this document but Renesas assumes no liability whatsoever for any damages incurred as a result of errors or omissions in the information included in this document When using or otherwise relying on the information in this document you should evaluate the information in light of the total system before deciding about the applicability of such information to the intended application Renesas makes no representations warranties or guaranties regarding the suitability of its products for any particular application and specifically disclaims any liabilit
625. which is next to the Current HEW tools location field Browse to the root directory of the new tool location and click the OK button This will switch the directory and change the tool location to the new directory It will be necessary to scan for any new tools that may be in this location This can be achieved by using the Search Disk or Register Tool functionality Registering a component The High performance Embedded Workshop will automatically attempt to register any new components installed since the last time it was invoked However in some circumstances you may need to register components yourself In some cases it is useful to search a drive for High performance Embedded Workshop compatible components This is especially useful if the High performance Embedded Workshop installation was deleted or corrupted as it can recreate your tool information instantly To search for components and register them ie Click the Search Disk button on the Tools Administration dialog box The Search Disk for Components dialog box opens Enter the directory in which you would like to search into the top field or browse to it graphically by clicking the Browse button Check the Include Subfolders checkbox if you would like to search the directory specified and all directories below it Click the Start button to begin the search During the search the Start button will change to a Stop button Click the Stop button to halt the search at any time
626. wish to compare to the Visual SourceSafe system in advance Select one of the following operations Select a file in the Projects tab of the workspace window Right click on the selected file to open a pop up menu Select Show Differences OR Click the Compare Files toolbar button Pld OR REJ10J2000 0100 Rev 1 00 Jun 16 2009 178 RENESAS High performance Embedded Workshop 11 Comparing Files e Select View gt Differences Right click within the window to open a pop up menu Select Compare 3 The Compare Files dialog box opens Compare Files Reference file Jorkspace DemoSH4 DemoSH4 dbsct c Browse Cancel C Compare with file on drive Target tile Gdvanced Browse f Compare with version control 4 Click the Compare with version control radio button This radio button is selectable if the High performance Embedded Workshop has been connected to the Visual SourceSafe system 5 Enter the name of a file to be compared to in Reference file If you have opened the Compare Files dialog box via the workspace window at step 2 the file name is already entered in Reference file Select a previously used file from the drop down list box or click the Browse button to browse a file 6 Clicking the Advanced button displays the Compare Files Advanced Options dialog box This allows you to perform the difference comparison without taking white space into account Click OK when you are finished
627. wsre c l Workspace DemoSH4 Demos resetpryg c Workspace DemoSH4 DemoSH4 sbrk c Workspace DemoSsH4 DemoSH4 DemoSH4 c Workspace DemoSH4 DemosHt Demoshda cie2 Celsl E No type Workspace DemoSH4 DemosSH4 DemosSH4 cf 40 C10l6 W Arqument n Workspace DemosH4t DemosH4a DemosHd c 49 C1016 iW Arqument Phase SH C C Compiler finished Build Right clicking displays a pop up menu containing available options A basic operation is allocated to the toolbar The functions of Toolbar display and Customize toolbar are also included in the pop up menu displayed by right clicking the toolbar area Pop up Menu Option Toolbar Button Function Ol Highlights the next occurrence of error and shows the source code in the editor GE Highlights the previous occurrence of error and shows the source code in the editor Al Highlights the next occurrence of warning and shows the source code in the editor Display next Displays the editor that generated the next build error or warning Error Warning Info Display previous Error Warning Info Help Displays the editor that generated the previous build error or warning Shows the help information about the line Goes to the associated source line Clears the contents of the window Go to Error Warning Info Clear Window Save Saves the contents of the window into a text file Copy Copies the selected contents onto the Windows clipboard Toolbar display Shows
628. xisting session file radio button Enter a name for the session Browse to an existing session file location which you would like to import into the current project Click the OK button f Use an existing session file Mame Tutorial session file path Browse Gpen and maintain link to session file ae SS ee Make session tle Irate read arly This operation can also be achieved by using the File gt Import session To import an existing session using File gt Import Session 1 Select File gt Import Session The Session Name dialog box opens k Ed emea Session Hame Session name Cancel 2 Enter the new session name 3 Select the session file you wish to import into the new session 4 Click OK A new session is added with the same settings as the file you browsed to but with the new name REJ10J2000 0100 Rev 1 00 Jun 16 2009 292 RENESAS High performance Embedded Workshop 17 Debugging Facility 17 1 6 3 Importing a link to a session You can add a new session to the High performance Embedded Workshop system but link to the session file in its location rather than importing or copying the file to the project directory This is useful when sharing debugger information with other users in a network environment To import a link to an existing session file 1 Select Debug gt Debug Sessions The Debug Sessions dialog box opens Click the Add button The Add new session dialog box
629. xtension belongs to a new group E FSeonateu applicata Pen Broun itty Editor Modis tl Remove 3 Enter the extension that you want to define into the File extension field Use only alphanumeric and an underscore as characters of a file extension string The drop down list contains all extensions that are undefined in the current project Selecting one of these extensions will add the text to the file extension field automatically 4 Select the Extension belongs to an existing group option and select the group to which you would like to add this new extension 5 Click the OK button to add the extension to the File Extensions list REJ10J2000 0100 Rev 1 00 Jun 16 2009 48 RENESAS High performance Embedded Workshop 2 Build Basics 2 6 Setting build options Once you have added the necessary files to the project the next step is to instruct the High performance Embedded Workshop on how to build each file To do this you will need to select a menu option from the Build menu The contents of this menu depend upon which tools you are using To set options for a build phase 1 Select the Build menu and select the phase whose options you would like to modify 2 A dialog box will be displayed allowing you to specify the options 3 After making your selections click the OK button to set them To obtain further information use the context sensitive help button or select the area in which you need assis
630. y Z zl E Debuglnly See DebugOnly See Download modules el 1 C Workspac DebugOnlysCebug Ernulator utorial abs 00000000 Et a Theale file Bbc lbh B CAWorkspaceDebugOnlyD ebugOnlyss ourcesbrk h seen CA Morkspace D ebuglnAlyD ebuglnlyS ounce york h cee CMorkspace SD ebuglnlysDebuglnlyS ounce stacksct h vee machine h feann stddef h stdio h 7 stdlib h Zh a C source file o E CorkspaceD ebuglnAly D ebugl nlyS ounce dbsct c d E Cw orkepacetD ebug nl D ebug0nly S ourcessbrk c a C source file fev E Li Workspace DD ebugllnlyDebugl niles ounce esetprg cpp bese E CWorkspace SD ebugi0nly D ebuglnly S ourcesort cpp faa on EI CA Workspace D ebuglnAly D ebug 0 nly S ounce Tutorial cop E Dependencies F el Projecte If you wish to relocate files in the download module to a different directory this is possible via pop up menu 3 Relocating files to a different directory If you wish to relocate the whole module i e want to relocate all files in the module to a different directory this 1s possible via the download module pop up menu To relocate all files in the module to a different directory 1 Right click on a download module in the Projects tab of the workspace window 2 Select the Relocate Module menu option Selecting this will bring up a standard Windows directory open dialog box Please select new location of module files Ei x Look ir E Debug _Ermulator d
631. y To edit an existing macro file 1 Select Tools gt Macros The Macro dialog box opens 2 Select the macro file the function exists in 3 Select the macro in the function list you wish to edit 4 Click the Edit button 5 The Macros dialog box is dismissed and the file is opened in the editor You can also drag and drop a macro file into the High performance Embedded Workshop window to open this file in the same way as opening an ordinary text file To remove the currently selected macro from the existing macro file 1 Select Tools gt Macros The Macro dialog box opens 2 Select the macro file the function exists in 3 Select the macro in the function list you wish to remove 4 Click the Remove button Pressing the Close button closes the Macro dialog box It is not possible to cancel operations on this dialog box 15 3 Importing a macro file with existing macros If you want to import an existing High performance Embedded Workshop macro file from another machine which already has a number of macros this is easily achieved by the following operations One method for importing macro files is from the macro dialog The instructions are shown below To import an existing macro file into High performance Embedded Workshop 1 Select Tools gt Macros The Macro dialog box opens 2 Click the Import button A standard file browser is opened for you to select the existing macro file you wish to import 3 Select th
632. y OR e Select Edit gt Find OR e Select Find from the pop up menu in the Editor window REJ10J2000 0100 Rev 1 00 Jun 16 2009 91 RENESAS High performance Embedded Workshop 4 Editor Find El Find what F Match whole word only Direction Cancel Match case c Up Regular expression Down 4 Enter the text that you want to search for into the Find what field or select a previous search string from the drop down list box If you select text before invoking the find operation the selected text will be automatically placed into the Find what field 5 If you would like to search for character string as a whole word then click the Match whole word only checkbox When this option is not selected the search will be for any string that is matched by the search string 6 If you would like your search to be case sensitive 1 e to distinguish between upper and lower case letters then check the Match case checkbox 7 If your search string uses regular expressions then check the Regular expressions checkbox See Reference 4 Regular Expressions for further information 8 The Direction radio buttons allow you to select the direction of the search Selecting Down means that the search will be performed from the insertion cursor towards the bottom of the file Selecting Up means that the search will be performed from the insertion cursor towards the top of the file 9 Click the Find Next button to begin the sea
633. y Microsoft Visual Microsoft Visual SourceSafe Microsoft Visual SourceSafe 5 0 6 0 and 2005 Main features SourceSafe 5 0 6 0 and 2005 are already defined 7 1 Selecting a Version Control System The Tools gt Version Control sub menu contains eight menu options but only the Tools gt Version Control gt Select option is initially available This is because a version control system is not yet active for the current workspace Select Eoniaue fine dd toves E Remove Tom Abs et from VES a Heck out tron Wills fo heck into vies a Get VES status To select a version control system 1 Select Tools gt Version Control gt Select The Select Version Control System dialog box opens which lists all of the supported version control systems Select Yersion Control System EAE Version control system Microsoft isual SourceS ate Ronee it 2 Select the desired version control system from the Version control system list 3 Click on the OK button e Once the Custom VCS is selected as a version control system the Tools gt Version Control gt Configure option will become available See Chapter 8 Custom Version Control System REJ10J2000 0100 Rev 1 00 Jun 16 2009 135 RENESAS High performance Embedded Workshop 7 Version Control e Once Microsoft Visual SourceSafe is selected as a version control system other options of the Tools gt Version Control gt Select option will becom
634. y arising out of the application and use of the information in this document or Renesas products With the exception of products specified by Renesas as suitable for automobile applications Renesas products are not designed manufactured or tested for applications or otherwise in systems the failure or malfunction of which may cause a direct threat to human life or create a risk of human injury or which require especially high quality and reliability such as safety systems or equipment or systems for transportation and traffic healthcare combustion control aerospace and aeronautics nuclear power or undersea communication transmission If you are considering the use of our products for such purposes please contact a Renesas sales office beforehand Renesas shall have no liability for damages arising out of the uses set forth above Notwithstanding the preceding paragraph you should not use Renesas products for the purposes listed below 1 artificial life support devices or systems 2 surgical implantations 3 healthcare intervention e g excision administration of medication etc 4 any other purposes that pose a direct threat to human life Renesas shall have no liability for damages arising out of the uses set forth in the above and purchasers who elect to use Renesas products in any of the foregoing applications shall indemnify and hold harmless Renesas Technology Corp its affiliated companies and their officers directors and employ
635. y the user ID password or database in the Log in dialog box opened by clicking the Log In button 5 The Configuration file group box shows the configuration file in the current version control system 9 5 Specifying file locations You can view the current mapping in the project Select the project that you wish to view the mapping from the Show mappings for project drop down list The High performance Embedded Workshop workspace and project directory and Visual SourceSafe project directory are shown in the list Mapping of projects can be added modified or removed For detail see section 8 6 Specifying file locations REJ10J2000 0100 Rev 1 00 Jun 16 2009 167 RENESAS High performance Embedded Workshop 9 Visual SourceSafe Version Control System Custom Commands Mappings General show mappings for project eva Ansara Source Director Version Control Director CAWorkspacesWorkspace Nam Workspace_Name Add C WworkspacesWorkepace Nam v orkepace_NameProject_Nar od iti Remove To define a new directory mapping 1 Select Tools gt Version Control gt Configure The Version Control Setup dialog box opens 2 Select the Mapping tab 3 Click the Add button The Version Control Directory Mapping dialog box opens 4 Specify a High performance Embedded Workshop workspace directory or project directory in the Source directory field Select one of the following operations e Enter the directory name
636. y title A PET Hdefine C function navigation category title ANSI C function To jump to a definition Select either of the following ways e Double click a function or a define definition on the Navigation tab e Right click on a function or a define definition on the Navigation tab Select Go to Definition from the pop up menu 12 2 C navigation component The C navigation component supports the following structures in the view for C source files The basic structure of the information is shown below REJ10J2000 0100 Rev 1 00 Jun 16 2009 183 RENESAS High performance Embedded Workshop 12 Navigation Facilities Workspace x C Classes C navigation ea CFish category title ERN eS a CGreatyhitel r Class name Clase member iy CGreatyyhite Fa eta vee a GetllassName void ee eee B sa m_nArea varnable Ga monea Protected member g m_stName variable E Globals Global variables Ha amp heap_area and functions folder ee aj brk INT Vectors E e Navigation The C navigation view uses a number of icons to describe the type of function or variable the icon belongs too These are listed in the table below Icon Description Private member wariable Double clicking on a navigation item by default jumps you to the associated navigation items declaration This default behavior can be modified by selecting Jump To Definition On Double Click from the pop
637. you want to delete all labela Don t ask this question again If you click OK all the labels are removed from the High performance Embedded Workshop system s symbol table and the list display will be cleared If the message box is not necessary then check the Don t ask this question again check box 17 18 1 6 Loading labels from a file A symbol file can be loaded and merged into the High performance Embedded Workshop s current symbol table Choose Load from the pop up menu to open the load symbols dialog box The dialog box operates like a standard Windows Open file dialog box select the file and click Open to start loading 99 The standard file extension for symbol files is sym 17 18 1 7 Saving labels into a file Choose Save As from the pop up menu to open the save symbols dialog box The save symbols dialog box operates like a standard Windows Save As dialog box Enter the name for the file in the File name field and click Save to save the High performance Embedded Workshop s current label list to a symbol file The standard file extension for symbol files 66 29 is sym See Reference 7 Symbol File Format for symbol file format Once a file is specified by the Save As menu the current symbol table can be saved in the same symbol file just by choosing Save from the pop up menu REJ10J2000 0100 Rev 1 00 Jun 16 2009 359 RENESAS High performance Embedded Workshop 17 Debugging Facility 17 18 1
638. your program s code You will learn how to do this by either running your program continuously or stepping single or multiple instructions at a time 17 13 1 Continuing run When your program is stopped the High performance Embedded Workshop will display a yellow arrow 5 in the gutter of the line in the source and disassembly views that correspond to the CPU s current Program Counter PC address value This will be the next instruction to be executed if you perform a step or continue running To continue running from the current PC address e Click the Go toolbar button El OR REJ10J2000 0100 Rev 1 00 Jun 16 2009 346 RENESAS High performance Embedded Workshop 17 Debugging Facility e Choose Debug gt Go To continue running from a specified address which is not the stop address change the PC value in one of the following ways and click the Go toolbar button Ely or choose Debug gt Go e Change the PC value in the Register window e Place the text cursor not the mouse cursor to a target line in the editor or disassembly window and choose Set PC Here from the pop up menu 17 13 2 Running from reset To reset your user system and run your program from the Reset Vector address click the Reset Go toolbar button or choose Debug gt Reset Go The program will run until it hits a breakpoint or a break condition is met You can stop the program manually at any time by clicking the Halt toolbar button or by ch
639. zed file type in the Workspace window the open operation is passed to the Windows operating system instead of opening the file in the editor The default Open operation is then carried out as if the file was double clicked in Windows Explorer To view the currently defined extensions use the File Extensions dialog box See section 2 5 File extensions and file groups for further information 2 3 2 Drag and drop of files and folders It is possible to drag and drop files or folders from Windows Explorer onto the Projects tab of the workspace window These files or folders can only be dropped onto a project in the active project or a user folder in the active project Note however that you cannot drag and drop files or folders onto multiple folders When you drag and drop files The behavior depends on the destination e A file dropped onto the active project is added into the group folder of the file type If a suitable group folder does not exist the High performance Embedded Workshop creates it For example if you drop the file test c onto the active project this file will be added to the group folder C source file e A file dropped onto a user folder is directly added to this folder Even if a file with the same name is already in the folder the new file can be added to the folder only when these two files have different paths e Ifa file of an unrecognized file type is added to the project this file is di

High-performance Embedded Workshop V.4.06 User`s Manual

Contents

Download Pdf Manuals

Related Search

Related Contents