Home

TRACE 32 - Lauterbach

1. Trae L i Lj rik 1 1 1 4 1 1 A 1 1 B 1 B B 1 1 4 A 1 B ees Tutorial for TRACE32 ICD 40 In most windows a context sensitive menu can be used with the right mouse button If you select a variable you get access to the Var pulldown menu that provides all features for displaying and modifying variables You want to inspect a variable and you are not sure about the spelling open the symbol browser to display all symbols stored in the internal symbol database dow Help he i Ynbol Browse ok name F 00081218 AdiabpS diab If you want to modify a variable value double click to the value The appropriate Var set command will be displayed in the command line Enter the new value and confirm with return diabpS diabpS ast word x left Samet right AxA Fieldi 1 Field2 2 Y 4 C diabpS diabpS ast count C lt diabpS diabpS ast count 12345 ok formats E Lo e 41 Tutorial for TRACE32 ICD Format HLL Variables To adapt the display of a variable to your needs select the variable name press the right mouse and select Format from the Var pulldown menu zY am WdiabpotdiabpStast unord AxA Add to Watch Window Yew in Window radix format i Modify Value T Decimal l Compact T String Display Memory d p T Hex Fixed y mbol Breakpoints Go Till j T BiNary TREE M POUMP ree Ascii Multiline Rec
2. Write access right on system directory Disk full Existing read only file Software crashes or stops after booting is finished Boot image file maybe destroyed remove all bootOx t82 files Connection of modules o k connector bend Quick Installation for TRACE32 ICD 34 Software doesn t work stable Boot image file maybe destroyed remove all boot0Ox t82 files Connection of modules o k connector bend Check connection of Fibre Optic Ethernet or Parallel interface On Ethernet try with smaller packet size and or handshake Emulation system doesn t work correctly Check Emulation Probe Manual in Targets part of the manual Parallel Port not working stable Check that the port is on the correct mode Choose either EPP 1 9 or compatible mode The mode selection can usually be done in the BIOS setup can be activated during booting 35 Quick Installation for TRACE32 ICD Tutorial for TRACE32 ICD About the Tutorial What is it about This is a tutorial for all In Circuit Debuggers TRACE32 ICD that are implemented using their onchip debug interface Typical examples for onchip debug interfaces are BDM JTAG ONCE Preconditions The tutorial assumes that the development system is already installed You should have basic knowledge of the C programming language in order to be able to follow the example code found in this tutorial In addition working with WINDOWS is assumed as known Also some knowledge of the
3. diabpo diabpo sieves ro a TPA pi imz i i 3 n 626 k i primz 629 while k lt SIZE t flags k FALSE aa Fa k primz address tupes C BBAILE P Onchip diabpS diabpS sievet F H Breakpoint type Breakpoint is set as Program breakpoint onchip breakpoint When the number of available onchip breakpoints is exceeded the following error message is displayed no such hardware breakpoint available emate Data War tagger devices P 00081230 diabpS diabposieve 8e 35 Tutorial for TRACE32 ICD Breakpoints on Data Accesses For most CPUs the provided onchip breakpoints can also be used by TRACE32 ICD to stop the program execution when a read or write access occurs to a specific address location For information on the available onchip breakpoints for your CPU refer to the Onchip Breakpoint Overview To stop the program execution on a read access to a variable select the variable with the cursor press the write mouse button and select Read from the Breakpoint pulldown 1 I 1 addr line source a O20 i GE Add to Watch window view in Window pas Modify Value 629 Display Memory Breakpoints j Program Go Till All 632 ather Spot e Bead a 634 anzah1 write H Alpha h Beta Charly 636 return anzahl Delta Zal 639 4 a address tupes C BAREGC468 BHBEC4 A R Onchip WdiabpS diabp5 f lags a 4 S H 4
4. xset ip homes i327 fontus xset fp rehash Verify that you have write permission to the system directory and the boot t82 file and prepare the configuration file cd home t32 Vi CONE LO eo 2 LINK NET NODE t 32 29 Quick Installation for TRACE32 ICD Copy the executable file to a directory in the PATH or include it in the PATH variable ep E32 de jusr bin Preparations for the Ethernet Interface Before installation a new node must be created The Ethernet address of the system is placed on the bottom side of the system The following line must be added to the file etc hosts LIZ s Je 200s t32 Note that the INTERNET address given here is an example only Contact your network administrator for a new INTERNET address for TRACE32 The Ethernet address of the system must be entered in the file etc ethers reti sar Usos E32 The INTERNET address is requested by a RARP protocol by TRACE32 If no RARP server is running the address for the first connect must be set in the host table After the first successful connect the INTERNET address is stored in nonvolatile memory within TRACE32 The following command sets the host translation table arp eo T32 O37CcO lt Sar02 020 This command must be executed immediately before the first startup of the emulator It is not required for future startups because the INTERNET address is stored in the emulator The arp cache table should be checked just before the first startup with
5. Tutorial for TRACE32 ICD Most features can alternatively be selected from a pulldown menu from a button in the main tool bar or from the command line Please remember this even if we use just one way in the following chapters The TRACE32 commands are not case sensitive In the TRACE32 books we use upper case letters for the characters that are significant for the command entry E g Register view can be shortened by r Another example which shows the typical TRACE32 command structure lt command family gt lt subcommand gt IS Data List that can be shortened to d 1 A good hint is to look at the soft keys They provide a guided command entry All possible commands and parameters are displayed Instead of writing to the command line you can assemble the correct command by clicking on the soft keys Example Assembly of the Data dump command by using the softkeys ok WEN Prit Pririt P OU0811B8 diabpodiabpo sieve 4 p DATA DUMP ok ANARA Coe options P OO080004 diabpS Globalh_ start P Data DUMP 1808 2808 ok ophons P OU0811B8 diabpo diabpo sieve 4 More detailed information about the TRACE32 user interface can be found in the Operating System User s Guide In the window header the TRACE32 command that was executed to open the window is displayed _ T 81196 RE H R16 BFFFFFFFF R24 DFFFFFFF t1 8FF68 R9 BFFFFFFFF Ei BFEFFFFFF R25 FFFFFFFF ne OCH H R16 JHHBKH R18 OBFFFFFF
6. fa a D Piinia Vto memdtvetae OO O O O O a When the TRACE32 debugger software is started a command window is displayed that contains the main menu bar the main tool bar and the command line All windows which display debugger information are placed freely on the screen MWI e Select remote control access not active The installation program generates a TRACE32 folder where you can start the debugger software and the Online Help from If you prefer to start the program by clicking on an icon on the desktop use the Explorer search for the startfile T32M lt CPU gt EXE e g t32m68 exe for the CPU32 from Motorola and pull it onto your desktop 23 Quick Installation for TRACE32 ICD The Configuration File for PODPC on MS WINDOWS The configuration file is used to make some basic settings for the cooperation between TRACE32 ICD and the host system The entries are automatically made by the installation program By default the software assumes that the configuration file is in the system directory and is named config t32 Refer to Setup the Application Properties in Tutorial for TRACE32 ICD if you want to change the name or location of the configuration file Standard settings in the configuration file Environment variables OS TD T 32 TMP C temp temp directory for TRACE32 SYS d t32 isa system directory for TRACE32 Printer settings PRINTER WINDOWS all standard windows printer can be sused from the TR
7. 8 set the transfer clock from the debug interface to your target By default TRACE32 ICD uses a fixed clock to run the debug interface A clock range from 100KHz up to 5 MHz can be used Command SyStem BdmClock We also provide a clock cable to allow you the use of the divided CPU clock as clock for the debug interface The relation between the CPU clock and the debug interface clock is specific for your CPU Refer to your ICD Target Manual for detailed information The use of the divided CPU clock has the following advantages e The max speed for the debug interface can be used However we recom mend 10MHz as the max speed e The clock for the debug interface is automatically adapted if the CPU clock is changed by your application program Enter the debug mode Select the Up button in the Mode field to restart the CPU with debug mode enable Command SYStem Up The user interface establishes the communication to the target s microprocessor After this command you should be able to access the registers Do the target specific settings The CPU is active now and you can initialize the CPU by writing to the special function registers using the Data Set command E g some CPU need to set the chip selects in order to access memory 9 Tutorial for TRACE32 ICD 4 Load your application Load your application by using the command Data LOAD lt option gt lt file_name gt The option required for your compiler can be fo
8. A simulator can run without a target processor The work of the CPU is simulated by software So real time debugging is not possible You can download our simulators from our web page http www lauterbach com or from our CD TRACE32 Product Information by using the link Download Demo Software inthe main menu 3 TRACE32 ICD Preface Where to Look for More Information The common TRACE32 user interface contains a detailed Online Help that offers the most current description of all debug features If you have installed the TRACE32 software The Online Help on how to start the Online Help The Online Help can also be called without installing the TRACE32 software e On WINDOWS systems simply call the help file DOS MAN HLP on the CD e Or use the PDF file TRACE32 MANUAL PDF in the PDF directory of the CD to open the Online help in PDF format The following books contain the most relevant information for the use of TRACE32 ICD ICD Targets Hiao ALE AS Urime Help Inhab indes Suchan Kirie Sie sul ain Burk und dann au Olen Orie Eicken Sie aul ere Fei Aeris IST EDH Ta FA be Diy PT Lit SH Le Since the Quick Installation for TRACE32 ICD and the Tutorial for TRACE32 ICD are generic for all supported CPUs we strongly recommand to read the ICD Target Guide for your CPU This guide describes all CPU specific settings and features ICD Debugger User s Guide This book provides information about the
9. Debug Module poppus rw o O oat ON ais connector to host interface Li sys PODBUS OUT connector for additional devices optional jp Bee eee th some processor types like MPC 740 750 PPC608 require a Power Debug Module But there is no difference in using this module POWER Power is applied to the debug module Power will be supplied via the PODBUS Therefore power is on when the host interface is on SELECT Optionally It is possible to connect more than one device to the PODBUS Each device can be independently controlled by the debugger software The LED is on when this device is currently controlled EMULATE The user program is running on the target 11 Quick Installation for TRACE32 ICD Hardware Installation Choose one of the following installations depending on your host interface e ISA Interface Card PODPC e Parallel Interface Card PODPAR e Ethernet Interface PODETH Installation with ISA Interface Card PODPC Optional wire for CPU clock ISA card A Do not connect or disconnect anything while power is on Quick Installation for TRACE32 ICD 12 To configure your TRACE382 ICD with the PODPC interface card 1 Install the ISA card PODPC on your PC Insert the ISA card PODPC in a free ISA slot of your PC The default I O address of the ISA interface card is set to 350h If this address is already in use it can be changed by setting the jumpers on the c
10. Ethernet address of the system must be entered in the file ETHERS Os C0 oa202020 C32 The INTERNET address is requested by a RARP protocol by TRACE32 ICD If no RARP server is running the address for the first connect must be set in the host table After the first successful connect the INTERNET address is stored in nonvolatile memory within TRACE32 ICD The following command sets the host translation table aro o Toa O CU sa 0 UHC NOTE Windows95 has a bug that may cause the arp command to fail when the arp cache is empty In this case ping another host before executing the arp command this will fill the arp cache Quick Installation for TRACE32 ICD 28 PODETH on SunOS Solaris SUN Installation of the TRACE 32 Debugger Software In the following example the directory home t32 is used as the system directory The system directory is created with the following command mkdir home t32 od similar The files are extracted from the CD to the system directory with the following commands mount F hsfs o ro dev dsk c0t6d0s2 cdrom trace32 or similar cd home t32 mkdir suns Co ar cdrom traces2 unix ep r J Cdrom trace32 bin ysuns lt my suns Config 32 chmod R usw In the login script cshrc in the home directory for the C shell the following lines must be added setenv T32SYS home t32 setenv T32TMP tmp setenv T32ID T32 Prepare and install the fonts cd home t32 fonts MKPOntdat lt
11. OFFAL Rid OFFAC R26 WFFFFFBFF R28 18 BRBESHSA Ro af Rig J43506 R21 BFFFFFFDF R29 1E 14 BBB8C438 RG C358 R14 BFFFFFBFF R22 BFFFFFFFF RS 13 18 AHAAAHAH Rf 156 R15 H R23 BFFFFFFFF R31 5 iC SHRBABAE A aoo r 4 H z P B Register SPOTLIGHT F 00081068 diabpS diabpS main OF 4 stopped RE AFFFFFFFF ACFFFFFFF SP gt Q8FF68 1 R9 SA AAAAAAA Ri GFEFFFFFF R25 FFFFFFFF 84 81 B4 2 BCA7A R10 A R18 FFFFFFF7 R26 FFFFFFFF 08 AAAAAAAF J R11 90288 R19 FFZFFFFF R27 FFBFFBFF 0C AAAAAAAA 4 SFFAC R12 SFFAC R20 G FFFFFBFF R29 7 18 99803030 5 37 R13 94388 R21 FFFFFFDF R29 1B 14 AAABC4AZS amp 8C350 R14 GFFFFFBFF R22 FFFFFFFF R30 13 18 AAAAAAAA 7 156 R15 A R23 FFFFFFFF R31 PS iC SAAAAAAA 20 BARSFFSA F H Tutorial for TRACE32 ICD 26 How to Display and Modify the Special Function Registers Open the Peripherals window to display your CPUs special function register TRACES2 ss 32 ei EEN Edt HETE var Break Hun CPU C3 w Registers Dump Source List Watch Locals Stack Symbols l Analyzer Ligt EE oe Area PER view ok Pe VIEW P 00081220 diabpS diat i af B PER view BABAR FRZ normal DLE unlocked PAR THUR HRRABE EMAP BACH4BH48H LEH enable IEH aa errilate Data trigge tagge D 5007FC20 15 15 l Bus Memor Enable If you select the register contents the address bit position and complete name of
12. PBHSHHHS 75 6 code Geak ERMA CPU Devices Trigge L Step Over Fs TRACE 32 File Edit View War Break Aun a pjm Go Next Go Retur lo Up Go Till Go ernulate Data Break PSOO0S0004 diabpo Globals P STEP Remember Mostly there are many possibilities to get the same result Here you can alternatively use the pulldown menu the accelerator F2 the speed bar or the command line Tutorial for TRACE32 ICD 16 Now have a look at the state line The address of the current cursor position blue bar in active window is displayed there The next field displays the state of the debugger stopped means your application program is stopped You can now for example inspect or change memory The debug mode MIX is selected will be explained next TRACE 32 Miel gt Fille Edt View War Break Aun CPU Devices Trigger Analyzer Per Coy Window Help jaj lele mim i 2i S B Data_List addr line code label nnenonic comment P ABR 7FFFC 93939393 stu r 26 6C6D ri9 r26 27757 r19 F AABAA JAAAAAAL li ri rl P BABGHBAA JDEHHHHIJ start rii 9 11 9 382 BHHHH nr ri ril PAASHAAC HDANHAAI lis ri3 3 HBBSHHIE S9ADASHS addi ri3 r13 4308 BAASHALF HC400AHI lis r29 rag PHHSAALE 354208 7H subi rZ rz 3 94 Prg 16272 P13 9 ABRSARIC H8BAAAAAL li ra r 13 r13 17168 HBBSHHZ SABIE CH Stuu r 44 r1 P4 64 r1 HAABA 1800125 bl 61256 __Init_main PHHSA
13. When using the RS232 interface Is a login process active on the tty Program stops with message font xxxx not found Do fonts appear in the xlsfonts command Can one font e g t32 lsys 16 be displayed by xfd fn t32 lsys 16 Fonts added to X Windows FONT PATH Fonts converted when required and bdf files removed Command to generate font directory executed with correct parameters Fonts installed on the X Windows server not client If using an X Terminal use the conversion programs for the X Terminal Executable program displays boot t32 not found Access rights to directory 0 k Read and write access to boot t82 write required on UNIX without NOLOCK Configuration file contents o k Environment variable T32SYS correctly set Executable program stops after displaying error reading boot t32 When transferring between different OS systems files copied in binary mode Access rights granted Try again after switching off the TRACE32 system Executable program stops after displaying booting or finished When transferring between different OS systems files copied in binary mode Packet size set correctly on Ethernet handshake set when required Bootloader stops with message fatal error When transferring between different OS systems files copied in binary mode Mixing different versions of the software e g MCC 1T32 and MCCxxx t382 Bootloader displays cannot save image
14. option LOCAL the local variables of each function are displayed When the option CALLER is set a few lines from the C code are displayed to indicate where the function was Called TRACE 32 File Edit BEE Var Break Bun ie lt lt Registers af Coy Window Help Dump a Al aal ae 5 e fe mA E A ee Watch Locals Peripherals Symbols ata aE LOCALS CALLER ok options P 00081244 WdiabpSdiabpS sieve 90 z B Data List Of x addr line source int sievet sieve of erathostene Analyzer List Message Area register int i primz kK B Yar Frame l c end of frame _start asm maint p HxBADBAIBDA while TRUE i sieve BAZ init_maintasm b AAI maint p Ax8C3z4 while TRUE gieve j AAA sieve i i primz 5 k 11 anzahl 1 Y as ls 23 Tutorial for TRACE32 ICD TRACE32 ICD provides also more complex debug control commands You can run or step until an expression changes or becomes true Example Var Step Till j gt 9 single steps the program until the variable j becomes greater than 9 More detailed information can be found in the Reference book at the description of the commands Step Change Step Till Go Change Go Till Var Step Change Var Step Till Var Go Change and Var Go Till Tutorial for TRACE32 ICD 24 How to Display and Modify CPU Registers We want to inspect the CPU registers now TRACE
15. or PODPAR on MS WINDOWS PC 2 Connect the power supply to the PODBUS printer port interface Plug 7 9V inner negative outer positive Please use only the enclosed AC DC adapter 3 Connect the Debug Module via the PODBUS connector to the PODPAR box 4 Connect the Debug Module to the target by the debug cable A list of the supported processors and the pinout of the dedicated debug interface connector BDM JTAG OCDS COP ONCE can be found in the ICD Target Guide for your CPU family Quick Installation for TRACE32 ICD 16 Connect the clock cable optional By default TRACE32 ICD uses a fixed clock to run the debug interface A clock range from 100KHz up to 5 MHz can be used We also provide a clock cable to allow you the use of the divided CPU clock as clock for the debug interface The relation between the CPU clock and the debug interface clock is specific for your CPU Refer to your ICD Target Guide for detailed information The use of the divided CPU clock has the following advantages e The max speed for the debug interface can be used However we recom mend 10MHz as the max speed e The clock for the debug interface is automatically adapted if the CPU clock is changed by your application program The setting for the debug clock are done during the Setup of the Debug Environment 17 Quick Installation for TRACE32 ICD Installation with Ethernet Interface PODETH debug port cable option
16. or mixed level e SETUP IMASKHLL ON to disable the interrupts during single stepping on HLL level 19 Tutorial for TRACE32 ICD Local buttons for the Data List window B Data List OLX step Step Over Gonet GoPeum GoUp Go Break Mode addr line code label mnemonic comment flags k FALSE a P 9989122 SDEHHHH9 lis riz i r12 9 398CC468 subi riz riz 3898 Pi2 ri2 15256 F 00081234 J96AHAAL li rii rii P 0A081238 7 D6CESAE stbx rii riz rz9 riil ri k 632 P AA8123C 7FBDF214 add P BBABA ABFFFFE4 b 41224 t 034 anzahl P BHABI ORICAAHI addi r28 rz8 1 P BAH61246 SEFF ARAL addi rai rsisi P 86881240 ABFFFF ES b G11FC h t 636 return anzahl P AHB81258 38 7ZCAHAH mr r3 r28 639 P AAH61254 3518088 luz r28 8 ri P BAB612568 B3JATUHAALC luz r29 Cir 4 k primz r29 rz9 r3 Li L Default CENE Spotpoint Set PC Here Ppl Display Memory i Breakpoints Go Till Edit Source eh here fay lll Here Assemble here Modify here J J r gt select a code line and press the right mouse button When you select Go Till Here the program execution is started and then stops when the program reaches the selected code line Tutorial for TRACE32 ICD 20 Single Stepping is one of the basic debugging commands Look at the Run pulldown menu at the local buttons of the Data List window or at the main tool bar for the other debug com
17. printer port interface PODPAR 5 Quick Installation for TRACE32 ICD PC or Ethernet Twisted Pair Workstation cite N aH a O mr FE o 44 o G FE Fx trigger PODBUS in out UE E AC DC adapter System configuration with ethernet interface PODETH Quick Installation for TRACE32 ICD 6 PODPC Interface Card for ISA bus PODBUS _ BNC connector awe trigger in out When a PODPC interface card is used no additional power supply is required for additional PODBUS devices Address select jumpers on the ISA card JP3 must always be on The BNC connector is used to input output a trigger signal to from the Debug Module For more information on this Trigger feature refer to Trigger in the ICD Users Guide 7 Quick Installation for TRACE32 ICD PODPAR Converter for Printer Port LPTx F ei a oe is ee sona THL ny FRE a gt a tp ee a I saath tif at E M o e External power supply is required for the PODPAR Plug 7 9V inner negative outer positive Please use only the enclosed AC DC Adapter The BNC connector is used to input output a trigger signal to from the Debug Module For more information on this Trigger feature refer to Trigger in the ICD Users Guide Quick Installation for TRACE32 ICD 8 PODETH Converter to Ethernet Twisted Pair eae ee oe roa e ee ea a ee ee tre ee ee ee ee pa OTa kor 5 TU err ee JE z x a T DEDI a n e one e ia 5 ea
18. quick access ee ern to the settings and additional features for your CPU ILD User Manual About TRACE 32 Look at the Reference book for a detailed description of all generic commands 7 Tutorial for TRACE32 ICD A typical start up procedure consists of 1 The CPU specific settings The SYStem Window provides all CPU specific settings Use System Settings in the CPU menu to open this window B 57Stem OF x Mode BdmtClock C Down C Option M CFLUSH Option M WATCHDOG C NoDebug 3 M ICREAD SCRATCH C Go co 4 M DCREAD OFFFFFOOO Attach os T NOTRAP SIUMCA Up C 1E M CLEARBE pooo clock BRENOMSE s00000 CER IEUS SERIND CPU MPC505 Inform the debugger about the CPU type on your target if an automatic detection of the CPU is not possible Select the correct CPU type from the pull down menu in the field CPU Command SYStem CPU lt CPU type gt Set the system options in the option field corresponding to your target configuration and application program Command SYStem Option lt option gt On some processor types the special function registers can be moved The command SYStem Option BASE is used to inform the debugger about the new base address address of the first SFR If the debugger does not have the correct base address no or wrong data will be displayed and FLASH programming might not be possible Tutorial for TRACE32 ICD
19. the ISA card PODPC for your host connection e Select ICD FIRE BDM JTAG ROM Monitor with PODPAR if you are using the printer port for your host connection Then select EPP mode if supported by your PC standard mode otherwise At last select the used printer port LPTx 21 Quick Installation for TRACE32 ICD e Select Multiple document interface MDI or Multiple window interface MWI TRACE a J for i 0 SIZE d44 3 if flags l i 2 primz i i 3 k i primz W EFFHHFEFF OF FFRFRF 7 OP er RRRF a FF FF Be rrr BFFFFFFFF FF RFFEF H5 CTR HLE SARA Hia DGE i SHH TA DR P PHRHEIRFFFFFAAFHF HLF FFF FPF Oo Th EF PAP ILE FF ME OM FER _ E F Im IP l When the TRACE32 debugger software is started an application specific window is displayed All windows which display debugger information are placed within this application window MDI Quick Installation for TRACE32 ICD 22 CT ee ee Tlic i THE j for E 1 i t 35E i J FE E a 625 if flagaf 4 i j at R f i flepl i 3 be miz i i j i n it k primz l LLL E GEEA Ch BARBH CA aicinoaa LA Hie 2 BEBRRBAE id a CIR izma Ir Hiie 920 GBBT EPRCAREFFFFFFF SARA HEI KIS HSR TAS PPP PHLEREFFFRFRFF SHH TH HIH B PYH n CPRIOBFEFF IFFI DEC ELME 1 Gene a me EE We Ya Dea An CPU Dewi Dies Gpe Pai ev reke Hip Hie sivie ole mi ein
20. the command arp a The net driver must be activated The node name can be changed when not identical to 32 Configuration Command LINK NET NODE lt nodename gt Node name of TRACE82 default t32 POOL lt nodename gt Define a set of nodes which are scanned for connection Quick Installation for TRACE32 ICD 30 PODETH on HP UX 10 X HP 9000 Installation of the TRACE 32 Debugger Software In the following example the directory home t 32 is used as the system directory and the connection is made by Ethernet The system directory is created by the following commands mkdir home t32 cd reme7 32 mkdir hp7 00 Extracting the files from CD the device name is only an example pfs_mountd amp pfsd amp prs mount f 2809060 x tunix d v dsk7c0tzZa0 cdrom Gp Cdrom uni x home t32 cp r cdrom bin hp700 home t32 hp700 my Ap TO0 Conri1G t32 home t32 In the login script cshrc in the home directory the following lines must be added setenv T225YS 7 home t3zZ setenv T32TMP tmp setenv T32ID T32 Prepare and install the fonts cd home t32 fonts usr bin X11 mkfontdir xset tip Homes t32 fronts xset fp rehash Verify that you have write permission to the system directory and the boot t82 file and prepare the configuration file cd home t32 Vi CONTIG O74 LINK NET NODE t 32 PACKLEN 1024 31 Quick Installation for TRACE32 ICD Copy the executable file to a directory
21. used processor and assembler compiler is necessary to get your debug system running Purpose of this tutorial The purpose of this tutorial is to get your debug system running to write the batch job that does the necessary startup procedure and to make you familiar with the main features of the In Circuit Debugger How to use this tutorial The tutorial contains a guided debug session It uses a simple C program example to show you the most important debug features You should perform a number exercises as you read this tutorial We recommend to go completely through all chapters since besides the tour written in normal text format there are very helpful remarks written in italics which will not be repeated in other chapters Where can I get more information The common TRACE32 user interface contains a detailed Online Help that offers the most current description of all debug features Refer to The Online Help on how to start the Online Help system How long does it take 60 minutes 1 Tutorial for TRACE32 ICD Start TRACE32 ICD lf your debug tools are installed in accordance to Quick Installation for TRACE32 ICD power up your debug system first and then the target To work with the In Circuit Debugger ICD a working target system is required Take care of the proper sequence on powering up down Power Up debugger target Power down target debugger To start the debugger software on your host open the TRA
22. 32 File Edt BA War Break Aun CPU DILI Dump Source List Watch Locals Stack eel Peripherals Halyzer Per Coy Wire Symbols Analyzer List Message Area Register view ok VIEN P O008122C AdiabpS diabp5 si RE R9 BFFF Ril R11 Riz R13 TE 55 ok vaaia options Ce Try to change a register value by double clicking on the value you want to change The Register Set command for the selected register is displayed in the command line You only have to enter the new value and confirm it with return see right picture above 25 Tutorial for TRACE32 ICD lf the registers changed by the last steps should be marked in the Register window 1 Click to the window header with the right mouse button The command that was used to open the window is displayed in the command line for modification The window header becomes red 2 Set the option SpotLight and confirm the modification with return 3 Execute a few single steps The registers changed by the last step are marked in dark red The registers changed in by the step before the last step are marked a little bit lighter etc This works up to a level of 4 step k 5 x O1HB4 RE H R16 BFFFFFFFF R24 BCFFFFFFF SP gt AABSFFEG OFFA RD SHHABHAH R17 BFEFFFFFF R25 FFFFFFFF 614 HBB 1HB4 OCH A Rib MH R18 BFFFFFFF R26 BFFFFFFFF 68 AAHHAHH 7 Ra 5 Rii OH266 R19 BFFZFFFFF R27 BFFBFFEFF C BRR t4
23. ABC468 AAHBL4 7A funch 4 k D yaw m idiabp5Stdiabp5 enumyvar diabpS diabpSs enunvar A od The selected variable is displayed at the top of the Watch Window diabpS diabpS ast word AxA count 12346 left x8C438 right Ax Fieldi 1 Field2 2 diabpS diabpS enunvar A Every time you use Watch from the Var menu the new variable is added to the top of the window Resize the window to see all entries in the Watch Window 39 Tutorial for TRACE32 ICD A quicker way to look at a variable is to mark the variable in the Data List window by the cursor and to press the right mouse button From the Var pulldown menu select Add to Watch Window while k lt SIZE Peete k l FALSE k Add to Watch Window H View in Window bs anzahl Modify Yalue Display Memory Breakpoints Go Till other FT F F F If you want to display a more complex structure or an array in a separate window use View in the Var pulldown menu If you just want to watch all variables accessed by the current program context use Show Current Vars from the Var pulldown menu and execute a view single steps THACES2 File Edit view RM Break Run CPU Dev b E tl Watch WWM Dump Breakpoint Delete Breakpoint Auhomatic Watch Show Function Show Watch Show Locals Show Stack Yar Ref Show Curent Wars ok set P 00081204 wdiabp5 diak
24. ACK32 user interface settings in the configuration file if the jumper settings are changed during the hardware installation PBIS ADDRESS 816 the address must be entered in decimal format Environment variables OS ID T32 TMP C temp temp directory for TRACE32 SYS d t32 isa system directory for TRACE32 Printer settings PRINTER WINDOWS all standard windows printer can be used from the TRACEKE32 user interface For more advanced setting refer to the Installation Guide Quick Installation for TRACE32 ICD 24 The Configuration File for PODPAR on MS WINDOWS The configuration file is used to make some basic settings for the cooperation between TRACE82 ICD and the host system The entries are automatically made by the installation program By default the software assumes that the configuration file is in the system directory and is named config t32 Refer to Setup the Application Properties in Tutorial for TRACE32 ICD if you want to change the name or location of the configuration file standard settings in the configuration file PBI Or optional LPIZ LPT 1 Environment variables OS LD T32 TMP C temp temp directory for TRACE32 SYS d t32 isa system directory for TRACE32 Printer settings PRINTER WINDOWS all standard windows printer can be used from the TRACEK32 user interface Settings in the configuration file if EPP mode should be used PBI LPT1 FOr optional UPTZ EPP Environment varia
25. AZE 18HH15F H b 01616 exit BAASHAZC 780AHF99 bl oHFC4 main ae Se se a2 5a Sa a2 58 32 H define TRUE 1 H define FALSE 0 4 P ODOGO00E diabp5 Global started P UUUSU00S diabpS Global started lopped symbolic address at the cursor position state of debugger debug mode 17 Tutorial for TRACE32 ICD Toggle the debug mode from MlXed to HLL by a click on the Mode button in the Data List window The state line shows the debug mode HLL High Level Language Then do another Step Button to toggle between MlXed and HLL mode Mode TRACE 32 OFX B Data_List addr Tine source maing int j char p vtripplearray 0 0 0 1 540 vtripplearray 1 0 0 2 541 vtripplearray 0 1 0 3 542 vtripplearray 0 0 1 4 func2 func2at ennulate Data Var trigger devices Analyzer EERE Eart Step other peerings POOOS0FC4 Adiabp5 diabpS main stopped HU E g H LL The step you did was a high level language step to the next HLL line If you toggle back to MIXed mode both the C source and the corresponding assembler commands will be displayed Tutorial for TRACE32 ICD 18 If you single step while an interrupt is pending the next step will enter the interrupt routine If you want to single step your program without entering an interrupt routine use e SETUP IMASKASM ON to disable the interrupts during single stepping on assembler
26. B start cmm OF x iClear the TRACES2Z screen WinCLEAR selcet CPU type o Stem CPU MPCSAS set debug clock frequency for debugger target communication sfoten BdmC lock SRAAAA irestart the CPU with debug mode enable Totem Up Set special function register iset system clock Data set d GHA 7FCoH 1 B41000804 rset base address CSBOOT Data Set d 8BH fdf 1 4BABA iset CSEOOT Data set d 600 fdfc 1 94852001 idisable watchdog DataSet d 8hAfefc4 Al FFF EEF load program Data Load E1F diabph x ENDDO koa 4 d ve Enter the required commands and finish the batchjob by ENDDO and click the Save button The picture above shows a startup procedure for the PowerPC505 11 Tutorial for TRACE32 ICD Start the startup procedure by using Batchfile in the File pulldown menu oll View Yar Break Aun CPU Devices Trigger Analyzer Pert Coy MPCOxe Window Help Piel eke Emm TRACE 32 gem Edit Open Batchfile Load Type E B B CD DU Dump Stop Comma suchen ini diab tsi aj c B Choose Color Cacheen cmm Print Denno crim Diabe cmm shill Prefast cmm Preshow cmm start cmm Dateiname Dateityp Current cmm u Abbrechen emate Data Var trigger devices Analyzer other preinls P OO080004 diabpS Global _ start stopped a MIs EI A To continue our tour take one of the example files you can find in
27. Breakpoint type Breakpoint is set as Read breakpoint onchip breakpoint Start the program execution with Go If the program does not reach your breakpoint you can stop the program execution with Break Tutorial for TRACE32 ICD 36 To stop the program execution on a write access to a variable you can also use Breakpoints from the Var pulldown e Browse through the symbol data base to find the variable select it by a double click select Write in the Variable Breakpoint Set dialog box Push OK to set the breakpoint e Or enter the variable name or the hil expression e g to indicate only an element of an array in the Expression field of the Variable Breakpoint Set dialog box Select Write and push OK to set the breakpoint PEJ Break Bun CPU watch WEE Dump Delete ae Show Function Sie A Variable Breakpoint Set Ox Show Expression Show Jflags 4 Browse EN Shor k lace Read Alpha ate Clasp W write Beta Programm T Charly address types LC BBB6C 460C BBB8C46C H Onchip diabpS diabp5 Fflags 4 4 H A Breakpoint type Breakpoint is set as Write breakpoint onchip breakpoint Start the program execution with Go If the program does not reach your breakpoint you can stop the program execution with Break Most CPU also provide more complex break and trigger configurations The support for these features by the TRACE32 ICD user interface varies for each CPU For more
28. CE32 folder in the start menu and start the TRACE82 user interface If you have generated an icon on your desktop double click there In the example below the software for two processor families PowerPC and 68HC1 2 is installed fog Traces2 Trace 32 for Windows 35 NT Interet TF a l US winzip P a Trace 32 ICD HC12 a We ftp wa Trace 32100 PPC F SET Zubehor a Trace 32 Manual T a2 cE f Eudora Fro te Acrobat Exchange 2 1 P Interet Explorer el hi ft F Point esis owerPoin 3 EE 0 New Office Document S AE E Al T 321 2 eke ae TIZEK ape T32W95 4ND1 ap TRACE S2 NOR1 ap TRACES2 T32 Po Microasott Binder Microsoft PowerPoint EF Microsoft Word We MS D05 Eingabeauthorderung fey Programme a Windows E xplorer ally Ed mpi T 32mppt exe Einstellungen AJ Suchen amp Hilfe 3 Ausfuhren Tutorial for TRACE32 ICD 2 Setup the Application Properties The property window of your application allows same basic setting for the debugger 1 PodPC HC1 2 Properties Definition of an user specific configuration file By default the configuration file config t32 in the system directory is used The option c allows you to define your own location and name for the configuration file For more information on the configuration file refer to Quick Installation for TRACE32 ICD Definition of a working directory It is recommended not to work in the system directory Definition of th
29. EE 43 Tutorial for TRACE32 ICD Exit TRACE32 To save the window configuration for your TRACE32 ICD use Store layout from the Window menu Store layout generates a PRACTICE file that includes all commands to reactivate your complete window configuration automatically Enter a filename for the PRACTICE file into the File name field of the Store dialog box and push Save to generate the PRACTICE file Fet Cov Baimnit Help Cascade Tile Arrange Icons Clear all B B sto win Save ini Ej Temp kd File name wirtLomm Save ag type Curent cmm Cancel Tutorial for TRACE32 ICD 44 Since PRACTICE support a modular program structure you can enter a call for the automatic window configuration into your start up file E A pect chet comm Mi Fi Clear t e reren Hin ERR i Select CPU type STE ba CPU AFTSHS gt Sel diug clock Blt ala for debuggers target comeunicat lon Solei Arlee Tice JAAR r restart GPU with debug mde enable ES tere Lip i SE pecial fimetion freqiater i ant apb clock Date Set oc Saco WA a cee hasa a SRT Datta art il FAT Ft 1 IHAHA i WE CABO DataSet cS rdf z1 See pT Sead i atchi Dota Set c Si 21 BPE gt load poop ae Data LOAD EIF dishes x SRE simka cot brat inn do wini HOI A al To exit from TRACE32 ICD by using Exit in the File menu gem Edt View War Oper Batchfile Load Type Dum
30. FY R26 BFFFFFFFF RS HB Ril H R19 BFFFFFFFF Re BFFBEFFBFF t4 eC Ri 2 C468 R26 FFFFFBFF R28 H to a R13 943608 R21 WFFFFFFDF R29 HF RB SC35H R14 BFFFFFBFF R22 BFFFFFFFF R3e d Ti 156 R15 H R23 AFFFFFFFF R31 H koa ip Tutorial for TRACE32 ICD 14 How to Debug the Program Open the Data List window by using Source List in the View menu The program listing around the program counter is displayed THRACE 32 File Edit B Data List addr line F AAHSAHHE PAASAHAL PAASAHIH PHHAHH14 PAASAHILE PHHAHHIC PAASAHZH PHHAHHZ4 PAASAHZE PAASAHZL T 72 2 ss ses oe gel a oe Registers Dump Source List Wal akoh code 3JD6AHHHJ J02 BAHHH JDAHHHHJ 39A 4368 SC4RBAAD 3042074 SCAR BAAA 94A 1FFC ABAH 1ZCS AGAA1SFA AGAABF 99 4 label _Start mnemonic lis hr lis add i lis subi li stuu bl b bl Wee var Break Aum CPU Devices Trigger Analizer Perr Cow MPCss Window Help E eh D comment rii 9 i riis ri rii ri3 9 f ri3 9 ri3 r13 4308 f ri3 13 1716 r29 f AE re rZ 3 90 f r2 r2 16272 ri rae rl 4Hiri gt rA 64ir1 61258 _Init_main 81618 exit BAFC4 main emate Data War tagger devices Analyzer other previo P OU080004 WdiabpS Global start stopped a MIs EI ve 15 Tutorial for TRACE32 ICD Single step through the program by clicking the Step button in the Data List window JEH P
31. In Deb e _ a Circul 32 U gg r Q ui ick in and toria k LA U ITE RBAC H A Copyright C 1989 1998 Lauterbach Datentechnik GmbH All rights reserved No part of this publication may be reproduced transmitted transcribed stored ina retrieval system or translated into any language in any form by any means without the written permission of Lauterbach Datentechnik GmbH TRACE32 is a registered trademark of Lauterbach Datentechnik GmbH Lauterbach Datentechnik GmbH Fichtenstrasse 27 D 85649 Hofolding Germany telephone 49 8104 8943 50 facsimile 49 8104 8943 49 e mail support lauterbach com TRACE32 In Circuit Debugger ICD August 1998 Table of Contents TRACE32 ICD Preface What is an In Circuit Debugger About this Guide Where to Look for More Information Quick Installation for TRACE32 ICD About the Installation Guide Product Overview system Concepts Host Interfaces The Debug Module Hardware Installation Installation with ISA Interface Card PODPC Installation with Parallel Interface Card PODPAR Installation with Ethernet Interface PODETH Software Installation PODPC or PODPAR on MS WINDOWS PC PODETH on MS WINDOWS PC PODETH on SunOS Solaris SUN PODETH on HP UX 10 X HP 9000 Troubleshooting In Circuit Debugger iii Page PRE 1 PRE 1 PRE 2 PRE 4 Page INST 1 INST 1 INST 2 INST 4 INST 4 INST 11 INST 12 INST 12 INST 15 INST 18 INST 20 IN
32. JDEAHHHIJ JOZBHHHH JDAHHHHIJ Hyu Ss EU A A D HHHSHHIA S9ADISHS JC4AHAHI 3042CH 7H JOAAAAAA DSCE lt 0NYsREpstit T 4 F A P Ida fa dunp 8HBKH 2H ok options F 000STIDC SAdiabpSidiabpotsieve 26 Use the command line to display a memory dump There a two different way to define an address range e lt start address gt lt end address gt e lt start address gt lt offset gt RR B Data dump AdiabpSidiabp5tilags Zw address 4 A 4 6 n A E E 4123456 7 89ABCDEF D PHHEC460 HHHH AHAA AAAA AAAAAIHI AA AANI You DUDURRRRRROR A D HHHSC4 7 4 H106 A100 BART 4188 HAHI TE AHAH HHAH AuRuuRRUURUVUUUU DS HABSC468 HHAH HHHH HAAA HHHH HAHH HAHA HAHH HAHA wauu ta tt D H0H8C496 HHAH HHHH HAHA HHHH HAHH HAHA AHHH HAAA aaan RREA aat t D PHHECHAH HHAH AAAA AAAA HAHH HHHH HHHH HAHAA AAAA EE 4 a D S D 8C46A ZBE NORD ok formats ANRA Ra as options D OO0SC464 S diabpodiabpotlags 2 stc Again the value at a memory address can be modified by a double click A Data Set command for the selected address in displayed in the command line Enter the new value and confirm it with return Tutorial for TRACE32 ICD 30 How to Set Breakpoints Software Breakpoints The ICD debuggers use software breakpoints by default When a software breakpoint is set to an instruction the code at this address is replaced by a special instruction e g TRAP that stops the realtime execution a
33. ST 21 INST 26 INST 29 INST 31 INST 33 Table of Contents Tutorial for TRACE32 ICD About the Tutorial Start TRACE32 ICD Setup the Application Properties The Online Help setup the Debug Environment Batch Jobs The User Interface How to Debug the Program How to Display and Modify CPU Registers How to Display and Modify the Special Function Registers How to Display and Modify Memory How to Set Breakpoints Software Breakpoints Breakpoints in ROM Flash EEPROM Breakpoints on Data Accesses Onchip Breakpoints Overview Display and Modify HLL Variables Format HLL Variables Exit TRACE32 Table of Contents iv Page TUT 1 TUT 1 TUT 2 TUT 3 TUT 4 TUT 7 TUT 11 TUT 13 TUT 15 TUT 25 TUT 27 TUT 29 TUT 31 TUT 31 TUT 35 TUT 36 TUT 38 TUT 39 TUT 42 TUT 44 In Circuit Debugger TRACE32 ICD Preface What is an In Circuit Debugger Most CPUs provide an onchip debug system implemented in the CPU Typical examples are the BDM interface from Motorola the JTAG interface for the ARM7 or the JTAG interface for the PowerPC family The debug interface usually requires a few CPU pins that are used for the communication between the onchip debug system and a third party development tool The onchip debug system provides the following basic features e Read write memory e Read write CPU register e Single step and real time execution e Hardware breakpoints and trigger features not supported by all CPUs Th
34. TH on MS WINDOWS The configuration file is used to make some basic settings for the cooperation between TRACE82 ICD and the host system The entries are automatically made by the installation program By default the software assumes that the configuration file is in the system directory and is named config t32 Refer to Setup the Application Properties in Tutorial for TRACE32 ICD if you want to change the name or location of the configuration file standard settings in the configuration file LINK NET NODE t 32 PACKLEN 1024 Environment variables OS ID T22 TMP C temp temp directory for TRACE32 SYS d t32 isa system directory for TRACE32 Printer settings PRINTER WINDOWS all standard windows printer can be used from the TRACEK32 user interface For more advanced setting refer to the Installation Guide 27 Quick Installation for TRACE32 ICD Preparations for the Ethernet Interface The Ethernet connection requires the driver program t32w95 exe with networking capabilities This program requires that a WINSOCK compatible TCP IP provider is installed First a new node must be created for TRACE32 The Ethernet address of the system is placed on the bottom side of the system The following line must be added to the file HOSTS LOD oe 200 sD tog Note that the INTERNET address given here is an example only Contact your network administrator for a new INTERNET address for TRACES32 ICD When a RARP server is used the
35. ace can be used However we recom mend 10MHz as the max speed e The clock for the debug interface is automatically adapted if the CPU clock is changed by your application program The setting for the debug clock are done during the Setup of the Debug Environment 19 Quick Installation for TRACE32 ICD Software Installation In this section the installation for the TRACE32 ICD software is described The installation depends on the operating system the host and the host interface Therefore select the corresponding chapters according to your needs e PODPC or PODPAR on MS WINDOWS PC e PODETH on MS WINDOWS PC e PODETH on SunOS Solaris SUN e PODETH on HP UX 10 X HP 9000 Quick Installation for TRACE32 ICD 20 PODPC or PODPAR on MS WINDOWS PC Installation on Windows 3 x 1 Start bin win32s disk1 setup exe on the CD to install WINS32s 2 Then start install bat in the root directory of the CD ROM and follow the instructions of the installation program Installation on Windows 3 x WIN32s Windows 95 Windows 98 Windows NT 1 Start setup bat in the root directory of the CD if it does not start automatically Follow the instructions of the installation program some hints to answer the questions of the installation program e Select product type ICD FIRE BDM JTAG ROM Monitor with PC Inthe ICE BDM ROM list select ICD lt CPU gt e g ICD 68K e Select ICD FIRE BDM JTAG ROM Monitor with PODPC if you are using
36. al wire for CPU clock oe tet Debug PODETH Module Fk jdika opal Ly I en A meee i PODBUS power supply PODETH provides an Ethernet interface twisted pair 10 Base T for the Debug Module N A Do not connect or disconnect anything while power is on Quick Installation for TRACE32 ICD 18 To configure your TRACE32 ICD with the PODETH interface card 1 2 Connect the Ethernet Interface to your Ethernet cable not enclosed Connect the power supply to the PODBUS Ethernet Interface Plug 7 9V inner negative outer positive Please use only the enclosed AC DC adapter Connect the Debug Module via the PODBUS connector to the PODETH box Connect the Debug Module to the target by the debug cable A list of the supported processors and the pinout of the dedicated debug interface connector BDM JTAG OCDS COP ONCE can be found in the ICD Targets for your CPU family Connect the clock cable optional By default TRACE32 ICD uses a fixed clock to run the debug interface A clock range from 100KHz up to 5 MHz can be used We also provide a clock cable to allow you the use of the divided CPU clock as clock for the debug interface The relation between the CPU clock and the debug interface clock is specific for your CPU Refer to your ICD Target Guide for detailed information The use of the divided CPU clock has the following advantages e The max speed for the debug interf
37. ard Address select jumpers on the ISA card off 250 592 off 260 608 off off 280 640 off 300 768 off off 340 832 off off off 390 JP3 must always be on If you change the jumper setting a modification in the TRACE32 configuration file config t32 is also required Example If the jumpers settings are JPO OFF JP1 ON JP2 OFF JP3 ON the file config t32 must have the following contents PBI ADDRESS 816 the address must be entered in decimal format For more information on the configuration file see PODPC or PODPAR on MS WINDOWS PC The PODPC requires no additional power supply Connect the Debug Module with PODBUS cable to the ISA card Connect the Debug Module to the target using the debug cable A list of the supported processors and the pinout of the dedicated debug interface connector BDM JTAG OCDS COP ONCE can be found in the ICD Target Guide for your CPU family 13 Quick Installation for TRACE32 ICD 4 Connect the clock cable optional By default TRACE32 ICD uses a fixed clock to run the debug interface A clock range from 100KHz up to 5 MHz can be used We also provide a clock cable to allow you the use of the divided CPU clock as clock for the debug interface The relation between the CPU clock and the debug interface clock is specific for your CPU Refer to your ICD Target Guide for detailed information The use of the divided CPU clock has the following advantages e The max speed for th
38. basic concepts for the In Circuit Debuggers and the other PODBUS devices e g ICD Trace ICD Risc Trace EPROM Simulator TRACE32 ICD Preface 4 Reference In the Reference book you can find an alphabetical list of all debug commands for the TRACE82 development tools and a detailed description of their syntax and function All commands not available for TRACE32 ICD are marked with E TRACE382 ICE only or F TRACE32 FIRE only The following books contain information for advanced users Installation Guide General Installation Guide for all TRACE32 development tools Operation System User s Guide Gives an overview of the features for the TRACES82 Operating System e g windows management file management printer etc Operation System Reference Provides a detailed description of the TRACE82 Operating System e g windows management file management printer etc Practice User s Guide Introduction into the batch language PRACTICE Practice Reference Alphabetical list of all PRACTICE com mands 5 TRACE32 ICD Preface Quick Installation for TRACE32 ICD About the Installation Guide This Installation Guide describes the basic installation and configuration for all TRACE82 ICD In Circuit Debuggers that are implemented using their onchip debug interface Typical examples for onchip debug interfaces are BDM JTAG ONCE For the installation and configuration of the ROM monitors or for special system configurations
39. bles OS ID T32 TMP C temp temp directory for TRACE32 SYS d t32 isa system directory for TRACE32 Printer settings PRINTER WINDOWS all standard windows printer can be rused from the TRACEK32 user interface For more advanced setting refer to the Installation Guide 25 Quick Installation for TRACE32 ICD PODETH on MS WINDOWS PC Installation of the TRACE32 Debugger Software Installation on Windows 3 x 1 Start bin win32s disk1 setup exe on the CD to install WIN32s 2 Then start install bat in the root directory of the CD ROM and follow the instructions of the installation program Installation on Windows 3 x WIN32s Windows 95 Windows 98 Windows NT 1 Start setup bat in the root directory of the CD if it does not start automatically Follow the instructions of the installation program some hints to answer the questions of the installation program e Select product type ICD FIRE BDM JTAG ROM Monitor with Ethernet e Inthe ICE BDM ROM list select ICD lt CPU gt e g ICD 68K e Select Multiple document interface MDI e Select Remote control access not active The installation program generates a TRACE32 folder where you can start the debugger software and the Online Help from If you prefer to start the program by clicking on an icon on the desktop use the Explorer search for the startfile t32w95 exe and pull it onto your desktop Quick Installation for TRACE32 ICD 26 The Configuration File for PODE
40. d 10MHz as the max speed The clock for the debug interface is automatically adapted if the CPU clock is changed by your application program e The TRACE32 debugger software PODBUS Interface Card for ISA PODPC Debug Cable to Target TRACE32 Debugger Software 3 Quick Installation for TRACE32 ICD System Concepts The TRACE32 Debugger Software runs on a host PC or workstation The host communicates with the target via the Debug Module e For the fast communication between the host and the debug module a special bus interface is used PODBUS Processor Oriented Device Bus An advantage of the PODBUS is that your debug environment can be easily expanded by additional PODBUS devices to provide a powerful tool configuration Additional PODBUS devices are ICD Trace ICD RISC Trace EPROM Simulator Stimuli Generator etc e The connection between the target and the debug module is done by a processor specific debug interface cable PODBUS Debug Interface Host Interfaces Three different interfaces are available to connect the host system to the PODBUS e PODPC interface card for ISA bus e PODPAR converter for printer port LPTx e PODETH converter to Ethernet Twisted Pair Quick Installation for TRACE32 ICD 4 MODULE ISA card PODBUS System configuration with ISA card PODPC standard parallel cable parallel power trigger PODBUS supply in out a AC DC adapter System configuration with
41. e In Circuit Debugger TRACE32 ICD uses these basic features of the onchip debug system to provide a powerful debug tool that offers e Easy high level and assembler debugging e Display of internal and external peripherals on a logical level e Onchip break and trigger support e RTOS awareness e Flash programming e Powerful script language e Multiprocessor debugging 1 TRACE32 ICD Preface TRACE82 ICD is part of the TRACE32 microprocessor development tool product line This product line also includes a trace extension for some ICD Debuggers and the full featured In Circuit Emulators TRACE32 ICE for all CISCs and TRACE32 FIRE for the fast RISC processors In Circuit Debugger In Circuit Emulator TRACE32 ICD TRACES32 ICE FIRE All TRACE32 development tools use a common user interface So the look and feel stays the same no matter what system you are using About this Guide The purpose of this guide is e To get your In Circuit Debugger installed See Quick Installation for TRACE32 ICD e To help you to write the proper start up sequence See Tutorial for TRACE32 ICD e To make you familiar with the basic functions of TRACE32 ICD See Tutorial for TRACE32 ICD TRACE32 ICD Preface 2 since an In Circuit Debugger always needs a working target system we also offer simulators for some major CPU families that allow you to get familiar with our debugging tools even before your target hardware is available Simulator
42. e debug interface can be used However we recom mend 10MHz as the max speed e The clock for the debug interface is automatically adapted if the CPU clock is changed by your application program The setting for the debug clock are done during the Setup of the Debug Environment Quick Installation for TRACE32 ICD 14 Installation with Parallel Interface Card PODPAR Do not connect or disconnect anything while power is on 15 Quick Installation for TRACE32 ICD To configure your TRACE32 ICD with the PODPAR interface card 1 Connect the Printer Port Interface PODPAR with enclosed cable to the printer port LPTx of the PC Normally no changes on your PC are needed The printer port interface supports standard and EPP parallel ports improved speed At common PC s the parallel port mode can be selected in the BIOS The BIOS must be switched to EPP EPP V1 7 or EPP V1 9 Some PC s require special tools to modify the parallel port mode Please ask your PC manufacturer During the software installation you will be asked which printer port you want to use and if EPP mode is supported The entry in the config t32 file will be generated automatically For standard configuration the file config t32 must have the following contents PBI EPT or optional LPT2 If the PC supports EPP mode the following config t32 entries are required PBI LPT1 or optional LPT2 EPP For more information on the configuration file see PODPC
43. e g additional devices multiprocessor debugging etc refer to the Installation Guide 1 Quick Installation for TRACE32 ICD Product Overview A complete TRACE32 ICD configuration consists of e A PODBUS interface to the host PODPC PODPAR or PODETH e A Debug Module Lauterbach offers two different debug modules the Standard Debug Module and the Power Debug Module Both modules can be used all CPUs that are supported by TRACE82 ICD some CPUs like the PPC603 or the MPC740 750 need the Power Debug Module since their complex debug interface requires the transfer of huge amounts of data To guarantee a fast data transfer rate the Power Debug Module has its own RISC controller e A Debug Cable The Debug Cable connects the Debug Module to the debug interface on your target For the connector pinout of your debug interface refer to the ICD Target Guide for your CPU Quick Installation for TRACE32 ICD 2 e A Clock Cable By default TRACE32 ICD uses a fixed clock to run the debug interface A clock range from 100KHz up to 5 MHz can be used We also provide a clock cable to allow you the use of the divided CPU clock as clock for the debug interface The relation between the CPU clock and the debug interface clock is specific for your CPU Refer to your ICD Target Guide for detailed information The use of the divided CPU clock has the following advantages The max speed for the debug interface can be used However we recom men
44. e o oglhen Ee E aie pees trigger in out Ethernet power supply RODBUSQUP 27 eR a x et kes ea a es ae ae aoe 2 a A Ta m ee n p mot pS ay ne Le Ge See TE A i oles Seas P ERRAT os m jl l z H The PODBUS controller for ethernet contains both an ethernet connector for twisted pair and a printer port interface to provide a flexible host connection External power supply is required for the PODETH Plug 7 9V inner negative outer positive Please use only the enclosed AC DC Adapter The BNC connector is used to input output a trigger signal to from the Debug Module For more information on this Trigger feature refer to Trigger in the ICD Users Guide 9 Quick Installation for TRACE32 ICD The LEDs transmit receive collision link polarity jabber indicate the status of the integrated Ethernet transceiver MC68160 LEDs POWER External power is supplied ACTIVE On if device is active flashes if device is not used ERROR On if device is active flashes if device is not used In error case an error code will be pulsed See the ICD Debugger User Guide for further information TRANSMIT Transmit activity RECEIVE Receive activity COLLISION Collision activity LINK Twisted pair link integrity POLARITY Twisted Pair Polarity Error receiver inputs TPRX TPRX are reversed JABBER Twisted Pair Jabber condition detected Quick Installation for TRACE32 ICD 10 The
45. e start up size of the application window General Shortcut Security A FodPC HC12 Target type Application 1 Target location Tae Target ONT 3243201 2 exe c config_par ta2 i i Buri separate Memon Space Start in D PEG 2 Shortcut Kep None Run Normal window hi it ee Minimized Maximized cae too 3 Tutorial for TRACE32 ICD The Online Help The most current version of the TRACE32 books is available in the online help Use the Help Topics button to get access to the TRACE32 online help Devices rigger i lt t Help Topics button in the Tool bar Help Topics Help souks THRACE 3 Online Help Contents Index Find Click a book and then click Open Or click another tab such as Index Se AACE 32 Online Manual Ce F elease History Indes TRACE 32 Command List gh Installation Guide g Operation System User s Guide Ce Operation System Reference Ce Practice User s Guide Ce Practice Reference Ce ILD Debugger User s Guide Ce Fire User s Guide Ce Emulator User s Guide Ce Reference Ce Emulator Extensions Ce Emulator Targets d ICE Targets Print Cancel Tutorial for TRACE32 ICD 4 The online help provides also a powerful context sensitive help Devices Trigger Analyze Use the Help Context button on the tool bar to activate the context sensitive help Click first on the Help Context button and then move the quotation mark cu
46. in the PATH or include it in the PATH variable ep E32 de jusr bin Preparations for the Ethernet Interface For the adaptation to Ethernet a new node must be created The Ethernet address of the system is placed on the bottom side of the system The following line must be added to the file etc hosts LIZ s Je ZOOS t32 Note that the INTERNET address given here is an example only Contact the network administrator for a new INTERNET address for TRACE32 The INTERNET address is not available to the TRACE32 system Therefore it can t response to ARP requests For the first connection the Ethernet address of the system must be entered in the host table by the following command aro g 32 UrcO roar Orro The net driver must be activated The node name can be changed when not identical to t32 On HP 9000 300 and HP 9000 400 and also some HP 9000 700 workstations the packet size must be limited to 1024 bytes Use the command PACKLEN 1024 for these type of workstations Configuration Command LINK NET NODE lt nodename gt default t32 PACKLEN lt psize gt default 1472 Quick Installation for TRACE32 ICD 32 Troubleshooting If you can not solve your problem with the following hints contact our support line telephone 49 8104 8943 50 facsimile 49 8104 8943 49 e mail support lauterbach com System doesn t response to ping on Ethernet Internet address already setup in system or arp used When arp is used i
47. information refer to the ICD Target Manual 37 Tutorial for TRACE32 ICD Onchip Breakpoints Overview The following list give an overview of the usage of the onchip breakpoints by TRACE82 ICD e CPU family e Onchip breakpoints Total amount of available onchip breakpoints e Instruction breakpoints Number of onchip breakpoints that can be used for pro gram and spot breakpoints e Data breakpoints Number of onchip breakpoints that can be used as read or write breakpoints CPU family Onchip Instruction Data Breakpoints Breakpoints Breakpoints 68HC12 68HC12B D all others 68HC16 ColdFire PPC400 MPC500 800 4 Instruction 2 Data PPC600 No a breakpoint if software breakpoints are used PPC740 750 2 Reduced to 1 if software breakpoints are used DSP56K 96k 56300 96100 Reduced to 1 if software breakpoints are used Tutorial for TRACE32 ICD 38 Display and Modify HLL Variables To display HLL variables use the Watch command from the Var pulldown menu 4k TRACES File Edit view MJ Break Run CPU Dump Select the variable by a double click Breakpoint from the symbol database Delete Breakpoint B v aw am Of in nn ES struct structi D BABBC 4S6 ABRBCAASB 4truct unioni D BABEC 6H ABAEC Fi unsigned char 17 D HHH812D4 HHHd 12E 4 struct abc D HABECSBC ABBECSCS enunvar int h D AARSBCSCC ARBECSCF f lags unsigned Char 19 D HB
48. l D Edit Source Tutorial for TRACE32 ICD 32 To set a program breakpoint to a code line that is not displayed select Show Function in the Var menu Doubleclick to the function to display it and then set the breakpoint by a doubleclick to the code line SS RE Break Run CPU Watch VIEW Dump Breakpoint Delete Breakpoint Show Function E GES KARENE Funci3 int P BABEBBSC BHABERESF Funci4 cint PBBBGHBAC BBBGBED Funci5 int P BABEBBE4 HABERC1S Funci6 Cint 3 P HBREBCZH ARBBHCAB Funci int Ms P BABEBCSE BHABERCD B Data List Aidiabp5 diabp5 funclb addr line source 4 int funci6 x1 3 fk Parameter 1 Long long x1 a5all 457 458 return int 2 x1 aa 4 ve 33 Tutorial for TRACE32 ICD The second breakpoint type that is available when software breakpoints are used is a spot breakpoint A spot breakpoint is a watchpoint that stops the program execution for a short time to update all displayed information and then restarts the program execution To set a spot breakpoint select the code line where it makes sense that the displayed information is updated Press the right mouse button and select Spotpoint from the pulldown menu E Data List addr line source 2 631 flagsL k FALSE 632 k 1 Go Till Here 634 anzahl4 Default Break points a i Se
49. mands eak Bale CPU Devices b Step F2 Step Ower Call Fs Trigge 7 id Step over function call or subroutines Step Over Go Next F4 Go Return FA Go Up FE Go Till G peak Ratug CPU Devices rigge p Step F2 H Step Over Call F3 Go Nest Go to the next code line written in the program listing Useful e g to leave loops Go Return FA Go Up FE Go Till Go Fr Brea eak Batam CPU Devices p Step F2 Step Over Call F3 Trigge A Go to the last instruction of a function Go Return Go Next F4 Go Lp Go Till Go Break 21 Tutorial for TRACE32 ICD reak Malus CPU Devices Trigg p Step Pe e Return to the caller function Step Over Call F3 Go Up Go Next F4 fo Return F5 Go Till G peak fatua CPO Devices Trigge E a F2 gt p step Lo Siem liver Cell F Start the realtime emulation Go Next F4 Go Return F5 Gop FE Go Iil eak Bam CPU Devices Triggi a D Step F2 Step Over Call Fa Stop the realtime emulation Break Go Next F4 Go Retur F5 Go Up FE Go Till Go Fy The commands Go Next Go Return and Go Up are only available if the program is running in RAM or if the CPU provides onchip breakpoints Tutorial for TRACE32 ICD 22 The Var Frame window displays the function nesting for your application program With the
50. nd returns the control to the onchip debug system This method requires RAM at the break positions If you run your program out of RAM the number of software breakpoints is unlimited lf your program does not run in RAM refer to Breakpoints in ROM FLASH or EEPROM Back to the program Doubleclick on the code line where you want to set a program breakpoint All code lines to which a program breakpoint is set are marked with a small red bar B Data_List addr line source 623 for i 0 i lt SIZE i if flags i i b27 primz i i 3 626 k i primz 629 while k lt SIZE t flags k FALSE k primz anzahl 31 Tutorial for TRACE32 ICD Use List from the Breakpoint menu to display the information about all set breakpoints Set Beh Vere Breakpoint type Breakpoint is set as Set on PC Program breakpoint software breakpoint Delete on PC _ amp B b l ioi address types YO C HAB6 12444 P SOFT diabpS diabpS sievet9h E Start the program execution with Go If the program does not reach your breakpoint you can stop the program execution with Break You can remove the breakpoint by another doubleclick to the marked line or by toggling the breakpoint in the Break List window address C BABE 1244 P SOFT dig F ievye B Go Till Here w Default Breakpoints H g Spotpoint Set PC Here Display Meron w Breakpoints l Go Til
51. p Stop Command Choose Colors Print d exit Take care of the proper sequence on powering up down N A Power Up debugger target Power down target debugger 45 Tutorial for TRACE32 ICD
52. rsor on the object you are interested in A popup window is opened to display information about this object A B 57Stem Of x Mode Bdmllock Option Option 4 E Down C4 M ICFLUSH hf WATCHDOG eak EM CPU Devices Trigge NoDebug sW m een een p Step Fo C Go C4 M OCRESD OFFFFFOOO step Over Call C AN All modes can be selected and SIUMCR gt C Up altered by clicking the appropriate button within the wirid ea i Goa Next Go Return Go Lp FE CPU Go Till MPC505 Go Break Like the command Go with a temporary breakpoint set to the next assembler command or next HLL line This command can be used to overstep a subroutine call instruction or to leave a loop See also the command Step Over See also Go Next Continue program 5 Tutorial for TRACE32 ICD The About TRACE32 command in the Help menu provides version information for all parts of TRACE32 ICD B ERSION About TRACE 32 k Tutorial for TRACE32 ICD 6 Setup the Debug Environment In order to set up your debugger you need some knowledge about your CPU and about your target configuration To be able to download your program including all symbol and debug information you also need some knowledge about your compiler A basic start up procedure and the CPU specific setting for the CD Debuggers are described in the ICD Target Manual Contents Topics ICD Target Manual gives
53. t PC Here Display Memory d 638 return anzahl Ereakpoints 639 Go Till 4 Edit Source H g To watch for example all changes on the variable k select the variable by the mouse press the right mouse button and apply Add to Watch Window from the pulldown menu EL EN BT step StepOver GoNet GoRetm Gol Go Break Mode addr line source flags k FALSE 632 primz h Add to Watch Window k 634 anzah View in Window F Modify Value h Display Memory Ereakpomte F 630 return anzahl E 639 d Go Till d other j 2 If you now start the program execution with Go you can watch the changes on the variable k Tutorial for TRACE32 ICD 34 Breakpoints in ROM Flash EEPROM Most processor types not 6833x and 6834x provide a small number of onchip breakpoints These breakpoints are used by TRACE32 ICD to set program or spot breakpoints even if the program doesnt run in RAM For information on the available onchip breakpoints for your CPU refer to the Onchip Breakpoints Overview since the debugger uses software breakpoints by default you must inform the debugger that the onchip breakpoints should be used MAP BOnchip lt address_range gt The command MAP BOnchip indicates that whenever a program or spot breakpoint is set within the specified address range the debugger should use an onchip breakpoint HMAF BONCHIP SHHKK 844 F r a a a P O0081 220
54. t must be used on the same workstation short before Ethernet address correct System on the correct subnet Cables and transceiver o k Ethernet software in host PC configured correctly xset fp fontpath gives error bad value Does the font directory exist Does the fonts dir file exist created by mkfontdir Is the directory seen under the same name by the X server Have all directories that lead to the font directory read and execute permissions for everybody Executable program does not start or gives fatal error When transferring between different OS systems files copied in binary mode Access rights to file in directory o k Configuration file contents o k Executable program displays FATAL ERROR selecting device driver Using configuration file for MS DOS for the WINDOWS Driver WINDOWS and workstation drivers cannot load new drivers Environment variable T32CONFIG and or T32SYS correctly set Executable program displays error reading config t32 Configuration file contents o k Commands in file in uppercase Blanks inserted not inserted Device specific commands placed after device header Device configuration blocks separated by empty lines Environment variable T32CONFIG and or T32SYS correctly set 33 Quick Installation for TRACE32 ICD Executable program stops without message but with window opened Access rights to directory 0 k On UNIX host try with NOLOCK feature
55. ter the address directly in the Address field and push OK to open the Data dump window TRACE 32 File Edt SMETS War Break Run CPU b p Registers Source List Ad akeh Dump Memory Mel x Address roe SOE OE Bute B symbol_ browse c dialog set addr C Word P VAENE NE struct abc int unsigned char 19 def anumyvar f lags funch Dump Hemy PEB Dump Hemy PEB Memory Address i WdiabpSdiabp5 flags Browse Byte won Lone RR B Data dump Adiabp5idiabp5 ilags Zw address 4 2 4 6 g A C E D HBBSC4AGE HHH BAAR AHAHA BBR 81H1 4168 4141 HANI y D BBHSC4 7H H100 A100 HAHI 4188 BAR HHHH HHAH AAAH D HHA8C486 HAHAA HHHH AANA HAHA HAHH HAHAA AHHH AAAH E a ae D H0A8C496 HAHAA AHHH AANA HAHA HAHH HAHAA AHHH AAAA Wt ett o D AHH8C4A6 HAHAA AHHH AANA HAHA HAHH HAAA AHHH AAAA Wta uet o oa D H0A8C4EH HAHAA HHHH AANA HAHA HAHH HAHAA AHHH AAAH Witte oo Value Memory Class Address 29 D HABECSBC AABECS D AAAECICC AAABCI k D HHAOL468 AAABL4 hl A 4123456 B9ABCDEF HHSSSNSSNS UPC CPUC OC AA FA FEFA A FEFA U F SHSHHSSHHSHHHHHH HUHUUHHUUHUUUUUL oe 4 ASCII Tutorial for TRACE32 ICD Display a dump at address 0 by using al the Memory Dump bution jer Analjzer Per Cov Window fit B data dump 80000 20 Of x address 4 4 g L 4123456 B9ABCDEF D HAASHHHH JOANAHHH
56. the special function register is displayed in the state line 27 Tutorial for TRACE32 ICD You can modify the contents of a special function register e By pressing the right mouse button and selecting one of the predefined logical value from the pulldown menu e By a double click to numeric values A Data Set command to change the register contents is displayed in the command line Enter the new value and confirm it with return an B PER PH Timer i IMRI BAA TIRRI HBA ICRI ABH TCH AHHH TERI ABH PH Timer 2 THR2 HARA TIRER ABH TERZ TCH2 TERZ 4 PSF BH CE oF Biel Es AMA ORI dis FRR ICLK BH GE dis ies fal REF A CAP WH arp PSF BB CE dis ON A ORI dis FRR ICLK BH GE dis Wen B PER PH Timer i THR1 TRR1 TCR1 TCH1 TER AAAA TIN AAAA AAAA AAAA PH Timer 2 THR2 TRR2 TCR2 TCH2 TER 4 PSF BH CE dis ON A ORI dis FRR A ICLK A GE dis REF CAP A PSF AA CE dis ON ORI dis FRE B ICLK AA GE dis REF A CAP A TUES ANORD ok formats EEE bag options C O0000990 Timer Mode Register stopped Tutorial for TRACE32 ICD 28 How to Display and Modify Memory To inspect an address range in the memory use the Data dump window select Dump from the View menu The Dump Memory dialog box is opened e Use the Browse button to browse through the symbol data base Select a label by a double click and then confirm by pushing OK e Or en
57. the TRACE32 system directory under demo lt processor_family gt compiler e g demo powerpc compiler Diab Diabc cmm or use your own batch file if you have already prepared one Tutorial for TRACE32 ICD 12 The User Interface TRACE 32 File Edit Beaisters Dump Wee var Break Aum CPU Devices Trigger Analizer Perk Cov Window Help 2 S m Biel E Sh Source List 0 x Step Wach fe GoPeum Goup Go Beak Mode addr Locals label mnemonic comment SP Bal tack add l d4 d3 prime k SP l Peripherals moveq 12 d 18 d Symbols cmp d3 d kd SP MBL Analyzer List bye 17BE Message Area H Ti count sp aageai7ca 5281 Puldown Menu Sddg i d1 1 count SP BAAAIFCC b282 add 1 1 d2 i i SP AAAALFCE 7012 noveq 12 d 18 d SP BAAA17DA EHHA cmp d2 d id SP PAAA17DZ GCG bge 17AA pE B YF l fc funcib amp vint register int 1 while TRUE register int prime 3 register int k 6 sieve j register int count i ABA sieve i 86 prime 3 k 6 count B 5 4 AA WA en Pee sP o Analyzer FERF e previos ee ae Z SP 000017 C6 SAnechmec sieve 3E Command Line Open a window to display the CPU registers You can alternatively select Registers from the View pulldown menu push the Register button or enter Register view at the prompt B in the command line 13
58. und in the ICD Target Manual in the section Compiler If the file should be loaded to an Eeprom the memory class EEPROM must be used to generate the required programming sequence Example d load b eoromdata EEPROM For flash programming refer to the FLASH command group in the Reference book To display the source code the compiled program must be equipped with debug information frequently compiler option debug Then TRACE32 can load the compiler output formats directly 5 Initialize program counter and stackpointer Register Set Many compilers add these settings in the startup code to the user program automatically It is recommended to write a batch job to set up the debugger to guarantee a proper start up sequence Tutorial for TRACE32 ICD 10 Batch Jobs Create a new batch file start cmm in your working directory by using the command PEDIT start cmm TRACE32 has its own command language for batch jobs It is called PRACTICE and it is very powerful see the PRACTICE User s Guide and PRACTICE Reference for more information All commands of the TRACE32 development tools commands for program flow conditional commands and I O commands are allowed The default extension for batch files is cmm Also debugging of a PRACTICE program is supported Look at the description in the PRACTICE User s Guide and PRACTICE Reference commands PLIST PEDIT PBREAK Es B EDIT D T32 Siemens MPC555 demo powerpc COMPILERADIA
59. urs m oe C DUMP ho H OFF Format h H 4 display other Index F INherited l SPaces Select Type to display the a pres rer variable with the complete Location F MEthods T SpotLight type information If Name Apply Cancel EE B v Y Sm diabpo diabp5 ast N IOK static struct structi diabpS diabpS ast iunsigned char word Axa a int count 12346 struct structi left x8C438 struct structi right Ax p unsigned int 2 fieldi Cunsigned int 3 field a LEE Tutorial for TRACE32 ICD 42 If you display more complex HLL structures select TREE in the Format field of the Change Variable Format dialog box This formatting allows to select the display for each member of the structure by clicking on or uned AxA Add to Watch Window View in Wirda Modify alue Display Merary I radix format pointer Breakpoints T Decimal T Compact String ie Hex T Fixed I sY mbol flim le E BIN ary POUMP Format h ae Aecursiy OFF RO ltiline o Ascii M OUMP other display T Index F INherited Type T Hidden T Location F MEthods W Hame SPaces E SpotLight Apply Cancel E diabpS diabpS ast Hword Ax count 12346 left AxgC438 Hword Axl count 12346 left AxBC436 Hlright AxA Fieldi 1 Field2 2 Hlright 4x Fieldi i Field 2

TRACE 32 - Lauterbach

Contents

Download Pdf Manuals

Related Search

Related Contents