REJ10J1837-0100 High-performance Embedded Workshop V.4.05 User's Manual Renesas Microcomputer Development Environment System Rev.1.00 Nov.
Notes regarding these materials 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. 13. This document is provided for reference purposes only so that Renesas customers may select the appropriate Renesas products for their use.
High-performance Embedded Workshop Introduction Introduction The High-performance Embedded Workshop is a powerful development environment for embedded applications targeted at Renesas micro-controllers. The main features are: • • • • • A configurable build engine that allows you to set-up compiler, assembler and linker options by using GUI. An integrated text editor with user customizable syntax coloring to improve code readability. A configurable environment, which allows you to run your own tools.
High-performance Embedded Workshop Introduction Figures Some figures in this user’s manual may differ from the objects they represent. Operating Environment for the High-performance Embedded Workshop This user’s manual, online help, and release notes do not indicate that the correct operation of the High-performance Embedded Workshop is guaranteed for any types of host computers or peripheral devices.
High-performance Embedded Workshop Contents Contents 1. Overview...................................................................................................................................... 1 1.1 1.2 Workspaces, projects and files...................................................................................................................................1 Main window ...........................................................................................................................
High-performance Embedded Workshop Contents 2.7.2 Adding a new build configuration.................................................................................................................50 2.7.3 Removing a build configuration....................................................................................................................50 2.8 Building a project ......................................................................................................................................
High-performance Embedded Workshop Contents 4.6 4.7 Printing a file ...........................................................................................................................................................96 Configuring text layout............................................................................................................................................96 4.7.1 Page set-up ...................................................................................................
High-performance Embedded Workshop Contents 6.10 6.11 Customizing the font in your views .......................................................................................................................132 Using the virtual desktop .......................................................................................................................................133 7. Version Control................................................................................................................
High-performance Embedded Workshop Contents 12.4 12.5 Drag and drop navigation items .............................................................................................................................186 Smart edit capability ..............................................................................................................................................187 13. Map .....................................................................................................................
High-performance Embedded Workshop Contents 15.5.2 Recordable functions (dependent on the debugger) ....................................................................................221 15.6 Playing a macro .....................................................................................................................................................229 15.7 Editing a macro................................................................................................................................
High-performance Embedded Workshop Contents 17.3.19 Changing the data length.............................................................................................................................319 17.3.20 Changing the radix ......................................................................................................................................319 17.3.21 Changing the code...................................................................................................................
High-performance Embedded Workshop Contents 17.7.10 Refreshing the Register window .................................................................................................................344 17.7.11 Disabling refresh of the Register window...................................................................................................344 17.7.12 Using register contents................................................................................................................................
High-performance Embedded Workshop 19.2 19.3 Contents Check for updates ..................................................................................................................................................390 Creating a bug report .............................................................................................................................................391 Reference .............................................................................................................
High-performance Embedded Workshop 1. Overview 1. Overview The functions for High-performance Embedded Workshop version 4.05.00 are explained in this manual. This chapter describes the fundamental concepts of the High-performance Embedded Workshop. 1.1 Workspaces, projects and files Just as a word processor allows you to create and modify documents, the High-performance Embedded Workshop allows you to create and modify workspaces.
High-performance Embedded Workshop 1.2.1 1. Overview Title bar The title bar displays the name of current activate project and file. It also contains the standard Minimize, Maximize and Close buttons. Click the Minimize button to minimize the High-performance Embedded Workshop on the Windows® task bar. Click the Maximize button to force High-performance Embedded Workshop to fill the screen.
High-performance Embedded Workshop 1.2.3 1. Overview Toolbars The toolbars provide a shortcut to the options that you will use the most often. There are twelve default toolbars: Editor, Search, Templates, Bookmarks, Default Window, Standard, Version Control, Map, Macros, Debug, Debug Run, and System Tools (as shown in the figures below). With the default session, the High-performance Embedded Workshop does not initially display buttons of Version Control and peripheral functions on the toolbar.
High-performance Embedded Workshop 1. Overview Standard toolbar Version Control toolbar This toolbar is only available when a version control tool is being used in the current project. Map toolbar Macros toolbar You can add a customized button, to which a created macro has been assigned, on the right to the standard macro buttons on the toolbar as shown below. Debug toolbar This toolbar is only available when a session is being used which has a target attached.
High-performance Embedded Workshop 1. Overview System Tools toolbar You can add an external tool button, to which an external tool menu has been assigned, on the right to the system tool button on the toolbar as shown below. When the Standard toolbar is docked, it has a Control bar as shown in the figure below. If you want to move the docked Standard toolbar, click and drag its Control bar to the new location. The figure below shows the Standard toolbar when it is docked and also when it is floating.
High-performance Embedded Workshop • 1. Overview Projects tab Allows you to show the current workspace, projects and files. You can quickly open any project file or dependent file by double-clicking on its icon. See section 2.2, Configuring the Projects tab of the Workspace window, for more information on the Projects tab. If you hover the mouse pointer over a file in the Projects tab then the file’s full path will be displayed in a tool tip. • Templates tab Allows you to display template settings.
High-performance Embedded Workshop 1. Overview When the Allow Docking option is checked, you can dock a window, toolbar or menu bar to the edge of the Highperformance Embedded Workshop main window or to the edge of another docked window. You can also float them ‘above’ the other High-performance Embedded Workshop windows or outside the High-performance Embedded Workshop main window. Figure (i) below shows a docked “Workspace” window, and figure (ii) below shows a floating “Workspace” window.
High-performance Embedded Workshop 1. Overview To hide the Workspace window or the Output window Select one of the following operations: • Click on the close button, which is located in the top right corner of the window, OR • Right-click anywhere inside a floating window and select the Hide option on the pop-up menu. To show the Workspace window or the Output window Select [View -> Workspace] or [View -> Output] respectively. 1.2.
High-performance Embedded Workshop 1.2.6 1. Overview Output window The Output window, by default, has seven tabs (Build, Debug, Find in Files 1, Find in Files 2, Macro, Test, and Version Control) on display. Build tab The Build tab shows the output from any build process (e.g. compiler, assembler and so on). If an error is encountered in a source file, an icon and the error message will be displayed in the Build tab, along with the source file name and line number.
High-performance Embedded Workshop 1. Overview Debug tab Shows the output from any debugger process. Any debug component that needs to display information will send its output to this window. Right-clicking displays a pop-up menu containing available options. A basic operation is allocated to the toolbar. The functions of Toolbar display and Customize toolbar are also included in the pop-up menu displayed by rightclicking the toolbar area.
High-performance Embedded Workshop 1. Overview Test tab Shows the results and progress of the current test execution (test support facility). The test execution progress shows the current test being executed and the number of tests remaining. If errors occur then these are displayed in this window. For details on the test-support facility, see Chapter 16, Using the Test Support Facility. Right-clicking displays a pop-up menu containing available options. A basic operation is allocated to the toolbar.
High-performance Embedded Workshop 1.2.7 1. Overview Status bar The status bar displays various information about the current state of the High-performance Embedded Workshop. The figure below shows the status bar. The customizable status bar feature allows the user to customize the display of the status bar area and its contents. The status bar will also now show target-related information where required by the specific target being used.
High-performance Embedded Workshop 1.4 1. Overview Launching the High-performance Embedded Workshop To initiate the High-performance Embedded Workshop, open the Start menu of Windows®, select Programs, select Renesas, select High-performance Embedded Workshop, and then select the shortcut of the High-performance Embedded Workshop. The Welcome! dialog box will be displayed after the start-up screen. If you have recently used a workspace, Open a recent project workspace is selected by default.
High-performance Embedded Workshop 1. Overview project name to be different. To select the directory in which you would like to create the workspace, use the Browse button or type the directory into the Directory field manually. 3. Select the CPU family and Tool chain upon which you would like to base the workspace. 4.
High-performance Embedded Workshop 1.7 1. Overview Using old workspaces The High-performance Embedded Workshop can open any workspace that was created on a previous version of the High-performance Embedded Workshop. This should be automatically upgraded when the workspace is opened. A back-up version of the initial workspace or project file must be saved in the current directory of the file that has been upgraded. 1.
High-performance Embedded Workshop 1. Overview A copy of the workspace will be saved into the current directory (so all the source files, etc. will remain in use) but with the entered prefix, e.g.: C:\Workspace\Workspace_Name\402_Workspace_Name.hws C:\Workspace\Workspace_Name\Projet_Name\402_Projet_Name.hwp C:\Workspace\Workspace_Name\Projet_Name\402_DefaultSession.hsf C:\Workspace\Workspace_Name\Projet_Name\402_SimSessionSH-1.hsf Note that the current workspace (in this example 4.05.
High-performance Embedded Workshop 1. Overview Note: *. Support for this function depends on the debugger. These files are specific to each user account on the host computer. When multiple versions of the High-performance Embedded Workshop are installed, the files specific to each High-performance Embedded Workshop are saved for each user account. 1.13 Overview of Configurations and Sessions The drop-down list box on the Standard toolbar shows the current configuration and session.
High-performance Embedded Workshop 1. Overview If you have selected a target debugging platform at creation of the project, the High-performance Embedded Workshop creates a configuration suitable for the debugging platform. If you have selected "SH-4 Simulator" in Targets at creation of the project, configuration "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 *.
High-performance Embedded Workshop 1. Overview Note: *. The project directory having the project name is created under the workspace directory used for creation of a new workspace. How to set up build options To set up build options kept with a configuration, select the configuration from the drop-down list box in the dialog box for set up build option opened from the Build menu. Options such as the compiler, assembler, and optimizing linkage editor can be set up.
High-performance Embedded Workshop 1. Overview In the figure of the Standard toolbar shown as an example, sessions "SimSessionSH-4" and "DefaultSession" are available. Information on each session is saved in an individual file in the High-performance Embedded Workshop project. Note: *.
High-performance Embedded Workshop 1.14 1. Overview Overview of Macro-Recording Support facility and Test Support facility When coding is finished, the program must be tested. If a problem is found in testing, you will need to correct the problem and re-test the program. Testing takes a significant number of steps in development of programs. To ease the process of testing, the High-performance Embedded Workshop provides the macro-recording support and test support facilities.
High-performance Embedded Workshop 1. Overview The procedure from selection of Record Macro ( ) to that of Stop Macro ( ) consists one macro and one Highperformance Embedded Workshop macro file can record multiple macros (a set of High-performance Embedded Workshop command-line commands). A macro includes multiple High-performance Embedded Workshop commandline commands. The figure below shows the High-performance Embedded Workshop macro file and macros.
High-performance Embedded Workshop 1. Overview The test support facility is available in the Test menu and in the pop-up menu of the Test tab of the workspace window. The first step towards using the test support facility is to create a test suite (a set of tests). This is available on the Test menu. Once a test suite is created, following operations can also be done in the Test tab of the workspace window.
High-performance Embedded Workshop 1.14.1 1. Overview Example of test procedures This page introduces an example of test procedures, which is a sequence through build and debugging using the macrorecording support facility and test support facility.
High-performance Embedded Workshop Classification Preparation before the running the program - Initialize values - Prepare a program Download the program Add variables, run the program, and check the result 1. Overview Operation Reload the session. (See "Step 1 (2)".) Initialize register values *. (See "Step 1 (3)".) Build the program for demonstration *. (See "Step 1 (4)".) Download the program for demonstration. (See "Step 1 (5)".
High-performance Embedded Workshop 1. Overview 4. Click the Build button ( ) on the Standard toolbar to build the program for demonstration. This records the build command. 5. Double-click to download the program for demonstration within the Download modules folder in the Projects tab of the workspace window. This records the file_load command. 6. Click the Memory button ( ) on the CPU toolbar to invoke the Display Address dialog box. Enter the address of the data field in Display Address.
High-performance Embedded Workshop 1.14.3 1. Overview Step 2: Editing a macro (viewing records) 1. Select [Tools -> Macros] to invoke the Macro dialog box. The High-performance Embedded Workshop macro file “Default”, in which a macro has been recorded, is listed in Current macro file. 2. Select the macro “Demo” in Macro functions and click the Edit button. The editor window shows the Highperformance Embedded Workshop macro file “Default.hdc”, in which a macro has been recorded.
High-performance Embedded Workshop 1.14.4 1. Overview Step 3: Playing a macro 1. Click the Play Macro button ( ) on the Macros toolbar. The Select Macro Function dialog box opens. 2. Selecting the macro “Demo” starts playing the recorded commands. The mouse pointer is modified to include the play icon ( 3. 1.14.5 ). When the playback of a macro is completed, the mouse cursor returns to be an arrow. Step 4: Creating a test suite 1.
High-performance Embedded Workshop 1. Overview 5. Enter “Demonstration” in Test description. 6. Click the Add button. The Add Test Script dialog box opens. 7. Select the “Demo” checkbox in Select macros to add to test. 8. Click the OK button. 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.
High-performance Embedded Workshop 1. Overview 11. Click the OK button. The “Test_Demo” test icon appears under the “Test_Suite_Demo” test-suite icon. 1.14.7 Step 6: Creating a test image file To compare the Memory content at the address of an array or the contents of the Watch window, the range of data acquisition must be selected. The test image of a test item is saved to the test image file "Test_Suite_Demo_Test_Demo.hif" specified at step 5. 1.
High-performance Embedded Workshop 1. Overview 4. The Memory content at the address of an array is saved into the test-image file. Double-click Memory-xxxxxx under CPU in Available components. The Edit Test Memory Ranges dialog box opens. 5. Click the Add button to display the Add Memory Range dialog box. 6. Enter the start address of an array in Start address and end address in End address and select the size in Access size. 7. Click the OK button. 8.
High-performance Embedded Workshop 1. Overview 12. Click the OK button in the Edit Test Image File dialog box. In the state of current High-performance Embedded Workshop system, the test image specified in test item is acquired, and the test image is saved to the test image file created at step 5. 1.14.8 Step 7: Modifying the program before the test In this example, the target of the test is a selected range of memory data in arrays.
High-performance Embedded Workshop 1. Overview 1. Open a source file including a main function in the editor window and modify the program to reduce the number of times to store data into the array. 2. Click the Save File button ( 3. Right-click on the “Test_Demo” test icon to display a pop-up menu. 4. Select Run Test Case to start the test. The progress and result of the test are shown in the Test tab of the Output window. 5. When the test is completed, the Test Browser window opens. 1.14.
High-performance Embedded Workshop 1. Overview 3. Clicking the Export button saves the test result into a text file. 4. Click the OK button. 1.14.10 Step 9: Modifying the program back and executing the test again Modify the program to restore the number of times to store data in the array and then execute the test. 1. Return the number from 8 to 10 and build the program. 2. Click the Save File button ( 3. Right-click on the “Test_Demo” test icon to display a pop-up menu. 4.
High-performance Embedded Workshop 2. Build Basics 2. Build Basics This chapter explains the general basic functions of the High-performance Embedded Workshop whilst the more advanced features can be found in chapter 3, Advanced Build Features. 2.1 The build process The typical build process is outlined in the figure below.
High-performance Embedded Workshop 2.2 2. Build Basics Configuring the Projects tab of the Workspace window The Projects tab shows the current workspace, projects and files. You can quickly open any project file or dependent file by double-clicking on its icon. Right-clicking on a workspace opens a pop-up menu containing the available options.
High-performance Embedded Workshop Expand/Collapse Version Control Configure View Properties - 2. Build Basics Expands or collapses the tree below a project icon. Executes a version control system. Configures the workspace view. Displays project properties. Right-clicking on a folder (other than Download module and Dependencies) opens a pop-up menu containing the available options. Pop-up Menu Option Add Folder Rename Folder Remove Folder Configure View Macro Recording - Function Add a custom folder.
High-performance Embedded Workshop Debug Settings - Configure View Relocate Module * - Properties - 2. Build Basics Opens the Debug Settings dialog box, which allows you to modify the debug settings. Configures the workspace view. Opens a dialog box which allows you to select one directory for relocating all files retrieved from the download module. Shows the selected download module setting in the Download Module dialog box. This download module setting can be modified.
High-performance Embedded Workshop 2.3.1 2. Build Basics Adding files to a project Before building an application, select files to configure the application. To add files to a project 1. Files can be added to the active project only.
High-performance Embedded Workshop 2. Build Basics Note: If you add a file that has an unrecognized file type to the project, then the file will be added to the project, but certain functions will be disabled for this file. When you double-click on a file with an unrecognized file type in the Workspace window, the open operation is passed to the Windows® operating system (instead of opening the file in the editor).
High-performance Embedded Workshop 2. Build Basics 1. In the dialog box, the files are initially sorted by the file type in alphabetical order. If you click a column header (of file names or types), the files will be sorted by the file name or type. 2. You can select multiple files by clicking. If you then click on one of the checkboxes for the selected files or press the Space key, checkboxes for all of the selected files will be switched ON or OFF (depending on the previous state). 3.
High-performance Embedded Workshop 2. Build Basics To remove selected files from a project using the Projects tab of the Workspace window 1. Select the files that you want to remove in the Projects tab of the Workspace window. Multiple files can be selected by holding down the SHIFT or CTRL key. 2. Press Delete. 3. A confirmation dialog box opens for you to select whether or not to delete the selected files from the project. To delete the selected files, select Yes. Otherwise select No.
High-performance Embedded Workshop • 2. 2.3.5 2. Build Basics Select several files as a range Click a file as the start of the range. Then keep pressing the SHIFT key and click another file as the end of the selected range. Take either of the two ways listed below. A red cross ( excluded from build. ) will appear on the file’s icon, and the file will be • Select Exclude Build , where is the name of the selected file, from the pop-up menu opened by right-clicking.
High-performance Embedded Workshop 4. Click OK. 5. You can now drag and drop files into this folder to group them logically. 2. Build Basics To drag and drop a folder Drag a folder in the active project from the Projects tab of the Workspace window. • If the folder is dropped onto the active project, the folder is directly added into the project. • If the folder is dropped onto a user folder in the active project, the folder is added into the user folder.
High-performance Embedded Workshop 2. Build Basics The File Extensions list is divided into two columns. On the left are the file extensions, and on the right are the file groups associated with the extensions. Many file extensions can belong to the same group. For example, assembler source files may have several extensions in a single project (e.g. .src, .asm, .mar etc.). 2.5.
High-performance Embedded Workshop 2. Build Basics To associate an application with a file group 1. Select [Project -> File Extensions]. The File Extensions dialog box opens. 2. Select the file group that you want to associate from the file extensions list. 3. Click the Open with button. The Modify File Extension dialog box opens. 4.
High-performance Embedded Workshop 2. Build Basics Enter the name of the tool into the Name field. Enter the full path to the tool in the Command field (do not include any parameters). Enter the parameters that are required to open a file into the Parameters field. Be sure to use the $(FULLFILE) placeholder to specify the location of the file (see Reference 5, Placeholders, for more information on placeholders).
High-performance Embedded Workshop 2. Build Basics If Editor is selected, the Open File function in the workspace window causes the file to be opened in the Highperformance Embedded Workshop editor. If None is selected then the Open File operation is disabled when it is attempted. Selecting Other allows you to configure another tool for the Open File operation. See section 2.5.1, Associating an application with a file group, for more details.
High-performance Embedded Workshop 2.6 2. Build Basics Setting build options Once you have added the necessary files to the project, the next step is to instruct the High-performance Embedded Workshop on how to build each file. To do this, you will need to select a menu option from the Build menu. The contents of this menu depend upon which tools you are using. To set options for a build phase 1. Select the Build menu and select the phase whose options you would like to modify. 2.
High-performance Embedded Workshop 2.7.1 2. Build Basics Selecting a build configuration To select the current configuration 1. Select [Build -> Build Configurations]. The Build Configurations dialog box opens. 2. Select the build configuration that you want to use from the Current Configuration drop-down list. 3. Click the OK button. You can also select a different build configuration by selecting it from the Current Configuration drop-down list on the Standard toolbar. 2.7.
High-performance Embedded Workshop 2.8 Building a project 2.8.1 Building individual files 2. Build Basics The High-performance Embedded Workshop lets you build project files individually. To build an individual file 1. Select the file to build from the Projects tab of the Workspace window. 2. Select one of the following operations: • Click the Build File toolbar button ( • Select Build from the pop-up menu, OR • Select the [Build -> Build File] menu option, OR • Press CTRL+F7.
High-performance Embedded Workshop 2.8.3 2. Build Basics Building multiple projects The High-performance Embedded Workshop allows you to build multiple projects and configurations at once. To build multiple projects 1. Select [Build -> Build Multiple]. The Build Multiple dialog box opens. 2. The Build Multiple dialog box gives you the choice of which projects and configurations to build. Select the check boxes next to the projects and configurations that you want to build.
High-performance Embedded Workshop 2. Build Basics Note: Do NOT assume that any output from the tool you terminated is valid. It is recommended that you delete any output files produced and ensure that the phase is executed again. 2.8.5 Deleting intermediate and output files produced in building You can delete intermediate and output files (produced in building) included in the current configuration in the project.
High-performance Embedded Workshop 2. Build Basics If you do not wish to open this confirmation dialog box, select the Don’t ask this question again checkbox. To open the confirmation dialog box again 1. Select [Setup -> Options]. The Options dialog box opens. 2. Select the Confirmation tab. 3. Select the Clean workspace checkbox. This checkbox is selected by default. 4. Click OK.
High-performance Embedded Workshop 2. Build Basics Right-clicking displays a pop-up menu containing available options. A basic operation is allocated to the toolbar. The functions of Toolbar display and Customize toolbar are also included in the pop-up menu displayed by rightclicking the toolbar area. Pop-up Menu Option - Toolbar Button Function Highlights the next occurrence of error and shows the source code in the editor.
High-performance Embedded Workshop 3. 2. Build Basics Select the category for which you wish to change the color from the table below. Category Text Build Error Text Build Warning Text Information Text Foreground Color of the Color Tab (Default) SYSTEM Black Black Black Background Color of the Color Tab (Default) SYSTEM White White White Tab(s) to be Applied All tabs Build Build Build 4. Change the selection in the Foreground and Background lists of the Color tab. 5. Click the OK button. 2.8.
High-performance Embedded Workshop 2. Build Basics To display out of date files in the workspace window 2.9 1. Select [Setup -> Options]. The Options dialog box opens. 2. Select the Build tab. 3. Check the Mark out of date files check box. 4. Click OK. File dependencies A typical project will contain dependencies between files. For example, a C file may ‘#include’ one or more header files.
High-performance Embedded Workshop 2.
High-performance Embedded Workshop 2. Build Basics When [Build -> Build] is selected, a confirmation dialog box appears to ask if you wish to update the file dependencies before executing the build. If you have not manually updated dependency data, it may be out of date. When you want dependency data to be updated prior to build, select Yes. If you select No, it executes "Build" based on current dependency scanning data.
High-performance Embedded Workshop 2.10 2. Build Basics Configuring the Workspace window If you right-click anywhere inside the Projects tab of the Workspace window, a pop-up menu will be invoked. Select the Configure View menu option to modify the way in which information is displayed. The following four sections detail the effect of each option on the Configure View dialog box.
High-performance Embedded Workshop 2. Build Basics Show File Paths By default, any files will not be shown with their full path (as in figure (k) below). If the Show file paths checkbox is selected, all of the files in the Projects tab of the Workspace window are shown with their full path, i.e. from a drive letter (as in figure (kk) below).
High-performance Embedded Workshop 2. Build Basics To insert a new project into the workspace 1. Select [Project -> Insert Project]. The Insert Project dialog box opens. 2. Select the New project radio button. 3. Click the OK button. The Insert New Project dialog box opens. 4. Enter the name of the new workspace into the Project Name field. This can be up to 32 characters in length and contain letters, numbers and the underscore character. Especially, do not use a minus sign, or a space.
High-performance Embedded Workshop 2. Build Basics To unload a project from the workspace 1. Select the Loaded project from the Projects tab of the workspace window. 2. Right-click to display the pop-up menu and select the Unload Project option. It is possible to select multiple projects in the workspace window to perform this operation. If the project is Unloaded, its icon appears ‘grayed’ in the Projects tab of the workspace window and no actions can be performed upon it.
High-performance Embedded Workshop 2. Build Basics When there is a project dependent on the current project, the High-performance Embedded Workshop checks whether building of the dependent project should be executed earlier than that of the current project. When the current project is a parent, the dependency checking will be performed on its child project. Even if another project is dependent on the child project, this dependent project will not be checked. 2.
High-performance Embedded Workshop 3. Advanced Build Features 3. Advanced Build Features This chapter explains the advanced build concepts. 3.1 The build process revisited “Chapter 2, Build Basics” began by describing the build process in terms of a compiler, an assembler and a linker. This will be the case for most installations of the High-performance Embedded Workshop. However, if you want to begin changing the build process (e.g.
High-performance Embedded Workshop 3. Advanced Build Features The remainder of this chapter details the various functions that the Build Phases dialog box provides. 3.2 Creating a custom build phase If you want to execute another tool before, during or after a standard build process then this can be achieved by creating your own (i.e. custom) build phase. To create a new custom build phase 1. Select [Build -> Build Phases] to invoke the Build Phases dialog box. 2. Click the Add button.
High-performance Embedded Workshop 3. Advanced Build Features Step 2 The second step asks what type of phase you would like to create. There are two choices: multiple or single. When a multiple phase is executed, the command is applied to each file in the project of a certain file group. For example, if you set the input file group to be C source files then the command will be executed once for each C source file in the project. A single phase is executed once at most during a build.
High-performance Embedded Workshop 3. Advanced Build Features Once this choice has been made the input file group selection is displayed as Multiple Groups. This dialog box allows the user to choose multiple input file groups for the custom phase being added to the project. To select a file group check the box next to the file group’s name. One or more file groups can be selected in this dialog box. Step 3 The third step requests the fundamental information about the new build phase.
High-performance Embedded Workshop 3. Advanced Build Features Step 4 The fourth and final step allows you to specify any environment variables that the phase requires. To add a new environment variable click the Add button (the Environment Variable dialog is displayed). Enter the variable name into the Variable field and the variable’s value into the Value field and then click the OK button to add the new variable to the list.
High-performance Embedded Workshop 3.3 3. Advanced Build Features Ordering build phases In a standard build (shown in figure below), you could add a phase at four different positions: before the compiler (1), before the assembler (2), before the linker (3) or after the linker (4). You may place your own custom phases or move system phases to any position in the build order.
High-performance Embedded Workshop 3. Advanced Build Features To change the order of phases (system/custom) in a build or build all operation 1. Select the phase to be moved and then click the Move Up and Move Down buttons to move the phase up and down respectively. 2. Click the OK button to set the new ordering. To view the properties of a system phase 1. Select the system phase that you would like to view. 2. Click the Modify button. 3. The Command tab shows general information about the phase.
High-performance Embedded Workshop 3. Advanced Build Features 8. Use the Add, Modify and Remove buttons to add, modify and remove environment variables respectively. 9. Select the Output Syntax tab and define the error, warning, and information for the custom phase. Messages that include filenames can only be handled as syntax. Thus all syntax defined on the Output Syntax page should include filenames. Always use a placeholder to specify a filename.
High-performance Embedded Workshop 3. Advanced Build Features The total number of errors and warnings will also be displayed in the Build tab of the output window at the end of a build phase. 10. Use the Add, Modify and Remove buttons to add, modify and remove output syntax line formats respectively. 11. Click the OK button when all modifications have been made. Note: You can only change the environment of a system phase via the Tools Administration dialog box. To remove a custom phase 1.
High-performance Embedded Workshop 3.3.3 3. Advanced Build Features File Mappings tab By default, the files input to a build phase are only taken from the project, i.e. all project files of the type specified in the Select input file group drop-down list on the New Build Phase dialog box. Select [Build -> Build Phases]. The Build Phases dialog box will be displayed.
High-performance Embedded Workshop 3.4 3. Advanced Build Features Setting custom build phase options Once you have defined a custom phase, you will want to specify the command line options that should be used when it is executed. Each defined phase has a menu option in the Build menu. To specify options for that phase select it.
High-performance Embedded Workshop 3. Advanced Build Features Note: An error will be returned when the total number of characters of the command line options exceeds 256. 3.4.2 Output Files tab This tab is where you can specify the output files that will be produced by the phase. Before each file is passed into this phase, the High-performance Embedded Workshop checks that the output files are of a less recent date than the input file. If so, the phase will be executed for that file (i.e.
High-performance Embedded Workshop 3. Advanced Build Features To add a dependent file 1. Click the Add button. The Add Dependent File dialog box opens. 2. Enter the file path or browse to it using the Browse button. 3. Click the OK button to add this output file to the list. To modify a dependent file 1. Select the dependent file that you would like to modify. 2. Click the Modify button. The Modify Dependent File dialog box opens. 3. Modify the fields as required. 4.
High-performance Embedded Workshop 3. Advanced Build Features Notes: • Irrespective of what these controls are set to, the build will always halt if a fatal error is encountered. • When projects are dependent on one another, building stops if an error occurs in the child project and its parent project will not be built. • Note the following descriptions when you check the Stop build if the number of errors exceeds check box and specify a number to the controls. i.
High-performance Embedded Workshop 3. Advanced Build Features To show information about toolchain components, select a tool from the Toolchain build phase drop-down list on the Change Toolchain Version dialog box, and click the Information button. A tool information dialog box will show you information about the tool. Click the Close button to close the dialog box. 3.8 Generating a makefile The High-performance Embedded Workshop allows you to generate a makefile associated with your workspace.
High-performance Embedded Workshop 3. Advanced Build Features 4. Select a makefile type in Generate makefile for. • the current configuration in the currently active project • all configurations in the currently active project • all configurations in all loaded projects in the current workspace 5. Enter the file name in the MakeFile name edit box. To insert a placeholder, place the cursor at the position where you wish to insert the placeholder, click the placeholder button ( pop-up menu.
High-performance Embedded Workshop 3. Advanced Build Features The High-performance Embedded Workshop will create a subdirectory called ’make’ within the current workspace directory and then generate the makefile into it. The executable HMAKE.EXE, located in the High-performance Embedded Workshop installation directory, is provided for you to execute the makefiles generated by HMake selected in Makefile format. If you wish to modify makefiles, see Reference 13, HMAKE User Guide.
High-performance Embedded Workshop 3. Advanced Build Features 5. Enter the make tool name to execute the makefile in the Command (excluding parameters) edit box. The default is hmake ($(HEWDIR)\hmake.exe). 6. Select the Use makefile build system (for this workspace) checkbox. This means that the makefile should be executed rather than the internal build. 7.
High-performance Embedded Workshop 3.10 3. Advanced Build Features Customizing the High-performance Embedded Workshop linkage order Modules are usually linked in the alphabetical order in High-performance Embedded Workshop. However, you can specify the linkage order if you wish to. Note: When the SuperH or H8SX, H8S, and H8 family toolchain is in use, the Object order list box shows library files along with object files. However, only object files matter to the linkage order.
High-performance Embedded Workshop • Move down Switches the selected module(s) and the next module. Move to bottom Moves the selected module(s) to the bottom. 3. Advanced Build Features To move non-consecutive modules Move to top Moves all of the selected modules to the top. Group up Moves all of the selected modules to the position of the first one among them. Group down Moves all of the selected modules to the position of the last one among them.
High-performance Embedded Workshop 3. Advanced Build Features To save the linkage order in a text file 1. Click [Build -> Linkage Order]. The Linkage Order dialog box opens. 2. Select the Use custom linkage order check box. 3. Click on the Export button. The Export Linkage Order dialog box opens. 4. Choose a file and directory and click on the Save button. The current settings in the list box are saved in the specified text file.
High-performance Embedded Workshop 4. Using the Editor 4. Using the Editor This chapter describes how to use the editor that is provided with the High-performance Embedded Workshop. 4.1 Editor window The editor window contains the file windows that are being viewed or edited. The title bar of the active window will appear a different color from that of the others (“dbsct.c” is the active window in figure bellow).
High-performance Embedded Workshop 4.2 4. Using the Editor Working with multiple files The file area is where you will work with the files of your project. The editor allows you to have many files open at one time, to switch between them, to arrange them in different configurations and to edit them in whichever order you want to.
High-performance Embedded Workshop 4. Using the Editor The table below outlines the basic operations that are provided by the editor.
High-performance Embedded Workshop 4. Using the Editor To save the contents of every open editor window 1. Select one of the following operations: • Click the Save All toolbar button ( • Select [File -> Save All]. 2. If any of the files has not been saved before, a File Save dialog box will be displayed. Enter a filename, specify a directory and then click the OK button to create the file with the name given in the directory specified.
High-performance Embedded Workshop 4. Using the Editor The High-performance Embedded Workshop keeps track of the last files that you have opened and adds them to the File menu under the [Recent Files] sub-menu. To open a recently used file Select [File -> Recent Files] and from this sub-menu select the desired file. 4.3.
High-performance Embedded Workshop 4.3.6 4. Using the Editor Pop-up menu to close the window In the High-performance Embedded Workshop editor window it is possible to save and close editor file window via the related tab’s pop-up menu. Right-clicking on the tab of the Editor window opens a pop-up menu containing available options. Pop-up Menu Option Save Close Function Saves the contents of an editing window. Closes an individual file.
High-performance Embedded Workshop 4. Using the Editor 4. Enter the text that you want to search for into the Find what field, or select a previous search string from the drop-down list box. If you select text before invoking the find operation, the selected text will be automatically placed into the Find what field. 5. If you would like to search for character string as a whole word then click the Match whole word only checkbox.
High-performance Embedded Workshop 4. Using the Editor 2. Enter the text that you want to search for into the Find field, or select a previous search string from the dropdown list box. If you selected text before invoking the find operation, the selected text will be automatically placed into the Find what field. 3. Enter the file extensions of the files you would like to search into the In files/types field. If several extensions are specified, be sure to separate them with a semicolon (e.g. *.C; *.
High-performance Embedded Workshop 4. Using the Editor Files] menu option. Once the Find In Files operation is complete, you may jump to an instance of the search string by double-clicking on the desired entry in the Output window. 4.4.3 Replacing text Replacing text is similar to finding text, as discussed in the previous section. The difference is that when the text is found you have the option to replace it with other text. To replace text in a file 1.
High-performance Embedded Workshop 4.4.4 4. Using the Editor Jumping to a specified line To jump to a line in a file 1. Ensure that the window, whose contents you want to replace, is the active window. 2. Select one of the following operations to open the Goto dialog box: • Press CTRL+G, OR • Select [Edit -> Goto Line], OR • Select Goto Line from the pop-up menu in the Editor window. 3. Enter the number of the line that you want to jump to into the Line number box and then click the OK button.
High-performance Embedded Workshop 4. Using the Editor To jump to the next bookmark in a file 1. Ensure that the insertion cursor is somewhere within the file to be searched. 2. Select one of the following operations: • Click the Next Bookmark toolbar button ( • Press F2, OR • • Select [Edit -> Bookmarks -> Next Bookmark], OR Right-click and select [Bookmarks -> Next Bookmark] from the pop-up menu. ), OR To jump to the previous bookmark in a file 1.
High-performance Embedded Workshop 4. Using the Editor To set up the page margins 1. Select [File -> Page Setup]. The Page Setup dialog box opens. 2. Enter the width of the margins required into the Left, Right, Top and Bottom fields. 3. Set the Inch or mm option accordingly. 4. Click the OK button for the new settings to take effect. To set up the header and footer information 1. Select [File -> Page Setup]. The Page Setup dialog box opens. 2.
High-performance Embedded Workshop 4. Using the Editor To use spaces as tabs 1. Select [Setup -> Options]. The Options dialog box opens. 2. Select the Editor tab. 3. Set the Use spaces as tabs checkbox as appropriate. 4. Click the OK button for the new tab settings to take effect. 4.7.3 Auto indentation When you press Enter the editor, the insertion cursor will move to the next line down, at the first column (i.e. against the left-hand side of the window).
High-performance Embedded Workshop 4. Using the Editor To split a window Double-click the split bar button to split the window in half, or click on the split bar button, keep the button pressed, drag the mouse down and then release the mouse button at the point you want to split the window. To adjust the position of the split bar Click on the split bar itself, keep the button pressed then move the bar to the new position and then release the button.
High-performance Embedded Workshop 4.10.1 4. Using the Editor Changing text colors To change existing colors 1. Select [Setup -> Format Views]. The Format Views dialog box opens. 2. Select the view you are interested in changing the font for. If it is the editor expand the "Source" in the tree on the left hand side of the dialog box. 3. Select the file type for which you want to edit syntax coloring from the File group list and then expand and select it. 4. Select the category are interested in.
High-performance Embedded Workshop 4. Using the Editor To create new keywords 1. Select [Setup -> Format Views]. The Format Views dialog box opens. 2. Select the desired keyword group to be modified. 3. Click the Keywords tab. 4. Click the Add button to add a keyword. Then the Add Keyword dialog box opens. Specify a keyword in the Keyword field and click the OK button to close the dialog box. To remove a keyword from the Keywords list, select the keyword and click the Remove button.
High-performance Embedded Workshop 4.11 4. Using the Editor Templates When developing software it is often necessary to enter the same text repeatedly, for instance, when typing a function definition, for loop or a comment block for a function. The High-performance Embedded Workshop editor allows you to specify a block of text (or template) which can be inserted into the currently active Editor window.
High-performance Embedded Workshop 4. Using the Editor 2. Click the Add button. The Add Template dialog box is displayed, which asks you to enter your chosen template name. This name must be unique, otherwise a duplicated template name message will be displayed and the template will not be added. 3. If you want to modify an existing template use the Template Name drop-down menu to select which template you want to modify. 4. Enter the desired text into the Template Text area.
High-performance Embedded Workshop 4.11.2 4. Using the Editor Deleting a template To delete a template 1.
High-performance Embedded Workshop • Select [Edit -> Match Braces], OR • Select Match Braces from the pop-up menu. 4. Using the Editor To check the structure of an entire file, place the cursor at its start and then repeatedly invoke the match brace operation. The editor will successively highlight each pair of braces in turn until there are no more left to match. 4.13 Setting the read-only attribute for a file While using the High-performance Embedded Workshop, you can set a file to be read-only.
High-performance Embedded Workshop 4. Using the Editor information column added by the debugger. The global column states feature is also accessible from the main edit menu. To switch off a column in all source files 1. Select one of the following operations to display the Global Editor Column States dialog box: • Select [Edit -> Define Column Format], OR • Right-click in the editor window and select Define Column Format from the pop-up menu. 2.
High-performance Embedded Workshop 4.17 4. Using the Editor Opening a file within the editor The High-performance Embedded Workshop allows you to open a file within the editor window. To open a file shown in the editor window 1. Right-click on the file name in the Source field in the editor window. 2. Select Open '' from the pop-up menu. 4.18 Tooltip watch Use this function to know the value of a variable defined in the source program.
High-performance Embedded Workshop 4.19 4. Using the Editor Evaluate an expression Launches the Evaluate dialog box allowing the user to enter a numeric expression, e.g. "205*2", and display the result in all currently supported radices. To evaluate an expressions 1. Select [Edit -> Evaluate]. The Evaluate dialog box opens. 2. Enter the expression that you wish to evaluate and click the Evaluate button.
High-performance Embedded Workshop 5. Tools Administration 5. Tools Administration You can control the components that are used by the High-performance Embedded Workshop via the Tools Administration dialog box, which is invoked by selecting [Tools -> Administration]. The Tools Administration dialog box is only accessible when no workspace is open. There are five standard types of component: Toolchain System Tool Utility Phase Debugger Component Extension Component 5.
High-performance Embedded Workshop 5. Tools Administration Although initial registration is automatic, during the course of development or if you want to manage the tools being used in your projects more effectively, you may need to register components yourself. 5.2 High-performance Embedded Workshop registration files When a High-performance Embedded Workshop compatible component (i.e.
High-performance Embedded Workshop 5. Tools Administration To change the tools directory location 1. Select [Tools -> Administration]. The Tools Administration dialog box opens. 2. Click the Modify button, which is next to the Current HEW tools location field. 3. Browse to the root directory of the new tool location and click the OK button. 4. This will switch the directory and change the tool location to the new directory.
High-performance Embedded Workshop 5. Tools Administration To register a single component 1. Click the Register button on the Tools Administration dialog box. 2. Browse to the component’s .HRF file and click the OK button to register that component. Note: The High-performance Embedded Workshop registration file is located in the root directory of a component’s installation. 5.
High-performance Embedded Workshop 5. Tools Administration If there is an issue with the component and it is working incorrectly additional information is displayed here. Select the Environment tab, if it exists, to view and edit a component’s environment settings. This tab is most commonly used to modify the environment of a toolchain. To add a new environment variable 1. Click the Add button. The Environment Variable dialog opens. 2. Enter the variable name into the Variable field. 3.
High-performance Embedded Workshop 5. Tools Administration To remove an environment variable 1. Select the variable that you want to remove from the Environment tab. 2. Click the Remove button. Note: Placeholder pop-up menus are included to ensure that the environment can be specified as flexibly as possible. For further information about using placeholders, see Reference 5, Placeholders. 5.
High-performance Embedded Workshop 5. Tools Administration If any of the components have problems these can be seen in the tools administration dialog. If the icon has an additional icon this explains the problem. There are two additional icons that can be displayed. If a component is found but cannot be used due to it being an old version or another dependent component is not available then the icon in figure below is used to show this.
High-performance Embedded Workshop 5. Tools Administration Note: Each project in your workspace can have different components loaded and unloaded. If you have multiple projects you can use the “Multiple projects” and “All projects” items to change a components load status over more than one project. If you select a combination which means the component is loaded in one project and not anther then the intermediate state icon is displayed. 5.
High-performance Embedded Workshop REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 117 5.
High-performance Embedded Workshop 6. Customizing the Environment 6. Customizing the Environment 6.1 Customizing the toolbars The High-performance Embedded Workshop provides standard toolbars as detailed in the Toolbars topic. In addition to these, you may also construct your own toolbars. To create a new toolbar 1. Select [Setup -> Customize]. The Customize dialog box opens. 2. Select the Toolbars tab. 3. Click the New button. The New Toolbar dialog box opens. 4.
High-performance Embedded Workshop 6. Customizing the Environment To remove buttons from a toolbar 1. Select [Setup -> Customize]. The Customize dialog box opens. 2. Select the Commands tab. 3. Click and drag a button from the toolbar onto the Buttons area. To modify the name of a user-defined toolbar 1. Select [Setup -> Customize]. The Customize dialog box opens. 2. Select the Toolbars tab. 3. In the Toolbars list, select the user-defined toolbar and whose name you want to modify. 4.
High-performance Embedded Workshop 6. Customizing the Environment To show or hide toolbar tooltips 1. Select [Setup -> Customize]. The Customize dialog box opens. 2. Select the Toolbars tab. 3. Set the Show Tooltips checkbox as desired. 6.2 Customizing the Tools menu The Tools menu can be customized to include your own menu options. To add a new menu option 1. Select [Setup -> Customize]. The Customize dialog box. 2. Select the Menu tab.
High-performance Embedded Workshop 6. Customizing the Environment New menu options are added to the bottom of the list (i.e. bottom of the Tools menu). To modify a menu option 1. Select [Setup -> Customize]. The Customize dialog box opens. 2. Select the Menu tab. 3. Select the menu option that you would like to modify and then click the Modify button. 4. Make the desired changes on the Modify Tool dialog box and then click the OK button. To remove a menu option 1. Select [Setup -> Customize].
High-performance Embedded Workshop 6. Customizing the Environment To add a custom placeholder 1. Select [Setup -> Customize]. The Tools Customize dialog box opens. 2. Select the Placeholders tab. 3. Choose whether you need to use an application-wide or workspace-wide placeholder. 4. Click the Add button which is adjacent to the list you require. The Add New Placeholder dialog box opens. 5.
High-performance Embedded Workshop 6. Customizing the Environment When the Generate workspace log check box is clicked any workspace changes will be logged to a file with the same name as the workspace with a “.log” extension. This file will be located in the same directory as the workspace file. When the Generate log for projects check box is clicked any projects in the current workspace that have changes made to them will be logged to a file with the same name as the project with a “.log” extension.
High-performance Embedded Workshop 6. Customizing the Environment 4. Enter a description of the help file into the Description field. 5. Enter the full path of the help file into the File name field (or browse to it graphically by clicking the Browse button). 6. Click the OK button to add the new help file to the list. To make a help file the default choice, select it from the Default Help File drop-down list or set it to None if you would like to be prompted for a help file whenever F1 is pressed.
High-performance Embedded Workshop 6. Customizing the Environment To add a new keyboard shortcut 1. Select the main menu category of the command you wish to modify. It is only possible to modify the commands that have a menu. Only some cases are special that allow modification, these are named global. 2. Select the command you wish to modify or add a new keyboard shortcut for in the Commands list. The current shortcut is displayed in the Current keyboard shortcut field. 3.
High-performance Embedded Workshop Tab Toolbar Command Menu Placeholders Debugger Log Help Keyboard 6.7.2 Control All All Application wide tools Workspace wide tools Application wide custom placeholder Workspace wide placeholder Debugger tool Debugger location Command line options Session file Download module All All All 6.
High-performance Embedded Workshop 6. Customizing the Environment To restore files on opening a workspace 1. Select [Setup -> Options]. The Options dialog box opens. 2. Select the Workspace tab. 3. Select the Restore files on opening workspace checkbox if you would like the files associated with a workspace to be opened when the workspace is opened. 4. Click the OK button. 6.8.
High-performance Embedded Workshop 6. Customizing the Environment To display a prompt before saving the workspace 1. Select [Setup -> Options]. The Options dialog box opens. 2. Select the Workspace tab. 3. Select the Prompt before saving workspace checkbox. 4. Click the OK button. 6.8.6 Prompting before saving a session Checking this option will force the High-performance Embedded Workshop into displaying a prompt before the session is saved to disk.
High-performance Embedded Workshop 6. Customizing the Environment To recover the files check the checkbox alongside the filenames you wish to recover and click OK. Clicking Cancel will discard the auto-recovery files and load from the original files. 6.8.8 Setting the projects to load on workspace open You can configure which projects are initially loaded on workspace open. This is an application wide setting which is only relevant to workspaces that contain multiple projects.
High-performance Embedded Workshop 6. Customizing the Environment To change the default directory for new workspaces 1. Select [Setup -> Options]. The Options dialog box opens. 2. Select the Workspace tab. 3. Enter the directory in which to create new workspaces into the Default directory for new workspaces field, or browse to it graphically by clicking the Browse button. 4. Click the OK button. 6.
High-performance Embedded Workshop 6. Customizing the Environment 4. Enter the path of the executable (without any arguments) into the Command field. 5. Enter the arguments required to open a file into the Arguments to open file field. Use the $(FULLFILE) placeholder to represent the path of the file to be opened. 6. Enter the arguments required to open a file at a specific line into Arguments to open file at line field.
High-performance Embedded Workshop 6. Customizing the Environment Note: When using an external editor be aware of the following issues: • Each time you invoke the external editor, in whichever way, a separate instance of the editor will be launched. • You must save your own files before you perform a Build, Build All or Build File operation. 6.10 Customizing the font in your views The High-performance Embedded Workshop contains many components which you may wish to make look differently.
High-performance Embedded Workshop Disassembly Unknown No Memory Modified Build Error Build Warning Information PC Line Highlight All Source Lines Text Output 6.11 6.
High-performance Embedded Workshop 7. Version Control 7. Version Control The High-performance Embedded Workshop provides facilities for connecting to version control system. Some of the reasons why version control systems are used with a project are: • To maintain the integrity of a project. • To store each stage of a project. • To enable different users to co-develop a project by controlling revisions to its source files.
High-performance Embedded Workshop 7. Version Control Other types of files can also be supported once they are added to the project. • Version Control System that can be Connected with the High-performance Embedded Workshop High-performance Embedded Workshop does not provide the version control system itself. It must be installed in your PC in advance. The High-performance Embedded Workshop can be connected to the version control system via the GUI interface.
High-performance Embedded Workshop • 7. Version Control Once "Microsoft Visual SourceSafe" is selected as a version control system, other options of the [Tools -> Version Control -> Select] option will become available. See Chapter 9, Using Visual SourceSafe. To deselect a version control system 1. Select [Tools -> Version Control -> Select]. The Select Version Control System dialog box opens. 2. Select "" from the Version control systems list. 3. Click on the OK button. 7.
High-performance Embedded Workshop 8. Using the Custom Version Control System 8. Using the Custom Version Control System If you have selected "Custom VCS" as the version control system in section 7.1, Select a Version Control System, the following definitions are necessary for connection of the High-performance Embedded Workshop and Custom VCS. • Version control menu options and locations of the associated command executables (.
High-performance Embedded Workshop 8. Using the Custom Version Control System The Commands tab has two lists of menu options. • System-defined menu options (System menu options and toolbar buttons) System menu options and toolbar buttons lists the menu options always shown as the [Tools -> Version Control] sub-menus. These menu options also have an associated toolbar button on the Version Control toolbar.
High-performance Embedded Workshop 8. Using the Custom Version Control System To define a command to be executed via the system menu or toolbar button 1. Select [Tools -> Version Control -> Configure]. The Version Control Setup dialog box opens. 2. Select a menu option in which you wish to define a command from System menu options and toolbar buttons list and click the Modify button. The Define Commands dialog box opens. 3. Click the Add button to define a command in the selected menu option.
High-performance Embedded Workshop 8. Using the Custom Version Control System To change the ordering of user-defined version control menu options 1. Select [Tools -> Version Control -> Configure]. The Version Control Setup dialog box opens. 2. Select the menu option to be moved and then click the Move up and Move down buttons as necessary. 3. Close the Version Control Setup dialog box by clicking the OK button. 8.
High-performance Embedded Workshop 8. Using the Custom Version Control System To change the ordering of version control menu options 8.3 1. Select the menu option to be moved from the Commands list of the Define Commands dialog box. 2. Click the Move up and Move down buttons as necessary. Specifying arguments It is obvious that arguments must be specified correctly, otherwise the version control tool executed will not function as intended.
High-performance Embedded Workshop 8.6 8. Using the Custom Version Control System Specifying file locations When referring to a file’s location, be sure to use a placeholder, otherwise the command will only relate to a hardwired file. For example, let’s imagine that a version control executable has been selected which uses a –GET command to obtain a read-only copy of a file. The Arguments field could be specified as: -GET ‘c:\vc\files\project\main.
High-performance Embedded Workshop 8. Using the Custom Version Control System To modify a directory mapping 1. Select [Tools -> Version Control -> Configure]. The Version Control Setup dialog box opens. Select the Projects tab. 2. Select the mapping to be modified from the Version Control Directory Mappings list and then click the Modify button. The Version Control Directory Mapping dialog box opens. 3.
High-performance Embedded Workshop 8.8 8. Using the Custom Version Control System Specifying environment Select the Projects tab of the Version Control Setup dialog box to view the current settings. To add a new environment variable 1. Click the Add button beside the Environment list (the Environment Variable dialog box will be invoked). 2. Enter the variable name into the Variable field. 3. Enter the variable’s value into the Value field. 4.
High-performance Embedded Workshop • 8. Using the Custom Version Control System Run in DOS window By default, the output of the version control commands is redirected to the Version Control tab of the output window. If you would rather run each command in a separate DOS window then set this checkbox. Select Close DOS window on exit checkbox if you wish the DOS window to close after execution has been completed.
High-performance Embedded Workshop 8.11 8. Using the Custom Version Control System Usage example of the Custom Version Control System The custom version control system includes any version control system in which command-line commands should be executed via the MS-DOS command prompt. The usage examples in this section use the following version control systems to be connected with the High-performance Embedded Workshop.
High-performance Embedded Workshop 8. Using the Custom Version Control System 8.11.1.2 Step 2: Selecting Custom Version Control System 1. Select [Tools -> Version Control -> Select]. The Select Version Control System dialog box opens. 2. Select Custom VCS. 3. Click the OK button. 8.11.1.3 Step 3: Making settings for Version Control Select [Tools -> Version Control -> Configure] to open the Version Control Setup dialog box. • Setting environment variables 1. Select the Projects tab. 2.
High-performance Embedded Workshop 8. Using the Custom Version Control System 4. Enter "path" in Variable and "%path%;C:\RCS" in Value, respectively. 5. Click the OK button. 6. Click the Add button. Also enter the following environment variables in Environment. LOGNAME=user TZ=JST-9 • • Specifying actions 1. Select the General tab. 2. Deselect the Prompt before executing command checkbox. (Leave it selected, however, if you wish to see the file name before executing commands.) 3.
High-performance Embedded Workshop 8. Using the Custom Version Control System 5. The Add Command dialog box appears. 6. Enter "C:\RCS\CI.EXE" in Version control executable. 7. Enter "-l $(FILENAME)" in Arguments. 8. Enter "$(PROJDIR)" in Initial directory. 9. Click the OK button. 10. Click the OK button in the Add Menu Option dialog box. Tip: It is recommended that you only register some commands frequently used for version control. Other commands should be used via the MS-DOS command prompt.
High-performance Embedded Workshop 8. Using the Custom Version Control System 4. Enter a comment for check-in after the prompt (">>") and press Enter. 5. Enter one period '.' and press Enter. rcs_sample.c,v <-- rcs_sample.c enter description, terminated with single '.' or end of file: NOTE: This is NOT the log message! >> . initial revision: 1.1 done C:\RCS> 6. Enter "exit" and press Enter. This closes the MS-DOS command prompt window. 7.
High-performance Embedded Workshop 8. Using the Custom Version Control System 8.11.1.6 Step 6: Using the Version Control facility (Check-out) Use the check-out command to undo the changes made in the file. 1. Select the file "rcs_sample.c" in the Projects tab of the workspace window and select [Tools -> Version Control -> Check out]. 2. The MS-DOS command prompt window appears and shows the result of check-out. 3. Enter "exit" and press the Enter key. This closes the MS-DOS command prompt window. 4.
High-performance Embedded Workshop 8. Using the Custom Version Control System Step 9: Using the Version Control facility (Compare) Step 10: Using the Version Control facility (Register the Result) Step 11: Using the Version Control facility (View Logs) 8.11.2.1 Step 1: Create a workspace 1. Select [File -> New Workspace] to open the New Project Workspace dialog box. 2. Create a workspace with the following conditions.
High-performance Embedded Workshop 5. • Click the OK button. Setting up commands 1. Select the Commands tab. 2. Click the Add button on User menu options. 3. The Add Menu Option dialog box appears. 4. Enter "Initialize" in Option and click the Add button. 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 153 8.
High-performance Embedded Workshop 9. 8. Using the Custom Version Control System Click the OK button. 10. Click the OK button in the Add Menu Option dialog box. Also set up the following six commands in the same way.
High-performance Embedded Workshop 8. Using the Custom Version Control System Executing C:\cvs-1-11-17\cvs.exe checkout sampleCVS U sampleCVS/dbsct.c (Omit) cvs.exe checkout: Updating sampleCVS Command(s) completed successfully. 8.11.2.7 Step 7: Using the Version Control facility (Modify the File) Use the High-performance Embedded Workshop editor to modify the file (and save it). In this example, the file "sampleCVS.c" is modified. 8.11.2.8 Step 8: Using the Version Control facility (Check the Status) 1.
High-performance Embedded Workshop 8. Using the Custom Version Control System > //loop > while(1) >{ > printf("### Data Input ###\n"); //loop 49a53,54 > //loop >} Command(s) completed successfully. You can see the changes made in the file "sampleCVS.c". 8.11.2.10 Step 10: Using the Version Control facility (Register the Result) 1. Select [Tools -> Version Control -> Commit]. 2. Select the file in the Commit dialog box and click the OK button. 3.
High-performance Embedded Workshop 8. Using the Custom Version Control System date: 2006/02/28 03:39:22; author: user; state: Exp; lines: +6 -1 modify ---------------------------revision 1.1 date: 2006/02/28 02:46:30; author: user; state: Exp; branches: 1.1.1; Initial revision ---------------------------revision 1.1.1.1 date: 2006/02/28 02:46:30; author: user; state: Exp; lines: +0 -0 New Source ====================================================================== Command(s) completed successfully.
High-performance Embedded Workshop 9. Using Visual SourceSafe 9. Using Visual SourceSafe The High-performance Embedded Workshop provides specific support for the Visual SourceSafe version control system. The Visual SourceSafe version control system associates a project in your workspace with a project inside a Visual SourceSafe database.
High-performance Embedded Workshop 9. Using Visual SourceSafe 4. Enter your Visual SourceSafe username into the Username field and password into the Password field. 5. For the Database path field, specify the Visual SourceSafe database file (SRCSAFE.INI) into which you would like to add this project. Select either of the following operations: • Click the Browse button to open the Select Visual SourceSafe database dialog box.
High-performance Embedded Workshop 9. 9. Using Visual SourceSafe Click the OK button in the Create SourceSafe Project For Workspace dialog box. The Create SourceSafe Project dialog box opens. The example below shows that the High-performance Embedded Workshop workspace “Workspace_Name” is added as a project “Workspace_Name” into Visual SourceSafe database. The Project name field shows “Poject_Name” that is to be created next. 10. Click the OK button in the Create SourceSafe Project dialog box. 11.
High-performance Embedded Workshop 9.2.1 9. Using Visual SourceSafe Adding files to Visual SourceSafe In the previous section, a mapping between the workspace directory on your hard disk (i.e. the working directory) and the project directory in Visual SourceSafe (i.e. the directory controlled by Visual SourceSafe) has been established.
High-performance Embedded Workshop 9. Using Visual SourceSafe command options. The information shown includes whether the file is added to the project, if the file is checked out and, if it is checked out, and who did so. 9.2.2 Removing files from Visual SourceSafe If you wish to take files out of Visual SourceSafe, the files must be removed. To remove files from Visual SourceSafe 1. Select the files that you would like to remove from Visual SourceSafe, in the Projects tab of the workspace window.
High-performance Embedded Workshop 3. 9.2.4 9. Using Visual SourceSafe The Get from VCS dialog box opens. Select the checkbox on the left to the name of the file that you wish to obtain and click the OK button. Checking out writable copy of files from Visual SourceSafe Visual SourceSafe protects your source files and ensures that only one user can have a writable copy of a controlled file at any one time.
High-performance Embedded Workshop 9.2.5 9. Using Visual SourceSafe Checking in writable copy of files into Visual SourceSafe Visual SourceSafe protects your source files and ensures that only one user can have a writable copy of a controlled file at any one time. The check out operation takes a writable copy of the file from Visual SourceSafe and places it on your local drive. Once a file is checked out it is edited and then checked back in so that the edits can be made available to other users.
High-performance Embedded Workshop 9. Using Visual SourceSafe 3. The Check in to VCS dialog box opens. Select the checkbox on the left to the name of the file that you wish to check back into Visual SourceSafe and click the OK button. 4. When the operation is finished the file has a red mark next to its name. This means you as the current user of High-performance Embedded Workshop has checked it out. 5.
High-performance Embedded Workshop 9. Using Visual SourceSafe other users. However, if the check out operation was carried out by mistake, or perhaps is no longer required, then the operation can be undone. To undo a check out of files from Visual SourceSafe 1. Select the files upon which you would like to undo a previous check out operation, in the Projects tab of the workspace window. You may also select a file folder, project folder, workspace folder or combination thereof. 2.
High-performance Embedded Workshop 3. 9.3 9. Using Visual SourceSafe The Version Control tab of the output window or the File(s) History dialog box shows the revision history of files. Visual SourceSafe command options You can control the way in which the history and status commands are displayed by selecting [Tools -> Version Control -> Configure]. 1. Select [Tools -> Version Control -> Configure]. The Version Control Setup dialog box opens. 2. Select the General tab. 3.
High-performance Embedded Workshop 9. Using Visual SourceSafe To define a new directory mapping 1. Select [Tools -> Version Control -> Configure]. The Version Control Setup dialog box opens. 2. Select the Mapping tab. 3. Click the Add button. The Version Control Directory Mapping dialog box opens. 4. Specify a High-performance Embedded Workshop workspace directory or project directory in the Source directory field.
High-performance Embedded Workshop 9. Using Visual SourceSafe To remove a directory mapping 1. Select [Tools -> Version Control -> Configure]. The Version Control Setup dialog box opens. 2. Select the Mapping tab. 3. Select the mapping to be removed from the list and then click the Remove button. 9.
High-performance Embedded Workshop 9. Using Visual SourceSafe 3. Enter the executable file (SS.EXE) for version control system in Version control executable. 4. Enter "Properties -y$(USERNAME),$(PASSWORD) -i- $(VCDIR)/$(FILENAME)" in Arguments. 5. Enter "$(FILEDIR)" in Initial directory. 6. Click the OK button. 7. Click the OK button in the Add Menu Option dialog box. For detail, see section 8.2, Defining Version Control commands. • Command Execution 1.
High-performance Embedded Workshop 10. Sharing Projects by Network Facilities 10. Sharing Projects by Network Facilities The High-performance Embedded Workshop is capable of sharing workspaces and projects across a network. This allows users to concurrently work on shared projects and see each other’s changes as they happen. This system can be used in conjunction with version control.
High-performance Embedded Workshop 10. Sharing Projects by Network Facilities To setup a project file on the server machine 1. Create a project file for the network. 2. As the directory of the New Project Workspace dialog, specify a network path that can be recognized by both the server machine and the client machine. Example: \\WorkGroup\Severl\ShareDirectory Sharing workspaces The directory specified by the above procedure (step 2) must be shared.
High-performance Embedded Workshop 10. Sharing Projects by Network Facilities Step2: DCOM 1. Select Run from the Windows® start menu. The Run dialog box is invoked. 2. Enter "dcomcnfg" in the Open field and click the OK button. The Component Services window opens. 3. Expand the tree. If the Window Security Alert dialog box appears at expansion, click the Keep Blocking button. Console Root -> Component Services -> Computers -> My Computer 4.
High-performance Embedded Workshop 10.2 10. Sharing Projects by Network Facilities Enabling network facilities to share projects To use network facilities to share projects 1. Select [Setup -> Options]. The Options dialog box opens. 2. Select the Network tab. 3. Click the Enable network data access checkbox. This should add an administrator to the system without a password. The administrator is the only user that can add additional users to the system and change user access rights.
High-performance Embedded Workshop 10. Sharing Projects by Network Facilities 5. Type the new password into both of the fields and click OK. 6. This should set the user and password on the Network tab of Options dialog box. 10.4 Adding new users to the system The initial setting of the network database adds an administrator user and a guest user to the system.
High-performance Embedded Workshop 10.5 10. Sharing Projects by Network Facilities Changing your password To change your password 1. Log into the High-performance Embedded Workshop network database you are changing your password for. Select [Setup -> Options]. The Options dialog box opens. 2. Select the Network tab. 3. Click the Password button. 4. Enter your new password and confirm it in the second edit box. 5. Click OK. 6. Then click OK to save the password change. 10.
High-performance Embedded Workshop 10. Sharing Projects by Network Facilities Note: If the network is running multiple High-performance Embedded Workshop workspaces with the network facilities to share projects enabled then a user can only access one of them at one time. The only instance when this is not the case is if the same machine is serving all of the network workspaces. REJ10J1837-0100 Rev.1.00 Nov.
High-performance Embedded Workshop 11. Comparing Files 11. Comparing Files The High-performance Embedded Workshop has an integrated difference view. You can perform a difference comparison with two files on your local drive or a local file and a file in the Microsoft® Visual SourceSafe system. 11.1 Opening the Difference window To perform a difference comparison with two files on your local drive 1. Select one of the following operations: • Select a file in the Projects tab of the workspace window.
High-performance Embedded Workshop 11. Comparing Files • Select [View -> Differences]. Right-click within the window to open a pop-up menu. Select Compare. 3. The Compare Files dialog box opens. 4. Click the Compare with version control radio button. This radio button is selectable if the High-performance Embedded Workshop has been connected to the Visual SourceSafe system. 5. Enter the name of a file to be compared to in Reference file.
High-performance Embedded Workshop 11. Comparing Files Options Right-clicking displays a pop-up menu containing available options. A basic operation is allocated to the toolbar. The Toolbar display and Customize toolbar options are also included in the pop-up menu opened by right-clicking on the toolbar.
High-performance Embedded Workshop 12. Navigation Facilities 12. Navigation Facilities The High-performance Embedded Workshop has a number of new integrated navigation facilities. The Navigation tab of the workspace window contains categories for all supported navigation types. In Highperformance Embedded Workshop the following navigation components are supported as standard: Navigation Type (Category) C Defines C Functions C++ Class Function All #defines for C and C++ source files are displayed.
High-performance Embedded Workshop 12. Navigation Facilities It is possible to disable scanning for certain navigation categories if you do not require the information. To switch off a navigation category 1. If you right-click anywhere inside the Navigation tab, a pop-up menu will be invoked. 2. Select Select Categories. The Select Categories dialog box is displayed. 3. Un-check any categories you are not interested in seeing definitions for. 4. Click OK. REJ10J1837-0100 Rev.1.00 Nov.
High-performance Embedded Workshop 12. Navigation Facilities To update the navigation view 1. If you right-click anywhere inside the Navigation tab, a pop-up menu will be invoked. 2. Select Refresh. Notes: • The navigation items are displayed gradually as the files are scanned. This means it may take some time if there are many files to fully complete the Navigation view update. • Files are re-scanned when they are saved.
High-performance Embedded Workshop 12. Navigation Facilities The C++ navigation view uses a number of icons to describe the type of function or variable the icon belongs too. These are listed in the table below: Double clicking on a navigation item by default jumps you to the associated navigation items declaration. This default behavior can be modified by selecting Jump To Definition On Double-Click from the pop-up menu (this option is unchecked by default).
High-performance Embedded Workshop 12. Navigation Facilities To list the member variables and functions in the alphabetical order 1. Right-click on navigation items on the Navigation tab to display a pop-up menu. 2. Un-check Group by Access. This option is unchecked by default. To group the display of public, private, and protected member variables and functions together 1. Right-click on navigation items on the Navigation tab to display a pop-up menu. 2. Check Group by Access.
High-performance Embedded Workshop 12.4 12. Navigation Facilities Drag and drop navigation items It is possible 'drag and drop' navigation items of #defines, C functions, or C++ classes shown in the Navigation tab of the workspace window. The Category (C Defines, C Functions, and C++ Classes), Globals Folder, and File items will not be draggable.
High-performance Embedded Workshop 12.5 12. Navigation Facilities Smart edit capability Another feature of the High-performance Embedded Workshop is its smart edit facility. This is enabled by default for all C++ source files. This feature allows the High-performance Embedded Workshop editor to access C++ navigation information and provide auto-completion help when using C functions, #defines, C++ classes, and member functions.
High-performance Embedded Workshop • 12. Navigation Facilities It is possible to select a C function, #define, C++ class, or member function in the pop-up window and add it to the High-performance Embedded Workshop editor window by either of the following ways: o Right-click within the High-performance Embedded Workshop editor window to display a pop-up menu and select List Members. A pop-up window opens. Select an item you wish to add and press ENTER, OR o Press CTRL+SPACE to display a pop-up window.
High-performance Embedded Workshop 13. Map 13. Map Among the section settings of the linkage editor and the contents of the linkage list file output by the linkage editor, information on sections and symbols are respectively shown. There are the following features.
High-performance Embedded Workshop 13. Map Note: If a subcommand file is specified as shown below, the section setting information of the linkage editor will not be shown in the Map Section Information window. 13.1 Managing section settings You can add, modify, or delete information on sections on the GUI through the Map Section Information window. It is also easy to check the section settings after modification. 13.1.
High-performance Embedded Workshop 13. Map 2. Select "Map Section Information" in the Map drop-down list. 3. Click OK. Window configuration • The left pane shows the map information and section settings of the linkage editor. - Section settings of the linkage editor are displayed. - While in the edit mode, each of subsection groups, overlay groups, and sections can be dragged and dropped.
High-performance Embedded Workshop • 13. Map The right pane shows the section settings after a build. - Nothing is displayed in this pane if there is no linkage list file (.map) output by the linkage editor. - You can adjust the column width by dragging the mouse on a column header. Moreover, right-clicking the column header displays a pop-up menu. A tick mark right next to an entry indicates that this column is displayed. Clicking an entry will switch showing/hiding the column.
High-performance Embedded Workshop Pop-up Menu Option Show Unallocated Area Toolbar Button Show No Size Section 13. Map Function Shows the unallocated area. Shows the no size section. View source Views the source code for the address in the selected line. Print Prints section list view. 13.1.2 Entering/exiting the edit mode To edit the section information shown in the left pane, the High-performance Embedded Workshop must enter the edit mode. By default, the edit mode is not selected.
High-performance Embedded Workshop 13. Map 3. The confirmation dialog box shown below opens. To reflect the changes to the section settings of the linkage editor, select Yes. 4. The High-performance Embedded Workshop exits the edit mode. The tick mark on Section Edit Mode has disappeared. 13.1.3 Adding a section group In the edit mode, you can add a section group. To add a section group 1. Right-click within the left pane to open a pop-up menu. 2. Select Add Section Group. 3.
High-performance Embedded Workshop 4. 13. Map Enter a section name in Section Name. In the tree of the left pane, the new section is added under the section group, subsection group, or overlay group. 13.1.5 Adding an overlay group In the edit mode, you can add an overlay group *1 under a section group, subsection group, or section *2. To add an overlay group 1. Right-click on a section group, subsection group, or section to open a pop-up menu. 2. Select Add Overlay Group. 3.
High-performance Embedded Workshop 13. Map To automatically add missing sections 1. Right-click within the left pane to open a pop-up menu. 2. Select Section Auto Registration. • If some sections are missing in the left pane and the right pane includes a section group whose address value is smaller than the smallest address among the missing sections, all of these sections will be added to the last in the section group.
High-performance Embedded Workshop 13.1.9 13. Map Setting a memory map While the High-performance Embedded Workshop is connected with a debugging platform, you can set a memory map. To set a memory map 1. Right-click within the left pane to open a pop-up menu. 2. Select Memory Map Setting. 3. The memory map setting dialog box opens. The current mapping of the address space is shown as a list. Set a memory map or memory resource as necessary. 4. Click the OK button.
High-performance Embedded Workshop 13. Map 13.1.11 Printing out the section settings tree You can also print out the section settings tree in the left pane. To print out the section settings tree 1. Right-click within the right pane to open a pop-up menu. 2. Select Print. 3. The standard print formatting and selection dialog box opens. From here you can choose your printer and page setup options. 13.1.12 Viewing unallocated areas You can view areas where no section is allocated.
High-performance Embedded Workshop 13. Map 13.1.15 Printing out the section list You can also print out the section list in the right pane. To print out the section list 1. Right-click within the right pane to open a pop-up menu. 2. Select Print. 3. The standard print formatting and selection dialog box opens. From here you can choose your printer and page setup options. 13.2 Viewing symbols You can view symbols in each of the sections in the Map Symbol Information window.
High-performance Embedded Workshop • 13. Map The left pane shows the map list of the linkage editor. - Nothing is displayed in this pane if there is no linkage list file (.map) output by the linkage editor. - Selecting the root of the map list ("Linker map list") shows all symbol information in the right pane. - Selecting a section in the map list only shows symbol information of the selected section in the right pane. • The right pane shows the symbol information of the linkage editor.
High-performance Embedded Workshop 13.2.2 13. Map Printing out the map list You can also print out the map list in the left pane. To print out the map list 1. Right-click within the left pane to open a pop-up menu. 2. Select Print. 3. The standard print formatting and selection dialog box opens. From here you can choose your printer and page setup options. 13.2.3 Finding symbols You can search for the linkage editor symbols. To search for symbols 1.
High-performance Embedded Workshop 13. Map 3. Select the Enable Filter checkbox. By default, this checkbox is not selected. 4. Select a column in Filter Column. 5. Select a filtering condition in Filter Item.
High-performance Embedded Workshop 13.2.6 13. Map Printing out the symbol information You can also print out the symbol information in the right pane. To print out the symbol information 1. Right-click within the right pane to open a pop-up menu. 2. Select Print. 3. The standard print formatting and selection dialog box opens. From here you can choose your printer and page setup options. REJ10J1837-0100 Rev.1.00 Nov.
High-performance Embedded Workshop 14. Using the Command Line 14. Using the Command Line The High-performance Embedded Workshop Command Line Interpreter allows the user to control the debugging platform by sending text-based commands instead of the window menus and commands. It is especially useful if a series of predefined commands need to be sent to the debugging platform by calling them from a batch file and, optionally, recording the output in a log file.
High-performance Embedded Workshop • 14. Using the Command Line Debugger tab This pane allows the user to perform single stepping or set breakpoints in the selected batch file to control the target platform. When a batch file has been loaded, placing the mouse cursor on the line dividing the panes turns the mouse cursor into a double-headed arrow. Click and drag the mouse cursor to a desired position to adjust the size of the panes.
High-performance Embedded Workshop 14. Using the Command Line Options • Console tab Right-clicking displays a pop-up menu containing available options. A basic operation is allocated to the toolbar. The Toolbar display and Customize toolbar options are also included in the pop-up menu opened by right-clicking on the toolbar. Pop-up Menu Option Set Batch File Toolbar Button Macro Recording Function Specifies a batch file. Play - Plays the current batch file.
High-performance Embedded Workshop Step 14. Using the Command Line - Single-steps in a batch file. Toggles a break point on the current line of a batch file. Enables or disables the current breakpoint on the current line of a batch file. Removes all breakpoints of a batch file. Specifies a log file. Insert/Remove Breakpoint Enable/Disable Breakpoint - - Clear All Breakpoints Set Log File - - Starts or stops output to log file. - - Shows or hides the toolbar. Customizes toolbar buttons.
High-performance Embedded Workshop 14. Using the Command Line If you modify the contents after the batch file has been specified, the High-performance Embedded Workshop shows a message telling that the batch file will be loaded again. If you do not wish to open this confirmation dialog box, select the Don't ask this question again checkbox. To open the confirmation dialog box again 1. Select [Setup -> Options]. The Options dialog box opens 2. Select the Confirmation tab. 3.
High-performance Embedded Workshop 14.6 14. Using the Command Line Starting or stopping logging Choose Logging from the pop-up menu to toggle logging to file on and off. When logging is active, the button becomes effective. Note that the contents of the log file cannot be viewed until logging is completed, or temporarily disabled by clearing the check box. Re-enabling logging will append to the log file. 14.
High-performance Embedded Workshop 14. Using the Command Line 14.13 Clearing the contents of the Command Line window Selecting Clear window from the pop-up menu of the Command Line window clears all of the information shown in the Console tabbed pane and in the upper pane of the Debugger tabbed pane of the Command Line window. 14.14 Undoing the last operation Choose Undo from the pop-up menu to undo the last operation at the latest cursor position (on the text currently being input). 14.
High-performance Embedded Workshop 14. Using the Command Line Notes: • • Information such as the name of the batch file and breakpoints in the batch file is saved in the session. If you change the session on the Debugger tabbed pane of the Command Line window, the pane now shows the contents of the batch file specified for the current session. The status of the batch file is also automatically reset even in cases where the batch file includes any of the following commands.
High-performance Embedded Workshop • 14. Using the Command Line CLOSE_WORKSPACE When a command is run, the batch file will be closed. • CHANGE_PROJECT or CHANGE_SESSION When a command is run, the contents of the batch file specified for the current session will be shown in the pane. • CHANGE_CONFIGURATION When a command is run, the status of the batch file will automatically be reset. 14.
High-performance Embedded Workshop 15. Using the Macro-Recording Support Facility 15. Using the Macro-Recording Support Facility The macro-recording support facility allows you to record operations, which are associated with the High-performance Embedded Workshop system applications *1, build *2, and debugging *3, as High-performance Embedded Workshop command-line commands or to execute these recorded commands.
High-performance Embedded Workshop 15. Using the Macro-Recording Support Facility Items that also have an associated toolbar have their icons displayed alongside the menu options. The standard buttons on the Macros toolbar are shown below. • The Record Macro button starts the macro recording process. After this button is clicked debugging and High-performance Embedded Workshop management operations are recorded. This operation is the same as the Record macro menu on the Tools menu.
High-performance Embedded Workshop 15. Using the Macro-Recording Support Facility The Current macro file drop-down list holds all of the macro files currently in use in the High-performance Embedded Workshop system. These files are stored in the “Macros” folder within the High-performance Embedded Workshop management information folder under the application data folder for each user profile. Any files that are copied into this directory are automatically added to the Current macro file drop-down list.
High-performance Embedded Workshop 15. Using the Macro-Recording Support Facility To edit an existing macro file 1. Select [Tools -> Macros]. The Macro dialog box opens. 2. Select the macro file, the function exists in. 3. Select the macro in the function list you wish to edit. 4. Click the Edit button. 5. The Macros dialog box is dismissed and the file is opened in the editor.
High-performance Embedded Workshop 15. Using the Macro-Recording Support Facility To record a macro from the toolbar or menu 1. Click the Record Macro button ( ) or menu option on the Macros toolbar or the Tools menu. To indicate ). When that a recording operation is taking place the mouse cursor is modified to include the record icon ( the macro is being recorded the Pause Macro ( ) and Stop Macro ( ) buttons and menus are enabled.
High-performance Embedded Workshop Project Build *1 Debug Set Current Project Insert Project Edit Project Configuration *3 Build File CTRL+F7 Build F7 Build All - Build Multiple Clean Current Project Clean All Project Build Configurations *4 - Debug Sessions *5 - Reset CPU - Go F5 Reset Go SHIFT+F5 Free Go *3 - Go to Cursor - Set PC to Cursor - Run Step In F11 Step Over F10 Step Out SHIFT+F11 Step Step Mode - - - - Halt Program - Initialize Connect *3 - - Disconnect
High-performance Embedded Workshop • 15. Using the Macro-Recording Support Facility Windows While a macro is being recorded, operations made in the windows listed below will be recorded into a macro file. For information on the types of recordable operations, see the descriptions of the respective windows.
High-performance Embedded Workshop 15. Using the Macro-Recording Support Facility Go To Cursor pop-up menu option Set PC Here pop-up menu option S/W Breakpoints column Runs program until the PC reaches cursor. Sets PC to the address at cursor. Double-click on Sets or clears a software breakpoint. the column Click on the Mixed/disassembly Go To Cursor pop-up menu option Sets or clears a software breakpoint.
High-performance Embedded Workshop 15. Using the Macro-Recording Support Facility In-place edit Make setting in the dialog box opened by double-clicking a value Value Modifies memory contents. Note: *. Support for this function depends on the debugger. 15.5.1.6 IO window While a macro is being recorded, the following operations will be recorded into a macro file. Target Value 15.5.
High-performance Embedded Workshop 15.
High-performance Embedded Workshop 15. Using the Macro-Recording Support Facility 15.5.2.1 Editor window While a macro is being recorded, the following operation will be recorded into a macro file. Display Mode Source mode Target Instant Watch pop-up menu option Operation Make setting in the dialog box opened by clicking on the menu option • E8 emulator software V.2.10 Release 00 and later • E8a emulator software • E10A-USB emulator software V.2.
High-performance Embedded Workshop Delete Auto Update pop-up menu option/toolbar button Delete Auto Update All pop-up menu option/toolbar button Record Update Value -> Start Recording pop-up menu option/toolbar button Record Update Value -> Stop Recording pop-up menu option/toolbar button Add Watch pop-up menu option/toolbar button Edit Name pop-up menu option/toolbar button Edit Value pop-up menu option/toolbar button Delete pop-up menu option/toolbar button Delete All pop-up menu option/toolbar button Ra
High-performance Embedded Workshop 15. Using the Macro-Recording Support Facility 15.5.2.8 CWatch window While a macro is being recorded, the following operations will be recorded into a macro file. Target Set pop-up menu option/toolbar button Value Operation Make setting in the dialog box opened by clicking on the menu option or toolbar button Make setting in the dialog box opened by double-clicking on a value In-place edit Function Sets new data to selected C watch point. 15.5.2.
High-performance Embedded Workshop 15. Using the Macro-Recording Support Facility 15.5.2.12 Trace window While a macro is being recorded, the following operation will be recorded into a macro file. Target Acquisition pop-up menu option/toolbar button Operation Function Make setting in the dialog box opened by Configures trace acquisition parameters. clicking on the menu option or toolbar button 15.5.2.
High-performance Embedded Workshop 15. Using the Macro-Recording Support Facility 15.5.2.17 Trace conditions dialog box While a macro is being recorded, the following operation will be recorded into a macro file. Target Apply button Operation Click on the button Function Changes the trace conditions. 15.5.2.18 Violation of access protection dialog box While a macro is being recorded, the following operation will be recorded into a macro file.
High-performance Embedded Workshop 15. Using the Macro-Recording Support Facility 15.5.2.23 Realtime Profile window While a macro is being recorded, the following operations will be recorded into a macro file.
High-performance Embedded Workshop 15. Using the Macro-Recording Support Facility 15.5.2.27 Start/Stop Function Setting dialog box While a macro is being recorded, the following operation will be recorded into a macro file. Target OK button 15.6 Operation Click on the button Function Specifies the address of a work area and an executing routine. Playing a macro There are a number of ways to play a macro file in the High-performance Embedded Workshop, these options are discussed below.
High-performance Embedded Workshop 15. Using the Macro-Recording Support Facility can also be manually edited in the High-performance Embedded Workshop editor window. Any changes made will automatically be picked up by the High-performance Embedded Workshop next time the macro is executed. 15.8 Assigning a macro It is possible to assign a macro to either a custom menu option, toolbar or keyboard shortcut. This allows you to quickly access macros which you often use.
High-performance Embedded Workshop 15.9 15. Using the Macro-Recording Support Facility Configuring the Macro tab of the Output window Shows the current records of macros. You can view information such as High-performance Embedded Workshop command-line commands recorded into a High-performance Embedded Workshop macro file from execution of [Tools -> Macro Recording] to [Tools -> Stop Macro]. It is also possible to view this information while recording.
High-performance Embedded Workshop 16. Using the Test Support Facility 16. Using the Test Support Facility The High-performance Embedded Workshop provides regression testing facilities for your application by the test support facility. Regression test is re-execution of a previous test after modification of the program to verify the result.
High-performance Embedded Workshop 16. Using the Test Support Facility To create a test suite 1. Select [Test -> Create New Test Suite]. The Create New Test Suite dialog box opens. 2. Enter the test suite name. 3. Initially the workspace directory is shown in Directory for test suite. This can be modified as required. 4. Clicking OK. The test suite is then created. This then enables a number of other options on the Test menu.
High-performance Embedded Workshop 16. Using the Test Support Facility To edit a test suite 1. Select [Test -> Edit Test Suite]. The Modify Test Suite dialog box is displayed. The Modify Test Suite dialog box displays the currently defined test cases. Each test case has a name and can have a detailed description that you have defined to explain the tests purpose. Clicking the Add button on this dialog box displays the Add New Test dialog box, this is shown below.
High-performance Embedded Workshop 16.4 16. Using the Test Support Facility Adding tests to the test suite Once your test suite has been created the next step is to add some tests. This operation allows you to access the Modify Test Suite dialog box and will allow you to add tests which will then be executable. To add tests to a test suite 1. Select [Test -> Edit Test Suite]. The Modify Test Suite is then displayed. 2. Click Add. The Add New Test dialog box is displayed.
High-performance Embedded Workshop 16.5 16. Using the Test Support Facility Creating a test image file The test image data is what is used for any comparison in the test system. Only items that are saved in the test file can be compared. For example you may only be interested in comparing data that is located in a small area memory not the memory for the entire device.
High-performance Embedded Workshop 16. Using the Test Support Facility 3. Click the Import button to open the Import the Test Image File dialog box. Browse to the HIF file location. The settings of an existing test image file are imported. 4. Each component is listed in the dialog box. Check the checkbox next to the component name to save data for that component. 5. Select the component in the dialog and then click the Settings button.
High-performance Embedded Workshop 16. Using the Test Support Facility In some cases it is necessary to make detailed setting specific to each of the test items before saving test-image data. If you double-click on a test item in the Create New Test Image dialog box, a further dialog box for detailed setting opens. When a test item has any detailed setting, it is possible to customize test-image data of this test item before saving.
High-performance Embedded Workshop New Example 16. Using the Test Support Facility Data in the current High-performance Embedded Workshop system or in another test-image file to be compared with Original: Connected New: Step Normal End No detailed setting specific to the test item can be made. 16.6.1.2 CPU-Register (Register window) The following table shows information on the test-image data to be saved into test-image files and test results (not matched).
High-performance Embedded Workshop 16. Using the Test Support Facility 1. Selecting the checkbox for an I/O register in the Compared I/O registers list allows this I/O register to be saved into the test-image file. These check boxes are not selected by default. The selected I/O register is shown in Current Setting. 2. If you do not wish to compare the address of the selected register, select the Ignore address checkbox. This checkbox is not selected by default. 3. Click OK. 16.6.1.
High-performance Embedded Workshop 16. Using the Test Support Facility 1. To specify the sheet to be compared in the test-image file, select the Memory, Platform, or Events checkbox. These checkboxes are not selected by default. 2. Click OK. 16.6.1.5 CPU-Memory (Memory window) The following table shows information on the test-image data to be saved into test-image files and test results (not matched).
High-performance Embedded Workshop • • • 16. Using the Test Support Facility To add a memory range 1. Click on the Add button on the Edit Test Memory Ranges dialog box to open the Add Memory Range dialog box. 2. Specify Start address, End address, and Access size to set a memory range to be saved into a test-image file. 3. Click OK. To modify a memory range 1. Click on the Modify button on the Edit Test Memory Ranges dialog box.
High-performance Embedded Workshop Test group name Test item name Test-image data to be saved into test-image files Test result details 16. Using the Test Support Facility Code StackTrace Values set as detailed information and data within nested function calls in the StackTrace window. The default value in Nest level is 10. Src Content of the test-image file Dest Data in the current HEW system or in another test-image file to be compared with Example Value differs.
High-performance Embedded Workshop ASMWatch ASMWatch CWatch CWatch 16.
High-performance Embedded Workshop 16. Using the Test Support Facility 1. The Watch Sheet drop-down list contains "Watch1", "Watch2", "Watch3", and "Watch4". Symbols shown in the Symbols list depend on the selection made in the Watch Sheet drop-down list. 2. Each of the symbols in the Symbols list has a check box. By default, the check boxes are not selected. Select a watch sheet and check the boxes for symbols as required. The selected symbol is shown in Current Setting. 3.
High-performance Embedded Workshop Test result details Failed at symbol Src Dest Example 16.
High-performance Embedded Workshop saved into test-image files Test result details 16. Using the Test Support Facility setting. Checkboxes for all watch points are blank by default.
High-performance Embedded Workshop • 2. Specify BitSymbol, Address, Size, and Bit to set a bit-level watch point to be saved into the test-image file. 3. Click OK. To delete a watch point 1. • 16. Using the Test Support Facility Click on the Delete button on the Edit Test ASM Watch Points dialog box. The watch point selected in the Compared watch list will be deleted. Only one point is selectable in the list. To disable comparison of the addresses of watch points 1.
High-performance Embedded Workshop Test group name Test item name Test-image data to be saved into test-image files Test result details 16. Using the Test Support Facility Symbol CWatch Values set as detailed information and the range of data in the CWatch window acquired with this setting. Checkboxes for all variables are blank by default.
High-performance Embedded Workshop 16. Using the Test Support Facility been selected, and local variables that can be viewed in the current scope (at the position of the program counter) when Local has been selected. When you have selected a file name, the Name list shows the file local variables included in the compilation unit to which the selected file belongs. • 3. Each of the variables in the Name list has a check box. By default, the check boxes are not selected.
High-performance Embedded Workshop • • 16. Using the Test Support Facility To add a simulated I/O range 1. Click on the Add button on the Edit Test Simulated I/O dialog box to open the Add Simulated I/O dialog box. 2. Specify All or Line No to set a I/O simulation range to be saved into a test-image file. 3. Click OK. To modify a simulated I/O range 1. Click on the Modify button on the Edit Test Simulated I/O dialog box. The simulated I/O range selected in the Simulated I/O list will be modified.
High-performance Embedded Workshop • 16. Using the Test Support Facility To remove a simulated I/O range 1. Click the Remove button on the Edit Test Simulated I/O dialog box. The simulated I/O range selected in the Simulated I/O list will be removed. Only one simulated I/O range is selectable in the list. Then click OK. 16.6.2.6 Code-Coverage (Coverage window) The following table shows information on the test-image data to be saved into test-image files and test results (not matched).
High-performance Embedded Workshop 16. Using the Test Support Facility 16.6.2.7 Code-Trace (Trace window) The following table shows information on the test-image data to be saved into test-image files and test results (not matched). Test group name Test item name Test-image data to be saved into test-image files Test result details Code Trace Values set as detailed information and the range of data in the Trace window acquired with this setting. No trace range is specified by default.
High-performance Embedded Workshop 3. • • 16. Using the Test Support Facility Click OK. To modify a trace range 1. Click on the Modify button on the Edit Test Trace Ranges dialog box. The trace range selected in the Trace ranges list will be modified. Only one trace range is selectable in the list. 2. The Modify Trace Range dialog box opens. 2. Specify Start PTR, and End PTR to set a trace range to be saved into a test-image file. 3. Click OK. To remove a trace range 1.
High-performance Embedded Workshop • • 16. Using the Test Support Facility 2. Specify Trace type, Start PTR, and End PTR to set a trace range to be saved into a test-image file. 3. Click OK. To change a trace range 1. Click on the Modify button on the Edit Test Trace Ranges dialog box. The trace range selected in the Trace ranges list will be modified. Only one trace range is selectable in the list. The Modify Trace Range dialog box opens. 2.
High-performance Embedded Workshop 16. Using the Test Support Facility 2. Enter the test file location that you want to compare in Test image file field. This is a "*.HIF" (Highperformance Embedded Workshop test image file) file and contains details about the test image data. 3. Then select what you want to compare the file you have selected with. You can choose either the Current system or another previously saved test image file.
High-performance Embedded Workshop 16. Using the Test Support Facility 3. Clicking the check box selects the test for execution in this test run. 4. It is also possible to modify the order a test is executed in by selecting the test and clicking the Move up and Move down buttons. 5. When one or more tests have been selected the Run button is enabled. Clicking this Run button starts the test run. Information will be shown in Test tab of the output window as the tests are executed. 6.
High-performance Embedded Workshop 16. Using the Test Support Facility Double clicking on the component displays more information on why the test data comparison failed. This can also be viewed by selecting the test and then clicking the details button on the toolbar. The results of the tests can be exported to file. The two options are Export and Export All, Export only saves the results of the currently selected test. Export All saves the results of all the tests executed.
High-performance Embedded Workshop modification and they need to be updated. This menu displays the test results for one or more test executions. It shows the pass and fail results and the detailed reason why the test failed. The Test Suite Properties dialog box is displayed. It displays the test suite name, test suite description, test suite location and the last modified date.
High-performance Embedded Workshop 16. Using the Test Support Facility Right-clicking displays a pop-up menu containing available options. A basic operation is allocated to the toolbar. The Toolbar display and Customize toolbar options are also included in the pop-up menu opened by right-clicking on the toolbar. Pop-up Menu Option Clear Window Toolbar Button Function Clears the contents of the window. Save Saves the contents of the window into a text file.
High-performance Embedded Workshop 17. Using the Debugger 17. Using the Debugger This chapter describes the debugging operations and their related windows and dialog boxes. See Chapter 1, Overview, for the fundamental concepts of the High-performance Embedded Workshop (Highperformance Embedded Workshop). For details on the functions available with the debugging platform in use, refer to the user’s manual or help of the emulator or simulator. 17.
High-performance Embedded Workshop 17. Using the Debugger The New Project Workspace dialog box allows you to select a project type for generation, which matches your CPU target. Project Type Application Assembly Application Demonstration C source startup Application Empty Application Import Makefile Library Debugger only - xxxxxx Description Project for generating an execution program that includes the initial routine file written in the C/C++ language.
High-performance Embedded Workshop 1. 17. Using the Debugger Select the CPU and Toolchain version in Step 1. The CPU types (CPU Type) are classified according to the CPU series (CPU Series). Select the CPU corresponding to the program to be developed because the generation file differs according to the CPU Series and CPU Type settings. If there is no corresponding CPU, select a CPU with similar hardware specifications or Other.
High-performance Embedded Workshop 2. 17. Using the Debugger Specify the options common to all project files in Step 2. The specifiable items depend on the CPU selected in Step 1. To move to Step 3, click the Next> button in Step 2. REJ10J1837-0100 Rev.1.00 Nov.
High-performance Embedded Workshop 3. 17. Using the Debugger Specify the generation file in Step 3. Use I/O Library: Number of I/O Streams: Use Heap Memory: Heap Size: Generate main() Function: I/O Register Definition Files: Generate Hardware Setup Function: Checking enables use of standard I/O libraries. Specifies the number of I/O streams that can be used simultaneously. Checking enables use of the heap area management function sbrk(). Specifies the unit of the size of the heap area to be managed.
High-performance Embedded Workshop Enable all: Disable all: 17. Using the Debugger Selects all standard library functions. Does not select all standard library functions. Note that only the minimum required functions, runtime and new, are selected. To move to Step 5, click the Next> button in Step 4. 5. Specify the stack area in Step 5. This is done by setting the initial value of the stack pointer and the stack size. The initial value of the stack areas depends on the CPU selected in Step 1.
High-performance Embedded Workshop 6. 17. Using the Debugger Specify the vector in Step 6. Vector Definition Files: Vector Handlers: Checking generates a vector definition file and a vector table setting function definition file. Handler: Displays the handler program name of the reset vector. To modify the handler program, after selecting the handler program name by clicking on it, enter the new handler program name. Note that if the handler program is modified, a reset program (resetprg.
High-performance Embedded Workshop 7. 17. Using the Debugger Specify the debugger targets in Step 7. Targets: Target type: Target CPU: Sets the debugger targets. Select (by checking) the debugger targets. No selection or a selection of more than one target is possible. Specifies the type of the targets displayed in Targets. Specifies the CPU of the targets displayed in Targets. Note: The endian type selected in step 2 will be applied to the compiler settings.
High-performance Embedded Workshop 8. 17. Using the Debugger Set the options for the debugger targets selected in Step 8. Core: Configuration name: Detail options: Specifies the target core. By default, the High-performance Embedded Workshop generates two configurations: Release and Debug. If a debugger target is selected, a configuration for the selected target is also generated (an abbreviation including the target name). This configuration name can be changed in Configuration name.
High-performance Embedded Workshop 9. 17. Using the Debugger The files to be generated by the High-performance Embedded Workshop based on the settings made so far are displayed as a list in Step 9. File Name: Extension: Description: File name To change a file name, after selecting the file name by clicking on it, enter the new file name. File extension Description of the file Clicking the Finish button in Step 9 displays the Summary dialog box. REJ10J1837-0100 Rev.1.00 Nov.
High-performance Embedded Workshop 17. Using the Debugger 10. The project generator displays information on the project to be generated in the Summary dialog box. After confirming the display contents, click the OK button. Clicking Cancel returns to the New Project wizard dialog box. Checking Generate Readme.txt as a summary file in the project directory will save the project information displayed in the Summary dialog box as a text file named Readme.txt in the project directory. 17.1.2.
High-performance Embedded Workshop 17. Using the Debugger When a makefile is selected by Makefile path, Source files shows source files in the makefile. To view the source files in the makefile again, click Start. To apply toolchain options such as the compiler, select the Import options check box. If you want to remove a file from the project, you can remove it by selecting the file and pressing Remove button. And if you want to add a file to the project, you can add it by pressing Add button.
High-performance Embedded Workshop 17. Using the Debugger 17.1.4.1 Setup To set-up the debugging platform configuration choose [Setup -> Simulator] or [Setup -> Emulator]. Under this sub menu will be the menus which can be used to configure your debug platform. In the case of the SuperH family Simulator the available menus are the System and Memory resource. These options both allow the simulator to be customized and setup to your requirements.
High-performance Embedded Workshop 17. Using the Debugger Target, Core, Debug format, or Download modules can be selected on the Target tab of the Debug Settings dialog box. Note that Core can be specified by using Synchronized Debugging facility. To change the target the following operations is necessary 1. Select the project that needs to be changed in the tree on the left of the dialog. It defaults to the current project. 2. Select the session which is to be modified in the drop list above the tree.
High-performance Embedded Workshop (1) 17. Using the Debugger Configuring the automatic command line batch file execution The High-performance Embedded Workshop debugger is tightly integrated with the TCL command line facilities. This means that it is possible to write batch files for the High-performance Embedded Workshop debugger which can be executed automatically at certain times. The Command batch file load timing list displays the order in which the files will be executed.
High-performance Embedded Workshop 17. Using the Debugger Notes: • If you use the FILE_LOAD or FILE_LOAD_ALL command to download a module, the command batch file specified for "Before download of modules" or "After download of modules" is not executed. • If you use the RESET command to reset the CPU, the RESET command written in the command batch file specified for "After reset" is not executed.
High-performance Embedded Workshop (6) 17. Using the Debugger 2. Select the Options tab. 3. Select the Disable memory access until after target connection command file execution. This option is useful when initial setting of memory is necessary at connection to the target. By default, this checkbox is not selected. 4. Click OK. Limiting disassembly memory access Disables reading data from memory outside the displayed range in disassembly mode. To limit disassembly memory access (7) 1.
High-performance Embedded Workshop 17. Using the Debugger To disable memory access by GUI when target is executing 1. Select [Debug -> Debug Settings]. The Debug Settings dialog box opens. 2. Select the Options tab. 3. Select the Disable memory access by GUI when target is executing. This checkbox is only enabled if the feature is supported by the selected target. Selecting a new target will reset this option to the default setting for the target. Default for this checkbox depends on the target. 4.
High-performance Embedded Workshop 17. Using the Debugger It is also possible to manually choose download modules after the project creation. This is achieved via the Debug Settings dialog box. This dialog box allows you to control the debug settings throughout your workspace. The tree on the left of the dialog contains all of the current projects. Selecting a session in this tree will then show you the settings for that project and the session selection in the session drop-down list.
High-performance Embedded Workshop 17. Using the Debugger 4. The Offset field specifies the memory address offset the module will be loaded at. It defaults to 0. After the module has been added, the offset value is shown on the right of the module name in the [Debug -> Build] submenu, the Download modules folder on the Projects tab of the workspace window, and the [File -> Recently Download Module] submenu. 5. The File format drop-down list box contains a list of supported object format.
High-performance Embedded Workshop 17. Using the Debugger To remove selected download modules using the Projects tab of the Workspace window 1. Select the download modules that you want to remove in the Projects tab of the Workspace window. Multiple download modules can be selected by holding down the SHIFT or CTRL key. 2. Select one of the following operations: • Select Remove from the pop-up menu opened by right-clicking, OR • Press Delete key. 3.
High-performance Embedded Workshop 17. Using the Debugger To automatically download an existing module to the target when adding it to the Download modules list 1. Select one of the following operations to open the Download Module dialog box: • Select [File -> Download A New Module], OR • Right-click on a module or within the Download modules folder on the Projects tab of the workspace window to display a pop-up menu. Select Download A New Module.
High-performance Embedded Workshop 17. Using the Debugger If you do not wish to open this confirmation dialog box, select the Don't ask this question again checkbox. To open the confirmation dialog box again 1. Select [Setup -> Options]. The Options dialog box will be displayed. 2. Select the Confirmation tab. 3. Select the Reload out-of-date download modules checkbox. This checkbox is selected by default. 4. Click OK. 17.1.5.
High-performance Embedded Workshop 17. Using the Debugger If the files are not full paths and are relative or short file names, they will automatically be searched for relative to the download module directory. Files that cannot be found after the initial search will be shown to you in the Locate Files dialog box. However, you can choose not to open the Locate Files dialog box at downloading. To prevent opening of the Locate Files dialog box at downloading • 1. Select [Setup -> Options].
High-performance Embedded Workshop 17. Using the Debugger To locate files 1. The Last searched directory holds the last directory that was searched for these module files. 2. The Search status field shows the number of files that were found against the number that have not - this is only relevant to the files in the dialog and do not account for any previous searches. 3.
High-performance Embedded Workshop 17. Using the Debugger If you select Yes a search will be made, and the Locate Files dialog box will remain open, allowing you to stop the search if needed. Selecting No will invoke the message box and close the Locate Files dialog box. If the confirmation is ticked not to be shown again, the default behavior will be No. To open the confirmation dialog box again (2) 1. Select [Setup -> Options]. The Options dialog box will be displayed. 2.
High-performance Embedded Workshop 17. Using the Debugger Files that could not be located will be shown under the download module but will have a red icon ( To distinguish these files, you can view the full path of the file. To view the full paths of all files 1. Right-click anywhere inside the Projects tab of the Workspace window. 2. Select the Configure View menu option. The Configure View dialog box will be displayed. 3. Select the Show file paths check box. 4. Click OK. REJ10J1837-0100 Rev.1.
High-performance Embedded Workshop 17. Using the Debugger If you wish to relocate files in the download module to a different directory this is possible via pop-up menu. (3) Relocating files to a different directory If you wish to relocate the whole module i.e. want to relocate all files in the module to a different directory this is possible via the download module pop-up menu. To relocate all files in the module to a different directory 1.
High-performance Embedded Workshop 3. 17. Using the Debugger Select a directory, and then click the Open button. Any files that could not be found in this directory will invoke the Locate Files dialog box, allowing you to search for the unlocated files. You can also relocate files, via the pop-up menu option shown for files. To relocate a file to a different directory 1. Right-click on a file in the Projects tab of the workspace window. 2. Select the Relocate file(s) menu option.
High-performance Embedded Workshop 17. Using the Debugger 17.1.5.6 Unloading of modules It is possible to manually unload downloaded modules. When a module is unloaded, its symbols are erased from the High-performance Embedded Workshop debugging system, but the memory contents of the target remains unmodified. After a module has been unloaded, it cannot be debugged unless it is reloaded.
High-performance Embedded Workshop 17. Using the Debugger 17.1.6.1 Selecting a session To select a session 1. Select [Debug -> Debug Sessions]. The Debug Sessions dialog box opens. 2. Select the session that you want to use from the Current session drop-down list box. 3. Click the OK button. You can also select a different debug session by selecting it from the Current Session drop-down list on the Standard toolbar. 17.1.6.
High-performance Embedded Workshop 17. Using the Debugger To add a new empty session 1. Select [Debug -> Debug Sessions]. The Debug Sessions dialog box opens. 2. Click the Add button. The Add Session dialog box opens. 3. Click the Add New Session radio button. 4. Enter a name for the session. 5. Click the OK button. You can import session data from another file and create a new session file in the project directory. All information is an exact copy of the file the data was imported from.
High-performance Embedded Workshop 17. Using the Debugger 17.1.6.3 Importing a link to a session You can add a new session to the High-performance Embedded Workshop system but link to the session file in its location rather than importing or copying the file to the project directory. This is useful when sharing debugger information with other users in a network environment. To import a link to an existing session file 1. Select [Debug -> Debug Sessions]. The Debug Sessions dialog box opens. 2.
High-performance Embedded Workshop 17. Using the Debugger 17.1.6.5 Making a session read-only To make a session read only 1. Select [Debug -> Debug Sessions]. The Debug Sessions dialog box opens. 2. Select the session you would like to view the properties for. 3. Click the Properties button. The properties dialog is displayed. 4. Click the Read only checkbox. This makes the link read only. This is useful if you are sharing debuggersetting files and you do not want data to be modified accidentally.
High-performance Embedded Workshop 17. Using the Debugger 17.1.6.7 Reloading session information To reload a session Select [File -> Refresh Session]. Clicking this will lose any changes to your session currently and the reload the current session into High-performance Embedded Workshop. 17.2 Viewing a program This section describes how to look at your program as source code and assembly language mnemonics. The source code will be shown in the source mode in two types of windows.
High-performance Embedded Workshop 17.2.1 17. Using the Debugger Opening the Editor window To view a source file’s code, double-click on its icon in the file tree, or right-click on the source file and click the Open option on the pop-up menu. The High-performance Embedded Workshop opens the file in the editor. Toolbar The editor in version 4.00 onwards has been enhanced to include an integrated disassembly view. This integrated view has a toolbar which allows the switching of mode.
High-performance Embedded Workshop 17. Using the Debugger If you do not wish to open this confirmation dialog box, select the Don't ask this question again checkbox. To open the confirmation dialog box again 1. Select [Setup -> Options]. The Options dialog box opens. 2. Select the Confirmation tab. 3. Select the Switch from disassembly to new source checkbox. This checkbox is selected by default. 4. Click OK. 17.2.1.1 Viewing the code To view a source file’s code, click the View Source button.
High-performance Embedded Workshop • 17. Using the Debugger The "Source" field includes codes highlighting the syntax. Options Right-clicking within the "Source" field opens a pop-up menu containing available options.
High-performance Embedded Workshop 17. Using the Debugger Window configuration • Clicking another toolbar button switches the display mode. To view disassembly codes in mixed mode, click the "View mixed mode" button. To view source codes in source mode, click the "View Source" button. • The columns listed in the table below are on the left of the "Disassembly" field. Column Name S/W Breakpoints - ASM Disassembly Address Obj code Label • Description Display the PC location ( ), breakpoints ( ).
High-performance Embedded Workshop 17. Using the Debugger 17.2.1.3 Refreshing the disassembly view Even if some external operation changes the memory contents shown in the Disassembly view, the High-performance Embedded Workshop cannot detect the change. For example, if you use the external flash utility to program the range of memory being displayed, the Disassembly view will not be reflected. Right-click on the Disassembly filed (in disassembly mode) and select Refresh.
High-performance Embedded Workshop 17. Using the Debugger The address, machine code and disassembled instructions are shown. Type the new instruction or edit the old instruction in the Mnemonic field. Pressing Enter will assemble the instruction into memory and move on to the next instruction. Clicking the OK button will assemble the instruction into memory and close the dialog box. Clicking the Cancel button or pressing ESC will close the dialog box.
High-performance Embedded Workshop 17. Using the Debugger Both a start and end address should be supplied. You also need to specify the full filename to save the information to. If needed you can browse to the file to use. Click OK. 17.2.1.9 Printing the disassembly view The disassembly view can be printed by using [File -> Print] or the Print toolbar button ( using the menu Print on the Disassembly field (in disassembly mode) pop-up menu.
High-performance Embedded Workshop 17. Using the Debugger Three different modes are possible these are listed below: Mode Source mode Mixed mode Disassembly mode Function The source file relating to the current PC address will be opened if available. It allows keywords are highlighted correctly if you are viewing source files. This view is read-only and cannot be edited. This view is only available when the module is downloaded.
High-performance Embedded Workshop • 17. Using the Debugger The "Source" field includes codes highlighting the syntax. Options Right-clicking within the "Source" field opens a pop-up menu containing available options.
High-performance Embedded Workshop 17. Using the Debugger 3. Select the Use disassembly source-mode as primary debug view checkbox. By default, this checkbox is not selected. 4. Click OK. If this option is set, the following actions will be performed: • If the Disassembly window is open and in Disassembly mode, then when a break occurs at a known source address, the Disassembly window will switch to source-mode.
High-performance Embedded Workshop 17. Using the Debugger Options Right-clicking within the "Disassembly" field opens a pop-up menu containing available options. Pop-up Menu Option Open File in Source Mode Refresh Lock Refresh View Source Set Address Go To Cursor Macro Recording - Display PC Set PC Here - Edit Find in Range Copy Define Column Format Turn Header On/Off Save Disassembly Text Print Toggle Breakpoint Enable/Disable Breakpoint - Function Opens a file shown in the disassembly window.
High-performance Embedded Workshop 17. Using the Debugger Right-click on the Source field or the Disassembly field and select the Set Address option. The Set Address dialog box will be displayed. Enter the address or label name in the edit box and either click the OK button or press the Enter key. The Disassembly view updates to show the code at the new address.
High-performance Embedded Workshop 17. Using the Debugger Enter your search string, the start and end address that should be searched. Click OK. The view then selects the first instance of that string in the range. Note: Subsequent find operations will find strings only in the paged disassembly area not the complete range. 17.2.2.
High-performance Embedded Workshop 17. Using the Debugger To highlight the line at the PC location 1. Select [Setup -> Options]. The Options dialog box opens. 2. Select the Debug tab. 3. Select the Enable line highlight for PC position checkbox. By default, this checkbox is selected. 4. Click OK. The color of the line can be customized in the Format Views dialog box. The text (foreground) is in black and the background color is yellow by default. To change the colors of the line at the PC 1.
High-performance Embedded Workshop 17. Using the Debugger Window configuration • The Label and Register columns are hidden by default. • The Label column shows the name of the label allocated to the first address of the memory data displayed on this row. • The Register column shows the name of the register allocated to the first address of the memory data displayed on this row. • '+n' in the column header of the Data column means the offset value from the first address of the row.
High-performance Embedded Workshop Lock Refresh Auto Refresh *2 - Disables refresh of the Memory window. Regularly refreshes the Memory window. Refresh Interval *2 - Specifies the refresh interval. Data Length 1byte - Data is displayed in 1-byte units. 2bytes - Data is displayed in 2-bytes units. 4bytes - Data is displayed in 4-bytes units. 8bytes - Data is displayed in 8-bytes units. Hex - Data is displayed in hexadecimal. Dec - Data is displayed in decimal.
High-performance Embedded Workshop 17. Using the Debugger • In-place edit in the Code column. • To change the contents of memory, open the Set dialog box by selecting one of the following operations: o Double-click the Data column you want to change, OR o Double-click the Code column you want to change, OR o Select the data you want to change and choose Set from the pop-up menu. Enter the value (value or character) to be set in the Data field. Select the Verify check box.
High-performance Embedded Workshop 17.3.4 17. Using the Debugger Filling an area of memory with constant data You can set the contents of a range of memory addresses to a value using the memory fill feature. Select an address range to fill in the Memory window by dragging the mouse. Choose Fill from the pop-up menu of the memory window. The Fill dialog box opens. Enter the data (value or character) to be filled in the Data field. Select the Verify check box.
High-performance Embedded Workshop 17. Using the Debugger Enter the copy destination start address in the Move Address field. Select the Verify check box. Support for verify function depends on the debugger. If you did not drag the copy-source address range, you must enter the start/end address. The end address can also be prefixed by a plus (+); the end address will become the (start address) + (entered value). Drag and Drop Type of dropped data Selected range on the Memory Window's Data column 17.3.
High-performance Embedded Workshop 17.3.7 17. Using the Debugger Testing an area of memory You can test an area of memory in the address space using the Memory Test feature. Select an address range to test in the Memory window by dragging the mouse. Choose the Test option from the pop-up menu of the memory window. The Test Memory dialog box opens. If you did not drag the address range to be tested, you must enter the start/end address.
High-performance Embedded Workshop 17.3.9 17. Using the Debugger Finding a value in memory You can find a value in memory using the Search Memory feature. Select an address range to search in the Memory window by dragging the mouse. Choose Search from the pop-up menu of the memory window. The Search memory dialog box opens. Enter a value you want to find in Data and select the data format in Search Data As.
High-performance Embedded Workshop 17. Using the Debugger Specify the displaying address in the Address field. Drag and Drop Manipulation Select address on Memory Window's Address area and drop it into another Memory Window's Address column Select variable name (text string) and drop it into Memory Window's Address column Operation Changes the window's display start address to that address. Changes the window's display start address to that address. 17.3.
High-performance Embedded Workshop 17. Using the Debugger 17.3.14 Changing the program display position immediately after downloading To specify the source file position, select Set Start Up Symbol option from pop-up menu of the memory window. The Set start up symbol dialog box opens. Input start up symbol to drop-down list box. 17.3.15 Refreshing the Memory window The Memory window contents can be forcibly refreshed. Selecting Refresh from the pop-up menu of the Memory window. 17.3.
High-performance Embedded Workshop 17. Using the Debugger 17.3.18 Specifying the refresh interval You can specify the interval to refresh the Memory window while the user program is running. Support for this function depends on the debugger. To specify the refresh interval 1. Right-click within the window to open a pop-up menu. 2. Select Refresh Interval. The Auto Refresh Interval dialog box opens. 3. Specify the refresh interval in 10-ms units.
High-performance Embedded Workshop 17. Using the Debugger 17.3.21 Changing the code Select the code from the followings in the pop-up menu Code of the memory window. Either the following can be specified. ASCII SJIS/JIS/UNICODE/EUC Float Double 16bit Fixed 32bit Fixed 24bit Accum 40bit Accum Displays memory as ASCII characters (default). Not support. Displays memory as single-precision floating point. Displays memory as double-precision floating point. Displays memory as 16bit fixed.
High-performance Embedded Workshop 17. Using the Debugger During coverage measurement, the default foreground and background colors of the executed codes are black and light blue, respectively, while those of the codes not executed are black and gray. The colors in both cases can be customized in the Format Views dialog box. For detail, see section 17.3.29, Changing text colors. Support for this function depends on the debugger. 17.3.
High-performance Embedded Workshop 17. Using the Debugger Enter the file format in File format, file name in Filename, offset address in Offset address, and access size in Access size. To verify memory, check Perform memory verify during download. If the load address value is to be changed, enter the offset value in the Offset field, otherwise enter 0. 17.3.
High-performance Embedded Workshop 17. Using the Debugger 17.3.29 Changing text colors The color and font of the data or codes shown in the Memory window can be customized in the Format Views dialog box (in the same manner as the color and font in other windows). Now it is also possible to customize the color of the changed values or accessed memory, which are shown in the data or code field of the Memory window, in the Format Views dialog box. To change the look of the Memory window 1.
High-performance Embedded Workshop 17.4.1 17. Using the Debugger Opening the Image window Choose [View -> Graphic -> Image] or click the Image toolbar button ( ) to open the Image Properties dialog box. The Image Properties dialog box is used to specify the display method of the Image window. The following items are to be specified: Color Specifies the color information of the image to be displayed. Information Mode Specifies the format. MONOCHROME Black and white.
High-performance Embedded Workshop 17. Using the Debugger An example is shown below.
High-performance Embedded Workshop 17. Using the Debugger Width/Height Size Specifies the height and width of an image to be displayed on part of the screen. Width (Pixel) Specifies the width of the display (unless a prefix is included, values are treated as decimal numbers). Height (Pixel) Specifies the height of the display (unless a prefix is included, values are treated as decimal numbers).
High-performance Embedded Workshop 17. Using the Debugger Redraw Continuously - Starts redrawing continuously. Stop - Stops redrawing continuously. Properties - Opens the Image Properties dialog box. - Shows or hides the toolbar. Customizes toolbar buttons. Toolbar display Customize toolbar - Note: *. Available only when the debugger supports this function. 17.4.2 Regularly refreshing the Image window Selecting [Auto Refresh -> Nonrefresh] from the pop-up menu will not refresh the window.
High-performance Embedded Workshop 17.4.5 17. Using the Debugger Viewing Images as Consecutive Frames The Image window can also show images as consecutive frames. This allows you to view multiple images easily because it is not necessary to set addresses for all images. After images have been loaded into consecutive addresses in memory as equal-sized frames, you can view the images by switching the frames in order. To enable the function to show images as consecutive frames 1.
High-performance Embedded Workshop 2. 17. Using the Debugger Click on the Next Image toolbar button to view the third frame. 17.4.5.2 Regularly switching the frames While the function to show images as consecutive frames is enabled, the pop-up menu and toolbar items listed in the table below are available for regularly switching the frames. Pop-up Menu Option Redraw Interval * Toolbar Button Redraw Continuously Function The image is redrawn continuously every 0.5 seconds.
High-performance Embedded Workshop 17. Using the Debugger 2. When the specified time has elapsed, the second frame is automatically displayed. 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.
High-performance Embedded Workshop 17. Using the Debugger This dialog box displays pixel information on the cursor location. Color Mode Pixel Position Buffer Size Image Size 17.5 Displays the format of the image. Displays color information of the cursor location. (Displayed in decimal) Displays the cursor location in X and Y coordinate. (Displayed in decimal) X Displays the X-coordinate of the cursor location. Y Displays the Y-coordinate of the cursor location. Displays the buffer size.
High-performance Embedded Workshop • 17. Using the Debugger If you double-click the coordinate where you wish to view the sampling information, the Sample Information dialog box appears. Options Right-clicking displays a pop-up menu containing available options.
High-performance Embedded Workshop 17. Using the Debugger To specify the refresh interval, select Update Interval from the pop-up menu. This item is only selectable when it is supported by the debugger. 17.5.3 Refreshing the Waveform window Selecting Refresh Now from the pop-up menu immediately refreshes the window contents. 17.5.4 Specifying the refresh interval You can specify the interval to refresh the Waveform window while the user program is running.
High-performance Embedded Workshop 17.5.9 17. Using the Debugger Setting the horizontal scale In the Scale submenu of the pop-up menu, the size of the X-coordinate can be selected from 128, 256, or 512 pixels. 17.5.10 Non-display of cursor Selecting Clear Cursor from the pop-up menu hides the cursor display. 17.5.11 Displaying the sampling information When anywhere within the graph is clicked, a cursor (green vertical line) appears. The cursor can be moved by pressing the left or right arrow key.
High-performance Embedded Workshop 17.6.1 17. Using the Debugger Opening the IO window To open the IO window, choose [View -> CPU -> IO] or click the View IO toolbar button ( the on-chip peripheral modules organize the I/O register information. ). Modules that match The IO window has two tabs: All Register and Selected Register. When the IO window is first opened, only a list of module names is shown on the All Register tabbed pane.
High-performance Embedded Workshop 17. Using the Debugger Find - Finds an I/O register. Find Next - Finds the next I/O register to match. - Shows or hides the toolbar. Customizes toolbar buttons. Toolbar display Customize toolbar 17.6.2 - Expanding an I/O register display To display the names, addresses and values of the I/O registers, double-click on the module name or select the module name, by clicking on it or using the cursor keys, and press the cursor right key.
High-performance Embedded Workshop 17.6.4 17. Using the Debugger Refreshing the IO window The IO window contents can be forcibly refreshed. Selecting Refresh from the pop-up menu of the IO window. 17.6.5 Disabling refresh of the IO window Automatic refresh of the IO window, which is performed when user program execution stops and in other cases, can be disabled. Select Lock Refresh from the pop-up menu of the IO window.
High-performance Embedded Workshop 17. Using the Debugger Note: This function cannot be used during execution of the user program. 17.6.7 Loading an I/O file I/O files can be manually loaded to the IO window. To load an I/O file 1. Right-click in the IO window to display a pop-up menu. 2. Select Load IO File. The Set I/O File dialog box opens. 3. Specify an I/O file you wish to load in the I/O File field. To insert a placeholder in the I/O File field, click the Placeholder button ( button.
High-performance Embedded Workshop 17.6.8 17. Using the Debugger Printing the currently displayed contents The contents currently displayed on the selected pane of the IO window can be printed in a text file. Select Print from the pop-up menu. 17.6.9 Saving the currently displayed contents The contents currently displayed on the selected pane of the IO window can be saved in a text file. Select Save to File from the pop-up menu. 17.6.
High-performance Embedded Workshop 17.7 17. Using the Debugger Looking at registers If you are debugging at assembly-language level using the Disassembly view, you will probably find it useful to see the contents of the CPU's general registers. You can do this by using the Register window. 17.7.1 Opening the Register window The Register window displays the register data and flag data. You can change a register/flag value from the window.
High-performance Embedded Workshop 17.7.2 17. Using the Debugger Changing the register display radix You can change the display radix by register. To do this, click the mouse right button on the register to be changed and select the display radix from the pop-up menu which is opened. The followings can be selected. Hex Dec Oct Bin 17.7.3 Display in hexadecimal. Display in decimal. Display in octal. Display in binary.
High-performance Embedded Workshop 17.7.4 17. Using the Debugger Setting the layout To set the layout of the Register Window, choose Layout from the register Window pop-up menu. The followings can be selected: Radix FLAGs Switch display or non-display of radix. Switch display or non-display of flags display area. When the radix or flag is shown, the option is checked. When the radix and flags are displayed 17.7.
High-performance Embedded Workshop 17.7.6 17. Using the Debugger Modifying register contents To change register contents, follow the procedure below. Enter a value in the Value field of the register you want to change. To change a register's contents, open the Set Value dialog by selecting one of the following operations • Double-click the register you want to change, OR • Select the register you want to change and choose the Edit option from the pop-up menu.
High-performance Embedded Workshop 17. Using the Debugger When you have entered the new number or expression, click the OK button or press Enter. The dialog box closes and the new value is written into the register. 17.7.7 Setting the flag value When the flag itself is displayed Click the button of the flag to be changed. Every time you click the button the flag status (1/0) is switched. If a flag is composed of multiple bits, a dialog is opened, where you can enter a value to be changed.
High-performance Embedded Workshop 17. Using the Debugger The contents of the Register window are grayed-out. When two windows are open and this function is enabled in either of the windows, values of registers and flags can be compared. 17.7.12 Using register contents It can be useful to be able to use the value contained in a CPU register when you are entering a value elsewhere in the High-performance Embedded Workshop, for example when displaying a specified address in the Disassembly or Memory views.
High-performance Embedded Workshop 17. Using the Debugger 17.11 Connecting/disconnecting the debugging platform To connect the debugging platform Select one of the following operations: • Click the Connect toolbar button ( • Select [Debug->Connect]. ), OR To disconnect the debugging platform Select one of the following operations: • Click the Disconnect toolbar button ( • Select [Debug->Disconnect]. ), OR Support for this function depends on the debugger. 17.
High-performance Embedded Workshop 17. Using the Debugger 17.12.3 Running program, ignoring any breakpoints Sometimes when you are debugging your application you may need to start running continuously but have breakpoints configured. Instead of disabling all the breakpoints, you can quickly execute the code using the Free Go feature. To run from the current PC address, but ignore any (both software and hardware) breakpoints • Click the Free Go toolbar button ( • Choose [Debug -> Free Go].
High-performance Embedded Workshop 17. Using the Debugger The following execution conditions can be specified in this dialog box: Program counter Temporary PC Breakpoints Instruction address to start execution. The initial value is the current PC value. A temporary PC breakpoint. When execution started by this dialog box stops, this breakpoint is cleared. Clicking the Go button starts execution according to the settings. Clicking the Reset Go button starts execution from the reset vector.
High-performance Embedded Workshop 17. Using the Debugger If you choose to step over the function the debugger will execute the call and all of the code in the function (and any function calls that function may make) and stop at the next line or instruction of the calling function. To step over the function • Click the Step Over toolbar button ( • Select [Debug -> Step Over].
High-performance Embedded Workshop Steps Delay Step over calls Source level step 17. Using the Debugger Number of steps to be executed. By default, this value is 1. Delay between steps when the program is automatically stepped. "No Refresh" (Prevents the update of the windows) or 0 to 3 seconds can be selected in 0.5 second units. By default, this value is 2.5 seconds. Selecting this box steps over function calls. By default, this checkbox is not selected.
High-performance Embedded Workshop 17. Using the Debugger 3. It is possible to enable or disable the current breakpoint by selecting [Enable/Disable Breakpoint] from the pop-up menu. 4. Now when you run your program and it reaches the address at which you set the PC breakpoint, execution halts with the message ‘PC Breakpoint’ displayed in the Debug pane, and the source or disassembly view is updated with the PC breakpoint line highlighted.
High-performance Embedded Workshop Tab Memory Platform Events 17. Using the Debugger Description Contains information about the current memory status including the memory mapping resources and the areas used by the currently loaded object file. Contains information about the current status of the debugging platform, typically including CPU series and mode, run status and timing information. Contains information about the current event (breakpoint) status, including resource information. 17.
High-performance Embedded Workshop 17. Using the Debugger 17.15.2 Viewing the source program Select a function and choose Go to Source from the pop-up menu to display, then the source program corresponding to the function, which has been selected by opening the editor window, is displayed. 17.15.3 Specifying the view Choose View Setting from the pop-up menu to open the Stack Trace Setting dialog box, which allows the user to specify the Stack Trace window settings.
High-performance Embedded Workshop Click the Launch External Debugger toolbar button ( 17. Using the Debugger ) to invoke the debugger with the specified session file. After a build, if the download module has been updated, the High-performance Embedded Workshop will switch back to the debugger to enable immediate debugging.
High-performance Embedded Workshop 17. Using the Debugger To configure the PD debugger to integrate with High-performance Embedded Workshop 1. Firstly, the location of the debugger executable must be specified. This may have been configured by the installation program or a project generation utility. 2. The second item of data is the profile file. This tells the debugger which profile file to load when it is launched. This file stores the debug setup information. 3.
High-performance Embedded Workshop 17. Using the Debugger To configure an external debugger to integrate with High-performance Embedded Workshop 1. Firstly, the location of the debugger executable must be specified. This may have been configured by the installation program or a project generation utility. 2. The second item of data is the command line options. This field allows additional options to be specified which can modify the behavior of the external debugger. 3.
High-performance Embedded Workshop 17. Using the Debugger Options Right-clicking displays a pop-up menu containing available options. A basic operation is allocated to the toolbar. The Toolbar display and Customize toolbar options are also included in the pop-up menu opened by right-clicking on the toolbar. Pop-up Menu Option Add Toolbar Button Edit Macro Recording Function Adds a label. - Edits a label. Delete Delete All Deletes a label. Deletes all labels. Load Loads labels from a file.
High-performance Embedded Workshop 17. Using the Debugger 17.17.1.4 Deleting a label To delete a label, select the label and choose Delete from the pop-up menu. A confirmation message box appears: If you click OK, the label is removed from the list and the window display is updated. If the message box is not necessary then check the Don’t ask this question again check box. 17.17.1.5 Deleting all labels To delete all the labels from the list, choose Delete All from the pop-up menu.
High-performance Embedded Workshop 17. Using the Debugger 17.17.1.8 Searching for a label Choose Find from the pop-up menu to open the Find Label dialog box. 1. Enter the label name that you wish to find into the Name field or select a label name that you have searched before from the drop-down list box. 2. Enter the address of the label that you wish to find into the Address field or select an address that you have searched before from the drop-down list box. 3.
High-performance Embedded Workshop 17. Using the Debugger 17.17.2.1 C/C++ operators The C/C++ language operators are available: +, -, *, /, &, |, ^, ~, !, >>, <<, %, (, ), <, >, <=, >=, ==, !=, &&, || Buffer_start + 0x1000 #R1 | B'10001101 ((pointer + (2 * increment_size)) & H'FFFF0000) >> D'15 !(flag ^ #ER4) 17.17.2.2 C/C++ expressions Expression examples: Object.value p_Object->value Class::value *value &value array[0] Object.
High-performance Embedded Workshop Select Function Name Set Function Name Counter (1) 17. Using the Debugger Displays the same-name functions or member functions and their detailed information. Name Displays the names of the functions Address Displays the addresses of the functions Displays the function to be set and their detailed information. Name Displays the names of the functions Address Displays the addresses of the functions Displays the number of the functions having the same name.
High-performance Embedded Workshop 17. Using the Debugger The Address list box displays the address ranges used by the Overlay function. Click to select one of the address ranges in the Address list box. The Section Name list box displays the section groups assigned to the selected address range.
High-performance Embedded Workshop 17. Using the Debugger Note: Within the address range used by the Overlay function, the debugging information for the section specified in the Overlay dialog box is referred to. Therefore, the same section of the currently loaded program must be selected in the Overlay dialog box. 17.17.3 Looking at variables This section describes how you can look at variables in the source program.
High-performance Embedded Workshop 17. Using the Debugger To view a tooltip watch on the editor window or disassembly window (in source mode) 1. Open the editor window or disassembly window (in source mode) showing the variable that you want to examine. 2. Rest the mouse cursor over the variable name that you want to examine. A tooltip will appear near the variable containing basic watch information for that variable. 17.17.3.
High-performance Embedded Workshop 17. Using the Debugger Window configuration • This window shows data only when the debugging information available in the load module (*.abs) includes the information on the C/C++ source program. No data is shown in the window if information on the source program is excluded from the debugging information due to optimization by the compiler. No variables declared as macros also can be displayed.
High-performance Embedded Workshop 17. Using the Debugger Options Right-clicking displays a pop-up menu containing available options. A basic operation is allocated to the toolbar. The Toolbar display and Customize toolbar options are also included in the pop-up menu opened by right-clicking on the toolbar.
High-performance Embedded Workshop • 17. Using the Debugger Open the Add Watch dialog box in either of the following ways. o Select the Watch window and press the Insert key. o Right-click within the Watch window and select Add Watch from the pop-up menu. Enter the name of the variable that you wish to watch in the Variable or expression field and click OK. The watch item is added to the Watch window. The scope of the added watch item is Auto by default.
High-performance Embedded Workshop 17. Using the Debugger The Watch window is updated to show the new name. Note: Names of watch items cannot be changed in the following cases. • The user program is running. • Two or more watch items are selected. (4) Expanding a watch item If a watch item is a pointer, array, or structure, then you will see a plus sign (+) expansion indicator to left of its name, this means that you can expand the watch item. To expand a watch item, click on it.
High-performance Embedded Workshop 17. Using the Debugger • In-place edit in the Value column. • Open the Edit Value dialog box in one of the following ways. o Double-click within the Value column. o Press the Enter key on the line of a watch item. o Right-click on the line of a watch item and select Edit Value from the pop-up menu. Enter the new value in the New Value field and click OK. The Watch window is updated to show the new value.
High-performance Embedded Workshop 17. Using the Debugger To set scope of a watch item Select either of the following ways. • In-place edit in the Scope column. Click on the button on the right edge of the list box and select scope from the list. • Open the Set Scope dialog box in either of the following ways. o Double-click within the Scope column. o Right-click on the line of a watch item and select Set Scope from the pop-up menu. 1. Select scope for the variable shown in the Expression field.
High-performance Embedded Workshop 2. 17. Using the Debugger If you have selected a load module name in Scope, select the corresponding file scope from the list in the File Scope section. You can also filter scope names by the string (not case-sensitive) entered in the Filter box before selecting a desired scope name. Note: If the scope for a variable selected in the Watch window does not match the download module, the Scope column on the line of the variable is highlighted.
High-performance Embedded Workshop 17. Using the Debugger (11) Setting real-time update The R mark shown to the left of each variable indicates whether the variable is updated in real-time. A pop-up menu containing the following options is available in the Watch window: Auto Update Auto Update All Delete Auto Update Delete Auto Update All Marks the selected variable with a bold R and updates the variable in real-time. Marks all variables with bold Rs and updates all variables in real-time.
High-performance Embedded Workshop 17. Using the Debugger 3. In the Recording Settings dialog box, specify how to record the history. 4. Select a sheet that you wish to record the history in Recording Sheet. Only one sheet can be used for recording at one time. Recording Sheet only lists the names of the sheets that include watch items to which automatic update has been applied. 5. Enter the file name in File name.
High-performance Embedded Workshop 17. Using the Debugger (14) Changing text colors You can customize the font and text coloring for the Watch window through the Format Views dialog box (the Text category in the table below). It is also possible to use the Format Views dialog box to specify the color for memory with a specific attribute or changed values shown in the Value column of the Watch window. To change the look of the Watch window 1. Select [Setup -> Format Views].
High-performance Embedded Workshop 17. Using the Debugger Options Right-clicking displays a pop-up menu containing available options. A basic operation is allocated to the toolbar. The Toolbar display and Customize toolbar options are also included in the pop-up menu opened by right-clicking on the toolbar. Pop-up Menu Option Edit Value Radix Toolbar Button Macro Recording Function Launches a dialog box to modify the selected variable's value. Hexadecimal - Displays in hexadecimal.
High-performance Embedded Workshop 18. Synchronized Debugging 18. Synchronized Debugging The synchronized debugging system is designed to help with debugging multi-core devices. It allows you to run programs on multiple CPU cores and synchronize common debug operations (Go, step, halt etc.) between the cores. The Synchronized Debug dialog box is the main entry point for configuring and initiating the synchronized debugging system. Options related to synchronized debugging are saved in “SDO” files.
High-performance Embedded Workshop 18.1.1 18. Synchronized Debugging Managing configurations The Current configuration drop list The drop list at the top of the Synchronized debug dialog will have an entry for each configuration file in the Sync directory. In order to change the settings on the dialog to a previously saved configuration you should select the configuration in the drop list.
High-performance Embedded Workshop 3. 18. Synchronized Debugging Click Import. The file will be copied to the Sync directory and the configuration will be added to the drop list where it will be selected and then loaded. To delete configurations In order to delete a configuration, delete the configuration’s file from the Sync directory (before opening the Synchronized Debug dialog box) or follow the following method: 1. Select the configuration you want to delete from the drop list. 2.
High-performance Embedded Workshop Options: Type: Workspace: Session: 18. Synchronized Debugging The Debugger is connected to a platform and it is not running. Break: The Debugger is connected to a platform and it is running. Running: Platform specific option on how the Debugger will be used when synchronized debugging starts. Select “Debug” for normal debugging. Type of platform associated with the Debugger. Will be one of the following: Normal single core platform. Single core: Multi-core platform.
High-performance Embedded Workshop 3. Enter a new unique ID for the Debugger. 4. Click OK. The Debugger’s ID will be updated in the list. It is not possible to modify Debugger IDs when synchronized. Changing a Debugger’s options There are two methods of changing a Debugger’s options. First method: 1. Select the Debugger in the list. 2. Click the Modify button. 3. Select the new options from the drop list. 4. Click OK. Second method: 1. Select the Debugger in the list. 2.
High-performance Embedded Workshop 18.1.3 18. Synchronized Debugging Setting the synchronization options Overview In this context “synchronization” refers to a virtual link from one Debugger/core to another Debugger/core for a specific debug operation (e.g. Go). While debugging is synchronized, these virtual links are examined whenever a debug operation is executed.
High-performance Embedded Workshop 18. Synchronized Debugging Platform settings When debugging a multi-core platform some synchronizations that are normally user configurable may be automatically enabled. If an option check box is checked and grayed out this means that the platform has specified that the operation must always be synchronized. Notes: • Platform settings cannot be overridden by editing the SDO (configuration) file. • Platform settings override your style selection.
High-performance Embedded Workshop 18. Synchronized Debugging Debuggers will be opened in the High-performance Embedded Workshop application from which the Synchronized Debug dialog box was launched. See section 18.2, Using High-performance Embedded Workshop when synchronized for details on how to use Highperformance Embedded Workshop while synchronized. 18.1.
High-performance Embedded Workshop 18. Synchronized Debugging When you right click on a Debugger ID the following menu will be displayed: Reset CPU Go Reset Go Step In Step Out Step Over Halt Program Allow Docking Hide Properties When an operation is selected it will be executed on the selected Debugger(s) only. All synchronizations are ignored when an operation is executed from the Debuggers tab. When debugging a multi-core platform, some operations will be disabled.
High-performance Embedded Workshop Step In Step Over Step Out Connect Download (file load) Initialize Step “Debug->Step In” menu. Step In toolbar button. “step” command. Step “Debug->Step Over” menu. Step Over toolbar button. “step_over” command. Step “Debug->Step Out” menu. Step Out toolbar button. “step_out” command. Connection “Debug->Connect” menu. Connect toolbar button. “connect” command or platform specific command. Download “Debug->Download Modules” menu item.
High-performance Embedded Workshop 18. Synchronized Debugging While synchronized debugging the functionality of the Debug Settings dialog is different. Instead of being able to set all the normally available options it is only possible to change the Download modules which are set in each Debugger’s session. It is possible to use multi select on the left side of the dialog to change the setup of multiple sessions at the same time.
High-performance Embedded Workshop 18.2.3 18. Synchronized Debugging Internal mode functionality General operation When using internal mode all Debuggers are opened in the one High-performance Embedded Workshop application. The state of the GUI can be switched (by various methods) to debug the different open Debuggers.
High-performance Embedded Workshop 18.3 18. Synchronized Debugging Using the command line window when synchronized Overview Two new commands are provided when using synchronized debugging. These allow the Debugger that commands will be executed on to be changed so a command file executed in one Debugger can execute commands on a different Debugger. SET_CORE command Abbreviation: SMC Description: Sets the current Debugger from the perspective of the command line ECX.
High-performance Embedded Workshop 18. Synchronized Debugging “OPEN_TEST_SUITE” “REFRESH_SESSION” “RUN_TEST” “SET_CORE” “SHOW_ALL_CORE” “SUBMIT” 18.4 Glossary of terms Term Core Debugger Debugger ID Internal Debugger ID Internal mode Local Debugger Multi-core platform Parallel mode Platform SDO file Definition An individual CPU core on a multi-core platform.
High-performance Embedded Workshop 19. Technical Support 19. Technical Support 19.1 Viewing the version information The version information of the High-performance Embedded Workshop can be viewed. To view the version information 1. Select [Help -> About High-performance Embedded Workshop]. The About High-performance Embedded Workshop dialog box opens. Information including the copyright and version number is shown in this dialog box. 2.
High-performance Embedded Workshop 19.3 19. Technical Support Creating a bug report Occasionally you may experience some unforeseen problems with the High-performance Embedded Workshop application. If a problem does occur that results in an application crash the High-performance Embedded Workshop bug tracking program will be invoked automatically. This allows you to compile a bug report and this can then be sent to your technical support contact in a variety of ways.
High-performance Embedded Workshop Reference Reference REJ10J1837-0100 Rev.1.00 Nov.
High-performance Embedded Workshop 1. Main Menus 1. Main Menus 1.
High-performance Embedded Workshop 1. Main Menus Find CTRL+F - Finds text in the current file. Find In Files F4 - Finds text in multiple files. Replace Goto Line Match Braces CTRL+H CTRL+G CTRL+SHIFT+M - Replaces text in the current file. Jumps to a line in a file. Finds a matching brace.
High-performance Embedded Workshop 1. Main Menus Notes: *1. Operations in some windows can be recorded as High-performance Embedded Workshop command-line commands by the macro-recording support facility. A macro record icon ( ) in the Macro Recording column of a menu option indicates that this function can be recorded into a macro file. For details, see section 15.5.1, Recordable functions (common to all High-performance Embedded Workshop products).
High-performance Embedded Workshop 1. Main Menus Build Build Phase Build Configurations Linkage Order - - - Generate Makefile - - - - exclusion. Adds, removes and modifies a phase. Selects the current configuration. Customizes the High-performance Embedded Workshop linkage order. Generates a makefile. Notes: *1. Operations with some menu options can be recorded as High-performance Embedded Workshop command-line commands by the macro-recording support facility.
High-performance Embedded Workshop Verify Memory *2 Download Modules Unload Modules - 1. Main Menus Verifies file contents against memory contents. Downloads the object program. Unloads the object program. - Notes: *1. Operations with some menu options can be recorded as High-performance Embedded Workshop command-line commands by the macro-recording support facility. A macro record icon ( ) in the "Macro Recording" column of a menu option indicates that this function can be recorded into a macro file.
High-performance Embedded Workshop 1. Main Menus Notes: *1. Custom menu options to which recorded macros have been assigned are shown between Stop Macro and system tools. *2. Further menu options for external tools added by customizing the Tools menu are shown under the menu options for system tools. 1.9 Menu Test 1.10 Test Menu Options Menu Option Shortcut Key Toolbar Button Function Create New Test Suite Creates a new blank test suite so you can begin adding and running tests.
High-performance Embedded Workshop 2. Windows 2.
High-performance Embedded Workshop 3. Commands 3. Commands 3.
High-performance Embedded Workshop SET_SOURCE_SOFT_BREAK SLEEP STATE_DISASSEMBLY_SOFT_BREAK STATE_SOURCE_SOFT_BREAK STEP STEP_MODE STEP_OUT STEP_OVER STEP_RATE SUBMIT TCL TOOL_INFROMATION UPDATE_ALL_DEPENDENCIES *1 SSB TDB TSB ST SM SP SO SR SU TO UD 3. Commands Sets or deletes a software breakpoint at the source level. Delays command execution. Enables or disables a software breakpoint at the disassembly level. Enables or disables a software breakpoint at the source level.
High-performance Embedded Workshop 3. Commands Command Line Operating Commands Command Name ! ASSERT AUTO_COMPLETE ERASE HELP LOG SLEEP SUBMIT TCL Abbreviation AC ER HE LO SU - Description Comment. Checks if an expression is true or false. Switches the auto-completion. Clears the Command Line window. Displays help for Command Line or help on a command. Controls command output logging. Delays command execution. Executes a file of commands. Turns TCL commands on or off.
High-performance Embedded Workshop 3. Commands Software Break Setting Commands (Available when the debugger is connected) Command Name SET_DISASSEMBLY_SOFT_BREAK SET_SOURCE_SOFT_BREAK STATE_DISASSEMBLY_SOFT_BREAK STATE_SOURCE_SOFT_BREAK Abbreviation SDB SSB TDB TSB Description Sets or deletes a software breakpoint at the disassembly level. Sets or deletes a software breakpoint at the source level. Enables or disables a software breakpoint at the disassembly level.
High-performance Embedded Workshop 4. Regular Expressions 4. Regular Expressions The High-performance Embedded Workshop editor allows you to include special characters in search strings when performing a find, replace or find in files operation. These characters are listed in the table below and explained underneath. Character ? * \n \t [] \ Function This character matches any single character, except the newline character. For example, t?p matches “top”, “tip” but not “trap”.
High-performance Embedded Workshop 5. Placeholders 5. Placeholders This section describes how to use the placeholders, a feature provided by several of the High-performance Embedded Workshop components. 5.1 What is a placeholder? A placeholder is a special string, inserted into text, which is replaced at some subsequent time for the actual value. For example, one of the High-performance Embedded Workshop placeholders is $(FULLFILE) which represents a file with a full path.
High-performance Embedded Workshop 5. Placeholders Example 3 1. Place the insertion cursor at the point you would like to insert the placeholder. 2. Select the required placeholder from the drop-down list box. 3. Click Insert. Example 4 1. Alternatively, if you know the placeholder already, type it into the field directly. Ensure that you type the placeholder name in uppercase and that it is preceded by ‘$(’ and followed by ‘)’.
High-performance Embedded Workshop $(PASSWORD) $(VCDIR) $(COMMENT) $(LINE) User password (Version control) “Virtual” version control directory Comment (Version control) Line number of an error/warning 5. Placeholders 214436 “c:\project” is mapped to “x:\vc\project”. “Please Enter Comment” dialog box opens. 12 In the table above, we are assuming that: • a file path is “c:\workspace\project\file.src”. • a workspace named “workspace” is located at “c:\workspace”.
High-performance Embedded Workshop 6. I/O File Format 6. I/O File Format High-performance Embedded Workshop formats the IO window based on information it finds in an I/O Register definition file. When you select a debugging platform, High-performance Embedded Workshop will look for a “.IO” file corresponding to the selected device and load it if it exists. This file is a formatted text file that describes the I/O modules and the address and size of their registers.
High-performance Embedded Workshop REJ10J1837-0100 Rev.1.00 Nov. 16, 2008 409 6.
High-performance Embedded Workshop 7. Symbol File Format 7. Symbol File Format In order for High-performance Embedded Workshop to be able to understand and decode the symbol file correctly, the file must be formatted as a Pentica-B file: 1. The file must be a plain ASCII text file. 2. The file must start with the word “BEGIN”. 3. Each symbol must be on a separate line with the value first, in hexadecimal terminated by an “H”, followed by a space then the symbol text. 4.
High-performance Embedded Workshop 8. Keyboard Shortcuts 8. Keyboard Shortcuts All major commands in the High-performance Embedded Workshop application can be driven by the keyboard. Below is a list of all keyboard commands in the application.
High-performance Embedded Workshop CTRL+SHIFT N CTRL+SHIFT CTRL+SHIFT CTRL+SHIFT CTRL+SHIFT CTRL+SHIFT CTRL+SHIFT CTRL+SHIFT S T U V Y F3 SPACEBAR CTRL+SHIFT CTRL+SHIFT CTRL+SHIFT CTRL+SHIFT CTRL+SHIFT SHIFT SHIFT SHIFT SHIFT SHIFT SHIFT SHIFT SHIFT SHIFT SHIFT SHIFT SHIFT SHIFT SHIFT SHIFT SHIFT+ALT None None None None None None None None None None None None None None None None None None None None None None None None None TAB HOME END LEFT ARROW RIGHT ARROW F1 F2 F3 F5 F8 F10 F11 F12 DELETE ESC TAB HOM
High-performance Embedded Workshop 9. Drag and Drop in the Debugger 9. Drag and Drop in the Debugger When using the High-performance Embedded Workshop debugger it is possible for each debug component to interact with the others. This can be achieved simply by dragging objects from one view to another. Some examples are listed below 1. It is possible to drag a label from the labels view onto other debug views.
High-performance Embedded Workshop 10. Using Labels to View Your Code 10. Using Labels to View Your Code Labels are a useful way of navigating through your debug module. It is possible to use labels in any edit field that allows addresses. If you enter a label in such a field then the built in evaluator will check the label and then convert it to an address. This allows you to enter evaluations such as "_main+100" or "_MyFunction+100".
High-performance Embedded Workshop 10. Using Labels to View Your Code In this dialog box, the labels are initially listed in alphabetical order and their addresses are displayed on the right. If you click a column header (of names or addresses), the labels will be sorted by the label name or the address value. The Filter edit box can be used to help you search for a specific label in the list.
High-performance Embedded Workshop 11. Integrated Toolbars in a Components View 11. Integrated Toolbars in a Components View The High-performance Embedded Workshop V.4.0 onwards has the capability to include a toolbar in a views client area. This toolbar allows the views functionality to be accessed quickly from this integrated toolbar. Various views in the High-performance Embedded Workshop system have this functionality. One example is the Difference view.
High-performance Embedded Workshop 11. Integrated Toolbars in a Components View The final menu option named "Customize" launches the Customize Toolbar dialog box. This is shown below: This dialog box allows you to modify the displayed buttons and change the ordering. The list on the left named Available toolbar buttons displays all toolbar buttons not currently in use on the toolbar. The list named Current toolbar buttons displays all of the toolbars currently added to the components' toolbar.
High-performance Embedded Workshop 12. To Build in Toolchain for High-performance Embedded Workshop V.1.x 12. To Build in Toolchain for High-performance Embedded Workshop V.1.x When a project created in High-performance Embedded Workshop V.1.x is used without upgrading to new toolchain that has been registered in High-performance Embedded Workshop V.2.x onwards, the toolchain for the old version must be registered.
High-performance Embedded Workshop 13. HMAKE User Guide 13. HMAKE User Guide 13.1 Command line The following section describes the command line that should be used to execute the hmake program on a file using none or more of the available options. Basic structure The command line must be of the following syntax: hmake If a file is specified without an extension then “.mak” will be appended to it.
High-performance Embedded Workshop 13. HMAKE User Guide There follows some examples of valid variable declarations: EXECUTABLE = c:\dir\prog.exe OUTPUT = c:\dir2\file1.out INPUT = c:\dir2\file1.c DEPEND = c:\dir2\file2.h \ c:\dir2\file3.h \ c:\dir2\file4.h In order to use a variable later in the hmake file write the variable name with “$(” added to the front and “)” added to the back. The variable name (along with the “$()” characters) will be substituted with the variables value.
High-performance Embedded Workshop 13. HMAKE User Guide Special commands There are two special commands which can be used in a description block. The "cd" command changes the current directory and the "set" command sets an environment variable which will then be in use for the duration of the make file execution. Both are used in the same way as the DOS equivalents.
High-performance Embedded Workshop 13.4 13. HMAKE User Guide Comments A ‘#’ character signifies a comment. When this character appears as the first character on a line the rest of the line (up until the next new line character) is ignored. There follows examples of valid comments: # My hmake file # Variable declaration OUTPUT= c:\dir1\file1.obj # Descriptor $(OUTPUT) : c:\dir1\file1.c c:\dir1\file1.h → set VAR1=value1 → gcc c:\dir1\file1.c A comment must occupy its own line in the hmake file.
High-performance Embedded Workshop V.4.05 User's Manual Publication Date: Nov. 16, 2008 Rev.1.00 Published by: Sales Strategic Planning Div. Renesas Technology Corp. Edited by: Microcomputer Tool Development Department Renesas Solutions Corp. © 2008. Renesas Technology Corp. and Renesas Solutions Corp., All rights reserved. Printed in Japan.
High-performance Embedded Workshop V.4.
