Home

MN101C00 Series C Source Code Debugger for WindowsR

1. Child Code Line no The Set line no dialog box is for specifying the starting line number for the source code in a Code window Enter the line number Set line no 5 21 Dialog Boxes 116 Child Code Child RAM Monitor Address The Address Code RAM Monitor dialog box is for specifying the starting address for the disassembler output in the Code window or RAM Monitor window Enter the address Child Command History The Command History dialog box is for selecting from commands previously entered in the Command window If there is text at the current prompt on the command line only commands beginning with that text are displayed Command History x bp main ex sd IR b 5 21 Dialog Boxes Chapter 5 Window Commands 117 Child Commana Exp Sym The Expand Symbol dialog box displays a list of command lines formed by completing the current partial command line with all global symbols starting with the word at the end of the command line The following example is for the partial command line ins P ins Procl ins Proc2 ins Proc ins Procd ins Proc5 ins Proc y Child Memory Address The Addressing Memory dialog box is for specifying the starting address for the dump list in a Memory window bailo Enter the address Specify the number of columns 5 21 Dialog Boxes 118 Child Memory Enter Data
2. ees 149 Exp Sym command eer 87 162 Expand Symbol dialog box sess 124 Expressions with Side Effects sss 142 External breakpoint command sss 101 External dimensions sse 155 F commarid A nes 148 File Po us command aaa 84 File Open dialog box eee 117 Fil s Saved at Bxit recette ee entres 45 Pile al 64 Files Necessary for Loading se 44 Pind jeomimnand e eec ri t e EE e i s 66 Find String dialog box eee 120 Flags dialog box eene 126 Flip command creen ise 84 Flyover Hints command eene 66 Font dialog box eee eed etin ee 118 Font Select command osse o Hp ERO Cet ect 73 FOR commandes iere 152 Forcible BreakJcommand eee sees ees ee ee Re 67 Function FocusJcommand eee sesse sees ee ee 84 Function step command eee 67 Functional Specifications sss 154 Gicommand op reds te ecce e te A dad 81 145 Global Symblos RE N OE terrenis 131 Go command AAA 67 Hcommand sesse nai 149 Hard Ware tives EO 16 Hardware breakpoins command 101 Hardware Breakpoint dialog BOX sesse esse see see se ee 127 Hardware Related Commands sss 147 HELEP commard eno o
3. eese 91 5 11 2 BackTrace Window Local Menu ee GR ee ER Re ee RA GR Re ee ER Re ee ee ee 92 5 11 3 BackTrace Window Mouse Operations esse esse ee se ee ee Re ee Ge ee nennen 92 5 12 Watch Window EE NE EER EE Ee Ge RUE Nee Coetus 93 5 12 1 Watch Window Shortcut Keys iese esse ee se ee ee Re ee GR RA ee GR RA ee enne 93 5 12 2 Watch Window Local MENU ee se ee RR GR AA ER Re ee ER Re ee Ge ee ee ee Re ee ee ee 94 5 12 3 Watch Window Mouse Operations ccescceecceceseceeececeseceeeeeceaeeeeeeecsaeeeeneeee 94 53 13 Bieak Window e eae mer ee te nr HER tea 95 CONTENTS 5 13 1 Break Window Shortcut Keys es se ee ee ee RA ee nennen 95 5 13 2 Break Window Local Menu sees se ee Ee AR ee ER Re Ge AA Ge ee ER Re ee Ge ee 96 5 13 3 Break Window Mouse Operations iese esse esse ee se ee ee GR Re ee enne 97 14 Trace Window ss sae ner eene ertet OER EE 98 5 14 1 Trace Window Shortcut Keys iese esse ee se ee ee RA ee ee GR AA ee GR Re nne nnne 98 5 14 2 Trace Window Local MENU ee se ee RR GR AA ER Re ee ER Re ee GR ee ener ee ee 99 2 I5 Inspect Windows EE De ree dete qu e EG be e te Se as 100 5 15 1 Inspect Window Shortcut Keys 100 5 15 2 Inspect Window Local MENU esse se ee ee ee ee ee RA ee RA nennen 101 5 15 3 Inspect Window Mouse Operations ese ee se se oe ee ee Ge ee ee ee ee ee ee 101 5 16 Memo Window AE RE EE EE OE EE teret
4. Pana N Series TheOnetoWatch for Constant Innovation Making the Future ComeAlive MICROCOMPUTER MN101C00 MN101C00 Series C Source Code Debugger for Windows User s Manual Pub No 11431 012E Panasonic MS DOS is a registered trademark of Microsoft Corporation Windows is a trademark of Microsoft Corporation PanaXSeries is a trademark of Matsushita Electric Industrial Co Ltd The other corporation names logotype and product names written in this book are trademarks or registered trademarks of their corresponding corporations Request for your special attention and precautions in using the technical information and semiconductors described in this book 1 An export permit needs to be obtained from the competent authorities of the Japanese Government if any of the products or technologies described in this book and controlled under the Foreign Exchange and Foreign Trade Law is to be exported or taken out of Japan 2 The contents of this book are subject to change without notice in matters of improved function When finalizing your design therefore ask for the most up to date version in advance in order to check for any changes 3 We are not liable for any damage arising out of the use of the contents of this book or for any infringement of patents or any other rights owned by a third party 4 No part of this book may be reprinted or reproduced by any means without written permission from our company
5. eese 91 Shortcut Keys oie ete s 90 Reload command ci Le C Dr RR ERI eR 64 87 REPEAT command esee 152 Reset command eo eer rrr ore in nen 64 87 BESET c mmiand nece eR die 145 Er AAA 73 Right button click esee TI ROM and RAM sees se se kk Ge Ge Re Ge Ge RR Ge Ge ee Ge 17 Run Installation Program eee 27 I un Oen cet e ti ee ib t Ge ed ee ge 67 Running User Program Commands sse 145 7 Bu X S comimand ice e etr ee Det 149 SALE comtiand rere tener 151 Save Setting command ee 101 Save Setup sa i ei rete a eR IRI EE EUR Ge RE ed 37 Create a New Environment sese 40 Modifying an Existing Environment 43 Upgrading from MS DOS R Version 42 Saving Command History window contents 45 Saving Memo window contents sees 45 Scope of C Variables see 140 Screen Control Miscellaneous Commands 151 Screen Display A Re eee tee 62 Sct en Latas 60 E oo EE GE eg Ak 66 Select Color comratid i acre 73 Select working directory sese 37 Creating a New Environment eee 39 Upgrading from MS DOS Version sss 41 Set Data dialog box esee 125 Set Inspect data dialog box esses 121 Set li
6. Head Office PICM Tingkat 16B Menara PKNS PJ No 17 Jalan Yong Shook Lin 46050 Petaling Jaya Selangor Darul Ehsan Malaysia Tel 03 7516606 Fax 08 7516666 Penang Office Suite 20 17 MWE PLAZA No 8 Lebuh Farquhar 10200 Penang Malaysia Tel 04 2625550 Fax 04 2619989 Johore Sales Office 39 01 Jaran Sri Perkasa 2 1 Taman Tampoi Utama Tampoi 81200 Johor Bahru Johor Malaysia Tel 07 241 3822 Fax 07 241 3996 E CHINA SALES OFFICE Panasonic SH Industrial Sales Shenzhen Co Ltd PSI SZ 7A 107 International Business amp Exhibition Centre Futian Free Trade Zone Shenzhen 518048 Tel 755 359 8500 Fax 755 359 8516 Panasonic Industrial Shanghai Co Ltd PICS 1F Block A Development Mansion 51 Ri Jing Street Wai Gao Qiao Free Trade Zone Shanghai 200137 Tel 21 5866 6114 Fax 21 5866 8000 E THAILAND SALES OFFICE Panasonic Industrial Thailand Ltd PICT 252 133 Muang Thai Phatra Complex Building 31st Fl Rachadaphisek Rd Huaykwang Bangkok 10320 Tel 02 6933407 Fax 02 6933423 080499
7. Use this symbol to detect user program breaks in macros C Source Code Debugger Win supports numbers in binary octal decimal and hexadecimal notations and uses prefixes to distinguish between them If there is no prefix it uses the radix specified with the N command i num hexadecimal number Oxnum hexadecimal number n m interpreted according to current radix 16 or 10 For example 11001010 Y312 202 CA and OxCA all specify the same numerical value There are also commands DS DL DT SS SL and ST that take floating point values Commands and dialog boxes that take addresses as parameters accept as input not just direct address values but also symbol names and as described in the next section line numbers 6 1 Data Expressions Chapter 6 Dialog Command Data 127 6 1 7 Line Numbers C Source Code Debugger Win supports debugging at the source level using line numbers from the source file Line numbers are used to specify locations in source files They are only available however when the debugging information loaded with the user program includes them There are three formats for entering line numbers 1 file name line number 2 plus minus line number 3 symbol plus minus line number These line number specifications consist of a decimal number line number or number of lines following a file name or symbol and specify a particular line in a source file for the program be
8. lt type gt B Byte 8 bit data W Word 16 bit data D Double word 32 bit data S 4 byte real number short float data E Nybble 4 bit data F lt type gt lt range gt lt data gt Fills the specified range with data of the specified type lt type gt B Byte 8 bit data W Word 16 bit data D Double word 32 bit data 7 2 Commands Grouped by Function Chapter 7 Dialog Command Reference 143 S lt type gt lt range gt lt list gt Searches the specified range for the specified memory pattern using the specified format lt type gt B Byte 8 bit data W Word 16 bit data D Double word 32 bit data C lt range gt lt address gt Compares the specified range with the range starting at the specified address M lt range gt lt address gt Moves the data in the specified range to the block starting at the specified address A lt address gt Begins assembly at the specified address N 10 16 Sets the input radix to decimal or hexadecimal H lt expression gt Displays the value of the expression in octal decimal hexadecimal ASCII and real number formats H lt expression 1 gt lt expression 2 gt Displays the sum and difference of the two expressions PF PRINTF lt format gt lt parameter gt Displays the specified parameters using C s printf function RD file name address Reads the specified file into memory starting at the specified address WR file name gt lt ra
9. R 5 21 15 Register Dialog Box 5 21 16 Flags Dialog Box Displays the register contents in decimal 5 8 Register Window Chapter 5 Window Commands 87 5 8 2 Register Window Local Menu Child Register The Child Register menu contains commands for controling the Zero F3 p Register window Decrement Change Decimal F9 Symbol F6 Memory p Menu Item Function Zero Zeros the register at the current cursor position Increment Increments the register at the current cursor position Decrement Decrements the register at the current cursor position Displays the dialog box for modifying the register at the current cursor position or CPU flags R 5 21 15 Register Dialog Box 5 21 16 Flags Dialog Box Decimal Toggles the register display between decimal and hexadecimal formats Symbol Displays the symbol corresponding to the register value Memory Toggles the display of the contents of the memory location whose address is in the register 5 8 3 Register Window Mouse Operations Double clicking the left mouse button on a register or CPU flag displays a dialog box for modifying the contents R 5 21 15 Register Dialog Box 5 21 16 Flags Dialog Box 5 8 Register Window 88 5 9 Stack Window The Stack window displays the current stack contents Figure 40 Stack Window 5 9 1 Stack Window Shortcut Keys The Stack window provid
10. information contained in the debugging information 6 2 4 Constants Constants follow the C specifications The default radix is always 10 regardless of any setting made with the N command for modifying the radix oum 8 For example 4096 decimal 0x1000 hexadecimal and 010000 octal all represent the same value C escape sequences may be used to define character constants nnn nn var mm Orta number 8 bit Poni mm Hexadecimal number E bio 6 2 Data Expressions Using C Syntax 134 6 2 5 Operators C Source Code Debugger Win supports C operators and C operator syntax It supports all operators except the assignment operators for floating point values The operators have the following precedence Precedence Operators Level function n array n n n n gt n n n If two operators have the same precedence they group from left to right Note however that only the assignment operators precedence level 16 group from right to left and that parentheses may be used to override this precedence order 6 2 Data Expressions Using C Syntax Chapter 6 Dialog Command Data 135 6 2 6 Expressions with Side Effects C expressions containing assignment operators or function calls have side effects lt em_dash gt that is they change the contents of variables While there are times when you may wish to deliberately change the contents of a variable with an assignment operator debugg
11. Command Window This window is for entering dialog commands and displaying execution results using a traditional TTY interface 5 1 Screen Layout Chapter 5 Window Commands 59 This window displays memory contents It is automatically updated when the CPU stops Register Window This window displays the contents of the CPU registers It is automatically updated when the CPU stops Stack Window This window displays the stack contents It is automatically updated when the CPU stops Local Window This window displays the contents of the local variables for the C function that the program counter PC is currently accessing It is automatically updated when the CPU stops Watch Window This window displays the contents of watch data It is automatically updated when the CPU stops This window displays the call history for the current C function It is automatically updated when the CPU stops Break Window SI This window lists the currently specified breakpoints Memo Window mi This window is a simple editor for taking notes during debugging C Source Code Debugger Win automatically saves the contents at exit Inspect Window This window displays the contents of variables for inspection Trace Window This window displays a dump of real time trace memory or disassembler output 5 1 Screen Layout 60 RAM Monitor Window This window displays a real time dump of memory while t
12. Command History window eee 45 Command li oo aa 48 Command reference iieri eee ete tee 143 Commands grouped by function sss 145 Command window essere 85 Eocalqmefti z5iazemneio iid 68 87 Shortcut Keys iii 85 COMPE ti AA 55 Configuring Interface Board se ee ee se 156 Connect in circuit emulator sese 26 Constants sre AS 140 Convert to ROM ce e er e p e Re 55 Copy command eee 65 109 Copy Page command eene 65 Copyn files se eet eet ehe eed Ee suis 33 Cr al a Shortcut bees Re d LR 37 Create a New Environment sese 40 Modifing an Existing Environment 43 Upgrading from MS DOS R Version 42 Create environment settings file sesse sesse se ee 37 46 Create a New Environment sse 39 Modify an Existing Environment esse sesse esse see see ese 43 Custm ToolBar command ee ee 73 ii AAA ee eg 65 109 D eommarid teria ninas 148 Data Expressions eese 131 Data Expressions Using C Syntax eee 138 Debugger Does Not Load eee 52 161 Debugger features eee o Ge De DE ee ee 14 Debugger overview esse ee ee GR ee ee 13 168 Decimal command ccooocnnnnonoccnonancnonnnononanacnnanans 89 91 111 Decrement commiatid a
13. Adjust the blue component indow Code Window Code Text Code Line No Search Find The Find String dialog box is for entering the search text and the search direction for the window that currently has the focus Specify the search direction Find String Enter the search string a The default search direction is lt Upward gt for the Command window and lt Downward gt for the m others 5 21 Dialog Boxes 114 Child Code Child Local Child Watch Inspect Inspect The Set Inspect data dialog box is for specifying a variable to inspect Set Inspect data Enter the name of the variable to inspect Child Code Child Local Child Watch Inspect Watch The Set Watch data dialog box is for specifying a variable to watch Set Watch data cli Enter the name of the variable to watch Only C variables may be specified in these dialog boxes To specify arbitrary locations in m memory use the W command For further details see the on line help 5 21 Dialog Boxes Chapter 5 Window Commands 115 File Child Code Module The Module dialog box is for selecting a source code module for the loaded user program for display in a Code window The Module name list box contains the names of all files specified in the debugging information within the loaded user program plus those added with the V command This panel lists the available files
14. Code windows 3 4 Specify Starting Options Chapter 3 Using Debugger for First Time 47 3 4 2 Specifying Starting Options via Command Line C Source Code Debugger Win starting options are normally specified via the Pset101C Options dialog box The specified starting options are then automatically added to the command line generated by clicking on the shortcut You can however also modify these without using Psetl01C For Windows 95 right click the mouse on the icon select Properties and edit the Target text box For Windows V3 1 use Program Manager s Icon Properties command and edit the Command line text box on the Program Item Properties dialog box C Source Code Debugger Win supports the following starting options B option This option specifies the sizes of the two buffers for debugging information and for macro definitions The debugging information area holds a wealth of information global symbols local symbols line numbers and type information for functions and variables for example B size D gt lt size M gt lt size D gt Size of the debugging information area in 16 kilobyte units The default is 512 kilobytes lt size M gt Size of macro definition area in 1 kilobyte units The default is 2 kilobytes D option This option specifies the current directory for C Source Code Debugger Win The specified directory must contain the environment settings file PICE101C ENV the
15. Data Expressions described how assembler like expressions based on global symbols local symbols and line numbers may be used to express addresses These expressions are supported by virtually all dialog commands The program being debugged however uses expressions following C syntax and these expressions cover a wider range C Source Code Debugger Win therefore adds support for C syntax to the following dialog and window commands inspect commands watch commands VAL command and command 6 2 1 C Expressions Commands that support C syntax interpret expressions differently from those using the syntax described in Section 6 1 Data Expressions To see the difference consider the following expressions based on the C global variable abc gt d abc Display memory starting at variable abc 3628 00 01 02 03 gt d abc 10 Display memory starting at address 10 bytes past variable abc 3638 AA BB CC DD gt abc Display value of variable abc expression evaluated using C syntax int 1 0x1 gt abc 10 f Display value of variable abc plus 10 expression evaluated using C syntax int 11 0xB gt This example illustrates how the same expressions abc and abc 10 have different meanings depending on whether they are evaluated with assembler D command or C command syntax The inspect commands watch commands VAL command and command interpret abc as a C variable The other commands interpret it as
16. If you have any inquries or questions about book or our semiconductors please contact one of our sales offices listed at tha back of this book or Matsushita Electoronics Corporation s Sales Department CONTENTS Chapter 1 Overview Chapter 2 Installation Chapter 3 Using Debugger for First Time Chapter 4 Creating User Program to Debug Chapter 5 Window Commands Chapter 6 Dialog Command Data Expressions Chapter 7 Dialog Command Reference Chapter 8 Appendices INDEX About This Manual This manual is for those debugging software for the MN101C00 series Chapters 1 through 3 describe the overall features of the C Source Code Debugger for Windows installation and loading for the first time Chapter 4 outlines the procedure for preparing a C program for debugging Chapter 5 contains detailed explanations of debugger windows their on screen elements and operations Chapters 6 covers data expressions for the dialog commands used in the Command Chapter 7 is a command reference for dialog commands Chapter 8 contains three appendices covering the in circuit emulator specifications interface board settings and error messages Finding Information This manual provides four different aids for rapidly finding necessary information 1 2 3 4 The thumbnail index at the front of the manual indicates the beginnings of chapters The table of contents at the front of the m
17. Illegal operand An assembler instruction entered with the A command has an error in operand syntax Invalid environment A problem with the environment settings prevents loading the user program Invalid function format The function is in a format not supported by C Source Code Debugger Win Invalid function name Either the specified function is not in the symbol table or a local symbol automatic variable was not declared at the beginning of the function Command error C Source Code Debugger Win does not recognize the specified command as an internal command or macro 8 3 Error Messages Chapter 8 Appendices 153 Invalid command format There is a mistake in input format parameter specifications or number of parameters for the command Sampling data not available This message appears when you attempt to display profiler statistics before running the profiler No such setting There is an error in the breakpoint number specification Cannot find specified file The debugger cannot find the file specified on the command line Cannot open specified file The debugger cannot open the specified file Check whether the file actually exists This message also appears when you have too many files open Error evaluating C expression The and VAL commands display this error when there is an error in the C expression Cannot find C variable The and VAL commands display this error when they cannot
18. Setting up such complex operations as a hardware breakpoint or a real time trace involves only simple mouse operations within the corresponding dialog box 1 1 2 Powerful Data Display Editing Functions This new version features greatly enhanced facilities for displaying and editing data Moving the mouse cursor to a variable array or bit value in a Code window and double clicking for example is all that it takes to open the Inspect window for viewing and editing the corresponding data in the appropriate data structure Data display editing is equally easy in the Watch Local Register and Memory windows 1 1 3 Tool Bar Buttons on the user configurable tool bar provide instant access with a single mouse click to such frequently used commands as those for loading the user program to be debugged running it and inspecting a variable 1 1 4 User Customization The tool bar text fonts display colors window layouts etc are all freely configurable Up to three window layouts may be defined 1 1 Features Chapter 1 Overview 15 On the fly support allows you to set breakpoints specify display traces and display edit data in RAM without stopping the user program You can thus debug without halting operation of the target CPU The debugger supports a macro language with such C like control structures as if for while and do Macros combine multiple commands into a single new command Together with breakpo
19. The Set Data dialog box is for modifying the contents of memory Set Data Enter the data Enter the address a Clicking the mouse on the OK button modifies the data and advances to the next address n To close this dialog box click the mouse on the Cancel button Child Register Change The Register dialog box is for modifying the contents of the selected register Enter the value 5 21 Dialog Boxes Chapter 5 Window Commands 119 Child Register Change The Flags dialog box is for modifying the CPU flags Unchecked flags are 0 Checked flags are 1 Child Trace Event The Event dialog box is for specifying real time trace events Select the trace mode Select the trace option Select the trace status Select the area mode Enter the delay trigger count 5 21 Dialog Boxes 120 Child Break Hardware breakpoint The Hardware Breakpoint dialog box is for setting up a hardware breakpoint Hardware Breakpoint Enter the address Select the breakpoint status Specify the data breakpoint conditions Enter the data breakpoint value Enter the pass count Enter the command to be executed at the breakpoint Select match or non match for the data breakpoint Child Break Add The Set Software Breakpoint dialog box is for setting up a software breakpoint Enter the address
20. Windows initialization file sse 44 Windows V3 1 Installation 28 WM command eese 150 Word ionitatid uec o ROS CORRER HR 89 Working directory i e ese see ee ee AR GR Re ee ee Ge Re 37 WR command rrt ie 149 X commande eee C e es 150 Y command ies osten RR RB Hd 150 Zero command o aeo edo ERR P ERROR C On a e Udine e ud 91 Zoom in out command scan 111 MN101C00 Series C Source Code Debugger for Windows Users Manual October 1999 1st Edition 2nd Printing Issued by Matsushita Electric Industrial Co Ltd O Matsushita Electric Industrial Co Ltd Semiconductor Company Matsushita Electronics Corporation Nagaokakyo Kyoto 617 8520 Japan Tel 075 951 8151 http www mec panasonic co jp SALES OFFICES E U S A SALES OFFICE Panasonic Industrial Company PIC New Jersey Office 2 Panasonic Way Secaucus New Jersey 07094 Tel 201 392 6173 Fax 201 392 4652 O Milpitas Office 1600 McCandless Drive Milpitas California 95035 Tel 408 945 5630 Fax 408 946 9063 Chicago Office 1707 N Randall Road Elgin Illinois 60123 7847 Tel 847 468 5829 Fax 847 468 5725 Atlanta Office 1225 Northbrook Parkway Suite 1 151 Suwanee Georgia 30174 Tel 770 338 6940 Fax 770 338 6849 San Diego Office 9444 Balboa Avenue Suite 185 San Diego California 92123 Tel 619 503 2940 Fax 619 715 5545 E CANADA SALES OFFICE Panasonic Canada Inc PCI 5700 Ambler Drive Mi
21. automatic variables is full Restart C Source Code Debugger Win using the B command line option to specify a larger buffer Cannot find local variable You have used a symbol name that has not been defined as a local symbol 8 3 Error Messages Chapter 8 Appendices 157 Failure to get chip bus Evaluation chip serial error Check the power supply oscillator and cable connections Failure to release chip bus Evaluation chip serial error Check power supply oscillator and cable connections There was an error while the microcomputer pod and probe was communicating with the device Check the power supply oscillator and cable connections If such errors persist contact your nearest Matsushita representative Failure to stop program at single step Run RESET command There is no RTS instruction matching a JSR instruction Failure to get mail There has been a serial error Check the cable connections between the in circuit emulator and the POD mailflg is not zero If this message persists even though the cable connections are solid contact your nearest Matsushita representative 8 3 Error Messages 158 8 3 Error Messages 159 INDEX INDEX 160 Symbols l GOmmarnd rto eR 149 heel ie eem eer ea Ee 149 COMIMANG EE a e ea ea 151 Mee lu ie N t ert 150 Tcommiand crecer Se EG Ee abs 82 151 macro NAME gt command sss 152 COITiTTIanid o eh rte D
22. 181C81D 841BC 1 Zoom 4 Search 5 16 lt gt 10 6 Inspect 7 Watch 8 View 9 Range 10 Change Figure 7 C Source Code Debugger Win Exit Confirmation 1 3 Basic Operating Procedure 24 1 3 Basic Operating Procedure Chapter 2 Installation 2 1 Preparing for Installation 2 2 Installation N o 2 1 Preparing for Installation Before running the C Source Code Debugger Win installation program make sure that the host computer and the in circuit emulator are properly connected You may postpone the steps in this section if you are only installing the software however 2 1 1 Install Interface Board Install the in circuit emulator s dedicated interface board RS 8 2 Configuring Interface Board 2 1 2 Connect In Circuit Emulator 1 Mount the interface board in an expansion slot inside the host computer 2 Connect the interface board mounted in the computer to the in circuit emulator with the 34 lead flat cable 3 Connect the target probe to the in circuit emulator 4 Connect the option connector and the connector extending from the top of the QFP conversion board under the target probe with the option probe For further details on the connection procedure see the MN101C00 Series Installation Manual 2 1 3 Back Up Floppy Disks After installing the software on the hard disk put the floppy disks away as master copies Backing up the C Source Code Debugger Win disks for purposes of mainte
23. 19 Operators ore pe Ree RR Rees 141 Option dialog box eene 47 OPTION comnmiand eren 151 Option Set command eere 73 Options menu tia 73 Other Files ttt N 45 o Pcommahid eee e oes eod eee E ee oe 84 145 Package Contents sonein a E 9 Paste GOmimalid aaa 65 87 109 PC Location command sese 83 Performance Evaluation Functions sess 15 PF PRINTF command ee ee ee ee ee se ee Ge ee ee ee 149 die stel ARE ii 44 PICELOIC ENV see see esse se ee ee 39 41 45 46 48 52 Powerful Data Display Editing Functions 14 Predefined Symbols senes 152 Preface ciment menie acts 8 Preparing for installation seen 26 PRMPT command see 151 PROF command tette 147 PTIOIC DAT oinor tierce ti 45 m8 Jj Hi COMMANG usc neo RENS 148 a AAA OS inde este 106 Radix Command ce tee eire 149 RAM Monitor Window eee 110 Local Men ASUNTO 71 111 Shortcut Keys eee reete eret i 110 LA AAA SESSE SR Gee ntt 106 RD command oet eden 149 Reading Writing Files eene 149 III 27 Real Time Tracing Commands sss 146 INDEX Register dialog box eene 125 Register window eese 90 Local mens desee ee teste e EE gs er rea Ged dee 69 91 Mouse Operations
24. 99 5 14 2 Trace Window Local Menu Child Trace Dump FS The Child Trace menu contains commands for controling the Jump F6 Top Trace window Bottom Trace Go FH Event F9 Area events Disassemble Toggles the display format between assembly language and Dump hexadecimal dump Jump Displays the dialog box for specifying the starting frame number for the trace buffer display ES 5 21 20 Jump Frame no Dialog Box Top Displays the start of the trace window contents Bottom Displays the end of the trace window contents Trace Go Toggles the real time trace function on and off while the user program Trace Stop is executing Event Displays the dialog box for specifying real time trace events un 5 21 17 Event Dialog Box Area events Displays the dialog box for managing area events 5 14 Trace Window 100 5 15 Inspect Window The Inspect window displays the specified variables max 16 in a format appropriate for the data structure ET TE ETE xPtrGlbNext 002E13 Pt rComp 02E13 Discr Id struct Record X PtrComp 02E13 enum Discr Ident 65535 enum JEnumComp Ident 10 int IntComp 18 0x12 char 31 StringComp 02E1B DHRYSTONE PROGRAM SOME STRII Figure 47 Inspect Window 5 15 1 Inspect Window Shortcut Keys The Inspect window provides the following shortcut keys for executing commands These shortcut keys apply when
25. Debugger 36 3 1 Set Up Environment with Pset101C The installation program creates a new group called PanaXSeries Before you can load C Source Code Debugger Win however you must specify certain environment settings Double click the mouse on the icon labeled Pset101C in the PanaXSeries group to load the program for doing so E PanaXSeries of x Fie Edit View Help gt 9 9 Instruction of Pset101C Help Wice101C MN101C Help Figure 16 PanaXSeries Group Configuring the C Source Code Debugger Win operating environment consists of the following steps Specifying a working directory pages 38 and 40 Creating an environment settings file pages 38 and 45 Specifying the starting options pages 39 41 and 46 Creating a shortcut pages 39 and 41 Saving the setup pages 39 and 42 Correctly completing the above steps allows C Source Code Debugger Win to load successfully The icon labeled Pset101C is a utility for performing these setup operations 3 1 Set Up Environment with Pset101C Chapter 3 Using Debugger for First Time 37 The icon labeled Psetl01C is a utility for setting up the C Source Code Debugger Win operating environment Load it by double clicking the mouse on the icon labeled Psetl01C in the PanaXSeries group C Source Code Debugger MN101C00 Win Setup Setup Help Target directory c wicel01c exp Figure 17 Pset101C Starting Screen There are three
26. Enter the command to be executed at the breakpoint 5 21 Dialog Boxes Chapter 5 Window Commands 121 trace buffer display in the Trace window Jump Frame no Child Trace Jump The Jump Frame no dialog box is for specifying the starting frame number for the Enter the frame number Child Break Child Trace Area events Enter the starting address Enter the end address Select the status List of area events Area Events The Area Events dialog box is for managing area events R ROM read O RAM read write RAM write List of Area events NO E7D Sadr Eadr ST Symbol 1 E 04100 041FF_ EX 2 E 04300 043FF_ EX Adds the current area event settings to the Clears the current area event settings Disables the currently selected area event Enables the currently selected area event Clears all selected area events Clears all area events 5 21 Dialog Boxes 122 Child Break Area breakpoint The Area Breakpoint dialog box is for setting area event conditions Area Breakpoint Select area event conditions Options Option Set The Additional Options dialog box is for specifying C Source Code Debugger Win options Checking this box makes case significant Additional Options in symbol names y oa N E 5 21 Dialog Boxes Chapter 6 Dialog Command Data Expressions 6 1 Data Express
27. Ge SEK GR ee Fe ke 115 5 21 10 Addressing Code RAM Monitor Dialog Box eee 116 5 21 11 Command History Dialog Box ese ese se se see ee ee ee Gee Ge ee ee ee se ee ee 116 5 21 12 Expand Symbol Dialog BOX sesse esse esse ese eene 117 5 21 13 Addressing Memory Dialog BOX iese esse esse ee ee ee ee GR Re ee GR Re ee GR Re ee 117 5 21 14 Set Data Dialog BOX esse ee de ee e ee ee ee nennen ee RA e 118 5 21 15 Register Dialog BOX esse see see se ee ee ee Ge Ge en otero Re Gee ee nennen 118 CONTENTS 5 21 16 Flags Dialog Box oett eee N es 119 3 2117 Event Dialog BOX tires 119 5 21 18 Hardware Breakpoint Dialog Box eee 120 5 21 19 Set Software Breakpoint Dialog Box eee 120 5 21 20 Jump Frame no Dialog Box esee nee 121 3 21 21 Area Events Dralog BOX eiecit fter ede ertet 121 5 21 22 Area Breakpoint Dialog Box sese 122 5 21 23 Additional Options Dialog Box esee 122 6 1 Data Expressions EE reete pia eoe den tee itin GE OE t 124 6L Symbols nU UO EHE DERE UE HO EORR ui eis 124 6 12 Global Symbols 43 o Re ERGE EE pen OR UP Uti ge n ds 124 6 1 3 Local Symbols ctt tte beoe toD pipere tere 125 6 1 4 Predefined Symbols se ese ee e ee ee Se Gee bee se ee nete tren nennen 126 6 1 5 Numerical Valles icono ettet ete ee Ee EE de dub be cene que done 126 EG el M
28. PAREA Sets up a ROM area breakpoint BP DAREA Sets up a RAM area breakpoint BP EXT Sets up an external breakpoint BPS S lt list gt E lt list gt B Sets up the specified list of breakpoints as a sequential event A sequential event may be used for partial time measurement First event condition Second event condition B Sets up the specified list of breakpoints as a sequential event BPA lt list gt Sets up the specified list of breakpoints as an AND breakpoint BC lt list gt Cancels the specified list of breakpoints 7 2 Commands Grouped by Function 140 BD lt list gt Disables the specified list of breakpoints BE lt list gt Enables the specified list of breakpoints AREA lt range gt lt mode gt Sets up an area event for the specified range lt mode gt EX ROM read area event RW RAM read write area event W RAM write area event blank ROM read area event AREAC lt list gt Cancels the specified list of area events AREAD lt list gt Disables the specified list of area events AREAE lt list gt Enables the specified list of area events TD U Switches to the mode for displaying real time trace data Adding U switches to the disassembler output mode Subcommands available in real time trace display mode B Moves the display s starting frame to the beginning end of trace memory N address Moves the display s starting frame to the specified address D range Displays the frame ra
29. a parameter can be omitted Such a parameter appears in square brackets A parameter offering two or more choices appears in braces with bars I separating the choices When a parameter is omitted C Source Code Debugger Win substitutes a default value or one based on a previously executed command Parameter delimiter Optional parameter AIB Choice of A or B ABCD Underlining indicates key input 7 1 Command Description Conventions Chapter 7 Dialog Command Reference 139 7 2 Commands Grouped by Function 7 2 1 Loading User Program L lt file name gt Reads in the user program to be debugged and the debugging information LP lt file name gt Reads in the user program to be debugged only T lt count gt Traces execution of the user program F8 P lt count gt Single steps through the user program F10 G lt execution address gt lt breakpoint address W Runs the user program F5 F7 AN Disables on the fly functions RESET Resets the target chip 7 2 3 Breakpoint Commands BP lt address gt lt status gt lt data gt N lt count gt C lt command gt Set a breakpoint at the specified address F9 status EX instruction execution hardware breakpoint RW RAM read write R RAM read W RAM write blank software breakpoint N Breaks on mismatch with the specified data C lt command gt Automatically executes the specified command at the breakpoint BP
30. an address 6 2 Data Expressions Using C Syntax 132 6 2 2 C Variables These C expressions may use any of the variables and functions declared in source files compiled with the options for including detailed debugging information in output files They may also use the following pseudo variables for registers and flags These pseudo variables are of type unsigned int Register Register Flag E NE Variable DO DO register D1 register D2 register DWO register _DW1 DW1 register AO register A1 register SP register PC register C flag N flag V flag Z flag flag IM flag 6 2 Data Expressions Using C Syntax Chapter 6 Dialog Command Data 133 6 2 3 Scope of C Variables When creating and debugging C programs the programmer must be mindful of each variable s scope the range where it may be used A variable declared with the extern modifier for example is valid everywhere in the program In other words its scope is the entire program An automatic variable declared within a function in contrast is only valid for the duration of the function Its scope is limited to that function If there are variables of both types with the same name only the latter is valid inside the function The former is not accessible Outside the function however the latter no longer exists anywhere in memory so is not accessible C Source Code Debugger Win automatically supports C variable scope based on scope
31. goes well C Source Code Debugger Win starts by displaying a screen similar to the following 4 PICE MN101C00 win Ol x File Edit Search View Bun Child Command Window Options Help iex eng poros aa E T ET 2F90 a8 20A aB SP DEB818 TT 84 d0 d8 58 d6 a8 EC1 1 a8 DC8161 1618 a8 OF OFF 41 6D DESDC POT ET DFO818 168 a1 CFODCA 4CD6 dw1 245 8DC4 POTNIT TTE NT 9F618 4132 48 a8 d8 5c d6 a1 EC1 1 a8 ED1 1 a1 2451000 1 dui E c el c e e E EJ PICE 1 1C 8 Uer 3 6 Release 5 1 1 Copyright c 1 Monitor Program Version 1 08 Evachip Number 101C01D 04108 1 Module 2 0ptWin 3 SrcSW 4 Search 5 Go 6 Inspct 7 Come 8 SglStp 9 Break 10 FncStp Figure 26 C Source Code Debugger Win Starting Screen 3 5 Load the Debugger Chapter 3 Using Debugger for First Time 51 If C Source Code Debugger Win fails to load however see Section 8 3 Error Messages for help interpreting the message box that appears PICE ERROR Check Power I F Card and 10 Address Can t Open wice101c ini Exit C Source Code Debugger Figure 27 Figura sa PICE ERROR PICE ERROR Not found Configuration file PICE101C ENV Exit C Source Code Debugger Figure 31 Wrong configuration file PICE101C ENV format PICEIOIC ENV Exit C Source Code Debugger Figure 29 The messages in Figure 27 through Figure 31 indicate that C Source Code Debugger Win is unable to read the files ne
32. in particular windows 5 4 1 Mouse Operations Available in All Windows This section describes mouse operations available in all windows Right button click Clicking the right mouse button anywhere in the window that currently has the focus displays the local menu for that window A command may then be selected R 5 2 6 Local Menus for Individual Windows F6 Ctrl l rttime 0 Watch Ctrltw ER Sd NES come F7 nulltime 0 s o head of Disassemble F3 Module Fi Line no Ctri QL Top Ctrl QR Bottom Ctrl ac PC Location Ctrl QP File Focus Function Focus ifndef GOOF Flip Figure 34 Code Window Local Menu 5 4 Mouse Operations Chapter 5 Window Commands 75 Left button drag Holding down the left mouse button and dragging the mouse across the text defines an area that appears in reverse Releasing the left button copies the currently selected area to the Clipboard 0 i lt LOOPS i nulltime 0 starttime Computes o head of selected area PtrGlbNext RecordPtr buf PtrGlb RecordPtr buf2 C GlbNext 1 DHRYSTONE PROGRAM S i fnde Figure 35 Selecting a Region to Copy Dragging means moving the mouse with a button pressed E 5 4 2 Window Specific Mouse Operations In addition to the mouse operations available in all windows listed in Section 5 4 1 there are mouse operations available only in particular windows The following pages list th
33. mode Displays execution shares 46 Chapter 8 Appendices 149 functions Clock OSC1 XI Emulator side target side separately excited oscillation only 8 1 2 Electrical Specifications Item Rating Emulator and probe power supply voltage 0 5 to 0 6 V EXT BREAK input voltage 0 3 to 5 5 V Trigger output voltage 0 3 to 5 5 V plus minus 10 mA Trigger output current 8 1 3 Environment Specifications Item Rating Temperature Operation 10 C to 30 C Storage 0 C to 45 C Humidity Operation 20 t 0 80 Storage 90 max 8 1 4 External Dimensions Rating 130 x 100 x 40 mm Item Length x width x height 8 1 In Circuit Emulator Specifications 150 8 2 Configuring Interface Board The interface between the host computer and the in circuit emulator uses one byte in the host computer s I O space Only the lowest eight bits of the I O address are decoded The board uses the upper eight bits Set the switches on the interface board to match the system used a The I O address may be any unused address but normally use an address from the tables LJ below The interface boards include a no fuse circuit breaker to prevent overcurrents from the 5 volt power supply from damaging the board If for any reason there is an overcurrent the white button pops out to shut off the current Before resetting the no fuse circuit breaker by pressing in the button always investigate the cause first Be car
34. monitor program MON101C EX and the Windows initialization file WICE101C IND mcs 3 2 1 Files Necessary for Loading D lt directory gt C Source Code Debugger Win uses the specified directory as its current directory If this option is omitted the debugger first looks for a directory specified via the Execution directory text box on the Program Item Properties dialog box and if that is empty obtains the directory containing the program file from the Command line text box 3 4 Specify Starting Options 48 E option This option adds an extension to the list of source file types displayed in Code windows E lt extension gt The specified extension becomes the default for displaying source files Do not include the period If this option is omitted the default list consists of the extensions C and ASM S options These options specify the source single step execution mode SP This option specifies the use of software breakpoints for source single step execution It is the default ST This option specifies the use of assembler steps for source single step execution If the default SP fails to produces correct single step execution use the ST option Note that the ST option slows down execution speed SD option This option specifies the directories containing the source files displayed in Code windows You can specify more than one directory by delimitting the directories with s
35. of the drive containing the Setup Disk and the file name SETUP EXE in the Command line text box Current Directory AX Command Line Run Minimized Figure 8 Running from Run Dialog Box Alternatively click the mouse on the Browse button and select the name of the drive containing Setup Disk and the program name setup exe in the File Browser dialog box that appears Click the mouse on the OK button to run the program i name Folders setup exe 1 setup exe a Lmstest exe d setup exe ml List files of type Drives Figure 9 Running from File Browser Dialog Box 2 2 Installation Chapter 2 Installation 29 From File Manager Insert the floppy disk labeled Setup Disk in the floppy disk drive Double click the mouse on the icon labeled File Manager in the Program Manager s Main window Select the Select drive command on File Manager s Disk menu Select the drive containing the floppy disk labeled Setup Disk in the Drive list box in the Select Drive dialog box Click the mouse on the lt OK gt button Select the icon labeled setup exe in the Directory window Select the Open command on File Manager s File menu to run the program E ge SCA Disk Tree View Options Window Help E Open Enter Move F A Copy FB 3owl202 d Gwi Delete Del Dpanax in_ R Cisample c_ Rename sample ex Properties Alt Enter DysetO1c dir Run P
36. on and off J Toggles the display of elements array members structure members etc for the currently selected variable on and off This command is only available for variables marked with a plus or minus sign 5 10 Local Window 90 Child Local The Child Local menu contains commands for controling Inspect F6 Ctrl I Watch F7 Ctri w Element Offset F9 Displays the currently selected variable in the Inspect window Adds the currently selected variable to the Watch window the Local window Element Toggles the display of elements array members structure members etc for the currently selected variable on and off This command is only available for variables marked with a plus or minus sign Offset Toggles the display of offsets for the local variables on and off Double clicking the left mouse button on a variable marked with a plus or minus sign toggles the display of elements array members structure members etc for that variable on and off 5 10 Local Window Chapter 5 Window Commands 91 5 11 BackTrace Window The BackTrace window traces the call hierarchy from the current function back to main SAMPLE C 26 04165 mairn C Figure 42 BackTrace Window a The BackTrace window is only available when C Source Code Debugger Win is loaded LI with the XC option RS 3 4 Specify Starting Options 5 11 1 BackTrace Window Short
37. possibilities depending on whether you are creating a new environment upgrading from the MS DOS version of the debugger or modifying an existing environment previously created with Pset101C If you are upgrading from the MS DOS version of the debugger skip to page 39 If you are modifying an existing environment created with Pset101C skip to page 42 3 1 Set Up Environment with Pset101C 38 Creating a New Environment Select working directory Specify the directory for creating the new C Source Code Debugger Win environment The normal choice is the directory containing the C source files and object files for the project You can however create a new directory if you wish To specify the directory either enter its name in the Directory text box or select it in the Directory list box Clicking the mouse on the lt OK gt button causes the C Source Code Debugger Win to copy the files that it needs to the specified directory Subseguent editing operations affect only the environment settings and starting options files in the specified directory Target Directory Ed Directories Jc wicel Dic Gen Ey wice101c Network dl Drives CJ c ms dos_6 gt Figure 18 Specifying Working Directory a If the files necessary for loading are not present in the specified directory C Source Code E Debugger Win will not load properly ENV Create environment settings file Create
38. target board is in the middle of a reset e When the JSR instruction pushes the return address onto the stack the trace sometimes does not show the result until the next instruction e Modifying an event while a direct trigger trace is in effect leads to faulty tracing e Specifying a trace full stop while the user program is running does not stop execution 1 2 Important Notes Chapter 1 Overview 19 1 2 7 On the Fly Support e Displaying or modifying data e g displaying disassembler output while the user program is running temporarily suspends execution The maximum delay per byte is 5 machine cycles for access to the emulation memory and 500 machine cycles for access to the microcomputer s special registers or external memory on the target board During this interval the debugger displays the message Warning CPU STOPPED on the status line e You cannot display edit the contents of memory the microcomputers special registers or external memory on the target board or disassemble the trace if the microcomputer is in STOP or HALT mode or if the target board is in the middle of a reset e Changing event settings while the user program is running clears all previous events e When the in circuit emulators RAM monitor and real time watch functions read the monitor RAM contents they do so within a 10 cycle period after the user program reads memory at a different address The data cannot be displayed if the user program acces
39. these settings the next time that you run it To modify the settings use the procedures in Modifying an Existing Environment below 3 1 Set Up Environment with Pset101C 42 Modifying an Existing Environment Open Open existing setup Open the setup previously saved with the lt Save setup gt button Modify environment ENY Modify the items accessible via the lt Environment settings gt button and lt Starting options gt button mcs Create a shortcut Reg Create a shortcut to the current C Source Code Debugger Win setup by double clicking the mouse on a group Double clicking the mouse on that icon then loads the debugger Registory icon Ed Icon name Wicel Oc a PanaXSeries PanaXSeries Figure 23 Creating Shortcut Labeled WICE101C Save Save setup Save the edited setup in the project file 3 1 Set Up Environment with Pset101C Chapter 3 Using Debugger for First Time 43 3 2 Check Files C Source Code Debugger Win works with the following files 3 2 1 Files Necessary for Loading This section lists the files necessary for loading C Source Code Debugger Win The debugger reads the first three files from the directory specified with the NEW button Environment settings file PICE101C ENV This file specifies such things as the target board configuration and target resources used by the in circuit emulator C Source Code Debugger Win shares this file with the MS DOS
40. tracing until program stops S Stops only tracing when the trace memory is full Does not stop the user program TM F Sets up free running trace mode TRIG lt mode gt Sets up displays external trigger output mode ON Enables trigger OFF Disables trigger TS Stops tracing EXI expanded area Assigns expanded memory to memory inside the emulator expanded area ROM Expanded ROM area 7 2 Commands Grouped by Function 142 RAM Expanded RAM area EXE lt range gt Assigns expanded memory to user target resources lt expanded area gt ROM Expanded ROM area RAM Expanded RAM area EX Display settings R Displays contents of all register and flags lt register gt REG lt value gt Sets the specified register to value of expression lt flag gt FLG lt value gt Sets the specified flag to value of expression R lt register gt Modifies contents of specified register or CPU flag D lt type gt lt range gt lt display count gt lt radix gt Displays the contents of the specified range with the specified radix lt type gt B Byte 8 bit data W Word 16 bit data D Double word 32 bit data S 4 byte real number short float data L 8 byte real number long float data A ASCII data lt radix gt H Hexadecimal display D Decimal display O Octal display E lt type gt lt address gt lt data gt Modifies memory starting at the specified address using the specified data type
41. version of the debugger Windows initialization file WICE101C INI This file contains environment settings for the Windows version window positions text fonts color specifications tool bar configuration breakpoints etc Starting options file WICE101C INF This file contains C Source Code Debugger Win starting options It is automatically created with the procedure in Section 3 4 Specify Starting Options Monitor program MON101C EX This file contains a monitor program that runs on the target CPU It is identical to the file supplied with the MS DOS version of the debugger Message file PICE101C MES This resource file contains messages displayed by C Source Code Debugger Win Auto execute file INIT MCR C Source Code Debugger Win automatically executes the contents of this macro file in the Command when it loads In other words you can store commands for any necessary preliminary processing here to have them automatically run when the debugger loads 3 2 Check Files 44 3 2 2 Files Saved at Exit C Source Code Debugger Win saves session information in these files just before it exits They are located in the directory specified with the lt Select working directory gt button Memo Window contents MEMO PT This file preserves the contents of the Memo window Command History Window PT101C DAT This file preserves the contents of the Command History window 3 2 3 Other Fil
42. window that currently has the focus for the next occurrence of the text specified with F4 CTRL R Scrolls the screen downward by one screen TUp CTRL S Moves the cursor one character position to the left 5 3 Shortcut Keys 72 y Copies the contents of the window that currently has the focus to the Clipboard CTRL Alt 0 window CTRL Alt C the window CTRL Alt W window CTRL Alt M window CTRL Alt R window CTRL Alt S window CTRL Alt L window CTRL Alt T the window CTRL Alt B window CTRL Alt E window CTRL 1 Restores the screen to user layout 1 CTRL 2 Restores the screen to user layout 2 CTRL 3 Restores the screen to user layout 3 Alt F10 Displays the local menu for the window that currently has the focus 5 3 Shortcut Keys Chapter 5 Window Commands 73 5 3 2 Window Specific Shortcut Keys In addition to the shortcut keys available in all windows listed in Section 5 3 1 there are shortcut keys defined for particular windows The following pages list these window specific shortcut keys Register window _5 8 1 Register Window Shortcut Keys 86 Local window_ 5 10 1 Local Window Shortcut Keys 88 i Trace window S141 Trace Window Shortcut Keys 98 BackTrace window 5 11 1 BackTrace Window Shortcut Keys 5 3 Shortcut Keys 74 5 4 Mouse Operations Mouse operations inside window consist of operations common to all windows and operations available only
43. 149 Help contents command eee 73 help file eet ec e Late BY Aes 45 INDEX Help on help command eee 73 Help imen ttt eerte ets 73 Hexadecimal command sees see sesse see ee ee 89 111 History command essere 87 HOME command sse 151 L x T IF command ttr aite 152 Import nt Notes eere a p et need eoe dates 16 In Circuit Emulator Specifications sse 154 remite 91 NIE il RR EE E 44 INIE EMGCR cia it t oe dede ge ns 44 INS command 2 eode estive pe 81 84 150 Inspect command esses 83 95 97 99 106 spect window nire rente 105 Focal MED ese cette eee eoe o Eae 71 106 Mouse Operations essere 106 Shortcut Keys e ERUIT EGER TR 105 Installation nonet BEES KOS WER il 20 25 169 Installation Directories dialog box 33 Instruction set help file een 45 Interface Board for PC AT Series sss 157 Interface board installation esssse 26 46 156 Interrupting Installation eer 35 Jump command eee 104 Jump Frame no dialog box eee 128 OR K command teet enin 150 Keyword Search command sess 73 KIL command un 152 L commatid er e eee PR UR 145 E ALL commaf
44. E EO e ee de eee eee 126 6 137 Line SE Et rhe E rere e ee E E ostias i n 127 61 8 Strings O 128 6 1 9 Register Names ete seen eie tei coisa rti EE te ipe tees 128 61 10 Afithmetic EX pressions etica eon hte d ipe eem deine ee pe e 129 6 2 Data Expressions Using C Syntax sees enne tenete nennen 131 AMC AS RR Deed EE hie ERIS 131 6 2 2 C Variables eee ri 132 6 2 3 Scope of C Variables tom re eR men ed ETE ERE oe EER ee id 133 6 2 4 CODStahts sedan gateau um di 133 6 2 5 Operators oup Cp EOD EER EE oia 134 6 2 6 Expressions with Side Effects esse esse see se see ee ee ee nennen nenne 135 7 1 Command Description Conventions sese GR RA RA Ge ee Ge ee ee ee ee ee ee 138 7 2 Commands Grouped by Function esse ses see see se ee ee ee Ge ee ee ee Ge Ge nennen eene ee ee ee ee 139 17 2 1 Loading User Proporta ss eie oe eene SR Ge EE Se ER ee eed 139 1 22 Running User Program SE SE ER EE EE Up PRO pee 139 7 2 3 Breakpoint Commands nete eee te tee tte ettet tetro 139 7 2 4 Area Event Commands essere ee ee se ee ee ee eit ke 140 7 2 5 Real Time Tracing Commands se se ee ee se ee ee ee Ge Se ee ee Ge ee 140 CONTENTS 7 2 6 Hardware Related Commands see ee ee ee ee ee ee ee ee nene 141 7 2 7 Displaying Modifying Registers esse se se se es ee ke Gee ee se ee ee ee ee Se ee 142 7 2 8 Displaying Modifying Memory ese se s
45. EE N N NE EE OE EEN 102 5 16 1 Memo Window Shortcut Keys ooooooococcconococonccononononaconcnonnnccononoonnacono ccoo Re ee 102 5 16 2 Memo Window Local MENU ee se ee RR RA GR ee enne ee RA ee Ge ee ee ee 103 5 17 RAM Monitor Window esses ener E Re ee Ee Re ee ee ee Ge Re ee ee nnns 104 5 17 1 RAM Monitor Window Shortcut Keys sesse ses ee es ee ee ee ee RA ee 104 5 17 2 RAM Monitor Window Local MENU ees ss see sese 105 5 18 Tool Bars EE RE a ES EE 106 5 18 1 Tool Bar Configuration see se ee ee Ge Ge Ge GR GR Esso Gee nn nono ee ee ee 106 23 182 Button Functions Rote d ere nte Ute tee tions enews 107 23 19 Window Bat ipei EE eee eie lied teer pee ete AO N 109 3 20 Stat s Bak s GE EE eg GE ete UU en cs EE Ge RR tint pee dee Ge eee EE 110 25 21 Dralo amp BOXES RE OE N EE NE HO eni t erm eto 111 5211 File Open Dialog BOX eise erepti EE Ee RR ER Ee Ee tere 111 3 21 2 Font Dialog BOE rere E Hr IEEE 112 3 21 3 Tool Bar Dialog Box EE n EE N EER coven EE GE wesc EE e sone ee eN Ee ee se ed 112 3 21 4 Color Dialog BOR cintia 113 5 21 5 Find String Dialog BOX eee ettet tte Re ee 113 5 21 6 Set Inspect data Dialog BOX ee ee se se Ge ee ee ee se ee ee ee Se ee 114 5 21 7 Set Watch data Dialog BOX sesse esse ee ee ee ee RA ee AA ee RA ee RA ee 114 3 21 8 Module Dialog BORG ee RENE es ee reete te recette 115 5 21 9 Set line no Dialog BOE REEKSE Re ER se ttr GE GEE
46. R epe 151 file namelcommand ee ee ee Re RR ee 152 file name command sss 151 deu EE EE ES 151 Da O As COMIMANG EE N 149 Ab t command acia paa cd 73 Add command ees Ee e rni 99 101 Additional Options dialog box s 129 Address command sos ee ttn rco one 83 97 111 Address Set command ooconocccnnoncccnoncnononanononanononanonnnnnonnno 89 Addresses command AAA 93 Addressing dialog BOX esse see see ke ee AR Re 123 124 Add to AND condition command s 101 All Clear command eene 99 Appendices epe RE RR eds 153 AREA command sss 146 Area breakpoint command eene 101 Area Breakpoint dialog box eese 129 Area event commands oo eee eee ee ee ee ee ee ee ee 146 Area events command VEE NE RE i tainen 101 Area Events dialog box en 128 AREAC command sse 146 AREAD command sss 146 AREAE command sss 146 Arithmetic expressions seen 136 Arrange command eene 72 AssemblE c5 edited ASS 55 Assemble command sseseseeeeeereenn 149 INDEX Auto execut Dile eee erepti tero eee err 44 Backup floppy disk ertet oie cea 26 Back Trace window arce ec a erm XD PR LIA UR 96 LOCA MET ee te te eio elei Ge ee DN EOS 70 97 Mouse Operations
47. Zero F3 Increment Decrement Change Register window E 5 8 2 Register Window Local Menu Decimal F9 Symbol F6 Memory pr Child Stack Menu mA The Child Stack menu contains commands for controling the Symbols F Addresses F7 Stack window E 5 9 2 Stack Window Local Menu Child Local Menu Child LocaD The Child Local menu contains commands for controling Inspect F6 Ctri l Watch FR CtrieWw Element the Local window E 5 10 2 Local Window Local Menu Offset F9 5 2 Menus Chapter 5 Window Commands 67 Child Watch Menu da The Child Watch menu contains commands for controling Inspect F6 Ctrl l Watch F7 Ctr W the Watch window Element E amp F 5 12 2 Watch Window Local Menu Add Ins Clear Del All Clear F3 Child BTrace Menu Child BTrace The Child BTrace menu contains commands for controling Inspect F6 Ctrl l the BackTrace window E amp F 5 11 2 BackTrace Window Local Menu Source F9 Address F Child Break Menu adit The Child Break menu contains Add Ins i Disable F9 Er commands for controling the Break window Clear Del ES 5 13 2 Break Window Local Menu Clear All F3 Save Setting F4 Load Setting F6 Hardware breakpoint E Area breakpoint Area events External breakpoint Child Memo Menu Child Memo The Child Memo menu
48. aa vis 91 Delete command ss er erre ite 65 109 Dialog Boxes ii eee Aer eee 117 Directory window esee 30 Disable Enable command esee 101 Disassemble command ocococccnnonccnnnnncnonancnonnnonananonananonnno 83 Disassemble Dump command sess 104 TREE TERT usce Ee FEDERER ee 30 Displaying Code ese see Ge Re ee ee ee ee Re ee 150 Displaying Expressions see eke ee ee ee Re ee ee 149 Displaying Modifying Registers sess 148 Displaying Modifying C Data sess 150 Displaying Modifying Memory sees 148 Displaying Modifying Symbols sssss 150 DO WHILE command sss 152 Double word command sesse sesse ee ee Re ee 89 E E comimangd iio 148 Edit command AAA 89 Edie ii E 65 Electrical Specifications eese 155 Eleiment commiafd ieu ern etr erdt 95 99 ENV101 CTT RE etat EE a 39 45 46 Environment Settings dialog box ee 46 Environment settings file 37 39 41 44 46 Environment Specifications sss 155 Error messages sonet e Rn 52 158 LE vent Icomimatid rta 104 Eventidialos BOX MA EE 126 EX commandar a e E TN 148 EXE COMMANM sesse rre 148 EXI command ees 147 EXI COMA asus ses nita eti ien ia Ee ken chia 64 EXIT Q command
49. ally delete or modify the contents Create Environmental Setting File Footer CONTENTS CONTENTS CHAPTER 1 OVERVIEW Ui Features ses RE a ite NI IND qe 14 1 1 Enhanced Features iii 14 1 1 2 Powerful Data Display Editing Functions esee 14 1 1 3 IR RE OE EN EE RE OE EE EE EE OE aS 14 1 1 4 User Customization eter OE OE KO EE Sues 14 1 1 5 ORE IR AA US RE OR N re eb aie e Herde ise ets 15 BEER M PER 15 1 1 7 Trace Functions eoe eter EE EE e erento pie 15 1 1 8 Performance Evaluation Functions ees sesse ee se ees se ee ee ee se ee GR ge ee ee enne ener 15 1 2 Important NOtes ER EE OR RE OR IE EE EER 16 12 ard SO N ET OE e 16 A SEE HE EE OE OE ER EE 17 12 3 ROM and RAM ete Ara 17 1 2 4 Go Step and Come Commands esee 17 1 25 Break POMS iss cnc ie eR Deren DH Ee Ee Se distet t Or ae S 18 A EA EE emo EE EG 18 1 2 7 On the Ely SUP 19 1 2 8 Miscellaneous ddr ette are etie ete teer ceed oe Se ee Se Nene defe in 19 1 3 Basic Opefating Procede Gee Ee E E GE Ee eene oe AE deed 20 CHAPTER 2 INSTALLATION 2 1 Preparing for Installations tee tre titer ous cr re ee GE E Ee e 26 2 1 1 Install Interface Boatd eerte ette eee deese eds 26 2 1 2 Comnect In Circuit Emulator tege RE RE ERR ER 26 2 1 3 Back Up Floppy Disks teet ret RE Rr ee ee ee Se ae 26 2 1 ASS tart W1ndOWS xcu eee et eite t rt ire eie ce ete Eee toe 26 2 2 Ins
50. anual lists sections by title The upper right hand corner of right hand pages gives the chapter title the bottom of each page the section title Together these give you an overview of the information available as you flip through the pages The index at the back of the manual provides references by keywords Related Manuals In addition to this manual the following manuals are available for the MN101C00 series MN101C00 Series Installation Manual MN101C00 Series LSI User s Manual Description of device hardware MN101C00 Series Instruction Manual Description of instruction set MN101C00 Series C Compiler User s Manual Usage Guide Description of installation loading and options MN101C00 Series C Compiler User s Manual Language Description Description of compiler s C implementation MN101C00 Series C Compiler User s Manual Library Reference Description of standard library functions included with the compiler MN101C00 Series Cross Assembler User s Manual Description of assembly language syntax and notation Contact If you have any guestions related to the contents of this manual direct them to your nearest Matsushita Semiconductor Design Center The Centers are included in the list of sales offices appearing at the end of this manual Page Layout The contents of this manual may be roughly divided into the following parts titles summaries main text notes and comments The fifures accompanying the summaries are sc
51. area event conditions mc 5 21 22 Area Breakpoint Dialog Box Displays the dialog box for managing area events mc 5 21 21 Area Events Dialog Box External breakpoint Sets up an external breakpoint Add to AND condition Adds the currently selected event to the AND condition breakpoint condition 1 sequential breakpoint breakpoint condition 2 sequential breakpoint 5 13 Break Window Chapter 5 Window Commands 97 Double clicking the left mouse button on a breakpoint toggles it between enabled and disabled 5 13 Break Window 5 14 Trace Window The Trace window displays either a hexadecimal dump of the real time trace memory or the disassembler output movw 1616 movw 1614 Figure 45 Trace Window Figure 46 Trace Window Disassemhler Output Dump Display The Trace window provides the following shortcut keys for executing commands These shortcut keys apply when the Trace window has the focus F6 Displays the dialog box for specifying the starting frame number for the trace buffer display mn 5 21 20 Jump Frame no Dialog Box Toggles the real time trace function on and off while the user program is executing Displays the dialog box for specifying real time trace events R 5 21 17 Event Dialog Box Ctrl Q R Displays the start of the trace window contents Ctrl Q C Displays the end of the trace window contents 5 14 Trace Window Chapter 5 Window Commands
52. arest Matsushita Sales Office In Circuit Emulator The in circuit emulator features a single switch for power and an LED that lights when the power is on It is controlled as a device within the host computer s 1 O space This dedicated interface board connects the in circuit emulator to the personal computer The illustration shows the version for the NEC PC 9801 series Also available are a IBM PC AT compatible version and a PCMCIA card version This probe connects the in circuit emulator to the target board The exact shape depends on the microcomputer model The in circuit emulator will not operate without this probe Preface 10 34 Lead Flat Cable 1 5 m Option Probe Floppy Disk Manuals This cable connects the in circuit emulator to the dedicated interface board in the host computer The option probe supplies the target probe with power to confirm the booting of the in circuit emulator Use the option probe s power supply only for this purpose The package contains two floppy disks labeled Setup Disk and Disk 2 Always use the setup program on the former to install C Source Code Debugger Win MN101C00 Series C Source Code Debugger for Windows User s Manual this manual This manual gives the procedures for installing the software and using it under Windows MN101C00 Series Installation Manual This manual gives the procedures for connecting the in circuit emulat
53. ater j than or equal to the left operand O otherwise comparison operator 1 when the right operand is less than or equal to the left operand O otherwise E comparison operator 1 when the right operand is greater than the left operand O otherwise 2 comparison operator 1 when the right operand is less than the left operand O otherwise comparison operator 1 when the right operand is equal to the left operand O otherwise comparison operator 1 when the right operand is not equal to the left operand O otherwise bitwise AND bitwise XOR logical AND logical OR 6 1 Data Expressions A amp amp m FS rz 130 System function VAL The VAL dialog command evaluates the specified C expression The numbers on the left of each operator indicate operator precedence If two operators have the same precedence they group from left to right Note however that parentheses may be used to override this precedence order Compare logical AND and logical OR expressions are available for processing decision conditions for macro for while commands etc and condition decision commands such as if command For the compare logical AND and logical OR instructions only the lower 16 bits are subject to operation gt h 1 2 3 oct dec hex asc float 37777777771 7 FFFFFFF9 6 805644e 38 6 1 Data Expressions Chapter 6 Dialog Command Data 131 6 2 Data Expressions Using C Syntax Section 6 1
54. bove procedure produces an executable file sample ex Load this user program into C Source Code Debugger Win with the load L command 4 1 Convert to ROM 56 4 1 Convert to ROM Chapter 5 Window Commands 5 1 Screen Layout 5 2 Menus 5 3 Shortcut Keys 5 4 Mouse Operations 5 5 to 5 17 Window Descriptions 5 18 Tool Bar 5 19 Window Bar 5 20 Status Bar 5 21 Dialog Boxes 58 5 1 Screen Layout This section describes the major structural elements making up the C Source Code Debugger Win screen menus tool bar status bar and debugging windows 5 1 1 Structural Elements The figure shows the various window elements Main window Menu Tool bar MISS T Register Window bar window a 3 Stack window Code window t ruct Record X PtrGIb X02E61 BackTrace 0 02E61 PtrComp 02E13 Discrz Ident 1 EnumComp I window Inspect window Break window Command window Memo Watch window window Trace Memory window window Local window RAM Monitor Status bar window Figure 32 Screen Elements Main Window This is the C Source Code Debugger Win main window It includes such features as the menu bar tool bar and status bar Code Windows These windows display source code and disassembler output The program counter PC position is indicated in reverse video software breakpoints with underlining There are two such windows available
55. cessary for loading Either copy the necessary files into the working directory or rerun the environment configuration program Pset101C gt 3 1 1 Load Pset101C 3 2 1 Files Necessary for Loading Figure 29 for example reports a problem with the environment settings file PICEIOIC ENV Use Pset101C to edit the model specific definition file and recreate the file KS 3 3 Create Environment Settings File 3 5 Load the Debugger 52 3 5 Load the Debugger Chapter 4 Creating User Program to Debug 4 1 Convert to ROM 54 4 1 Convert to ROM C Source Code Debugger Win supports debugging of programs developed in the C programming language at the source level This Chapter outlines the procedure for using the MN101C00 series C compiler CC101C to convert the source files for a user program into an executable file for loading into C Source Code Debugger Win The compiler produces output designed to run on the target system that is may be converted to ROM You must therefore specify the ROM and RAM assignments stack size and other parameters to match the target To modify the setup rewrite the start up routine link file and other components following the specifications given in the compiler manual The following describes the procedure for using the MN101C00 series C compiler CC101C to create an executable file ex file As an example it uses two C source files samplel c and sample2 c C Source Cod
56. contains commands for controling Undo Alt BkSp the Memo window E 5 16 2 Memo Window Local Menu Cut Shift Del Copy Ctrl Ins Paste Shitt Ins Delete Del Clear All Ctri Del 5 2 Menus 68 Inspect Menu cid The Inspect menu contains commands for controling the Inspect F6 1 Ctrl l Watch F7 W CteleW Inspect window View F8 V CtPV R37 5 15 2 Inspect Window Local Menu Range F9 R Change F10 C Radix F5 Child Trace Menu Child Trace The Child Trace menu contains commands for controling the Dump F3 Jump F6 Trace window Te ES 5 14 2 Trace Window Local Menu Bottom Trace Go ET Event F9 Area events Child RAM Monitor Menu Child RAM Monitor The Child RAM Monitor menu contains commands for Bit 1 F3 Byte B F4 controling the RAM Monitor window R 5 17 2 RAM Monitor Window Local Menu v Hexadecimal 6 H Decimal 1 Address AF Zoom in out F6 5 2 Menus Chapter 5 Window Commands 69 5 2 7 Window Menu Window The Window menu contains commands that Cascade Tie operate on windows Arrange Icons Userl Ctrl 1 User2 Ctrl 2 User3 Ctrl 3 1 Memo PT 2 TEST2 C 1 3 Memory 4 Stack 5 Registre B RAM Monitor 7 Watch B Trace v STESTI C More Windus Menu Item Function Cascade Arranges all windows not reduced to icons so that they overlap Tile Arrang
57. cut Keys The BackTrace window provides the following shortcut keys for executing commands These shortcut keys apply when the BackTrace window has the focus Key Combination F6 Displays in a Code window the source code for the line at the current CTRL I cursor position a Toggles the display of symbols in the window on and off F9 Toggles the display of source files and line numbers for symbols in the window on and off 5 11 BackTrace Window 92 Child BTrace The Child BackTrace menu contains commands for Inspect F6 Ctrl l controling the BackTrace window Source F9 Address F7 Menu Item Function Inspect Displays in a Code window the source code for the line at the current cursor position Source Toggles the display of source file names and line numbers for symbols in the window on and off Address Toggles the display of addresses on and off Double clicking the left mouse button on the BackTrace window displays the source code for that line in a Code window 5 11 BackTrace Window Chapter 5 Window Commands 93 5 12 Watch Window The Watch window displays the contents of specified variables max 16 A plus sign to the left of the variable name indicates a variable with elements array members structure members etc that may also be displayed a minus sign a variable with its elements displa
58. de Window Options Help Sell ero e Ela EER if sec 1 6 sec 1 0 H EY void init data int xsec test tst1 1 test tst2 2 sec 0 INIT_DISPDATA_L sec 1 INIT_DISPDATA_H num 6 gt void inc void ifF num lt 180 4 nun pelse gt num 6 Command PICE 161C66 Ver 3 6 Release 5 1 1 Copyright c 1 Monitor Program Version 1 66 Evachip Number 101C81D gt gt gt gt 05108 1 Module 2 0ptWin 3 SrcSW 4 Search 5 Go 6 Inspct 7 Come 8 SqlStp 9 Break 10 FncStp Figure 4 Setting Breakpoint 1 3 Basic Operating Procedure 22 6 Run user program Run the user program and wait for it to stop at the breakpoint set in step 5 Alternatively ma wv program MIN press the Esc key to force a halt 7 Inspect variable Double click the mouse on a variable to display its contents for editing in the Inspect window BA 5 5 1 Code Window Shortcut Keys 4 PICE MN101C00 win File Edit Search View Run Inspect Window Options Help eee 1o s E e E EN SAMPLE C FA Local if sec 1 6 sec 1 8 gt void init data int x sec test tst1 1 EN Inspect 2000000 BEES struct abc test 388888 tst1 1 tst2 6 int tst1 1 8x1 int tst2 8 8x8 void inc void if nun lt 100 lt nun jelse num 8 PICE 161CA8 Ver 3 6 Release 5 1 1 Copyright c 1 Monitor Program Version 1 66 Evachip Number 101C01D g
59. e Command eset window has the focus Module Exit Load Displays the dialog box for selecting the user program to load RS 5 21 1 File Open Dialog Box Reloads the program being debugged Reset Resets the evaluation chip Module Displays the dialog box for selecting a source code module for the loaded user program for display in a Code window RS 5 21 8 Module Dialog Box Terminates C Source Code Debugger Win execution 5 2 Menus 5 2 2 Edit Menu The Edit menu contains commands for passing text Paste Shift Ins EE RE EE between windows via the Clipboard Edit When the Memo window has the focus the Edit menu do Alt BkSp 2 expands to the menu shown to the left S t Shift Del Copy Ctrl Ins Paste Shift Ins Delete Del Clear All Ctrl Del Menu Item Function Delete Deletes the currently selected text Clear All Deletes the entire contents of the Memo window 5 2 Menus Chapter 5 Window Commands 63 5 2 3 Search Menu The Search menu contains commands for searching the ind F4 Ctrl QF ext CtritF4 CtlL current window for a particular text string Find Displays the dialog box for entering the search text and the search direction for the window that currently has the focus RS 5 21 5 Find String Dialog Box Next Searches in the specified direction starting at the current cursor position in the window that currently has the focus for the
60. e window The only exceptions are the commands related to cursor movement E amp 5 5 1 Code Window Shortcut Keys 5 6 Command Window Chapter 5 Window Commands 83 5 6 2 Command Window Local Menu Child Command The Child Command menu contains commands for Load Beload controling the Command window Reset Paste Shift Ins History Shift F2 Exp Sym Shift F6 Reloads the program being debugged History Displays the dialog box for selecting from previously entered commands Re 5 21 11 Command History Dialog Box Displays a dialog box listing command lines formed by completing the current partial command line with all global symbols starting with the word at the end of the command line RS 5 21 12 Expand Symbol Dialog Box 5 6 Command Window 84 5 7 Memory Window The Memory window displays the contents of memory in various formats Figure 38 Memory Window The Memory window provides the following shortcut keys for executing commands These shortcut keys apply when the Memory window has the focus Ky Comite Displays the dialog box for specifying the starting address for the display mcs 5 21 13 Addressing Memory Dialog Box Displays the dialog box for modifying data RS 5 21 14 Set Data Dialog Box Displays the memory data in bytes 5 7 Memory Window Chapter 5 Window Commands 85 5 7 2 Memory Window L
61. e Debugger Win supports all C data constructs scalars int char etc m pointers arrays structures and unions It supports local variables global variables and static variables Compiling The first step is to create rf files from the C source files Always include the compiler s g option for including detailed debugging information in the object output You can also have the CC101C driver call the assembler by simply specifying the driver s c option gt CC101C c g sample1 c gt CC101C c g sample2 c Assembling Use the assembler to convert asm files to rf files If the assembly language file is startup asm for example the following command produces an object file The g is the debug option gt AS101C g startup asm 4 1 Convert to ROM Chapter 4 Creating User Program to Debug 55 Linking The linker links all object files together into a single executable ex file Always include the g option to retain the debugging information in the output The o option specifies a name for the output file The T options specify starting addresses for the _TEXT and DATA sections gt LD101C g j osample ex T_TEXT 4100 T_DATA 100 startup rf sample1 rf sample2 rf When linking always include a start up routine Microcomputer programs require a start L up routine that initializes registers and RAM and then calls main For further details see the compiler manual Loading executable file The a
62. e Ge RA Gee ee ee ee ee Ge Ge SR Re GR GRA RA ee ee ee 150 8 2 1 Interface Board for PCIA Tiida iris 151 8 3 Error Messages idee o ee dit 152 CONTENTS Preface Overview Thank you for purchasing the MN101C00 Series C Source Code Debugger for Windows hereinafter referred to as C Source Code Debugger Win Windows based control software for the PanaXSeries in circuit emulator This update to the MN101C00 Series C Source Code Debugger retains backward compatibility with the MS DOS version while adding new features made possible by Windows more debugging information a multiwindow interface pull down menus a convenient tool bar and extensive on line help We are certain that you will find it a highly effective tool for continued use About This Manual The manual set for the software consists of the MN101C00 Series Installation Manual and the MN101C00 Series C Source Code Debugger for Windows Users Manual hereinafter referred to as the C Source Code Debugger Win User s Manual This manual the C Source Code Debugger Win User s Manual details the setup and operation procedures for the software For further details on dialog commands entered via the Command window see the on line help Preface Package Contents The development environment consists of the following components Check that you have received all components and examine them for damage during shipment If there are any problems contain your ne
63. e gt Evaluates the specified C expression and displays the result in the Inspect window W C expression Adds the C expression to the Watch window W lt type gt lt address gt lt count gt lt radix gt Adds the specified address to the Watch window type B Byte 8 bit data W Word 16 bit data D Double word 32 bit data A ASCII data C expression display radix H Hexadecimal display D Decimal display O Octal display Y list Deletes the specified watch line s WM lt list gt Displays the specified watch line s in the RAM Monitor window 7 2 Commands Grouped by Function Chapter 7 Dialog Command Reference 145 VAL C expression gt lt function name gt Evaluates the specified C expression and displays the result OPTION lt reg gt lt code gt lt case gt Sets options Shift F10 lt reg gt ON OFF Switches the Register window display on and off lt code gt SRC ASM Switches the Code window display between source code and disassembler output case ON OFF Switches case significance for symbol names on and off MEM lt number gt lt text gt Writes the specified text to the specified memo number MEM Displays the contents of the current memo MEM Deletes all current memos gt file name Logs Command window displays and input to the specified file overwriting the file gt gt file name Logs Command window displays and input
64. e macro Define the macro definition at the C Source Code Debugger Win command level Macros cannot define other macros 8 3 Error Messages 156 Macro buffer full Either the buffer for macro definitions is full or there are too many macros defined Restart C Source Code Debugger Win using the B command line option to specify a larger buffer Macro name same as internal command The macro definition uses a name that matches a C Source Code Debugger Win internal command Use a different name Out of memory There is not enough memory available Restart C Source Code Debugger Win using the B command line option to specify smaller buffers Cannot find monitor program MON101C EX The debugger needs the monitor program MON101C EX to start but cannot load the file Copy the MON101C EX file in the current directory or the directory specified with PAHT Check power supply interface board and addresses Make sure that the power supply to the in circuit emulator is on Make sure that the probe and pod switch settings match Make sure that the VO address of the interface board matches that specified with the Pset101C command Check the interface board address for conflicts with other boards EMS memory RAM disks and the like Cannot define local symbol This message appears when you attempt to define a global symbol with the same name as an existing local symbol Local symbol buffer full The buffer for local symbols
65. e see ee sed ee ee Ge ee ee ee ee Ge ee nennen 142 7 2 9 Assemble Command iese esse ee ee ee Se Ge GR ASA GRA Gee ee ee ee ee ee ee Re 143 7 2 10 Radix Command 4 ot emen rece c ie dee eee sake dees 143 7 2 11 Displaying Expressions sense eek oker Ee rette eto dete b eee 143 7 2 12 Reading Writing Files nenne nente Se REEDE RD E eis 143 7 2 13 System Commands sees see se ee ee ee ee Se Se e GRA GR Gee Ge ee ee ee ee ee ee 143 7 2 14 Displaying Modifying Symbols sse 144 7 2 15 xDisplaying Code ceo Dr e eed ipto tss 144 7 2 16 Displaying Modifying C Data eese nennen nennen 144 7 2 17 Setting Options oc UU RUE 145 7 2 18 Memo Commands cni cecidere eiit ditte cei iet eene Re tee ires sees 145 7 2 19 Logging Running Batch Commands eene 145 7 2 20 Screen Control Miscellaneous Commands eene 145 7 2 21 Predefined Symbols tete e eee eed 146 7 2 22 Macro Commands oe Rete OPE D dete ette eed 146 CHAPTER 8 APPENDICES 8 1 In Circuit Emulator Specifications sess eene etre ener Ge nee rns 148 8 1 1 Functional Specifications eie pere cete e nu eg Ee Eee eae 148 8 1 2 Electrical Specifications EE EE Deor 149 8 1 3 Environment Specifications essere ene eene nennen 149 8 1 4 External Dimensions s is see see see ee se ee ee ee Ge oer neon nooo E eene ee ee ee ee 149 8 2 Configuring Interface Board neen e
66. eful not to press too firmly on the button When the button has popped out it protrudes approximately 1 or 2 mm from the top of the no fuse circuit breaker 8 2 Configuring Interface Board Chapter 8 Appendices 151 Interface Board for PC AT Rotary switch IBM PC AT XT I F BOARD O O im ces Mio sw DIP switch 2 09 m DSW p ESE pswa ME DSWS RA es DSW3 ER ESE DSW2 E ore EE pswt B ENGER OER GERGEN GENOEG EH EL ETT ON OFF DIP switch DSW5 7 settings EHE NEN ee UNE Rotary switch DSW 1 2 3 4 6 settings Set the I O address to an unused address between x300H and x3FFH Note Dashes indicate that the setting does not matter 8 2 Configuring Interface Board 152 8 3 Error Messages C Source Code Debugger Win displays an error message when it detects an error in a user command The following lists possible error messages and their meanings Address error This message appears when the address input field contains an improper address specification when the starting and end addresses are reversed and when the input uses an undefined symbol Illegal instruction breakpoint The device executed an illegal instruction Use the real time trace function to determine the address of the problem instruction Cannot add watch variable max 16 There are too many watch variables The limit is 16
67. emicolons SD lt directory gt The specified directory becomes the directory with the source files For example enter the following in the icon s command line text box when the source files exist in the directory C YPANAXYPRJ C WICE101C BIN WICE101C EXE SDC WICE101C PRJ 3 4 Specify Starting Options Chapter 3 Using Debugger for First Time 49 TAB option This option specifies the tab size for displaying source code in Code windows Use it to change the tab size to that used in your editor TAB tab size This option sets the tab size to the specified number If the option is omitted the default is eight For example to set tabs every four columns enter the following in the icon s Command line text box C WICE101C BIN WICE101C EXE TAB4 X options These options specify either the assembler or the C debug mode Using the wrong specification interferes with proper debugging or limits access to particular functions X This option specifies assembler debug mode It is the default C Source Code Debugger Win loaded in this mode does not support such C related commands as stack backtracing and the display of local variables XC This option specifies CC101C compiler debug mode 3 4 Specify Starting Options 50 3 5 Load the Debugger To load C Source Code Debugger Win double click the mouse on the shortcut created with Pset101C 3 5 1 Debugger Loads Normally If all
68. es In addition to the files mentioned above C Source Code Debugger Win supplies the following files on the floppy disks Model specific definition file ENV101C TXT This file configures the environment to match the target probe used The environment settings file PICE101C ENV is created from this file C Source Code Debugger Win help file WICE101C HLP Pressing the keyboard Help key or clicking the mouse on the lt Help gt button in a dialog box displays this help file Instruction set help file NEM101C HLP This file provides help for the MN101COO series instruction set Clicking the mouse on the lt Instruction set gt button in the debugger help displays this file To return to the debugger help click the mouse on the lt Debugger gt button 3 2 Check Files Chapter 3 Using Debugger for First Time 45 3 3 Create Environment Settings File Create the environment settings file PICEIOIC ENV in the working directory by editing the model specific definition file ENV101C TXT matching the target probe used E N Clicking the mouse on the lt Env gt button on the Pset101C tool bar produces the following dialog box The Table below lists the settings provided Environment Settings Interface method IF O PCMCIA Interface board 1 0 address flo y CPU 101C01D Memory expansion mode C SINGLE ODE C PROCESSOR Stack pointer after reset 0x0001 00 Figure 24 Environment Settin
69. es all windows not reduced to icons so that they divide up the display area C Source Code Debugger Win picks the positions Arrange Icons Aligns the windows reduced to icons Restores the window layout to that stored with the User Savel User1 command Restores the window layout to that stored with the User Save User2 command User3 Restores the window layout to that stored with the User Savel User3 command User Save Saves current window layout 5 2 Menus 5 2 8 Options Menu Options The Options menu contains commands for configuring C Select Color Source Code Debugger Win Custm ToolBar Font Select Option Set v ReSize Window Displays the dialog box for changing the background and text colors for windows RS 5 21 4 Color Dialog Box Displays the dialog box for modifying the button layout on the tool bar E 5 21 3 Tool Bar Dialog Box Font Select Displays the dialog box for changing the font font style and font size for text in the window that currently has the focus Re 5 21 2 Font Dialog Box Debugger Win settings window 5 2 9 Help Menu The Help menu contains commands for Help Contents Keyword Search accessing the help system Help on help About C Source Code Debugger Help Contents Displays the table of contents for C Source Code Debugger Win help Keyword Search Searches the C Source Code Debugger Win on line help b
70. es the following shortcut keys for executing commands These shortcut keys apply when the Stack window has the focus Key Combination Function Displays the symbols corresponding to the stack data Displays the actual memory addresses for the stack 5 9 2 Stack Window Local Menu isnie The Child Stack menu contains commands for controling the Symbols F6 Addresses F7 Stack window Function Symbols Displays the symbols corresponding to the stack data Displays the actual memory addresses for the stack 5 9 Stack Window Chapter 5 Window Commands 89 5 10 Local Window The Local window displays the contents of the local variables for the function currently with the program counter PC A plus sign to the left of the variable name indicates a variable with elements array members structure members etc that may also be displayed a minus sign a variable with its elements displayed Figure 41 Local Window a The Local window is only available when C Source Code Debugger Win is loaded with LI the XC option RS 3 4 Specify Starting Options 5 10 1 Local Window Shortcut Keys The Local window provides the following shortcut keys for executing commands These shortcut keys apply when the Local window has the focus Key Combination CTRL I Adds the currently selected variable to the Watch window CTRL W Toggles the display of offsets for the local variables
71. ese window specific mouse operations 5 4 Mouse Operations 76 5 5 Code Window A Code window displays the source code either alone or mixed with assembler There are two Code windows They support a variety of display configurations DHRYSTONE PROG Hifndef G Hendif X Was missing in publ sl Program counter PC Breakpoint Figure 36 Code Window 5 5 Code Window Chapter 5 Window Commands 77 5 5 1 Code Window Shortcut Keys The Code windows provide the following shortcut keys for executing commands These shortcut keys apply when a Code window has the focus Combination Displays the dialog box for selecting a source code module for the loaded user program for display in a Code window Re 5 21 8 Module Dialog Box F1 F3 Toggles the Code window display between source code and V command disassembler output The display is always centered on the U command line currently containing the program counter PC F6 Inspects the currently selected variable INS command CTRL F6 CTRL I dili 7 nac NN PC to the current cursor position position CTRL F1 Duplicates the action of the lt Maximize gt lt Restore gt button switching the Code window between its maximum and original sizes ICTRL F2 Shifts the focus to the next window CTRL F3 Toggles the Code window display between source code and V command disassembler output The display is alway
72. essere 97 Shortcut Keys eei See Ge rere ie 96 Basic Operating Procedure esse sesse se ke ee ee ee 20 BE command esse EE CIAO 145 BD commiand 5 2 EE 146 BE COMMANA zer E ER 146 BEL COMMANA yros i eet 151 Ea Soe Ee aa 111 Botte command cin 83 104 BP command ov sesse Se osse eg ee aao da 81 84 145 BPA EOMMaNAE ME EE Ree e edt 145 BRS comiand OE pee 145 BREAK comimiand iet etis 152 Breakpoint Commands eese 145 Breakpotnts eee RERO RH DER IRR BY Ge 18 Break windows eerte e Dr tea eH ERE dig 100 Local men unser rrt ie 770 101 Mouse Operations essere 102 Shortcut Keys oe eet ect ey 100 ISO soe aloe SES ERES ETE EG EE set 113 115 Byte command 5 5 nter 89 111 C commahd et RR 149 C EXDIeSSIODS Lise ROCHE HERRERA 138 C El ER nana 139 Cascade conmmandg is cae EA EES Ee GN ec 12 Change command eere 91 106 Char ASCIT command essere 89 Clear corumand 12 5 etr rre it 99 101 Clear Alfjeomnmand es tette exer 65 109 AAA doses EE 151 AS AAA N OO N 80 AA o 68 83 Mouse Operations seen 84 Shortcut Keys Ree t ERR Ee ee 81 Color dialog bo ee e emet 120 Comelcompiand d boc AGED RR ERO EC 67 83 Command Description Conventions sss 144 Command History dialog box sess 123 Command History file eee 45
73. find the specified C variable Cannot start in STOP or HALT mode The CPU is in STOP or HALT mode Before user program execution can resume you must modify the contents of the CPU mode register Source line butter full The debugger has run out of space for source line information Restart C Source Code Debugger Win using the B command line option to specify a larger buffer 8 3 Error Messages 154 Target reset on Monitor program inoperative Check probe and installation Make sure that the model number specified with the Pset101C command matches that on the evaluation chip Disk full There is not enough free space on the specified disk Data specification error This message indicates an illegal data value in the input or a value that is out of range Debugging information missing The debugger found no debugging information in the executable file Matsushita ex format loaded with the L command Invalid debugging information format The debugging information in the user program is not in the proper format Debugging information buffer full The debugger has run out of space for debugging information Restart C Source Code Debugger Win using the B command line option to specify a larger buffer PICE internal error This message indicates a problem within C Source Code Debugger Win It should not normally appear If it appears in a reproducible fashion contact your nearest Matsushita representati
74. gs Dialog Box computer or PCMCIA card Interface board VO Enter the I O address specified with the DIP switches on the address interface board ES 8 2 Configuring Interface Board Select the device being used mode reset must be within memory physically present a C Source Code Debugger Win reads the environment settings file when it loads Be E careful not to accidentally delete or modify the contents 3 3 Create Environment Settings File 3 4 Specify Starting Options 3 4 1 Specifying Starting Options via Dialog Box on the Pset101C tool bar produces Clicking the mouse on the lt Option gt button the following dialog box for specifying the C Source Code Debugger Win starting options Pset101C writes these settings to the starting options file WICEIOIC INF which the debugger then reads in when loading The Table below lists the settings provided Debug buffer size 64 Macro buffer size 2 Extention je Source step mode P Command y Tab size 8 Debug Info mode Compiler y Source Path Figure 25 Option Dialog Box in 16 kilobyte units kilobyte units Adds an extension to the list of source file types displayed i in Code windows single step execution step execution Code windows Debug info mode Ed Specifies the assembler debug mode xc Specifies the CC101C compiler debug mode Source Path SEA Specifies the directories containing the source files displayed in
75. h floppy disk When the contents of the disk appear in the right panel double click the mouse on the icon labeled Setup exe to launch the program Y Exploring 3 Floppy File Edit View Tools Help All Folders Contents of 3 Floppy Desktop _mstest aa Setup Ist My Computer si Bc4021tl di laa Setupapi inc 9 3 Floppy Bids402 dl_ Startup as_ eg Ms dos_6 C Cti3dv2 dl w101c amp e D Msdetectinc laa Wicel O1c mst e E Owi202 dl amp Control Panel Panaxin 3 Printers hal sample 7 5 Network Neighborhood pec eg Recycle Bin 22 Sample ex_ 1 object s selected 24 0KB Ua Figure 13 Running from Explorer 2 2 Installation 32 The installation program starts by asking for directories Figure 14 Choose Destination Location x Destination Directory C WICE101C r Directory M Debugger C WICE101C BIN Project C WICE101C PRJ M Sample C WICE101C EXP Figure 14 Installation Directories Dialog Box To change directories for C Source Code Debugger Win components enter the path names from the keyboard Debugger Specify the directory for installing the C Source Code Debugger Win program files Specify the working directory Sample programs Specify the directory for installing the sample programs If you do not wish to install a particular group of files click the mouse on the check box next to it to erase the check
76. he user program is executing 5 1 2 Screen Display Most windows do not allow horizontal scrolling to display data that spills off the right of the window To display such data you must adjust the window size and or the font size The only windows supporting horizontal scrolling are the Code and the Memo windows When the results of a Find command lie in the hidden part of the window three right angle brackets gt appear in the corresponding line Figure 33 To display the search results adjust the window size and or the font size and issue the Search Next command Figure 33 Search Text in Hidden Part of Window 5 1 Screen Layout Chapter 5 Window Commands 61 The menus contain the C Source Code Debugger Win commands arranged in groups Commands either execute immediately or display a dialog box for specifying additional options Menu bar File Edit Searc View Run Beane N Window Options Help eot pr stri Light color items are not available Come F7 Source F3 Some commands Items with ellipses lead to Module Fi offer keyboard i F ii h dialog boxes os FER CtrtQL shortcuts A check mark v indicates that the Sort uA corresponding function is currently PC Location CtritQP active N File Focus v Function Focus Flip 5 2 1 File Menu File cad The File menu contains commands related to files The Module eloa command is only available when a Code window or th
77. hen the Command window has the focus Key Combination SHIFT F1 Copies one character from the immediately preceding command C1 SHIFT F2 Displays the dialog box for selecting from previously entered commands mn 5 21 11 Command History Dialog Box preceding command CA CTRL A Moves the cursor to the end of the command line Ln Bot CTRL F 5 6 Command Window 82 SHIFT F6 Displays a dialog box listing command lines formed by completing the current partial command line with all global symbols starting with the word at the end of the command line R 5 21 12 Expand Symbol Dialog Box CTRL U SHIFT F8 Clears the command line and the command history BS Deletes the character to the left of the cursor CTRL H c Moves the cursor one character to the left SHIFT lt CTRL S gt Moves the cursor one character to the right SHIFT gt CTRL D CTRL G CTRL V SHIFT T Scrolls backward through the command history starting with the most recent CTRL W command If there is text on the command line only commands beginning with that text are displayed SHIFT 4 Scrolls forward through the command history starting with the oldest command If there is text on the command line only commands beginning with that text are displayed SHIFT INS Inserts the text from the Clipboard on the command line The Command window supports most of the same function keys and Ctrl function key m combinations as the Cod
78. id rtm 151 Left button drag erret eo tree eene o ene ee 78 Line nole mmand ses sec t ee e re 83 Line del IE TN 134 Bid ei N 56 LIST command iii it 151 Ei eLo 64 87 Load Setting command eee 101 Load the Debugger eene erret 51 Loading User Program Commands 145 ESCAMILLA 68 Local menu LBatk Trac WIBONW erica 70 97 Break Window sese 70 101 Code ROOM ee apt DEAN SERERE EHE 68 83 Command Window eee 68 87 Inspect window eee 71 106 Local windOW eese rn teen 69 95 Memory Window eene 69 89 Meno Dido i GE ER ta REM Ce red 70 109 RAM Monitor window eee 71 111 Register window eese 69 91 Eg AA 69 92 TRACE WINGS uit MOREM RC RETE 71 104 Watch WO OR EO ria exi N ind 70 99 Local Symbols aiii 132 socal NottdoW twa cia eA aa eee ols 94 AA O 69 95 Mouse Operations 95 SliortCut Keys eet et eite er in ee oes 94 Logging Running Batch Commands 151 Long Floats command eene 89 EP comimand ESE SERE EE DO ntn 145 M commiand ea dere pet 149 Macro Commands sse 152 O MA DIE HIS 15 Main window eese eene enne enne 61 Make sequential breakpoint condition 1 command 101 Make sequential breakpoint condition 2 comma
79. ined macros to the specified file lt file name Loads macros from specified macro file IF lt expression gt Adds C like if elseif else control statement to macro 7 2 Commands Grouped by Function Chapter 8 Appendices 8 1 In Circuit Emulator Specifications 8 2 Configuring Interface Board 8 3 Error Messages 148 8 1 In Circuit Emulator Specifications 8 1 1 Functional Specifications Item Target device Memory Emulation memory capacity Breakpoint ROM breakpoint functions RAM breakpoint Sequential breakpoint Trace breakpoint RAM access violation breakpoint External breakpoint Trace Trace memory size functions Trace get data Trace mode Timer Measurement modes functions Time measurement resolution Trigger output functions RAM monitor function Display modes Performance Profiler evaluation 8 1 In Circuit Emulator Specifications Specifications 224 kilobytes Maximum of 4 events Conditions Area specification pass count specification Maximum of 4 events Conditions Area specification pass count specification bit mask read write access specification match mismatch specification AND condition specification Two levels Two levels One bit 511 steps ROM address RAM address RAM data R W Normal mode ROM RAM area mode delayed trigger mode Execution time measurement mode maximum execution time measurement mode 100 ns One output 32 bytes Dump list mode bit map
80. ing debugged The first format specifies an absolute line number If there is a file name the specification indicates the specified line number in the specified file Otherwise it indicates the specified line number in the current file the one displayed in the Code window gt u 100 Line 100 in the currently selected source file gt u sample 120 Line 120 in sample c The second format expresses the target address as a line number relative to the source line currently containing the program counter PC A plus indicates the line the specified number of lines after the current source line a minus the one the specified number of lines before The format produces an input error if the specified line does not exist gt v 10 10 lines past the line containing the program counter PC The third format expresses the target address as a line number relative to the specified symbol A plus indicates the line the specified number of lines after the symbol a minus the one the specified number of lines before The format produces an input error 1f the specified line does not exist gt bp main 10 10 lines past the symbol main 6 1 Data Expressions 128 C Source Code Debugger Win supports the use of ASCII text strings instead of numerical values Put such strings inside single guotes N 41 AB 4142 ABCD 41424344 The E EB command for example accepts up to 16 s
81. ing usually just means viewing the contents of variables There is relatively little call for modification To prevent accidental modification of variables as the result of expression evaluation therefore C Source Code Debugger Win blocks C expressions containing operators with side effects from the watch inspect and commands Only the VAL command permits them If your primary interest is merely viewing data stick to the and inspect commands Save the VAL command for when you deliberately wish to use operators that have side effects Function calls are even more dangerous since a function may very well modify global variables static variables or via pointers other data areas that do not appear in the expression If you are not careful it may even become impossible to resume program execution Be extremely careful when using the VAL command to evaluate an expression containing a function call gt abc 1234 Operators with side effects not allowed gt val abc 1234 Set abc to 1234 int 1234 0x4D2 gt val fnc 1 2 3 Call function fnc int 10 OxA gt 6 2 Data Expressions Using C Syntax 136 6 2 Data Expressions Using C Syntax Chapter 7 Dialog Command Reference 7 1 Command Description Conventions 7 2 Commands Grouped by Function 138 7 1 Command Description Conventions C Source Code Debugger Win commands consist of a command name followed by a parameter list Sometimes
82. instead R 5 21 6 Set Inspect data Dialog Box Watch Adds the currently selected variable to the Watch window If the text at the current cursor position is not a variable that can be watched the Set Watch data dialog box appears instead RS 5 21 7 Set Watch data Dialog Box Come Runs the user program from the current program counter PC to the current cursor position Disassemble Toggles the window display between source code and disassembler Source output Module Displays the dialog box for selecting a source code module for the loaded user program for display in a Code window mS 5 21 8 Module Dialog Box Line no Displays the dialog box for specifying the starting line number Address source code or starting address disassembler output m 5 21 9 Set line no Dialog Box 5 21 10 Addressing Code RAM Monitor Dialog Box Displays the start of the source code Displays the end of the source code PC Location Displays the current program counter PC position 5 5 Code Window 80 File Focus Checking this item while the file currently containing the program counter PC is displayed causes the focus to switch back and forth between the two Code windows whenever the program counter PC leaves or enters the file Function Focus Checking this item while the function currently containing the program counter PC is displayed causes the focus to switch back and forth between the two C
83. ints they greatly improve debugging efficiency These functions update the display of trace memory contents every machine cycle as the user program executes C Source Code Debugger Win includes a profiler for determining the functions where the user program spends most of its time and a RAM Monitor window for displaying the contents of RAM on the screen as the user program executes 1 1 Features 16 1 2 Important Notes This section lists important things to watch out for when using the in circuit emulator 1 2 1 Hardware e The pins on the probe are precision parts that must be protected from physical shocks When storing the probe cover the connectors with the caps provided e Do not touch the surface of the interface board or the circuit board inside the in circuit emulator e The emulator only supports separately excited oscillation OSC XI for the target e There is a certain amount of error in execution time measurements over extended periods The in circuit emulator does not operate properly under the following conditions e The clock is supplied by the target and the clock waveform either does not have the proper levels or contains excessive noise e The power to the target is off e The bus request signal from the target is active for longer than a specific interval approximately 0 1 seconds e The reset signal from the target is active for longer than a specific interval approximately 0 1
84. ions 6 2 Data Expressions Using C Syntax 124 6 1 Data Expressions C Source Code Debugger Win dialog commands are backward compatible with those of the MS DOS version The debugger supports a wide variety of symbolic and arithmetic expressions for specifying addresses and data 6 1 1 Symbols C Source Code Debugger Win supports two types of symbols global symbols valid everywhere in the user program and local symbols valid only inside the current function 6 1 2 Global Symbols Global symbols may be used as address values for label and address input to disassemble commands They include C extern variables and function names C normally prefixes or suffixes variable names and function names with an underscore _ Since entering this underscore each time that you enter a global symbol can get tiresome C Source Code Debugger Win allows you to omit it It also allows you to choose whether or not to make case significant ES OPTION command Options Option Set Note however that if a symbol has the same name as a CPU register the CPU register takes precedence In other words you cannot access variables with the same names as CPU registers Using a global symbol to specify an address gt u main Disassemble starting at symbol main gt u main Same as above Address Figure 54 Using Symbol _main in Addressing Dialog Box 6 1 Data Expressions Chapter 6 Dialog Command Data 125 Using a global
85. language versions of the operating system Windows The package requires Windows 95 or Windows V3 1 Before starting the C Source Code Debugger Win installation procedure make sure that Windows is running on the computer Typographical Conventions This manual uses the following typographical conventions Menu Menu names are enclosed in square brackets Menu Command Commands are also shown in square brackets and preceded with the name of the menu on which they appear Dialog Dialog boxes are also shown in square brackets lt Button gt Button names are shown in angle brackets On Line Help C Source Code Debugger Win includes on line help for on screen viewing of explanations for functions and procedures To display these help screens press the End type the HELP dialog command select the Help Contents command or click the mouse on the lt Help gt button Preface Chapter 1 Overview 1 1 Features 1 2 Important Notes 1 3 Basic Operating Procedure A C Source Code Debugger Win incorporates many features to make work easier for the developer 1 1 1 Enhanced Features Users of the MS DOS version should have no trouble making the transition since most keyboard operations including function keys for the Code and Command windows are the same The software has been enhanced however with such standard Windows features as pull down menus scroll bars a tool bar and on line help
86. mark To restore the check mark click the mouse a second time on the empty box Click the mouse on the lt Install gt button to start installation 2 2 Installation Chapter 2 Installation 33 Clicking on the lt Install gt button starts file copying After a while a dialog box asks for the second disk Change floppy disks and click the mouse on the lt OK gt button When it has finished copying the files the program creates the PanaXSeries group in the Program Manager Windows V3 1 or the Start Program menu Windows 95 This completes the C Source Code Debugger Win installation Windows 95 displays the following window lel ES Ig PanaXSeries File Edit View Help gt 9 9 9 Instruction of Pserl 1C Help WicelO1C MN101C Help Figure 15 New PanaXSeries Group When C Source Code Debugger Win installation is complete put the floppy disks away for safe keeping 2 2 Installation 34 You may exit the program when the Installation Directories dialog box is on the screen or the program is copying files In the latter case however the program leaves the newly created directories on the hard disk Before repeating the installation remove these with Explorer File Manager or the DOS DEL command 2 2 Installation Chapter 3 Using Debugger for First Time 3 1 Set Up Environment with Pset101C 3 2 Check Files 3 3 Create Environment Settings File 3 4 Specify Starting Options 3 5 Load the
87. memory data in bytes Displays the memory data in hexadecimal Displays the memory data in decimal Address Displays the dialog box for specifying the starting address for the display 13 5 21 13 Addressing Memory Dialog Box Displays the all memory datas or 32byte datas 5 17 RAM Monitor Window 106 5 18 Tool Bar This section describes the C Source Code Debugger Win tool bar The tool bar is a handy new feature with buttons that provide instant access with a single mouse click to C Source Code Debugger Win commands The following describes the procedure for assigning buttons to the tool bar and the function of each button available The View Tool Bar command alternately hides and displays the tool bar E 5 2 4 View Menu slae 6 5 aaa 53 1 2 Figure 50 Sample Tool Bar 5 18 1 Tool Bar Configuration The Options Custm ToolBar command displays the Tool Bar dialog box Select a button from the List of Button list box and click the mouse on the Add button to add the button to the Tool Bar list box R 5 21 3 Tool Bar Dialog Box Separator Figure 51 Tool Bar Dialog Box 5 18 Tool Bar Chapter 5 Window Commands 107 5 18 2 Button Functions The following is a list of the buttons available for assignment to the tool bar and their functions Button Function Loads the user program to be debugged ge 5 21 1 File Open Dialog Box Reloads the currentl
88. nance and security is the only type of copying permitted 2 1 4 Start Windows Confirm that Windows loads properly 2 1 Preparing for Installation Chapter 2 Installation 27 2 2 Installation This section describes the procedures for running the installation program under Windows V3 1 or Windows 95 The files for C Source Code Debugger Win are stored on the floppy disks in a a compressed format so installing them involves more than simply copying them to the hard disk Always use the C Source Code Debugger Win installation program supplied on the first floppy disk 2 2 1 Read README WRI The floppy disk may contain a README WRI file containing additions to the manual cautionary notes and other late breaking material Be sure to read this file with Write WordPad or similar program before running the C Source Code Debugger Win installation program 2 2 2 Run Installation Program The proper procedure for installing C Source Code Debugger Win is to insert the floppy disk labeled Setup Disk and run the included installation program SETUP EXE from Windows If you are running Windows V3 1 proceed to Section 2 2 3 If you are running Windows 95 skip to Section 2 2 4 2 2 Installation 00 From Program Manager Insert the floppy disk labeled Setup Disk in the floppy disk drive Open the Program Manager s Icon menu and select the Run command In the Run dialog box that appears enter the name
89. nd 101 163 MEM command sss 151 Memo Commands pedibns 151 MEMO PT ataca 45 107 Memory command eere 91 Memoty windOw Ee EG RE SE eee ee 88 LOCA MEA OE 69 89 Mouse Operations essere 89 Shortcut de RE ER ene eo WE en ARS 88 Memo window EE E Eee ee ds 107 LOCAL MENU M TO EE 770 109 Shortc t de NO 107 ENE e noe ERE EUIS RA RUNE 64 Message lle EE GEE e eee ise 44 Miscellaneous rete tede 19 MEIST comrmiarg oes 152 MLIST command tete 152 Model specific definition file 39 45 46 52 Moodle commande i e eer A 64 83 Module dialog box eere 122 MONTOLE o a thee cnet 44 48 Monitor PLOMO iii 44 Mouse Operations ococoococoncconcnononnnononnconcnnnonccnncnncnncnnnons 71 78 Back Trace eed Wav pet rr exi tk Prin 97 Break window ese SE REGSE EES Gee etas 102 Code A Ge eae 84 Inspect windOw EE RE rese 106 Local idees aa 95 Memory Window eese 89 Register window eese 91 Watch Window ee esse ese ee ee Re Re Re Re ee 99 Mo ulle RE EE EG 149 Necessary Hardware esee 11 Necessary SOftwaTe TO 12 NEMOC HEP arnis tr eec 45 Next leommand uiu ses crista ect erre Ge Ge AG Ee 66 NLIST command meets 151 Numerical Values esee 133 164 Al Offsetlcommand roda POR AG Ee 95 On the Fly Support esee 15
90. ndow supports the Clipboard for moving data between windows so you can for example copy the values from the Register window here before running the user program copy them again after a break and compare the two sets You can also edit a macro in the Memo window and then copy it to the Command window C Source Code Debugger Win automatically saves the contents of this window to the file MEMO PT at exit and reads them back in the next time that it loads Di0 Figure 48 Memo Window The Memo window provides the following shortcut keys for executing commands These shortcut keys apply when the Memo window has the focus Key Combination Ctrl Ins Copies the currently selected text to the Clipboard Ctrl Del Deletes the entire contents of the Memo window Shift Del Copies the currently selected text to the Clipboard and deletes the original Shift Ins Inserts the text from the Clipboard at the current cursor position Alt BS Reverses the results of the last editing command 5 16 Memo Window Chapter 5 Window Commands 103 5 16 2 Memo Window Local Menu Child Memo The Child Memo menu contains commands for controling Lindo Alt BkSp the Memo window Cut Shift Del Copy Ctrl Ins Paste Shift Ins Delete Del Clear All Ctri Del Menu Item Function Paste Inserts the text from the Clipboard at the current cursor position Reverses the results of the last editing command Cut C
91. ne no dialog box sees 122 Set Software Break point command 67 Set Software Breakpoint dialog box 127 Set Up Environment essere 37 Creating a New Environment eee 39 Modifying an Existing Environment 43 Upgrading from MS DOS Version ss 41 Set Watch data dialog box sss 121 Setting Options SESSE SEG SEGE ERGE SE GEORG eerte ESL RS 151 Short Floats command eee 89 Shortcut Keys eee e el eee e re ONE ase 74 Back Trace Wind Ow uic eso eire a tes 96 id C A 100 Code windQW essa coim eR cai 81 Command window esee 85 Inspect window eese 105 EscallwiidoW Me Ie 94 Memory Window eese 88 Memo WINdOW ooo scu Ee RR oes 107 RAM Monitor window oooocccoonccconnnccnonanonnnnnncnnnanonnno 110 Register window eese 90 Stack window essent 92 ER Eie o ceca Dep od vacare 103 Watch windo Wa esca ete en Gb ERE MR ORE Ren REDE 98 Single step command eene 67 SM commarnd oerte te ee sege 147 SO tWate cte A 17 atea eoe a ea eo ete be E ER HU Ced ER 83 97 Specify starting options Create a New Environment sese 40 Modify an Existing Environment sss 43 Upgrading fr
92. nge data in hexadecimal U range Displays the frame range data in hexadecimal and as disassembler output TDW Displays the real time trace data in window mode 7 2 Commands Grouped by Function Chapter 7 Dialog Command Reference 141 7 2 6 Hardware Related Commands SM lt address gt Specifies displays the sample area SMB lt address gt Specifies the address for displaying in bits SMC lt address gt Clears the address for displaying in bits PROF lt mode gt Displays statistics on subroutine access profiler lt mode gt ON Turns profiler ON OFF Turns profiler OFF CLR Clears profiler statistics TG Resumes tracing TI lt mode gt Sets up displays timer mode lt mode gt RUN Measures time elapsed from program start to stop PAR1 Measures time elapsed up to first sequential event MAX Measures time elapsed for repeated sequential events and determines maximum value STOP Terminates timer mode TM lt mode gt T lt count gt lt status gt lt option gt Sets up displays trace mode lt mode gt PAREA ROM area trace mode DAREA RAM area trace mode ORAREA ROM and RAM area OR condition trace mode ANDAREA ROM and RAM area AND condition trace mode T lt count gt Traces specified number of times after trigger condition detected and then stops lt status gt MEM Memory access trace mode ALL All cycle trace mode lt option gt B Breaks when trace memory is full C Continues
93. nge gt Writes the contents of the specified memory range to the specified file EXIT Q lt exit code gt Exits C Source Code Debugger Win and returns to MS DOS Displays the command history I lt text gt Selects the last command beginning with the specified text from the command history HELP Displays the on line help 7 2 Commands Grouped by Function 144 X symbol name gt Displays the definition for the specified symbol or all symbol definitions if there is no parameter lt symbol name Defines or resets the specified symbol to the specified value V lt file name gt lt line gt Displays the specified line in the specified file in a Code window V lt symbol name gt Displays the source file containing the specified symbol in a Code window U lt address gt Displays disassembler output starting from the specified address in a Code window UPUSH lt address gt Pushes the current display address onto the address stack and displays disassembler output starting from the specified address UPOP Pops an address off the address stack and displays disassembler output starting from that specified address UEND Displays disassembler output starting from the last address pushed onto the address stack UX lt address gt Displays disassembler output starting from the specified address in the Command window K Backtraces the function call history INS lt C expression gt lt function nam
94. ocal Menu Ele i The Child Memory menu contains commands for Byte Word Double Word Short Float Long Float Char ASCID controling the Memory window Hexadecimal 0100030 n Decimal Address Set Enter Data F6 m r mn J Displays the memory data in decimal Address Set Displays the dialog box for specifying the starting address for the display mc 5 21 13 Addressing Memory Dialog Box Re 5 21 14 Set Data Dialog Box Displays the memory data in hexadecimal 5 7 3 Memory Window Mouse Operations Double clicking the left mouse button on the data portion of the window displays a dialog box for modifying the data Re 5 21 14 Set Data Dialog Box 5 7 Memory Window 86 5 8 Register Window The Register window displays the contents of registers and CPU flags It also displays register related information Figure 39 Register Window 5 8 1 Register Window Shortcut Keys The Register window provides the following shortcut keys for executing commands These shortcut keys apply when the Register window has the focus Key Combination Zeros the register or CPU flag at the current cursor position Displays the symbol corresponding to the register value Displays the contents of the memory location whose address is in the register Displays the dialog box for modifying the register at the current cursor position or the CPU flags
95. ode windows whenever the program counter PC leaves or enters the function Checking this item causes the focus to switch back and forth between the two Code windows whenever the program counter PC enters or leaves a function a The file lock function lock and flip commands are only available when both Code E windows are displayed 5 5 3 Code Window Mouse Operations The Code window provides mouse equivalents for the following commonly used commands Mouse Operation Dialog Command Inspect INS command variable Software breakpoint BP command number or address Single step execution Shift left click T command Function step execution Shift right click P command Ctrt right click 5 5 Code Window Chapter 5 Window Commands 81 5 6 Command Window The Command window is for entering dialog commands and displaying execution results using a traditional TTY interface For further details on dialog commands entered via the Command window see Chapters 6 and 7 and the on line help Command of 30 01 00 00 20 20 00 00 10 00 30 00 10 48 00 00 COG FF BF FF FB FF FF FF FF FF FF FF FF FF FF FF FF DO 01 D1 01 D2 01 D3 00 DWO 0101 DW1 0001 IM 0 I 0 AO 3FED A1 0200 HA 3FED SP 0100 PC 04100 jmp 4104_ Figure 37 Command Window 5 6 1 Command Window Shortcut Keys The Command window provides the following shortcut keys for executing commands These shortcut keys apply w
96. of the user program returning control to C Source Code Debugger Win Interrupts execution of a repeated command or macro 5 2 Menus Chapter 5 Window Commands 65 A local menu contains commands available only within the current window The local menu for the window that currently has the focus appears on the menu bar Clicking the right mouse button on the display also displays the local menu Child Code Menu ERUNT The Child Code menu contains commands for Inspect F6 Ctri l f Watch Ctrl W controling Code windows Come F7 ES 5 5 2 Code Window Local Menu Disassemble F3 Module F1 Line no Ctrl GL Top CtrkQR Bottom Ctrl Qc PC Location Ctrl QP v File Focus v Function Focus v Flip Child Command Menu Child Command The Child Command menu contains commands for Load Reload controling the Command window Reset R 5 6 2 Command Window Local Menu Paste Shift Ins History Shift F2 Exp Sym Shift F6 5 2 Menus Child Memory Menu Child Memory E The Child Memory menu contains commands for controling Y By e Word Double Word Short Float Long Float Char lA SCID the Memory window E amp 5 7 2 Memory Window Local Menu v Hexadecimal Decimal olorvoozum mn Address Set Enter Data m y a o Child Register Menu Child Register The Child Register menu contains commands for controling the
97. om MS DOS R Version 42 Stack Window a vasca ve pip as bx Ux TO ain N ATI Y 92 Local Ten esee ee eo ee rne rere de e 69 92 Shortcut Keys ise eee e e HE 92 Stare ment MNT 31 Starting Optiorns tei tenete rte ectee tede 47 Specifying Starting Options via Command Line 48 Specifying Starting Options via Dialog Box 47 Starting options file iese sesse ee Re ee Re Re Re ee 44 165 Status Bar command diria esaet orn ES erra en 66 Stat s EO te oe t RI tee 116 Kip Hm 135 Structural Elements rid Reo ee 60 Symbol command eene 91 Symbols command een 92 Symbols anite ER EHE ERR Ita 131 System Commands soseri oiis SE ee 149 Tcoimmand EE SE TOO ES EOE ee ee 84 145 TD command eene 146 TDW command 146 TG commiand visionar 147 command tet en 147 Wile command anal 72 TIMES COMMANG ori 151 TM command iese esse iii 147 Tool Barjcommand ee d ER o b EG a OR HERREN 66 Tool Bar dialog box eee 118 TOBA 112 Tool Bar Configuration eene 112 Top comiand ois e hehe ee 83 104 Trace Euncti ons tiere neri ee 15 Trace Go Trace Stop command sssss 104 Trace Window SE er er RUE OO ee ERR DONE 103 LOCA heri ee o a 71 104 Shortc t Keys O 103 Tracing IE EE TA 18 TRIG command retten 147 TS comtriarid coi
98. opies the currently selected text to the Clipboard and deletes the original Copies the currently selected text to the Clipboard Deletes the currently selected text Clear All Deletes the entire contents of the Memo window 5 16 Memo Window 104 5 17 RAM Monitor Window The RAM Monitor window displays in real time and in various formats the contents of the 64 byte sampling area specified with the SM command while the user program is executing Data locations outside the sampling area are filled with dashes Scrolling the window automatically changes the sampling area Figure 49 RAM Monitor Window 5 17 1 RAM Monitor Window Shortcut Keys The RAM Monitor window provides the following shortcut keys for executing commands These shortcut keys apply when the RAM Monitor window has the focus Displays the dialog box for specifying the starting address for the display 137 5 21 13 Starting Address Memory Dialog Box 6 H Displays the memory data in hexadecimal Displays the memory data in decimal FEE Displays the memory data in bits 5 17 RAM Monitor Window Chapter 5 Window Commands 105 5 17 2 RAM Monitor Window Local Menu Child RAM Monitor The Child RAM Monitor menu contains commands for Bit F3 Byte B F4 controling the RAM Monitor window v Hexadecimal 6 H Decimal 1 Address A F Zoom in out F6 Displays the memory data in bits Displays the
99. or installing and configuring the interface board and connecting to a PanaXSeries device Preface 11 Operating Environment This section describes the hardware and software necessary for installing the C Source Code Debugger Win package Before proceeding to the actual installation check your hardware and software Necessary Hardware Personal Computer and Memory The package reguires a personal computer that has a CPU that is an 80386 or better has at least eight megabytes of memory runs either Windows V3 1 or Windows 95 and contains an expansion bus matching the specifications of the in circuit emulator s dedicated interface board Display The display can be either external or built into the personal computer but it must support Windows V3 1 or Windows 95 Hard Disk C Source Code Debugger Win requires a hard disk with at least five megabytes of free space Floppy Disk Drive Setting up C Source Code Debugger Win requires at least one floppy disk drive This drive must match the specifications of the floppy disks included with the package Mouse To derive the full benefit of C Source Code Debugger Win s many features you must have a Windows V3 1 Windows 95 compatible mouse attached to your personal computer Preface 12 Necessary Software MS DOS The Windows V3 1 version requires that the MS DOS be running on the computer used The Windows 95 version runs under both English and Japanese
100. program to be debugged Folders c panax Network Select the List files of type drive Executable file LEX v Drives Select the type of files to display in the File name list box 5 21 Dialog Boxes 112 Options Font Al The Font dialog box is for changing the font font style and font size for text in the window that currently has the focus Select the font style Select the font SS Courier New Fixedsys Terminal Select the font size Sampl AaBbYyZz Script wesen 7 i Options Custm ToolBar The Tool Bar dialog box is for modifying the button layout on the tool bar Selecting a button in the Tool Bar list box and pressing the Del key removes the currently selected button from the tool bar Specify the position Add the currently of the button selected button to the tool bar Shift the button up or down the list Separator Select a button to be added to the tool bar Pil Trace Remove the currently selected button from n the tool bar This area gives the currently selected button s function 5 21 Dialog Boxes Chapter 5 Window Commands 113 Options Select Color The Color dialog box is for changing the background and text colors for windows This panel shows the new colors Select the window to modify Adjust the red component Adjust the green component
101. reen shots of operation under Windows 95 Header Title Debugger for First Time Summary This material 3 3 Create Environment Settings File provides a brief overview of the Create the environment settings file ENV 101C TXT in the working directory by editing section the model specific definition file PICE101C ENV matching the target probe used Icon This shows an on screen icon Env Clicking the mouse on the lt ENV gt button on the Pset101C tool bar produces the relevant to the text following dialog box The Table below lists the settings provided Envirc etting Environment Setting Simulator Starting option Target enironment Pe Figure n This illustrates aii 103E00 the text Stack pointer after reset 00000100 Figure 25 Environment Setting Dialog Box Interface Choose either dedicated interface board in the desktop method computer or PCMCIA card Cross Interface board Enter the VO address specitied with the DIP switches reference VO address the interface board LE 7 2 Configuring Interface Board This indicates Select the device being used the location of BUS SIZE Select the bus size Ag IS 1 r Memory mode Select the memory mode Ex ustratos hd Stack pointer Enter an initial value for the stack pointer This address after reset must be within memory physically present Note a C Source Code Debugger Win reads the environment settings file when it loads Be careful not to accident
102. rint Elsetupapi inc Associate starfup as ver dll Dw101c inf Create Directory Search Select Files Figure 10 Running from File Manager 2 2 Installation Oo o By Specifying File Name Insert the floppy disk labeled Setup Disk in the floppy disk drive On the Start menu select the Run command In the Run dialog box that appears enter the name of the drive containing the Setup Disk and the file name setup exe in the Command line text box Type the name of a program folder or document and Windows will open it for vou Open fa Setup exe Figure 11 Running from Run Dialog Box Alternatively click the mouse on the Browse button and select the name of the drive containing Setup Disk and the program name setup exe in the File Browser dialog box that appears Click the mouse on the OK button to run the program Look in 2 3 Floppy A Ej ex _mstest File name Setup Files of type Programs 7 Cancel Figure 12 Running from File Browser Dialog Box 2 2 Installation Chapter 2 Installation 31 From Explorer Insert the floppy disk labeled Setup Disk in the floppy disk drive On the Start menu select Programs and then click the mouse on Explorer to run the program In the left panel showing the disk drives and folders select the name of the drive containing the Setup Disk Desktop My Computer 3 5 inc
103. s 58 5 1 1 Structural Elements nere bone eoi epe 58 5 12 Screen Display ienasi ES SS EE etin e ee eet ted 60 3 2 MENUS EA Rd e pede epe Reden REPRE qan 61 5 241 Pile Menu EE Ron Re RE HEEN 61 23 222 Edit Men EG SE DS GE a PINE 62 NM e sti O 63 5 2 4 View ER ais 63 IZ ROA Me A Md deutuuetu 64 5 2 6 Local Menus for Individual Windows ese see see se see se ee ee ee ee Ge Ge ee RA ee 65 5 2 T Wmdow Menu een o ele nat 69 3 2 8 Options Menu pedet eee reee tegere tier pee oe a De Ee gee 70 3 229 Help Menu EE EE EE OE Et SE EE 70 3 3 Shortcut OE AE EE ORE AE RE EE EE EE RE EO EE N 71 CONTENTS 5 3 1 Shortcut Keys Available in All Windows serene 71 5 3 2 Window Specific Shortcut Keys essere eene 73 24 Mouse Operations teo RH pd Re Eg ere e o nene edis 74 5 4 1 Mouse Operations Available in All Windows eee 74 5 4 2 Window Specific Mouse Operations ooooconocconnconoconcconocnnonnnonnnnnn oran ee Ge corona eene 75 5 3 Code Window EE OE EE EE EE ia EE ENE GE EE N 76 5 5 1 Code Window Shortcut Keys ee se ee GR ee ee GR RA ee GR AA ee RA ee ee Ge ee IT 5 5 2 Code Window Local MENU se ee Re RA GR ee ER Re ee ee RA ee GR Re ee ER Re ee ee ee 79 5 5 3 Code Window Mouse Operations ee se ee ee ee GR ee Re ee ee ee ee 80 0 Command WIDdOW EE EE EES ER EE EE Ge istae etienne munie Se 81 5 6 1 Command Windo
104. s centered on the U command line currently containing the program counter PC li MN CTRL L specified direction from the current cursor position to its caller Adds the currently selected variable to the Watch window CTRL W 5 5 Code Window 78 CTRL V window command a CTRL G Command window ale MIN 0 Clipboard address to display U command CTRL QR Displays the start of the source code CTRL QC Displays the end of the source code CTRL Q J Returns windows to the starting layout p ENE p P PC CTRL F For the source code display moves the cursor to the next word For the disassembler output display moves the cursor in the order address gt code gt mnemonic sl lac previous word a The Code window also supports the shifted key combinations given in Section 5 6 1 L Command Window Shortcut Keys 5 5 Code Window Chapter 5 Window Commands 79 5 5 2 Code Window Local Menu ik edel The Child Code menu contains commands for Inspect F6 Ctrl l Watch Ctrl W controling Code windows Come F Disassemble F3 Module F1 Line no Ctri tQL Top Ctrl QR Bottom CrkQc PC Location Ctrl GP v File Focus v Function Focus v Flip Menu item Function Inspect Displays the currently selected variable in the Inspect window If the text at the current cursor position is not a variable that can be inspected the Set Inspect data dialog box appears
105. s section describes the C Source Code Debugger Win window bar The window bar is for rapidly switching between C Source Code Debugger Win windows The View Window Bar command alternately hides and displays the window bar The following lists the window for each button The button settings on the window bar cannot be changed ge 5 2 4 View Menu Figure 52 Window Bar Code window 0 BH ee Watch window a 5 19 Window Bar 110 5 20 Status Bar The status bar displays the real time trace address hints for shortcut keys buttons and menu error messages C Source Code Debugger Win status messages and the like The View Status Bar command alternately hides and displays the status bar ge 5 2 4 View Menu 104100 1 Module 2 Optwin 3 SrcSW 4 Search 5 80 6 Inspct 7 Come 8 SglStp 9 Break 10 FncStp Forceful ly terminates execution of the user program 04177 ant set break point OB Running execution 0 0 0 00 0000000000000 Figure 53 Sample Status Bars 5 20 Status Bar Chapter 5 Window Commands 111 5 21 Dialog Boxes C Source Code Debugger Win has many dialog boxes This section discusses them individually 5 21 1 File Open Dialog Box File Load The File Open dialog box is for selecting and loading the user program to be debugged Double click the mouse on the folder containing the user program to be dahiinnad Select the user
106. s the directory for creating the C Source Code Debugger Win environment the one already in use by the MS DOS version of the debugger Clicking the mouse on the lt OK gt button produces the warning message box shown in Figure 21 Click the mouse on the lt No gt button to keep from overwriting your existing environment settings file PICEIOIC ENV Target Directory Ed Directories fe wicel01c ey cs C3 wicel lc Network dl Drives S c ms dos 6 gt Figure 20 Specifying Working Directory N pice101c env exsist Overwrite Figure 21 Confirm Message Box 3 1 Set Up Environment with Pset101C Chapter 3 Using Debugger for First Time 41 Specify starting options Specify the C Source Code Debugger Win starting options These options tell the debugger such things as the operating mode and memory configuration For further details see Section 3 4 Specify Starting Options EIS Create a shortcut Reg Create a shortcut to the current C Source Code Debugger Win setup by double clicking the mouse on a group Double clicking the mouse on that icon then loads the debugger Registory icon Ea Icon name Wicel Old po id PanaXSeries Accessories PanaXSeries Figure 22 Creating Shortcut Labeled WICE101C Save Save the edit setup in the project file The environment configuration program the icon Save setup labeled Pset101C then automatically reads in
107. seconds e The target is operating in the handshake mode and the NDK signal from the target does not become active within a specific interval e The NDEAD signal from the target is active for longer than a specific interval approximately 0 1 seconds 1 2 Important Notes Chapter 1 Overview 17 After installing the software on the hard disk put the floppy disks away in a safe place for use as master disks Backing up the C Source Code Debugger Win disks for purposes of maintenance and security is the only type of copying permitted Backups can be made with such commands as the MS DOS DISKCOPY and COPY commands Add an extra ten bytes to the program user stack for use by the monitor program The addresses from 38000H through to the end of the 256 kilobyte address space are not available for use as emulation memory The D E U and other commands cannot display or modify data in the expanded ROM area if that is assigned to the target The microcomputer does not accept interrupts during Step command execution The Go Step and Come commands are not available when the microcomputer is in STOP or HALT mode Add an extra ten bytes to the program user stack for use by the monitor program This stack must be in either the RAM emulation memory or the RAM on the target TI the in circuit emulator s command for measuring execution time does not give correct results during single step execution 1 2 Importan
108. ses that address during that interval Neither can it be displayed if there is no access to a different address 1 2 8 Miscellaneous e There is a certain amount of error in execution time measurements over extended periods e Execution time measurements do not include the execution time for the first instruction e Ifthe target is operating in the handshake mode the in circuit emulator does not issue acknowledge signals when the microcomputer accesses the external memory space You must therefore provide a circuit or other mechanism for generating acknowledge signals for all external memory regions used e Note that the in circuit emulator does not issue acknowledge signals even for accesses to external memory space regions assigned to the emulation memory inside the in circuit emulator with the EX command 1 2 Important Notes 20 1 3 Basic Operating Procedure This section describes the basic operating procedure for C Source Code Debugger Win 1 Install software Install C Source Code Debugger Win on the hard disk with the installation program ES Chapter 2 Installation 2 Set up environment Set up the C Source Code Debugger Win operating environment with Pset101C 13 3 1 Set Up Environment with Pset101C There is a separate setup program for this purpose Target directory c wice101c exp Figure 1 Environment Configuration Program Pset101C 3 Load debugger After set
109. specified text 5 2 4 View Menu FE The View menu contains commands controlling the display of the v Status Bar v Tool Bar v Window Bar tool bar and other elements Flyover Hints Menu Item Status Bar Alternately displays and hides the status bar ms 5 20 Status Bar Tool Bar Alternately displays and hides the tool bar ms 5 18 Tool Bar Window Bar Alternately displays and hides the window bar I 5 19 Window Bar Flyover Hints Alternately enables and disables the display of button hints 5 2 Menus 64 5 2 5 Run Menu The Run menu contains commands for starting A is and stopping execution of the user program S Step F8 FEE Ge F10 The Come and Set Software Break point Until Return Ctri FS commands are only available when the Code Set Software Break point F9 window has the focus Forcible Break Go Resumes execution of the user program from the current program counter PC Come Executes the user program from the current program counter PC to the line at the current cursor position Single Step Single steps execution in units of source lines or machine language instructions Function Step Function steps in units of source lines or machine language instructions Until Return Executes the user program until the current function returns to its caller Set Software Activates or disables a software breakpoint Break point Forcible Break Forcefully terminates execution
110. ssissauga Ontario LAW 2T3 Tel 905 624 5010 Fax 905 624 9880 E GERMANY SALES OFFICE Panasonic Industrial Europe G m b H PIEG Munich Office Hans Pinsel Strasse 2 85540 Haar Tel 89 46159 156 Fax 89 46159 195 E U K SALES OFFICE Panasonic Industrial Europe Ltd PIEL Electric component Group Willoughby Road Bracknell Berkshire RG12 8FP Tel 1344 85 3773 Fax 1344 85 3853 E FRANCE SALES OFFICE Panasonic Industrial Europe G m b H PIEG Paris Office 270 Avenue de President Wilson 93218 La Plaine Saint Denis Cedex Tel 14946 4413 Fax 14946 0007 B ITALY SALES OFFICE Panasonic Industrial Europe G m b H PIEG Milano Office Via Lucini N19 20125 Milano Tel 2678 8266 Fax 2668 8207 E HONG KONG SALES OFFICE Panasonic Shun Hing Industrial Sales Hong Kong Co Ltd PSI HK 11 F Great Eagle Centre 23 Harbour Road Wanchai Hong Kong Tel 2529 7322 Fax 2865 3697 E TAIWAN SALES OFFICE Panasonic Industrial Sales Taiwan Co Ltd PIST Head Office 6th Floor Tai Ping amp First Building No 550 Sec 4 Chung Hsiao E Rd Taipei 10516 Tel 2 2757 1900 Fax 2 2757 1906 Kaohsiung Office 6th Floor Hsien 1st Road Kaohsiung Tel 7 223 5815 Fax 7 224 8362 E SINGAPORE SALES OFFICE Panasonic Semiconductor of South Asia PSSA 300 Beach Road 16 01 The Concourse Singapore 199555 Tel 390 3688 Fax 390 3689 B MALAYSIA SALES OFFICE Panasonic Industrial Company Malaysia Sdn Bhd
111. symbol inside a macro gt i 5 Defined symbol gt while i 0 T Assign the value 5 to the symbol i If i is undefined the debugger defines it Compare the value of symbol i to 0 If iis nonzero trace execution with the T command Subtract 1 from i and store the result back in i a fF CO N Terminate the while command Execution of this line sends the debugger back to the whilef test in line 2 Executing the above commands produces a while loop that executes the T command five times and then stops In the above example the symbol i represents a variable similar to those in such high level languages as C and BASIC Note that this symbol must not have the same name as a previously defined global or local variable 6 1 3 Local Symbols Local symbols are variables that are only valid inside the function i e automatic variables and function arguments and variables declared static The debugger automatically defines local symbols when it reads the debugging information In addition to their addresses local symbols have a scope and a type int char double etc 6 1 Data Expressions 126 ERR The debugger sets the predefined symbol ERR to 1 when the previously executed command resulted in an error and to O otherwise Use this symbol to add error processing to macros RUN The debugger sets the predefined symbol RUN to 1 when the user program is running and to O during a break
112. t gt gt gt ox18C 1 Zoom 4 Search 5 16 lt gt 10 B Inspect 7 Watch 8 View 9 Range 10 Change Figure 5 Inspect Window 1 3 Basic Operating Procedure Chapter 1 Overview 23 8 Add watch variable Add a variable to the Watch window 5 5 1 Code Window Shortcut Keys PICE MN101C00 Win File Edit Search View Run Inspect Window Options Help Sela opo o5 Bia e ES EN SAMPLE C Mm E EX Local if sec 1 6 sec 1 6 H void init_data int sec test tst1 1 EN Inspect 000000 BEE struct abc test 308008 tst1 1 tst2 6 int tst1 1 0x1 int tst2 6 6x6 void inc void if num lt 166 nun yelse num in 1 struct abc test 980888 tst1 1 tst2 6 2 int test tsti 1 0x1 PICE 1 1CA8 Ver 3 6 Release 5 1 1 Copyright c 1 Monitor Program Version 1 08 Evachip Number 101C01D 041BC 1 Zoom 4 Search 5 16 lt gt 10 6 Inspect 7 Watch 8 View 9 Range 10 Change Figure 6 Watch Window 9 Exit Exit C Source Code Debugger Win File Exit PICE MN101C00 win File Edit Search View Bun Inspect Window Options Help aer Ble 2 E if sec 1 6 sec 1 8 void init_data int x sec test tst1 1 EA Inspect 000000 struct abc test 488888 tst1 1 tst int tst1 1 0x1 int tst2 8 6x6 void inc void if num lt 1667 1000080 tst1 1 tst2 6 Monitor Program Version Evachip Number
113. t Notes 18 1 2 5 Breakpoints e Setting a software breakpoint to a byte other than an opcode replaces the operand with the PI code OxFF e Since a software breakpoint stops execution just before the instruction specified as the breakpoint you cannot specify a count e A hardware breakpoint stops after executing one or two instructions after the instruction specified as the breakpoint The exact number depends on the instruction sequence Since a ROM hardware breakpoint is based on the microcomputers ROM read address there are sometimes breaks at points other than the specified instruction e You cannot set breakpoints for the microcomputers Auto Transfer Control ATC operation e You cannot set RAM breakpoints for data sizes word and long e When a trace full breakpoint is in effect only forced breakpoints and software breakpoints are available e Setting a RAM area breakpoint in the stack area interferes with execution of the user program 1 2 6 Tracing e Using single step operation clears the contents of the trace memory e When a trace full breakpoint is in effect or the number of steps traced is less than 511 tracing sometimes does not show the first and last instructions executed e Tracing does not show the first instruction executed e You cannot trace the microcomputers Auto Transfer Control ATC operation e Youcannot disassemble the trace if the microcomputer is in STOP or HALT mode or if the
114. tala ORE PM LE 27 22 1 Read README WRI i eicere e sek Gee LI bes ees ek eek eode 27 2 2 2 Run Installation Program nier rre ttr rrt ree re REPRE EIER ee Ree nde 27 2 2 3 Windows V3 1 Installation iese se ee se ee ee eene ener 28 2 2 4 Windows 95 Installation esee GR AA ee enne enne ee GR ee ee 30 2 2 5 Specify Installation Directories nennen 32 CONTENTS 2 2 6 Copying DI RE in OE ees 33 2 2 7 Interrupting Installation EE etii REO RE DIEI HN 34 3 1 Set Up Environment with Pset101C ee e Ge ee ee ee nennen eren rennen 36 EED Doad PSetl01G RE ER AE EE RORRRR 37 3 2 Check dei ante reo P ded EE leia 43 3 2 1 Files Necessary for Loading oooooccoccnocnnoccoonconnconoconccn nono nonnnonn ee ee ee Se Se nennen rennes 43 3 22 Files Saved at Exat ete e E o uU OE RR EN a 44 3 2 3 Other FIles 2 nott iren ia 44 3 3 Create Environment Settings File rene rdiet dece d eei 45 3 4 Specify Starting Opos 46 3 4 1 Specifying Starting Options via Dialog BOX iese esse esse esse esee 46 3 4 2 Specifying Starting Options via Command Line eese 47 35 Load the Debug er nus EE ED EG POESIE eem 50 3 5 1 Debugger Loads Normally seen eene nre 50 3 3 2 Debugget Does Noto diu 51 CHAPTER 4 CREATING USER PROGRAM TO DEBUG 4 I Convertto ROM ettet A ep Oe Aaa ented 54 CHAPTER 5 WINDOW COMMANDS Screen Layout RE OE AE tr Utama EE ein
115. the Inspect window has the focus Key Contato Toggles the display format for array variables between decimal and hexadecimal Displays the currently selected variable in the Inspect window CTRL I e F7 Adds the currently selected variable to the Watch window W CTRL W F8 Displays the currently selected variable in the Command window s view V format CTRL V R selected variable C variable 5 15 Inspect Window Chapter 5 Window Commands 101 5 15 2 Inspect Window Local Menu Inspect F6 1 Ctrl l Watch F W Ctrlew The Inspect menu contains commands for controling the View F8 V Ctrity Inspect window Range F9 R Change F10 C Radix F5 Displays the currently selected variable in the Inspect window Adds the currently selected variable to the Watch window View Displays the currently selected variable in the Command window s view format Change Displays the dialog box for modifying the contents of the currently selected variable Range Displays the dialog box for specifying the display range for the currently selected variable Radix Toggles the display format for array variables between decimal and hexadecimal 5 15 3 Inspect Window Mouse Operations Double clicking the left mouse button on a variable displays the variable in the Inspect window 5 15 Inspect Window 102 5 16 Memo Window The Memo window is a simple editor This wi
116. the environment settings file PICEIOIC ENV in the working directory by editing the model specific definition file ENV101C TXT matching the target probe used 3 1 Set Up Environment with Pset101C Chapter 3 Using Debugger for First Time 39 For further details on the items to be specified interface board type VO port address CPU type bus size stack pointer after a reset and memory mode see Section 3 3 Creating Environment Settings File Specify starting options Specify the C Source Code Debugger Win starting options These options tell the debugger such things as the operating mode and memory configuration For further details see Section 3 4 Specify Starting Options ele Q _ Create a shortcut Teel Create a shortcut to the current C Source Code Debugger Win setup by double clicking the mouse on a group Double clicking the mouse on that icon then loads the debugger Registory icon x Icon name Wice1 Old PanaXSeries Accessories PanaxSeries Figure 19 Creating Shortcut Labeled WICE101C Save setup Save Save the edited setup in the project file The environment configuration program the icon labeled Pset101C then automatically reads in these settings the next time that you run it To modify the settings use the procedures in Modifying an Existing Environment below 3 1 Set Up Environment with Pset101C Upgrading from MS DOS Version Select working directory Select a
117. ting up the operating environment load C Source Code Debugger Win PICE MN101C00 Win CR File Edit Search View Bun Child Command Window Options Help ola oo ai Ee e E lalsd 2F090 a0 a SP ITE d0 d8 40 a8 UJ 1618 a8 416D POT NETS 166 a1 4CD0 dwt PETTE NT 4132 a8 d8 d a1 1 a6 1 a1 1 dv1 PICE 101000 Ver 3 6 Release 5 1 1 Copyright c 1 Monitor Program Version 1 66 Evachip Number 181C81D gt gt gt gt Figure 2 C Source Code Debugger Win Starting Screen 1 3 Basic Operating Procedure Chapter 1 Overview 21 4 Load user program Load the user program to be debugged Le L command File Load command 4f PICE MN101C00 Win lol File Edit Search View Run Child Command Window Options Help os leal al Ele 2 5 File name sample ex List files of type y Executable file EX y PICE 181C88 Uer 3 6 Release 5 1 1 Copyright c 1 Monitor Program Uersion 1 86 Evachip Number 101C01D gt gt gt gt 04188 1 Module 2 0ptWin 3 SrcSW 4 Search 5 Go 6 Inspct 7 Come B SalStp 9 Break 10 FncStp Figure 3 Loading Target Program 5 Set breakpoint Click the mouse on the line number in a Code window to set a breakpoint at the corresponding address E 5 5 3 Code Window Mouse Operations Child Break Add PICE MN101C00 Win G x File Edit Search View Run EChid Co
118. to 147 o Ed U comindnd seed sedes eed ee eren noo eros eani 81 82 150 UEND commarid 3 tete ent 150 Undo command uu eee ver nn Ebr v ree ERR 65 109 Until RetumlJcommand sesse esse ee ee Re ee 67 WPOP CoOmMMANG coincida 150 UPUSH command esse sesse sess 150 INDEX 166 User Customization vesci dr Ee diete Ge N ve 14 User Save od T2 User command iiu osea eratis atea 72 User command es ce eer itii n oda il 72 rod 72 Using Debugger for First Time ees 36 UX command cicer tea ROT s 150 V command A ee 81 82 150 VAT commando tete t eno Ee Move 82 151 IN dew cota d uu etr A 106 View ME ar tior i cr a e ER 66 Lo Ww W command nitenin esre A A as 81 150 WZ Command ici 150 WAIT command esse see seeks ee Rek ee RR ee Ee ee eek ee 151 Watch command sene 83 95 99 106 Watch wind OW AE aa a ee 98 Loca MENi diia aee ieii da 70 99 Mouse Operations ese see see ee ee AR a 99 Shortcut Keys eee eSI RR 98 WHRIEEt comma uir 152 WICE1O1 CHEP casi ia 45 INDEX WICETO CIN ita 44 48 Window Specific Mouse Operations iese sesse ese eke ee ee ee 78 Specific Shortcut KEY sesse se see ee Re Re Re ke 76 Window Bar Comimatid si esse e rt re er rero 66 Window Baise ao tear ed d 115 Window Commandis essere 59 Window menu esesseeeeeeeeeeee nennen enne enne enne 72 Windows 95 Installation 31
119. to the end of the specified file gt Suspends logging and closes the log file lt file name Takes Command window input from the specified file Use the ESC key to interrupt such batch processing Adds a comment line BEL Sounds the buzzer CLS Clears the Command window HOME Moves the Command window cursor to the home position LALL Enables display output during macro execution SALL Disables display output during macro execution LIST Enables Command window display output NLIST Disables Command window display output PRMPT lt character gt Changes the prompt to the specified character TIME Displays the current time in hh mm ss format WAIT Pause 7 2 Commands Grouped by Function 146 _ ERR__ The debugger sets this to 1 when the previously executed command resulted in an error and to O otherwise RUN The debugger sets this to 1 when the user program is running and to 0 during a break DEBINF Undefines all symbols macro name gt Defines a macro with the specified name DO WHILE expression Adds C like do while control statement to macro FOR Adds C like for control statement to macro WHILE lt expression gt Adds C like while control statement to macro REPEAT lt parameter gt Adds repeat loop to macro BREAK Breaks out of macro KILL lt macro name gt Deletes the specified macro MLIST lt macro name gt Lists macro s MLIST gt file name Writes all currently def
120. uch characters as input a A single quote inside the string terminates it causing the rest to be ignored Use its a numerical value e g 27 instead C Source Code Debugger Win provides access to register and flag contents through symbols consisting of an underscore _ plus the register or CPU flag name A DE etc The following registers and flags are available Register Names D0 D1 D2 D3 DWO DW1 A0 A1 SP HA PC PSW Flag Names C N V Z LIM gt while _DO _D1 Compare contents of DO and D1 registers T Trace execution command End of macro gt The above example executes the T trace command until the registers DO and D1 contain the same value Note that if a symbol has the same name as a CPU register the CPU register takes precedence 6 1 Data Expressions Chapter 6 Dialog Command Data 129 6 1 10 Arithmetic Expressions Arithmetic expressions combine numerical values symbols and registers with operators to yield a single value C Source Code Debugger Win supports C like numerical values and logical operators Arithmetic expressions may be used anywhere that a command calls for data or an address The following is a list of the unary and binary operators available for arithmetic expressions 16 bit data at the specified address pointer to word LN Unary operators division left shift gt gt lt lt comparison operator 1 when the right operand is gre
121. variable on and off 5 12 Watch Window Chapter 5 Window Commands 95 5 13 Break Window The Break window displays the currently registered breakpoints max 16 n Break IDE x Figure 44 Break Window The Break window provides the following shortcut keys for executing commands These shortcut keys apply when the Break window has the focus Displays the dialog box for setting up a hardware breakpoint Rc 5 21 18 Hardware Breakpoint Dialog Box Displays the dialog box for setting up a software breakpoint un 5 21 19 Set Software Breakpoint Dialog Box Clears the currently selected breakpoint Toggles the currently selected breakpoint between enabled and disabled Y 5 13 Break Window 96 5 13 2 Break Window Local Menu Child Break Add Ins The Child Break menu contains Disable FA Er f Clear Del commands for controling the Break window Clear All F3 Save Setting F4 Load Setting F6 Hardware breakpoint FU Area breakpoint Area events External breakpoint Add Displays the dialog box for setting up a software breakpoint ge 5 21 19 Set Software Breakpoint Dialog Box Disable Enable Toggles the currently selected breakpoint between enabled and disabled Hardware breakpoint Displays the dialog box for setting up a hardware breakpoint RS 5 21 18 Hardware Breakpoint Dialog Box Displays the dialog box for setting
122. ve Cannot create file Either the disk is full or there are too many files open Try closing unnecessary files Operators with side effects not allowed The command does not allow the use of operators with side effects etc If you are willing to accept side effects use the VAL command instead 8 3 Error Messages Chapter 8 Appendices 155 Cannot set breakpoint max 16 There are too many software breakpoints either alone or in combination with hardware breakpoints The limit is 16 Verify error A write to memory failed This message indicates an attempt to write to memory that is not physically present Cannot find HELP file PT101C HLP file cannot be found Load PT101C HLP file in the current directory or the directory specified with environment variable HELP Microcomputer out of control The user program has run out of control while executing Check stack usage interrupt service routines etc Other possible causes include problems with the power supply oscillator and cable connections Try resetting the device Macro nesting limit exceeded max 15 C Source Code Debugger Win only supports macro nesting up to 15 levels deep Missing in macro definition The braces in a macro definition do not match Cannot delete macro inside macro Delete the macro definition at the C Source Code Debugger Win command level Macros cannot delete other macros Cannot define macro insid
123. w Shortcut Keys iese esse ee ee Re ee GR ee GR Re ee GR Re ee ee ee 81 5 6 2 Command Window Local MENU ees se ee se Re ER Re ee ER Re ee Ge ee ee GR Re ee ee ee 83 3 7 Memory WindOW sii te oe GE REESE SEINE REUS ERE ERU E FERE ERE taut 84 5 7 1 Memory Window Shortcut Keys ese se se se GR Ge ee ee Ge ee ee Ge Se Ge Re ee 84 5 7 2 Memory Window Local Menu es se ee GR ee ee GR RA ee GR AA ee RA ee ee Ge ee 85 5 7 3 Memory Window Mouse Operations se see se ee ee ee ee nennen 85 5 8 Register Window sic ie EO pet EE RE EN AE ED 86 5 8 1 Register Window Shortcut Keys esse ese se ee ee ee ee ee nennen nennen 86 5 8 2 Register Window Local Menu esse esse es se ee ee ee ee ee ee ee RA ee ee 87 5 8 3 Register Window Mouse Operations esse se ee ee ee ee Ge ee ee ee ee Ge ee 87 39 Stack Wind Wi aee mannm nta 88 5 9 1 Stack Window Shortcut KeYS sesse esse ese ee ee ee ee ee ee ee ee ee ee ee 88 5 9 2 Stack Window Local Menu ee Re RA GR enne enne enne enne 88 3 10 Local WihdOW 0 due Mt ccs 89 5 10 1 Local Window Shortcut Keys esse esse ee se ee ee GR ee ee GR ee enne 89 5 10 2 Local Window Local MENU se ee se ee RR GR AR Re ee ER Re ee ee ee ee Re ee ee ee 90 5 10 3 Local Window Mouse OperaHOnS esse sesse esse ee se ee ee GR ee GR RA ee GR ge ee ee ee 90 5 11 BackTrace Wide E ees 91 5 11 1 BackTrace Window Shortcut Keys
124. x Displays the dialog box for entering the search text and the search direction for the window that currently has the focus RS 5 21 5 Find String Dialog Box B Searches in the specified direction starting at the current cursor position in the window that currently has the focus for the specified text e Displays the dialog box for selecting a source code module for the loaded user program for display in a Code window RS 5 21 8 Module Dialog Box 5 18 Tool Bar i 00 0 Restores window layout 1 Restores window layout 2 Restores window layout 3 Arranges all windows not reduced to icons so that they overlap Arranges all windows not reduced to icons so that they divide up the display area C Source Code Debugger Win picks the positions Inserts the text from the Clipboard at the current cursor position in the window that currently has the focus Copies the currently selected text in the window that currently has the focus to the Clipboard Displays the dialog box for modifying the button layout on the tool bar Re 5 21 3 Tool Bar Dialog Box e bk E Hb El E Adjusts the sizes of all child windows to the size of the Main window Toggles the Code window display format between assembly language and hexadecimal dump 7 Displays C Source Code Debugger Win help Exits C Source Code Debugger Win 5 18 Tool Bar Chapter 5 Window Commands 109 5 19 Window Bar Thi
125. y keyword Help on help Displays a help file for the Windows help system About C Source Code Displays a brief screen describing C Source Code Debugger Debugger Win 5 2 Menus Chapter 5 Window Commands 71 5 3 Shortcut Keys Shortcut keys are key combinations defined for the most frequently run C Source Code Debugger Win commands 5 3 1 Shortcut Keys Available in All Windows The following shortcut keys are common to all windows Key Combination Duplicates the action of the lt Maximize gt lt Restore gt button switching the window that currently has the focus between its maximum and original sizes Note that the Code and Command windows use this key for different commands F2 Sends the active window to the rear and makes the next window CTRL O active CTRL B Makes the previous window active Reverse of F2 and Ctrl O F4 Displays the dialog box for entering the search text and the search CTRL Q F direction for the window that currently has the focus R 5 21 5 Find String Dialog Box Runs the user program from the current program counter PC position F Single steps execution of the user program F10 Function steps through the user program CTRL C Scrolls the screen upward by one screen Page Down CTRL D Moves the cursor one character position to the right CTRL E Moves the cursor one line upward CTRL L Searches in the specified direction starting at the current cursor position in the
126. y loaded program Resets the evaluation chip Runs the user program from the current program counter PC position Single steps execution in source line units or machine language instruction units Function steps execution in source line units or machine language instruction units Executes the user program until the current function returns to its caller Forcefully terminates execution of the user program returning control to C Source Code Es E a El i El 0 Debugger Win Interrupts execution of a repeated command or macro Adds the currently selected variable to the Watch window If the text at the current cursor position is not a variable that can be watched the Add to Watch dialog box appears instead m3 5 21 7 Set Watch data Dialog Box Displays the currently selected variable in the Inspect window If the text at the current cursor position is not a variable that can be inspected the Add to Inspect dialog box appears instead R 5 21 6 Set Inspect data Dialog Box Alternately enables and disables the display of button hints that appear on the status line when the mouse cursor passes over buttons Switches the tool bar display position Displays the dialog box for changing the background and text colors for windows RS 5 21 4 Color Dialog Box Displays the dialog box for changing the font font style and font size for text in the window that currently has the focus Re 5 21 2 Font Dialog Bo
127. yed If a watch address is within the sampling area specified with the SM command the window displays the corresponding variable in real time while the program is executing lb omp X02E12 i The Watch window provides the following shortcut keys for executing commands These shortcut keys apply when the Watch window has the focus Key Combination Clears the Watch window of all variables F6 Displays the currently selected variable in the Inspect window CTRL I CTRL W or minus sign on the left of their names on and off INS 5 12 Watch Window 5 12 2 Watch Window Local Menu inia The Child Watch menu contains commands for controling Inspect F6 Ctrl l Watch F7 Ctr ew the Watch window Element Add Ins Clear Del All Clear F3 Displays the currently selected variable in the Inspect window Adds the currently selected variable to the Watch window Element Toggles the display of contents of the local variables with elements array members structure members etc on and off Add Displays the dialog box for adding variables to the Watch window C Deletes the currently selected variable from the Watch window All Clear Clears the Watch window of all variables 5 12 3 Watch Window Mouse Operations Double clicking the left mouse button on a variable marked with a plus or minus sign toggles the display of elements array members structure members etc for that

MN101C00 Series C Source Code Debugger for WindowsR

Contents

Download Pdf Manuals

Related Search

Related Contents