Page 1 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.
Page 2 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”...
Page 3 High-performance Embedded Workshop V.4.05 User’s Manual Renesas Microcomputer Development Environment System Rev.1.00 2008.11...
Page 4 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.
Page 5 High-performance Embedded Workshop 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.
Page 6 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 REJ10J1837-0100 Rev.1.00 Nov. 16, 2008...
Page 7: Table Of Contents
Associating an application with a file group ...45 2.5.2 Creating a new file extension and file group...47 2.5.3 Creating a new file extension ...48 Setting build options ...49 Build configurations ...49 2.7.1 Selecting a build configuration ...50 REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Contents Contents...
Page 8 Pop-up menu to close the window ...91 Searching and navigating through files...91 4.4.1 Finding text ...91 4.4.2 Finding text in multiple files ...92 4.4.3 Replacing text ...94 4.4.4 Jumping to a specified line...95 Bookmarks...95 REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Contents...
Page 9 6.8.6 Prompting before saving a session ...128 6.8.7 Enabling auto-backup facilities...128 6.8.8 Setting the projects to load on workspace open ...129 6.8.9 Specifying a default directory for new workspaces ...129 Using an external editor...130 REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Contents...
Page 10 Note on using the network facilities to share projects ...176 Comparing Files... 178 11.1 Opening the Difference window...178 Navigation Facilities ... 181 12.1 C function and #define navigation component ...183 12.2 C++ navigation component...183 12.3 Jump to a definition from the editor ...185 REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Contents...
Page 11 Using the Macro dialog box...214 15.3 Importing a macro file with existing macros ...216 15.4 Recording a macro ...216 15.5 Functions that can be recorded into macro files...217 15.5.1 Recordable functions (common to all High-performance Embedded Workshop products)...217 REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Contents...
Page 12 Changing the program display position immediately after downloading...318 17.3.15 Refreshing the Memory window...318 17.3.16 Disabling refresh of the Memory window ...318 17.3.17 Regularly refreshing the Memory window ...318 17.3.18 Specifying the refresh interval ...319 REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Contents...
Page 13 Switching Register Bank...341 17.7.4 Setting the layout ...342 17.7.5 Choosing a register to be displayed...342 17.7.6 Modifying register contents ...343 17.7.7 Setting the flag value...344 17.7.8 Splitting up the window display...344 17.7.9 Saving register contents ...344 REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Contents...
Page 14 18.2.2 Parallel mode functionality ...386 18.2.3 Internal mode functionality ...387 18.3 Using the command line window when synchronized...388 18.4 Glossary of terms ...389 Technical Support ... 390 19.1 Viewing the version information ...390 REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 viii Contents...
Page 15 Integrated Toolbars in a Components View ... 416 To Build in Toolchain for High-performance Embedded Workshop V.1.x ... 418 HMAKE User Guide... 419 13.1 Command line...419 13.2 File syntax...419 13.3 Description blocks ...420 13.4 Comments ...422 13.5 Message commands ...422 REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Contents...
Page 16: Overview
(e.g. build, version control commands and so on). REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 1. Overview...
Page 17: Title Bar
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 1. Overview...
Page 18: Toolbars
Editor, Search, Templates, Bookmarks, Default Window, and Standard will not be displayed by default. Toolbars can be created, modified and removed via [Tools -> Customize] (see section 6.1, Customizing the toolbars, for further information). Editor toolbar Search toolbar Templates toolbar Bookmarks toolbar Default Window toolbar REJ10J1837-0100 Rev.1.00 Nov. 16, 2008...
Page 19 This toolbar is only available when a session is being used which has a target attached. Debug Run toolbar This toolbar is only available when a session is being used which has a target attached. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008...
Page 20: Workspace Window
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). REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 1. Overview...
Page 21 Right-click anywhere inside the Workspace window or the Output window. Then a pop-up menu will be displayed. 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 1. Overview...
Page 22 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. • Drag the control bar of a docked window while pressing the "CTRL" key. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 1. Overview...
Page 23: Editor Window
Options dialog box, which can be invoked via [Setup -> Options]. For further details on how to use the editor, see Chapter 4, Using the Editor. Note: *. Allows you to set software breakpoints only when the debugger is connected to the session. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 1. Overview...
Page 24: Output Window
Icon Build Error Build Warning Information REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Function Highlights the next occurrence of error and shows the source code in the editor. Highlights the previous occurrence of error and shows the source code in the editor.
Page 25 Clear Window Save Copy Toolbar display Customize toolbar REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Function Clears the contents of the window. Saves the contents of the window into a text file. Copies the selected contents onto the Windows® clipboard. Shows or hides the toolbar.
Page 26 Black 4. Change the selection in the Foreground and Background lists of the Color tab. 5. Click the OK button. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Function Clears the contents of the window. Saves the contents of the window into a text file.
Page 27: Status Bar
When this is clicked, the mouse pointer will change to 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 1. Overview...
Page 28: Launching The High-Performance Embedded Workshop
Launching the High-performance Embedded Workshop To initiate the High-performance Embedded Workshop, open the Start menu of Windows 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.
Page 29: Opening A Workspace
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 1. Overview...
Page 30: Using Old Workspaces
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 1. Overview...
Page 31: Closing A Workspace
• Keyboard shortcut layout files • Macro information file and newly added macro files • Custom project-type wizard files • Syntax highlighting files • Templates files • Synchronized debug option configuration files * REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 1. Overview...
Page 32: Overview Of Configurations And Sessions
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 debugging platform.
Page 33 "SimDebug_SH-4" is created. Configuration names can be changed 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008...
Page 34 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.
Page 35 Debug Settings dialog box opened from the Build menu. Options can be set up in the Target and Options tabs. See section 17.1.6, Debugger sessions, for more information about a Debugger sessions. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 1. Overview...
Page 36: Overview Of Macro-Recording Support Facility And Test Support Facility
Macros Macro Recording Play Macro Stop Macro REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Function 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.
Page 37 16.6, Functions that can be saved as test-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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008...
Page 38 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008...
Page 39: 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 1. Overview...
Page 40: Step 1: Recording A Macro
3. Click the Registers button ( of which you wish to change the value, to invoke the Set Value dialog box. Enter 0 in Value. This records the register_set command. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Operation Reload the session. (See "Step 1 (2)".) Initialize register values *.
Page 41 To view the recorded High-performance Embedded Workshop command-line commands, be sure to select the Macro tab of the Output window. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 ) on the Standard toolbar to build the program for demonstration. ) on the CPU toolbar to invoke the Display Address dialog box. Enter the ) on the Debug Run toolbar to reset the CPU.
Page 42: Step 2: Editing A Macro (Viewing Records)
Output window. clear_output_window debug Modify the description as required and click the Save File button ( performance Embedded Workshop macro file “Default.hdc”. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 ) on the Editor toolbar. Close the High- 1. Overview...
Page 43: Step 3: Playing A Macro
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 1. Overview...
Page 44 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. 10. Click the OK button. The test “Test_Demo” is added to the Test cases list. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 1. Overview...
Page 45: Step 6: Creating A Test Image File
2. 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”. 3. Select the checkboxes Memory-xxxxxx (under CPU in Available components) and Watch-xxxxxx (under Symbol). REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 1. Overview...
Page 46 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 1. Overview...
Page 47: Step 7: Modifying The Program Before The Test
In this example, the target 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008...
Page 48: Step 8: Viewing The Test Result (Unmatched)
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 ) on the Editor toolbar. 1. Overview...
Page 49: Step 9: Modifying The Program Back And Executing The Test Again
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 ) on the Editor toolbar. 1. Overview...
Page 50: Build Basics
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008...
Page 51: Configuring The Projects Tab Of The Workspace Window
Unload Project Load Project Add Files Remove Files Add Folder REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 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.
Page 52 Macro Recording Download Download (Debug Data Only) Unload Download A New Module Remove REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Expands or collapses the tree below a project icon. Executes a version control system. Configures the workspace view. Displays project properties. Function Add a custom folder.
Page 53: 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). REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Opens the Debug Settings dialog box, which allows you to modify the debug settings.
Page 54: Adding Files To A 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 2. Build Basics ®...
Page 55: Drag And Drop Of Files And Folders
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 ® operating system (instead of opening the file in the editor). The 2.
Page 56: Removing Files From A Project
3. Click the Remove button to remove the file(s), or click the Remove All button to remove all files from the list. 4. Click the OK button to remove the files from the project. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 2. Build Basics...
Page 57: Excluding A Project File From Build
It is also possible to select several files by using a mouse or inputs through the keyboard as follows: • To select several files Click the files while pressing the CTRL key. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 2. Build Basics...
Page 58: Including A Project File In Build
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 REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 ) will appear on the file’s icon, and the file will be 2. Build Basics...
Page 59: File Extensions And File Groups
File extensions and file groups can be viewed and modified via the File Extensions dialog box, which is invoked by selecting [Project -> File Extensions]. This dialog box displays all the extensions and file groups that are defined within the current workspace. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 2. Build Basics...
Page 60: 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008...
Page 61 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 2. Build Basics...
Page 62: Creating A New File Extension And File Group
5. At this stage it is possible to change the associated application. There are four available choices in the Open "<extension group>" with drop-down list: • Editor • None • Other • Windows default REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 placeholder to specify the location of the file (see Reference 5, Placeholders, for 2. Build Basics...
Page 63: Creating A New File Extension
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 but the High-performance Embedded Workshop only recognizes .asm 2.
Page 64: Setting Build Options
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 MyDebug and MyOptimized.
Page 65: Selecting A Build Configuration
1. Select [Build -> Build Configurations]. The Build Configurations 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 2. Build Basics...
Page 66: Building A Project
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 ), OR...
Page 67: Building Multiple Projects
Click the Stop Tool Execution toolbar button ( • Select [Build -> Stop Tool Execution]. The ‘Build Stopped by User’ message appears in the Build tab of the Output window. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 ), OR 2. Build Basics...
Page 68: Deleting Intermediate And Output Files Produced In Building
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 ), OR 2. Build Basics...
Page 69: Configuring The Build Tab Of The Output Window
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 2. Build Basics...
Page 70 1. Select [Setup -> 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Function Highlights the next occurrence of error and shows the source code in the editor.
Page 71: Controlling The Content Of The Build Tab Of The Output Window
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Background Color of the Tab(s) to be Color Tab (Default)
Page 72: File Dependencies
Initially, the dependencies for all files are contained within the Dependencies folder (although this can be modified by configuring the projects tab). REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 2. Build Basics ’ one or more header files.
Page 73 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". REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Specific Operation Select option in the Welcome! dialog box Select [File ->...
Page 74 • Select [Build -> Update All Dependencies], OR • Right-click on a project in the Projects tab of the Workspace window and select [Build -> Update All Dependencies] from the pop-up menu. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 2. Build Basics...
Page 75: Configuring The Workspace Window
C code, if you write a ‘#include’ statement, such as ‘#include <stdio.h>’, 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). REJ10J1837-0100 Rev.1.00 Nov. 16, 2008...
Page 76: Inserting A Project Into The Workspace
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 it is created, you can insert new or existing projects into the workspace. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008...
Page 77: Setting The Current Project
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 2. Build Basics...
Page 78: Specifying Dependencies Between Projects
(excluding the selected project). 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 2. Build Basics...
Page 79: Removing A Project From The Workspace
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 2. Build Basics...
Page 80: Advanced Build Features
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 -> Build Phases]. On the left-hand side are the phases that are defined in the current project. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 3. Advanced Build Features...
Page 81: Creating A Custom Build 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 3. Advanced Build Features...
Page 82 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008...
Page 83 Default Options field. If you have a preferred directory in which 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008...
Page 84 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008...
Page 85: Ordering Build Phases
) 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 3. Advanced Build Features...
Page 86 6. Select the Read output on-the-fly checkbox if you want to display build output as it happens, rather than showing the output at the end of each phase execution. 7. Select the Environment tab to edit the environment settings for the phase. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 3. Advanced Build Features...
Page 87 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.
Page 88: Build File Order Tab
C source file. If you don’t want a certain phase to execute when [Build -> Build File] is selected then clear the check box to the left of the phase name in the Phase order list. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 3. Advanced Build Features...
Page 89: File Mappings Tab
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 3. Advanced Build Features...
Page 90: Setting Custom Build Phase Options
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 3. Advanced Build Features...
Page 91: Output Files Tab
If so, the phase will be executed for that file (i.e. dependent files have been modified since the input files was last modified). If not, the phase will not be executed. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 3. Advanced Build Features...
Page 92: Controlling The Build
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 3. Advanced Build Features...
Page 93: Logging Build Output
Change Toolchain Version]. Choose one of the versions from the Toolchain version drop-down list and click the OK button to enforce your choice. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 ) and select the placeholder from the pop-up menu. 3. Advanced Build Features...
Page 94: Generating A Makefile
2. Select a configuration for generating a makefile. 3. Select [Build -> Generate Makefile]. The Generate Makefile dialog box opens. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 3. Advanced Build Features...
Page 95 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Workspace Directory and below Absolute path...
Page 96: Using A Makefile Inside The High-Performance Embedded Workshop System
2. If you want to use a High-performance Embedded Workshop generated makefile, select [Build -> Generate Makefile] to generate a makefile. For details, see section 3.8, Generating a makefile. 3. Select [Setup -> Options]. The Options dialog box opens. 4. Click the Build tab. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 3. Advanced Build Features...
Page 97 4. 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 3. Advanced Build Features...
Page 98: Customizing The High-Performance Embedded Workshop Linkage Order
You can change the linkage order in the following ways. • 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 3. Advanced Build Features...
Page 99 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 3. Advanced Build Features...
Page 100 4. 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. 5. Select a configuration and click OK. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 3. Advanced Build Features...
Page 101: Using The Editor
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 4. Using the Editor...
Page 102: Working With Multiple Files
(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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 ), OR...
Page 103: Saving A File
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Action Select [Edit -> Undo] Press CTRL+Z Select [Edit ->...
Page 104: Opening A File
• 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 ), OR ), OR 4. Using the Editor...
Page 105: Closing Files
Clicking Yes opens the Save file dialog box. Change the file name before saving. • Clicking No closes the file without saving. • Clicking Overwrite closes the file by overwriting the contents. • Clicking Cancel returns to the editor window. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 4. Using the Editor Close], OR ->...
Page 106: Pop-Up Menu To Close The Window
• Select [Edit Find], OR -> • Select Find from the pop-up menu in the Editor window. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Function Saves the contents of an editing window. Closes an individual file. Function Closes the Disassembly window. ), OR...
Page 107: Finding Text In Multiple Files
1. Select one of the following operations to open the Find In Files dialog box: • Click the Find In Files toolbar button ( • Press the F4 key, OR • Select [Edit -> Find in Files]. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 ), OR 4. Using the Editor...
Page 108 9. Click Find to begin the search. Any matches found will 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 REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 4. Using the Editor *.C;...
Page 109: Replacing 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 4. Using the Editor...
Page 110: Jumping To A Specified Line
• Select [Edit Bookmarks -> • Right-click and select [Bookmarks 3. The bookmark icon will be removed from the line. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 ), OR Toggle Bookmark], OR -> Toggle Bookmark] from the pop-up menu. -> ), OR Toggle Bookmark], OR ->...
Page 111: Printing A File
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). REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 ), OR Next Bookmark], OR ->...
Page 112: Changing Tabs
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 4. Using the Editor...
Page 113: Auto Indentation
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). REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 4. Using the Editor int z = ’...
Page 114: Changing The Editor Font
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 4. Using the Editor...
Page 115: Changing Text Colors
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 4. Using the Editor...
Page 116: Enabling/Disabling Syntax Coloring
To enable/disable syntax coloring 1. Select [Setup -> Options]. The Options dialog box opens. 2. Select the Editor tab. 3. Set the Enable syntax coloring checkbox as necessary and then click the OK button. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 4. Using the Editor...
Page 117: Templates
Right-click on the Templates in the Templates tab of the workspace window and select Edit from the pop- up menu, OR • Right-click in the editor window and select [Templates -> Define Templates] from the pop-up menu. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Function Adds a new template. Removes the current selection.
Page 118 When the template is inserted 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Placeholder Replaced With...
Page 119: Deleting A Template
2. Select one of the following operations: • Click the Match Braces toolbar button ( • Press CTRL+SHIFT+M, OR REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 ), OR ), OR ’ clause. To help in such situations, the ), OR 4. Using the Editor...
Page 120: Setting The Read-Only Attribute For A File
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 REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 4. Using the Editor...
Page 121: 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/hiding 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 4. Using the Editor...
Page 122: Opening A File Within The Editor
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 4. Using the Editor...
Page 123: Evaluate An Expression
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Multiplication (*) Division (/) Logical NOT (!) *...
Page 124: Tools Administration
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 5. Tools Administration...
Page 125: High-Performance Embedded Workshop Registration Files
It is possible to change the tool directory location and this causes a re-scan of the tools that are registered in High-performance Embedded Workshop. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008...
Page 126: Registering A Component
5. 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. 6. Click the Close button to exit the dialog box. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 5. Tools Administration...
Page 127: Unregistering A Component
The General tab displays the name, version and location of the selected component. Select the Information tab to view any information about the component. This may include copyright information, enhancements and so on. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 5. Tools Administration...
Page 128 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 5. Tools Administration...
Page 129: Technical Support
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 5. Tools Administration...
Page 130: Using On-Demand Components
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Component not found icon Incompatible component found icon...
Page 131: Custom Project Types
When the registered toolchain can be updated, the toolchain version can be changed in the dialog box that is displayed by selecting [Tools –> Change Toolchain Version]. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008...
Page 132 High-performance Embedded Workshop 5. Tools Administration REJ10J1837-0100 Rev.1.00 Nov. 16, 2008...
Page 133: Customizing The Environment
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 6. Customizing the Environment...
Page 134 The Reset Positions button reverts 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 6. Customizing the Environment...
Page 135: Customizing The Tools Menu
7. Enter the initial directory, in which you would like the tool to run, into the Initial directory field. 8. Click the OK button to add the menu option to the Tools menu. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 6. Customizing the Environment...
Page 136: Using 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 6. Customizing the Environment ) will be used.
Page 137: Using The Workspace And Project Log Facilities
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 6. Customizing the Environment...
Page 138: Configuring The Help System
To add a new help file 1. Select [Setup -> Customize]. The Setup Customize dialog box opens. 2. Select the Help tab. 3. Click the Add button. The Add Help File dialog box opens. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 6. Customizing the Environment...
Page 139: Keyboard Shortcut Customization
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: REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 6. Customizing the Environment...
Page 140: Scope Of A Control In The Setup
Scope of a control in the Customize dialog box The scope of each control in the Customize dialog box, which is launched via [Setup -> Customize], differs. This can be confusing so these have been listed below: REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 6. Customizing the Environment...
Page 141: Scope Of A Control In The Options Dialog Box
If you would like the files associated with a workspace to be opened when the workspace is opened, then set this checkbox. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 6. Customizing the Environment...
Page 142: Displaying Workspace Information On Opening 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 6. Customizing the Environment...
Page 143: Prompting Before Saving A Session
5. Click the OK button. 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 6. Customizing the Environment...
Page 144: Setting The Projects To Load On Workspace Open
One of the fields on this dialog is the directory in which the new workspace will be created. By default, this is the Workspace directory. However, it is also possible to set this default directory to another location. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 6. Customizing the Environment...
Page 145: Using An External Editor
To specify an external editor 1. Select [Setup -> Options]. The Options dialog box opens. 2. Select the Editor tab. 3. Check the Use external editor checkbox. The External Editor dialog box opens. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 6. Customizing the Environment...
Page 146 If you select a file in the Projects tab of the workspace window and right-click to display a pop-up menu, the Open <file name> in external editor menu option is available under the Open <file name> menu option. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 6. Customizing the Environment...
Page 147: Customizing The Font In Your Views
Memory Accessed Not Accessed REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Objects to be Customized A selected text shown in the editor window and disassembly window (in source mode) The line at the PC (program counter) in the editor window and disassembly window (in source...
Page 148: Using The 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Text outside the coverage range shown in the Memory window Text outside the memory range shown in the Memory window...
Page 149: Version Control
Configuration file Source file C source file C++ source file Assembly source file Include file C header file C++ header file Assembly include file REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 File Extension Supported CPU Type Common Common Common Common • SuperH family •...
Page 150: Selecting A Version Control System
Once the "Custom VCS" is selected as a version control system, the [Tools -> Version Control -> Configure] option will become available. See Chapter 8, Using the Custom Version Control System. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Description Any version control system in which command-line commands should be executed via the MS-DOS command prompt (such as , or PVCS).
Page 151: Importing And Exporting A Set-Up
2. Click the Import button. An Import a Version Control configuration dialog box opens. 3. Browse to the file that you would like to import. *.HVC 4. Select the file and then click the Import button. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 7. Version Control...
Page 152: Using The Custom Version Control System
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 -> Version Control -> Configure]. The Version Control Setup dialog box opens. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 8. Using the Custom Version Control System...
Page 153: System-Defined Menu Options
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 8. Using the Custom Version Control System...
Page 154: User-Defined Menu Options
2. Select the menu option to be removed from the [User menu options list and click the Remove button. 3. Close the Version Control Setup dialog box by clicking the OK button. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 8. Using the Custom Version Control System...
Page 155: Defining Version Control Commands
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 8. Using the Custom Version Control System...
Page 156: Specifying Arguments
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 8. Using the Custom Version Control System...
Page 157: Specifying File Locations
Click the Browse button to open the Browse to Source Directory dialog box. Select the directory and click the Select button. 5. Enter the version control directory into the Version Control Directory field. 6. Click the OK button. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 8. Using the Custom Version Control System...
Page 158: Specifying File Locations Example
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 version control directory mapping for ‘c:\work\application\project1’. 2. ‘FILE1.C’ is substituted for ‘$(FILENAME)’. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 8. Using the Custom Version Control System...
Page 159: Specifying Environment
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 8. Using the Custom Version Control System...
Page 160: Specifying A User Name And Password
7. 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 8. Using the Custom Version Control System...
Page 161: Usage Example Of The Custom Version Control System
1. Select [File -> New Workspace] to open the New Project Workspace dialog box. 2. Create a workspace with the following conditions. • Workspace Name: rcs_sample • Project Name: rcs_sample • Directory: C:\WorkSpace\rcs_sample 3. Create a folder for RCS. C:\WorkSpace\rcs_sample\rcs_sample\RCS REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 8. Using the Custom Version Control System...
Page 162 Select [Tools -> Version Control -> Configure] to open the Version Control Setup dialog box. • Setting environment variables 1. Select the Projects tab. 2. Click the Add button on Environment. 3. The Environment dialog box appears. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 8. Using the Custom Version Control System...
Page 163 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 8. Using the Custom Version Control System...
Page 164 2. Select the file "rcs_sample.c" in the Projects tab of the workspace window and then select [Tools -> Version Control -> Check in]. 3. The MS-DOS command prompt window opens. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 8. Using the Custom Version Control System Characters to be Input C:\RCS\CO.EXE...
Page 165 1; selected revisions: 1 description: ---------------------------- revision 1.1 locked by: user; date: 2006/03/14 07:22:42; author: user; state: Exp; Initial revision ============================================================================= REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 8. Using the Custom Version Control System...
Page 166: Connecting The High-Performance Embedded Workshop With Cvs
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) REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 8. Using the Custom Version Control System...
Page 167 1. Select the Projects tab. 2. Click the Add button on Environment. 3. The Environment dialog box appears. 4. Enter "CVSROOT" in Variable and "C:\cvs-1-11-17\DATABASE" in Value, respectively. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 8. Using the Custom Version Control System...
Page 168 4. Enter "Initialize" in Option and click the Add button. 5. The Add Command dialog box appears. 6. Enter "C:\cvs-1-11-17\cvs.exe" in Version control executable. 7. Enter "init" in Arguments. 8. Enter "C:\src\sampleCVS" in Initial directory. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 8. Using the Custom Version Control System...
Page 169 8.11.2.5 Step 5: Using the Version Control facility (Register a Module) 1. Select [Tools -> Version Control -> Register]. 2. 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.
Page 170 4. 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 -r1.1.1.1 sampleCVS.c 28c28,31 < printf("### Data Input ###\n"); REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 8. Using the Custom Version Control System...
Page 171 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 REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 8. Using the Custom Version Control System...
Page 172 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 8. Using the Custom Version Control System...
Page 173: Using Visual Sourcesafe
1. Select [Tools -> Version Control -> Select]. The Select Version Control System dialog box opens. 2. Select the "Microsoft Visual SourceSafe" entry from the Version control systems list. 3. Click OK. The SourceSafe Login dialog box opens. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 9. Using Visual SourceSafe...
Page 174 8. The 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 9. Using Visual SourceSafe...
Page 175: Visual Sourcesafe Commands
Check out from VCS Check in to VCS Get VCS status Undo Check Out Show History REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 9. Using Visual SourceSafe Function Adding files to Visual SourceSafe Removing files from Visual SourceSafe Getting read-only copy of files from Visual SourceSafe...
Page 176: Adding Files To Visual Sourcesafe
3. 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 REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 ), OR ), OR 9.
Page 177: Removing Files From Visual Sourcesafe
Select the [Tools -> Version Control -> Get from VCS] menu option, OR • Right-click to invoke a pop-up menu and select [Version Control -> Get from VCS]. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 ), OR ), OR 9. Using Visual SourceSafe...
Page 178: Checking Out Writable Copy Of Files From Visual Sourcesafe
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 9. Using Visual SourceSafe...
Page 179: Checking In Writable Copy Of Files Into Visual Sourcesafe
Click the Check in to VCS toolbar button ( • Select [Tools -> Version Control -> Check in to VCS], OR • Right-click to invoke a pop-up menu and select [Version Control -> Check in to VCS]. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 ), OR 9. Using Visual SourceSafe...
Page 180: Viewing The Status Of Files In Visual Sourcesafe
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 REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 ), OR...
Page 181: Viewing The History Of Files In Visual Sourcesafe
2. Select one of the following operations: • Select [Tools -> Version Control -> Show History], OR • Right-click to invoke a pop-up menu and select [Version Control -> Show History]. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 9. Using Visual SourceSafe...
Page 182: Visual Sourcesafe Command Options
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 9. Using Visual SourceSafe...
Page 183 Directory Mapping dialog box opens. 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 9. Using Visual SourceSafe...
Page 184: Adding Visual Sourcesafe Commands
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 9. Using Visual SourceSafe...
Page 185 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 9. Using Visual SourceSafe...
Page 186: Sharing Projects By Network Facilities
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 10. Sharing Projects by Network Facilities...
Page 187: Sharing Projects By Network Facilities In A Pc With Windows® Xp Service Pack 2 Or Later
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 10. Sharing Projects by Network Facilities...
Page 188 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 10. Sharing Projects by Network Facilities...
Page 189: Enabling Network Facilities To Share Projects
2. Click the Password button. This should have been enabled when the network data access was enabled. 3. The Change password dialog box opens. 4. The user name is read only in the top field. In this case it should be Admin. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 10. Sharing Projects by Network Facilities...
Page 190: Adding New Users To The System
4. Click the Access rights button. The User access rights dialog is displayed. 5. Select the user you wish to remove in the users list. 6. Press the Remove button. 7. Then click OK to save the access rights changes. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 10. Sharing Projects by Network Facilities...
Page 191: Changing Your Password
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 10. Sharing Projects by Network Facilities...
Page 192 The only instance when this is not the case is if the same machine is serving all of the network workspaces. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008...
Page 193: Comparing Files
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 ( REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 ), OR ), OR 11. Comparing Files...
Page 194 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 11. Comparing Files...
Page 195 Previous difference Next difference Refresh comparison Toolbar display Customize toolbar REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Macro Recording 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.
Page 196: Navigation Facilities
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Function All #defines for C and C++ source files are displayed.
Page 197 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. 3. Un-check any categories you are not interested in seeing definitions for. 4. Click OK. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 12. Navigation Facilities...
Page 198: C Function And #Define Navigation Component
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 12. Navigation Facilities...
Page 199 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. • Right-click on navigation items on the Navigation tab to display a pop-up menu. Select Go to Declaration. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 12. Navigation Facilities...
Page 200: Jump To A Definition From The Editor
3. If two 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 12. Navigation Facilities...
Page 201: Drag And Drop Navigation Items
Multiple items can be dragged at the same time (these will appear on separate lines). • The navigation item names will be inserted in alphabetical order. • Note that if you drag a function, only the function's name will be dragged. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 12. Navigation Facilities...
Page 202: Smart Edit Capability
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 12. Navigation Facilities...
Page 203 List Members. A pop-up window opens. Select an item you wish to add and press ENTER, OR Press CTRL+SPACE to display a pop-up window. Select an item you wish to add and press ENTER. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 12. Navigation Facilities...
Page 204: Map
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 -> Build]. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 13. Map...
Page 205: Managing Section Settings
To open the Map Section Information window 1. Select one of the following operations to open the Select Map Window Type dialog box: • Select [View -> Map], OR • Click the Map toolbar button ( REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 13. Map...
Page 206 ) or section ) and drag it Select an overlay group ( ) and drag it REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Appearance of the Mouse Pointer while an Item is Dragged ‘Normal select’ pointer showing the item name and a ‘+’...
Page 207 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Toolbar Button Function Enters the edit mode.
Page 208: Entering/Exiting The Edit Mode
C/C++ compiler package V.6.01 Release 02 or later. To exit the edit mode 1. Right-click within the left pane to open a pop-up menu. 2. Select Section Edit Mode. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Function Shows the unallocated area. Shows the no size section.
Page 209: Adding A Section Group
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 menu. 2. Select Add Section. 3. The Add Section dialog box appears. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 13. Map...
Page 210: Adding An Overlay Group
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 to the left pane. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 13. Map...
Page 211: Editing A Selected Item
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 13. Map...
Page 212: Setting A Memory Map
2. Select Memory Resource Auto Allocate. The dialog box shown below appears. 3. To continue processing, click OK. 4. When allocation is completed, the dialog box shown below appears. Support for this function depends on the debugger. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 13. Map...
Page 213: Printing Out The Section Settings Tree
Select one of the following operations: • Right-click on the section-list line in the right pane to open a pop-up menu. Then select View Source, OR • Double-click on the section-list line in the right pane. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 13. Map...
Page 214: Printing Out The Section List
1. Select one of the following operations to open the Select Map Window Type dialog box: • Select [View -> Map], OR • Click the Map toolbar button ( 2. Select "Map Symbol Information" in the Map drop-down list. 3. Click OK. Window configuration REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 13. Map...
Page 215 Pop-up Menu Option Toolbar Button Find Find Next Filter View source Print REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Function Prints section tree view. Shows or hides the toolbar. Customizes toolbar buttons. Function Finds a symbol. Finds the next symbol that matches the search text.
Page 216: Printing Out The Map List
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 13. Map...
Page 217: Viewing The Source Code For The Address
• Right-click on the symbol-list line in the right pane to open a pop-up menu. Then select View Source, OR • Double-click on the symbol-list line in the right pane. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Filter Item Function Function Filter by functions...
Page 218: Printing 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 13. Map...
Page 219: Using The Command Line
Debugger tab. You can clear the information shown on this pane. The contents of the lower pane of the Debugger tab will also be cleared. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 14. Using the Command Line ) to open the Command Line...
Page 220 You can clear the information shown in this pane. The contents of the Console tabbed pane will also be cleared. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 ) in the Breakpoint column indicates the command line where execution is to start. 14. Using the Command Line...
Page 221 Pop-up Menu Option Toolbar Button Set Batch File Play Stop Reset REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Macro Recording Function Specifies a batch file. Plays the current batch file. Stops execution of the current batch file. Specifies a log file. Starts or stops output to log file.
Page 222: Specifying A Batch File
Debugger tabbed pane in the Command Line window will be updated. The status of the batch file will be reset, with all breakpoints deleted. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Single-steps in a batch file. Toggles a break point on the current line of a batch file.
Page 223: Executing A Batch File
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 14. Using the Command Line...
Page 224: Starting Or Stopping Logging
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Placeholder $(CONFIGDIR)
Page 225: Clearing The Contents Of The Command Line Window
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 ) is displayed, users can see if brackets match. The button State...
Page 226: Single-Stepping In A Batch File
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 14. Using the Command Line...
Page 227: Setting A Breakpoint In A Batch File
Debugger tabbed pane in the Command Line window will be updated. The status of the batch file will be reset, with all breakpoints deleted. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 14. Using the Command Line ). Up to 256 breakpoints can be set. When...
Page 228: Using The Macro-Recording Support Facility
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 menu options. This is shown below. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008...
Page 229: 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 15. Using the Macro-Recording Support Facility...
Page 230 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 15. Using the Macro-Recording Support Facility...
Page 231: Importing A Macro File With Existing Macros
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 15. Using the Macro-Recording Support Facility...
Page 232: Functions That Can Be Recorded Into Macro Files
Refresh Session Download A New Module *2 Recent Workspaces Recent Downloaded Modules Edit Toggle Breakpoint Enable/Disable Breakpoint REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 15. Using the Macro-Recording Support Facility ) and menus are enabled. Shortcut Key Toolbar Button CTRL+F9 ). When...
Page 233 *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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 15. Using the Macro-Recording Support Facility CTRL+F7...
Page 234 Build "<File name>" pop-up menu option Toggle Breakpoint pop-up menu option Enable/Disable Breakpoint pop-up menu option REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 15. Using the Macro-Recording Support Facility Opened by [View -> Workspace] Double-clicking on a file in the Projects tab of the workspace window [View ->...
Page 235 Compare Pop-up menu option/toolbar button * Save Pop-up menu option/toolbar button Load Pop-up menu option/toolbar button REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 15. Using the Macro-Recording Support Facility Runs program until the PC reaches cursor. Sets PC to the address at cursor.
Page 236: Recordable Functions (Dependent On The Debugger)
CWatch [View -> Symbol -> CWatch] S/W Break Points [View -> Break -> S/W Break Points] REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 15. Using the Macro-Recording Support Facility In-place edit Make setting in the dialog box opened by double-clicking a value...
Page 237 Support of this function depends on the debugging platform in use. For details, refer to the user’s manual, help files, or the release notes for the emulator or the simulator debugger. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 15. Using the Macro-Recording Support Facility...
Page 238 While a macro is being recorded, the following operations will be recorded into a macro file. Target Auto Update pop-up menu option/toolbar button Auto Update All pop-up menu option/toolbar button REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Operation Make setting in the dialog box opened by clicking on the menu option...
Page 239 While a macro is being recorded, the following operations will be recorded into a macro file. Target Set pop-up menu option/toolbar button Value REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Make setting in the dialog box opened by clicking on the menu option or toolbar button Click on the menu option or toolbar button Stops recording the updated values.
Page 240 Enable pop-up menu option/toolbar button Clear Data pop-up menu option/toolbar button Save Data pop-up menu option/toolbar button Load Data pop-up menu option/toolbar button REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 15. Using the Macro-Recording Support Facility Operation Function Click on the button Adds the break point.
Page 241 While a macro is being recorded, the following operation will be recorded into a macro file. Target Operation Apply button Click on the button REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 15. Using the Macro-Recording Support Facility Operation Make setting in the dialog box opened by clicking on the menu option or toolbar button...
Page 242 While a macro is being recorded, the following operation will be recorded into a macro file. Target Operation Apply button Click on the button REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 15. Using the Macro-Recording Support Facility Function Changes the trace conditions. Function Sets the access violation area.
Page 243 While a macro is being recorded, the following operation will be recorded into a macro file. Target Operation OK button Click on the button REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 15. Using the Macro-Recording Support Facility Function Clears all measurement data of real- time profile.
Page 244: Playing A Macro
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 REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 15. Using the Macro-Recording Support Facility Function Specifies the address of a work area and an executing routine.
Page 245: Assigning A Macro
6. Select the keyboard shortcut you wish to assign to the macro in the drop-down list. 7. Click OK and the shortcut is now available for use. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 15. Using the Macro-Recording Support Facility ) or specify your own toolbar...
Page 246: Configuring The Macro Tab Of The Output Window
Clear Window Save Copy Toolbar display Customize toolbar REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 15. Using the Macro-Recording Support Facility Function Clears the contents of the window. Saves the contents of the window into a text file. Copies the selected contents onto the Windows® clipboard.
Page 247: Using The Test Support Facility
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008...
Page 248: Opening And Closing Test Suites
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 16. Using the Test Support Facility...
Page 249 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008...
Page 250: Adding Tests To The Test Suite
This file can be created by using [Test -> Create Test Image File]. 11. Clicking OK adds the test to the Modify Test Suite dialog box. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 16. Using the Test Support Facility...
Page 251: Creating A Test Image File
1. Select the [Test -> Create New Test Image File]. The Create New Test Image dialog box is then displayed. 2. Clicking the Check All button selects all checkboxes, while clicking the Uncheck All button deselects all checkboxes. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 16. Using the Test Support Facility...
Page 252: Functions That Can Be Saved As Test-Image Data Into Test-Image Files
• Functions that can be saved into test-image files (common to all High-performance Embedded Workshop products) • Functions that can be saved into test-image files (dependent on the debugger) REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 16. Using the Test Support Facility...
Page 253: Functions That Can Be Saved Into Test-Image Files (Common To All High-Performance Embedded Workshop Products)
Test-image data to be All information in the Debug tab of the output window. saved into test-image files Test result details Original REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Window (Tab) Name Build tab of the Output window Debug tab of the Output window Register...
Page 254 If you double-click on a test item in the Create New Test Image dialog box, a further dialog box for detailed setting opens. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Data in the current High-performance Embedded Workshop system or in another test-image...
Page 255 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Name of the unmatched sheet Unmatched line number...
Page 256 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Unmatched address Content of the test-image file Data in the current High-performance Embedded Workshop system or in another...
Page 257 Memory ranges list will be deleted. Only one trace range is 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). REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 16. Using the Test Support Facility...
Page 258: Functions That Can Be Saved Into Test-Image Files (Dependent On The Debugger)
Test Item Name Symbol Watch Locals REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Content of the test-image file Data in the current HEW system or in another test-image file to be compared with Value differs. Src = F, PowerON_Reset_PC(), { 0000080E }...
Page 259 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 ASMWatch [View -> Symbol -> ASMWatch] CWatch [View ->...
Page 260 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 16. Using the Test Support Facility...
Page 261 ASMWatch Test-image data to be Values set as detailed information and the range of data in the ASMWatch window acquired with this REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Name of the unmatched symbol Content of the test-image file Data in the current High-performance Embedded Workshop system or in another...
Page 262 To add a bit-level watch point 1. Click on the Add Bit button on the Edit Test ASM Watch Points dialog box to open the BitAdd dialog box. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 16. Using the Test Support Facility Content of the test-image file...
Page 263 The check box is not selected by default. 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). REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 16. Using the Test Support Facility...
Page 264 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 REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 16. Using the Test Support Facility...
Page 265 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Unmatched line number Content of the test-image file...
Page 266 Simulated I/O list will be modified. Only one variable is selectable in the list. The Modify Simulated I/O dialog box opens. 2. Specify All or Line No to set the I/O simulation range to be saved into a test-image file. 3. Click OK. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 16. Using the Test Support Facility...
Page 267 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Coverage range Unmatched test option...
Page 268 1. Click on the Add button on the Edit Test Trace Ranges dialog box to open the Add Trace Range dialog box. 2. Specify Start PTR, and End PTR to set a trace range to be saved into a test-image file. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 16. Using the Test Support Facility...
Page 269 • 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 16. Using the Test Support Facility...
Page 270: Comparing A Test Image File
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 -> Compare Test Image File]. The Compare dialog box opens. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 16. Using the Test Support Facility...
Page 271: Running Tests
1. Select [Test -> Run Tests]. The Run Tests dialog box opens. 2. All tests currently defined in the High-performance Embedded Workshop test system are listed in the Test cases list. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 16. Using the Test Support Facility...
Page 272: Using The Test Browser
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 16. Using the Test Support Facility...
Page 273: Configuring The Test Pane Of The Workspace Window
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 REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Toolbar Button Function Exports the result.
Page 274: Configuring The Test Tab Of The Output Window
<Macro Name> file/macro (X of Y) X is the current test number and Y is the total number of tests. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Run Tests dialog box Action after test execution Compare system against drop-down list box saved test image file...
Page 275 Clear Window Save Copy Toolbar display Customize toolbar REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Function Clears the contents of the window. Saves the contents of the window into a text file. Copies the selected contents onto the Windows® clipboard. Shows or hides the toolbar.
Page 276: Using The Debugger
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 277 Demonstration Project for generating a demonstration program written in the C language. (Renesas SuperH Standard Tool chain or Hitachi H8S,H8/300 Standard Tool chain) C source startup Application Project for generating a startup program written in the C language.
Page 278 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> button in Step 1. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 279 17. Using the Debugger 2. Specify the options common to all project files in Step 2. The specifiable items depend on the CPU selected in Step To move to Step 3, click the Next> button in Step 2. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008...
Page 280 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Checking enables use of standard I/O libraries.
Page 281 [Project -> Edit Project Configuration] in the High- performance Embedded Workshop. To move to Step 6, click the Next> button in Step 5. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 282 CPU hardware manual. To move to Step 7, click the Next> button in Step 6. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Checking generates a vector definition file and a vector table setting function definition file.
Page 283 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> button in Step 7. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 284 Bus mode: Initial session: To move to Step 9, click the Next> button in Step 8. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 System call for standard I/O or file I/O from the user program is enabled (Enable) or disabled (Disable). Address for above system call.
Page 285 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 286 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 287: Editing Project Configuration
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 288 Select [Debug -> Debug Settings], OR • 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 289 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 REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 290 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 ) and select the placeholder from the pop-up menu. To ) and select the placeholder from...
Page 291 To disable memory access until after target connection command file execution 1. Select [Debug -> Debug Settings]. The Debug Settings dialog box opens. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 292 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 293: Downloading Modules
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 debugging platform. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 294 2. In the project tree, select the project and configurations to which you want to add a download module. 3. Click the Add button. The Download Module dialog box is displayed. All fields must be setup for the download module to be configured correctly. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 295 2. Change the setting and click the OK button. To remove download modules 1. Open the Debug Settings dialog box. 2. Select a module, which you wish to remove, in the Download modules list and click the Remove button. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 296 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 297 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 298 While a debug-only project (i.e., "Debugger only - xxxxxx") is in use, a tree of source files for a download module are automatically 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 299 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). REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Condition of the Support The High-performance Embedded Workshop has become V.4.02 or later due to an...
Page 300 3. Select the Show dialog to search on OK for directory browse dialog checkbox. This checkbox is selected by default. 4. Click OK. If you select the OK button after selecting a directory, and not selecting search, a confirmation box will be shown, as below. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 301 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 ( REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 302 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 303 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 304 3. 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 305: Debugger Sessions
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 306 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 307 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 308 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 309 To save a session with a different name using [File -> Save Sessions As] 1. Select [File -> Save Sessions As]. The Session Name dialog box opens. 2. Enter the new session name. 3. Click the OK button. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 310: Viewing A Program
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 311: Opening The Editor Window
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 312 The columns listed in the table below are on the left of the "Source" field. Column Name Line Source Address S/W Breakpoints REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Description Displays the line number for the source file. After your program has been downloaded, the editor window displays the addresses for the current source file.
Page 313 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 debugging platform is connected to the session. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Function Builds the selected files.
Page 314 Turn Header On/Off Save Disassembly Text Print Toggle Breakpoint Enable/Disable Breakpoint REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Description Display the PC location ( ), breakpoints ( ). Setting PC breakpoint by double-click. Display the disassembly address. Open the Set Address dialog box by double-click.
Page 315 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 dialog box will be displayed. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008...
Page 316 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008...
Page 317: Opening The Disassembly Window
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger ) when it is in focus or by...
Page 318 After your program has been downloaded, the source view displays the addresses for the current source file. S/W Breakpoints Display the PC location ( double-click. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 ), and breakpoints ( ). Setting PC breakpoint by 17. Using the Debugger...
Page 319 To use disassembly source-mode as primary debug view 1. Select [Setup -> Options]. The Options dialog box opens. 2. Select the Debug tab. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Opens an editor window containing the file for editing. Opens a file shown in the disassembly window.
Page 320 Disassembly Address Obj code Label • Double-clicking the "Disassembly" field opens the Assembler dialog box. Enter assembly-language codes. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Description Display the PC location ( ), breakpoints ( ). Setting PC breakpoint by double-click. Display the disassembly address. Open the Set Address dialog box by double-click.
Page 321 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 scrolling through a lot of code in the program, you can go directly to a specific address. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Opens a file shown in the disassembly window.
Page 322 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008...
Page 323: Looking At The Current Pc Position
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger ) when it is in focus or by...
Page 324: Operating Memory
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 325 Scroll Area Register *1 (xxxxx) Followed Stack Pointer *1 Set Start Up Symbol Refresh REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Toolbar Button Macro Recording Function 17. Using the Debugger Sets data at specified address. Fills specified memory block with data. Moves specified memory block to.
Page 326: Modifying Memory Contents
Modifying memory contents To change the contents of memory, follow the procedure below. • In-place edit in the Data column. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger Disables refresh of the Memory window. Regularly refreshes the Memory window.
Page 327: Selecting A Memory Range
If the memory address range is in the Memory view, you 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 328: Filling An Area Of Memory With Constant Data
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 329: Comparing The Memory Contents
When the contents of the two memory areas match at comparison, the message "Comparison successful." appears. Support for this function depends on the debugger. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Operation Copy the contents of a selected range of data to an area starting from the dropped position.
Page 330: Testing An Area Of Memory
Radix, and code in Code. 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 331: Finding A Value In Memory
2. To change the display address, open the Display Address dialog box by selecting one of the following operations: • Double-click the Address column you want to change, OR • Choose Address from the pop-up menu. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 332: Changing The Scroll Area
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger Operation Changes the window's display start address to that address.
Page 333: Changing The Program Display Position Immediately After Downloading
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008...
Page 334: Specifying The Refresh Interval
Select the data radix from the followings in the pop-up menu Radix of the memory window. Either the following can be specified. Displays in hexadecimal (default). Displays in decimal. Signed Dec Displays in signed decimal. Displays in octal. Displays in binary. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 335: Changing The Code
[Coverage -> 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 336: Saving An Area Of Memory
When the file save is complete a confirmation message box will be displayed. 17.3.26 Loading a memory area from a file A file can be loaded to the debugging platform’s memory. Choose Load from the pop-up menu of the memory window. The Load Program dialog box opens. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008...
Page 337: Splitting Up The Window Display
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” appears. Support for this function depends on the debugger. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008...
Page 338: Changing Text Colors
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger Foreground Background color (default)
Page 339: Opening The Image Window
Specifies the color information of the image to be displayed. Information Mode Bit/Pixel Sampling REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Specifies the format. MONOCHROME Black and white. R (red), G (green), and B (blue) B (blue), G (green), and R (red)
Page 340 Specifies whether display is on all or part of the screen (in hexadecimal notation; valid when “8Bit” has Information been selected for RGB or BGR). View Mode Start Position Position REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 An example is shown below. Sampling Ratio Original Data Sampling Data 4:4:4...
Page 341 Interval 1.0s 2.0s 4.0s REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 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).
Page 342: Regularly Refreshing The Image Window
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Starts redrawing continuously. Stops redrawing continuously.
Page 343: Viewing Images As Consecutive Frames
Clicking on Next Image goes to the next frame. If you wish to view three consecutive frames, for example, the operation will be as follows. 1. Click on the Next Image toolbar button to view the second frame. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Function Redraws the next image.
Page 344 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Toolbar Button Function The image is redrawn continuously every 0.5 seconds.
Page 345: Displaying The Pixel Information
3. When the specified time has elapsed, the third frame is automatically displayed. The automatic switching of frames has ended. 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 346: Displaying Memory Contents As Waveforms
Displays the memory contents as waveforms. The X-coordinate shows the number of sampling data and the Y- coordinate shows the sampling value. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Displays the X-coordinate of the cursor location. Displays the Y-coordinate of the cursor location.
Page 347: Regularly Refreshing The Waveform Window
Selecting [Auto Refresh -> Real time] from the pop-up menu will allow the window contents to be refreshed while the user program is running. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Macro Recording Function Disables refresh of the Waveform window.
Page 348: Refreshing The Waveform Window
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 349: Setting The Horizontal Scale
ASCII values, so the High-performance Embedded Workshop also provides an IO window to ease the inspection and setting up of these registers. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 350: Opening The Io Window
Refresh Lock Refresh Load IO File Selected IO Register Print Save To File REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Description Shows all I/O registers. Shows selected I/O registers. This page is blank by default. Macro Recording Function Refreshes the IO window.
Page 351: Expanding An I/O Register Display
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 value in New value. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Finds an I/O register. Finds the next I/O register to match.
Page 352: Refreshing The Io Window
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 353: Loading An I/O File
If the register names in the loaded I/O file and those shown on the Select I/O Register tabbed pane of the IO window do not match, an icon appears on the items as shown below. See Reference 6, I/O File Format, for more information about an I/O file format. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 354: Printing The Currently Displayed Contents
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 355: Looking At Registers
Refresh Lock Refresh Split Save To File Note: *. Support for this function depends on the debugger. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Function Displays in hexadecimal. Displays in decimal. Displays in octal. Displays in binary. Displays registers of bank 0.
Page 356: Changing The Register Display Radix
To reference the register data of Bank0, select Bank0 from the pop-up menu with the Register window active. (Through the operation of option Bank0 and Bank1, the value of flag does not change.) Support for this function depends on the debugger. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 357: Setting The Layout
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 358: Modifying Register Contents
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). REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 359: Setting The Flag Value
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 360: Using Register Contents
It will close down any open child windows and shut down the link to the debugging platform. If this is successful, an attempt to re-establish the link to the debugging platform will be made. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 361: Connecting/Disconnecting The Debugging Platform
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 ), OR ), OR ), OR ) or choose [Debug ->...
Page 362: Running Program, Ignoring Any Breakpoints
17.12.5 Running from a specified address The Run Program dialog box allows the user to run the program from any address. Choose [Debug -> Run] to open the Run Program dialog box. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 ), OR 17. Using the Debugger...
Page 363: Continuing Execution To A Main Function At A Reset
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 • Click the Step In toolbar button ( • Select [Debug -> Step In]. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 ), OR ), OR 17. Using the Debugger...
Page 364: 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 -> Step]. The Step Program dialog box opens. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 ), OR ), OR...
Page 365: Stopping Your Program
You will see a red circle ( ) appear in the gutter to indicate that a PC breakpoint has been set. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 ) and by setting breakpoints at specific locations in your code.
Page 366: Viewing The Current Status
To check the configuration and status of the debugging platform in the Status window, choose [View -> CPU -> Status], or click the View Status button ( The Status window has three tabs. Window configuration REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 367: Viewing The Function Call History
Pop-up Menu Option Macro Recording Go to Source View Setting Copy REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Function Go to the associated source line. Specifying the Stack Trace window settings. Places a copy of the highlighted text into the Windows® clipboard.
Page 368: Viewing The Source Program
Hitachi Debugger Interface (version 4.x or greater) Renesas PD debugger Other external debugger Non selected REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Configuring the Hitachi Debugging Interface to integrate with High-performance Embedded Workshop Configuring the PD debugger to integrate with High- performance Embedded Workshop...
Page 369: Configuring The Hitachi Debugging Interface 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 ) to invoke the debugger with the specified session file.
Page 370: Configuring An External 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 371: Debugging Functions Dependent On The Debugger
You can quickly toggle a software break at the entry point of a function by double clicking in the BP (breakpoint) column. Alternatively, right-click to show the pop-up menu and select Break. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 372 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.17.2.3, Supporting duplicate labels. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Macro Recording Function Adds a label.
Page 373 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008...
Page 374: Elf/Dwarf2 Support
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.17.2 Elf/Dwarf2 support The High-performance Embedded Workshop supports the Elf/Dwarf2 object file format for debugging applications written in C/C++ and assembly language for Renesas microcomputers. Key Features: • Source level debugging •...
Page 375 (except for setting breakpoints, as multiple functions can be selected). This dialog box has three areas: REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Specifies direct reference of a member (C/C++) Specifies indirect reference of a member (C/C++)
Page 376 Open the Overlay dialog box by choosing [Debug -> Overlay]. This dialog box has two areas: the Address list box and the Section Name list box. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Displays the names of the functions Displays the addresses of the functions...
Page 377 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008...
Page 378: Looking At Variables
This section describes how you can look at variables in the source program. If you are debugging ELF/DWARF2 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.
Page 379 Opening the Watch window To open a Watch window, choose [View -> Symbol -> Watch] or click on the Watch toolbar button ( visible. A Watch window opens. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger ) if it is...
Page 380 *. 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 381 Drag a watch item from the Editor or Disassembly window and drop it into the Watch window. • Use Instant Watch in the Editor or Disassembly (in source mode) window. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Macro Recording Description Marks the selected variable with a bold R and updates the variable in real-time.
Page 382 Double-click within the Name column. • Right-click on the line of a watch item and select Edit Name from the pop-up menu. Enter the new name in the Value or expression field and click OK. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 383 The watch item can be expanded for the number of levels when a numerical key from 1 to 9 is pressed while a watch item is selected. 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 384 Auto Global File scope name: Load module name REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 This scope covers all variables that can be watched from the address indicated by the program counter. (default) This scope covers global variables in all load modules. Global variables declared as static cannot be watched.
Page 385 Double-click within the Scope column. Right-click on the line of a watch item and select Set Scope from the pop-up menu. 1. Select scope for the variable shown in the Expression field. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 386 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 387 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 388 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 REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger...
Page 389 Double-clicking the Value column opens a dialog box, which allows you to change the value of a local variable. (Macro Recording) • The value of a local variable can be changed by using in-place editing. (Macro Recording) REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 17. Using the Debugger Foreground color (default) Background color (default) Black...
Page 390 The Locals window is updated to show the new value. Modifying the radix The radix for the selected variable display can be modified by choosing Radix from the pop-up menu. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Launches a dialog box to modify the selected variable's value. Displays in hexadecimal.
Page 391: Synchronized Debugging
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 18. Synchronized Debugging...
Page 392: Managing Configurations
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 18. Synchronized Debugging...
Page 393: Defining The Synchronized Debuggers
Will be one of the following: Not open: Not connected: REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 The Debugger is not currently open in a High-performance Embedded Workshop application. It will be opened when the “Sync” button is clicked. The Debugger is currently not connected to a platform.
Page 394 1. Select the Debugger to be changed in the list. 2. Click the Modify button. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 The Debugger is connected to a platform and it is not running. The Debugger is connected to a platform and it is running.
Page 395 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 18. Synchronized Debugging...
Page 396: Setting The Synchronization Options
Connection, Download and Initialize. For non multi-core platforms they will always be off. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 No synchronizations. Two way synchronizations between each Debugger and every other Debugger for the checked operations.
Page 397: Setting The Memory Update Option
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 REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 18. Synchronized Debugging...
Page 398: Update Synchronized Debugging
The Debugger is not connected to a platform. The Debugger is connected to a platform which is currently stopped (i.e. not running). The Debugger is connected to a platform which is currently running. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 18. Synchronized Debugging...
Page 399 Breakpoint is reached. Halt Break/Halt “Debug->Halt” Program menu. Halt toolbar button. “halt” command. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 18. Synchronized Debugging Effect Resets all synchronized platforms. Runs all synchronized platforms. Runs initial platform with a specific set of temporary breakpoints.
Page 400 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 REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 18. Synchronized Debugging Performs step in on all synchronized platforms.
Page 401: Parallel Mode Functionality
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 18. Synchronized Debugging...
Page 402: Internal Mode Functionality
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 18. Synchronized Debugging...
Page 403: Using The Command Line Window When Synchronized
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” REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 18. Synchronized Debugging...
Page 404: Glossary Of Terms
SDO file 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 18. Synchronized Debugging...
Page 405: Technical Support
2. Clicking the More>> 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). 3. Click on the OK button to close the dialog box.
Page 406: Creating A Bug Report
8. Then click Submit. This will send the report. When submitting a report via e-mail you will see a confirmation message after clicking Submit. Note: Fields marked with an asterisk (*) are required. You can click the Submit button after these fields are completed. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 19. Technical Support...
Page 407: Reference
High-performance Embedded Workshop Reference Reference REJ10J1837-0100 Rev.1.00 Nov. 16, 2008...
Page 408: Main Menus
Copy CTRL+C Paste CTRL+V Clear Delete Select All CTRL+A REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Toolbar Button Macro Recording * Function Toolbar Button Macro Recording * Function 1. Main Menus Creates a new document. Opens an existing document. Closes the active document.
Page 409: View Menu Options
Status CTRL+U Graphic Image *3 CTRL+SHIFT+G Waveform *3 CTRL+SHIFT+V Code Stack Trace CTRL+K REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Toolbar Macro Saving into Test- Button Recording *1 Image File *2 1. Main Menus Finds text in the current file. Finds text in multiple files.
Page 410: Project Menu Options
Clean All Projects Update All Dependencies Stop Tool Execution CTRL+Break Include/Exclude REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Shortcut Key Toolbar Button Macro Recording *1 Function 1. Main Menus Sets this project as the current project. Inserts a project to the workspace.
Page 411: Debug Menu Options
Assembly - Source Halt Program Initialize Connect *2 Disconnect *2 Save Memory REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 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.
Page 412: Setup Menu Options
Opens the Macro dialog box. Starts recording of a macro. Plays a macro. Stops a macro. Invokes system tools (e.g. Renesas Call Walker). 1. Main Menus Verifies file contents against memory contents. Downloads the object program. Unloads the object program.
Page 413: Test Menu Options
About High-performance Embedded Workshop Debugger Help REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Creates a new blank test suite so you can begin adding and running tests. Opens an existing test suite. Edits the current test suite. Allows you to add and remove tests to the test suite.
Page 414: Windows
Stack Trace Test Browser Notes: *1. Support for this function depends on the debugger. *2. See the "Tcl/Tk Additional document". REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Opened by [View -> Difference] [View -> Map] [View -> Map] [View -> Command Line] [View ->...
Page 415: Commands
REFRESH_SESSION REMOVE_FILE RESET RUN_TEST SAVE_SESSION SAVE_WORKSPACE SET_DISASSEMBLY_SOFT_BREAK REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Abbreviation Description Comment. Adds a file to the current project. Checks if an expression is true or false. Switches the auto-completion. Performs a build on the current project.
Page 416: Command List (Listed By Function)
BUILD_MULTIPLE CLEAN GENERATE_MAKE_FILE UPDATE_ALL_DEPENDENCIES REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 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.
Page 417 MEMORY_FILL MEMORY_FIND * MEMORY_MOVE MEMORY_TEST * Note: *. Support for this command depends on the debugger. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Abbreviation Description Comment. Checks if an expression is true or false. Switches the auto-completion. Clears the Command Line window.
Page 418 INITIALIZE Note: *. Support for this command depends on the debugger. For the syntax of each command, refer to the online help. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Abbreviation Description Sets or deletes a software breakpoint at the disassembly level. Sets or deletes a software breakpoint at the source level.
Page 419: Regular Expressions
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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 4. Regular Expressions...
Page 420: Placeholders
2. If you select "Custom directory", specify an absolute directory path in the Sub-Directory field. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 , which can accept the file to be edited as a parameter. When c:\myedit\myeditor.exe...
Page 421: Available Placeholders
Project name $(CONFIGDIR) Configuration directory $(CONFIGNAME) Configuration name $(HEWDIR) High-performance Embedded Workshop installation directory c:\Program Files\Renesas\Hew $(TCINSTALL) Toolchain install directory (on the options setting dialogs and the New Build Phase dialog (step 3)) $(TOOLDIR) Tool installation directory (Tools Administration) $(TEMPDIR)
Page 422: Placeholder Tips
*.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.
Page 423: I/O File Format
Bitfield sections define the bits within a register each entry is of the type bit<no>=<name>. 1. <no> is the bit number. 2. <name> is a symbolic name of the bit. Comment lines are allowed and must start with a “;” character. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 6. I/O File Format...
Page 424 High-performance Embedded Workshop 6. I/O File Format REJ10J1837-0100 Rev.1.00 Nov. 16, 2008...
Page 425: Symbol File Format
4. 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 Note: Support for this function depends on the debugger. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 7. Symbol File Format...
Page 426: Keyboard Shortcuts
CTRL+ALT PAGE DOWN CTRL+SHIFT 8 CTRL+SHIFT G CTRL+SHIFT K CTRL+SHIFT L CTRL+SHIFT M REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 Function Play a macro assigned to keyboard shortcut. Toggle status bar. Open the workspace window. Open the output window. Exit the application.
Page 427 ALT + Mouse select Note: Support for this function depends on the debugger. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 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.
Page 428: Drag And Drop In The Debugger
2. It is 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 9. Drag and Drop in the Debugger...
Page 429: Using Labels To View Your Code
) 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008...
Page 430 “conv6” as the filter the list box would be set to only contain “__conv64i” and “__conv64u”. This is a useful feature for when you have a large number of labels in your project. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008...
Page 431: Integrated Toolbars In A Components View
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: The top menu option named "Toolbar" switches showing/hiding of the toolbar (the toolbar is hidden in the figure below). REJ10J1837-0100 Rev.1.00 Nov. 16, 2008...
Page 432 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 11. Integrated Toolbars in a Components View...
Page 433: To Build In Toolchain For 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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008...
Page 434: Hmake User Guide
The value may be split over several lines using a ‘\’ character. If the value contains ‘\’ characters within the main text then these are taken literally. Only ‘\’ characters followed by a new line are considered to indicate a value wrapping over more than one line. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 13. HMAKE User Guide...
Page 435: Description Blocks
There follows some examples of valid description blocks (one of which uses the variable specified above under variable declarations): c:\dir1\file1.obj : c:\dir1\file1.c c:\dir1\file1.h → gcc c:\dir1\file1.c $(OUTPUT) : $(INPUT) $(DEPEND) → $(EXECUTABLE) $(INPUT) REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 13. HMAKE User Guide...
Page 436 -c -o c:\dir1\file1.obj c:\dir1\file1.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. REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 temporary directory, which will contain the lines <sub ®...
Page 437: Comments
A new line character is assumed to come after the last character in <text to output>. Any white space between !MESSAGE and <text to output> will be ignored. There follows an example of a valid message command: !MESSAGE Executing C Compiler REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 13. HMAKE User Guide...
Page 438 User's Manual Publication Date: Nov. 16, 2008 Sales Strategic Planning Div. Published by: Renesas Technology Corp. Microcomputer Tool Development Department Edited by: Renesas Solutions Corp. © 2008. Renesas Technology Corp. and Renesas Solutions Corp., All rights reserved. Printed in Japan. Rev.1.00...
Page 439 High-performance Embedded Workshop V.4.05 User’s Manual 1753, Shimonumabe, Nakahara-ku, Kawasaki-shi, Kanagawa 211-8668 Japan REJ10J1837-0100...

This manual is also suitable for:

High-performance embedded workshop v.4.05

Renesas REJ10J1837-0100 User Manual

Quick Links

Related Manuals for Renesas REJ10J1837-0100

Summary of Contents for Renesas REJ10J1837-0100