Home

Alpha Microprocessors Motherboard Debug Monitor User's Guide

1. tions Command Parameters Description cl address Edits memory longwords 32 bit cw address Edits memory words 16 bit cb address Edits memory bytes 8 bit fill start address Fills the specified memory block with the specified 32 bit pattern end address fill value copy start address Copies a memory range to the specified address end address destina tion compare start address Compares a memory range to a specified address end address compare address dis start address Displays memory as CPU instructions end address sum start address Prints a checksum of a memory range end address rl register iterations Reads a longword from a register port in I O address space silent rw register iterations Reads a word from a register port in I O address space silent rb register iterations Reads a byte from a register port in I O address space silent wl register data itera Writes a longword to a register port in I O address space tions ww register data itera Writes a word to a register port in I O address space tions wb register data itera Writes a byte to a register port in I O address space tions mrl address iterations Reads a longword from memory in I O address space silent mrw address iterations Reads a word from memory in I O address space silent mrb address iterations Reads a byte from memory in I O address space silent mwl address data itera Writes a longw
2. ee 00100040 00000000 00000000 00000000 00000000 e 00100050 00000000 00000000 00000000 00000000 e 00100060 00000000 00000000 00000000 00000000 ee 00100070 00000000 00000000 00000000 00000000 ee 00100080 00000000 00000000 00000000 00000000 ee DP264 sw 100000 100080 2 1 val 2010 mask FOFO occurrence at 00100022 221F occurrence at 00100026 2610 User Commands 4 121 User Commands 4 4 102 swpipl Set or Display IPL The swpipl command sets or displays the interrupt priority level IPL of the CPU Format swpipl ipl Parameters ipl Specifies the IPL ranging from 0 to 7 as defined for Tru64 UNIX by the Alpha Archi tecture Reference Manual Description The swpipl command reports the current IPL when no parameter is provided When a value of 0 to 7 is provided to the swpipl command the current IPL is set to that value This command uses the swpipl PALcode instruction for Tru64 UNIX defined by the Alpha Architecture Reference Manual The CPU arbitrates interrupt requests based on the IPL When the current IPL is lower than a pending interrupt request the CPU will raise the IPL while it services that interrupt At IPL 7 no interrupt requests are handled To avoid interrupt complexities when debugging hardware the Debug Monitor is designed for minimal use of interrupts Therefore at startup the IPL is set to 7 and can be lowered on demand using
3. 0 0 0 0 cece eee tenes 4 117 step Execute Next Instruction llle 4 118 stop Set Breakpoint iia Oa ees e RARE RU lle 4 119 sum Compute Checksum in Range 0 cece eet eee ee 4 120 sw Search Memory by Words 0 0 c cee ene 4 121 swpipl Set or Display IPL ng mirae e e e a pE eee 4 122 sysshow Display ROM Parameters 0 00 c eee eee eee eee 4 123 tip Connect to Serial Communication Port 000 cece eee eee eee 4 124 version Display Debug Monitor Firmware Version llli elles 4 125 vinit Initialize Video Controller lle 4 126 wb Write Byte to I O Address Space lisse esee 4 127 wl Write Longword to I O Space 1 0 0 cette eee 4 128 wrfen Write Floating Point Enable 2 0 0 0 cece ee ees 4 129 ww Write Word to I O Address Space lisse eese 4 130 V vi A Support A 1 A 2 Index Customer Support Alpha Documentation 8 April 1999 Figures 2 1 8 April 1999 Debug Monitor Memory Map vil Tables 3 1 Ladebug Command Line Options 0 0 0 cece teens 3 3 4 1 Command Line Editing Keypad 0 eects 4 1 4 2 Command Summary Table ise area aee e cette tees 4 3 viii 8 April 1999 Preface Introduction This document describes the software features of an Alpha microprocessor mother board The motherboard software is intended to provide softwar
4. Ene 00100020 40C2040648807722 B49C82F8B4DC82F0 w H Q 00100030 43C5153EB4BC8300 B3FC8308B7FE0020 gt C 00100040 47E20404D0000007 00000080D0001019 Guns 00100050 0000000047FFO041F 0000000000000000 G 00100060 B41E002843C6153E A49C8018D0000136 C 6 00100070 D000030943E03405 43E05405A49C8020 4 C EMT User Commands 4 91 User Commands 4 4 77 prb Read Byte from PCI Configuration Space Format Parameters Description Example The prb command reads a byte 8 bits from the specified address in the PCI configura tion space prb pci_address id bus function pci_address Specifies the address in PCI space id Specifies a decimal number that represents the slot assigned to the PCI device bus Specifies which bus to read from The default value is 0 function Specifies which function to read from The default value is 0 The prb command reads a byte from the specified address in the PCI configuration space for a device specified by the id If the motherboard does not support PCI then this command is not implemented If your system configuration supports multiple PCI buses use the parameters to specify the PCI device Use the pcishow command to view the available PCI devices DP264 gt prb 0 19 86 4 92 User Commands 8 April 1999 User Commands 4 4 78 preg Display General Purpose Registers The preg command displays the saved CPU general purpose
5. User Commands 4 89 User Commands DP264 gt pl 100000 00100000 C1000003 00000000 0010D910 00000000 s 00100010 2F880007 A49E0000 43C11405 40A11406 C 00100020 48807722 40C20406 B4DC82F0 B49C82F8 w H 00100030 B4BC8300 43C5153E B7FEO020 B3FC8308 C 00100040 D0000007 47E20404 D0001019 00000080 agate 00100050 47FFO41F 00000000 00000000 00000000 G 00100060 43C6153E B41E0028 D0000136 A49C8018 C 6 00100070 43E03405 D0000309 A49C8020 43E05405 4 C SC DP264 pl 100000 100000 00100000 C1000003 00000000 0010D910 00000000 4 90 User Commands 8 April 1999 User Commands 4 4 76 pq Display Memory Quadword Format Parameters Description Example 8 April 1999 The pq command displays the specified memory quadword 64 bit pq start address end address iterations silent start address Specifies a hexadecimal number that represents a legal address at which to start the dis play The default is the current address end address Specifies a hexadecimal number that represents a legal address at which to end the dis play The default is the current address plus 127 bytes iterations Specifies how many times the data is read The default is 1 silent Specifies whether or not the data is displayed Setting this field to 1 causes t
6. 8 April 1999 The flboot command downloads the specified file from the diskette and begins execu tion of that file flboot file address file Specifies the name of the file to access on the diskette address Specifies the address at which to load the file The default is the boot address The flboot command downloads the specified file into the specified address or the boot address The downloaded file automatically begins execution in PALmode as if a jtopal command had been entered DP264 gt flboot size2 High Density selected size2 20 bytes 11 21 1999 13 42 20 loading cluster 2 sector 33 buffer 200000 done Jumping to 0x200000 User Commands 4 53 User Commands 4 4 43 flcd Display or Change Working Directory or Drive Format Parameters Description Example 4 54 User Commands The fled command displays or changes the current working directory or drive fled drive_pathname drive_pathname Specifies the new drive and working directory The fled command allows you to change the current working directory for the current drive It can also be used to switch to a different default drive If no parameters are specified then the default drive and working directory are displayed Drives are specified by using the letters A through Z The path is a list of subdirectories separated by a slash for Tru64 UNIX users or a backslash for DOS users The top level directory known as the
7. The stop command sets a breakpoint at the specified address When a breakpoint is encountered all current register values are stored in memory and can be viewed with the preg and pfreg commands Example P264 gt stop 100000 P264 gt go xecuting at 0x100000 01 00 C1000003 P2 stop 100200 go ing at 0x100000 00 4A671793 64 gt cont 00200 4A671793 sra s simple program prints the various data types in bytes char shor int long floa double Alpha 21264 Version Bootadr br 64 Sra HOUOPDnHUUonutu 00 i0 Hs NE Evaluation Board D Fri Apr 09 20 50 11 0x100000 memSize 0 8 April 1999 r8 100010 IS 0x39 rl9 r19 size of 0x38 r19 P264 Debug Monitor EDT 1999 x2000000 User Commands 4 119 User Commands 4 4 100 sum Compute Checksum in Range The sum command computes the checksum of the data in the specified range Format sum start_address end_address Parameters start_address Specifies the address at which the checksum check begins end_address Specifies the address at which the checksum check ends Description The sum command prints the checksum of the data contained in the specified memory range The algorithm used computes a 16 bit checksum and is compatible with the stan dard BSD4 3 algorithm provided in most implementations of UNIX sum thus allow ing easy comparisons of images in the motherboard s memory with those on the
8. tip dev tty01 DP264 User Commands 4 71 User Commands 4 4 59 mces Set or Display Machine Check Error Summary The mces command sets or displays the machine check error summary register Format mces mces_data Parameters mces_data Specifies the value to be written to the machine check error summary register Description The machine check error summary register controls machine check and system correct able error handling The mces command provides direct user access to the rdmces and wrmces PALcode instructions that are defined by the Alpha Architecture Reference Manual This register is also affected by the mcheck command Example In the following example a zero is written to the machine check error summary regis ter DP264 gt mces Machine Check Error Summary 08 DP264 gt mces 0 Machine Check Error Summary 00 4 72 User Commands 8 April 1999 User Commands 4 4 60 mcheck Control Machine Checks The mcheck command controls the reporting of hardware error conditions machine checks Format mcheck state Parameters state on Enables all machine check reporting state off Disables all machine check reporting state system Enables machine check reporting for hardware errors detected external to the CPU state cpu Enables machine check reporting for hardware errors detected by the CPU Description The mcheck command controls the reporting of hardware error conditions A machine check ind
9. 10 06 99 10 05a DIR dir2 1048064 bytes free P264 fled dirl dir2 dirl dir2 P264 fldir dir3 igh Density selected 0 06 99 10 05a DIR 0 06 99 10 05a DIR Ur 4 28 99 05 50p 71 diff lst 1048064 bytes free OrPrPMmMUA YU DP264 gt fldir b High Density selected 09 07 99 10 28a 6688 srom 10 03 99 05 59p 202980 rom rom 1247232 bytes free User Commands 4 57 User Commands 4 4 46 flload Download File from Diskette The flload command downloads the specified file from the diskette Format flload file address Parameters file Specifies the name of the file to access on the diskette address Specifies the address at which to load the file The default is the boot address Description The flload command downloads the specified file into the specified address or the boot address The program can then be executed with the go or jtopal commands Example DP264 gt bootadr 00200000 DP264 gt flload size2 High Density selected size2 A 20 bytes 11 21 1999 13 42 20 loading cluster 2 sector 33 buffer 200000 done 4 58 User Commands 8 April 1999 User Commands 4 4 47 flread Read Logical Sectors from Diskette The flread command reads logical sectors from a diskette Format flread first sector bytes dest address iterations drive Parameters first sector Specifies the first
10. 16 0000000000000000 0000000000000000 0000000000000000 0000000000000000 20 0000000000000000 0000000000000000 0000000000000000 0000000000000000 24 0000000000000000 0000000000000000 0000000000000000 0000000000000000 28 0000000000000000 0000000000000000 0000000000000000 0000000000000000 PC 000000000000000D PS 000000000000000D 4 88 User Commands 8 April 1999 User Commands 4 4 75 pl Display Memory Longword Format Parameters Description Example 8 April 1999 The pl command displays the specified memory longword 32 bit pl start_address end_address iterations silent start_address Specifies a hexadecimal number that represents a legal address at which to start the dis play The default is the current address end_address Specifies a hexadecimal number that represents a legal address at which to end the dis play The default is the current address plus 127 bytes iterations Specifies how many times the data is read The default is 1 silent Specifies whether or not the data is displayed Setting this field to 1 causes the data to be read but not displayed The default is 0 data is displayed The pl command displays the specified memory in longword format If no address is specified then the current memory longword and the following 31 longwords are dis played The field displayed after the longword represents the translation of the memory contents in ASCII characters If the memory contents
11. The pwl command writes a longword 32 bits to an address in the PCI configuration space pwl pci address id data bus function pci address Specifies which address to write to id Specifies a decimal number that represents the slot assigned to the PCI device data Specifies the value that is written to the pci address bus Specifies which bus to write to The default value is 0 function Specifies which function to write from The default value is 0 The pwl command writes a longword to the specified address in the PCI configuration space for a device specified by the id If the motherboard does not support PCI then this command is not implemented If your system configuration supports multiple PCI buses use the parameters to specify the PCI device Use the pcishow command to view the available PCI devices DP264 gt pwl 4f 19 0000a6 3 User Commands 4 99 User Commands 4 4 84 pww Format Parameters Description Example Write Word to PCI Configuration Space The pww command writes a word 16 bits to an address in the PCI configuration space pww pci_address id data bus function pci_address Specifies which address to write to id Specifies a decimal number that represents the slot assigned to the PCI device data Specifies the value that is written to the pci_address bus Specifies which bus to write to The default value is 0 function Specifies which function to write from The defaul
12. silent Specifies whether or not the data is displayed Setting this field to 1 causes the data to be read but not displayed The default is 0 data is displayed Description The rl command reads a longword from the specified register in I O address space Example DP264 gt rl 370 0000A6F3 4 102 User Commands 8 April 1999 User Commands 4 4 87 rmode Set dis Command Register Display Mode The rmode command sets the dis command register display mode Format rmode mode Parameters mode Determines the mode If set 1 the software register names are displayed If cleared 0 the hardware register names are displayed The default is 0 Description The rmode command specifies whether hardware register names such as r16 or soft ware register names such as a0 are displayed with the dis command The following table displays the Tru64 UNIX Alpha microprocessor register usage Hardware Software Register Register Name Name Use and Linkage rO vO Used for expression evaluation and to hold integer function results r1 r8 t0 t7 Temporary registers not preserved across procedure calls r9 r14 s0 s5 Saved registers their values must be preserved across procedure calls r15 FP or s6 Frame pointer or a saved register r16 r21 a0 a5 Argument registers used to pass the first six integer type arguments their values are not preserved across proce
13. 746300A2 3D8 77FF0055 3DC 77FF0000 gt 4 104 User Commands subl sll mt mf lda sll bic and srl bic bis sll bis mt mt mt subl sll mt lda sll bic and srl bic bis sll bis mt mt mt r24 2 QC r3 p r4 2 r4 O r3 r 125 r24 r24 r24 r24 r2 r2 0x20 r2 4 2 r2 017 zero x2A r4 r3 0xl x25 x1B r24 ES X24 r3 A zero zero N ct OomN O0Q0oOo 2 0x1F r24 r25 r24 Ox2A r24 ES flushIc 0 1 t1 x20 t1 8 April 1999 User Commands 4 4 88 romboot Load and Execute Image from ROM Format Parameters Description Example 8 April 1999 The romboot command loads the specified image from ROM and begins execution romboot type address type Specifies the image to load into ROM If the type is specified as 0 then any header information is ignored and the entire contents of the ROM is loaded The default is to load and execute the first image in the system ROM address Specifies the starting address for loading the image into ROM The romboot command loads and executes the operating system and associated firm ware from the system ROM Use the romlist command to display the images contained in the ROM You can specify the type as a number or a name Type number Type name Description 0 DBM Alpha Motherboard Debug Monitor 1 NT Windows NT 2 VMS
14. FFFFFCO2C0000000 FFFFFC000006C1E0 0000000000FFDF40 0000000000000003 PC 000000000000000D PS 000000000000000D DP264 gt creg 04 555 DP264 gt preg General Purpose Registers register file 0000C040 x00 0000000000000020 0000000000000005 000000000000C000 000000000000000D r04 0000000000000555 0000000000000000 0000000000000000 000000000000000D r08 FFFFFC000005F470 0000000000027340 0444306453605341 0A110C485F6EA26E r12 208090EA6024C19C 882C08AA92065B2D 4100610AE100244F 9E2891ACA8A9D984 r16 0000000000100000 000000000000000D 0000000000000006 0000000000000030 r20 0000000E20026335 5619A46B2B1A5125 0000000000000000 000000000000000D r24 0000000000000003 0000000000000000 FFFFFC0000042C3C 0000000000100000 r28 FFFFFC02C0000000 FFFFFC000006C1E0 0000000000FFDF 40 0000000000000003 PC 000000000000000D PS 000000000000000D 8 April 1999 User Commands 4 25 User Commands 4 4 17 cw Edit Memory Words The cw command allows you to edit memory words 16 bit Format cw address Parameters address Specifies the address of the memory word you want to change Description The cw command allows you to modify the contents of the specified memory address If no address is specified then the next word is selected The Debug Monitor displays the address followed by the current data and a colon For example 00200090 101D To modify the contents of this memory location type the new data after the colon and press the Return key To end th
15. If the type specified is 0 then any header information is ignored and the entire contents of the ROM are compared If the type is n the nth image in the ROM will be used 2 is the second entry The default is to compare the first image in the system ROM address Specifies the starting address for comparing the image in the ROM The bootadr is the default The romverify command compares an image in memory to an image in the ROM Use the romlist command to display the images contained in the ROM You can specify the type as a number or a name ile loaded successfully Size 0x28380 P264 gt romverify dbm earching for the Alpha Evaluation Board omparing to image at 0x300000 mages match P264 gt romverify 0 300000 DHANUA 4 110 User Commands Type number Type name Description 0 DBM Alpha Motherboard Debug Monitor 1 NT Windows NT 2 VMS OpenVMS 3 UNIX Tru64 UNIX 7 LINUX Linux MILO 8 VXWORKS VxWorks 10 SROM Serial ROM DP264 gt romload 0 300000 Loading entire ROM Loading ROM to address 00300000 Loaded 1048576 bytes starting at 0x300000 to Ox3fffff DP264 gt romverify 0 Comparing entire ROM to image at 0x300000 Images match DP264 gt netload PC164dbm rom Attempting BOOTP Loading PC164dbm rom at 0x300000 y IP address 192 168 0 107 Server IP address 192 168 0 114 HAHAHA ERE 164736 Debug Monitor 8 April 1999 User Commands Searching fo
16. UserCommands eee dadas talar 4 8 apropos Display Help Descriptions oooooooocoocoorr ee 4 9 arpshow Display Known Address Resolution Protocol Entries 4 10 beep Test Speaker 2 0 eee teen eens 4 11 boot Download File Using XMODEM Protocol 0 0 00 cece eee eee 4 12 bootadr Display or Modify Default Boot Address 0 2 0 0 eese 4 13 bootopt Select Operating System and Firmware 00000 eee eaee 4 14 bpstat Display Breakpoint Status 0 0 0 0 0 cece eee 4 16 cb Edit Memory Bytes 0 0 0 eee e eee nn 4 17 cfreg Modify CPU Floating Point Register llle esses 4 18 cl Edit Memory LONgWoOrdS ooocoooccoc 4 19 cominit Initialize Communications Ports eese 4 20 compare Compare Memory Range 0 0 e eee e eene 4 21 cont Continue Execution from Breakpoint 00 0 cece eee eee 4 22 copy Copy Memory Block o oococooccccccocna eee 4 23 cq Edit Memory QUadWordS oococcocococ eee 4 24 creg Modify Register State 00 ketenes 4 25 cw Edit Memory Words iio o py Re ep TEE 4 26 date Display or Modify Date and Time 1 2 2 0 eee ee 4 27 ddmq Deposit Quadword in Memory 00 0 cee teas 4 28 delete Remove Breakpoint from Address oooooccocccoo ees 4 29 dis Disassemble Instructions 0 00 c cee ees 4 30 dmb Deposit
17. pcishow pwb help mces stop cont setbaud ereg eprom 8 April 1999 User Commands 4 4 53 iack Perform Interrupt Acknowledge Cycle The iack command performs an interrupt acknowledge cycle Format iack Parameters None Description The iack command allows you to perform an interrupt acknowledge cycle Two iack commands are required to read the interrupt vector Example DP264 iack FF DP264 iack 07 8 April 1999 User Commands 4 65 User Commands 4 4 54 ident Identify Revision of Files Format Parameters Description Example The ident command displays revision control system RCS ID strings found in the specified memory range ident start_address end_address start_address Specifies a hexadecimal number that represents a legal address at which to start search ing for RCS keywords The default value is the boot address end_address Specifies a hexadecimal number that represents a legal address at which to end the search for RCS keywords The default value is the boot address plus 70 6 The ident command identifies the revision of files used to build images that were loaded into memory by searching for all occurrences of the pattern keyword in the specified memory range This command is based on the assumption that RCS was used for version control on the source files on the host development system RCS is supplied with the Tru64 UNIX operating system DP264 gt ident 0 80000 I
18. 1019 D000 0080 0000 CHARTAS 00100050 041F 47FF 0000 0000 0000 0000 0000 0000 G 00100060 153E 43C6 0028 B41E 0136 D000 8018 A49C gt Cl 6 00100070 3405 43E0 0309 D000 8020 A49C 5405 43E0 4 C T C User Commands 4 97 User Commands 4 4 82 pwb Write Byte to PCI Configuration Space Format Parameters Description Example The pwb command writes a byte 8 bits to an address in the PCI configuration space pwb pci_address id data bus function pci_address Specifies which address to write to id Specifies a decimal number that represents the slot assigned to the PCI device data Specifies the value that is written to the pci_address bus Specifies which bus to write to The default value is 0 function Specifies which function to write from The default value is 0 The pwb command writes a byte to the specified address in the PCI configuration space for a device specified by the id If the motherboard does not support PCI then this com mand is not implemented If your system configuration supports multiple PCI buses use the parameters to specify the PCI device Use the pcishow command to view the available PCI devices DP264 gt prb 4f 19 3F DP264 gt pwb 4f 19 2f DP264 prb 4f 19 2F 4 98 User Commands 8 April 1999 User Commands 4 4 83 pwl Write Longword to PCI Configuration Space Format Parameters Description Example 8 April 1999
19. 280 68 DP264 gt rb 280 68 User Commands 4 127 User Commands 4 4 108 wl Write Longword to I O Space The wl command writes a longword 32 bits to a register port in I O address space Format wl register data iterations Parameters register Specifies which register to write to data Specifies the value that is written to the register iterations Specifies how many times the data is read The default is 1 Description The wl command writes a longword to the specified register in I O address space Example DP264 gt wl 370 0000a6f3 4 128 User Commands 8 April 1999 User Commands 4 4 109 wrfen Write Floating Point Enable The wrfen command enables or disables floating point Format wrfen value Parameters value Specifies a value of 0 or 1 that is written into the processor s floating point enable reg ister Description The wrfen write floating point enable command writes bit zero of the value passed to the floating point enable register in the CPU The value of FEN is also updated to the PCB Example DP264 gt wrfen 1 8 April 1999 User Commands 4 129 User Commands 4 4 110 ww Write Word to I O Address Space The WW command writes a word 16 bits to a register port in I O address space Format ww register data iterations Parameters register Specifies which register to write to data Specifies the value that is written to the register iterations Specifies how many t
20. 45 69 gateway IP address 16 123 45 69 Loading from users eval boot size EH DP264 gt stop 200000 DP264 gt go Executing at 0x200000 00200000 23DEFFFO lda sp 16 sp DP264 gt ladebug Ethernet Base Address 360 DMA Mask 1 DRO5 Init Block Address 100000 Init Done Client connected client is FFFFFFFFA0107F10 The following command entered from the host system starts Ladebug and causes it to connect to the DP264 ladebug size out rn dp264 pid 0 Welcome to the Ladebug Debugger Version 1 3 1 object file name size out machine name dp264 process id O0 Reading symbolic information done Connected to remote debugger ladebug The ladebug inthe previous example is the Ladebug prompt You are now ready to debug a process that is running on the DP264 To end this session and return to the Debug Monitor command prompt use the Ladebug quit command to disconnect from the server Refer to the Ladebug documentation for more information about how to run Ladebug 8 April 1999 Remote Debugging 3 5 4 1 Overview 8 April 1999 This chapter describes how to use the Alpha Microprocessors Motherboard Debug Monitor commands 4 User Commands The Debug Monitor supports advanced command line editing including cursor key movements and an Emacs like editing interface In addition a history buffer has been added to facilitate repetition of commands Table 4 1 shows the command
21. 52 flboot 4 53 fled 4 54 flcopy 4 56 fldir 4 57 flload 4 58 flread 4 59 flsave 4 60 flwrite 4 61 fwupdate 4 62 Index 2 G Getting started 2 1 go 2 8 4 63 H Hardware requirements 2 1 help 4 64 Host system 2 3 lack 4 65 ident 4 66 init 4 67 Introduction 1 1 J jtopal 2 8 4 68 K Kernel stack 2 7 L Ladebug 2 5 3 1 command 4 69 command line options 3 3 starting a session 3 4 load 2 3 4 71 Loading a file from diskette 4 53 4 58 Loading a program 2 7 Machine check 4 73 mces 4 72 mcheck 4 73 Memory map 2 6 Memory regions 2 7 memtest 4 75 mrb 4 76 mrl 4 77 mrw 4 78 mt 4 79 mwb 4 80 8 April 1999 mwl 4 81 mww 4 82 N netboot 2 3 4 83 netload 2 3 4 84 next 4 85 O Operating system requirements 2 1 P PALcode environment 3 3 PALcode guidelines 3 3 Path 4 54 4 57 pb 4 86 PC connecting to 2 2 pcishow 4 87 Personal computer 2 2 pfreg 4 88 pl 4 89 pq 4 91 prb 4 92 preg 4 93 prl 4 94 Programmable memory regions 2 7 prw 4 95 pw 4 97 pwb 4 98 pwl 4 99 pww 4 100 R rb 4 101 Recommended host system 1 1 Remote debug server 3 1 Remote debugger definition of 3 1 Remote debugging 2 5 3 1 command line options 3 3 executable file 3 4 guidelines 3 1 8 April 1999 Requirements host system 2 1 Reset 2 8 rl 4 102 rmode 4 103 romboot 4 105 roml
22. 79 FFFF 80 E810 81 FFFF 82 0000 83 FFFF 84 0038 85 0008 86 F000 87 FFFF 88 3003 89 2000 90 FFFF 91 FFFEF 92 FFFE 93 FFFE 94 0235 95 FFFF 96 1308 97 8308 98 F9CO 99 0235 100 FFFE 101 FFFF 102 FFFF 103 FFFF 104 0000 105 0202 106 FFFF 107 FFFF 108 8000 109 0235 110 FFFF 111 FFFF 112 0000 113 FFFF 114 0042 115 FFFF 116 FFFF 117 FFFEF 118 FFFF 119 FFFF 120 FFFF 121 FFFF 122 FFFF 123 FFFEF 124 FCOO 125 FFFF 126 0000 Ethernet Controller ISACSRO 0 0005 110005 20003 30000 140000 5 0084 6 0008 7 0090 4 44 User Commands 8 April 1999 User Commands 4 4 36 eshow Display Ethernet Devices The eshow command displays all of the registered Ethernet devices Format eshow Parameters None Description The eshow command displays all of the installed device drivers and works for all of the motherboards To set the Debug Monitor to use one of these devices see the edevice command An asterisk following the net device number indicates the selected Ethernet device to be used by the Debug Monitor Ethernet commands Example DP264 gt eshow All registered Ethernet devices Net Type Device 0 AM79C960 I WD3003 2 Alpha 21340 3 Alpha 21340 8 April 1999 User Commands 4 45 User Commands 4 4 37 estat Display Ethernet Statistics The estat command displays Ethernet statistics Format estat Parameters None Description The estat command displays Ethernet statistics kept by the Ethernet device driver Example D
23. April 1999 The Sq command searches memory by quadwords 64 bit sq start_address end_address string inverse start_address Specifies the address at which to begin the search end_address Specifies the address at which to end the search string Specifies the search string inverse Specifies whether to search for a matching string 0 or a nonmatching string 1 The default is O search for a matching string The sq command searches memory by quadword chunks for the specified string You can use an asterisk as a wildcard character for single character matching DP264 gt pq 00000000 00000000C3E00007 0000000000000000 00000010 0000000000000000 0000000000000000 00000020 26100002221F0000 000000006BF00000 amp k 00000030 0000000000000000 0000000000000000 00000040 0000000000000000 0000000000000000 00000050 0000000000000000 0000000000000000 00000060 0000000000000000 0000000000000000 00000070 0000000000000000 0000000000000000 DP264 gt sq 100000 100080 2 val 2 mask FFFFFFFFFFFFFFFF value not found DP264 gt sq 100000 100080 26100002221F0000 value 26100002221F0000 mask FFFFFFFFFFFFFFFE occurrence at 00000020 26100002221F0000 User Commands 4 117 User Commands 4 4 98 step Execute Next Instruction Format Parameters Description Example The step
24. April 1999 User Commands 4 55 User Commands 4 4 44 flcopy Copy File Format Parameters Description Example The flcopy command copies a file to another location flcopy source file destination file source file Specifies the file to be copied If no drive and path are specified the default drive and path are used destination file Specifies the name of the copied file If no drive and path are specified the default drive and path are used Note that a destination file name must always be specified even if copying to a subdirectory The flcopy command allows you to copy a file to another destination An optional drive and path specification may be specified for either the source or destination file name If they are not specified then the default drive and path are used DP264 fled dir3 a dir3 DP264 gt fldir High Density selected 10 06 99 10 05a lt DIR gt 10 06 99 10 05a lt DIR gt e 04 28 99 05 50p TA difflbst 1048064 bytes free P264 flcopy diff lst dirl dir2 diff2 1st igh Density selected opying files e P264 fldir NdirlNdir2N igh Density selected 0 06 99 10 05a DIR 0 06 99 10 05a DIR sce 0 06 99 10 48a 71 diff2 1st 1047552 bytes free DP264 gt flcopy diff lst b diff2 1st High Density selected High Density selected Copying files Done DP264 fldir b High Density selected O 3 r2 p HPILHUUQORmU 09 07 99 10 28a 6688 srom 10
25. Boldface type Indicates Debug Monitor command text DP264 gt Indicates the motherboard command prompt Italic type Emphasizes important information indicates variables in command syntax and denotes complete titles of documents Indicates an operating system command a file name or a Monospaced TYDS directory path name All numbers are decimal unless otherwise indicated Where there is ambiguity numbers other than decimal have a subscript indicating their base x 8 April 1999 1 Introduction 1 1 Overview The Alpha Microprocessors Motherboard Debug Monitor can be used to load code into the system and perform other software debug functions such as memory read write and instruction breakpointing You can develop your code on a host system and load the software into the motherboard through a serial port Ethernet port user supplied floppy drive or the extra ROM socket The full source code is provided with a free license allowing you to use and modify this code as you desire 1 2 General Features The Debug Monitor offers the ability to Download files via serial and Ethernet ports ROM socket and user supplied floppy drive e Examine and deposit the motherboard system register CPU internal processor reg isters IPRs and I O mapped registers Examine and modify DRAM and I O mapped memory e Disassemble CPU instructions in memory e Transfer control to programs loaded into memory e Perfo
26. Byte of Data in Memory eee 4 31 dml Deposit Longword of Data in Memory oooccoccocoo eee 4 32 dmq Deposit Quadword in Memory 000 eect eee ee 4 33 dmw Deposit Word in Memory 00 cee tees 4 34 ebuff Set Memory Address for Ethernet Buffers 000 cee eee eee 4 35 edevice Set Debug Monitor to Use Ethernet Device 0 0 200s 4 36 edmp Set Display of PacketS oooococoocccococnnnc eens 4 37 einit Initialize Ethernet Controller oooocococccoccocoocor 4 38 emb Specify Display of Data o ooooccccococncr eee 4 39 eml Specify Display of Data ooooococcccocrnn ee 4 40 emq Display Quadword in Memory ssssses eee 4 41 emw Display Word in Memory 00 cee eee ett 4 42 eprom Set Flag for Receiving PacketS 00 0 cece eee eee eee 4 43 ereg Display Ethernet Controller Registers llle lees 4 44 eshow Display Ethernet Devices 0 0 tees 4 45 estat Display Ethernet Statistics 0 2 00 cece eee 4 46 estop Stop Ethernet Controller llli ee 4 47 fill Specify Address for Fill Value lisse 4 48 flash Program Data into Flash Memory 0 00 e eee B 4 49 flasherase Erase Data from Flash Memory oooooccocccoo eese 4 52 flboot Download and Execute File from Diskette ooo ooooooooomo 4 53 fled Di
27. bootadr 4 13 bootopt 4 14 BOOTP 4 83 BOOTP server setting up 2 3 verification of 2 4 bootptab 4 83 4 84 bpstat 4 16 C cb 4 17 cfreg 4 18 cl 4 19 cominit 4 20 Command features 1 1 Command interface features 4 1 Command line editing 4 1 Command overview 4 1 Command quick reference 4 3 Commands usage of 4 2 Communication ports 2 1 2 2 8 April 1999 Index compare 4 21 Configuring the system 2 1 Connecting to a PC 2 2 Connecting to a serial port 2 3 Connecting to a system for Tru64 UNIX 2 2 Connecting to a system for Windows NT 2 2 Connecting to a terminal 2 1 cont 4 22 Conventions of document x copy 4 23 cq 4 24 creg 4 25 cw 4 26 D Daemon log file 2 4 date 4 27 ddmq 4 28 Debug Monitor commands 4 8 Debug Monitor firmware installing 2 5 Debugger definition of 3 1 Debugging hints 3 1 delete 4 29 dis 4 30 Diskette 2 7 DMA buffers 2 7 dmb 4 31 dml 4 32 dmq 4 33 dmw 4 34 Index 1 Document audience ix conventions x structure ix Documentation ordering A 1 Downloading files 2 7 Drive 4 54 4 57 E ebuff 4 35 edevice 4 36 edmp 4 37 einit 4 38 emb 4 39 eml 4 40 emq 441 emw 4 42 Environment for PALcode 3 3 eprom 4 43 ereg 444 eshow 4 45 estat 4 46 estop 4 47 Ethernet 2 7 Execution commands 2 8 F Features 1 1 of command interface 4 1 fill 448 flash 4 49 flasherase 4
28. can be translated to an ASCH character then that character is displayed otherwise a dot is displayed The silent and iterations fields are often used together to continuously perform read operations thus avoiding slowdowns caused by displaying the data The repeating cycles can be monitored with test equipment This example displays memory longwords DP264 pl 0 00000000 E7E01021 00000000 00000000 00000000 006 00000010 00000000 00000000 00000000 00000000 sss 00000020 E7E01095 00000000 00000000 00000000 s s 00000030 00000000 00000000 00000000 00000000 ss 00000040 00000000 00000000 00000000 00000000 s s 00000050 00000000 00000000 00000000 00000000 00000060 00000000 00000000 00000000 00000000 sss 00000070 00000000 00000000 00000000 00000000 sss DP264 pl 00000090 00000000 00000000 00000000 00000000 sss 000000A0 00000000 00000000 00000000 00000000 ss 00000080 00000000 00000000 00000000 00000000 ss 000000C0 00000000 00000000 00000000 00000000 ss 000000D0 00000000 00000000 00000000 00000000 sss 000000E0 74420082 644200A9 74210081 64210024 Bt Bd t d 000000F0 48405682 F0400013 E4400003 77DEOO9E V H w 00000100 67DEO09F 44205401 47E09402 744200A9 g T D G Bt
29. command executes the next instruction s tep None Use the step command and the next command to execute a machine instruction When the instruction contains a subroutine call the step command steps into the subroutine being called and the next command executes that subroutine In the following example the step command used at address 00200034 steps to the first instruction of the subroutine being called at address 002000c0 The next command used at address 002000ec executes the subroutine being called and steps to the next instruc tion at address 002000f0 DP264 gt dis 00200030 a77d8010 ldq r27 32784 r29 00200034 605504000 jsr r26 r27 00200038 27ba0001 ldah r29 1 r26 0020003c 23bdc148 lda r29 49480 r29 DP264 gt step 00200030 a77d8010 ldq r27 32784 r29 DP264 gt step 00200034 605504000 jsr r26 r27 DP264 gt step 002000c0 275050001 ldah r29 1 r27 DP264 dis 002000e8 a77d8040 ldq r27 32832 r29 002000ec b6b5b46b8 jsr r26 r27 002000f0 27ba0001 ldah r29 1 126 DP264 gt step 002000e8 a77d8040 ldq r27 32832 29 DP264 gt step 02000ec 6b5b46b8 jsr r26 r27 DP264 gt next 002000f0 27ba0001 ldah r29 1 126 DP264 4 118 User Commands 8 April 1999 4 4 99 stop Set Breakpoint User Commands The stop command sets a breakpoint Format stop address Parameters address Specifies the address at which the breakpoint is set Description
30. command with the PALbase address Example DP264 gt init Stopping network device 0 in PCI slot 18 Jumping to 0x000000 Starting Debug Monitor 8 April 1999 User Commands 4 67 User Commands 4 4 56 jtopal Set to PALmode and Execute Instructions The jtopal command sets the environment to PALmode and begins execution of instructions at the specified address Format jtopal start_address Parameters start_address Specifies the address at which to start executing instructions The default is the boot address Description The jtopal command emulates the hardware mechanism for entering PALcode When instructions contain PALcode you must set the environment to PALmode to properly execute instructions This command is required for executing downloaded images entered in PALmode such as a serial ROM or debug ROM image The jtopal com mand sets the environment to PALmode and then jumps to the specified location in memory to begin executing instructions Example This example starts executing instructions at address 10000056 DP264 gt jtopal 100000 4 68 User Commands 8 April 1999 User Commands 4 4 57 ladebug Start Ladebug Remote Debugger Format Parameters Description Example 8 April 1999 The ladebug command starts the Ladebug server for a remote debug session ladebug None The ladebug command configures the motherboard as a remote debugger target You ca
31. jtopal See Chapter 4 for more details about these commands 2 8 Resetting the Debug Monitor If the software hangs the motherboard then the hardware reset on the board can be used to reset to the Debug Monitor command line For information about connecting the reset signals see your motherboard s user s manual 2 8 Getting Started 8 April 1999 3 Remote Debugging The Debug Monitor supports remote debugging for Tru64 UNIX host systems with Ladebug The Ladebug software provides the full source level debugging capabilities of most programs that run on the motherboard including the Debug Monitor This chapter describes some debugging hints to use with the Debug Monitor and the remote debugger This chapter also describes the guidelines for writing programs that allow you to take full advantage of remote debugging 3 1 What Is a Debugger A debugger is a tool that helps you locate run time programming errors or bugs You use the debugger on executable programs created when a program has been compiled and linked successfully 3 2 What Is a Remote Debugger A remote debugger is a tool that helps you locate run time programming errors or bugs in a program running on a remote system The remote system can be a system that can not support a full programming environment by itself You use a remote debugger on executable programs compiled and linked for the remote system 3 3 Remote Debug Server The Debug Monitor s remote debu
32. line editing keypad Table 4 1 Command Line Editing Keypad Keys Description period Repeats the last command entered Nup arrow Scrolls up older entries the history buffer Ctri P i down arrow Ctrl N Scrolls down newer entries the history buffer lt left arrow Ctrl B Moves the cursor one character to the left gt right arrow Ctrl F Moves the cursor one character to the right Backspace Deletes the character preceding the cursor Delete Ctrl H Ctrl D Deletes character at cursor position Ctrl K Deletes text from cursor to end of line Ctrl R Refreshes the current line Ctrl U Erases the current line of command text End Moves to the end of the line Ctrl E Esc B Moves the cursor to the previous word Esc Backspace Deletes the previous word Esc DELETE Esc D Deletes the next word User Commands Using the Commands Table 4 1 Command Line Editing Keypad Continued Keys Description Esc F Moves the cursor to the next word Home Moves to the beginning of the line Ctrl A Insert Toggles between insert and overwrite mode Return Enters the current command Ctrl J Ctrl M Mf you connected to the motherboard through the Tru64 UNIX t ip command you must press Ctrl P twice to obtain the normal effect of Ctrl P This key requires that the keyboard be connected directly to the motherboard 4 2 Usin
33. logical sector of diskette to read The default is sector O the boot sec tor bytes Specifies the number of bytes to be read from the diskette The default sector is one sec tor dest address Specifies the beginning address where data will be loaded The default is the boot address iterations Specifies the number of times to repeat the reading of the sector range The default is 1 drive Specifies the diskette drive number to use 0 or 1 The default is 0 Description The flread command reads the data from the specified logical sectors of a diskette into memory The iterations parameter can be used to repeat the task a specified number of times Example DP264 flread 1 High Density selected Reading 0 bytes to 0x300000 starting at sector 1 Done 512 0X200 bytes transferred DP264 gt flread 1 1500 High Density selected Reading 1500 bytes to 0x300000 starting at sector 1 Done 1536 0X600 bytes transferred DP264 flread 1 1500 400000 High Density selected Reading 1500 bytes to 0x400000 starting at sector 1 Done 1536 0X600 bytes transferred DP264 flread 1 1500 400000 3 High Density selected Reading 1500 bytes to 0x400000 starting at sector 1 Done 1536 0X600 bytes transferred 2 iterations remaining Done 1536 0X600 bytes transferred 1 iterations remaining Done 1536 0X600 bytes transferred 8 April 1999 User Commands 4 59 User Commands 4 4 48 flsave Write Memory Range to File The flsave comm
34. map Figure 2 1 Debug Monitor Memory Map lt Top of Main Memory 8KB Guard Page X Top of Stack Stack 0x300000 Default Boot Address bootadr 0x200000 DMA Buffers 0x100000 DMA Buffer Base Debug Monitor Kernel 0x10000 Debug Monitor Entry Debug Monitor PALcode 0x0 PALcode Base Address FM 05670 Al4 2 6 Getting Started 8 April 1999 2 5 1 Stack Downloading Files The Debug Monitor image consists of PALcode at physical address 0 and the Debug Monitor kernel at physical address 10000 6 After loading the image into memory the SROM initialization code begins execution of the image in PALmode at the PALcode base address The PALcode used in the Debug Monitor was designed to support Tru64 UNIX and was later adapted to the Debug Monitor Refer to the Alpha Architecture Reference Manual and the PALcode for Alpha Microprocessors System Design Guide for more information about Tru64 UNIX PALcode PALcode starts execution of the Debug Monitor kernel at physical address 10000 Upon entry to the Debug Monitor kernel the Debug Monitor establishes the initial stack pointer at the first 8KB boundary below the top of main memory From there the stack grows downward 2 5 2 DMA Buffers Various devices used with the motherboard require direct memory access DMA The device drivers provided in the Debug Monitor for these devices are designed to perform their DMA within a 1MB range st
35. multiple PCI buses use the parameters to specify the PCI device Use the pcishow command to view the available PCI devices DP264 gt pcishow PCI Address Mapping windows are 1 PCI Base 0x00100000 Size 0x00100000 Translated Base 0x00100000 Bus 0 primary 0 secondary 0 subordinate 1 PCI I O space 1000 PCI Mem space 100000 PCI I O base B000 PCI Mem base 200000 PCI slot 17 vendor Ox1011 device 0x1 PCI IO Base 0x0 PCI IO Size 0x0 PCI Mem Base 0x0 PCI Mem Size 0x0 PCI PCI bridge PCI slot 19 vendor 0x8086 device 0x484 PCI IO Base 0x0 PCI IO Size 0x0 PCI Mem Base 0x0 PCI Mem Size 0x0 on VGA compatible device Bus 1 primary 0 secondary 1 subordinate 1 PCI I O space 1000 PCI Mem space 100000 PCI I O base B000 PCI Mem base 200000 PCI slot 6 vendor 0x1011 device 0x2 PCI IO Base OxB000 PCI IO Size 0x80 PCI Mem Base 0x200000 PCI Mem Size 0x80 Ethernet controller User Commands 4 95 User Commands DP264 gt prw 0 6 1 1011 DP264 gt prw 0 19 8086 4 96 User Commands 8 April 1999 User Commands 4 4 81 pw Display Memory Word Format Parameters Description Example 8 April 1999 The pw command displays the specified memory word 16 bit pw start_address end_address iterations silent start_address Specifies a hexadecimal number that represents a legal address at which to start the dis play T
36. register state Format preg address Parameters address Specifies an alternate address for the saved state area Description The preg command displays the contents of the CPU general purpose registers stored in the saved state area A register state is stored when a breakpoint is encountered or the PALcode reset flow is entered Example DP264 gt preg General Purpose Registers register file 0000C040 x00 0000000000000020 0000000000000005 000000000000C000 000000000000000D r04 00000000000003F8 0000000000000000 0000000000000000 000000000000000D r08 FFFFFCOO00005F470 0000000000027340 0444306453605341 0A110C485F6EA26E r12 208090EA6024C19C 882C08AA92065B2D 4100610AE100244F 9E2891ACA8A9D984 r16 0000000000100000 000000000000000D 0000000000000006 0000000000000030 r20 0000000E20026335 5619A46B2B1A5125 0000000000000000 000000000000000D r24 0000000000000003 0000000000000000 FFFFFC0000042C3C 0000000000100000 r28 FFFFFC02C0000000 FFFFFC000006C1E0 0000000000FFDF40 0000000000000003 PC 000000000000000D PS 000000000000000D 8 April 1999 User Commands 4 93 User Commands 4 4 79 pri Read Longword from PCI Configuration Space Format Parameters Description Example The prl command reads a longword 32 bits from the specified address in the PCI con figuration space prl pci address id bus function pci address Specifies
37. root directory is represented by a slash or backslash A path can be an absolute or relative path An absolute path begins with the root directory whereas a relative path begins with the current working directory Subdirectory entries also contain two special entries that can be used to specify a path One period represents the current directory and two periods represent the direc tory above the current level P264 gt flcd EN P264 fldir i Density selected 0 04 99 02 07p 0 04 9999 02 08p 0 06 99 10 05a 0 06 99 10 05a 203088 rom cmp 203140 rom rom dirl dir3 bytes free lt DIR gt lt DIR gt 1048576 PEePRREu u Q gt P264 gt fled dirl NdirlN P264 fldir igh Density 0 06 99 10 0 06 99 10 0 06 99 10 selected 05a 05a 05a lt DIR gt lt DIR gt lt DIR gt 1048576 Rrrernuyu dir2 bytes free P264 fled dirl dir2 dirl dir2 P264 gt fldir igh Density selected 0 06 99 10 05a 0 06 99 10 05a lt DIR gt lt DIR gt 1048576 r2 n uumotu bytes free P264 fled dir3 sNdirINdEir2N N esNdrr3N P264 fldir igh Density 0 06 99 10 0 06 99 10 4 28 99 05 selected 05a 05a 50p lt DIR gt lt DIR gt OrPrFRTUAYNU diff lst bytes free 71 1048576 P264 flcd b EN P264 fldir CoU 8 April 1999 User Commands High Density selected 09 07 99 10 28a 6688 srom 10 03 99 05 59p 202980 rom rom 1247232 bytes free 8
38. software running on a PC can also be used to communicate with the motherboard To connect the motherboard to a PC connect the terminal communication line to serial port 1 of the motherboard as described for the ter minal 2 3 3 Connecting from a System Running Windows NT A system running the Windows NT operating system supports serial communication with the motherboard To configure a COM port follow these steps 1 Choose the Program Manager icon 2 Choose the Accessories icon 3 Choose the Terminal icon 4 Set the following terminal characteristics Terminal Setting Value Data bits 8 bit Transmit receive speed 9600 baud Character format No parity Stop bits 1 Save these settings in a file For example settings for the DP264 could be saved in a file called dp264 t rm For consistency all examples and command descriptions assume that the motherboard serial port 1 is connected to COMI 2 3 4 Connecting from a System Running Tru64 UNIX Tru64 UNIX supports serial communications and Ethernet communications with the motherboard An Alpha system running the Tru64 UNIX operating system supports serial communi cation through the following two ports that can be connected to the motherboard e dev ttyOO e dev tty01 For consistency all examples and command descriptions assume that the motherboard serial port 1 is connected to port dev tty00 2 2 Getting Started 8 April 1999 Configuring Y
39. stop drivers Specifies if device drivers should be stopped before the start of the memory test A non zero value stops all device drivers A zero value specifies that drivers should not be stopped The default is stopped The memtest command performs a set of memory tests on the specified address range This test uses longword accesses to memory The tests include walking 1s and walking Os as well as alternating 1s and Os While conducting the memory test correctable read data errors may be encountered indicating memory integrity problems However if hardware error reporting is dis abled the CPU corrects the correctable errors without reporting them To alleviate this problem the mcheck parameter must specify the machine check conditions while run ning the memory test Device drivers that use main memory for DMA access while the memory test is running may cause unpredictable results To prevent the memory test from conflicting with the device drivers the stop drivers parameter must be set to a nonzero value DP264 memtest 2 8000000 8ffffff 4 on 1 User Commands 4 75 User Commands 4 4 62 mrb Display Byte from Memory I O Space The mrb command reads a byte from memory in the register port in I O address space Format mrb address iterations silent Parameters address Specifies the address in memory I O space iterations Specifies how many times the data is read The default is 1 silent Specifies whether or not t
40. the address in PCI space id Specifies a decimal number that represents the slot assigned to the PCI device bus Specifies which bus to read from The default value is 0 function Specifies which function to read from The default value is 0 The prl command reads a longword from the specified address in the PCI configuration space for a device specified by the id If the motherboard does not support PCI then this command is not implemented If your system configuration supports multiple PCI buses use the parameters to specify the PCI device Use the pcishow command to view the available PCI devices DP264 gt prl 0 19 04848086 4 94 User Commands 8 April 1999 User Commands 4 4 80 prw Read Word from PCI Configuration Space Format Parameters Description Example 8 April 1999 The prw command reads a word 16 bits from the specified address in the PCI config uration space prw pci_address id bus function pci_address Specifies the address in PCI space id Specifies a decimal number that represents the slot assigned to the PCI device bus Specifies which bus to read from The default value is 0 function Specifies which function to read from The default value is 0 The prw command reads a word from the specified address in the PCI configuration space for a device specified by the id If the motherboard does not support PCI then this command is not implemented If your system configuration supports
41. the address of the debug entry point through the installation of the new PALcode For the motherboard PALcode this address is held in the PAL temporary register with symbolic name ptEntDbg The user defined PALcode must also either preserve the address of the interrupt entry point ptEntInt or set the IPL to a level that prevents all interrupts until the program sets up its own interrupt handler containing a callto 1adbx poll 3 5 Ladebug Command Line Options 8 April 1999 Versions 1 3 or later of Ladebug provide the command line options shown in Table 3 1 to support remote debugging Table 3 1 Ladebug Command Line Options Command Line Option Description rn node name Specifies IP node name of the target node Required for remote debug No default pid process id Specifies the process id of the process to be debugged The Ladebug software debugs a running process rather than loading a new process rfn arbitrary string Specifies the file name or other identifier of the image to be loaded on a remote system Defaults to the local object file name Passed to the remote system uninterrupted Will often have to be quoted to avoid shell command line interpretation on the local system Can be used only with rn do not combine with pid Remote Debugging 3 3 Building the Executable File Table 3 1 Ladebug Command Line Options Continued Command Line Option Description rinsist Connec
42. to the new specified address copy start_address end_address destination start_address Specifies the starting address for this copy end_address Specifies the last address to be included in this copy destination Specifies the new starting address for the memory range The copy command copies the data from the specified block of memory to a new loca tion in memory The original location is unchanged This example displays the original location and the destination before and after the copy command DP264 gt pl 8000000 08000000 1F1F1F1F 1F1F1F1F 1F1F1F1F 1FIFIFIF ees 08000010 1F1F1F1F 1F1F1F1F 1F1F1F1F 1FIFIFIF ss 08000020 1F1F1F1F 1F1F1F1F 1F1F1F1F 1FIFIFIF o o o 08000030 1F1F1F1F 1F1F1F1F 1F1F1F1F 1FlFlFlF o o 08000040 1F1F1F1F 1F1F1F1F 1F1F1F1F 1FIFIFIF o 08000050 1F1F1F1F 1F1F1F1F 1F1F1F1F 1FIFIFIF 08000060 1F1F1F1F 1F1F1F1F 1F1F1F1F 1FIFIFIF oo o 08000070 1F1F1F1F 1F1F1F1F 1F1F1F1F 1FIFIFIF o o o DP264 gt pl 9000150 09000150 00000000 00000000 00000000 00000000 sss 09000160 00000000 00000000 00000000 00000000 sess 09000170 00000000 00000000 00000000 00000000 sss 09000190 00000000 00000000 00000000 00000000 sss 090001A0 00000000 00000000 00000000 00000000 sess 090001B0 00000000 00000000 00000000 00000000 s
43. 0000000000000 0000000000000000 28 0000000000000000 0000000000000000 0000000000000000 0000000000000000 PC 000000000000000D PS 000000000000000D 4 18 User Commands 8 April 1999 User Commands 4 4 10 cl Edit Memory Longwords Format Parameters Description Example 8 April 1999 The cl command allows you to edit memory longwords 32 bit cl address address Specifies the address of the memory longword you want to change The cl command allows you to modify the contents of a specified memory address If no address is specified then the next longword is selected The Debug Monitor displays the address followed by the current data and a colon For example 00200090 E7E0101D To modify the contents of this memory location type the new data after the colon and press the Return key To end the editing of memory locations type any nonalphanumeric character except a period The nonalphanumeric character can be typed after the modified byte on the same line To leave the current location unchanged press the Return key on an empty line In this example the memory data at address 0 has been modified from 91E01122 to E7E01021 DP264 gt cl 0 00000000 91E01122 e7e01021 DP264 pl 0 0 00000000 E7E01021 00000000 00000000 00000000 008 User Commands 4 19 User Commands 4 4 11
44. 020122 subl r24 r2 r2 000243A4 48441722 sll r2 0x20 r2 000243A8 74420050 mt B2 000243AC 64630082 mf ES y piEZ 000243B0 209F07E1 lda r4 2017 zero 000243B4 48855724 sll r4 Ox2A r4 000243B8 44640103 bic E235 147 13 000243BC 47203019 and 429 7 Ox UD 120 DP264 gt dis 000243C0 4B037698 srl r24 0x1B r24 000243C4 4703F118 bie r24 0x1F r24 000243C8 47190418 bis r24 r25 r24 000243CC 4B055738 sll r24 0x2A r24 000243D0 44780403 bis r3 r24 r3 000243D4 746300A2 mt r3 A2 000243D8 7TTFF0055 mt zero flushIc 000243DC 7T7FF0000 mt zero 0 DP264 4 30 User Commands 8 April 1999 User Commands 4 4 22 dmb Deposit Byte of Data in Memory Format Parameters Description Example 8 April 1999 The dmb command deposits the specified byte of data in the specified memory loca tion dmb address data iterations address Specifies the memory address data Specifies the longword of data to be stored iterations Specifies how many times the command is executed The default is 1 The dmb command deposits the specified byte of data in the specified memory loca tion A memory barrier MB instruction is executed after the store to force the stored data out of the chip DP264 gt dmb d0000 FCO4FFOO User Commands 4 31 User Commands 4 4 23 dml Deposit Longword of Data in Memory The dml command deposits the specified longword of data in the specified memory location Format dm
45. 03 99 05 59p 202980 rom rom 10 06 99 10 53a 71 diff2 1st 1246720 bytes free 4 56 User Commands 8 April 1999 User Commands 4 4 45 fldir Display File Listing Format Parameters Description Example 8 April 1999 The fldir command displays a list of files in the current or specified directory fldir drive pathname drive pathname Specifies the drive or subdirectory The fldir command displays a directory of files in the current or specified directory Drives are specified by using the letters A through Z The path is a list of subdirectories separated by a slash for Tru64 UNIX users or a backslash for DOS users The top level directory known as the root directory is represented by a slash or backslash Y A path can be an absolute or relative path An absolute path begins with the root directory whereas a relative path begins with the current working directory Subdirectory entries also contain two special entries that can be used to specify a path One period represents the current directory and two periods represent the direc tory above the current level DP264 gt flcd a DP264 gt fldir High Density selected 10 04 99 02 07p 203088 rom cmp 10 04 99 02 08p 203140 rom rom 10 06 99 10 05a lt DIR gt dirl 10 06 99 10 05a lt DIR gt dir3 1048064 bytes free DP264 gt fldir dirl High Density selected 10 06 99 10 05a lt DIR gt 10 06 99 10 05a lt DIR gt EM
46. 1 or specify 2 for serial port 2 Example In this example the host system is connected to serial port 1 DP264 gt tip 1 4 124 User Commands 8 April 1999 User Commands 4 4 105 version Display Debug Monitor Firmware Version The version command displays the current Debug Monitor firmware version information Format version Parameters None Description The version command displays the current Debug Monitor firmware version informa tion This information is also displayed in the banner when you power up the mother board Example DP264 gt version Wed Feb 10 19 52 24 EST 1999 8 April 1999 User Commands 4 125 User Commands 4 4 106 vinit Initialize Video Controller The vinit command initializes the video controller Format vinit Parameters None Description The vinit command initializes the video controller Example DP264 gt vinit 4 126 User Commands 8 April 1999 User Commands 4 4 107 wb Write Byte to I O Address Space Format Parameters Description Example 8 April 1999 The wb command writes a byte 8 bits to a register port in I O address space wb register data iterations register Specifies which register to write to data Specifies the value that is written to the register iterations Specifies how many times the data is read The default is 1 The wb command writes a byte to the specified register in I O address space DP264 gt rb 280 28 DP264 gt wb
47. 1F lFlFlFlF s s 08000080 1F1F1F1F 00000000 00000000 00000000 00000000 20000000035 220000000 0 00 0 0 0 0 0 0 Hj RY uj RY a oj bro o Ps e E A Hj RY nj Hj Hj Hj Hj Hj Hj 4 48 User Commands 8 April 1999 User Commands 4 4 40 flash Program Data into Flash Memory Format Parameters Description Example 8 April 1999 The flash command programs data into flash memory flash source address destination offset bytes to write source address Specifies the address in memory of the data to be programmed into the flash The default is the default boot address see bootadr destination offset Specifies the offset in bytes into the flash where the first byte of source data will be programmed If not provided you are prompted with a default destination offset value The destination offset combined with the size of the data to be written must fit within the remaining space in the flash Also note that ROM images containing the standard Makerom header must be longword aligned See the MAKEROM chapter of the Alpha Microprocessors Motherboard Software Design Tools User s Guide bytes to write Specifies how many bytes to write beginning at the source address This parameter causes the flash command to ignore any standard header that might be included in the source data This value defaults to the value in the image size fie
48. 4 05 14 C1 43 06 14 Al 40 C 00100020 22 77 80 48 06 04 C2 40 FO 82 DC B4 F8 82 9C B4 w H Q 00100030 00 83 BC B4 3E 15 C5 43 20 00 FE B7 08 83 FC B3 gt C 00100040 07 00 00 DO 04 04 E2 47 19 10 00 DO 80 00 00 00 Garra 00100050 1F 04 FF 47 00 00 00 00 00 00 00 00 00 00 00 00 G 00100060 3E 15 C6 43 28 00 1E B4 36 01 00 DO 18 80 9C M gt C 6 00100070 05 34 EO 43 09 03 00 DO 20 80 9C AZ 05 54 EO 43 4 C T C 4 86 User Commands 8 April 1999 User Commands 4 4 73 pcishow Display PCI Slots and Mapping Format Parameters Description Example 8 April 1999 The pcishow command displays the contents of each PCI slot and the current PCI to system address space mapping pcishow bus id function bus Specifies which bus to show The default value is 0 id Specifies a decimal number that represents the slot assigned to the PCI device function Specifies which funtion to read from The default value is 0 The pcishow command applies only to PCI motherboards DP264 gt pcishow PCI Address Mapping windows are 1 PCI Base 0x00100000 Size 0x00100000 Translated Base 0x00100000 Bus 0 primary 0 secondary 0 subordinate 0 PCI I O space 1000 PCI Mem space 3F00000 PCI I O base B000 PCI Mem base 200000 PCI slot 18 vendor 0x1011 device 0x4 PCI IO Base 0x0 PCI IO Size 0x0 PCI Mem Base 0
49. 728 206 KB Firmware ID Opt 0305109502131030 ASCII 0 Header Checksum OxCED2 Loading ROM to address 00300000 Image checksum verified 0xD38C Loaded 211728 bytes starting at 300000 to 333B10 Jumping to 0x300000 DP264 gt romboot unix Searching for the Alpha SRM Console The specified ROM image was not found DP264 gt romboot nt Searching for the Windows NT Firmware Header Size 52 bytes Image Checksum OxD38C 54156 Image Size Uncomp 211728 206 KB Compression Type 0 Image Destination 0x0000000000300000 Header Version 1 Firmware ID 1 Windows NT Firmware ROM Image Size 211728 206 KB Firmware ID Opt 0305109502131030 ASCII 0 Header Checksum OxCED2 Loading ROM to address 00300000 Image checksum verified 0xD38C Loaded 211728 bytes starting at 300000 to 333B10 Jumping to 0x300000 4 106 User Commands 8 April 1999 User Commands 4 4 89 romlist List ROM Image Headers The romlist command lists the ROM image headers contained in ROM Format romlist Parameters None Description The romlist command searches the system ROM for any ROM image headers that might be present It then prints a summary for each header found Example DP264 gt romlist ROM image header found at offset 0x000000 Header Size 52 bytes Image Checksum 0x8111 Image Size Uncomp 129552 126 KB Compre
50. 938E DP EC QD2KC TE EC QP99C TE EC QP98C TE Support A 1 A 2 Support Title Alpha 21164PC Microprocessor Hardware Reference Manual AlphaPC 264DP Product Brief AlphaPC 264DP User s Manual AlphaPC 264DP Technical Reference Manual AlphaPC 164SX Motherboard Product Brief AlphaPC 164SX Motherboard Windows NT User s Manual AlphaPC 164SX Motherboard DIGITAL UNIX User s Manual AlphaPC 164SX Motherboard Technical Reference Manual AlphaPC 164LX Motherboard Product Brief AlphaPC 164LX Motherboard Windows NT User s Manual AlphaPC 164LX Motherboard Tru64 UNIX User s Manual AlphaPC 164LX Motherboard Technical Reference Manual Alpha Motherboards Software Developer s Kit Product Brief Alpha Motherboards Software Developer s Kit Read Me First Alpha Microprocessors Motherboard Software Design Tools User s Guide Alpha Microprocessors SROM Mini Debugger User s Guide Order Number EC R2WO0A TE EC RBDOA TE EC RBOBA TE EC RBODA TE EC R57CA TE EC R57DB TE EC R8P7B TE EC R57EB TE EC R2RZA TE EC R2ZQF TE EC R2ZPC TB EC R46WC TE EC QXQKD TE EC QERSJ TE EC QHUWE TE EC QHUXD TE Not available on website To purchase the Alpha Architecture Reference Manual contact your local sales office or call Butterworth Heinemann DIGITAL Press at 1 800 366 2665 8 April 1999 A Alpha 1 1 apropos 4 9 arpshow 4 10 Audience ix B Baud rate 2 1 beep 4 11 boot 2 3 4 12 Boot address 4 13
51. 96 16 C4 4A 36 B7 C1 00400408 FF FF FF FF FF FF FF FE 3FFF80410 4A 16 04 36 43 00 90 D6 00400410 FF FF FF FF FF FF FF FE 3FFF80418 6E OD 00 CO E2 20 00 08 00400418 FF FF FF FF FF FF FF FE 3FFF80420 75 40 00 D6 76 42 00 D6 00400420 FF FF FF FF FF FF FF FE 3FFF80428 76 97 00 08 65 88 00 D6 00400428 FF FF FF FF FF FF FF FF 3FFF80430 66 95 00 39 67 00 80 FF 00400430 FF FF FF FF FF FF FF FF 3FFF80438 79 7B 44 00 39 67 99 36 00400438 FF FF FF FF FF FF FF FF 3FFFD0000 FF FF FF FF FF FF FF FF 00450000 2D 00 00 00 00 00 00 00 User Commands 4 21 User Commands 4 4 13 cont Continue Execution from Breakpoint The cont command continues execution from a breakpoint Format cont Parameters None Description The cont command continues from a breakpoint The program continues until another breakpoint or the end of the program is reached Example P264 gt stop 100000 P264 gt go xecuting at 0x100000 0100000 C1000003 br r8 100010 P264 step 0100010 2F880007 ldq u r28 7 r8 P264 step 0100014 A49E0000 ldq r4 O sp P264 cont his simple program prints the sizes of various data types in bytes char short int long float double HUOUOUOIDnUU 0o 00S No P 4 22 User Commands 8 April 1999 User Commands 4 4 14 copy Copy Memory Block Format Parameters Description Example 8 April 1999 The Copy command copies the specified memory range
52. AR ee Pre NR AERE E 2 7 2 7 Execution Commands 00 cece hme 2 8 2 8 Resetting the Debug Monitor llle RII 2 8 3 Remote Debugging 3 1 What Isa Debugger wii iss kie REIR eee EE aOR ee ee edo ge 3 1 3 2 What Is a Remote Debugger ooooccccoccc teen eee 3 1 3 3 Remote Debug Server 0 ccc rh 3 1 3 4 Programming Guidelines 0 0 0 0 ccc eee eens 3 1 3 4 1 The Run Time Environment 0 00 eens 3 1 3 4 2 Iype sof Programs cio pee eme a dai 3 2 3 4 2 1 Restriction uro pA ERE RR RO RR MUR essed UR Nea a ico 3 2 3 4 3 PALcode Environment 0 00 c eee teens 3 3 3 5 Ladebug Command Line Options oooccccccococ eh 3 3 3 6 Building the Executable File 2 0 0 cece eee Ie 3 4 3 7 Starting a Ladebug Session iilii rene 3 4 8 April 1999 iii 4 User Commands 4 1 4 2 4 3 4 4 4 4 1 4 4 2 4 4 3 4 4 4 4 4 5 4 4 6 4 4 7 4 4 8 4 4 9 4 4 10 4 4 11 4 4 12 4 4 13 4 4 14 4 4 15 4 4 16 4 4 17 4 4 18 4 4 19 4 4 20 4 4 21 4 4 22 4 4 23 4 4 24 4 4 25 4 4 26 4 4 27 4 4 28 4 4 29 4 4 30 4 4 31 4 4 32 4 4 33 4 4 34 4 4 35 4 4 36 4 4 37 4 4 38 4 4 39 4 4 40 4 4 41 4 4 42 4 4 43 4 4 44 4 4 45 4 4 46 4 4 47 4 4 48 4 4 49 4 4 50 4 4 51 4 4 52 4 4 53 iv OVEIVIOW as ii A A Ade Ral eed wales lata Cates NU RE apne ga wad 4 1 Using the Commands 2 geen ieee eed as eee ee ETE BAN ee 4 2 User Commands Quick Reference 0 000 cece cette ees 4 3
53. April 1999 User Commands 4 4 16 creg Modify Register State The creg command modifies the saved CPU general purpose register state Format creg register_number value Parameters register_number Identifies the register value Specifies the new value of the register in hexadecimal numbers Description The creg command modifies the saved CPU general purpose register state to contain the specified value The program register contents are stored in memory to the saved state area when a breakpoint is encountered Modifications to a register using the creg command are applied to that register when execution of the program is resumed using the step or cont command Example DP264 gt preg General Purpose Registers register file 0000C040 x00 0000000000000020 0000000000000005 000000000000C000 000000000000000D r04 00000000000003F8 0000000000000000 0000000000000000 000000000000000D r08 FFFFFC000005F470 0000000000027340 0444306453605341 0A110C485F6EA26E r12 208090EA6024C19C 882C08AA92065B2D 4100610AE100244F 9E2891ACA8A9D984 r16 0000000000100000 000000000000000D 0000000000000006 0000000000000030 r20 0000000E20026335 5619A46B2B1A5125 0000000000000000 000000000000000D x24 0000000000000003 0000000000000000 FFFFFCOO00042C3C 0000000000100000 r28
54. COMPAQ Alpha Microprocessors Motherboard Debug Monitor User s Guide Order Number EC QHUVG TE Revision Update Information This is a revised document It supersedes the Alpha Microprocessors Motherboard Debug Monitor User s Guide EC QHUVF TE Compaq Computer Corporation April 1999 The information in this publication is subject to change without notice COMPAQ COMPUTER CORPORATION SHALL NOT BE LIABLE FOR TECHNICAL OR EDITORIAL ERRORS OR OMISSIONS CONTAINED HEREIN NOR FOR INCIDENTAL OR CONSEQUENTIAL DAM AGES RESULTING FROM THE FURNISHING PERFORMANCE OR USE OF THIS MATERIAL THIS INFORMATION IS PROVIDED AS IS AND COMPAQ COMPUTER CORPORATION DISCLAIMS ANY WARRANTIES EXPRESS IMPLIED OR STATUTORY AND EXPRESSLY DISCLAIMS THE IMPLIED WAR RANTIES OF MERCHANTABILITY FITNESS FOR PARTICULAR PURPOSE GOOD TITLE AND AGAINST INFRINGEMENT This publication contains information protected by copyright No part of this publication may be photocopied or reproduced in any form without prior written consent from Compaq Computer Corporation 1999 Digital Equipment Corporation All rights reserved Printed in U S A The software described in this publication is furnished under a license agreement or nondisclosure agreement The software may be used or copied only in accordance with the terms of the agreement COMPAQ the Compaq logo the Digital logo DIGITAL and VMS Registered in U S Patent and Trademark Office AlphaPC DECch
55. OpenVMS 3 UNIX Tru64 UNIX 7 LINUX Linux MILO 8 VXWORKS VxWorks 10 SROM Serial ROM The romboot command can also be used to select a ROM image based on its position in the ROM Specifying the type as 0 selects the entire ROM Specifying the type as 1 selects the first image 2 selects the second image and so on You can specify an address to override what is in the image file header You may also use the bootadr command Use the system reset to reset the motherboard to the initial booted state DP264 gt romboot Searching for ROM image 1 Header Size 52 bytes Image Checksum 0x581A 22554 Image Size Uncomp 117160 114 KB Compression Type 0 Image Destination 0x0000000000300000 Header Version 1 Firmware ID 0 Alpha Evaluation Board Debug Monitor ROM Image Size 117160 114 KB Firmware ID Opt 0000000000000000 ASCII Header Checksum Ox8F5C User Commands 4 105 User Commands Loading ROM to address 00300000 Image checksum verified 0x581A Loaded 117160 bytes starting at 300000 to 31C9A8 Jumping to 0x300000 DP264 gt romboot 2 Searching for ROM image 2 Header Size 52 bytes Image Checksum 0xD38C 54156 Image Size Uncomp 211728 206 KB Compression Type 0 Image Destination 0x0000000000300000 Header Version 1 Firmware ID 1 Windows NT Firmware ROM Image Size 211
56. P264 gt estat secs 7 mc bytes rcv 130075 bytes rev 1297171 mc frms rcv 625 bytes snt 0 frms snt dfrd 0 frms rcv 3129 frms snt cllsn 0 frms snt O frms snt mult cllsn 0 snd flrs def rcv flrs fos rcv flrs ferr rcv flrs flen data ovrn snd flrs xs cllsn snd flrs cc snd flrs shrt snd flrs opn snd flrs flen cllsn chk flr C9 29 60 CO 000000 4 46 User Commands 8 April 1999 User Commands 4 4 38 estop Stop Ethernet Controller The estop command stops the Ethernet controller Format estop Parameters None Description The estop command allows you to stop sending or receiving packets from an Ethernet device selected with the edevice command Example DP264 gt eshow All registered Ethernet devices Net Type Device 0 Alpha 21340 1 AM79C960 DP264 gt edevice Using network device 0 DP264 gt estop Stopping network device 0 in PCI slot 20 8 April 1999 User Commands 4 47 User Commands 4 4 39 fill Specify Address for Fill Value The fill command fills a specified memory block with the specified 32 bit pattern Format fill start address end address fill value Parameters start address Specifies the start address for the fill value end address Specifies the end address for the fill value The fill value includes the end address fill value Specifies a longword hexadecimal number as the fill value for the specified address The default i
57. ROM Image Size 0x31300 201472 196 KB Firmware ID Opt 0301009810291137 ROM offset 0x00000000 Header Checksum 0x7acl Enter destination offset or press RETURN for default 0 Return Flash offset 0x0 Image size w header 201528 Block 0 to 3 inclusive 8 April 1999 Getting Started 2 5 Debug Monitor Memory Map 11111 Warning About to overwrite flash memory Press Y to proceed any other key to abort Writing Flash Block OV 1V 2V 3V 7 The Debug Monitor is now in flash memory To restore the firmware 1 Use the flasherase command to erase the Debug Monitor from flash memory flasherase 0 3ffff 2 Run the normal update procedure described in your motherboard s user s manual by using the firmware update diskette supplied with your motherboard or downloading firmware from the Alpha OEM website described in Appendix A 2 5 Debug Monitor Memory Map The Debug Monitor image is loaded from the system ROM into memory at physical address 0 by the SROM initialization code At startup the Debug Monitor determines the amount of memory present in the motherboard based on parameters that are passed in from the SROM initialization code One of these parameters determines the top of main memory Refer to your motherboard s user s manual for more information about the SROM initialization code and supported memory configurations Figure 2 1 shows the basic outline for the Debug Monitor memory
58. Specifies whether or not the data is displayed Setting this parameter to 1 causes the data to be read but not displayed The default is O data is displayed The emq command displays a quadword of data from the specified memory location DP264 emq d0000 00000000FCOA4FF00 User Commands 4 41 User Commands 4 4 33 emw Display Word in Memory The emw command examines and displays a word of data in memory Format emw address iterations silent Parameters address Specifies the memory address iterations Specifies how many times the command is executed The default is 1 silent Specifies whether or not the data is displayed Setting this parameter to 1 causes the data to be read but not displayed The default is 0 data is displayed Description The emw command displays a word of data from the specified memory location Example DP264 gt emw d0000 00000000FCO4FFOO 4 42 User Commands 8 April 1999 User Commands 4 4 34 eprom Set Flag for Receiving Packets The eprom command sets or clears a flag for receiving all packets promiscuous mode Format eprom status Parameters status Determines whether packets are displayed Status can be 1 on or 0 off Description The eprom command sets a flag for receiving packets If status is set to 1 on then promiscuous mode is turned on and packets can be continuously received If this com mand is entered with no status then the current status is displayed The defau
59. UNIX host Example DP264 gt netload pc64dbm rom Alpha 21340 0 Initializing Hardware address BA 98 76 54 32 10 Trying 10 Base T Switching to AUI MAC address BA 98 76 54 32 10 Attempting BOOTP Loading sae share boot userl pc64 pc64dbm rom at 0x300000 My IP address 16 123 45 67 Server IP address 16 123 45 69 TESHHARSHESASHET SUE File loaded successfully Size 0x30B80 199552 DP264 sum 300000 330B7F Oxe5cc 58828 4 120 User Commands 8 April 1999 User Commands 4 4 101 sw Search Memory by Words Format Parameters Description Example 8 April 1999 The SW command searches memory by words 16 bit sw start_address end_address string inverse start_address Specifies the address at which to begin the search end_address Specifies the address at which to end the search string Specifies the search string inverse Specifies whether to search for a matching string 0 or a nonmatching string 1 The default is O search for a matching string The sw command searches memory by word chunks for the specified string You can use an asterisk as a wildcard character for single character matching DP264 gt pl 100000 100080 00100000 C3E00007 00000000 00000000 00000000 ee 00100010 00000000 00000000 00000000 00000000 e 00100020 221F0000 26100012 6BF00000 00000000 ok 00100030 00000000 00000000 00000000 00000000
60. ams load and begin execution The bootadr command sets the default address for the load commands to begin execution or to download your program into memory If the bootadr command is specified without an address the command displays the current default boot address If you set the boot address value the value is stored in battery backed RAM This example sets the starting address to 20000j The next file that is loaded begins execution from this address DP264 gt bootadr 20000 User Commands 4 13 User Commands 4 4 6 bootopt Select Operating System and Firmware Format Parameters Description Example 4 14 User Commands The bootopt command selects the operating system and firmware type to be used on the next power up bootopt type type Specifies the operating system type If the specified image is not found at power up the first image is booted If there are no ROM headers the whole ROM will be loaded at address 0 The bootopt command selects the operating system and associated firmware type that will be used the next time you power up your motherboard If no type is specified a list of predefined types is displayed along with the current selection Use the romlist com mand to display the images contained in the ROM You can specify the type as a num ber or a name Type number Type_name Description 0 DBM Alpha Motherboard Debug Monitor 1 NT Windows NT 2 VMS OpenVMS 3 UNIX Tr
61. and writes a memory range to a file Format flsave file name start address file size Parameters file name Specifies the name of the file to be created with the data If no drive or path is specified the file is created in the default working directory start address Specifies the address in memory to start writing to the file file size Specifies the size in bytes of the file to write Description The flsave command writes a section of memory to a file The file name can specify a drive and path Example DP264 flsave test txt 300000 34526 High Density selected Saving range 0x300000 to 0x334525 to file test txt DP264 flsave b Ntest txt 300000 34526 High Density selected Saving range 0x300000 to 0x334525 to file b test txt 4 60 User Commands 8 April 1999 User Commands 4 4 49 flwrite Write Data to Diskette s Logical Sectors Format Parameters Description Example 8 April 1999 The flwrite command writes data to logical sectors on a diskette Caution This is a destructive command You must be careful which sectors you write to because you may render the disk unusable flwrite first_sector image_size source_address iterations drive first_sector Specifies the first logical sector of diskette to be written The default is sector 0 the boot sector image_size Specifies the number of bytes to write to the diskette The default is one sector source_address Specifies the beginn
62. ard or serial port baud_rate Specifies the baud rate for the specified port The default is 9600 Description The setbaud command sets the baud rate for the specified keyboard or serial communi cation port The baud rate can be set to 1200 2400 9600 19200 or 38400 The following table shows the port identifier numbers Port ID Port Name 0 Keyboard port 1 Serial communication port 1 2 Serial communication port 2 Example DP264 gt setbaud 1 2400 4 114 User Commands 8 April 1999 User Commands 4 4 95 setty Specify Port for Debug Monitor Format Parameters Description Example 8 April 1999 The setty command sets the Debug Monitor to the specified port setty port port Specifies the number identifier for the keyboard or serial port The setty command specifies the port used for Debug Monitor interaction The follow ing table shows the port identifier numbers Port ID Port Name 0 Keyboard port 1 Serial communication port 1 2 Serial communication port 2 DP264 gt setty 1 User Commands 4 115 User Commands 4 4 96 sl Search Memory by Longwords The sl command searches memory by longwords 32 bit Format sl start_address end_address string inverse Parameters start_address Specifies the address at which to begin the search end_address Specifies the address at which to end the search string Specifies the
63. art address end address iterations silent Parameters start address Specifies a hexadecimal number that represents a legal address at which to start the dis play The default is the current address end address Specifies a hexadecimal number that represents a legal address at which to end the dis play The default is the current address plus 127 bytes iterations Specifies how many times the data is read The default is 1 silent Specifies whether or not the data is displayed Setting this field to 1 causes the data to be read but not displayed The default is O data is displayed Description The pb command displays the specified memory in byte format If no address is speci fied then the current memory byte and the following 127 bytes are displayed The field displayed after the bytes represents the translation of the memory contents in ASCII characters If the memory contents can be translated to an ASCII character then that character is displayed otherwise a dot is displayed The silent and iterations fields are often used together to continuously perform read operations thus avoiding slowdowns caused by displaying the data The repeating cycles can be monitored with test equipment Example This example displays 128 bytes from memory starting with 100000 in byte format P264 pb 100000 00 D 00100000 03 00 C1 00 00 00 00 10 D9 10 00 00 00 00 00 00100010 07 00 88 2F 00 00 9E A
64. arting at 1 megabyte physical address 100000 g At startup the Debug Monitor initializes the I O subsystem with DMA windows that include this range The device drivers included with the Debug Monitor that require DMA are the Ethernet and diskette drivers Although the ebuff command can be used to change the base of the Ethernet buffers the buffers must remain within this 1MB window 2 6 Downloading Files 8 April 1999 The motherboard supports loading files into memory from a serial port the Ethernet and a diskette The user can either load the file into memory or load and execute the file in a single step The following table shows the commands for the specific I O devices See Chapter 4 for more details about these commands Use this command to Use this command to 1 O Device load into memory load into memory and execute ROM socket romload romboot Serial port load boot Ethernet netload netboot Diskette flload flboot The default boot address bootadr is 300000 However you can change the default boot address with the bootadr command The new setting is then stored in the battery backed RAM Getting Started 2 7 Execution Commands 2 Execution Commands After your program is loaded you are ready to execute it If the command loads and executes a program you may want to re execute the program during the motherboard session The Debug Monitor has two commands to execute programs go and
65. ata is read The default is 1 silent Specifies whether or not the data is displayed Setting this field to 1 causes the data to be read but not displayed The default is 0 data is displayed Description The mrw command displays the word from the specified memory location in the mem ory I O space For example on the DP264 the word is read from the ISA extension slot Example DP264 gt mrw d0000 FFOO 4 78 User Commands 8 April 1999 User Commands 4 4 65 mt Measure Memory Bandwidth The mt command measures memory bandwidth Format mt Parameters None Description The mt command measures memory bandwidth Example DP264 gt mt 8 April 1999 User Commands 4 79 User Commands 4 4 66 mwb Write Byte to Memory I O Space The mwb command writes a byte to memory in the register port in I O address space Format mwb address data iterations Parameters address Specifies the address in memory I O space where the byte is written data Specifies byte data iterations Specifies how many times the data is read The default is 1 Description The mwb command specifies the memory location in I O memory space to write data in byte format Example DP264 gt mrb d0000 FF DP264 gt mwb d0000 O DP264 mrb d0000 00 4 80 User Commands 8 April 1999 User Commands 4 4 67 mwl Write Longword to Memory I O Space Format Parameters Description Example 8 April 1999 The mwl command writes a
66. ation Space 0 0 0 0 eee eee 4 92 preg Display General Purpose RegisterS 00 cee eee eee eee eee 4 93 pri Read Longword from PCI Configuration Space oococcccccococn ee 4 94 prw Read Word from PCI Configuration Space liliis 4 95 pw Display Memory Word ssseseseee eh 4 97 pwb Write Byte to PCI Configuration Space eee 4 98 pwl Write Longword to PCI Configuration Space oocococcccccococnc o 4 99 pww Write Word to PCI Configuration Space s sssusa aeaaaee eee 4 100 rb Read Byte from I O Address Space 1 0 0 0 cece eese 4 101 rl Read Longword from I O Address Space 0 000 cece eee eae 4 102 rmode Set dis Command Register Display Mode 0 0 cece eens 4 103 romboot Load and Execute Image from ROM 0 0c eee eee eee eee 4 105 romlist List ROM Image Headers 0 00 c eect eee 4 107 romload Load OS and Firmware from ROM issseseseee eese 4 108 romverify Compare Memory Image to ROM Image lisse eee eee eee 4 110 rw Read a Word from I O Address Space 0 0 c eee eee 4 112 sb Search Memory by Bytes ooococcccoccc ee 4 113 setbaud Set Port s Baud Rate 0 cee tees 4 114 setty Specify Port for Debug Monitor lile 4 115 sl Search Memory by LongwordsS 000 c eee eee eee eee ee 4 116 sq Search Memory by Quadwords
67. byte of data in memory silent eml address iterations Displays longword of data at the specified memory address silent emq address iterations Displays quadword of data at the specified memory address silent emw address iterations Examines and displays a word of data in memory silent ddmq address data itera Deposits the specified quadword of data in the specified memory tions address dmb address data itera Deposits the specified byte of data in the specified memory address tions dml address data itera Deposits the specified longword of data in the specified memory tions address dmq address data itera Deposits the specified quadword of data in the specified memory tions address dmw address data itera Deposits the specified word of data in the specified memory address tions mt none Measures memory bandwidth pq start_address Prints memory in quadword 64 bit format end_address itera tions silent pl start_address Prints memory in longword 32 bit format end_address itera tions silent pw start_address Prints memory in word 16 bit format end_address itera tions silent pb start_address Prints memory in byte 8 bit format end_address itera tions silent cq address Edits memory quadwords 64 bit 4 4 User Commands 8 April 1999 User Commands Quick Reference Table 4 2 Command Summary Table Continued
68. bytes Image Checksum Ox581A 22554 Image Size Uncomp 117160 114 KB Compression Type 0 Image Destination 0x0000000000300000 Header Version 1 Firmware ID 0 Alpha Evaluation Board Debug Monitor ROM Image Size 117160 114 KB Firmware ID Opt 0000000000000000 ASCII Header Checksum 0x8F5C Loading ROM to address 00300000 Image checksum verified 0x581A Loaded 117160 bytes from 300000 to 31C9A8 DP264 gt DP264 gt romload unix Searching for Alpha SRM Console The specified ROM image was not found DP264 gt DP264 gt romload nt Searching for Windows NT Firmware Header Size 52 bytes Image Checksum OxD38C 54156 Image Size Uncomp 211728 206 KB Compression Type 0 Image Destination 0x0000000000300000 Header Version Ji Firmware ID 1 Windows NT Firmware ROM Image Size 211728 206 KB Firmware ID Opt 0305109502131030 ASCII 0 Header Checksum OxCED2 Loading ROM to address 00300000 Image checksum verified 0xD38C Loaded 211728 bytes from 300000 to 333B10 DP264 gt User Commands 4 109 User Commands 4 4 91 romverify Compare Memory Image to ROM Image Format Parameters Description Examples The romverify command compares an image in memory to an image in the ROM romverify type address type Specifies the name or number of an image in the ROM to compare against memory
69. cominit Initialize Communications Ports The cominit command initializes communications ports Format cominit Parameters None Description The cominit command initializes communications ports Example DP264 gt cominit 4 20 User Commands 8 April 1999 4 4 12 compare Compare Memory Range Format Parameters Description Example 8 April 1999 User Commands The compare command compares a memory range to a specified address compare start_address end_address compare_address start_address Specifies the memory address at which to start the comparison end_address Specifies the last address that will be compared compare_address Specifies the address to be compared to the memory range The compare command compares each longword 32 bits within a specified range in memory to another specified location It then prints the data that differ DP264 gt copy 3fff80000 3fffd0000 400000 DP264 fill 400200 400220 DP264 fill 400400 400440 ffffffff DP264 compare 3fff80000 3fffd0000 400000 3FFF80200 64 86 00 E7 64 00 80 FF 00400200 00 00 00 00 00 00 00 00 3FFF80208 7B 06 78 C3 44 AO 10 CO 00400208 00 00 00 00 00 00 00 00 3FFF80210 F4 9B 10 EO C3 80 00 80 00400210 00 00 00 00 00 00 00 00 3FFF80218 00 CC 00 64 83 00 84 74 00400218 00 00 00 00 00 00 00 00 3FFF80400 E2 39 37 05 49 99 76 26 00400400 FF FF FF FF FF FF FF FF 3FFF80408 4B
70. d iterations Specifies how many times the command is executed The default is 1 Description The dmw command deposits the specified word of data in the specified memory loca tion A memory barrier MB instruction is executed after the store to force the stored data out of the chip Example DP264 gt dmw d0000 00000000FCO4FF00 4 34 User Commands 8 April 1999 User Commands 4 4 26 ebuff Set Memory Address for Ethernet Buffers Format Parameters Description Example 8 April 1999 The ebuff command sets the base address for the Ethernet transmit receive buffers ebuff address address Specifies the address for the transmit and receive buffers The default is 1000001 The ebuff command sets the address in physical memory where the transmit and receive buffers are located If specified without an address this command displays the current location of the buffers in memory DP264 gt ebuff 180000 User Commands 4 35 User Commands 4 4 27 edevice Set Debug Monitor to Use Ethernet Device The edevice command selects the registered Ethernet device that the Debug Monitor will use Format edevice device_number Parameters device_number Specifies the net device number of any registered Ethernet device If no device number is provided the current device number is displayed Description The edevice command sets the Debug Monitor to use one of the registered Ethernet devices Use the eshow command to
71. d crt_startup s v 1 3 1999 06 18 20 30 03 fdh Rel Id crt c v 1 1 1999 06 08 19 56 39 fdh Rel Id dis c v 1 1 1999 06 08 19 56 40 fdh Rel Id ffexec c 2 1999 06 09 20 23 05 fdh Rel Id ffsrec c 1 1999 06 08 19 56 41 fdh Rel Id cmd c v 1 6 1999 06 18 17 32 36 fdh Rel Id pReg c v 1999 06 08 19 56 41 fdh Rel Tes WE Ts 999 06 08 19 56 42 fdh Rel Id netboot c v 1 1 1999 06 08 19 56 30 fdh Rel Id amd c v 1 2 1999 06 08 22 32 57 berent Rel Id tftp c v 1 1 1999 06 08 19 56 31 fdh Rel Id netutil c v 1 1 1999 06 08 19 56 31 fdh Rel Id boots c v 1 2 1999 06 08 22 32 57 berent Rel Id listener c v 1 2 1999 06 08 22 32 57 berent Rel Id kernel c v 1 5 1999 06 18 17 49 34 fdh Rel Id bptable c v 1 1 1999 06 08 19 56 33 fdh Rel Id kutil s v 1 1 1999 06 08 19 56 36 fdh Rel Id comms c v 1 2 1999 06 08 22 32 06 berent Rel Id server_read_loop c v 1 1 1999 06 08 19 56 38 fdh Rel Id packet handling c v 1 2 1999 06 08 22 32 06 berent Rel Id printf c v 1 1 1999 06 08 19 56 24 fdh Rel he V V hb hp Hit any key to continue Control C to quit 4 66 User Commands 8 April 1999 User Commands 4 4 55 init Reinitialize the Debug Monitor The init command reinitializes the Debug Monitor Format init Parameters None Description The init command restarts the Debug Monitor by jumping to the PALcode base address in PALmode It is analogous to using the jtopal
72. d to the Header error will be reported wi DP264 gt dml 500000 400000 DP264 gt flash 500000 40018 4 Image source address 0x50 Flash offset Data image size 0x40 4 S M Warning Abou Press Y Do pr Writing Flash Block 4W Verifying Flash Block 4V 4 50 User Commands change a header checksum th romlist 0000 018 egment 4 to 4 inclusive T aT t to overwrite flash memory oceed any other key to abort 8 April 1999 User Commands DP264 gt romlist ROM image header found at offset 0x040000 Header Size 56 bytes Image Checksum Ox6eeb 28395 emory Image Size 0x30B2C 199468 194 KB Compression Type 0 Image Destination 0x0000000000400000 Firmware ID 0 Alpha Evaluation Board Debug Monitor ROM Image Size 0x30B2C 199468 194 KB Firmware ID Opt 0200009511221015 ROM offset 0x00000000 Header Checksum 0x71fb ERROR Bad ROM header checksum 0x79fb 8 April 1999 User Commands 4 51 User Commands 4 4 41 flasherase Erase Data from Flash Memory The flasherase command erases data from flash memory Format flasherase starting offset bytes to erase Parameters starting offest Specifies the offset in bytes into the flash where data will be erased If not provided the entire flash will be erased bytes to erase Specifies how many bytes to erase If not specified all bytes from the start
73. display all of the registered Ethernet devices Example DP264 gt eshow All registered Ethernet devices Net Type Device 0 AM79C960 1 WD3003 2 Alpha 21340 3 Alpha 21340 DP264 gt edevice 1 4 36 User Commands 8 April 1999 User Commands 4 4 28 edmp Set Display of Packets Format Parameters Description Example 8 April 1999 The edmp command displays packets received or transmitted to the terminal screen edmp status status Determines whether packets are displayed Status can be 1 on or 0 off The edmp command sets or clears the display of packets received or transmitted to the screen If this command is entered with no status then the current status is displayed DP264 gt edmp packet dumps are OFF DP264 gt eprom 1 DP264 gt edmp 1 User Commands 4 37 User Commands 4 4 29 einit Initialize Ethernet Controller The einit command initializes the Ethernet controller Format einit Parameters None Description The einit command initializes the Ethernet controller and displays the Ethernet hard ware address Example DP264 gt einit Ethernet Base Address 360 DMA Mask 1 DRO5 Init Block Address 80000 Init Done Ethernet BA 98 76 54 32 10 4 38 User Commands 8 April 1999 User Commands 4 4 30 emb Specify Display of Data Format Parameters Description Example 8 April 1999 The emb command examines and displays a byte of data i
74. dure calls r22 r25 t8 t11 Temporary registers not preserved across procedure calls r26 ra Contains the return address used for expression evaluation r27 pv or t12 Procedure value or a temporary register r28 at Assembler temporary register not preserved across procedure calls r29 GP Global pointer r30 SP Stack pointer r31 Zero Always has the value 0 8 April 1999 If you enter the command without a parameter then the current mode is displayed The rmode setting is stored in battery backed RAM User Commands 4 103 User Commands Example P264 mode P264 0024 024 024 024 024 024 024 024 264 024 024 024 024 024 024 024 024 P264 P264 024 024 024 024 024 024 024 024 264 024 024 024 024 024 024 024 024 P264 0 00 0 00 00 C O O OOOO QOO O C Ooo dcc U 0 00 0 0 0 00 UOOOOOOOOUGOGOOOOOOOUUGcGOOOOOOOUOOOOOoOoOoOoOouUHWU rmode 0 gt dis 243a0 3A0 43020122 3A4 48441722 3A8 74420050 3AC 64630082 3B0 209F07E1 3B4 48855724 3B8 44640103 3BC 47203019 gt dis 3C0 4B037698 3C4 4703F118 3C8 47190418 3CC 4B055738 3D0 44780403 3D4 746300A2 3D8 77FFO055 3DC 77FF0000 rmode 1 gt dis 243a0 3A0 43020122 3A4 48441722 3A8 74420050 3AC 64630082 3B0 209F07E1 3B4 48855724 3B8 44640103 3BC 47203019 gt dis 3C0 4B037698 3C4 4703F118 3C8 47190418 3CC 4B055738 3D0 44780403 3D4
75. e editing of memory locations type any nonalphanu meric character except a period The nonalphanumeric character can be typed after the modified byte on the same line To leave the current location unchanged press the Return key on an empty line Example This example modifies words 200094 through 200098 DP264 gt pw 200090 00200090 3BB9 CA6D FFB9 CFE7 3FBF FFFF 33F9 CE67 m TNT 002000A0 0000 0400 0000 0000 0000 0000 0000 0000 eee 002000B0 8166 309A 4166 3402 8960 0402 8D46 359Af 0fA 4 F 5 002000C0 FEFF FFFD FEFF FBFD FEFF FBFD FEFF FBFD 002000D0 3399 DA65 BB99 CFF7 37BF FFFF 33D9 CE67 3e 7 39 002000E0 0000 0000 0000 0000 0000 0000 0000 0000 sese 002000F0 8142 2012 0166 3402 8140 0402 4504 049A B f 48 E 00200100 FEFF FFFD FEFF FBFD FEFF FBFD FEFF FBFD DP264 cw 200090 00200090 3BB9 00200092 CA6D 00200094 FFB9 ffff 00200096 CFE7 0000 00200098 3FBF 0101 0020009A FFFF DP264 pw 200090 20009A 00200090 3BB9 CA6D FFFF 0000 0101 FFFF 33F9 CE67 m 3g 4 26 User Commands 8 April 1999 User Commands 4 4 18 date Display or Modify Date and Time Format Parameters Description Example 8 April 1999 The date command displays or modifies the date and time date yymmddhhmmss yymmddhhmmss To modify the date supply the year month day hou
76. e monitor and debug capabilities to customers who use an Alpha microprocessor motherboard as a develop ment platform for creating their own Alpha microprocessor based systems Audience This document is for anyone who develops software or hardware to be used with an Alpha microprocessor The Alpha Microprocessors Motherboard Debug Monitor Debug Monitor supports the following products Alpha 21264 Motherboard AlphaPC 264DP e Alpha 21164 Motherboard AlphaPC 164S X e Alpha 21164 Motherboard AlphaPC 164LX Content Overview The information in this document is organized as follows e Chapter 1 is an introduction to the Debug Monitor e Chapter 2 describes how to use this Debug Monitor Chapter 3 describes how to use remote debugging e Chapter 4 lists all Debug Monitor commands e Appendix A contains information about customer support services and associated documentation 8 April 1999 ix Conventions In this document the term motherboard refers to the AlphaPC 264DP Motherboard the AlphaPC 164SX Motherboard and the AlphaPC 164LX Motherboard unless other wise noted The following conventions are used in this document Convention Definition A percent sign Indicates a Tru64 UNIX operating system command prompt A pound sign Indicates a Tru64 UNIX superuser prompt and indicates that these commands are performed from the root directory level Square brackets Denote optional syntax
77. ebug Monitor supports remote debugging for Tru64 UNIX host systems with Ladebug The Ladebug software does not accept numeric Internet addresses You can give your motherboard an internet name in the etc hosts file In the etc hosts file the format is the Internet protocol IP address followed by the host system name For example 12 345 57 89 remote system nameO 2 4 Installing the Debug Monitor Firmware This section explains how to program the Debug Monitor firmware into a flash ROM on the motherboard by using the fail safe booter For more details about the fail safe booter see the user s manual for your motherboard 1 Put the Debug Monitor firmware on a floppy diskette 2 Setthe switch on the motherboard to the position which loads the fail safe booter See your motherboard s user manual for this information Insert the floppy diskette into your system 4 Resetthe system Load the file from the floppy diskette into main memory by using the flload com mand DP264 gt flload dp264dbm rom 6 The DP264 gt prompt displays Enter the flash command DP264 gt flash Image source address 0x300000 Searching for Standard ROM image header Found Header Size 0x38 56 bytes Image Checksum Oxff4b 65355 Memory Image Size 0X31300 201472 196 KB Compression Type 0 Image Destination 0x0000000000300000 Header Version 2 Firmware ID 0 Alpha Evaluation Board Debug Monitor
78. egisters and provide debug capabilities including breakpoints and single stepping 4 2 User Commands 8 April 1999 User Commands Quick Reference e Miscellaneous commands These commands are used to read and write the system register perform an interrupt acknowledge cycle call a subroutine and connect to serial communication ports e Ethernet commands These commands are used to set up and verify the status of the Ethernet port e Diagnostic commands These commands are used to verify that the motherboard is working properly 4 3 User Commands Quick Reference Table 4 2 contains a summary of all Debug Monitor commands The commands are grouped by category and function Table 4 2 Command Summary Table Command Parameters Description Download and Execution Commands load address Downloads a file through the active serial port using the XMODEM protocol boot address Downloads a file through the active serial port using the XMODEM protocol and begins execution netload file address Downloads the specified file through the Ethernet port at the current boot address or specified address netboot file address Downloads the specified file through the Ethernet port and begins exe cution flcd drive pathname Changes the current working directory to the specified drive or path flcopy source file Copies the specified file to another location destination file fldir drive pathname Display
79. emory location type the new data after the colon and press the Return key To end the editing of memory locations type any nonalphanumeric character except a period The nonalphanumeric character can be typed after the modified byte on the same line To leave the current location unchanged press the Return key on an empty line In this example the bytes at 30000046 and 300003 have been modified leaving the ones at 300001 6 and 300002 unchanged DP264 gt pb 300000 300008 00300000 1f 04 ff 47 1f 04 ff 47 45 00 60 c3 00 00 00 00 G GE DP264 cb 300000 00300000 1f aa 00300001 04 00300002 ff 00300003 47 dd 00300004 1f DP264 pb 300000 300008 00300000 aa 04 ff dd 1f 04 ff 47 45 00 60 c3 00 00 00 00 GE VN Rs User Commands 4 17 User Commands 4 4 9 cfreg Modify CPU Floating Point Register The cfreg command modifies the saved CPU floating point register state Format cfreg register_number value Parameters register_number Identifies the register value Specifies the new value of the register in hexadecimal numbers Description The cfreg command modifies the saved CPU floating point register state to contain the specified value The program register contents are stored in memory to the saved state area when a breakpoint is encountered Modifications to a register using the cfreg command are applied to that register when execution of the program is resumed using t
80. er Commands 4 69 User Commands The following command entered from the host system starts Ladebug and causes it to connect to the DP264 ladebug size out rn dp264 pid 0 The following information is displayed on the host system Welcome to the Ladebug Debugger Version 1 3 1 object file name size out machine name dp264 process id 0 Reading symbolic information done Connected to remote debugger ladebug The 1adebug in the previous example is the Ladebug prompt You are now ready to debug a process that is running on the DP264 4 70 User Commands 8 April 1999 User Commands 4 4 58 load Download File Using XMODEM Protocol Format Parameters Description Example 8 April 1999 The load command downloads a file through the active serial port using the XMODEM protocol load address address Specifies the address at which to download the file The default is the boot address The load command uses the XMODEM protocol to download a file through the active serial port The program is loaded to the supplied address or the boot address if an address is not specified The program can then be executed with the go or jtopal com mands In this example a Tru64 UNIX host system is connected to the motherboard on device dev tty01 The sx command sends a file using XMODEM echo load 300000 gt dev tty01 sx kt 10 users evall demo2 size lt dev ttya01 gt dev tty01 Sector nnn
81. ers Description Example 8 April 1999 The next command executes the machine instruction without stepping into subrou tines n ext None Use the step command and the next command to execute a machine instruction When the instruction contains a subroutine the step command steps into the subroutine being called and the next command executes the subroutine being called In the following example the step command used at address 200034 steps to the first instruction of the function being called at address 2000c0 The next command used at address 2000ec executes the function being called and steps to the next instruction at address 2000f0 DP264 gt dis 00200030 a77d8010 ldq r27 32784 r29 00200034 605504000 jsr r26 r27 00200038 27ba0001 ldah r29 1 r26 0020003c 23bdc148 lda r29 49480 r29 DP264 gt step 00200030 a77d8010 ldq r27 32784 r29 DP264 gt step 00200034 605504000 jsr r26 r27 DP264 gt step 002000c0 27550001 ldah r29 1 r27 DP264 gt dis 002000e8 a77d8040 ldq r27 32832 r29 002000ec b6b5b46b8 jsr r26 r27 002000f0 27ba0001 ldah r29 1 126 DP264 step 002000e8 a77d8040 ldq r27 32832 r29 DP264 gt step 002000ec b6b5b46b8 jsr r26 27 DP264 gt next 002000f0 27ba0001 ldah r29 1 r26 DP264 User Commands 4 85 User Commands 4 4 72 pb Display Memory Byte The pb command displays the specified memory byte 8 bit Format pb st
82. est Walking 1 s on x00028051 amp BC CFG x00020041 amp BC CFG 0x8 amp CIA MCR Error Summary 00 0x01E21772 0x01E21772 0x2001FE21 range 0x0008a420 0x03ffc000 Processor Correctable Machine Check Interrupt vector 0x630 EI STAT FFFFFFFOCAFFFFFF EI ADDR FFFFFF00001231AF FILL SYNDROME 0000000000000019 ISR 0000000100600000 Processor Correctable Machine Check Interrupt vector 0x630 EI STAT FILL SYNDROME 4 74 User Commands FFFFFFFOCAFFFFFE 0000000000000019 EI ADDR FFFFFF00009231AF ISR 0000000100600000 8 April 1999 User Commands 4 4 61 memtest Perform Tests on Memory Range Format Parameters Description Example 8 April 1999 The memtest command tests a memory range memtest iterations start address end address increment mcheck stop_drivers iterations Specifies the number of times the memory range test will run The default iteration is 1 start address Specifies the address at which to start the memory test The default is the current address end address Specifies the address at which to end the memory test increment Defines the step size The default is longword access 4 mcheck Specifies the machine check state as defined by the mcheck command see the mcheck command The mcheck state is specified during the start of the memory test Possible selections are on off cpu and system The default is on
83. ether to search for a matching string 0 or a nonmatching string 1 The default is O search for a matching string The sb command searches memory by byte chunks for the specified string You can use an asterisk as a wildcard character for single character matching 4 gt pl 100000 100080 000 C3E00007 00000000 010 00000000 00000000 020 221F0000 26100012 030 00000000 00000000 040 00000000 00000000 050 00000000 00000000 060 00000000 00000000 070 00000000 00000000 00000000 080 00000000 00000000 00000000 64 gt sb 100000 100080 2 l 20 mask ccurrence at ccurrence at P264 gt sb 1000 val 10 mask occurrence at occurrence a occurrence a DP264 gt sb 10 val 1F ma occurrence at 0 00000000 00000000 6BF 00000 00000000 00000000 00000000 00000000 000000000 o o 000000000 000000000 o 00000000o0o0 OO 00 0 00 0 0 P26 1 dl Jl 1 1 1 1 1 1 P2 023 22 027 26 0080 1 UOO lt U cO OO OE w TY O 0 O OO OO OO ooo 022 1F 024 12 026 10 0080 1f occ o O cC C olooool iooo I o x gt omnmnooomndhoomtrd eoOunjooooooocoocooc 022 1F User Commands 4 113 User Commands 4 4 94 setbaud Set Port s Baud Rate The setbaud command sets the baud rate for the specified communication port con nection Format setbaud port baud_rate Parameters port Specifies the number identifier for the keybo
84. files using the g option This preserves the symbolic information in the source files 2 Link the source files with the N and Tx options where x is the load address for the executable on the motherboard 3 Use the CSTRIP utility to strip the coff header from the executable file Keep the unstripped executable file 3 7 Starting a Ladebug Session 3 4 The Debug Monitor ladebug command configures the motherboard as a remote debugger target Communication is performed through the Ethernet connection To debug a program running on a motherboard using Ladebug running on a remote host follow these steps 1 Setup the host Tru64 UNIX machine as described in Chapter 2 2 Start the motherboard 3 Load the program into memory on the motherboard Remote Debugging 8 April 1999 Starting a Ladebug Session 4 Set a breakpoint in the program Execute the program The program will stop at the breakpoint and print the instruc tion line at that location 6 Issue the ladebug command This causes the motherboard to wait for a connection from Ladebug 7 From the host system enter the command to start Ladebug and cause it to connect to the motherboard The following example shows how to set up a sample session DP264 gt netload size Ethernet Base Address 360 DMA Mask 1 DRO5 Init Block Address 100000 Init Done Ethernet BA 98 76 54 32 01 Attempting BOOTP success my IP address 16 123 45 67 server IP address 16 123
85. g server the part of the monitor that communicates with Ladebug uses interrupts and an Ethernet device Interrupts are used by the Debug Monitor to poll the Ethernet device for messages from Ladebug Any program that changes the interrupt handler must instruct the debug server when to poll the Ethernet 3 4 Programming Guidelines The following sections describe the programming guidelines for remote debugging 3 4 1 The Run Time Environment 8 April 1999 When a program is started by the Debug Monitor s go command it is started at the appropriate IPL to enable real time clock interrupts usually IPL 4 If a program does not install its own interrupt handler then the Debug Monitor will handle all interrupts If a program does install its own interrupt handler using the Write System Entry Remote Debugging 3 1 Programming Guidelines Address PAL call then it must be prepared to handle all interrupts as described in the following sections When a program completes normally the Debug Monitor reinstalls its own interrupt handler 3 4 2 Types of Programs For the purposes of this chapter programs may be classified into the following three types Programs that do not use the Ethernet or do not include their own interrupt handler Programs that do not use the Ethernet but do include their own interrupt handler e Programs that use the Ethernet 3 4 2 1 Restriction There is only one restriction for programs that do not use the E
86. g the Commands This section describes the Debug Monitor command categories Download and execution commands The motherboard software basic load command expects to receive Motorola S records that are stored in the appropriate memory location The Ethernet port provides improved download performance by using the Internet BOOTP protocol a UDP based protocol This feature allows the motherboard system to determine its Internet address the address of a boot server and the name of a file to boot The Debug Monitor also supports loading files from a floppy drive or the secondary ROM socket The execution commands can be used to transfer control to a program in memory These commands begin executing a program in memory at the specified address or automatically with a download command Examine and modify memory commands These commands are used to examine and change memory in various formats beginning at a specified address and ending at a specified address Quadwords 64 bits longwords 32 bits halfwords 16 bits and bytes 8 bits are all supported by these commands PCI commands These commands are used to access PCI configuration space Utility commands These commands are used to display and modify the date and time display the ver sion of the Debug Monitor and obtain information about commands implemented in the current version Debug commands These commands are used to debug software Debug commands display internal CPU r
87. he data is displayed Setting this field to 1 causes the data to be read but not displayed The default is 0 data is displayed Description The mrb command displays the byte from the specified memory location in the mem ory I O space For example on the DP264 the byte is read from the ISA extension slot Example DP264 gt mrb d0000 FF 4 76 User Commands 8 April 1999 User Commands 4 4 63 mrl Display Longword from Memory I O Space Format Parameters Description Example 8 April 1999 The mrl command reads a longword from memory in the register port in I O address space mrl address iterations silent address Specifies the address in memory I O space iterations Specifies how many times the data is read The default is 1 silent Specifies whether or not the data is displayed Setting this field to 1 causes the data to be read but not displayed The default is 0 data is displayed The mrl command displays the longword from the specified memory location in the memory I O space For example on the DP264 the longword is read from the ISA extension slot DP264 gt mrl d0000 FCO4FFOO User Commands 4 77 User Commands 4 4 64 mrw Read Word from Memory I O Space The mrw command reads a word from memory in the register port in I O address space Format mrw address iterations silent Parameters address Specifies the address in memory I O space iterations Specifies how many times the d
88. he data to be read but not displayed The default is O data is displayed The pq command displays the specified memory in quadword format If no address is specified then the current memory quadword and the following 15 quadwords are dis played The field displayed after the quad word represents the translation of the memory contents in ASCII characters If the memory contents can be translated to an ASCII character then that character is displayed otherwise a dot is displayed The silent and iterations fields are often used together to continuously perform read operations thus avoiding slowdowns caused by displaying the data The repeating cycles can be monitored with test equipment This example displays memory quadwords DP264 pq 00000000 00000000E7E01021 0000000000000000 00000010 0000000000000000 0000000000000000 ee 00000020 00000000E7E01095 0000000000000000 00000030 0000000000000000 0000000000000000 eee 00000040 0000000000000000 0000000000000000 ee 00000050 0000000000000000 0000000000000000 eee 00000060 0000000000000000 0000000000000000 ee 00000070 0000000000000000 0000000000000000 ee DP264 pq 100000 00100000 00000000C1000003 000000000010D910 00100010 A49E00002F880007 40A1140643C11405
89. he default is the current address end_address Specifies a hexadecimal number that represents a legal address at which to end the dis play The default is the current address plus 127 bytes iterations Specifies how many times the data is read The default is 1 silent Specifies whether or not the data is displayed Setting this field to 1 causes the data to be read but not displayed The default is 0 data is displayed The pw command displays the specified memory in word format If no address is spec ified then the current memory word and the following 63 words are displayed The field displayed after the word represents the translation of the memory contents in ASCII characters If the memory contents can be translated to an ASCII character then that character is displayed otherwise a dot is displayed The silent and iterations fields are often used together to continuously perform read operations thus avoiding slowdowns caused by displaying the data The repeating cycles can be monitored with test equipment This example displays eight memory addresses starting with 100000 in word format DP264 gt pw 100000 00100000 0003 C100 0000 0000 D910 0010 0000 0000 lese 00100010 0007 2F88 0000 A49E 1405 43C1 1406 40A1 Qr 00100020 7722 4880 0406 40C2 82F0 B4DC 82F8 B49C w H 00100030 8300 B4BC 153E 43C5 0020 B7FE 8308 B3FC gt C 00100040 0007 D000 0404 47E2
90. he step or the cont command Example DP264 gt pfreg Floating Point Registers register file 0000C840 00 0000000000000000 0000000000000000 0000000000000000 0000000000000000 04 0000000000000000 0000000000000000 0000000000000000 0000000000000000 08 0000000000000000 0000000000000000 0000000000000000 0000000000000000 12 0000000000000000 0000000000000000 0000000000000000 0000000000000000 16 0000000000000000 0000000000000000 0000000000000000 0000000000000000 20 0000000000000000 0000000000000000 0000000000000000 0000000000000000 24 0000000000000000 0000000000000000 0000000000000000 0000000000000000 28 0000000000000000 0000000000000000 0000000000000000 0000000000000000 PC 000000000000000D PS 000000000000000D DP264 gt cfreg 12 ababababab DP264 gt cfreg 14 fefefefefe DP264 gt pfreg Floating Point Registers register file 0000C840 00 0000000000000000 0000000000000000 0000000000000000 0000000000000000 04 0000000000000000 0000000000000000 0000000000000000 0000000000000000 08 0000000000000000 0000000000000000 0000000000000000 0000000000000000 12 000000ABABABABAB 0000000000000000 000000FEFEFEFEFE 0000000000000000 f16 0000000000000000 0000000000000000 0000000000000000 0000000000000000 20 0000000000000000 0000000000000000 0000000000000000 0000000000000000 24 0000000000000000 0000000000000000 000
91. icates that a hardware error condition was detected Different error conditions are detected by the CPU or system logic external to the CPU To help to ensure the availability of the Debug Monitor for hardware debug machine check reporting is dis abled when the Debug Monitor starts up This condition makes the Debug Monitor firmware more fail safe than conventional firmware when hardware integrity is ques tionable Therefore when using the Debug Monitor machine checks can be enabled on demand by the mcheck command to facilitate low level hardware debug Because some machine checks are reported through interrupt requests at interrupt prior ity level IPL 6 the mcheck command could change the current IPL If the current IPL is lower than 7 the current IPL will not be affected See the description of the swpipl command for more information about the IPL The mcheck command could also modify the machine check error summary register See the mces command for more information about the machine check error summary register 8 April 1999 User Commands 4 73 User Commands Example In the following example all machine check and correctable error reporting are enabled before running the memory test The errors displayed in this example are correctable and without machine checks enabled these memory errors would be corrected by the CPU DP264 gt mcheck Old BC_CTL 0 New BC_CTL 0 CIA_CACK_EN DP264 gt mces Machine Check DP264 gt memt
92. imes the data is read The default is 1 Description The ww command writes a word to the specified register in I O address space For example on the DP264 the word is written to the ISA extension slot Example DP264 gt ww 370 4 DP264 gt rw 370 0004 4 130 User Commands 8 April 1999 A 1 Customer Support URL A Support The Alpha OEM website provides the following information for customer support Description http www digital com alphaoem Contains the following links e Developers Area Development tools code examples driver developers information and technical white papers Motherboard Products Motherboard details and performance information e Microprocessor Products Microprocessor details and performance information News Press releases Technical Information Motherboard firmware and drivers hardware compatibility lists and product documentation library Customer Support Feedback form A 2 Alpha Documentation 8 April 1999 The following table lists some of the available Alpha documentation You can down load Alpha documentation from the Alpha OEM World Wide Web Internet site http www digital com alphaoem Click on Technical Information Then click on Documentation Library Title Alpha Architecture Reference Manual Alpha Architecture Handbook Alpha 21164 Microprocessor Hardware Reference Manual Alpha 21164 Microprocessor Data Sheet Order Number EY W
93. ing address where data to be written resides The default is the boot address iterations Specifies the number of times to repeat the writing of the sector range The default is 1 drive Specifies the diskette drive number to use 0 or 1 The default is 0 The flwrite command writes data from memory to the specified logical sectors of a dis kette The iterations parameter can be used to repeat the task a specified number of times DP264 gt flwrite 30 High Density selected Writing 0 bytes from 0x400000 starting at sector 30 Done 512 0X200 bytes transferred DP264 gt flwrite 30 3400 High Density selected Writing 3400 bytes from 0x400000 starting at sector 30 Done 3584 0XE00 bytes transferred DP264 gt flwrite 30 3400 300000 High Density selected Writing 3400 bytes from 0x300000 starting at sector 30 Done 3584 0XE00 bytes transferred DP264 gt flwrite 30 3400 300000 2 High Density selected Writing 3400 bytes from 0x300000 starting at sector 30 Done 3584 0XE00 bytes transferred 1 iterations remaining Done 3584 0XE00 bytes transferred User Commands 4 61 User Commands 4 4 50 fwupdate Load and Run Firmware Update from Diskette The fwupdate command loads and runs the firmware update utility from diskette Format fwupdate Parameters None Description The fwupdate command loads and executes the firmware update u
94. ing offset through the rest of the flash will be erased Description The flasherase command clears flash memory on boards equipped with flash The area to be erased that is filled with zeros can be specified or calculated by the flasherase command Example DP264 romlist ROM image header found at offset 0x000000 Header Size 0x38 56 bytes Image Checksum 0x45b0 17840 Memory Image Size OxBA40 47680 46 KB Compression Type Image Destination 0x0000000000300000 Header Version Firmware ID Alpha Evaluation Board Fail Safe Booter ONANOOOC ROM Image Size xBA40 47680 46 KB Firmware ID Opt 0202009702121228 AAA ROM O PESE tic eco 0x00000000 Header Checksum Oxfad4 ROM image header found at offset 0x010000 Header Size 0x38 56 bytes Image Checksum Oxc63c 50748 emory Image Size 0x280B4 164020 160 KB Firmware ID Opt 0202009706130904 ROM offSetillss nss 0x00000000 Header Checksum 0x94a5 DP264 flasherase 4000 Flash offset 0x40000 Bytes to b rased 786432 Block 4 to 15 inclusive Warning About to overwrite flash memory Press Y to proceed any other key to abort Writing Flash Block 4V 5V 6V 7V 8V 9V 10V 11V 12V 13V 14V 15V 4 52 User Commands 8 April 1999 User Commands 4 4 42 flboot Download and Execute File from Diskette Format Parameters Description Example
95. ion space bus function pww pci address id data Writes a word to a specified address in PCI configuration space bus function pwb pci_address id data Writes a byte to a specified address in PCI configuration space bus function Utility Commands date yymmddhhmmss Modifies or displays the date and time flash source_address Programs data into flash memory destination_offset bytes_to_write flasherase starting_offset Erases data from flash memory bytes_to_erase fwupdate none Loads and runs the firmware update utility help command_name Displays a list of commands or displays parameter fields and syntax if a command is specified apropos keyword Displays help text containing the specified keyword ident start_address Displays RCS ID strings found in the specified memory range end_address sysshow none Displays SROM parameters version none Displays the Debug Monitor firmware version information 4 6 User Commands 8 April 1999 User Commands Quick Reference Table 4 2 Command Summary Table Continued Command Parameters Description swpipl ipl Sets or displays the current interrupt priority level IPL of the CPU mces mces_data Sets or displays the machine check error summary register wrfen value Enables disables floating point Debug Commands preg address Displays CPU general purpose registers pfreg add
96. ip DIGITAL UNIX Ladebug OpenVMS and Tru64 are trademarks of Compaq Computer Corporation Microsoft MS DOS and Windows NT are registered trademarks of Microsoft Corporation Intel is a registered trademark of Intel Corporation Other product names mentioned herein may be the trademarks of their respective companies 8 April 1999 Contents Preface 1 Introduction 1 1 OVerVvieW 24 4 4 Geet Se ee que Ee ee ee ee Ros Rn 1 1 1 2 General Features cmt ee eee bp ate gfe RH RO ORE QUE De dE Rr pad 1 1 1 3 Recommended Host SysteM ocococcccoc teens 1 1 2 Getting Started 2 1 Overview iio a Gee ed eee nae oe 2 1 2 2 System Requirements o cocoococcocc eens 21 2 3 Configuring Your System 2 0 tees 2 1 2 3 1 Connecting to a Terminali sesse darua siape urey eii aaa ne 2 1 2 3 2 Connecting toa PO ss uu see ee Os Sv ee eee dea es e 2 2 2 3 3 Connecting from a System Running Windows NT 0 000 eee eee ee eee 2 2 2 3 4 Connecting from a System Running Tru64 UNIX 0 0 0 0 00 eee 2 2 2 3 4 1 Connecting to a Serial Port eee 2 3 2 3 4 2 Setting Up the Host System as a BOOTP Server 0200e eee eeee 2 3 2 3 4 3 Setting Up the Host System as a Ladebug Client 00055 2 5 2 4 Installing the Debug Monitor Firmware lseelel I 2 5 2 5 Debug Monitor Memory Map 00 eee eet ae 2 6 2 5 1 SACK aet sev a Ao a She sie i 2 7 2 5 2 pw cc 2 7 2 6 Downloadirig Fll s 3 e ER RR E
97. ist 4 107 romload 4 108 romverify 4 110 rw 4 112 S sb 4 113 Serial connection Tru64 UNIX 2 2 Serial port 2 1 2 7 4 12 connecting to 2 3 setbaud 4 114 Setting up for remote debugging 2 5 setty 4 115 sl 4 116 sq 4 117 Stack 2 7 step 4 118 stop 4 119 Structure of document ix sum 4 120 Summary of commands 4 3 sw 4 121 swpipl 4 122 sysshow 4 123 System configuration 2 1 T Terminal connecting to 2 1 tip 4 124 Tru64 UNIX command 2 3 Tru64 UNIX 1 1 2 2 Tru64 UNIX remote debugging 3 1 Tru64 UNIX tip command 2 3 U User commands 4 8 Index 3 V version 4 125 vinit 4 126 W wb 4 127 Windows NT 1 1 2 2 wl 4 128 wrfen 4 129 ww 4 130 Index 4 8 April 1999
98. l address data iterations Parameters address Specifies the memory address data Specifies the longword of data to be stored iterations Specifies how many times the command is executed The default is 1 Description The dml command deposits the specified longword of data in the specified memory location A memory barrier MB instruction is executed after the store to force the stored data out of the chip Example DP264 gt dml d0000 FCO4FFOO 4 32 User Commands 8 April 1999 User Commands 4 4 24 dmq Deposit Quadword in Memory Format Parameters Description Example 8 April 1999 The dmq command deposits the specified quadword of data in the specified memory location dmq address data iterations address Specifies the memory address data Specifies the quadword of data to be stored iterations Specifies how many times the command is executed The default is 1 The dmq command deposits the specified quadword of data in the specified memory location A memory barrier MB instruction is executed after the store to force the stored data out of the chip DP264 gt dmq d0000 O0000000FCO4FF00 User Commands 4 33 User Commands 4 4 25 dmw Deposit Word in Memory The dmw command deposits the specified word of data in the specified memory loca tion Format dmw address data iterations Parameters address Specifies the memory address data Specifies the quadword of data to be store
99. l received Ethernet frames To ensure that this function gets called at the proper time enable either Ethernet or timer interrupts or both and call it every time an interrupt occurs Programs cannot share an Ethernet device with the Debug Monitor The Debug Monitor can drive a selection of different types of Ethernet devices on ISA or PCI cards and an individual Ethernet device can be selected with the Debug Monitor edevice command 3 2 Remote Debugging 8 April 1999 Ladebug Command Line Options 3 4 3 PALcode Environment Most programs will be able to use the Tru64 UNIX compatible PALcode included with the Debug Monitor however for the programs that install their own PALcode the fol lowing guidelines must be followed For remote debug to work the following Tru64 UNIX PALcode calls must be implemented according to the interface described in the UNIX section of the Alpha Architecture Reference Manual IMB RDUSP RTI WPIPL WRENT The interface to the system must conform to the standards described in the UNIX section of the Alpha Architecture Reference Manual The debug server uses the DBGSTOP PAL call to implement breakpoints The pro gram must contain an identical implementation of the DBGSTOP PAL call This PAL call rather than the BPT PAL call is used because complex programs such as operating systems are likely to reset the EntIF system entry point during initialization The program reset PALcode routine must preserve
100. ld of the standard header If not specified and if there is no standard image at the beginning of the source data this value is assumed to be the remaining space in the flash The flash command programs the flash memory on the motherboards containing this type of memory It reads data from memory at the specified source address and pro grams it into the flash at the specified offset The amount of data written can be speci fied by the user or determined by the flash command DP264 netload pc64dbm rom Attempting BOOTP Loading users eval pc64 pc64dbm rom at 300000 y IP address 16 123 45 67 Server IP address 16 123 45 69 Tidg4SESESETHTSESESSFile loaded DP264 flash Image source address 0x300000 Standard image header Found Header Size 56 bytes Image Checksum Ox6eeb 28395 emory Image Size 0x30B2C 199468 194 KB Compression Type 0 Image Destination 0x0000000000300000 Header Version 2 Firmware ID Opt 0 Alpha Evaluation Board Debug Monitor FROM Image Size 0x30B2C 199468 194 KB Firmware ID Opt 0200009511221015 ROM OffSetulite ws 0x00000000 Header Checksum 0x71fb Enter destination offset or press RETURN for default 0 User Commands 4 49 User Commands Flash offset Image size w header 1 Warning Press Yt Update canceled by user DP264 flash Image source address Standard image header Header Size Image Checks
101. longword to memory in the register port in I O address space mwil address data iterations address Specifies the address in memory I O space where the longword is written data Specifies longword of data iterations Specifies how many times the data is read The default is 1 The mwl command writes a longword to memory in I O address space For example on the DP264 the longword is written to the ISA extension slot DP264 gt mwl d0000 fcO4ffO00 User Commands 4 81 User Commands 4 4 68 mww Write Word to Memory I O Space The mww command writes a word to memory in the register port in I O address space Format mww address data iterations Parameters address Specifies the address in memory I O space where the word is written data Specifies word of data iterations Specifies how many times the data is read The default is 1 Description The mww command writes a word to memory I O space For example on the DP264 a word is written to the ISA extension slot Example DP264 gt mrw d0000 FFOO DP264 gt mww d0000 a5a5 DP264 gt mrw d0000 A5A5 4 82 User Commands 8 April 1999 User Commands 4 4 69 netboot Download and Execute File Format Parameters Description Example 8 April 1999 The netboot command downloads the specified file through the Ethernet port and begins execution of that file netboot file address file Specifies a legal file name to be downloaded to the
102. lt status is 0 off Example DP264 eprom Promiscuous Mode is DISABLED DP264 eprom 1 8 April 1999 User Commands 4 43 User Commands 4 4 35 ereg Display Ethernet Controller Registers The ereg command displays the Ethernet controller registers Format ereg Parameters None Description The ereg command displays the Ethernet controller registers This command s output is dependent on the Ethernet device selected for the motherboard For example the ISA based AM79C960 controller must be in stop mode write 0 to register port 372 and write 4 to data port 370 to view most of its registers Example DP264 gt ww 372 0 DP264 gt ww 370 4 DP264 gt ereg Ethernet Controller Base Address 360 CSR 0 126 O 0004 1 0000 2 0008 3 0000 4 1115 5 8000 6 1200 7 0000 8 0000 9 0000 10 0000 11 0000 12 0008 13 122B 14 D637 15 4080 16 0000 17 0008 18 0OcC8 19 0008 20 1F88 21 0008 22 1308 23 0008 24 0018 25 0008 26 0030 27 0008 28 0028 29 0008 30 0038 31 0008 32 FFFF 33 FDFF 34 0040 35 0008 36 0018 37 0008 38 FFFF 39 FDFF 40 F9CO 41 8308 42 FFC4 43 0308 44 F9CO 45 8308 46 3CED 47 FFEFF 48 FFFF 49 FFEF 50 FFEF 5 FFEF 52 DFFF 53 TEFF 54 FFFE 55 FFFD 56 EFFF 57 FFFF 58 FFFF 59 EFFF 60 0038 61 0008 62 F000 63 8308 64 1F88 65 0008 66 FFC4 67 0308 68 8000 69 0235 70 0202 71 0000 72 FEFC 73 FFFF 74 FFFE 75 FFFF 76 FFFC 77 FEFE 78 FFFE
103. mmand keywords implemented in the current release The command can be abbreviated to one letter h If you specify a command with a command keyword then a brief description and syntax for the specified com mand is displayed You can use an asterisk in place of a command keyword to dis play all help information The help command without a parameter displays a list of all commands implemented in the current version of the software When specified with a parameter 1t displays more information about that command keyword DP264 gt help A brief help description is available for each of the following commands load fldir romboot go emq pa cw sum wb mwb prl flash h wrfen bpstat delete tip estat arpshow DP264 gt boot flboot romlist jtopal ddmq pl cb rl mrl sq prw flasherase ident preg next ladebug cominit einit mcheck help netload flload romload init dmb pw fill rw mrw sl prb fwupdate version pfreg n iack vinit estop beep Hit any key to continue netboot flread romverify emb dmw pb copy rb mrb sw pwl date sysshow creg step rmode edevice ebuff memtest flcd flwrite bootadr emw dml cq compare wl mwl sb pww apropos swpipl cfreg S setty eshow edmp mt Control C to quit Displays help for all commands in the command list 4 64 User Commands flcopy flsave bootopt eml dmq cit dis ww mww
104. motherboard The default is to load the file specified in the boot ptab file address Specifies the address at which to download the file The default is the boot address The netboot command uses BOOTP to download the specified file through the Ether net port The Ethernet port is selected through the edevice command The downloaded file automatically begins execution in PALmode This command has the same effect as using the netload command followed by the jtopal command A default file and directory path may be defined in the boot pt ab file See Section 2 3 4 2 for more information If you specify an address this address becomes the default boot address This value however is not set in battery backed RAM This example downloads and begins execution of a file called size DP264 gt netboot size Ethernet Base Address 360 DMA Mask 1 DRO5 Init Block Address 80000 Init Done Ethernet BA 98 76 54 32 10 Attempting BOOTP success my IP address 16 123 45 67 server IP address 16 123 45 69 gateway IP address 16 123 45 69 Loading from users eval boot size Hitt Jumping to 0x100000 char short nda long float double 00 H gt 00 NE Alpha 21264 Evaluation Board DP264 Debug Monitor Version Wed Feb 10 19 52 24 EST 1999 Bootadr 0x100000 memSize 0x2000000 User Commands 4 83 User Commands 4 4 70 netload Download File to Default Boot Address Format Parameters Description E
105. n asterisk to remove all breakpoints Example DP264 gt delete 00200050 8 April 1999 User Commands 4 29 User Commands 4 4 21 dis Disassemble Instructions Format Parameters Description Example The dis command displays memory as CPU instructions dis start_address end_address start_address Specifies the address at which to start disassembling instructions If the start_address is not specified the address of the last load command the last breakpoint or the last dis command is used end_address Specifies the address at which to end disassembling instructions The default is the start_address plus 32 bytes 8 instructions The dis command disassembles instructions starting with the specified address You can specify an address range of instructions to be disassembled If no parameters are specified then the command starts with the current address and disassembles the next eight instructions If a file is downloaded to memory then the default starting address for the dis command is the first memory location in the downloaded file If a breakpoint is encountered then the default starting address is the breakpoint address The rmode command is used to select whether the hardware or software register names are displayed when instructions are disassembled The hardware register names are shown by default The rmode setting is stored in nonvolatile RAM DP264 gt dis 243a0 000243A0 43
106. n connect to the motherboard from the Ladebug source level debugger running on a Tru64 UNIX host Communication is performed through the Ethernet connection The Ladebug software provides the full source level debugging capabilities of most pro grams running on the motherboard including the Debug Monitor To debug a program running on a motherboard using Ladebug running on a remote host follow these steps 1 Load the program into memory on the motherboard 2 Set a breakpoint in the program 3 Execute the program The program will stop at the breakpoint and print the instruc tion line at that location 4 Issue the ladebug command This causes the motherboard to wait for a connection from Ladebug 5 From the host system enter the command to start up Ladebug and cause it to con nect to the motherboard Refer to the Ladebug documentation for more information DP264 gt netload size Ethernet Base Address 360 DMA Mask 1 DRO5 Init Block Address 100000 Init Done Ethernet BA 98 76 54 32 10 Attempting BOOTP success my IP address 16 123 45 67 server IP address 16 123 45 69 gateway IP address 16 123 45 69 Loading from users eval boot size EH DP264 gt stop 200000 DP264 gt go Executing at 0x200000 00200000 23DEFFFO lda sp 16 sp DP264 gt ladebug Ethernet Base Address 360 DMA Mask 1 DRO5 Init Block Address 100000 Init Done Client connected client is FFFFFFFFA0107F10 Us
107. n memory emb address iterations silent address Specifies the memory address iterations Specifies how many times the command is executed The default is 1 silent Specifies whether or not the data is displayed Setting this parameter to 1 causes the data to be read but not displayed The default is 0 data is displayed The emb command displays a byte of data from the specified memory location DP264 gt emb d0000 FCO4FF00 User Commands 4 39 User Commands 4 4 31 eml Specify Display of Data The eml command examines and displays a longword of data in memory Format eml address iterations silent Parameters address Specifies the memory address iterations Specifies how many times the command is executed The default is 1 silent Specifies whether or not the data is displayed Setting this parameter to 1 causes the data to be read but not displayed The default is 0 data is displayed Description The eml command displays a longword of data from the specified memory location Example DP264 gt eml d0000 FCO4FFOO 4 40 User Commands 8 April 1999 User Commands 4 4 32 emg Display Quadword in Memory Format Parameters Description Example 8 April 1999 The emq command examines and displays a quadword of data in memory emq address iterations silent address Specifies the memory address iterations Specifies how many times the command is executed The default is 1 silent
108. nd frequency Example DP264 gt beep 1000 4000 8 April 1999 User Commands 4 11 User Commands 4 4 4 boot Download File Using XMODEM Protocol The boot command downloads a file through the active serial port using the XMODEM protocol and begins execution Format boot address Parameters address Specifies the address at which to download the file The default is the boot address Description The boot command uses the XMODEM protocol to download a file through the active serial port The program is loaded to the supplied address or to the boot address if an address is not specified The program is then automatically executed Example In this example a Tru64 UNIX host system is connected to the motherboard on device dev tty01 The sx command sends a file using XMODEM echo boot 300000 gt dev tty01 sx kt 10 users evall demo2 size lt dev tty01 gt dev tty01 Sector nnn tip dev tty01 DP264 4 12 User Commands 8 April 1999 User Commands 4 4 5 bootadr Display or Modify Default Boot Address Format Parameters Description Example 8 April 1999 The bootadr command allows you to display or modify the default boot address bootadr address address Specifies the starting address at which a program is loaded Programs loaded with the netboot command automatically begin program execution at this address The default address is 300000 6 The boot address is the address at which your progr
109. ning communication software e A system running Windows NT e An Alpha system running Tru64 UNIX You need to provide a power supply for the motherboard See your motherboard s user s manual for more information about requirements for your power supply 2 3 1 Connecting to a Terminal 8 April 1999 To connect the motherboard to a terminal connect the terminal communication line to serial port 1 of the motherboard Your terminal should be set to match the baud rate of the motherboard The most current and reliable source for this information is your motherboard s user manual After the terminal and the motherboard are connected and the motherboard is powered on the terminal screen should display the banner and prompt For example DECchip 21264 DP264 Debug Monitor Version Tue May 04 16 55 54 EDT 1999 Bootadr 0x100000 memSize 0x2000000 32MB DP264 Getting Started 2 1 Configuring Your System Note Using a terminal in this manner is the most effective way to quickly verify that your motherboard was not damaged during shipping You can use the onboard ROM to load and boot software through a compatible ROM How ever to download a file you need a system running terminal emulation software that has the capability of performing text dumps through the serial connection or through an Ethernet connection to a host system that sup ports the BOOTP protocol 2 3 2 Connecting to a PC Communication terminal emulation
110. o display it For example the following lines modify this file for the DP264 remote_system_name0 ht ethernet ha BA9876543210 ip 16 123 45 67 hd directoryl bf filename vm auto BOOTP checks this file to see if it has changed each time it receives a request If it has changed the new file is read The directory and filename are the defaults for the netload and netboot commands If no argument is specified with either command the file loaded is directoryl filename Verify the BOOTP Server To verify that the BOOTP server has been set up properly you can look at the dae mon log file This file shows directories accessed for the netload or netboot com mands tail f var adm sylog dated dated dir daemon log The following example displays a boot request from an example daemon log file ay not ay ay ay 5 10 40 28 eval bootpd 328 request from hardware address BA9876543210 ay 5 10 40 28 eval bootpd 328 found dp264 BA9876543210 at 16 123 45 67 5 10 40 28 eval bootpd 328 file users eval boot size dp264 found 5 10 40 28 eval bootpd 328 vendor magic field is 0 0 0 0 5 10 40 28 eval bootpd 328 sending RFC1048 style reply You can refer to the Tru64 UNIX man pages for more information about boot p bootpd tftp tftpd inet inetd and init 2 4 Getting Started 8 April 1999 Installing the Debug Monitor Firmware 2 3 4 3 Setting Up the Host System as a Ladebug Client The D
111. odify the contents of the specified memory address If no address is specified then the next quadword is selected The Debug Monitor dis plays the address followed by the current data and a colon For example 00200090 00000000E7E0101D To modify the contents of this memory location type the new data after the colon and press the Return key To end the editing of memory locations type any nonalphanumeric character except a period The nonalphanumeric character can be typed after the modified byte on the same line To leave the current location unchanged press the Return key on an empty line Example This example modifies only quadword 200020 DP264 gt eq 200020 00200020 0000000004000000 0000000011111111 00200028 0000000000000000 00200030 3402010400120106 00200038 0402010004020100 00200040 FBFDFEFFFFFDFEFFE DP264 pq 200000 00200000 FA7D7299CE7F3299 DA65FA99DA7D32D9 2 r 2 e 00200010 FFFFFFFBFBFFFFDB FFFFFFFFFFFFFFFF 00200020 0000000011111111 0000000000000000 eee eee 00200030 3402010400120106 0402010004020100 C osha gas 00200040 FBFDFEFFFFFDFEFF FBFDFEFFFBFDFEFF 00200050 CFET7FF99CB6FF799 EEET7FBFBFFFFFFFF 0 00200060 0000000004020000 0000000000000000 eee eee 00200070 1402010620100106 050A050004020100 seen 4 24 User Commands 8
112. ooocooooo 4 68 ladebug Start Ladebug Remote Debugger lisse cece eee eee eae 4 69 load Download File Using XMODEM Protocol 0 0 0 cece eee eee 4 71 mces Set or Display Machine Check Error Summary 2000000005 4 72 mcheck Control Machine CheckS ooooccccococccc eee 4 73 memtest Perform Tests on Memory Range oooccccccccoc eee eee 4 75 mrb Display Byte from Memory I O Space 20 000 cece eee eee 4 76 mrl Display Longword from Memory I O Space 0 0 cee eee eee 4 77 mrw Read Word from Memory I O Space 0 0 cece eee eee 4 78 mt Measure Memory Bandwidth ooooocoocronrrrr 4 79 mwb Write Byte to Memory I O Space eren 4 80 mwl Write Longword to Memory I O Space isses esee 4 81 mww Write Word to Memory I O Space 00 0 eese 4 82 netboot Download and Execute File 4 83 netload Download File to Default Boot Address 0 0000 e eee eee 4 84 next Execute Next Machine Instruction 2 0 00 cece eee ee 4 85 pb Display Memory Byte 0 cee teens 4 86 pcishow Display PCI Slots and Mapping 0 0 cece ee eee eee 4 87 pfreg Display Floating Point Register State 0 00 eee eee 4 88 pl Display Memory Longword 0 20 eee teeta 4 89 pq Display Memory QUadWord o ccccccccoc eene 4 91 prb Read Byte from PCI Configur
113. or DBM 1 The Windows NT Operating System NT 2 OpenVMS VMS 3 Tru64 UNIX UNIX 7 Linux Milo 8 VxWorks Real Time Operating System VxWorks 10 Serial ROM SROM SROM Load and boot entire ROM at address zero Firmware type Unknown HU ou User Commands 4 15 User Commands 4 4 7 bpstat Display Breakpoint Status The bpstat command displays the current breakpoint status Format bpstat Parameters None Description The bpstat command lists the breakpoints set with the stop command The disassem bled instructions for that location are also displayed Example DP264 gt stop 200000 DP264 gt stop 200FCO DP264 bpstat break at 00200000 23DEFFFO lda sp 16 sp break at 00200FCO 27BBO001 ldah r29 1 r27 4 16 User Commands 8 April 1999 User Commands 4 4 8 cb Edit Memory Bytes Format Parameters Description Example 8 April 1999 The cb command allows you to edit memory bytes 8 bit cb address address Specifies the address of the memory byte you want to change The cb command allows you to modify the contents of a specified memory address If no address is specified then the next byte is selected The Debug Monitor displays the address followed by the current data and a colon For example 0200090 1D To modify the contents of this m
114. ord to memory in I O address space tions mww address data itera Writes a word to memory in I O address space tions mwb address data itera Writes a byte to memory in I O address space 8 April 1999 User Commands 4 5 User Commands Quick Reference Table 4 2 Command Summary Table Continued Command Parameters Description sq start_address Searches the specified memory range by quadwords for the specified end_address string pattern inverse sl start_address Searches the specified memory range by longwords for the specified end address string pattern inverse sw start_address Searches the specified memory range by words for the specified pat end address string tern inverse sb start_address Searches the specified memory range by bytes for the specified pat end address string tern inverse PCI Commands pcishow id bus function Displays the contents of each PCI slot and current PCI to system address space mapping prl pci address id bus Reads a longword from the specified address in PCI configuration function space prw pci address id bus Reads a word from the specified address in PCI configuration space function prb pci address id bus Reads a byte from the specified address in PCI configuration space function pwl pci_address id data Writes a longword to a specified address in PCI configurat
115. otocol BOOTP needs to be defined so that the commands netload and netboot work correctly To set up a Tru64 UNIX system as a BOOTP server follow these steps 1 Modify the etc inetd conf file This file enables both the BOOTP and the TFTP daemons The TFTP daemon is required by the BOOTP daemon a Add the following line to specify the directories that can be accessed by the TFTP daemon tftp dgram udp wait root usr sbin tftpd tftpd directoryl directory2 If no directory is specified all files with public access can be accessed by the TFTP daemon b To start the BOOTP daemon enter the following line bootps dgram udp wait root usr sbin bootpd bootpd d d d Getting Started 2 3 Configuring Your System If BOOTP is already running on your system you want to stop it To stop BOOTP enter the following commands ps uax grep bootpd kill KILL process_id_number ps uax grep inetd kill HUP process_id_number To restart BOOTP enter the following command sbin init q The changes made to the etc inetd conf file will now take effect Modify the etc bootptab file to specify the Ethernet hardware address of the motherboard and the IP address assigned to that node Contact your network administrator to obtain an IP address Refer to the literature supplied with your Ethernet card to obtain information about the hardware address If the hardware address is accessible through software you can use the einit command t
116. our System To enable these ports for use with the motherboard follow these steps 1 Login as superuser 2 Modify the following two files etc remote etc inittab a Add the following two lines to the etc remote file These lines define a device to connect to when using the Tru64 UNIX t ip command port_name0 dv dev tty00 br 9600 pa none port_namel dv dev tty01 br 9600 pa none The port_name refers to an arbitrary name that you assign to that port b Modify the etc inittab file to disable logins on the two serial communication ports by setting the third field to of For example modify the tty00 and tty01 lines as follows tty00 23 0ff usr sbin getty dev tty00 9600 tty01 23 off usr sbin getty dev tty01 9600 3 Reboot the system or issue the following command to ensure that the modified files take effect sbin init q 2 3 4 1 Connecting to a Serial Port After you modify the etc remote and etc inittab files you can connect to the serial port under the Tru64 UNIX operating system using the Tru64 UNIX tip command If the connection is successful the motherboard prompt displays and you are ready to use the Debug Monitor load or boot commands to download your file For example tip port nameO DP264 gt load Send File now Type gt to cause the Tru64 UNIX tip command to send the file to the motherboard 2 3 4 2 Setting Up the Host System as a BOOTP Server 8 April 1999 The bootstrap pr
117. r minute and second If the date command is specified alone the month day time and year is displayed If you supply a parameter the date is modified This example displays the current date and time setting DP264 gt date Jun 1 12 58 19 1999 These examples show how to modify the date and time setting DP264 gt date 930211000000 DP264 gt date Feb 11 00 00 04 1999 DP264 gt date 930211135700 DP264 gt date Feb 11 13 57 02 1999 User Commands 4 27 User Commands 4 4 19 ddmq Deposit Quadword in Memory The ddmq command deposits a quadword of data in the specified memory location Format ddmq address data iterations Parameters address Specifies the memory address data Specifies the quadword of data to be stored iterations Specifies how many times the command is executed The default is 1 Description The ddmq command deposits the specified quadword of data in the specified memory location A memory barrier MB instruction is executed after the store to force the stored data out of the chip Example DP264 ddmq d0000 00000000FC04FF00 4 28 User Commands 8 April 1999 User Commands 4 4 20 delete Remove Breakpoint from Address The delete command removes a breakpoint from the specified address Format delete address Parameters address Specifies the address from which to delete the breakpoint Description The delete command removes a breakpoint from the specified address You can use a
118. r the Alpha Evaluation Board Debug Monitor Comparing to image at 0x300000 Images match DP264 gt romverify 1 300000 Searching for ROM image 1 Comparing to image at 0x300000 Images do not match DP264 gt romverify 2 300000 Searching for ROM image 2 Comparing to image at 0x300000 Images match 8 April 1999 User Commands 4 111 User Commands 4 4 92 rw Read a Word from I O Address Space The rw command reads a word 16 bits from a register port in I O address space Format rw register iterations silent Parameters register Specifies the register from the I O address space iterations Specifies how many times the data is read The default is 1 silent Specifies whether or not the data is displayed Setting this field to 1 causes the data to be read but not displayed The default is 0 data is displayed Description The rw command reads a word from the specified register in I O address space Example DP264 gt rw 372 0000 DP264 gt rw 370 A6B3 4 112 User Commands 8 April 1999 User Commands 4 4 93 sb Search Memory by Bytes Format Parameters Description Example 8 April 1999 The sb command searches memory by bytes 8 bit sb start_address end_address string inverse start_address Specifies the address at which to begin the search end_address Specifies the address at which to end the search string Specifies the search string inverse Specifies wh
119. ress Displays CPU floating point registers creg register_number Modifies CPU general purpose registers value cfreg register_number Modifies CPU floating point registers value stop address Sets a breakpoint at the specified address bpstat none Displays the current breakpoint status step none Executes a machine instruction by stepping into the first instruction of the function being called next none Executes a machine instruction without stepping into subroutines cont none Continues execution from a breakpoint delete address Removes breakpoint from the specified address ladebug none Starts a Ladebug server for a remote debug session Miscellaneous Commands cominit none Initializes communications ports iack none Performs an interrupt acknowledge cycle rmode mode Sets the dis command register display mode setty port Specifies the port used for Debug Monitor interaction setbaud port baud_rate Sets the communication port baud rate The default is 9600 tip port Connects to a specified serial communication port vinit none Initializes the video controller Ethernet Commands edevice device_number Selects a registered Ethernet device eshow none Displays all registered Ethernet devices ereg none Displays the Ethernet controller registers estat none Displays Ethernet statistics einit none Initializes Ethernet controller and displays the Ethernet hardware address estop none Stops the Ethernet controller ebuff address Sets the base addres
120. rm native debugging including breakpoints and single stepping e Perform full source level debugging using the DIGITAL Ladebug debugger Lade bug for Tru64 UNIX running on a remote host that communicates through an Ethernet connection 1 3 Recommended Host System 8 April 1999 The recommended host system for software development is an Alpha system running the Windows NT or Tru64 UNIX operating systems Alpha hardware is the platform upon which the initial set of portable development tools is provided The native Tru64 UNIX and Windows NT software development tools are used in conjunction with the portable tools The Tru64 UNIX operating system also supports the bootstrap protocol BOOTP for downloading executable images to the motherboard and Ladebug for remote debug ging The examples in this manual that pertain to a host system are based on Alpha hardware running the Tru64 UNIX operating system Introduction 1 1 2 Getting Started 2 1 Overview This chapter describes how to set up your motherboard and host system 2 2 System Requirements The minimum configuration that you need in order to use your motherboard is a power supply and a terminal However to take full advantage of the motherboard you need an Alpha host development system running the Windows NT or Tru64 UNIX operating systems 2 3 Configuring Your System This section describes how to connect your motherboard to the following e A terminal e A PC run
121. s 090001C0 00000000 00000000 00000000 00000000 sess DP264 copy 8000000 8000080 9000150 DP264 pl 9000150 09000150 1F1F1F1F 1F1F1F1F 1F1F1F1F 1FIFIFIF ee 09000160 1F1F1F1F 1F1F1F1F 1F1F1F1F 1FIFIFIF e 09000180 1F1F1F1F 1F1F1F1F 1F1F1F1F 1FIFIFIF o 09000190 1F1F1F1F 1F1F1F1F 1F1F1F1F 1FIFIFIF o o 090001A0 1F1F1F1F 1F1F1F1F 1F1F1F1F 1FIFIFIF o o o 090001B0 1F1F1F1F 1F1F1F1F 1F1F1F1F 1FIFIFIF o 090001C0 1F1F1F1F 1F1F1F1F 1F1F1F1F 1FIFIFIF o DP264 gt pl 8000000 08000000 1F1F1F1F 1F1F1F1F 1F1F1F1F 1FIFIFIF o o 08000010 1F1F1F1F 1F1F1F1F 1F1F1F1F 1FIFIFIF 08000020 1F1F1F1F 1F1F1F1F 1F1F1F1F 1FIFIFIF o o o 08000030 1F1F1F1F 1F1F1F1F 1F1F1F1F 1FIFIFIF o o o 08000040 1F1F1F1F 1F1F1F1F 1F1F1F1F 1FIFIFIF o o 08000050 1F1F1F1F 1F1F1F1F 1F1F1F1F 1FIFIFIF o 08000060 1F1F1F1F 1F1F1F1F 1F1F1F1F 1FIFIFIF o 08000070 1F1F1F1F 1F1F1F1F 1F1F1F1F 1FIFIFIF o oo o User Commands 4 23 User Commands 4 4 15 cq Edit Memory Quadwords The cq command allows you to edit memory quadwords 64 bit Format cq address Parameters address Specifies the address of the memory quadword you want to change Description The cq command allows you to m
122. s 0 Description The fill command fills a specified block of memory with a specified value The data or fill value specified is placed in memory starting at the first address specified and it fills through the last or end address specified Example This example displays the original value in address range 08000000 through 08000080 and the value of the same address range after the fill command DP264 pl 8000000 08000000 E7E01021 00000000 00000000 00000000 08000010 00000000 00000000 00000000 00000000 08000020 E7E01095 00000000 00000000 00000000 08000030 00000000 00000000 00000000 00000000 08000040 00000000 00000000 00000000 00000000 08000050 00000000 00000000 00000000 00000000 08000060 00000000 00000000 00000000 00000000 08000070 00000000 00000000 00000000 00000000 DP264 fill 8000000 8000080 1f1f1f1f DP264 pl 8000000 8000080 08000000 1F1F1F1F 1F1F1F1F 1F1F1F1F lFlFlFlF see 08000010 1F1F1F1F 1F1F1F1F 1F1F1F1F lFlFlFlF sss 08000020 1F1F1F1F 1F1F1F1F 1F1F1F1F lFlFlFlF sss 08000030 1F1F1F1F 1F1F1F1F 1F1F1F1F lFlFlFlF sss 08000040 1F1 IFIFIFIF 1F1F1F1F IFIFIFIF 08000050 1F1F1F1F 1F1F1F1F 1F1F1F1F lFlFlFlF ses 08000060 1F1F1F1F 1F1F1F1F 1F1F1F1F lFlFlFlF sss 08000070 1F1F1F1F 1F1F1F1F 1F1F1F
123. s a list of files in the current or specified directory flload file address Downloads the specified diskette file flboot file address Downloads the specified diskette file and begins execution flread first sector bytes Reads logical sectors from a diskette dest address itera tions drive flwrite first_sector Writes data by logical sectors to a diskette image_size source_address itera tions drive flsave file_name Saves the specified memory range to the specified file start_address file_size romload type address Loads the specified image from ROM to the specified address romboot type address Loads the specified image from ROM and begins execution 8 April 1999 User Commands 4 3 User Commands Quick Reference Table 4 2 Command Summary Table Continued Command Parameters Description romlist none Lists the ROM image headers contained in ROM romverify type address Compares an image in memory to an image in ROM bootadr address Sets default boot address bootopt type Selects the operating system and firmware type to be used on the next power up go start_address Starts execution at the specified address jtopal start_address Starts execution at the specified address in PALmode init none Reinitializes the Debug Monitor Examine and Modify Memory Commands emb address iterations Examines and displays a
124. s for Ethernet DMA buffers 8 April 1999 User Commands 4 7 User Commands Table 4 2 Command Summary Table Continued Command Parameters Description edmp status Sets or clears display of packets received or transmitted eprom status Sets or clears flag for receiving all packets promiscuous mode arpshow none Displays all known address resolution protocol ARP entries Diagnostic Commands beep duration frequency Causes speaker to beep for the specified duration and frequency mcheck state Controls the reporting of hardware error conditions machine checks memtest iterations Tests memory range Uses longword accesses to memory start address end address incre ment mcheck stop drivers 4 4 User Commands 4 8 This section contains complete descriptions and examples of the Debug Monitor com mands The commands are listed in alphabetical order User Commands 8 April 1999 User Commands 4 4 1 apropos Display Help Descriptions Format Parameters Description Example 8 April 1999 The apropos command displays help descriptions for the specified keyword apropos keyword keyword Specifies the string to match in the help command text The apropos command is an additional form of help This command searches the help file and displays all matches for the specified keyword DP264 gt apropos load load Downloads S records through a serial por
125. search string inverse Specifies whether to search for a matching string 0 or a nonmatching string 1 The default is O search for a matching string Description The sl command searches memory by longword chunks for the specified string You can use an asterisk as a wildcard character for single character matching Example P264 gt pl 100000 0100000 C3E00007 000000 0100010 00000000 000000 0100020 000 261000 0100030 000 000000 0100040 000 000000 0100050 000 000000 0100060 000 000000 0000000 00000000 e 0000000 00000000 e BF00000 00000000 amp k 0000000 00000000 e 0 0 00 00 0 0 00 0 0000 o CSS eee 0000000 00 000 00 0 os teen rte 603 0000000 00000000 e 0100070 000 000000 0000000 00000000 P264 sl O 100070 2 al 2000 mask F0000000 ccurrence 00100020 221F0000 ccurrence 00100024 26100012 P264 sl 100000 100070 2 1 val 20100000 mask FOF00000 occurrence at 00100020 221F0000 occurrence at 00100024 26100012 CeOOOOoOhNOGO DEFOD CO CFO C2 OOoooomnococo Seoqc coo ono ac gt CiA0 0 O Oo O NO E 0 0 0 0 0 0 0 UOOd4Uooooocoocotu tro 2 0 0 0 0 0 0 0 a a 0 0 gt 1 0 0 4 116 User Commands 8 April 1999 User Commands 4 4 97 sq Search Memory by Quadwords Format Parameters Description Example 8
126. splay or Change Working Directory or Drive llle elles 4 54 flcopy Gopy File oi ban ar hp Der m Rer dare HERE teri 4 56 fldir Display File Listing rr RR RR EIER ERES E 4 57 flload Download File from Diskette llle 4 58 flread Read Logical Sectors from Diskette llle esee 4 59 flsave Write Memory Range to File 0 eee ees 4 60 flwrite Write Data to Diskette s Logical Sectors 0000 eee eee eee 4 61 fwupdate Load and Run Firmware Update from Diskette 4 62 go Begin Executing Instructions llle 4 63 help Display Command Information 0 0 cee eere 4 64 iack Perform Interrupt Acknowledge Cycle sss esee 4 65 8 April 1999 4 4 54 4 4 55 4 4 56 4 4 57 4 4 58 4 4 59 4 4 60 4 4 61 4 4 62 4 4 63 4 4 64 4 4 65 4 4 66 4 4 67 4 4 68 4 4 69 4 4 70 4 4 71 4 4 72 4 4 73 4 4 74 4 4 75 4 4 76 4 4 77 4 4 78 4 4 79 4 4 80 4 4 81 4 4 82 4 4 83 4 4 84 4 4 85 4 4 86 4 4 87 4 4 88 4 4 89 4 4 90 4 4 91 4 4 92 4 4 93 4 4 94 4 4 95 4 4 96 4 4 97 4 4 98 4 4 99 4 4 100 4 4 101 4 4 102 4 4 103 4 4 104 4 4 105 4 4 106 4 4 107 4 4 108 4 4 109 4 4 110 8 April 1999 ident Identify Revision of Files llle BB 4 66 init Reinitialize the Debug Monitor 0 eee eee 4 67 jtopal Set to PALmode and Execute Instructi0NS 0oooooco
127. ssion Type 0 Image Destination 0x0000000000300000 Header Version 1 Firmware ID 0 Alpha Evaluation Board Debug Monitor ROM Image Size 129552 126 KB Firmware ID Opt 0000000000000000 ASCII Header Checksum 0xA839 ROM image header found at offset 0x040000 Header Size 52 bytes Image Checksum 0xD38C Image Size Uncomp 211728 206 KB Compression Type 0 Image Destination 0x0000000000300000 Header Version Ji Firmware ID 1 Windows NT Firmware ROM Image Size 211728 206 KB Firmware ID Opt 0305109502131030 ASCII 0O Header Checksum OxCED25 DP264 8 April 1999 User Commands 4 107 User Commands 4 4 90 romload Load OS and Firmware from ROM Format Parameters Description Example The romload command loads the specified image from ROM to the specified address romload type address type Specifies the image to load into ROM If the type is specified as 0 then any header information is ignored and the entire contents of the ROM is loaded The default is to load the first image in the system ROM address Specifies the starting address for loading the image into ROM The romload command loads the operating system and associated firmware from the system ROM Use the romlist command to display the images contained in the ROM You can specify the type as a number or a name T
128. t syntax load arguments boot Downloads S records through a serial port and begins execution syntax boot arguments netload Downloads file via the Ethernet port to address Address defaults to bootadr syntax netload file address arguments lt opt str gt lt opt hex gt netboot Downloads file through the Ethernet port and begins execution syntax netboot file address arguments lt opt str gt lt opt hex gt Hit any key to continue Control C to quit User Commands 4 9 User Commands 4 4 2 arpshow Display Known Address Resolution Protocol Entries The arpshow command displays all known address resolution protocol ARP entries Format arpshow Parameters None Description The arpshow command displays an IP routing table entry If there are no ARP entries nothing is shown for that device The Ethernet device number displayed matches the number that is displayed when the eshow and edevice commands are entered Example DP264 gt arpshow Arp Table Contents at 0x00074570 Ethernet Device 0 IP Address 16 123 45 67 AC Address BA 98 76 54 32 10 4 10 User Commands 8 April 1999 User Commands 4 4 3 beep Test Speaker The beep command tests the speaker Format beep duration frequency Parameters duration Specifies the duration of the beep in milliseconds frequency Specifies the frequency in hertz Description The beep command causes the speaker to beep for the specified duration a
129. t value is 0 The pww command writes a word to the specified address in the PCI configuration space for a device specified by the id If the motherboard does not support PCI then this command is not implemented If your system configuration supports multiple PCI buses use the parameters to specify the PCI device Use the pcishow command to view the available PCI devices DP264 gt pww 4f 19 4 DP264 prw 4f 19 0004 4 100 User Commands 8 April 1999 User Commands 4 4 85 rb Read Byte from I O Address Space The rb command reads a byte 8 bits from a register port in I O address space Format rb register iterations silent Parameters register Specifies the register from the I O address space iterations Specifies how many times the data is read The default is 1 silent Specifies whether or not the data is displayed Setting this field to 1 causes the data to be read but not displayed The default is 0 data is displayed Description The rb command reads a byte from the specified register in I O address space Example DP264 gt rb 370 04 8 April 1999 User Commands 4 101 User Commands 4 4 86 rl Read Longword from I O Address Space The rl command reads a longword 32 bits from a register port in I O address space Format rl register iterations silent Parameters register Specifies the register from the I O address space iterations Specifies how many times the data is read The default is 1
130. the swpipl command Other commands that affect the IPL are the mcheck and the ladebug commands In the following example the IPL is lowered from 6 to 4 Example DP264 gt swpipl Current Interrupt Priority Level 6 DP264 gt swpipl 4 DP264 gt swpipl Current Interrupt Priority Level 4 DP264 gt 4 122 User Commands 8 April 1999 4 4 103 sysshow Display ROM Parameters Format Parameters Description Example 8 April 1999 The sysshow command displays all SROM parameters sysshow None User Commands The sysshow command displays the system status passed from the SROM at initializa tion or reset Refer to your motherboard s user s manual for more information about the SROM parameters displayed DP264 gt sysshow abox ctl bcro bcr2 bmrO bmr2 srom rev mem size signature Sysctx D 428 64C0 0 F00000 0 1805 2000000 ECBOOO01 0 berl bcr3 bmr1 bmr 3 proc_id cycle_cnt proc_mask valid 10064C0 0 F00000 0 4 1771 1 il User Commands 4 123 User Commands 4 4 104 tip Connect to Serial Communication Port The tip command connects to the specified serial communication port Format tip port Parameters port Specifies the serial port Description The tip command is a subset of the Tru64 UNIX t ip command It allows you to con nect directly from the motherboard to the specified serial communication port You can specify 1 for serial port
131. thernet and that use the Debug Monitor interrupt handler Do not disable the real time clock interrupt and the Ethernet interrupts for long periods Long delays may cause Ladebug to behave as if there is a problem with the Ethernet link to the target If network delays are insignificant Ladebug will tolerate periods of up to 10 seconds with interrupts disabled although it will normally warn the user of possible network problems if interrupts are disabled for more than a second Ethernet interrupts are disabled at IPL 3 or more and real time clock interrupts are disabled at IPL 5 or more Writing to the control registers of the Ethernet device or to the real time clock can also disable the interrupts It is possible to set breakpoints or to single step uninterruptible code There is no restriction on the time that can be spent at the breakpoint Programs that define or install their own interrupt handler must ensure that the Debug Monitor polls the Ethernet device often enough to receive all the messages sent to it by Ladebug An easy way to do this is to use the 1adbx po11 function When this func tion is called the following occurs e All frames that have been received on the Ethernet device are read e All remote debug frames are processed and acted upon e Any Ethernet interrupt is cleared The 1adbx poll function is a void function that takes no arguments It must be called often enough to allow the Debug Monitor to respond promptly to al
132. tility fwupdate exe from diskette The utility gets loaded into physical address 900000 6 physical location 9 MB and gets executed in PALmode This command expects the diskette to be formatted with a FAT file structure Example DP264 gt fwupdate follow instructions to update firmware for Windows NT Firmware the Debug Monitor or the Alpha SRM Console 4 62 User Commands 8 April 1999 User Commands 4 4 51 go Begin Executing Instructions The go command begins execution of instructions at the specified address Format go start_address Parameters start_address Specifies the address at which to start executing the instructions Description The go command jumps to a location in memory and begins executing instructions If no address is specified then the execution of instructions begins at the boot address Example This example starts executing instructions at address 100000 1 DP264 gt go 100000 8 April 1999 User Commands 4 63 User Commands 4 4 52 help Display Command Information Format Parameters Description Example The help command displays a list of commands currently available If you specify a command keyword information about the specified command is displayed h elp command_keyword command_keyword Indicates any command name that appears in the list when you type the help command An asterisk displays help for all commands The help command displays a list of co
133. ts to a running remote process using the connect insist protocol message instead of the connect protocol message This option functions as a request to the server to connect to the client even if some other client is already connected The previously connected client is disconnected Use only with rn and pid rp debug protocol name Specifies the remote debug protocol to be used The valid value and default is Ladebug_preemptive rt transport protocol name Specifies the transport protocol to be used for remote debug The valid value and default is UDP Note The debug server can be used only to debug already loaded processes therefore the pid option must always be specified Because the Debug Monitor is not a multiprocessing system the process id specified with this option is ignored Because using the Debug Monitor with Ladebug is a subset of general Ladebug usage the only meaningful command line has the following format using both the rn option and the pid option Sladebug size out rn dp264 pid 0 This example connects to the server on the node with IP node name dp2 64 and asks to debug the process with pid 0 The local object file is called size out Depending upon your network environment you may need to fully specify the IP node name such as dp264 mysite hlo dec com 3 6 Building the Executable File To build the executable file for remote debugging follow these steps 1 Compile your source
134. u64 UNIX 7 LINUX Linux MILO 8 VXWORKS VxWorks 10 SROM Serial ROM The bootopt command can also be used to select a ROM image based on its position in the ROM Specifying the type as 0 selects the whole ROM Specifying the type as 1 selects the first image 2 selects the second image and so on DP264 gt bootopt Predefined bootoptions are 0 Alpha Evaluation Board Debug Monitor DBM 1 The Windows NT Operating System NT 2 OpenVMS VMS 3 Tru64 UNIX UNIX 7 Linux Milo 8 VxWorks Real Time Operating System VxWorks 10 Serial ROM SROM SROM O S type selected OpenVMS Firmware type Alpha SRM DP264 bootopt 0 O S type selected Alpha Evaluation Board Debug Monitor Firmware type Alpha Evaluation Board Debug Monitor DP264 bootopt nt O S type selected The Windows NT Operating System Firmware type Windows NT Firmware Console 8 April 1999 8 April 1999 User Commands P264 gt bootopt 1 irmware image 1 selected Firmware type Unknown P264 gt bootopt unix S type selected Tru64 UNIX Firmware type Alpha SRM Console DP264 bootopt 0 Load and boot entire ROM at address zero Firmware type Unknown DP264 gt bootopt Predefined bootoptions are 0 Alpha Evaluation Board Debug Monit
135. um Header Version Firmware ID ROM Image Size Firmware ID Opt ROM offset Header Checksum Enter destination offse Flash offset Image size w header Y 4544 Press Y t Writing Flash Block 4W Verifying Flash Block DP264 romlist ROM image header found Header Size Image Checksum emory Image Size Compression Type Image Destination Header Version Firmware ID ROM Image Size lemory Image Size Compression Type Image Destination Warning About to overwrite flash memory 0x0 199524 Segment 0 to 3 inclusive AERE About to overwrite flash memory O proceed any other key to abort 0x300000 Found 56 bytes Ox6eeb 28395 0x30B2C 199468 0 0x0000000000300000 2 0 Alpha Evaluation Board Debug Monitor 0x30B2C 199468 194 KB 0200009511221015 0x00000000 0x71fb 194 KB ETURN for default 40000 t or press RI O14 0x40000 199524 Segment 4 to 7 inclusive VERTA o proceed any other key to abort 5W 6W 7W 4V 5V 6V 7V at offset 56 bytes Ox6eeb 28395 0x30B2C 199468 194 KB 0 0x0000000000300000 0x040000 0 Alpha Evaluation Board Debug Monitor 0x30B2C 199468 194 KB Change the Image Destinat Note that because no chan Checksum field after th Firmware ID Opt 0200009511221015 ds ROM offset 0x00000000 Header Checksum 0x71fb ion field from 300000 to 400000 ges were performe
136. x2000000 PCI Mem Size 0x2000000 Display controller PCI slot 19 vendor 0x8086 device 0x484 PCI IO Base 0x0 PCI IO Size 0x0 PCI Mem Base 0x0 PCI Mem Size 0x0 on VGA compatible device PCI slot 17 vendor 0x1011 device 0x2 PCI IO Base OxB000 PCI IO Size 0x80 PCI Mem Base 0x4000000 PCI Mem Size 0x80 Ethernet controller PCI slot 20 vendor 0x1000 device 0x1 PCI IO Base 0xB400 PCI IO Size 0x100 PCI Mem Base 0x4001000 PCI Mem Size 0x100 on VGA compatible device DP264 gt User Commands 4 87 User Commands 4 4 74 pfreg Display Floating Point Register State The pfreg command displays the saved CPU floating point register state Format pfreg address Parameters address Specifies an alternate address for the saved state area Description The pfreg command displays the contents of the CPU floating point registers stored in the saved state area A register state is stored when a breakpoint is encountered or the PALcode reset flow is entered Example DP264 gt pfreg Floating Point Registers register file 0000C840 00 0000000000000000 0000000000000000 0000000000000000 0000000000000000 04 0000000000000000 0000000000000000 0000000000000000 0000000000000000 f08 0000000000000000 0000000000000000 0000000000000000 0000000000000000 12 0000000000000000 0000000000000000 0000000000000000 0000000000000000
137. xample The netload command downloads the specified file through the Ethernet port to the default boot address netload file address file Specifies a legal file name to be downloaded to the motherboard The default is to load the file specified in the boot ptab file address Specifies the address at which to download the file The default is the boot address The netload command uses BOOTP to download the specified file through the Ether net port The Ethernet port is selected using the edevice command The program is loaded into the default boot address You can set up or change the boot address with the bootadr command The program can then be executed with the go or jtopal command A default file and directory path may be defined in the boot pt ab file See Section 2 3 4 2 for more information If you specify an address this address becomes the default boot address This value however is not set in battery backed RAM In this example a file called size is loaded into the default boot address DP264 gt netload size Ethernet Base Address 360 DMA Mask 1 DRO5 Init Block Address 80000 Init Done Ethernet BA 98 76 54 32 10 Attempting BOOTP success my IP address 16 123 45 67 server IP address 16 123 45 69 gateway IP address 16 123 45 69 Loading from users eval boot size Hitt 4 84 User Commands 8 April 1999 User Commands 4 4 71 next Execute Next Machine Instruction Format Paramet
138. ype number Type name Description 0 DBM Alpha Motherboard Debug Monitor 1 NT Windows NT 2 VMS OpenVMS 3 UNIX Tru64 UNIX 7 LINUX Linux MILO 8 VXWORKS VxWorks 10 SROM Serial ROM The romload command can also be used to select a ROM image based on its position in the ROM Specifying the type as 0 selects the entire ROM Specifying the type as 1 selects the first image 2 selects the second image and so on You can specify an address to override what is in the image file header You may also use the bootadr command Use the jtopal command to execute the image DP264 gt romload Loading entire Loading ROM to Loaded 1048576 DP264 gt DP264 gt romload 0 ROM address 002000 bytes from 200 1 00 000 to 300000 Searching for ROM image 1 Header Size 52 bytes Image Checksum Ox581A 22554 Image Size Uncomp 117160 114 KB Compression Type 0 Image Destination 0x0000000000300000 Header Version 1 Firmware ID 0 Alpha Evaluation Board Debug Monitor 4 108 User Commands 8 April 1999 8 April 1999 User Commands ROM Image Size 117160 114 KB Firmware ID Opt 0000000000000000 ASCII Header Checksum 0x8F5C Loading ROM to address 00300000 Image checksum verified 0x581A Loaded 117160 bytes from 300000 to 31C9A8 DP264 gt DP264 gt romload Searching for ROM image 1 Header Size 52

Alpha Microprocessors Motherboard Debug Monitor User's Guide

Contents

Download Pdf Manuals

Related Search

Related Contents