mirror of
https://github.com/cmosher01/Epple-II.git
synced 2024-08-14 10:29:12 +00:00
fix stub readme
This commit is contained in:
parent
cd70bbf24f
commit
392ec64835
129
README.asciidoc
129
README.asciidoc
@ -1,14 +1,16 @@
|
|||||||
epple2 (Emulated Apple ][)
|
epple2 (Emulated Apple ][)
|
||||||
--------------------------
|
==========================
|
||||||
|
Christopher A. Mosher <chris@mosher.mine.nu>
|
||||||
|
|
||||||
|
Home page: http://mosher.mine.nu/epple2[]
|
||||||
|
|
||||||
epple2 is an emulator of the Apple ][ and Apple ][ plus
|
+epple2+ is an emulator of the *Apple ][* and *Apple ][ plus*
|
||||||
computers from Apple, Inc. It strives to faithfully simulate
|
computers from Apple, Inc. It strives to faithfully simulate
|
||||||
much of the internal workings of the original Apple ][,
|
much of the internal workings of the original Apple ][,
|
||||||
including the individual cycles of the 6502 CPU, and the
|
including the individual cycles of the 6502 CPU, and the
|
||||||
NTSC video signal generation, including the "strange orange
|
NTSC video signal generation, including the ``strange orange
|
||||||
line", other color anomalies, and the "floating data bus."
|
line'', other color anomalies, and the ``floating data bus.''
|
||||||
Understanding the Apple ][, by Jim Sather, is the primary
|
_Understanding the Apple ][_, by Jim Sather, is the primary
|
||||||
source for information about the internals of the Apple ][.
|
source for information about the internals of the Apple ][.
|
||||||
|
|
||||||
The CPU and video timings are synchronized, and the emulator
|
The CPU and video timings are synchronized, and the emulator
|
||||||
@ -18,118 +20,11 @@ several different types of television screens and monitors
|
|||||||
for the display.
|
for the display.
|
||||||
|
|
||||||
It includes emulation of a Disk ][ controller card, a ROM
|
It includes emulation of a Disk ][ controller card, a ROM
|
||||||
firmware card, and a RAM "Language" card, as well as a
|
firmware card, and a RAM Language card, as well as a
|
||||||
simple clock card.
|
simple clock card.
|
||||||
|
|
||||||
epple2 is written in C++, and is designed to be buildable
|
+epple2+ is written in C++, and is designed to be buildable
|
||||||
on Windows (with MSYS/MinGW or Visual C++ 2008, Express
|
on Linux (gcc) or Windows (mingw). http://www.libsdl.org/[SDL]
|
||||||
Edition) or Linux (gcc).
|
is the only dependency.
|
||||||
|
|
||||||
The SDL library (http://www.libsdl.org) is the only dependency
|
+epple2+ is released under GPLv3.
|
||||||
of epple2 (see below).
|
|
||||||
|
|
||||||
The epple2 is released under GPLv3.
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
RUNNING
|
|
||||||
-------
|
|
||||||
SDL:
|
|
||||||
To run epple2, you need to have the SDL libraries installed.
|
|
||||||
See http://www.libsdl.org for information on SDL.
|
|
||||||
You'll need to download and install the "Runtime Libraries"
|
|
||||||
for your platform (Win32 or Linux).
|
|
||||||
|
|
||||||
ROM:
|
|
||||||
With epple2 and SDL, you can run the emulator, but it won't
|
|
||||||
do too much without the appropriate Apple ROM code. You can
|
|
||||||
use ROM images from your own original Apple ][ or ][ plus, or
|
|
||||||
you can find some on the Internet (check the Asimov Apple
|
|
||||||
repository).
|
|
||||||
Alternatively, you can build the ROMs yourself from assembly
|
|
||||||
language source files I've created; these are available in
|
|
||||||
the apple2src project. (See that project for details).
|
|
||||||
|
|
||||||
Disks:
|
|
||||||
You will also probably want floppy disk images. Again, you can
|
|
||||||
download some from the Internet, especially from Asimov. The
|
|
||||||
epple2 only reads NIBBLE IMAGES. If you only have 16 sector
|
|
||||||
images, you will need to convert them to nibble images; you
|
|
||||||
can use CiderPress (http://ciderpress.sourceforge.net).
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
BUILDING
|
|
||||||
--------
|
|
||||||
See INSTALL for generic instructions on building and installing
|
|
||||||
a normal distribution.
|
|
||||||
|
|
||||||
If you want to build epple2 from the source distribution,
|
|
||||||
you'll need to have the SDL development libraries installed.
|
|
||||||
See http://www.libsdl.org for information on SDL.
|
|
||||||
You'll need to download and install the "Development Libraries"
|
|
||||||
for your platform (Win32 or Linux).
|
|
||||||
|
|
||||||
Developers fetching directly from the repository instead of
|
|
||||||
downloading the distribution will need to execute the bootstrap
|
|
||||||
script before running ./configure or make.
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
PLATFORM-SPECIFIC BUILDING
|
|
||||||
--------------------------
|
|
||||||
|
|
||||||
Windows/MSYS
|
|
||||||
--------------
|
|
||||||
Install MSYS into C:\MSYS\1.0
|
|
||||||
Install MinGW into C:\mingw
|
|
||||||
|
|
||||||
Install SDL. At http://www.libsdl.org/ find the download page.
|
|
||||||
Download the "Development Libraries" for Win32, mingw, for example:
|
|
||||||
SDL-devel-1.2.13-mingw32.tar.gz (Mingw32)
|
|
||||||
And save it to your MSYS home directory.
|
|
||||||
Untar the SDL archive to your home directory:
|
|
||||||
$ cd
|
|
||||||
$ tar xzvf SDL-devel-1.2.13-mingw32.tar.gz
|
|
||||||
Then follow the instructions to install SDL, for example:
|
|
||||||
$ cd SDL-1.2.13
|
|
||||||
$ make native
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
Run MSYS, and at the bash prompt, go to your home directory and
|
|
||||||
untar the epple2 source distribution tar file and cd to the
|
|
||||||
epple2 directory. For example:
|
|
||||||
$ cd
|
|
||||||
$ tar xzvf epple2-1.0.tar.gz
|
|
||||||
|
|
||||||
NOTE: If you checked out epple2 from subversion, rather
|
|
||||||
than downloading the distribution, you need to first run
|
|
||||||
the bootstrap script. But first you'll need to install
|
|
||||||
autoconf, automake, etc.
|
|
||||||
$ cd
|
|
||||||
$ cd epple2
|
|
||||||
$ ./bootstrap
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
Then build as follows. I recommend doing a VPATH build, in
|
|
||||||
which you build into a different directory that the source
|
|
||||||
directory. To accomplish this, create a new directory for
|
|
||||||
building, somewhere, such as:
|
|
||||||
$ cd
|
|
||||||
$ mkdir buildepple2
|
|
||||||
$ cd buildepple2
|
|
||||||
Then run configure from there. For the MSYS build to work,
|
|
||||||
you need some extra parameters to the build, and you could
|
|
||||||
also add some compiler options to optimize the build. For
|
|
||||||
example (from the buildepple2 directory you just created):
|
|
||||||
$ ~/epple2/configure --prefix= \
|
|
||||||
CXXFLAGS="-I/usr/include -O4 -msse3" \
|
|
||||||
CFLAGS="-I/usr/include" \
|
|
||||||
LDFLAGS="-L/usr/lib -mconsole -mthreads -mno-cygwin"
|
|
||||||
$ make
|
|
||||||
$ make install
|
|
||||||
|
|
||||||
Then follow the instruction above under "RUNNING" for ROM and disks.
|
|
||||||
|
Loading…
Reference in New Issue
Block a user