cpc4x V 0.24: (c) 1999, 2000, 2001, Ulrich Cordes

This is a beta version of a AMSTRAD CPC emulator for X11. I build it with S.u.S.E. Linux.

IMPORTANT

     If you have installed an earlier version of cpc4x than 0.20, please 
     rename the "cpc" directory in your (or every users) home directory
     to "cpc_old" first.

     Only after this, the emulator will be installed correctly while its first
     start! Later you must copy your "dsk" files from the "cpc_old/disc" to the
     "cpc/disc" directory.

You can compile this emulator as system administrator and makes so the emulator useable for all users on the machine where you install it. In that case you need root access.

If you do not have root access, you must compile the emulator in single user mode.

Sytemadministrator installation:

Login as root and extract the cpc4x_***.tgz file in a directory of your choise, e.g. /usr/src/SOURCE. Use the following shell command for extract

tar -xvzf cpc4x.tgz

A subdirectory "cpc" will be created automaticaly. After extracting change with "cd cpc" into the new directory.

2. If you use an Intel based operating system (386 or higer) goto step 5

3. Now you must find out what kind of microprocessor you use. Is it a high

endian (INTEL 386 or higher) or a low endian (?) type. To find it out, translate the file "processor.c" with the following command:

cc -o processor src/processor.c

Start the test program now by typing "./processor". The test program should show, if you use a high endian or a low endian processor.

4. Edit the "Makefile.admin" file and choice the right processor type

in the first lines. Set the variable PROCESSOR to -DLSB_FIRST if you use a low endian processor or to -DMSB_FIRST if you use a high endian one.

5. Set in the Makefile.admin the installation directory where the emulator binary

file will be copied to after "make -f Makefile.admin install" command.

INSTALLDIR = /usr/lib/cpc

As next set the user working directory, which will be created in every users home directory, if the user starts the emulator the first time.

USERSUBDIR = cpc

Set the BINDIR variable to a directory which is included by the PATH variable. The Makefile will create a script file there which starts the emulator by typing "cpc". Example:

BINDIR = /usr/X11/bin

6. Type

     make -f Makefile.admin config
     make -f Makefile.admin 
     make -f Makefile.admin install
     make -f Makefile.admin clean

Now the emulator should be installed in the directory structure as been describe in the doc/DirectoryStructure.txt file.

Every user can start the emulator by typing the command "cpc"

Single user installation for no root access:

To install this emulator as single user login on your system
Copy the cpc4x_***.tgz file to your home directory and extract it with the shell command:

tar -xvzf cpc4x.tgz

A subdirectory "cpc" will be created automaticaly. After extracting change with "cd cpc" into the new directory.

3. If you use an Intel based operating system (386 or higer) goto step 6

4. Now you must find out what kind of microprocessor you use. Is it a high

endian (INTEL 386 or higher) or a low endian (?) type. To find it out, translate the file "processor.c" with the following command:

cc -o processor src/processor.c

Start the test program now by typing "processor". The test program should show, if you use a high endian or a low endian processor.

5. Edit the "Makefile.user" and choice the right processor type in the first

lines. Set the variable PROCESSOR to -DLSB_FIRST if you use a low endian processor or to -DMSB_FIRST if you use a high endian one.

6. Set in "Makefile.user" the variables INSTALLDIR = $(HOME)/cpc,

the USERSUBDIR = /cpc and the BINDIR = $(HOME)/bin

7. If not exists, create a "bin" directory in your home directory with

mkdir $HOME/bin

8. Type

     make -f Makefile.user config
     make -f Makefile.user 
     make -f Makefile.user install

     To clean up type   rm -r src/*.o     
     Do not(!) use      make -f Makefile.user clean!!!

Now you can start the CPC emulator by typing "cpc".

The emulator do not work perfect now, but you can use it to run your old CPC basic programs. I work hard on the emulator but I need time for it. If you want to help me, pleas contact me.

Keys

F1 - Info and help dialog
F3 - insert a disk image as A:
F4 - insert a disk image as B:
F7 - shows a setup dialog
F8 - resets the emulation
F12 - exit the emulation

Author

Ulrich Cordes
Vor der Dorneiche 1
34317 HABICHTSWALD

GERMANY

email: ulrich.cordes@gmx.de
WWW: http://www.amstrad-cpc.de (my CPC homepage in english language)

http://www.schneider-cpc.de (my CPC homepage in german language )