mirror of
https://github.com/cmosher01/Epple-II.git
synced 2025-01-01 04:29:18 +00:00
74 lines
3.5 KiB
Plaintext
74 lines
3.5 KiB
Plaintext
== Download
|
|
|
|
[TIP]
|
|
Usable Apple ROMs (proprietary
|
|
footnoteref:[disclaimer,You must
|
|
respect the fact that the Apple
|
|
System Software and
|
|
Apple Disk Operating System (DOS) Software are
|
|
_proprietary_ software; they are copyright by Apple and/or others. This web page is not
|
|
providing any advice as to the legality of any copying or downloading you may perform.
|
|
])
|
|
are available at the http://mosher.mine.nu/apple2/[Apple II Library].
|
|
|
|
The following software is licensed under
|
|
http://www.gnu.org/licenses/gpl-3.0-standalone.html[GPLv3].
|
|
|
|
Epple ][ Program:: link:download/epple2-{VERSION}.tar.gz[epple2-{VERSION}.tar.gz]
|
|
|
|
See <<building>> on how to build from sources.
|
|
|
|
Source code is hosted on github:
|
|
https://github.com/cmosher01/Epple-II/[Epple-II]
|
|
|
|
|
|
== What To Download
|
|
|
|
=== Epple ][ Program—The Hardware (Emulated)
|
|
|
|
The _Epple ][ Program_ package is the emulator itself, which emulates the
|
|
Apple ][ or Apple ][ plus _hardware_, as well as the
|
|
<<cards>> hardware. This is the main program, so you will
|
|
certainly need to download this package. To have a full functioning emulator,
|
|
you will also need System ROMs and Card ROMs, as described in the following
|
|
sections.
|
|
|
|
anchor:firmware[]
|
|
|
|
=== System ROMs—The Main System Firmware (Demo or Real)
|
|
|
|
Since the Epple ][ program emulates only the hardware, you will also need to download some _system software_
|
|
for it to run. This is commonly called ``firmware'' or ``ROMs,'' because it is stored in the
|
|
read-only memory area of the emulated system. The original system software on the
|
|
Apple ][ machines is copyright by Apple, and is proprietary. If you own an actual
|
|
Apple ][ or Apple ][ plus machine, you can copy footnoteref:[disclaimer] the firmware
|
|
from it ($D000-$FFFF) (into a file on your PC) and use it. Alternatively, you can
|
|
download footnoteref:[disclaimer] the firmware images from the http://mosher.mine.nu/apple2/[Apple II Library].
|
|
|
|
If you do not want to download the proprietary firmware, you can still use the emulator (albeit
|
|
in a rudimentary manner) with the free (GPLv3) _System ROM (Demo)_ package (included with the EPPLE ][ download).
|
|
The source code is also available; you can
|
|
assemble it using the http://www.floodgap.com/retrotech/xa/[xa Assembler] .
|
|
The Demo System ROM only provides commands to dump or set memory bytes,
|
|
or run a program in memory. It is not compatible with any Apple software, nor can it read from disks.
|
|
It's just a free simple demo system to make the emulator do something reasonable.
|
|
|
|
=== Card ROMs—The Peripheral Card Firmware
|
|
|
|
If you are going to use the Disk ][ Controller peripheral card (which you almost certainly will, if
|
|
you want to read any floppy disk images), you will need to have to original ROMs from Apple.
|
|
No demo of the Disk ROMs are provided here; you will need to
|
|
use the original ROMs, which can be obtained from an original machine (by copying footnoteref:[disclaimer]
|
|
it from $C600-$C6FF into a file on the PC), or by downloading footnoteref:[disclaimer] it
|
|
from the http://mosher.mine.nu/apple2/[Apple II Library].
|
|
(And, of course, you will need the real Apple System ROM, as noted in the previous section,
|
|
not the Demo System ROM.)
|
|
|
|
If you are using any of the clock, the standard output, or the
|
|
standard input <<cards>>, you will need to download their firmware as well,
|
|
which are contained in the _Card ROMs_ package. You can choose either binary format
|
|
(ready to run) or source format (to assemble it yourself using the
|
|
http://www.floodgap.com/retrotech/xa/[xa Assembler]).
|
|
If you are _not_ going to use the stdin, stdout, or clock
|
|
cards, then you do not need to download this package.
|