资 源 简 介
This manual describes how to configure, start and operate the WGDB7 Windows Debugger, to debug programs written for the ST7 family of microcontrollers, in any of these developmentand test environments:• Program debugging with ST7 emulators,• Program debugging with ST7 simulators,• Program debugging with ST7 development kits.WGDB7 communicates with the user via the standard Windows Graphical User Interface.It is based on the GNU Debugger (GDB) command set, and uses additional ST7-specific commands. Consequently, the manual discusses also basic GDB commands.1 INTRODUCTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51.1 AN ST7-FAMILY DEBUGGING TOOL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51.2 EMULATORS, SIMULATORS, DEVELOPMENT KITS . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51.3 WGDB7 MAIN FEATURES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71.3.1 Displaying Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71.3.2 Entering Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71.3.3 Workspaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81.3.4 Using GDB Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81.3.5 WGDB7 Debugging Capabilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82 INSTALLING WGDB7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112.1 HARDWARE AND SOFTWARE REQUIREMENTS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112.2 COMPATIBILITY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112.3 BASIC INSTALLATION PROCEDURE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112.4 INSTALLING WGDB7 IN THE WINDOWS NT ENVIRONMENT: COMPLETING THE INSTALLATION122.5 POWERING UP THE EMULATOR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122.5.1 Connecting the Emulator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122.5.2 Running the Hardware Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122.5.3 Connection Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132.6 POWERING UP THE DEVELOPMENT KIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142.6.1 Connecting the Development Kit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142.6.2 Running the Hardware Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153 PREPARING PROGRAMS FOR DEBUGGING . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174 OPERATING WGDB7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184.1 INTRODUCTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184.2 STARTING WGDB7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184.3 GETTING HELP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194.4 EMULATOR/SIMULATOR CONFIGURATION OPTIONS . . . . . . . . . . . . . . . . . . . . . . . . . 204.4.1 Choosing the Emulated/Simulated ST7 Microcontroller . . . . . . . . . . . . . . . . . . . . . . 204.4.2 Changing the Emulated/Simulated ST7 Memory Mapping . . . . . . . . . . . . . . . . . . . 214.4.3 Viewing and Setting Additional Emulator Configuration Options . . . . . . . . . . . . . . . 244.5 VIEWING ST7 RESOURCES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264.5.1 Viewing ST7 Memory Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264.5.2 Viewing Disassembled Program Code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274.5.3 Viewing Register Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284.6 LOADING A PROGRAM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294.7 VIEWING PROGRAM INFORMATION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304.7.1 Viewing a Source Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304.7.2 Finding and Viewing Symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324.7.3 Watching Variable or Expression Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334.8 EXECUTING LOADED PROGRAMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354.9 USING SOFTWARE BREAKPOINTS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364.9.1 Setting Software Breakpoints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364.9.2 Managing Software Breakpoints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364.10 USING HARDWARE BREAKPOINTS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374.10.1Hardware and Advanced Breakpoints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374.10.2Setting Hardware Breakpoints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 384.10.3Setting Advanced Breakpoints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404.10.4Managing Hardware Breakpoints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 424.11WORKING WITH OUTPUT TRIGGERS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 434.11.1Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 434.11.2Setting Trigger Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 444.11.3Setting the TRIGOUT Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464.11.4Managing Trigger Event Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 484.12WORKING WITH THE TRACE BUFFER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 484.12.1Viewing Trace Buffer Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 494.13MANAGING TRACE BUFFER RECORDING USING THE LOGIC ANALYSER . . . . . . . . 504.14 PIN INPUT/OUTPUT SIMULATION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 534.14.1The Input-Process-Output Scheme . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 534.14.2How to Setup Pin Input Simulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 544.14.3Starting Pin Input Simulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 584.14.4Pin Output Signals Generated by your Program . . . . . . . . . . . . . . . . . . . . . . . . . . . 594.14.5Viewing Pin Output Generated by your Program . . . . . . . . . . . . . . . . . . . . . . . . . . . 594.15 TIME MANAGEMENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 605 CUSTOMISING WGDB7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 625.1 CHANGING THE COLOUR SETTINGS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 625.2 SELECTING WHICH EVENTS ARE INDICATED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 636 WORKING WITH WORKSPACES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 646.1 SAVING AND LOADING WORKSPACE DEFINITIONS . . . . . . . . . . . . . . . . . . . . . . . . . . 656.2 ENABLING/DISABLING AUTOMATIC DEFAULT WORKSPACE SAVING . . . . . . . . . . . 657 USING GDB7 COMMANDS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 667.1 EXECUTING GDB7 COMMANDS WHEN A PROGRAM IS LOADED . . . . . . . . . . . . . . . 667.2 EXECUTING GDB7 COMMAND BATCH FILES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 667.3 ENTERING GDB7 COMMANDS USING YOUR KEYBOARD . . . . . . . . . . . . . . . . . . . . . . 677.4 VIEWING GDB7 DIALOG EXECUTED BY WGDB7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 687.5 RECORDING GDB7 COMMANDS IN A LOG FILE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 688 QUESTIONS AND ANSWERS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 698.1 WHAT DOES THE HOUR GLASS CURSOR MEAN? . . . . . . . . . . . . . . . . . . . . . . . . . . . . 698.2 WHY IS THE LOCALS WINDOW EMPTY? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 698.3 HOW DO I SPECIFY THE LOCATION OF SOURCE FILES? . . . . . . . . . . . . . . . . . . . . . . 698.4 HOW CAN I MODIFY A HARDWARE BREAKPOINT? . . . . . . . . . . . . . . . . . . . . . . . . . . . 698.5 WHY ARE SOME SOFTWARE BREAKPOINTS NEVER TRIGGERED? . . . . . . . . . . . . . 698.6 WHY ARE SOME HARDWARE BREAKPOINTS NEVER TRIGGERED? . . . . . . . . . . . . . 708.7 WHAT DOES “STOP AT USER REQUEST” MEAN? . . . . . . . . . . . . . . . . . . . . . . . . . . . . 708.8 HOW DO I EXECUTE WGDB7 FROM WINEDIT? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
