Introducing jzIntv's Debugger - Revision history

Mr z: Protected "Introducing jzIntv's Debugger" ([edit=autoconfirmed] (indefinite) [move=autoconfirmed] (indefinite))

2010-12-04T08:41:41Z

Protected "Introducing jzIntv's Debugger" ([edit=autoconfirmed] (indefinite) [move=autoconfirmed] (indefinite))

Mr z at 22:23, 8 October 2007

2007-10-08T22:23:41Z

Mr z: /* Wrapping Up */

2007-10-08T04:12:31Z

‎Wrapping Up

Mr z: /* Stepping Through */

2007-10-08T04:10:26Z

‎Stepping Through

Mr z: /* Stepping Through */

2007-10-08T04:09:16Z

‎Stepping Through

Mr z: /* Stepping Through */

2007-10-08T04:07:01Z

‎Stepping Through

Mr z: /* Wrapping Up */

2007-10-08T02:36:03Z

‎Wrapping Up

Show changes

Mr z at 01:34, 8 October 2007

2007-10-08T01:34:56Z

Mr z: /* Stepping Through Code */

2007-10-08T01:32:10Z

‎Stepping Through Code

Show changes

Mr z: /* Debugger Commands */

2007-10-08T00:59:59Z

‎Debugger Commands

← Older revision		Revision as of 22:23, 8 October 2007
Line 1:		Line 1:
		+	[[Category: Programming]][[Category: Tutorial]]
	[[jzIntv]] offers a simple command-line oriented debugger. It should be familiar in style to anyone who has used the Apple ][ Monitor or DOS's DEBUG.EXE.		[[jzIntv]] offers a simple command-line oriented debugger. It should be familiar in style to anyone who has used the Apple ][ Monitor or DOS's DEBUG.EXE.

← Older revision		Revision as of 04:12, 8 October 2007
Line 551:		Line 551:

	That concludes the quick tour of the most useful commands in jzIntv's debugger. You can quit the debugger by giving it the "Q" command. You're encouraged at this point to try single-stepping through other programs to see how the instructions work. The next tutorial aims at introducing the various families of instructions.		That concludes the quick tour of the most useful commands in jzIntv's debugger. You can quit the debugger by giving it the "Q" command. You're encouraged at this point to try single-stepping through other programs to see how the instructions work. The next tutorial aims at introducing the various families of instructions.
		+
		+	----
		+	Back to [[Programming Tutorials]].

@@ Line 441: / Line 441: @@
       WR a=02D3 d=02A7 CP-1610          (PC = $5052) t=55192
 </CODE>
-That brings us through "&nbsp;&&nbsp;Copyright"...
+That brings us through "&nbsp;&nbsp;Copyright"...
 <CODE>
 A7 0007 0290 8007 02D4 5033 02f2 5053 ----I---  [[MVI@]] R5,R0            55201

@@ Line 327: / Line 327: @@
 * Read a character
 * Is it NUL?  No:  Loop and display it
-* Subtract off 32 to map ASCII to GROM characters
+* Subtract off 32 to map ASCII to [[Graphics_ROM#GROM_Picture_Catalog|GROM]] characters
-* Shift the result left by 3 to align it as the [[STIC#Display_Background]] expects
+* Shift the result left by 3 to align it as the [[STIC#Display_Background|STIC]] expects
 * Add in the format word
 * Write the formatted character to the display at $2C9

@@ Line 262: / Line 262: @@
 = Stepping Through =
-Now let's see what the whole program does.  We'll first set a breakpoint at the last instruction, and then tell jzIntv to step to the end.
+Now let's see what the whole program does.  We'll first set a breakpoint at the last instruction, and then tell jzIntv to step to the end.  I've included some light commentary.  Later tutorials will give more in-depth explanations of what's going on.
 <CODE>
      > b503b
@@ Line 272: / Line 272: @@
       RD a=5024 d=0150 CP-1610          (PC = $5023) t=54479
       RD a=5025 d=003D CP-1610          (PC = $5023) t=54479
 C0C0 0290 8007 5022 5026 02f2 503D ----I-i-  [[MVI@]] R5,R1            54491
       RD a=503D d=02A9 CP-1610          (PC = $503D) t=54491
@@ Line 278: / Line 281: @@
       RD a=503E d=02AC CP-1610          (PC = $503E) t=54499
       RD a=5027 d=02C9 CP-1610          (PC = $503E) t=54499
 0007 0290 8007 02C9 5028 02f2 503F ----I-i-  [[B]]    $5048            54507
       RD a=503F d=0200 CP-1610          (PC = $503F) t=54507
@@ Line 287: / Line 293: @@
 000E 0290 8007 02C9 5028 02f2 504A ----I---  [[RRC]]  R1               54526
       RD a=504A d=0071 CP-1610          (PC = $504A) t=54526
 0007 0290 8007 02C9 5028 02f2 504B ----I---  [[B]]    $5053            54532
       RD a=504B d=0200 CP-1610          (PC = $504B) t=54532
       RD a=504C d=0006 CP-1610          (PC = $504B) t=54532
 0007 0290 8007 02C9 5028 02f2 5053 ----I-i-  [[MVI@]] R5,R0            54541
       RD a=5053 d=02A8 CP-1610          (PC = $5053) t=54541
@@ Line 310: / Line 322: @@
       RD a=5052 d=0260 CP-1610          (PC = $5052) t=54592
       WR a=02C9 d=0007 CP-1610          (PC = $5052) t=54592
 0007 0290 8007 02CA 5029 02f2 5053 ----I---  [[MVI@]] R5,R0            54601
       RD a=5029 d=0020 CP-1610          (PC = $5053) t=54601
@@ Line 320: / Line 345: @@
 0007 0290 8007 02CA 502A 02f2 5052 ----I-i-  [[MVO@]] R0,R4            54652
       WR a=02CA d=0007 CP-1610          (PC = $5052) t=54652
 0007 0290 8007 02CB 502A 02f2 5053 ----I---  [[MVI@]] R5,R0            54661
       RD a=502A d=0043 CP-1610          (PC = $5053) t=54661
@@ Line 410: / Line 440: @@
 A7 0007 0290 8007 02D3 5033 02f2 5052 ----I-i-  [[MVO@]] R0,R4            55192
       WR a=02D3 d=02A7 CP-1610          (PC = $5052) t=55192
 A7 0007 0290 8007 02D4 5033 02f2 5053 ----I---  [[MVI@]] R5,R0            55201
       RD a=5033 d=0020 CP-1610          (PC = $5053) t=55201
@@ Line 480: / Line 513: @@
 0007 0290 8007 02DA 503A 02f2 5052 ----I-i-  [[MVO@]] R0,R4            55612
       WR a=02DA d=0007 CP-1610          (PC = $5052) t=55612
 0007 0290 8007 02DB 503A 02f2 5053 ----I---  [[MVI@]] R5,R0            55621
       RD a=503A d=0000 CP-1610          (PC = $5053) t=55621
 0007 0290 8007 02DB 503B 02f2 5054 ----I-i-  [[TSTR]] R0               55629
 0007 0290 8007 02DB 503B 02f2 5055 ---ZI-i-  [[BNEQ]] $504d            55635
 0007 0290 8007 02DB 503B 02f2 5057 ---ZI-i-  [[SLL]]C R1               55642
       RD a=5057 d=0059 CP-1610          (PC = $5057) t=55642
@@ Line 491: / Line 534: @@
       RD a=5059 d=0061 CP-1610          (PC = $5059) t=55654
 0007 0290 8007 02DB 503B 02f2 505A ----I---  [[ADDR]] R0,R7            55660
       RD a=505A d=00C7 CP-1610          (PC = $505A) t=55660
 0007 0290 8007 02DB 503B 02f2 505B ----I-i-  [[MOVR]] R5,R7            55667
@@ Line 499: / Line 547: @@
+     >
 </CODE>
 = Wrapping Up =
 That concludes the quick tour of the most useful commands in jzIntv's debugger.  You can quit the debugger by giving it the "Q" command.  You're encouraged at this point to try single-stepping through other programs to see how the instructions work.  The next tutorial aims at introducing the various families of instructions.

← Older revision	Revision as of 08:41, 4 December 2010
(No difference)

@@ Line 1: / Line 1: @@
 [[jzIntv]] offers a simple command-line oriented debugger.  It should be familiar in style to anyone who has used the Apple ][ Monitor or DOS's DEBUG.EXE.
-= Debugger Overview =
+= Invoking the Debugger =
 To invoke the debugger, add the "-d" flag to jzIntv's command line.  For example, using "hello2.rom" from the [[Hello World Tutorial]]:
 <CODE><pre>
@@ Line 43: / Line 41: @@
 Most of this output is jzIntv's initialization.  The last portion is the debugger prompt.
-== The Debugger Prompt ==
+= The Debugger Prompt =
 <CODE><pre>
@@ Line 74: / Line 72: @@
 In the example above, jzIntv shows the CPU as taking an interrupt.  Really, it's coming out of reset, which is similar.  Don't worry too much about interrupts for the moment.
-== Introducing the Registers ==
+= Introducing the Registers =
 The CPU's [[CP1610#Registers|registers]] act as a scratch pad, holding values for instructions to operate on.  Some registers have special purposes.  All the registers can be used for general purpose computation.  Here's a quick reference to what each register can be used for.
@@ Line 94: / Line 92: @@
 You will want to pay attention to R7 to know where you are at in your program.  You can use the listing file, as [[Hello World Tutorial#Examining the Listing File|described in the Hello World tutorial]] to relate what you wrote to what the debugger shows you.
-== Debugger Commands ==
+= Debugger Commands =
 The debugger offers a series of single-letter commands.  You can find a [http://spatula-city.org/~im14u2c/intv/debugger.txt full summary here].  For this tutorial, we will focus on a small subset of these.
@@ Line 110: / Line 108: @@
 The commands are case-insensitive.  That is, "R 100"  (run 100 instructions) is the same as "r 100".  The debugger also offers a short-cut:  Pressing enter alone on a line is the same as "s 1".  That is, it steps a single instruction.
-== First Steps: Watching Things Happen ==
+= First Steps: Watching Things Happen =
 Start the debugger using "hello2.rom" from the [[Hello World Tutorial#Example_2:__Fixing_up_the_title_screen|Hello World Tutorial's Example 2]]:
@@ Line 149: / Line 147: @@
 In this particular code sequence, we can see the [[Executive ROM|EXEC]] begin to initialize itself.  First, it jumps from the start of ROM to the first real bit of code.  Then it sets up the stack pointer, and jumps to yet another subroutine.  Notice how the register values, particularly the program counter (R7), stack pointer (R6) and return address (R5) change values.  Click on the instructions themselves to get a description of what each one does.
-== Running Ahead to Our Code ==
+= Running Ahead to Our Code =
 At this point, it would be useful to jump ahead to our own program code.  The simulated Intellivision needs to run the EXEC code that leads up our program, but we want the simulation to stop at the first instruction of our code.  We accomplish this with a breakpoint.
@@ Line 211: / Line 209: @@
 </CODE>
-== Pulling It Apart ==
+= Pulling It Apart:  Disassembly and Dumping =
 Now we can look ahead at the next couple of instructions that will execute.  The "U" command will <B>U</B>nassemble the next several instructions.  "U" by itself starts at the current instruction and outputs the next several:
@@ Line 261: / Line 259: @@
 </CODE>
 The format of the memory dump is simple.  At the left is the starting address.  In the middle are hexadecimal values for 8 locations.  At the right is an ASCII representation of the data.  As you can see, starting on the second row at location $5028, the phrase "  Copyright 2007  " is right where we expect it.  The extra '.' characters between letters are due to the fact that memory locations are 16-bits wide, but characters are only 8 bits.  Additional information could be in those other bits.

← Older revision		Revision as of 00:59, 8 October 2007
Line 109:		Line 109:

	The commands are case-insensitive. That is, "R 100" (run 100 instructions) is the same as "r 100". The debugger also offers a short-cut: Pressing enter alone on a line is the same as "s 1". That is, it steps a single instruction.		The commands are case-insensitive. That is, "R 100" (run 100 instructions) is the same as "r 100". The debugger also offers a short-cut: Pressing enter alone on a line is the same as "s 1". That is, it steps a single instruction.
		+
		+	== Stepping Through Code ==
		+
		+	Start the debugger using "hello2.rom" from the [[Hello World Tutorial]]:
		+	<CODE><pre>
		+	jzintv -d hello2.rom
		+	</pre></CODE>
		+	Once at the debugger prompt, press <CODE>[Enter]</CODE> a couple of times. You should see output similar to the following:
		+	<CODE><pre>
		+	0000 0000 0000 0000 0000 0000 0000 1000 -------- JSRD R5,$1026 0
		+	>
		+	Starting jzIntv...
		+	RD a=1000 d=0004 CP-1610 (PC = $1000) t=0
		+	RD a=1001 d=0112 CP-1610 (PC = $1000) t=0
		+	RD a=1002 d=0026 CP-1610 (PC = $1000) t=0
		+	0000 0000 0000 0000 0000 1003 0000 1026 -------- MVII #$02f1,R6 12
		+	>
		+	RD a=1026 d=02BE CP-1610 (PC = $1026) t=12
		+	RD a=1027 d=02F1 CP-1610 (PC = $1026) t=12
		+	0000 0000 0000 0000 0000 1003 02f1 1028 ------i- JSR R5,$1a83 21
		+	>
		+	RD a=1028 d=0004 CP-1610 (PC = $1028) t=21
		+	RD a=1029 d=0118 CP-1610 (PC = $1028) t=21
		+	RD a=102A d=0283 CP-1610 (PC = $1028) t=21
		+	0000 0000 0000 0000 0000 102B 02f1 1A83 ------i- PSHR R5 33
		+	>
		+	RD a=1A83 d=0275 CP-1610 (PC = $1A83) t=33
		+	WR a=02F1 d=102B CP-1610 (PC = $1A83) t=33
		+	0000 0000 0000 0000 0000 102B 02f2 1A84 -------- PSHR R0 42
		+	>
		+	</pre></CODE>