Re: Apple //e debugger

[dempson@actrix.gen.nz (David Empson)]

Markco <onthfly@charter.net> wrote:

> Can anyone tell me the command to start the mini assembly monitor on a //e?

Do you mean the mini assembler, or the monitor?  They are different
things.

The monitor is entered from BASIC using "CALL -151" and this works on
every Apple II model.  (In this and all subsequent instructions, don't
type in the quote marks.)  To get back to BASIC, the recommended method
is to use "3D0G" if you are running under DOS 3.x or ProDOS, or Ctrl-C
if you are running without an operating system (e.g. Ctrl-Reset to the
command prompt at startup without booting).  Incidentally, the IIgs
monitor has a special "Q" command which does a 3D0G for you.

The monitor uses "*" for its prompt, and the mini-assembler uses "!".

The mini-assembler is used to enter programs in assembly language.  It
isn't built into all machines, and the details of its use vary.

For the original Apple ][, or an Apple ][+ running with an Integer card,
or an Apple ][, ][+, IIe, IIc or IIgs under DOS 3.3 with INTBASIC
loaded, you can access the original version of the mini-assembler from
the monitor using "F666G".  Once there, you get back to the monitor with
"$FF69G" (this version of the mini-assembler lets you enter any monitor
command by prefixing it with a dollar sign).

The IIgs, IIc and enhanced IIe firmware have their own implementations
of the mini-assembler, which is entered from the monitor using the "!"
command.  You can get back to the monitor by pressing the return key at
the prompt.

The IIe mini-assembler only knows about 6502 instructions (as does the
IIe monitor's disassembler).  The IIc's mini-assembler and disassembler
support 65C02 instructions.  The IIgs's mini-assemlber and disassembler
support 65816 instructions.

There is no built-in mini-assembler on an unenhanced IIe or a ][+.  (At
one stage, I used the mini-assembler from INTBASIC, relocated to run
lower in memory.)

> What commands are used in the monitor environment?

There are quite a few of them, and they are rather terse (single letters
or symbols).  The syntax is also very sensitive to details like
placement of spaces.

I would expect this to be covered in the comp.sys.apple2 FAQs.