User`s manual

Part V: Tools.
Interactive Tools:
These tools are used to interact with the Apple II from the keyboard and screen. As real Linux tools,
they can also accept I/O redirection to automate keyboard input and capture output. The other common
ability (with the exception of bintomon) of the tools is to be able to connect to Apple II Pi remotely
over the network. A final, optional argument is the IP address of the Apple II Pi computer. The tools
can be built for a multitude of Linux and Unix computers and run remotely, connecting to the Apple II
Pi.
a2mon:
The Apple 1 has a very simple monitor program that can examine and change memory, as well as
execute code. a2mon is modeled after that monitor. As such, it isn't very powerful, but can be a
valuable tool when combined with I/O redirection. You can incorporate complete programs in the
monitor format, or just change a few bytes of memory. Calling code in RAM or ROM is simple.
There is a concept of current address. To specify an address, just enter it first on the command line. To
change memory contents, enter a colon either after a specific address or by it self to use the current
address followed by the bytes separated by spaces. Reading a range of memory involves specifying two
address separated by a period. To begin execution of code (run) at a specific address or current address,
type 'r'. Finally, 'q', will quit the session and return. Run as:
a2mon [IP addr]
a2term:
Probably the most interesting of the tools, a2term connects the Linux console to the Apple II console.
a2term connects to the Apple II running ProDOS BASIC. This is roughly equivalent to using an old
serial terminal connected to a Super Serial Card and issuing commands to redirect the keyboard and
screen I/O hooks.
AppleSoft programs, ProDOS commands, and Monitor commands are all available. Like a2mon, the
input and output can be redirected to files for automated keyboard input and output capture; similar to
running the EXEC command from ProDOS (and DOS 3.3). To quit, use the ESCAPE+Q sequence. To
send an actual ESC character, press ESCAPE twice. The DELETE key has been remapped to
BACKSPACE for convenience.
There are some limitations that have to be followed. The screen editing/cursor movement keys are not
available. As mentioned before, the DELETE key now backspaces to aid editing. Do NOT leave
AppleSoft BASIC, or the mouse and keyboard will be disconnected from Apple II Pi and you will have
to re-start BASIC.SYSTEM from the A2PI boot disk. If you run a program that doesn't do any screen
or keyboard I/O, you will see that your mouse and keyboard are no longer responsive. Apple II Pi relies
on the screen and keyboard I/O hooks to provide the co-operative tasking between Apple II programs
and Pi input events. CONTROL+C will usually break into an AppleSoft program (may take a few
tries) but machine code that isn't responding will require a press of CONTROL+RESET. Not to
worry, Apple II Pi will re-sync and return to BASIC (assuming memory hasn't been overwritten). In
19
19