Hitachi, Ltd. HS6400DIIW2SE IMPORTANT INFORMATION READ
|
|
|
Top Searches for this datasheet
Hitachi Debugging Interface User's Manual
Hitachi, Ltd.
HS6400DIIW2SE
IMPORTANT INFORMATION
READ FIRST
READ this user's manual before using Hitachi Debugging Interface (hereafter, called HDI). KEEP user's manual handy future reference. attempt system until fully understand mechanism. Target User System: This system should only used those have carefully read thoroughly understood information restrictions contained user's manual. attempt system until fully understand mechanism. highly recommended that first-time users instructed users that well versed operation system. Purpose HDI: This system software hardware development tool systems employing Hitachi microcomputer. This system must only used above purpose. Improvement Policy: Hitachi, Ltd. (including subsidiaries, hereafter collectively referred Hitachi) pursues policy continuing improvement design, performance, safety system. Hitachi reserves right change, wholly partially, specifications, design, user's manual, other documentation time without notice. Figures: Some figures this user's manual show items different from your actual system. Other Important Things Keep Mind: Examples described herein meant merely indicate characteristics performance Hitachi's semiconductor products. Hitachi assumes responsibility intellectual property claims other problems that result from applications based examples described herein. license granted implication otherwise under patents other rights third party Hitachi. Rights Reserved: This user's manual this system copyrighted rights reserved Hitachi. part this user's manual, part, reproduced duplicated form, hardcopy machine-readable form, means available without Hitachi's prior written consent. Trademarks: products brand names used manual trademarks registered trademarks their respective companies.
Preface
About this Manual
This manual explains Hitachi Debugging Interface (HDI) Version Hitachi microcomputer development tools. following section will provide brief Introduction debugging interface list features. System Overview describes different software modules make system which modules needed specific configuration. different parts user interface described some common features explored. following sections Preparing Debug, Looking Your Program, Executing Your Program, Stopping Your Program, Looking Variables, Working with Memory, Configuring User Interface provide "how guide using debugging. next sections Menus Windows give depth reference information about operation facilities available from these respective areas. This manual assumes that used English version Microsoft Windows95. separate Debugging Platform User's Manual will typically provide: Setting section that informs about installing debugging platform's hardware software your verifying that components have been correctly installed. Tutorial section that takes through available features using some sample code. Reference section that describes user interface that specific that debugging platform; example, editing breakpoints, configuring trace acquisition, etc.
Assumptions
assumed that reader competent knowledge programming language, assembly-language mnemonics processor being debugged experienced using Microsoft Windows applications compatible computers.
Hitachi Debugging Interface User Manual
Document Conventions
This manual uses following typographic conventions: Table Typographic Conventions CONVENTION MEANING
[Menu->Menu Option] Bold text with `->' used indicate menu options example, [File->Save As.] FILENAME.C "enter this string" Key+Key Uppercase names used indicate file names. Used indicate text that must entered (excluding quotes). Used indicate required presses. example, Ctrl+N means press Ctrl then, while holding Ctrl down, press key. When this symbol used, always located left hand margin. indicates that text immediate right describing "how something.
(The "how symbol)
Contents
Introduction Features System Overview. User Interface. 2.1.1 Menu Bar. 2.1.2 Toolbar 2.1.3 Status Bar. 2.1.4 Pop-Up Menus. Data Entry 2.2.1 Operators 2.2.2 Data Formats. 2.2.3 Precision. 2.2.4 Expression Examples 2.2.5 Symbol Format 2.2.6 Symbol Examples. Help. 2.3.1 Context Sensitive Help Preparing Debug Compiling Debug.11 Selecting Debugging Platform Configuring Debugging Platform 3.3.1 Setup.12 3.3.2 Mapping.12 3.3.3 Status Downloading Program 3.4.1 Selecting File Type Looking Your Program Viewing Code 4.1.1 Viewing Assembly-Language Code.18 4.1.2 Modifying Assembly-Language Code
Hitachi Debugging Interface User Manual
4.1.3 Displaying Source Code.20 4.1.4 Displaying Mixed Code Looking Symbols 4.2.1 Listing Symbols 4.2.2 Finding Symbol.21 4.2.3 Finding Again 4.2.4 Adding Symbols.22 4.2.5 Adding Symbol from Program Window 4.2.6 Modifying Symbols 4.2.7 Deleting Symbols.23 4.2.8 Deleting Symbols.24 4.2.9 Loading Symbol File 4.2.10 Saving Symbol File.25 4.2.11 Symbol File Format Looking Specific Address.26 4.3.1 Looking Current Program Counter Address Finding Text Looking Text File 4.5.1 Opening Text Window 4.5.2 Copying Text 4.5.3 Finding Text Working with Memory Looking Area Memory.31 5.1.1 Displaying Memory Bytes.32 5.1.2 Displaying Memory Words 5.1.3 Displaying Memory Longwords.32 5.1.4 Displaying Memory Single-Precision Floating Point.33 5.1.5 Displaying Memory Double-Precision Floating Point.33 5.1.6 Displaying Memory ASCII 5.1.7 Looking Different Area Memory Modifying Memory Contents 5.2.1 Quick Edit.35
5.2.2 Full Edit Finding Value Memory Filling Area Memory with Value.37 5.4.1 Selecting Memory Range.37 5.4.2 Filling Range.37 Moving Area Memory Testing Area Memory Saving Area Memory Loading Area Memory.41 Verifying Area Memory Executing Your Program.43 Running from Reset.43 Continuing Run.43 Running Cursor.44 Running Several Points Single Step.45 6.5.1 Stepping into Function 6.5.2 Stepping over Function Call.45 Stepping Function Multiple Steps.46 Stopping Your Program Halting Execution Program Breakpoints Breakpoints) 7.2.1 Clearing Program (PC) Breakpoints.48 Breakpoints Window.49 7.3.1 Adding Breakpoint 7.3.2 Modifying Breakpoint 7.3.3 Deleting Breakpoint 7.3.4 Deleting Breakpoints.50 Disabling Breakpoints 7.4.1 Disabling Breakpoint 7.4.2 Enabling Breakpoint.51
Hitachi Debugging Interface User Manual
Temporary Breakpoints Hardware Breakpoints(Event) Looking Variables Instant Watch Using Watch Items 8.2.1 Adding Watch 8.2.2 Expanding Watch 8.2.3 Changing Watch Item's Value.58 8.2.4 Deleting Watch Looking Local Variables.59 Looking Registers 8.4.1 Modifying Register Contents 8.4.2 Using Register Contents Looking I/O.62 8.5.1 Opening Registers Window 8.5.2 Expanding Register Display 8.5.3 Modifying Register Contents 8.5.4 Register Files.64 Selecting Functions Displaying Functions.67 Specifying Functions 9.2.1 Selecting Function 9.2.2 Deleting Function.68 9.2.3 Setting Function.68 Configuring User Interface 10.1 Arranging Windows.69 10.1.1 Minimizing Windows 10.1.2 Arranging Icons.70 10.1.3 Tiling Windows 10.1.4 Cascading Windows 10.2 Locating Currently Open Windows.71 10.2.1 Locating Next Window
10.2.2 Locating Specific Window.71 10.3 Enabling/Disabling Status Bar.72 10.4 Enabling/Disabling Toolbar 10.5 Customizing Toolbar.73 10.5.1 Button Categories 10.5.2 Adding Button Toolbar.73 10.5.3 Positioning Button Toolbar 10.5.4 Removing Button from Toolbar 10.6 Customizing Fonts 10.7 Saving Session.75 10.8 Loading Session 10.9 Setting Options.76 10.10 Setting Default Radix Menus.79 11.1 File 11.1.1 Load Program.79 11.1.2 Save Memory. 11.1.3 Verify Memory. 11.1.4 Save Session.80 11.1.5 Load Session. 11.1.6 Save Session As.80 11.1.7 Initialise 11.1.8 Exit 11.2 Edit.81 11.2.1 Cut.81 11.2.2 Copy.81 11.2.3 Paste 11.2.4 Find 11.2.5 Line 11.2.6 Fill Memory.82 11.2.7 Move Memory.82 11.2.8 Test Memory.82
viii Hitachi Debugging Interface User Manual
11.2.9 Update Memory 11.3 View 11.3.1 Toolbar 11.3.2 Status Bar.82 11.3.3 Breakpoint Window.82 11.3.4 Command Line Window.83 11.3.5 Register Window.83 11.3.6 Local Variable Window 11.3.7 Memory Mapping Window 11.3.8 Memory Window.83 11.3.9 Performance Analysis Window 11.3.10 Program Window. 11.3.11 Register Window.84 11.3.12 Status Window.84 11.3.13 Text Window.84 11.3.14 Trace Window.84 11.3.15 Watch Window 11.4 11.4.1 11.4.2 Reset 11.4.3 Cursor.85 11.4.4 Run.85 11.4.5 Step In.85 11.4.6 Step Over 11.4.7 Step 11.4.8 Step.85 11.4.9 Halt Program 11.4.10 Cursor.86 11.4.11 Reset CPU.86 11.5 Setup.86 11.5.1 Options. 11.5.2 Radix
11.5.3 Customise.86 11.5.4 Select Platform. 11.5.5 Configure Platform.87 11.6 Tools 11.6.1 Symbols.87 11.6.2 Evaluate. 11.7 Window 11.7.1 Cascade 11.7.2 Tile 11.7.3 Arrange Icons 11.7.4 Close 11.8 Help.88 11.8.1 Index 11.8.2 Using Help 11.8.3 Search Help on.88 11.8.4 About HDI.88 Windows 12.1 Breakpoints 12.1.1 Help.89 12.1.2 Add.90 12.1.3 Edit 12.1.4 Delete.90 12.1.5 Delete 12.1.6 Disable/Enable.90 12.2 Command Line 12.2.1 Stop.91 12.2.2 Batch File 12.2.3 File 12.2.4 Logging.92 12.3 Registers 12.3.1 Copy.93 12.3.2 Edit.
Hitachi Debugging Interface User Manual
12.3.3 Expand/Collapse.93 12.3.4 Help.93 12.4 Locals.94 12.4.1 Copy.94 12.4.2 Edit Value 12.5 Memory Mapping.95 12.5.1 Add.95 12.5.2 Change.95 12.5.3 Reset 12.5.4 Help.95 12.6 Memory 12.6.1 Copy.96 12.6.2 Find 12.6.3 Fill 12.6.4 Move 12.6.5 Test 12.6.6 Save.97 12.6.7 Address 12.6.8 ASCII/Byte/Word/Long/Single Float/Double float 12.7 Performance Analysis.98 12.7.1 Range.98 12.7.2 Edit Range.98 12.7.3 Delete Range.98 12.7.4 Reset Counts/Times 12.7.5 Delete Ranges 12.7.6 Analysis Enabled 12.8 Program 12.8.1 Copy.100 12.8.2 Find .100 12.8.3 Line .101 12.8.4 Cursor.101 12.8.5 Here .101
12.8.6 Toggle Breakpoint.101 12.8.7 Instant Watch .101 12.8.8 Watch.101 12.8.9 Source/Mixed/Assembler .101 12.9 Registers .102 12.9.1 Copy.102 12.9.2 Edit .102 12.9.3 Toggle .102 12.10 System Status .103 12.10.1 Update.103 12.10.2 Copy .103 12.10.3 Configure.103 12.11 Text .104 12.11.1 Copy .104 12.11.2 Find .104 12.12 Trace .105 12.12.1 Find .105 12.12.2 Find Next .105 12.12.3 Filter .105 12.12.4 Acquisition .105 12.12.5 Halt.106 12.12.6 Restart .106 12.12.7 Snapshot .106 12.12.8 Clear.106 12.12.9 Save .106 12.13 Watch.107 12.13.1 Copy .107 12.13.2 Delete Watch.107 12.13.3 Watch.107 12.13.4 Edit Value .108 Appendix System Modules.109 Appendix Command Line Interface .111
Hitachi Debugging Interface User Manual
Appendix Command Line Summary Chart .135
xiii
Figures
Figure Graphical User Interface. Figure Ellipsis. Figure Check Mark Figure Cascading Menu. Figure Accelerator Figure Default Toolbar. Figure File Operation. Figure Copy Move Operations. Figure Execution Operations Figure 2.10 Open Windows Figure 2.11 Help. Figure 2.12 Status Bar. Figure 2.13 Pop-Up Menu Figure 2.14 Help Button. Figure Select Platform Dialog Box.11 Figure Link Message.12 Figure Memory Mapping Window Figure Edit Memory Mapping Window Figure System Status Window.15 Figure Load Object File Dialog Figure File Type Selection.16 Figure Download Completion Message.16 Figure Open Dialog Figure Program Window (Source Display) Figure Program Window (Assembly-Language Display).19 Figure Assembler Dialog Figure Symbols Dialog Figure Find Symbol Containing Dialog Box.21 Figure Symbol Dialog Figure Label Dialog Figure Edit Symbol Dialog Figure 4.10 Message Confirming Symbol Deletion Figure 4.11 Message Confirming Symbol Deletion Figure 4.12 Load Symbols Dialog Box.25 Figure 4.13 Number Loaded Symbols.25 Figure 4.14 Address Dialog Figure 4.15 Find Dialog Figure 4.16 Open Dialog
Hitachi Debugging Interface User Manual
Figure 4.17 Text Window Figure 4.18 Copying Text Figure 4.19 Find Dialog Figure Open Memory Window Dialog Figure Memory Window (Bytes).31 Figure Memory Window (Words) Figure Memory Window (Longwords).32 Figure Memory Window (Single-Precision Floating Point).33 Figure Memory Window (Double-Precision Floating Point) Figure Memory Window (ASCII) Figure Address Dialog Figure Edit Dialog Box.35 Figure 5.10 Find Memory Dialog Figure 5.11 Address Where Data Found.36 Figure 5.12 Address Where Data Found Figure 5.13 Selecting Memory Range.37 Figure 5.14 Fill Memory Dialog Box.38 Figure 5.15 Move Memory Dialog Box.38 Figure 5.16 Test Memory Dialog Figure 5.17 Save S-Record File Dialog Figure 5.18 Message Confirming File Save Completion Figure 5.19 Load Object File Dialog Figure 5.20 Message Confirming File Load Completion Figure 5.21 Verify S-Record File with Memory Dialog Box.42 Figure 5.22 Message Confirming Verification Completion Figure Highlighted Line Corresponding Address.43 Figure Step Program Dialog Figure Execution Halted Clicking Halt Button Figure Setting Program Breakpoint Figure Break Program Breakpoint.48 Figure Breakpoints Window.49 Figure Program Dialog Figure Selecting Instant Watch.55 Figure Instant Watch Dialog Figure Watch Dialog Box.57 Figure Watch Window Figure Expanding Watch Figure Edit Value Dialog Box.59 Figure Locals Window
Figure Registers Window.60 Figure Register Dialog Figure 8.10 Registers Window Figure 8.11 Dialog Modifying Register Contents Figure Select Function Dialog Box.67 Figure 10.1 Minimizing Window.69 Figure 10.2 Code Window Icon.69 Figure 10.3 Icons Before Arrangement Figure 10.4 Icons After Arrangement Figure 10.5 Selecting Window Figure 10.6 Customise Toolbar Dialog Box.73 Figure 10.7 Font Dialog Figure 10.8 Session Name Display.75 Figure 10.9 Options Dialog Figure 10.10 Setting Radix Figure 11.1 Menus.79 Figure 12.1 Breakpoints Window Figure 12.2 Command Line Window.91 Figure 12.3 Registers Window Figure 12.4 Locals Window Figure 12.5 Memory Mapping Window Figure 12.6 Memory Window.96 Figure 12.7 Performance Analysis Window Figure 12.8 Source Format.99 Figure 12.9 Assembly-Language Format Figure 12.10 Registers Window.102 Figure 12.11 System Status Window.103 Figure 12.12 Text Window.104 Figure 12.13 Trace Window.105 Figure 12.14 Watch Window .107 Figure System Modules.109
Section
Introduction
Introduction
Hitachi Debugging Interface HDI) Version Graphical User Interface intended ease development debugging applications written C/C++ assembly language Hitachi microcomputers. provide powerful intuitive accessing, observing modifying debugging platform which application running.
Features
WindowsGUI debugging Intuitive interface On-line help Common "Look Feel" Note detailed information about debugging platform hardware, please refer separate Debugging Platform User's Manual.
Hitachi Debugging Interface User Manual
Section
System Overview
System Overview
modular software system, utilizing self-contained modules specific tasks. These modules linked general purpose Graphical User Interface, which provides common look feel independent particular modules with which system configured.
User Interface
Graphical User Interface Windows application that presents debugging platform allows modify system.
Menu Toolbar
Pop-up menu
Window
Icon Status
Figure Graphical User Interface 2.1.1 Menu Debugging commands grouped into similar areas Menu bar. Using mouse select command operation invoke dialog window interact with system. Clicking left mouse button category will pull down menu, from which select option.
Hitachi Debugging Interface User Manual
menu option does perform action directly, instead displays dialog window further user interaction, then will followed ellipsis (three dots,
Figure Ellipsis menu action also invoked pressing function key, then function number (Fn) will displayed next option. menu option toggles feature then check mark will displayed next text when enabled:
Figure Check Mark this manual, menu option selection expressed using brackets example, above operation expressed [View Toolbar]. cascading menu option selection shown below expressed [Setup->Radix->Hexadecimal]. menu option cascading menu symbol next then cascading hierarchical menu available. Clicking menu option will cascading menu: Click [Radix]
Figure Cascading Menu
Section
System Overview
ZDQW VHOHFW H[DPSOH SUHVV VHTXHQFH ORDG SURJUDP
)LJXUH$FFHOHUDWRU.H\ 7RROEDU WRROEDU ORFDWHG EHORZ PHQX 7KLV SURYLGHV TXLFN DFFHVV IHDWXUHV FOLFNLQJ UHVSHFWLYH EXWWRQ ZLWK WKHPRXVH )LJXUH'HIDXOW7RROEDU
Load Code Save Memory Verify Memory
)LJXUH)LOH2SHUDWLRQ
Selection
Copy Selection
Paste Selection Find Pattern Fill Memory Block Move Memory Block Test Memory Block
)LJXUH&RS\0RYH2SHUDWLRQV
Program from Reset Stop Program Step Into Step Over Step
)LJXUH([HFXWLRQ2SHUDWLRQV
Hitachi Debugging Interface User Manual
Register Memory Breakpoint Trace Memory Mapping Status
Program
)LJXUH2SHQ:LQGRZV
List Help
)LJXUH+HOS ILQGHDVLHVWWRXVH PRUH GHWDLOV DERXW FKDQJLQJ DUUDQJHPHQW WRROEDU ©VIXQFWLRQVHH VHFWLRQ &XVWRPL]LQJWKH7RROEDU 6WDWXV%DU 6WDWXV ORFDWHG ERWWRP DSSOLFDWLRQ ZLQGRZ SURYLGHV XVHU ZLWK LQIRUPDWLRQ DERXW ZKDW RIWKH&DS1XP6FUO/RFN
Status message Cap/Num/Scrl Lock state
)LJXUH6WDWXV%DU
3RS8S0HQXV :LQGRZV KDYH 3RSXS PHQXV RUGHU PDNH FRPPRQO\ XVHG IHDWXUHV HDVLHU DFFHVV 7KHVH PHQXV LQYRNHG FOLFNLQJ 6+,)7)DQGWKHQ VHOHFWLQJWKHUHTXLUHGPHQXRSWLRQ
Section
System Overview
Figure 2.13 Pop-Up Menu contents operation specific Pop-up menus explained detail description each window. section Windows.
Data Entry
When entering numbers dialog field always enter expression instead simple number. This expression contain symbols operators C/C++ programming languages. C/C++ language features such arrays structures only available object reader that supports C/C++ language debugging use. 2.2.1 Operators C/C++ language operators available: 2.2.2 Data Formats Unprefixed data values will taken being default radix [Setup->Radix] menu option, with exception count fields which expect decimal values default (independent current default system radix). Symbols used name ASCII character strings entered surrounded single quote characters, e.g. `demo'.
Hitachi Debugging Interface User Manual
following prefixes used identify radices: Octal Binary Decimal Hexadecimal Hexadecimal
contents register used specifying register name, prefixed character, e.g.: #R1, #ER3, #R4L 2.2.3 Precision mathematics expression evaluation done using bits (signed). values exceeding bits truncated. 2.2.4 Expression Examples
Buffer_start 0x1000 B'10001101 ((pointer increment_size)) H'FFFF0000) D'15 !(flag #ER4)
2.2.5 Symbol Format specify reference symbols same format C/C++ language. Cast operators used together with symbols, reference data after type been converted. Note following limitations. Pointers specified four levels. Arrays specified three dimensions. References specified only level. typedef name used.
2.2.6 Symbol Examples
Object.value p_Object->value Class::value *value &value array[0] Object.*value ::g_value Class::function(short) (struct STR) *value
//Specifies direct reference member (C/C++) //Specifies indirect reference member (C/C++) //Specifies reference member with class (C++) //Specifies pointer (C/C++) //Specifies reference (C/C++) //Specifies array (C/C++) //Specifies reference member with pointer (C++) //Specifies reference global variable (C/C++) //Specifies member function (C++) //Specifies cast operation (C/C++)
Section
System Overview
Help
standard Windows context sensitive help system. This provides on-line information about using debugging system. Help invoked pressing Help menu. Additionally, some windows dialog boxes have dedicated help button launch help file appropriate location:
Figure 2.14 Help Button 2.3.1 Context Sensitive Help help specific item HDI, help cursor used. enable help cursor, press SHIFT+F1. Your cursor then changes include question mark. then click item which require help help system will opened appropriate location.
Hitachi Debugging Interface User Manual
Section
Preparing debug
Preparing Debug
This section manual describes facilities that available setting debugging platform ready start debugging your program. will learn select configure debugging platform with which debug, load your debug object file.
Compiling Debug
order able debug your program C/C++ source level, compiler must provide information about your C/C++ program debugging platform object file. When this option enabled, compiler puts information necessary debugging your C/C++ code into object file, which then usually called debug object file. Note Make sure have debug option enabled your compiler linker, when generate object file debugging. your debug object file does contain debugging information, then still load into debugging platform, will only able debug assembly-language level.
Selecting Debugging Platform
have only installed single debugging platform, then will automatically link installed debugging platform when launched. However, have installed more than debugging platform, then will have select appropriate debugging platform startup with Select Platform dialog clicking [Setup>Select Platform.] menu option.
Figure Select Platform Dialog
Hitachi Debugging Interface User Manual
dialog lists debugging platforms installed system. (These could hardware in-circuit emulators, software simulation engines evaluation board monitors.) Select debugging platform want this session. will load target module establish communications with debugging platform. module loads, will initialize hardware data structures provide status messages status initialization progresses. When debugging platform been successfully initialized will report "Link status bar:
Figure Link Message Note have only debugging platform installed your system this option disabled (the [Setup->Select Platform.] menu option grayed) automatically links that debugging platform.
Configuring Debugging Platform
Before load program into your debugging platform must match your application's system. items that must setup typically device type, operating mode, clock speed memory map. particularly important set-up memory map, must have memory debugging platform which your user code will loaded. 3.3.1 Setup set-up debugging platform configuration invoke [Setup ->Configure Platform.] menu option. will presented with set-up dialog specific debugging platform that chose Select Platform dialog box. Note detailed description features available your debugging platform, please refer separate Debugging Platform User's Manual.
3.3.2 Mapping debugger correctly represent your user system, memory must needs know which areas device's address space RAM, ROM, on-chip registers areas where there memory.
Section
Preparing debug
When select device type mode Configure Platform dialog box, will automatically that device mode which processor operating. example device with internal RAM, areas where these located device's memory will default. using device that does have internal memory, device with external memory instead addition internal memory, then must tell debugging platform that have memory there. Also trying debug code with emulator wish have some memory available address that does exist either internally device externally your user system, then some emulation memory from emulator address space your application use. Again dialog shown will specific debugging platform that chose Select Platform dialog box. But, example, with hardware in-circuit emulator will something like:
Setting Device Configuration
System Resources
Figure Memory Mapping Window Setting area shows address space currently mapped. lists address ranges covering entire address space type memory which they set; internal external emulator access restrictions they have, e.g. read only guarded access). This includes those ranges automatically those have modified yourself.
Hitachi Debugging Interface User Manual
Device Configuration area shows memory device's address space configured, according device type mode selected Configure Platform dialog on-chip memory control settings. System Resources area shows status mapping resources available system. example emulator this will show address ranges which emulation memory been allocated which currently available. Clicking [Reset] button will system setting back default current device type mode. modify setting, select click [Edit] button double click setting line. From following dialog will then able modify start addresses range, memory type setting:
Figure Edit Memory Mapping Window range click [Add] button, Memory Mapping dialog will appear same Edit Memory dialog without default values). Enter start addresses range, memory type setting area. range middle existing range, will automatically adjust range. Note page length limitations some emulators when accessing their internal RAM, range addresses exactly match entered addresses.
Section
Preparing debug
3.3.3 Status check configuration status debugging platform looking System Status window. This invoked from [View->Status Window] menu.
Figure System Status Window status window updated demand from pop-up menu. Click right mouse button pop-up pop-up menu select [Configure].
Downloading Program
Once have made sure that there memory your system which download your code, then proceed download program debug. Clicking [File->Load Program.] menu option will invoke Load Object File dialog box:
Figure Load Object File Dialog
Hitachi Debugging Interface User Manual
3.4.1 Selecting File Type select file download, first select type file display list area clicking List Files Type field then click file type that require.
Figure File Type Selection file list will then updated with files available, from which your selection made. Directory drive navigation possible using standard windows file open dialog controls, right file list. Alternatively file name typed into File Name: field directly. Clicking [OK] button will initiate downloading. During download will give readout progress status bar, will display following message when finished.
Figure Download Completion Message message will shown indicating areas memory user system that have been changed.
Section
Looking your program
Looking Your Program
This section describes look your program source code assembly-language mnemonics. HDI's facilities dealing with code symbol information explained will shown look text files user interface.
Viewing Code
look your program, open Program window either selecting [View->Program Window.] menu option clicking Program Window button toolbar visible). have source files open already, will prompt relevant source file Open Program Window dialog box:
Viewing Assembler Code
Figure Open Dialog
Hitachi Debugging Interface User Manual
Select your source file press [OK], opens Program window:
Header
Address Field
Breakpoint
Source Code
Figure Program Window (Source Display) Program window source display divided into areas; header area main window area, split vertically into three columns; Address, Break, Code. respective width each column adjusted dragging dividing line between each column title header bar. cursor will change vertical line will displayed where dividing line columns will Release mouse button when satisfied with column width display will updated with column width. default window will display C/C++ assembly-language source text your program. 4.1.1 Viewing Assembly-Language Code have source file, wish view code assemblylanguage level, select Address radio button "Open group Open Program Window dialog enter address symbol) Address field. Note that this only valid option have opened Program window address have matching source file. Program window will show assembly-language mnemonics (with symbols when available) Code column will replaced with three columns; Code showing machine code values, Label
Section
Looking your program
VKRZLQJ ODEHOV V\PEROV $VVHPEOHU VKRZLQJ GLVDVVHPEOHGPQHPRQLFV
0RGLI\LQJ$VVHPEO\/DQJXDJH&RGH PRGLI\ DVVHPEO\ODQJXDJH FRGH GRXEOHFOLFNLQJ LQVWUXFWLRQ WKDW ZLVK FKDQJH $VVHPEOHU GLDORJ ZLOODSSHDU
Address Machine Code Disassembled Instruction
)LJXUH$VVHPEOHU'LDORJ%R[ DGGUHVV PDFKLQH FRGH GLVDVVHPEOHG LQVWUXFWLRQ 0QHPRQLF ILHOG &OLFNLQJ >2.@ SUHVVLQJ (17(5 ZLOO DVVHPEOH LQVWUXFWLRQ LQWR PHPRU\ PRYH QH[W LQVWUXFWLRQ Note DVVHPEO\ODQJXDJH GLVSOD\ GLVDVVHPEOHG IURP DFWXDO PDFKLQH FRGH GHEXJJLQJ SODWIRUP PHPRU\ PHPRU\ FRQWHQWV FKDQJHG GLVSOD\ ZLOO VKRZ FRUUHVSRQGLQJ DVVHPEO\ODQJXDJH FRGH ZLOO PDWFK WH[W VKRZQ VRXUFHGLVSOD\
Hitachi Debugging Interface User Manual
4.1.3 Displaying Source Code change Program window display show source code, invoke pop-up menu clicking right mouse button alternatively pressing SHIFT+F10 keyboard) select [Source]. 4.1.4 Displaying Mixed Code also display source code lines interspersed with corresponding assembly-language code what called Mixed display. change Program window display show mixed source assembly-language code, invoke pop-up menu clicking right mouse button alternatively pressing SHIFT+F10 keyboard) select [Mixed].
Looking Symbols
addition debugging information that uses link your program's source code actual code memory, debug object file also contains symbol information. These symbols labels) text names that represent address program. When have Program window assembly-language format mixed format, will symbols Label field line corresponding address, Assembler field instruction's operand. Note instruction's operand replaced with symbol operand symbol match. This done simple match operand symbols' values. more symbols have same value, then symbol that comes first alphabetically will displayed. Wherever enter address value symbol instead. 4.2.1 Listing Symbols list symbols defined current session open Symbols dialog selecting [Tools->Symbols.] menu option. Symbols dialog shows list symbols defined HDI.
Section
Looking your program
Sort order radio buttons
Figure Symbols Dialog view symbols sorted either alphabetically(by ASCII code) address value clicking respective radio buttons. 4.2.2 Finding Symbol find particular symbol, click [Find] button, Find Symbol Containing dialog presented.
Figure Find Symbol Containing Dialog Enter part symbol name that wish find into edit click [OK] press ENTER. dialog closes searches symbol list symbol name containing text that entered. Note Only first characters symbol stored, therefore symbols should unique these first characters. Symbols case sensitive.
4.2.3 Finding Again find next symbol list containing text that entered Find Symbol Containing dialog box, click [Find Next] button.
Hitachi Debugging Interface User Manual
4.2.4 Adding Symbols symbol symbol list press [Add] button.
Figure Symbol Dialog Enter symbol name into Name field corresponding value into Value field press [OK]. Symbol dialog closes symbol list updated show symbol. When overloaded function class name entered Value field, Select Function dialog appears select function. details, refer section Selecting Functions. 4.2.5 Adding Symbol from Program Window quickly symbol from Program window (when assembly-language display mode), double-clicking Label column address which want assign symbol. Label dialog appears enter symbol text.
Figure Label Dialog
Section
Looking your program
Enter symbol name text click [OK], symbol added symbol list with address value contained Address column corresponding line, Program window display updated show symbol. This method also used quickly modifying text existing symbols. When double-click symbol Label column, text copied into edit Label dialog box. then edit modified version saved symbol list. Program window display updated show symbol. Note added modified symbols again later sessions, save symbols file. details, section 4.2.10, Saving Symbol File.
4.2.6 Modifying Symbols Symbol names values modified from Symbols dialog box. Open this selecting [Tools->Symbols.] menu option. Select symbol modify clicking symbol line list display. Clicking [Edit] button will open Edit Symbol dialog box:
Figure Edit Symbol Dialog then edit symbol name value. Press [OK] save modified version symbol list. list display updated show symbol. When overloaded function class name entered Value field, Select Function dialog appears select function. details, refer section Selecting Functions. 4.2.7 Deleting Symbols delete symbol from symbol list, select symbol delete from Symbols dialog clicking symbol line list display, click [Delete] button. confirmation message appears:
Hitachi Debugging Interface User Manual
Figure 4.10 Message Confirming Symbol Deletion click [Yes] button symbol removed from system's symbol table list display updated. 4.2.8 Deleting Symbols delete symbols from symbol list, click [Del All] button. confirmation message appears:
Figure 4.11 Message Confirming Symbol Deletion click [Yes] button symbols removed from system's symbol table list display will cleared. 4.2.9 Loading Symbol File Although will automatically extract symbols from debug object file when loaded, there times when want load extra symbols. This could case debugging code without debug information. Having enter these symbols manually using Symbols dialog would extremely tedious, fortunately allows load symbols from external symbol file. load symbol file into HDI, open Symbols dialog selecting [Tools->Symbols.] menu option click [Load] button. Load Symbols dialog appears:
Section
Looking your program
Figure 4.12 Load Symbols Dialog dialog operates like standard windows open file dialog box; select file click [OK] start loading. standard file extension symbol files ".sym". When loading complete message shows many symbols have been loaded:
Figure 4.13 Number Loaded Symbols 4.2.10 Saving Symbol File save symbol file from HDI, open Symbols dialog selecting [Tools->Symbols.] menu option click [Save] button. Save Symbols dialog appears. dialog operates like standard windows save file dialog box. Enter name file File Name: field click [OK] start saving. standard file extension symbol files ".sym". 4.2.11 Symbol File Format order able understand decode symbol file correctly, file must formatted specific way: file must plain ASCII text file. file must start with word "BEGIN".
Hitachi Debugging Interface User Manual
Each symbol must separate line with value first, hexadecimal terminated "H", followed space then symbol text. file must with word "END". Example: BEGIN 11FAH 11FCH 11FEH 1200H Symbol_name_1 Symbol_name_2 Symbol_name_3 Symbol_name_4
Looking Specific Address
When looking your program Program window, want look another area your program's code. Rather than scrolling through code program, directly specific address. Double-click Address column Program window, Address dialog appears:
Figure 4.14 Address Dialog Enter address symbol name edit either click [OK] press ENTER. code that address same source file, Program window updates show code address. When overloaded function class name entered, Select Function dialog appears select function. details, refer section Selecting Functions. address another source file, Program window opens show code that address. default window shows source available. source available address, Program window shows assembly-language code.
Section
Looking your program
address source file that already Program window open, that window brought front updated show code address. 4.3.1 Looking Current Program Counter Address Wherever enter address value into HDI, also enter expression (see section 2.2, Data Entry). enter register name prefixed character, contents that register will used value expression. Therefore invoke Address dialog enter expression "#PC", Program window display will current address. also allows that display from offset current entering expression with register plus offset, e.g., "#PC+0x100".
Finding Text
search particular text string Program window using find option. this invoke pop-up menu clicking right mouse button alternatively pressing SHIFT+F10 keyboard) select [Find.]. Find dialog displayed:
Figure 4.15 Find Dialog Enter text that wish find click [Find Next] press ENTER. Program window will display text found) highlighted. find next occurrence text, click [Find Next] press ENTER again. close Find dialog box, click [Cancel] press ESC.
Hitachi Debugging Interface User Manual
Looking Text File
will automatically show source files your program debug object file provides with source file information. However there will occasions when want look source text files which compiler does include this information e.g. include files, data tables project documentation files. provides this feature with Text window. 4.5.1 Opening Text Window open Text window, select [View->Text Window.] menu option. Open dialog appears:
Figure 4.16 Open Dialog dialog operates like standard windows open file dialog box; select text file click [OK] open Text window will open file will displayed.
Section
Looking your program
Figure 4.17 Text Window move around display window using scroll bars keyboard using cursor Page Up/Down keys. 4.5.2 Copying Text copy text from Text window into clipboard, first select text dragging mouse over Then invoke local pop-up menu clicking right mouse button:
Figure 4.18 Copying Text Click [Copy] selected text copied clipboard.
Hitachi Debugging Interface User Manual
4.5.3 Finding Text search particular text string Text window using find option. Invoke local pop-up menu clicking right mouse button, click [Find.] will presented with Find dialog box.
Figure 4.19 Find Dialog Enter text that wish search edit click [Find Next]. searches through Text window stops first occurrence text that specified. find next occurrence, click [Find Next] again.
Section
Working with memory
Working with Memory
This section describes look areas memory CPU's address space. will show look area memory different formats, fill, move test block memory, save, load verify area memory with disk file.
Looking Area Memory
look area memory, open Memory window, selecting [View->Memory Window] menu option, clicking Memory Window toolbar button visible. will presented with Open Memory Window dialog box:
Figure Open Memory Window Dialog Type start address equivalent symbol window display Address field select required display format from Format list. Click [OK] press ENTER, dialog disappears Memory window opens:
Figure Memory Window (Bytes)
Hitachi Debugging Interface User Manual
want change display format from selected when opened window, this done from pop-up menu. 5.1.1 Displaying Memory Bytes display memory bytes, invoke pop-up menu clicking right mouse button pressing SHIFT+F10). Select [Byte] menu option display will updated show area memory individual bytes, shown above. 5.1.2 Displaying Memory Words display memory words, invoke pop-up menu clicking right mouse button pressing SHIFT+F10). Select [Word] menu option display will updated show area memory words:
Figure Memory Window (Words) 5.1.3 Displaying Memory Longwords display memory longwords, invoke pop-up menu clicking right mouse button pressing SHIFT+F10). Select [Long] menu option display will updated show area memory longwords:
Figure Memory Window (Longwords)
Section
Working with memory
5.1.4 Displaying Memory Single-Precision Floating Point display memory single-precision floating-point data, invoke pop-up menu clicking right mouse button pressing SHIFT+F10). Select [Single float] menu option display will updated show area memory single-precision floating-point data:
Figure Memory Window (Single-Precision Floating Point) 5.1.5 Displaying Memory Double-Precision Floating Point display memory double-precision floating-point data, invoke pop-up menu clicking right mouse button pressing SHIFT+F10). Select [Double float] menu option display will updated show area memory double-precision floating-point data:
Figure Memory Window (Double-Precision Floating Point)
Hitachi Debugging Interface User Manual
5.1.6 Displaying Memory ASCII display memory ASCII characters, invoke pop-up menu clicking right mouse button pressing SHIFT+F10). Select [ASCII] menu option display will updated show area memory ASCII characters:
Figure Memory Window (ASCII) 5.1.7 Looking Different Area Memory want change area memory that Memory window displaying scroll bars. quickly look address Address dialog box. This invoked either from pop-up menu double clicking Address column. Invoke pop-up menu clicking right mouse button, pressing SHIFT+F10) click [Set Address]:
Figure Address Dialog Address dialog appears; enter address value. Click [OK] press ENTER, dialog disappears Memory window display updated with data address. When overloaded function class name entered, Select Function dialog appears select function. details, refer section Selecting Functions.
Section
Working with memory
Modifying Memory Contents
There ways that change contents memory address; quick edit method that allows enter values typing directly into window, limited hexadecimal values only, full edit method that requires enter values dialog box, allows enter values simple complex expressions. 5.2.1 Quick Edit quick change contents memory select digit that wish change, clicking dragging will selected digit highlighted. Type value digit, must range 0-9, a-f. value written into digit cursor moves next digit memory. 5.2.2 Full Edit full change contents memory accessed Edit dialog box. Move cursor memory unit (depending your Memory window display choice) that wish change. Either double-click memory unit, press ENTER. Edit dialog appears:
Figure Edit Dialog Like other data entry field HDI, enter formatted number C/C++ expression (see Data Entry section System Overview). When have entered number expression, click [OK] button press ENTER, dialog closes value written into memory.
Hitachi Debugging Interface User Manual
Finding Value Memory
search value memory using Find feature. find value, invoke pop-up menu clicking right mouse button, pressing SHIFT+F10) click [Find]. Find Memory dialog appears:
Figure 5.10 Find Memory Dialog Enter start addresses range which search data value search for. Select search format Long word/Word/Byte/Single float/Double float click [OK] press ENTER. dialog closes searches range specified data. data found, message showing address which data been found displayed Status bar:
Figure 5.11 Address Where Data Found otherwise following message will displayed:
Figure 5.12 Address Where Data Found
Section
Working with memory
Filling Area Memory with Value
contents range memory addresses value using memory fill feature. 5.4.1 Selecting Memory Range memory address range Memory window, select range clicking first memory unit (depending your Memory window display choice) dragging mouse last unit, selected range highlighted.
Figure 5.13 Selecting Memory Range memory address range larger than outside Memory window, then enter start addresses byte count respective fields Fill Memory dialog box. 5.4.2 Filling Range fill range, invoke pop-up menu clicking right mouse button, pressing SHIFT+F10) click [Fill]. Fill Memory dialog appears:
Hitachi Debugging Interface User Manual
Figure 5.14 Fill Memory Dialog When address range been selected Memory window, specified start address byte count will displayed Address Byte Count fields. Select format clicking relevant radio button Format group enter data value Data field. Click [OK] button press ENTER, dialog closes value written into memory range.
Moving Area Memory
move area memory address space using memory move feature. Select memory range (see section 5.4.1, Selecting memory range), invoke pop-up menu click [Move]. Move Memory dialog appears:
Figure 5.15 Move Memory Dialog source start address address specified Memory window will displayed Source Start Address Source
Section
Working with memory
Address fields. Enter destination start address Destination Address field click [OK] button press ENTER, dialog closes memory block will copied address.
Testing Area Memory
test area memory address space using memory test feature. Select memory range (see section 5.4.1, Selecting memory range), invoke pop-up menu click [Test]. Test Memory dialog appears:
Figure 5.16 Test Memory Dialog start address address specified Memory window will displayed Start Address Address fields. Click [OK] button press ENTER, dialog closes will perform test memory range. Note exact test target dependent. However, cases current contents memory will overwritten YOUR PROGRAM DATA WILL ERASED.
Hitachi Debugging Interface User Manual
Saving Area Memory
save area memory address space disk file using save memory feature. Open Save S-Record File dialog selecting [File->Save Memory.] menu option:
Figure 5.17 Save S-Record File Dialog Enter start addresses memory block that wish save file name. Directory drive navigation possible using standard windows file open dialog controls, right file list. Click [OK] button press ENTER, dialog closes memory block will saved disk Motorola S-record format file. When file save complete confirmation message appears:
Figure 5.18 Message Confirming File Save Completion
Section
Working with memory
Loading Area Memory
load program area memory from disk file using load program feature. Since programs loaded Motorola s-Record files this feature used load data values into memory addresses specified records file, e.g. previously saved memory block. Open Load Object File dialog selecting [File->Load Program.] menu option:
Figure 5.19 Load Object File Dialog offset loading address from address specified Srecord entering value (positive negative) Offset field. Click [OK] button press ENTER, dialog closes file loaded into memory. When file load complete confirmation message appears:
Figure 5.20 Message Confirming File Load Completion
Hitachi Debugging Interface User Manual
Verifying Area Memory
verify area memory address space against disk file using verify memory feature. This useful checking integrity data currently memory compared previously saved block memory file. Open Verify S-Record File with Memory dialog selecting [File->Verify Memory] menu
option:
Figure 5.21 Verify S-Record File with Memory Dialog offset verification address from address specified S-record entering value (positive negative) Offset field. Click [OK] button press ENTER, dialog closes file verified. When file verification complete confirmation message appears:
Figure 5.22 Message Confirming Verification Completion
Section
Executing your program
Executing Your Program
This section describes execute your program's code. will learn this either running your program continuously stepping single multiple instructions time.
Running from Reset
reset your user system your program from Reset Vector address, click Reset toolbar button visible, select [Run->Go Reset] menu option. program will until hits breakpoint break condition met. stop program manually clicking Halt toolbar button selecting [Run->Halt program] menu option. Note program will start running from whatever address stored Reset Vector location. Therefore important make sure that this location contains address your startup code.
Continuing
When your program stopped debugger break mode, will highlight line Program window that corresponds CPU's current Program Counter (PC) address value. This will next instruction executed perform step continue running.
Figure Highlighted Line Corresponding Address
Hitachi Debugging Interface User Manual
continue running from current address click Continue toolbar button visible, select [Run->Go] menu option.
Running Cursor
Sometimes going through your application want only small section code, that would require many single steps execute. this case would useful able particular point. this using Cursor feature.
Using Cursor
Make sure that Program window open showing address which wish stop. Position cursor address which wish stop either clicking Address field using cursor keys. Invoke pop-up menu clicking right mouse button, pressing SHIFT+F10) selecting Cursor] menu option. debugging platform will your code from current value until reaches address indicated cursor's position. Notes your program never executes code this address, program will stop. this happens, code execution stopped pressing Esc; selecting [Run->Halt Program] menu option; clicking `Stop' toolbar button[ Cursor feature requires temporary breakpoint have already used those available then feature will work, menu option will disabled.
Running Several Points
When want perform something like Cursor operation destination outside Program window, want stop several addresses, HDI's temporary breakpoint feature (see section 7.5, Temporary Breakpoints).
Section
Executing your program
Single Step
When debugging your code very useful able step single line instruction time examine effect that instruction system. Program window display source mode, then step operation will step single source line. Program window display assembly-language mixed mode, step operation will step single assembly-language instruction. instruction calls another function subroutine, have option either step into step over function. instruction does perform call, then either option will cause debugger execute instruction stop next instruction. 6.5.1 Stepping into Function choose step into function debugger will execute call stop first line instruction function. step into function either click Step toolbar button visible, select [Run->Step menu option. 6.5.2 Stepping over Function Call choose step over function debugger will execute call code function (and function calls that that function make) stop next line instruction calling function. step into function either click Step Over toolbar button visible, select [Run->Step Over] menu option.
Stepping Function
During debugging, there occasions when have entered function, finished stepping through instructions that want examine would like return calling function without tediously stepping through remaining code function. alternatively (and perhaps more usefully) have stepped into function accident, when meant step over want return calling function without stepping through current function. this with Step feature. step current function either click Step toolbar button visible, select [Run->Step Out] menu option.
Hitachi Debugging Interface User Manual
Multiple Steps
Sometimes find useful step several instructions time. this using Step Program dialog box. dialog also provides automated step with selectable delay between steps. invoked selecting [Run-> Step.] menu option. Step Program dialog displayed:
Figure Step Program Dialog Enter number steps Steps field select whether want step over function calls Step Over Calls check box. using feature automated stepping, select step rate from list Rate field. Click [OK] press ENTER start stepping.
Section
Stopping your program
Stopping Your Program
This section describes halt execution your application's code. This section describes this directly using halt command setting breakpoints specific locations your code.
Halting Execution
When your program running, Halt toolbar button enabled stop sign), when program stopped disabled (the stop sign grayed out). stop program click Halt toolbar button, visible, select [Run->Halt Program] menu option. Your program's execution halted, with following message displayed status bar. will then update open windows.
Figure Execution Halted Clicking Halt Button
Program Breakpoints Breakpoints)
When trying debug your program will want able stop program running when reaches specific point points your code. this setting breakpoint line instruction which want execution stop. following instructions will show quickly clear simple breakpoints. More complex breakpoint operation done Breakpoints window, which discussed later.
program (PC) breakpoint
Make sure that Program window open place want program (PC) breakpoint. Double-click Break column line which want program stop. will word `Break' appear column indicate that program (PC) breakpoint been set.
Hitachi Debugging Interface User Manual
Current location
Breakpoint
Figure Setting Program Breakpoint when your program reaches address which program (PC) breakpoint, execution halts with message:
Figure Break Program Breakpoint displayed status bar, Program window display updated with program (PC) breakpoint line highlighted. Note line instruction which program (PC) breakpoint actually executed; program stops just before about execute choose Step after stopping program (PC) breakpoint, then highlighted line will next instruction executed.
7.2.1 Clearing Program (PC) Breakpoints clear program (PC) breakpoint, double-click word `Break' Break column line which program (PC) breakpoint set. display will update word `Break' disappears.
Section
Stopping your program
Breakpoints Window
Breakpoints window allows access complex breakpoints your debugging platform supports them) gives more control over setting/clearing enabling/disabling breakpoints. open Breakpoints window select [View->Breakpoint Window] menu option click Breakpoint Window toolbar button visible. Breakpoints window opens.
Header Breakpoint disabled Breakpoint enabled
Resource display
Figure Breakpoints Window window divided into main areas; list breakpoints system, display breakpoint resources. breakpoint list divided horizontally into five columns; Enable, File/Line, Symbol, Address, Type. respective widths each columns adjusted clicking dragging dividing line between each column title header bar. cursor will change vertical line will displayed dividing line columns. Release mouse button when satisfied with column width display will updated with column width. 7.3.1 Adding Breakpoint breakpoint Breakpoints window three ways: Click [Add] button.
Hitachi Debugging Interface User Manual
Invoke pop-up menu clicking right mouse button select [Add] menu option. Invoke pop-up menu pressing SHIFT+F10 select [Add] menu option. this manual, directions click button also mean selecting local pop-up menu option having same name button. Breakpoint/Event Properties dialog will appear which select type parameters breakpoint that wish set. Note Breakpoint/Event Properties dialog specific debugging platform have selected. appearance operation depend breakpoint features available debugging platform. details debugging platform specific breakpoints, separate Debugging Platform User's Manual.
7.3.2 Modifying Breakpoint edit existing breakpoint Breakpoints window, select breakpoint list double clicking, clicking line corresponding click [Edit] button. Breakpoint/Event Properties dialog will appear which select type parameters breakpoint that wish set. Note Breakpoint/Event Properties dialog specific debugging platform have selected. appearance operation depend breakpoint features available debugging platform. details debugging platform specific breakpoints, separate Debugging Platform User's Manual.
7.3.3 Deleting Breakpoint delete existing breakpoint Breakpoints window, select breakpoint list clicking line corresponding click [Delete] button. breakpoint deleted window updated. 7.3.4 Deleting Breakpoints delete breakpoints listed Breakpoints window click [Del All] button.
Section
Stopping your program
breakpoints deleted window cleared.
Disabling Breakpoints
During course debugging session find that tend focus particular areas code period time then look other areas, want return previous ones afterwards. When concentrating these areas will want breakpoints stop your program execution useful points. have these breakpoints wish move another area investigation, know that will want return current area later, frustrating have delete breakpoints have only have them again when return. Fortunately, eases this problem allowing disable breakpoints, while still leaving them breakpoint list. 7.4.1 Disabling Breakpoint disable individual breakpoint, select breakpoint list clicking line corresponding click [Disable] button. menu disappears breakpoint list updates show that breakpoint longer enabled Enable column. 7.4.2 Enabling Breakpoint When want re-enable breakpoint Breakpoints window list, select breakpoint list clicking line corresponding click [Enable] button. menu disappears breakpoint list updates show that breakpoint again enabled, showing check mark Enable column.
Temporary Breakpoints
There times when want start running your program want stop hits more addresses, want permanent breakpoints these address. example want perform something like Cursor operation, destination outside Program window want stop several addresses. this HDI's temporary breakpoint feature with temporary breakpoints that cleared when break. Temporary breakpoints Program dialog box, which opened selecting [Run-> Run.] menu option.
Hitachi Debugging Interface User Manual
Program dialog appears:
Figure Program Dialog Enter symbols address values points which want program stop maximum Stop field. When overloaded function class name entered, Select Function dialog appears select function. details, refer section Selecting Functions. Click button start running from current Program Counter address, displayed Program Counter field. Click Reset] button reset start running from reset vector address. program will stop reaches temporary breakpoint, normal breakpoint halt manually. When program halts temporary breakpoints that specified Stop field cleared. When select Program dialog again, temporary breakpoints listed will again click Reset]. remove temporary breakpoint from list, select clicking dragging mouse across press delete. click [Cancel] changes that have made Program dialog will lost.
Section
Stopping your program
Hardware Breakpoints(Event)
Note hardware breakpoints specific debugging platform have selected. Their operation depends breakpoint features available debugging platform. details debugging platform specific breakpoints, separate Debugging Platform User's Manual.
Hitachi Debugging Interface User Manual
Section
Looking variables
Looking Variables
This section describes look variables data objects that your program uses. shows view variables, watch items look contents CPU's general on-chip peripheral registers.
Instant Watch
quickest look variable your program Instant Watch feature.
Instant Watch:
Open Program window showing variable that want examine. Click variable. should cursor variable. Invoke pop-up menu clicking right mouse button, pressing SHIFT+F10), click [Instant Watch].
Figure Selecting Instant Watch
Hitachi Debugging Interface User Manual
Instant Watch dialog appears showing variable name value:
Figure Instant Watch Dialog this variable list watch items Watch window clicking [Add Watch] button.
Using Watch Items
When debugging your program find useful able look variables interest their values different times during program. allows open Watch windows, which contain list variables their values. open Watch window select [View->Watch Window] menu option; click Watch Window toolbar button visible. Watch window opens. Initially contents window will blank. 8.2.1 Adding Watch There ways Watch items Watch window; quick method accessed from Program window, full method using Watch dialog Watch window. Quick Method quickest variable Watch window Watch feature.
Watch:
Open Program window showing variable that want examine. Click variable. should cursor variable.
Section
Looking variables
Invoke Program window pop-up menu clicking right mouse button, pressing SHIFT+F10) click [Add Watch]. variable added watch item Watch window updates. Full Method item Watch window, invoke local pop-up menu clicking right mouse button pressing SHIFT+F10) Watch window click [Add Watch] option. Watch dialog appears:
Figure Watch Dialog Enter name variable that wish watch click [OK]. variable added Watch window.
Figure Watch Window Note variable that have added local variable that currently scope, will Watch window value will blank.
Hitachi Debugging Interface User Manual
8.2.2 Expanding Watch watch item pointer, array, structure, then will plus sign expansion indicator left name, this means that expand watch item. expand watch item, double click item expands show elements case structures arrays) data value case pointers) indented stop, plus sign changes minus sign (-). elements watch item also contain pointers, structures, arrays then they will also have expansion indicators next them.
Expanded watch Expansion indicator
Collapsed watch
Figure Expanding Watch collapse expanded watch item, double click item again. item elements collapse back single item minus sign changes back plus sign. 8.2.3 Changing Watch Item's Value wish change value watch variable, e.g. testing purposes value incorrect your program. change watch item's value Edit Value function.
Editing watch item's value:
Select item edit clicking will flashing cursor next item. Invoke pop-up menu clicking right mouse button pressing SHIFT+F10). Click [Edit Value] menu option.
Section
Looking variables
Edit Value dialog appears:
Figure Edit Value Dialog Enter value expression Value field click [OK]. Watch window updated show value. 8.2.4 Deleting Watch delete watch item, select clicking Invoke pop-up menu clicking right mouse button pressing SHIFT+F10) click [Delete Watch] option. item deleted Watch window updated. Note watches that have watch window saved session file. section Configuring User Interface.
Looking Local Variables
look local variables, open Locals window selecting [View->Local Variable Window] menu option. Locals window appears:
Figure Locals Window debug your program Locals window will updated, following step break from run, show current local variables their values. local variable initialized when defined, then
Hitachi Debugging Interface User Manual
value Locals window will undefined until value assigned local variable.
Looking Registers
debugging assembly-language level, using Program window assembly-language mixed display, then will probably find useful contents CPU's general registers. this using Registers window.
Figure Registers Window open Registers window select [View->Register Window] menu option click Register Window toolbar button visible. Registers window opens showing CPU's general registers their values, displayed hexadecimal. 8.4.1 Modifying Register Contents There ways that change register's contents; quick edit method that allows enter values typing directly into window, limited hexadecimal values only, full edit method that requires enter values dialog box, allows enter values base complex expressions. Quick Edit quick change register's contents select digit that wish change, clicking dragging will selected digit highlighted. Type value digit; must range a-f. value written into digit cursor moves next digit register. When enter value into least significant digit register, cursor moves
Section
Looking variables
most significant digit next register. digit register display indicates e.g. condition code register (CCR) then press SPACE toggle bit's value. Full Edit full change register's contents accessed Register dialog box. Open Register dialog four ways: Double-click register want change. Select register want change, press ENTER. Select register want change, invoke pop-up menu clicking right mouse button, click [Edit] menu option. Select register want change, invoke pop-up menu pressing SHIFT+F10, click [Edit] menu option.
Figure Register Dialog other data entry field HDI, enter formatted number C/C++ expression (see section 2.2, Data Entry). choose whether modify whole register contents just part register selecting Whole register/High Word/Low Word/Byte radio buttons. enter floating-point data checking Single float check box. When have entered number expression, click [OK] button press ENTER, dialog closes value written into register.
Hitachi Debugging Interface User Manual
8.4.2 Using Register Contents useful able value contained register when entering value elsewhere HDI, example when displaying specified address Program Memory windows. this specifying register name prefixed character, e.g.: #R1, #PC, #R6L, #ER3.
Looking
well ROM/RAM, microcomputer also contain onchip peripheral modules. exact number type peripheral modules differs between devices typical modules controllers, serial Communications interfaces, converters, integrated timer units, state controller watchdog timer. These on-chip peripherals programmed accessing registers mapped into microcomputer's address space. Since setting these on-chip peripheral registers usually very important embedded microcomputer application, useful able look clearly contents these registers. Memory window only allows look data memory byte, word, longword, single-precision floating-point, double-precision floating-point, ASCII values, also provides Registers window ease inspection setting these registers. 8.5.1 Opening Registers Window open Registers window select [View->I/O Register Window] menu option click Register Window toolbar button visible. register information organized modules, corresponding on-chip peripheral modules. When Registers window first opened, only list module names displayed.
Section
Looking variables
Module name
Registers
Register address Register name Register value
Figure 8.10 Registers Window 8.5.2 Expanding Register Display display names, addresses values registers, double click module name select module name, clicking using cursor keys, press ENTER. module display will expand show individual registers that peripheral module their names, addresses values. Double clicking pressing ENTER) again module name will close register display. 8.5.3 Modifying Register Contents edit value register double click press ENTER register open dialog modify register contents:
Figure 8.11 Dialog Modifying Register Contents
Hitachi Debugging Interface User Manual
When have entered number expression, click [OK] button press ENTER; dialog closes value written into register. Note using emulator debugging platform, when reads data from register this sometimes affect operation your program. example, reading data register cancel pending interrupt. Data only read from modules that have been expanded Registers window that register values displayed). Therefore, long modules collapsed when they longer need displayed, this will cause problem. order check whether this affecting your program running without Registers window. Also, note that having Memory window Code window) open area have same effect.
8.5.4 Register Files formats Registers window based information finds Register definition file. When select debugging platform using [Setup->Configure Platform.] menu option, will look "<device>.IO" file corresponding selected device load exists. This file formatted text file that describes modules address size their registers. edit this file, with text editor, support memory mapped registers peripherals have specific your application e.g. registers ASIC device mapped into microcomputer's address space. File format Each module name must defined [Modules] definition section numbering each module must sequential. Each module corresponds register definition section within section each entry defines register. `BaseAddress' definition devices where location registers moves address space depending mode. this case, `BaseAddress' value base address registers specific mode addresses used register definitions address locations registers same mode. When register file actually used, `BaseAddress' value subtracted from defined register address resultant offset added relevant base address selected mode.
Section
Looking variables
first field [Register] definition entry register name followed character. second field register address value followed optional flags: <size> which byte, word, long (default byte). <absolute> which register absolute address. This only relevant area address range moves about different modes. this case, register defined absolute base address offset calculation performed specified address used directly. Comment lines allowed must start with character. Example:
Comment Module definition
SH7034 Family Register Definitions File [Modules] BaseAddress=0 Module1=Interrupt Controller Module2=Bus State Controller Module3=DMAC Channel Module18=Serial Communications Interface Module19=A/D Converter Module20=User ASIC [Interrupt Controller] IPRA=0x5FFFF84 IPRB=0x5FFFF86 IPRC=0x5FFFF88 IPRD=0x5FFFF8A IPRE=0x5FFFF8C ICR=0x5FFFF8E [User ASIC] CTLR=0x10000 ADDR=0x10004 DDIR=0x10006 DATR=0x10007
Register definition
Register name Address Size
Absolute address flag
Hitachi Debugging Interface User Manual
Section
Selecting functions
Selecting Functions
When selecting overloaded functions member functions that used programs, follow description this section.
Displaying Functions
Select Function dialog display overloaded functions member functions. function selected following cases. When setting breakpoint When specifying function Program dialog Address dialog opening Program window Address dialog opening Memory window When adding modifying symbol When specifying function performance analysis When multiple functions have same specified function name, when class name including member function specified, Select Function dialog opens.
Figure Select Function Dialog
Hitachi Debugging Interface User Manual
This dialog three areas. Select Function Name list Displays same-name functions member functions their detailed information. Function Name list Displays function their detailed information. Counter group edit Function Displays number same-name functions member functions. Select Function Displays number functions displayed Select Function Name list box. Function Displays number functions displayed Function Name list box.
Specifying Functions
Select overloaded functions member functions Select Function dialog box. Generally, function selected time; only setting breakpoints, multiple functions selected. 9.2.1 Selecting Function Click function wish select Select Function Name list box, click button. will selected function Function Name list box. select functions Select Function Name list box, click [>>] button. 9.2.2 Deleting Function Click function wish delete from Function Name list box, click button. will selected function Function Name list box. delete functions Function Name list box, click [<<] button. 9.2.3 Setting Function Click [OK] button functions displayed Function Name list box. functions Select Function dialog closes. Clicking [Cancel] button closes dialog without setting functions.
Section
Configuring user interface
Configuring User Interface
When designed user interface tried make frequently used operations quickly accessible have related operations grouped logical order. However, when middle heavy debugging session find more useful have different arrangement user interface items just have personal preference want arranged. realize this allows customize user interface that satisfied with tool that using debugging your program. This section describes arrange user interface windows, customize various aspects display save configuration.
10.1 Arranging Windows
10.1.1 Minimizing Windows have temporarily finished using open window want able look current state later, reduce icon. This called minimizing window. minimize window, either click minimize button window, select Minimize] window menu option.
Window menu
Minimize button
Figure 10.1 Minimizing Window window minimized icon bottom left application window; above Code window example icon Figure 10.2 Code Window Icon Note able icon have window open over bottom screen.
Hitachi Debugging Interface User Manual
restore icon back window, either double click icon, click once invoke pop-up menu select [Restore]. 10.1.2 Arranging Icons Although icons will bottom left application window default when minimize window, move them anywhere like application window simply clicking dragging them position. When restore icon window, window will same position that when minimized Similarly, when minimize again, icon will placed last position that moved When have many minimized windows icons, display look rather messy. tidy icons, select [Window->Arrange Icons] menu option. icons will arranged order from bottom left application window:
Figure 10.3 Icons Before Arrangement
Figure 10.4 Icons After Arrangement
Section
Configuring user interface
10.1.3 Tiling Windows After some heavy debugging find that have many windows open screen. arrange windows tile format with none them overlapping each other using Tile function. invoke this select [Window->Tile] menu option. currently open windows arranged tile format. Windows that minimized icons affected. 10.1.4 Cascading Windows Open windows also arranged cascading format with only their left border visible under window front them. invoke this select [Window->Cascade] menu option. currently open windows arranged cascading format. Windows that minimized icons affected.
10.2 Locating Currently Open Windows
When have many windows open application window quite easy lose them behind others. There methods that find lost window: 10.2.1 Locating Next Window bring next window window list front display, select [Next] from window menu, press CTRL+F6. Repeating this operation will cycle selection windows (open minimized). 10.2.2 Locating Specific Window select specific window, invoke Window menu. Click window that wish select from list windows (open minimized) bottom menu. currently selected window check mark next window list. following example, Code window currently selected window:
Hitachi Debugging Interface User Manual
Figure 10.5 Selecting Window window that select (the Trace window above example) will brought front display. minimized icon restored window.
10.3 Enabling/Disabling Status
select whether Status displayed bottom application window; default will displayed. disable display Status bar, select [View->Status Bar] menu option. Status will disabled removed from application window display. re-enable Status display, select [View>Status Bar] menu option again. Status will enabled added application window display.
10.4 Enabling/Disabling Toolbar
select whether Toolbar displayed bottom application window; default will displayed. disable display Toolbar, select [View->Toolbar] menu option. Toolbar will disabled removed from application window display. re-enable Toolbar display, select [View>Toolbar] menu option again. Toolbar will enabled added application window display.
Section
Configuring user interface
10.5 Customizing Toolbar
customize selection arrangement buttons displayed toolbar. change display invoke [Setup->Customise>Toolbar] menu option. Customise Toolbar dialog appears:
Button categories Button operations button toolbar
Button order control
Description button's operation
Button arrangement list
Figure 10.6 Customise Toolbar Dialog 10.5.1 Button Categories left dialog list button categories, which are; File, Edit, View, Run, Setup, Tools, Window, Help. each category list possible button controlled operations listed below category. Click button operation option list will description button's operation Button Description field. 10.5.2 Adding Button Toolbar button toolbar: Select button category from button category list. Select button item from operation list. Click [>>] button.
Hitachi Debugging Interface User Manual
button added list. existing button item selected Selected Buttons list, button added after selected button list. button selected button added bottom list. 10.5.3 Positioning Button Toolbar move button position toolbar order: Select button move Selected Button list. Click button order controls move button; [Up], [Down], [Top], [Bottom] list. separator list separate blocks buttons clicking [Sep. Before] [Sep. After] buttons. 10.5.4 Removing Button from Toolbar remove button from toolbar, select button Selected Buttons list click [Remove]. button removed from list list updated.
10.6 Customizing Fonts
customize main display font text style windows (e.g. Program Memory windows), change default font that used when window opened. change display invoke [Setup->Customise->Font] menu option. This will launch Font configuration dialog box:
Figure 10.7 Font Dialog
Section
Configuring user interface
dialog based normal font selection dialog box, except that only fixed width fonts listed Font list box. command button `Use Default Font' will save current font settings font used when opening windows that already have their font settings.
10.7 Saving Session
have downloaded user code into debugging platform, have corresponding source files displayed number auxiliary windows open, then take some time setup this information next time program loaded. help with this, save current settings file. save current setting, select [File->Save Session As.] menu option. This will launch standard Windows file dialog prompting file name. files saved, session file (*.hds) target session file (*.hdt) former includes interface settings, e.g. open windows their positions, while latter includes settings specific debugging platform/user system, e.g. name debugging platform configuration. session name then displayed second entry HDI's title bar, e.g. "MANUAL":
Figure 10.8 Session Name Display already using named session, updated selecting [File->Save Session] menu option. This will overwrite current session files with latest settings. Note session file does include symbol memory information. modified information again later sessions, save symbol memory information appropriate files. details, section 4.2.10, Saving Symbol File section 5.7, Saving Area Memory.
10.8 Loading Session
reload saved session, select [File->Load Session] menu option. This will launch standard Windows file dialog prompting session file name (*.hds) associated target session file (*.hdt) will automatically loaded same time.
Hitachi Debugging Interface User Manual
currently open windows will closed, connection debugging platform initialized. user code been downloaded user system, then status will display percentage done. When download complete, windows will opened refreshed show latest information from user system.
10.9 Setting Options
There number settings available help interface. Selecting [Setup->Options] menu option will launch Options dialog box:
Figure 10.9 Options Dialog 'Tab Size' list used number spaces that character will expanded within views. Valid values between best value will same your normal editor. Exit' group radio buttons automates saving current session when program shut down: Automatically save session this will save session information current session file. there current session file then will prompted enter session file name. Prompt session save this will always want save current session when program shuts down. select 'Yes', then session information saved current session file. there current session file then will prompted enter session file name. Quit without asking this shuts down program does prompt you, save current session information.
Section
Configuring user interface
Check 'Load last session startup' check want automatically load last saved session next time program started.
10.10 Setting Default Radix
display numbers several formats. Normally would fill information fields using prefixes described section 2.2.2, Data Formats. improve usability, select these formats default, i.e. will need enter corresponding prefix that radix. change default radix, [Setup->Radix] menu option. This will display list possible numbering systems with check mark left current radix:
Figure 10.10 Setting Radix
Hitachi Debugging Interface User Manual
Section
Menus
Menus
This document uses standard Microsoft menu naming convention:
Check mark Menu Menu title Drop-down menu Menu option Ellipsis Cascading menu
Figure 11.1 Menus Check marks indicate that feature provided menu option selected. Ellipsis indicate that selecting menu option will open dialog that requires extra information entered. Refer your Windows user manual details Windows menu system.
11.1 File
File menu used aspects program that access data files. 11.1.1 Load Program. Launches Load Object File dialog box, allowing user select object file either S-record (*.mot; *.s20; *.obj extensions) SYSROF (*.abs extension) format download debugging platform's memory. This will also load symbols they available selected file. 11.1.2 Save Memory. Launches Save S-Record File dialog box, allowing user select start address memory area, save S-record format file disk. block memory highlighted Memory window, these will automatically entered start addresses when dialog displayed.
Hitachi Debugging Interface User Manual
11.1.3 Verify Memory. Launches Verify S-Record File with Memory dialog box, allowing user select start address memory area check against contents S-record file disk. 11.1.4 Save Session Updates session file current session file. there current session file defined, this acts similar manner Save Session menu option. 11.1.5 Load Session. Launches Open dialog allowing user load session from selected session file (*.hds extension). session file contains details current debugging platform, debugging platform's settings, current program position open child windows (views) contains symbols, breakpoints, current register values. 11.1.6 Save Session Launches Save dialog allowing user save current session details under file name. session file contains details current debugging platform, debugging platform's settings, current program position open child windows (views) contains symbols, breakpoints, current register values. 11.1.7 Initialise This will attempt re-initialize debugging system. will close down open child windows shut down link debugging platform. this successful, attempt re-establish link debugging platform will made. message 'Link will appear left-most status this successful. (See also section 11.4.11, Reset CPU) 11.1.8 Exit This will close down HDI. actions that carried defined user Exit' section Options dialog box. (See also section 11.5.1, Options.)
Section
Menus
11.2 Edit
Edit menu used aspects program that access modify data child windows debugging platform. 11.2.1 Only available block highlighted child window who's contents modified (shown disabled). This will remove contents highlighted block from window place clipboard standard Windows manner. 11.2.2 Copy Only available block highlighted child window (shown disabled). This will copy contents highlighted block clipboard standard Windows manner. 11.2.3 Paste Only available contents child window modified (shown disabled). This will copy contents Windows clipboard into child window current cursor position. 11.2.4 Find Only available window contains text (shown disabled). This will launch Find dialog allowing user enter word locate occurrences within text. match found, cursor will move start word. 11.2.5 Line Only available Program window source format. Launches Line dialog allowing user enter integer (i.e. line number source program) view will then scroll display this line window.
Hitachi Debugging Interface User Manual
11.2.6 Fill Memory. Launches Fill Memory dialog allowing user fill block debugging platform's memory with value. 11.2.7 Move Memory. Launches Move Memory dialog allowing user copy block debugging platform's memory address within same memory area. blocks overlap, which case data within overlapped region source block will overwritten. 11.2.8 Test Memory. Launches Test Memory dialog allowing user specify block memory test correct read/write operation. exact test target dependent. However, cases current contents memory will overwritten YOUR PROGRAM DATA WILL ERASED. 11.2.9 Update Memory Forces manual update contents open memory windows.
11.3 View
View menu used select open child windows. menu option grayed, then features provided window available with current debugging platform. 11.3.1 Toolbar Toggles toolbar feature off. feature enabled then check mark will displayed left menu text. 11.3.2 Status Toggles status feature off. feature enabled then check mark will displayed left menu text. 11.3.3 Breakpoint Window Opens Breakpoints window allowing user view edit current breakpoints.
Section
Menus
11.3.4 Command Line Window Opens Command Line window allowing user enter text based commands control debugging platform. These commands piped from batch file, results piped file, allowing automatic tests performed. 11.3.5 Register Window Opens Registers window allowing user control user system's on-chip input/output functionality, e.g. interrupt controller. 11.3.6 Local Variable Window Opens Locals window allowing user view edit values variables defined current function. contents blank unless within C/C++ source-level function. 11.3.7 Memory Mapping Window Opens Memory Mapping window allowing user view supported) edit debugging platform's current memory map. some debugging platforms, Memory dialog will open. 11.3.8 Memory Window. Launches Open Memory Window dialog allowing user specify memory block view format display within Memory window. 11.3.9 Performance Analysis Window Launches Performance Analysis window allowing user view number times that particular sections user code have been called. 11.3.10 Program Window. Launches Open Program Window dialog allowing user enter file name program either C/C++ assemblylanguage format) view. source file included within current program (see also section 11.1.1, Load Program.) there debugging information file within 'absolute' (*.abs) file, then
Hitachi Debugging Interface User Manual
message "Cannot load program. Source level debugging available" displayed. view file these circumstances [View->Text Window] menu option. 11.3.11 Register Window Opens Registers window allowing user view current registers their contents. 11.3.12 Status Window Opens System Status window allowing user view debugging platform's current status current session program names. 11.3.13 Text Window. Launches Open dialog allowing user enter name text file that wish view. 11.3.14 Trace Window Opens Trace window allowing user current trace information. 11.3.15 Watch Window Opens Watch window allowing user enter C/C++source level variables view modify their contents.
11.4
menu controls execution user code debugging platform. 11.4.1 Starts executing user code current 11.4.2 Reset Resets user system hardware sets Reset Vector address before executing user code.
Section
Menus
11.4.3 Cursor Starts executing user code current continues until equals address indicated current text cursor (not mouse cursor) position. 11.4.4 Run. Launches Program dialog allowing user enter temporary breakpoints before executing user code. 11.4.5 Step Executes block user code before breaking. size this block normally single instruction user more than instruction C/C++-source line (see also section 11.4.8, Step.). subroutine call reached, then subroutine will entered view updated include code. 11.4.6 Step Over Executes block user code before breaking. size this block normally single instruction user more than instruction C/C++-source line (see also section 11.4.8, Step.). subroutine call reached, then subroutine will entered sufficient user code will executed current position next line current view. 11.4.7 Step Executes sufficient user code reach current function next line calling function before breaking. 11.4.8 Step. Launches Step Program dialog allowing user modify settings stepping. 11.4.9 Halt Program Stops execution user code returns control user.
Hitachi Debugging Interface User Manual
11.4.10 Cursor Sets address indicated current text cursor (not mouse cursor). 11.4.11 Reset Resets user system hardware sets Reset Vector address. (See also section 11.1.7, Initialise)
11.5 Setup
Setup menu used modify settings user interface, configuration debugging platform. 11.5.1 Options. Launches Options dialog allowing user modify settings that specific (not debugging platform dependent settings). 11.5.2 Radix Cascades menu displaying list radix which numeric values will displayed entered default (without entering radix prefix). current base check mark left associated toolbar button locked down. example, current radix decimal then number will displayed "10" entered "10", "H'A", "0x0a", etc.; current base hexadecimal then number will displayed "0A" entered "A", "D'10", etc. 11.5.3 Customise Cascades menu displaying list options that customized user. Toolbar launches Customise Toolbar dialog box. Font launches standard Windows Font dialog box, allowing fixed width font selected. 11.5.4 Select Platform. Launches Select Platform dialog allowing user select debugging platform. item grayed only target
Section
Menus
present same directory program file (and that debugging platform will selected automatically when loaded). 11.5.5 Configure Platform. Launches set-up dialog specific selected debugging platform. Refer debugging platform's user manual more detail about options available dialog box.
11.6 Tools
Tools menu selects launches additional applications. following three menu options always displayed, user define their tools (e.g. find file utility) which will displayed below standard items. 11.6.1 Symbols. Launches Symbols dialog allowing user manipulate current program's symbols (labels). 11.6.2 Evaluate. Launches Evaluate dialog allowing user enter numeric expression, e.g. "(#pc 205)*2", display result currently supported radix.
11.7 Window
Window menu modifies display currently open child windows. following menu options always displayed, numbered list current child windows will appended topmost child window will have check mark. 11.7.1 Cascade Arranges child windows standard cascade manner, i.e. from left such that title each child window visible. 11.7.2 Tile Arranges child windows standard tile manner, i.e. sizes each window such that displayed without overlapping.
Hitachi Debugging Interface User Manual
11.7.3 Arrange Icons Lines iconized windows neatly along bottom parent frame standard manner. 11.7.4 Close Closes child windows.
11.8 Help
Help menu accesses additional information functionality provided HDI. 11.8.1 Index Opens main help file index. 11.8.2 Using Help Opens help file allowing user find Windows' hypertext help system. 11.8.3 Search Help Opens main help file launches Search dialog allowing user enter browse through file's keywords. 11.8.4 About Launches About dialog allowing user view version currently loaded DLLs.
Section
Windows
Windows
This section describes each child window type, features that each window supports options available through their associated pop-up menu.
12.1 Breakpoints
Figure 12.1 Breakpoints Window Allows user view control current breakpoints view hardware breakpoint resources. more information regarding supported breakpoint types resources, refer Debugging Platform User's Manual. functionality command buttons identical pop-up menu options shown below; while global enabling breakpoints only available using check window. pop-up menu containing following options available rightclicking within window. 12.1.1 Help Launches help file index controlling breakpoints.
Hitachi Debugging Interface User Manual
12.1.2 Launches Breakpoint/Event Properties dialog allowing user enter breakpoint. dialog dependent debugging platform. 12.1.3 Edit Only enabled breakpoint selected. Launches Breakpoint/Event Properties dialog allowing user modify properties existing breakpoint. dialog dependent debugging platform. 12.1.4 Delete Only enabled breakpoint selected. Removes selected breakpoint. retain details breakpoint have cause break when conditions met, Disable option (see section 12.1.6, Disable/Enable). 12.1.5 Delete Removes breakpoints from list. 12.1.6 Disable/Enable Only enabled breakpoint selected. Toggles selected breakpoint between enabled disabled (when disabled, breakpoint remains list, does cause break when specified conditions satisfied). When breakpoint enabled, check mark shown left menu text (and shown Enable column breakpoint).
Section
Windows
12.2 Command Line
Figure 12.2 Command Line Window Allows user control debugging platform sending textbased commands instead window menus commands. useful series predefined commands need sent debugging platform calling them from batch file and, optionally, recording output file. information about available commands, refer on-line help. functionality command buttons identical pop-up menu options shown below. 12.2.1 Stop Stops executing batch file returns control user. 12.2.2 Batch File Launches Batch File dialog box, allowing user enter name command file (*.hdc). 12.2.3 File Launches Open File dialog box, allowing user enter name file (*.log). logging option automatically name file shown window, e.g. Logging MANUAL.LOG".
Hitachi Debugging Interface User Manual
Opening previous file will user they wish append over-write current log. 12.2.4 Logging Toggles logging file off. When logging active, check mark shown left menu text (and check window set). Note that contents file cannot viewed until logging completed, temporarily disabled clearing check box. Re-enabling logging will append file.
Section
Windows
12.3 Registers
Figure 12.3 Registers Window Allows user view control user system hardware's on-chip peripherals. peripherals organized modules, level displayed detail changed with plus indicating that information expanded double-clicking variable name, minus indicating that information collapsed. pop-up menu containing following options available rightclicking within window: 12.3.1 Copy Only available block text highlighted. This copies highlighted text into Windows clipboard, allowing pasted into other applications. 12.3.2 Edit. Launches dialog modify selected register's contents. 12.3.3 Expand/Collapse Expands/collapses selected module. 12.3.4 Help Launches help file index Register window.
Hitachi Debugging Interface User Manual
12.4 Locals
Figure 12.4 Locals Window Allows user view modify values local variables. contents this window blank unless current associated C/C++-source file debugging information available object file. variables listed with plus indicating that information expanded double-clicking variable name, minus indicating that information collapsed. more information display information, refer section 8.2.2, Expanding Watch. pop-up menu containing following options available rightclicking within window: 12.4.1 Copy Only available block text highlighted. This copies highlighted text into Windows clipboard, allowing pasted into other applications. 12.4.2 Edit Value Launches dialog modify selected variable's value.
Section
Windows
12.5 Memory Mapping
Figure 12.5 Memory Mapping Window Allows user view modify debugging platform's memory view memory configuration resources. some debugging platforms, Memory dialog will open. functionality command buttons basically same pop-up menu options shown below, pop-up menu options depend debugging platform. 12.5.1 Launches Edit Memory Mapping dialog allowing user enter details memory area map. Grayed debugging platform does support editing maps. 12.5.2 Change Launches Edit Memory Mapping dialog allowing user modify details currently selected memory map. Grayed debugging platform does support editing maps. 12.5.3 Reset Returns information debugging platform's default values. Grayed debugging platform does support editing maps. 12.5.4 Help Launches help file index Memory Mapping window.
Hitachi Debugging Interface User Manual
12.6 Memory
Figure 12.6 Memory Window Allows user view modify contents debugging platform's memory. Memory viewed ASCII, byte, word, longword, single-precision floating-point, double-precision floating-point formats, title indicates current view style closed previous label (symbol). contents memory edited either typing current cursor position, double-clicking data item. latter will launch Edit dialog box, allowing user enter value using complex expression. data that address cannot modified (i.e. within ROM) then message "Invalid address value" displayed. Double-clicking within Address column will launch Address dialog box, allowing user enter address. Clicking [OK] button will update window that address entered Address dialog first address displayed top-left corner. pop-up menu containing following options available rightclicking within window: 12.6.1 Copy Only available block memory highlighted. This copies highlighted text including address into Windows clipboard, allowing pasted into other applications. 12.6.2 Find Launches Find Memory dialog box, allowing user search block debugging platform's memory specified data value. block memory highlighted, start fields dialog
Section
Windows
will filled automatically with start addresses corresponding highlighted block, respectively. 12.6.3 Fill Launches Fill Memory dialog box, allowing user fill block debugging platform's memory with specified value. start fields similarly Find option. 12.6.4 Move Launches Move Memory dialog box, allowing user copy block memory within debugging platform another location within same memory space. blocks overlap. start fields similarly Find option. 12.6.5 Test Launches Test Memory dialog box, allowing user validate block memory within debugging platform. details test depend debugging platform. start fields similarly Find option. 12.6.6 Save Launches Save S-Record File dialog box, allowing user save block debugging platform's memory S-record file (*.mot). start fields similarly Find option. 12.6.7 Address Launches Address dialog box, allowing user enter start address. window will updated that this first address displayed top-left corner. When overloaded function class name entered, Select Function dialog appears select function. 12.6.8 ASCII/Byte/Word/Long/Single Float/Double float check mark next these options indicates current view format. user select different option change that format.
Hitachi Debugging Interface User Manual
12.7 Performance Analysis
Figure 12.7 Performance Analysis Window Allows user view control performance analysis data. items displayed default cannot deleted modified user. display contents operation depend debugging platform. supplied Debugging Platform User's Manual more information. pop-up menu containing following options available rightclicking within view area: 12.7.1 Range Launches Range dialog box, allowing user user range based either source lines address range. name range edited. 12.7.2 Edit Range Only enabled when highlighting user-defined range. Launches Edit Range dialog box, allowing user modify range's settings. 12.7.3 Delete Range Only enabled when highlighting user-defined range. Deletes range immediately recalculates data other ranges. 12.7.4 Reset Counts/Times Clears current performance analysis data. 12.7.5 Delete Ranges Deletes current user-defined ranges, clears performance analysis data. 12.7.6 Analysis Enabled Toggles collection performance analysis data. When performance analysis active, check mark shown left text.
Section
Windows
12.8 Program
format this window three different formats source, mixed, assembly-language. source format used view source file that included within absolute (*.abs) file debug information this C/C++, assembly-language, etc. mixed format similar layout source format, also displays instructions associated with each line code. This useful when stepping through program assembly level. assembly-language format different layout other two, with additional column Label which displays symbol name available) that address. Assembler information obtained disassembling memory contents, edited viewed directly from memory without requiring debug information from object file. there associated source file, window's title "Code".)
Figure 12.8 Source Format
Figure 12.9 Assembly-Language Format
Hitachi Debugging Interface User Manual
formats support column-specific double-click actions: Address Launches Address dialog box, allowing user enter address. address within range this file, then view will scroll such that cursor positioned correctly. address different source file, then that file will opened window with cursor specified address. Finally, address does correspond source file, then window will opened assembly-language format entitled 'Code'. When overloaded function class name entered, Select Function dialog appears select function. Break Sets/clears program (PC) breakpoint that address. Code (Assembly-language format only.) Launches Assembler dialog allowing user modify instruction that address. Note that changes machine code modify source file, changes will lost session. Label (Assembly-language format only.) Launches Label dialog box, allowing user enter label, clear edit name existing label. Assembler (Assembly-language format only.) Launches Assembler dialog allowing user modify instruction that address. Note that changes instruction modify source file, changes will lost session. pop-up menu containing following options available rightclicking within window: 12.8.1 Copy Only available block text highlighted. This copies highlighted text into Windows clipboard, allowing pasted into other applications. 12.8.2 Find Launches Find dialog box, allowing user search source file string. only available source view format.
Section
Windows
12.8.3 Line Launches Line dialog box, allowing user display move text cursor specific line. only available pure source view format. 12.8.4 Cursor Commences execute user code starting from current address. program will continue until reaches address indicated text cursor (not mouse cursor) another break condition satisfied. Grayed supported debugging platform. 12.8.5 Here Changes value address indicated text cursor (not mouse cursor). 12.8.6 Toggle Breakpoint Sets/clears software breakpoint address indicated text cursor (not mouse cursor). This equivalent double-clicking within Break column. (Additional break point types available depending selected debugging platform this case, list will cycled through.) 12.8.7 Instant Watch Only available source mixed formats. Launches Instant Watch dialog with name extracted from view current text cursor (not mouse cursor) position. 12.8.8 Watch Only available source mixed formats. Adds name extracted from view current text cursor (not mouse cursor) position list watched variables. Watch window open, then opened brought child windows. 12.8.9 Source/Mixed/Assembler check mark next these options indicates current view format. user select different option change that format.
Hitachi Debugging Interface User Manual
12.9 Registers
Figure 12.10 Registers Window Allows user view modify current register values. pop-up menu containing following options available rightclicking within window: 12.9.1 Copy Only available block text highlighted. This copies highlighted text into Windows clipboard, allowing pasted into other applications. 12.9.2 Edit Launches Register dialog box, allowing user value register indicated text cursor (not mouse cursor). 12.9.3 Toggle Only available text cursor placed bit-field, e.g. flag within status register. Changes current state other state, e.g. overflow flag cleared.
Section
Windows
12.10 System Status
Figure 12.11 System Status Window Allows user view current status debugging platform. text consists sections standard section (from Emulator Cause last break) debugging platform dependent section. supplied Debugging Platform User's Manual more information about latter section. pop-up menu containing following options available rightclicking within window: 12.10.1 Update Updates displayed data. 12.10.2 Copy Only available block text highlighted. This copies highlighted text into Windows clipboard, allowing pasted into other applications. 12.10.3 Configure. Launches setup dialog specific selected debugging platform. Refer supplied Debugging Platform User's Manual more detail about options available dialog box.
Hitachi Debugging Interface User Manual
12.11 Text
Figure 12.12 Text Window Allows user view text file, e.g. file source code without debugging information available. window read-only. pop-up menu containing following options available rightclicking within window: 12.11.1 Copy Only available block text highlighted. This copies highlighted text into Windows clipboard, allowing pasted into other applications. 12.11.2 Find Launches Find dialog box, allowing user search text file string.
Section
Windows
12.12 Trace
Figure 12.13 Trace Window Allows user view sequence instructions leading debugging platform's current status. functionality command buttons identical pop-up menu options shown below. 12.12.1 Find Launches Trace Search dialog box, allowing user search current trace buffer specific trace record. 12.12.2 Find Next find operation successful, item found non-unique, then this will move next similar item. 12.12.3 Filter Launches Filter Trace dialog box, allowing user mask unnecessary trace entries. 12.12.4 Acquisition Launches Trace Acquisition dialog box, allowing user define area user code traced. This useful focus tracing problem areas.
Hitachi Debugging Interface User Manual
12.12.5 Halt Stops tracing data updates trace information without stopping execution user code. 12.12.6 Restart Starts tracing data. 12.12.7 Snapshot Updates trace information show debugging platform's current status without stopping user code execution. 12.12.8 Clear Empties trace buffer debugging platform. more than trace window open, trace windows will cleared they access same buffer. 12.12.9 Save Launches Save file dialog box, allowing user save contents trace buffer text file. possible define numeric range based Cycle number save complete buffer (saving complete buffer take several minutes). Note that this file cannot reloaded into trace buffer.
Section
Windows
12.13 Watch
Figure 12.14 Watch Window Allows user view modify C/C++-source level variables. contents this window blank unless current user code associated C/C++-source file debugging information available object file (*.abs). variables listed with plus indicating that information expanded double-clicking variable name, minus indicating that information collapsed. pop-up menu containing following options available rightclicking within windows: 12.13.1 Copy Only available block text highlighted. This copies highlighted text into Windows clipboard, allowing pasted into other applications. 12.13.2 Delete Watch Removes variable indicated text cursor (not mouse cursor) from watch window. 12.13.3 Watch Launches Watch dialog box, allowing user enter variable expression watched.
Hitachi Debugging Interface User Manual
12.13.4 Edit Value Launches Edit Watch dialog box, allowing user change variable's value. Particular care should taken when value pointer changed longer point valid data.
Appendix
System Modules
Appendix System Modules
following section describes architecture debugging system.
graphical user interface
Object
Debugging platform Target file
Monitor
Emulator
Simulator
User system hardware
User code (object file)
Figure System Modules normal operation, user code will placed directly into target hardware (for example EPROM). uses this information provide Windows based debugging system. decrease learning curve when swapping between different debugging platforms and/or user system hardware, provides single unified interface (the GUI) family target specific modules. Normally, user will only interact with standard once appropriate target module been selected, rest system configures itself automatically loading appropriate modules. Graphical User Interface This main HDI.EXE program that runs under Windows. uses familiar Windows operations, with menus windows give userfriendly view into debugging system. only contact
Hitachi Debugging Interface User Manual
Other recent searches
ZABB10A2 - ZABB10A2 ZABB10A2 Datasheet
STP08C596 - STP08C596 STP08C596 Datasheet
SNC26031 - SNC26031 SNC26031 Datasheet
SN54HC165 - SN54HC165 SN54HC165 Datasheet
Si4823DY - Si4823DY Si4823DY Datasheet
PA78EU - PA78EU PA78EU Datasheet
ADS1245 - ADS1245 ADS1245 Datasheet
Privacy Policy | Disclaimer
© 2012 Datasheet Archive
