mirror of
https://github.com/dschmenk/apple2pi.git
synced 2024-11-28 09:49:27 +00:00
Doc updates and a fix for the IIGS.
This commit is contained in:
parent
da4e1efd8c
commit
01e5b82884
@ -8,7 +8,7 @@ On the Linux side, the Apple II Pi daemon runs in the background, listening to t
|
||||
|
||||
2.1 Keyboard Mapping:
|
||||
=====================
|
||||
a2pid is responsible for mapping the ASCII characters from the Apple II keyboard into modern scancodes used by the Linux input subsystem. Because of the limited number of keys, the Open-Apple and Closed-Apple keys are used as modifiers to the other keys. Open-Apple is mapped to the ALT key. Closed-Apple is used as a FN modifier key: it alters the arrow keys to HOME, END, PGUP, and PGDN. It also converts the number ksys into F1-F10 equivalents. Closed-Apple-DELETE becomes DEL instead of BACKSPACE. Two special key sequences have a backdoor function for Apple II Pi. Closed-Apple-ESC will exit the Apple II client code, returning keyboard control back to the Apple II. If you want to resume interaction with the Linux daemon, you can either press RESET, re-run the A2PI:STARTUP program, or reboot the A2PI floppy. The Open-Apple-Closed-Apple-ESC sequence will exit both the Apple II client and the Linux a2pid daemon. This is useful for installing new code, or restarting a2pid in non-daemom mode for debugging purposes.
|
||||
a2pid is responsible for mapping the ASCII characters from the Apple II keyboard into modern scancodes used by the Linux input subsystem. Because of the limited number of keys, the Open-Apple and Solid-Apple keys are used as modifiers to the other keys. Open-Apple is mapped to the ALT key. Solid-Apple is used as a FN modifier key: it alters the arrow keys to HOME, END, PGUP, and PGDN. It also converts the number ksys into F1-F10 equivalents. Solid-Apple-DELETE becomes DEL instead of BACKSPACE. Two special key sequences have a backdoor function for Apple II Pi. Solid-Apple-ESC will exit the Apple II client code, returning keyboard control back to the Apple II. If you want to resume interaction with the Linux daemon, you can either press RESET, re-run the A2PI:STARTUP program, or reboot the A2PI floppy. The Open-Apple-Solid-Apple-ESC sequence will exit both the Apple II client and the Linux a2pid daemon. This is useful for installing new code, or restarting a2pid in non-daemom mode for debugging purposes.
|
||||
|
||||
3.0 a2serclk:
|
||||
=============
|
||||
@ -16,7 +16,7 @@ a2serclk is the utility required when using the optional plug-in card for Apple
|
||||
|
||||
4.0 A2PI.PO:
|
||||
============
|
||||
The ProDOS disk image file. Inside you will find ProDOS version 1.9, MERLIN8 version 2.59 assembler, BASIC.SYSTEM version 1.5, and the STARTUP program that loads the A2PI device driver. A2PI.S is the source to the device driver developed using the MERLIN8 assembler. The device driver is loaded into the upper ProDOS BASIC buffer space so it won't interfere with BASIC programs. However, leaving BASIC will disconnect the A2PI driver and keyboard/mouse operations won't be seen in Linux until STARTUP is re-run from BASIC.
|
||||
The ProDOS disk image file. Inside you will find ProDOS version 1.9, MERLIN8 version 2.59 assembler, BASIC.SYSTEM version 1.5, the STARTUP program that loads the A2PI device driver, and the CONFIG program. A2PI.S is the source to the device driver developed using the MERLIN8 assembler. The device driver is loaded into the upper ProDOS BASIC buffer space so it won't interfere with BASIC programs. However, leaving BASIC will disconnect the A2PI driver and keyboard/mouse operations won't be seen in Linux until STARTUP is re-run from BASIC.
|
||||
|
||||
5.0 Conclusion:
|
||||
===============
|
||||
|
@ -43,7 +43,7 @@ These tools are used to interact with the Apple II from the keyboard and screen.
|
||||
|
||||
3.1 a2mon:
|
||||
----------
|
||||
The Apple 1 has a very simple monitor program that can examine and change memory, as well as execute code. a2mon is modelled 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.
|
||||
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.
|
||||
|
||||
@ -69,7 +69,7 @@ There are some limitations that have to be followed. The screen editing/cursor
|
||||
|
||||
Run as:
|
||||
|
||||
a2term [IP addr]
|
||||
a2term [IP addr]
|
||||
|
||||
4.0 Development Tools:
|
||||
======================
|
||||
|
BIN
src/A2PI.PO
BIN
src/A2PI.PO
Binary file not shown.
Loading…
Reference in New Issue
Block a user