cpc4x V 0.23: (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: -------------------------------- 1. 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: -------------------------------------------- 1. To install this emulator as single user login on your system 2. 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 ) EOF (c) 1999, 2000, Ulrich Cordes