User ManualTable of ContentsCover1Notes regarding these materials2Introduction3Contents51. Overview141.1 Workspaces, projects and files141.2 Main window141.2.1 Title bar151.2.2 Menu bar151.2.3 Toolbars161.2.4 Workspace window181.2.5 Editor window211.2.6 Output window221.2.7 Status bar251.3 Help system251.4 Launching the High-performance Embedded Workshop261.5 Creating a new workspace261.6 Opening a workspace271.7 Using old workspaces281.8 Saving a workspace281.9 Closing a workspace291.10 Exiting the High-performance Embedded Workshop291.11 Component system overview291.12 Management information files of High-performance Embedded Workshop291.13 Overview of Configurations and Sessions301.14 Overview of Macro-Recording Support facility and Test Support facility341.14.1 Example of test procedures371.14.2 Step 1: Recording a macro381.14.3 Step 2: Editing a macro (viewing records)401.14.4 Step 3: Playing a macro411.14.5 Step 4: Creating a test suite411.14.6 tep 5: Editing a test suite411.14.7 Step 6: Creating a test image file431.14.8 Step 7: Modifying the program before the test451.14.9 Step 8: Viewing the test result (unmatched)461.14.10 Step 9: Modifying the program back and executing the test again471.14.11 Step 10: Viewing the test result (matched)472. Build Basics482.1 The build process482.2 Configuring the Projects tab of the Workspace window492.3 Project files512.3.1 Adding files to a project522.3.2 Drag and drop of files and folders532.3.3 Removing files from a project542.3.4 Excluding a project file from build552.3.5 Including a project file in build562.4 User folders in the workspace562.5 File extensions and file groups572.5.1 Associating an application with a file group582.5.2 Creating a new file extension and file group602.5.3 Creating a new file extension612.6 Setting build options622.7 Build configurations622.7.1 Selecting a build configuration632.7.2 Adding a new build configuration632.7.3 Removing a build configuration632.8 Building a project642.8.1 Building individual files642.8.2 Building a project642.8.3 Building multiple projects652.8.4 Stopping tool execution652.8.5 Deleting intermediate and output files produced in building662.8.6 Configuring the Build tab of the Output window672.8.7 Controlling the content of the Build tab of the Output window692.8.8 Displaying out of date files in the Workspace window692.9 File dependencies702.10 Configuring the Workspace window732.11 Inserting a project into the workspace742.12 Setting the current project752.13 Specifying dependencies between projects762.14 Removing a project from the workspace772.15 Relative projects paths in the workspace773. Advanced Build Features783.1 The build process revisited783.1.1 What is a build?783.2 Creating a custom build phase793.3 Ordering build phases833.3.1 Build Order tab833.3.2 Build File Order tab863.3.3 File Mappings tab873.4 Setting custom build phase options883.4.1 Options tab883.4.2 Output Files tab893.4.3 Dependent Files tab893.5 Controlling the build903.6 Logging build output913.7 Changing toolchain version913.8 Generating a makefile923.9 Using a makefile inside the High-performance Embedded Workshop system943.10 Customizing the High-performance Embedded Workshop linkage order964. Using the Editor994.1 Editor window994.2 Working with multiple files1004.3 Standard file operations1004.3.1 Creating a new file1004.3.2 Editing a file1004.3.3 Saving a file1014.3.4 Opening a file1024.3.5 Closing files1034.3.6 Pop-up menu to close the window1044.4 Searching and navigating through files1044.4.1 Finding text1044.4.2 Finding text in multiple files1054.4.3 Replacing text1074.4.4 Jumping to a specified line1084.5 Bookmarks1084.6 Printing a file1094.7 Configuring text layout1094.7.1 Page set-up1094.7.2 Changing tabs1104.7.3 Auto indentation1114.8 Splitting a window1114.9 Changing the editor font1124.10 Syntax coloring1124.10.1 Changing text colors1134.10.2 Creating new keywords1134.10.3 Enabling/disabling syntax coloring1144.11 Templates1154.11.1 Defining a template1154.11.2 Deleting a template1174.11.3 Inserting a template1174.12 Brace matching1174.13 Setting the read-only attribute for a file1184.14 Preventing modification of files while debugging1184.15 Managing the editor columns1184.16 Showing/hiding the column header1194.17 Opening a file within the editor1204.18 Tooltip watch1204.19 Evaluate an expression1215. Tools Administration1225.1 Tool locations1225.2 High-performance Embedded Workshop registration files1235.3 Registering a component1245.4 Unregistering a component1255.5 Viewing and editing component properties1255.6 Technical support1275.7 Using On-Demand components1285.8 Custom project types1296. Customizing the Environment1316.1 Customizing the toolbars1316.2 Customizing the Tools menu1336.3 Using custom placeholders1346.4 Using the workspace and project log facilities1356.5 Configuring the help system1366.6 Keyboard shortcut customization1376.7 Scope of a control in the setup1386.7.1 Scope of a control in the Customize dialog box1386.7.2 Scope of a control in the Options dialog box1396.8 Specifying workspace options1396.8.1 Opening the last workspace at start-up1396.8.2 Restoring files on opening a workspace1396.8.3 Displaying workspace information on opening a workspace1406.8.4 Saving the workspace before executing any tools1406.8.5 Prompting before saving a workspace1406.8.6 Prompting before saving a session1416.8.7 Enabling auto-backup facilities1416.8.8 Setting the projects to load on workspace open1426.8.9 Specifying a default directory for new workspaces1426.9 Using an external editor1436.10 Customizing the font in your views1456.11 Using the virtual desktop1467. Version Control1477.1 Selecting a Version Control System1487.2 Importing and exporting a set-up1498. Using the Custom Version Control System1508.1 Defining Version Control menu options1508.1.1 System-defined menu options1518.1.2 User-defined menu options1528.2 Defining Version Control commands1538.3 Specifying arguments1548.4 Specifying comments1548.5 Executable return code1548.6 Specifying file locations1558.7 Specifying file locations example1568.8 Specifying environment1578.9 Controlling execution of a Version Control System1578.10 Specifying a user name and password1588.11 Usage example of the Custom Version Control System1598.11.1 Connecting the High-performance Embedded Workshop with RCS1598.11.2 Connecting the High-performance Embedded Workshop with CVS1649. Using Visual SourceSafe1719.1 Attaching Visual SourceSafe to a workspace1719.2 Visual SourceSafe commands1739.2.1 Adding files to Visual SourceSafe1749.2.2 Removing files from Visual SourceSafe1759.2.3 Getting read-only copy of files from Visual SourceSafe1759.2.4 Checking out writable copy of files from Visual SourceSafe1769.2.5 Checking in writable copy of files into Visual SourceSafe1779.2.6 Viewing the status of files in Visual SourceSafe1789.2.7 Undoing a check out command in Visual SourceSafe1789.2.8 Viewing the history of files in Visual SourceSafe1799.3 Visual SourceSafe command options1809.4 Version Control setup1809.5 Specifying file locations1809.6 Adding Visual SourceSafe commands18210. Sharing Projects by Network Facilities18410.1 Sharing projects by network facilities in a PC with Windows® XP Service Pack 2 or later18510.2 Enabling network facilities to share projects18710.3 Setting the administrator user's password18710.4 Adding new users to the system18810.5 Changing your password18910.6 Note on using the network facilities to share projects18911. Comparing Files19111.1 Opening the Difference window19112. Navigation Facilities19412.1 C function and #define navigation component19612.2 C++ navigation component19612.3 Jump to a definition from the editor19812.4 Drag and drop navigation items19912.5 Smart edit capability20013. Map20213.1 Managing section settings20313.1.1 Opening the Map Section Information window20313.1.2 Entering/exiting the edit mode20613.1.3 Adding a section group20713.1.4 Adding a section20713.1.5 Adding an overlay group20813.1.6 Automatically registering the unregistered section20813.1.7 Editing a selected item20913.1.8 Setting the primary section20913.1.9 Setting a memory map21013.1.10 Automatically allocating the memory resource21013.1.11 Printing out the section settings tree21113.1.12 Viewing unallocated areas21113.1.13 Viewing sections of size 021113.1.14 Viewing the source code for the address21113.1.15 Printing out the section list21213.2 Viewing symbols21213.2.1 Opening the Map Symbol Information window21213.2.2 Printing out the map list21413.2.3 Finding symbols21413.2.4 Filtering the symbol information21413.2.5 Viewing the source code for the address21513.2.6 Printing out the symbol information21614. Using the Command Line21714.1 Opening the Command Line window21714.2 Specifying a batch file22014.3 Executing a batch file22114.4 Stopping command execution22114.5 Specifying a log file22114.6 Starting or stopping logging22214.7 Entering a full path to the file22214.8 Pasting a placeholder22214.9 Selecting all the window contents22214.10 Copying the selection onto the clipboard22214.11 Cutting out the selection to the clipboard22214.12 Pasting the contents of the clipboard22214.13 Clearing the contents of the Command Line window22314.14 Undoing the last operation22314.15 Checking brace matching22314.16 Resetting the status of a batch file22314.17 Single-stepping in a batch file22414.18 Setting a breakpoint in a batch file22515. Using the Macro-Recording Support Facility22615.1 Macro menu and toolbar22615.2 Using the Macro dialog box22715.3 Importing a macro file with existing macros22915.4 Recording a macro22915.5 Functions that can be recorded into macro files23015.5.1 Recordable functions (common to all High-performance Embedded Workshop products)23015.5.2 Recordable functions (dependent on the debugger)23415.6 Playing a macro24215.7 Editing a macro24215.8 Assigning a macro24315.9 Configuring the Macro tab of the Output window24416. Using the Test Support Facility24516.1 Creating a test suite24516.2 Opening and closing test suites24616.3 Editing a test suite24616.4 Adding tests to the test suite24816.5 Creating a test image file24916.6 Functions that can be saved as test-image data into test-image files25016.6.1 Functions that can be saved into test-image files (common to all High-performance Embedded Workshop products)25116.6.2 Functions that can be saved into test-image files (dependent on the debugger)25616.7 Comparing a test image file26816.8 Running tests26916.9 Using the test browser27016.10 Configuring the Test pane of the Workspace window27116.11 Configuring the Test tab of the Output window27217. Using the Debugger27417.1 Preparations for debugging27417.1.1 Compiling for debug27417.1.2 Selecting a debugging platform27417.1.3 Editing project configuration28517.1.4 Configuring the debugging platform28517.1.5 Downloading modules29117.1.6 Debugger sessions30317.2 Viewing a program30817.2.1 Opening the Editor window30917.2.2 Opening the Disassembly window31517.2.3 Looking at the current PC position32117.2.4 Highlighting the line at the PC32117.3 Operating memory32217.3.1 Opening the Memory window32217.3.2 Modifying memory contents32417.3.3 Selecting a memory range32517.3.4 Filling an area of memory with constant data32617.3.5 Copying an area of memory32617.3.6 Comparing the memory contents32717.3.7 Testing an area of memory32817.3.8 Saving memory contents in a text file32817.3.9 Finding a value in memory32917.3.10 Changing the display address32917.3.11 Changing the scroll area33017.3.12 Starting address to value of the register33017.3.13 Tracking the stack pointer position33017.3.14 Changing the program display position immediately after downloading33117.3.15 Refreshing the Memory window33117.3.16 Disabling refresh of the Memory window33117.3.17 Regularly refreshing the Memory window33117.3.18 Specifying the refresh interval33217.3.19 Changing the data length33217.3.20 Changing the radix33217.3.21 Changing the code33317.3.22 Setting the layout33317.3.23 Changing the number of digits displayed33317.3.24 Switching display or non-display of measurement result33317.3.25 Saving an area of memory33417.3.26 Loading a memory area from a file33417.3.27 Splitting up the window display33517.3.28 Verifying a memory area33517.3.29 Changing text colors33617.4 Displaying memory contents as an Image33617.4.1 Opening the Image window33717.4.2 Regularly refreshing the Image window34017.4.3 Refreshing the Image window34017.4.4 Specifying the refresh interval34017.4.5 Viewing Images as Consecutive Frames34117.4.6 Displaying the pixel information34317.5 Displaying memory contents as Waveforms34417.5.1 Opening the Waveform window34417.5.2 Regularly refreshing the Waveform window34517.5.3 Refreshing the Waveform window34617.5.4 Specifying the refresh interval34617.5.5 Zoom-in display34617.5.6 Zoom-out display34617.5.7 Resetting the zoom display34617.5.8 Setting the zoom magnification34617.5.9 Setting the horizontal scale34717.5.10 Non-display of cursor34717.5.11 Displaying the sampling information34717.6 Looking at I/O memory34717.6.1 Opening the IO window34817.6.2 Expanding an I/O register display34917.6.3 Modifying the values of I/O registers34917.6.4 Refreshing the IO window35017.6.5 Disabling refresh of the IO window35017.6.6 Selecting the I/O register(s) to view35017.6.7 Loading an I/O file35117.6.8 Printing the currently displayed contents35217.6.9 Saving the currently displayed contents35217.6.10 Finding an I/O register35217.6.11 Finding the next35217.7 Looking at registers35317.7.1 Opening the Register window35317.7.2 Changing the register display radix35417.7.3 Switching Register Bank35417.7.4 Setting the layout35517.7.5 Choosing a register to be displayed35517.7.6 Modifying register contents35617.7.7 Setting the flag value35717.7.8 Splitting up the window display35717.7.9 Saving register contents35717.7.10 Refreshing the Register window35717.7.11 Disabling refresh of the Register window35717.7.12 Using register contents35817.7.13 Changing text colors35817.8 Resetting the target MCU35817.9 Setting PC to the address at cursor35817.10 Initializing the debugging platform35817.11 Connecting/disconnecting the debugging platform35917.12 Executing your program35917.12.1 Continuing run35917.12.2 Running from reset35917.12.3 Running program, ignoring any breakpoints36017.12.4 Running to cursor36017.12.5 Running from a specified address36017.12.6 Continuing execution to a main function at a reset36117.12.7 Single step36117.12.8 Multiple steps36217.13 Stopping your program36317.13.1 Stopping the program by the Halt toolbar button36317.13.2 Standard breakpoints (PC breakpoints)36317.14 Viewing the current status36417.15 Viewing the function call history36517.15.1 Opening the Stack Trace window36517.15.2 Viewing the source program36617.15.3 Specifying the view36617.16 Using an external debugger36617.16.1 Configuring the Hitachi Debugging Interface to integrate with High-performance Embedded Workshop36717.16.2 Configuring the PD debugger to integrate with High-performance Embedded Workshop36717.16.3 Configuring an external debugger to integrate with High-performance Embedded Workshop36817.17 Debugging functions dependent on the debugger36917.17.1 Looking at labels36917.17.2 Elf/Dwarf2 support37217.17.3 Looking at variables37618. Synchronized Debugging38918.1 The Synchronized Debug dialog box38918.1.1 Managing configurations39018.1.2 Defining the synchronized Debuggers39118.1.3 Setting the synchronization options39418.1.4 Setting the memory update option39518.1.5 Synchronized debugging mode39518.1.6 Start synchronized debugging39518.1.7 Update synchronized debugging39618.1.8 Stop synchronized debugging39618.2 Using High-performance Embedded Workshop while synchronized39618.2.1 Common functionality39618.2.2 Parallel mode functionality39918.2.3 Internal mode functionality40018.3 Using the command line window when synchronized40118.4 Glossary of terms40219. Technical Support40319.1 Viewing the version information40319.2 Check for updates40319.3 Creating a bug report404Reference4051. Main Menus4061.1 File Menu Options4061.2 Edit Menu Options4061.3 View Menu Options4071.4 Project Menu Options4081.5 Build Menu Options4081.6 Debug Menu Options4091.7 Setup Menu Options4101.8 Tools Menu Options4101.9 Test Menu Options4111.10 Window Menu Options4111.11 Help Menu Options4112. Windows4123. Commands4133.1 Command List (Alphabetic Order)4133.2 Command List (Listed by Function)4144. Regular Expressions4175. Placeholders4185.1 What is a placeholder?4185.2 Inserting a placeholder4185.3 Available placeholders4195.4 Placeholder tips4206. I/O File Format4217. Symbol File Format4238. Keyboard Shortcuts4249. Drag and Drop in the Debugger42610. Using Labels to View Your Code42711. Integrated Toolbars in a Components View42912. To Build in Toolchain for High-performance Embedded Workshop V.1.x43113. HMAKE User Guide43213.1 Command line43213.2 File syntax43213.3 Description blocks43313.4 Comments43513.5 Message commands435Colophon436Size: 3.85 MBPages: 437Language: EnglishOpen manual