Apple-2-Tools/Epple-II
1
0
Fork 0
mirror of https://github.com/cmosher01/Epple-II.git synced 2025-01-15 18:30:43 +00:00
Code Issues Projects Releases Wiki Activity

more docs

Browse Source
This commit is contained in:
Christopher Mosher 2019-04-12 16:53:46 -04:00
parent 7a5eb3a972
commit 93404ef974
2 changed files with 13 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
docs/screenshots.md
View File

@ -101,8 +101,8 @@ RUN
image::pinkmystery.png[] image::pinkmystery.png[]
Jim Sather's book Jim Sather's book
[Understanding the Apple \]\[](http://www.scribd.com/doc/201423/Understanding-the-Apple-II-by-Jim-Sather-1983Quality-Software), [*Understanding the Apple \]\[*](https://archive.org/details/understanding_the_apple_ii/),
which was the primary which is the primary
reference for the internal design of the EPPLE \]\[ emulator, describes the video reference for the internal design of the EPPLE \]\[ emulator, describes the video
generation process of the Apple \]\[, in great detail, in Chapter 8. generation process of the Apple \]\[, in great detail, in Chapter 8.
On page 8-21 he shows a simple Applesoft BASIC program (shown below) On page 8-21 he shows a simple Applesoft BASIC program (shown below)

22
docs/usermanual.md
View File

@ -9,7 +9,7 @@ reference
### Overview ### Overview
Epple \]\[ (the Emulated Apple \]\[ is a free (as in GPLv3), cross-platform Epple \]\[ (the Emulated Apple \]\[ is a free (as in GPLv3), cross-platform
(Windows, Linux) emulator of the Apple \]\[ and Apple \]\[ plus computers (Windows, Linux, Mac) emulator of the Apple \]\[ and Apple \]\[ plus computers
from Apple, Inc. It strives for accurate emulation of the original machines, from Apple, Inc. It strives for accurate emulation of the original machines,
with a few extra features added. with a few extra features added.
@ -143,14 +143,14 @@ by the Apple. So for motherboard ROM, for example, specifying a base as 2DED wil
image to be loaded at offset $2DED in the ROM, which will be addressed by the Apple at image to be loaded at offset $2DED in the ROM, which will be addressed by the Apple at
memory address $FDED, because motherboard ROM *starts* at address $D000, and $D000 + $2DED = $FDED. memory address $FDED, because motherboard ROM *starts* at address $D000, and $D000 + $2DED = $FDED.
For peripheral cards, the ROM will be seen at locations `$Cs00-$CsFF`, where s is the slot For peripheral cards, the ROM will be seen at locations `$Cs00`-`$CsFF`, where s is the slot
number (1 through 7). The *seventh ROM* can be seen as locations `$C800-$CFFF`; Jim Sather number (1 through 7). The *seventh ROM* can be seen as locations `$C800`-`$CFFF`; Jim Sather
describes this functionality in describes this functionality in
http://www.scribd.com/doc/201423/Understanding-the-Apple-II-by-Jim-Sather-1983Quality-Software[Understanding the Apple II], [*Understanding the Apple II*](https://archive.org/details/understanding_the_apple_ii/page/n137),
on page 6-4, section *The Seventh ROM Chip.* The EPPLE \]\[ emulator handles this processing correctly. A card can on page 6-4, section *The Seventh ROM Chip*. The EPPLE \]\[ emulator handles this processing correctly. A card can
also have bank-switched ROM, which will show up at addresses `$D000-$FFFF` when switched in also have bank-switched ROM, which will show up at addresses `$D000`-`$FFFF` when switched in
(stealing that address range from motherboard ROM... see (stealing that address range from motherboard ROM... see
http://www.scribd.com/doc/201423/Understanding-the-Apple-II-by-Jim-Sather-1983Quality-Software[Understanding the Apple II], [*Understanding the Apple II*]https://archive.org/details/understanding_the_apple_ii/page/n117,
p. 5-26 *The 16K RAM Card*). p. 5-26 *The 16K RAM Card*).
@ -348,7 +348,7 @@ keyboard into the EPPLE \]\[, it produces an at-sign, as you would normally expe
The Apple \]\[ keyboard didn't produce lower-case letters; neither does the emulator. The Apple \]\[ keyboard didn't produce lower-case letters; neither does the emulator.
Also, the Apple couldn't produce an opening square bracket `[`, braces `{}`, vertical Also, the Apple couldn't produce an opening square bracket `[`, braces `{}`, vertical
bar `|`, or backslash `\\`. There were no up- or down-arrow keys. You cannot type these into bar `|`, or backslash `\`. There were no up- or down-arrow keys. You cannot type these into
the emulator, either. There are other, unusual, cases that are emulated correctly, the emulator, either. There are other, unusual, cases that are emulated correctly,
as well, such as typing Control in conjunction with a number key simply produces as well, such as typing Control in conjunction with a number key simply produces
that number. So typing a Control-3 is the same as just typing a 3. Also, typing that number. So typing a Control-3 is the same as just typing a 3. Also, typing
@ -462,7 +462,7 @@ language card as follows:
An overview of the I/O switches that control the language card An overview of the I/O switches that control the language card
is provided by Jim Sather in is provided by Jim Sather in
[*Understanding the Apple II*](http://www.scribd.com/doc/201423/Understanding-the-Apple-II-by-Jim-Sather-1983Quality-Software), [*Understanding the Apple II*](https://archive.org/details/understanding_the_apple_ii/page/n121),
p. 5-30, Table 5.4, as follows: p. 5-30, Table 5.4, as follows:
+==================================================================+ +==================================================================+
@ -527,7 +527,7 @@ you to type `FP` to use Applesoft BASIC, or `INT` to switch to Integer BASIC.
Note that DOS and ProDOS will make use of a firmware card only if it is in slot _zero_. Note that DOS and ProDOS will make use of a firmware card only if it is in slot _zero_.
Jim Sather, in Jim Sather, in
[*Understanding the Apple II*](http://www.scribd.com/doc/201423/Understanding-the-Apple-II-by-Jim-Sather-1983Quality-Software), [*Understanding the Apple II*](https://archive.org/details/understanding_the_apple_ii/page/n151),
on pages 6-18 through 6-21, explains on pages 6-18 through 6-21, explains
how to modify a firmware card to allow independent switching of the $F800-$FFFF how to modify a firmware card to allow independent switching of the $F800-$FFFF
ROM memory. This area is occupied by the Monitor, so it is primarily ROM memory. This area is occupied by the Monitor, so it is primarily
@ -844,7 +844,7 @@ paddle is controlled by moving the mouse up and down. The paddle buttons
are emulated by the mouse buttons (left and right click). are emulated by the mouse buttons (left and right click).
In In
[*Understanding the Apple II*](http://www.scribd.com/doc/201423/Understanding-the-Apple-II-by-Jim-Sather-1983Quality-Software), [*Understanding the Apple II*](https://archive.org/details/understanding_the_apple_ii/page/n188),
on page 7-33, Jim Sather describes soldering fixed resistors across a game connector on page 7-33, Jim Sather describes soldering fixed resistors across a game connector
to create two real-time clock references. This is emulated by the Epple \]\[. Paddle timers 2 and 3 to create two real-time clock references. This is emulated by the Epple \]\[. Paddle timers 2 and 3
are 100-microsecond and 1-millisecond references, respectively. are 100-microsecond and 1-millisecond references, respectively.