Author:   Karsten Scheibler
Homepage: http://unusedino.de/ec64/
eMail:    ec64@unusedino.de


  ===========================
    [1] GENERAL INFORMATION
   =========================


The C64 was a very popular home computer in the 1980's and early 1990's.
From todays point of view, the C64 looks like a toy (no harddisk or floppy
built in [you had to buy an extra device usually a C1541 floppy disk drive],
64 KB RAM, 6510 Microprocessor clocked with 1 MHz, high resolution graphics
with 320x200). But in the good old days the users had much fun with this
machine ;-)

Although there are very good C64 emulators already available, i've started
my own emulator project in July 1999, called ec64 (emulated C64). It behaves
like a C64 with an attached C1541. The emulation works cycle oriented. At the
moment ec64 runs under Linux only.


  =======================================
    [2] SHORT INSTALLATION INSTRUCTIONS
   =====================================


Here are some short instructions for more look in the doc/ directory.

You will find a precompiled binary called ec64 in this directory, it
depends on no shared libraries it only needs a running linux kernel.

If your kernel has support for a "real" fb device you can start this binary
as normal user. If you have no fb device or you use vga16fb ec64 will try to
access the VGA registers directly, but for this task ec64 needs root rights,
either you start it as root, or you use the setuid mechanism, execute the
following commands as root:

chown root:root ec64
chmod 4111 ec64

NOTE1: vesafb may cause problems, because the driver can't change color
       depth at run time.

NOTE2: check the file permissions of your audio and fb device, if you run
       ec64 as normal user, this user must have read/write permissions
       on this devices


  ================
    [3] FILELIST
   ==============


Config		basic compile time configuration (included from every
		Makefile)
LICENSE		the license of this package (GNU Public License
		Version 2)
Makefile	the 'master' Makefile
README		this file
ec64		a precompiled binary
bin/		after 'make all' you will find the ec64 binary here
doc/		html documentation
src/		the source tree
tools/		shell scripts needed for compilation