From: Jarek Adamski <zxvgs@yarek.com>
Date: 2003-05-15 10:47:56
Content-Type: text/plain


This file is short description how to install ZXVGS on the ZX Spectrum +3 and
the XZX 2.9.0 emulator in ZX Spectrum +3 mode. ZXVGS is operating system for
ZX Spectrum compatibile computers.


New ROM checks presence of extra RAM (this is dedicated for emulators) and in
case of fault displays message and hardware patch schematics.


To run ZXVGS on real hardware using MS-DOS:
 1. The computer must be properly upgraded or have the PL3MEM interface. To
get the hardware patch schematics, run ZX Spectrum +3 emulation on any
emulator and choose the "ZXROMPL3.ROM" file as ROM. The patch means
repleacing one of ROM chips (IC8) with 62256 static memory and the second
(IC7) with EPROM (programmed with "ZXROMPL3.ROM"). Because the ULA enables
the IC8 only for reading, there's need for extra selection logic. The patch
includes also write-protection of the 62256, when other memory is selected.
(ZXVGS works without this, but it is easy to damage system data.)
 2. Unpack archive to any pleace of disk. You don't have to make subdirectory, 
as the archive already has it.
 3. Call the "ZXVGSPL3" subdirectory that was made while unpacking.
 4. Into the "ZXVGS" subdirectory you can add files to be pleaced on the
diskimage.
 5. Execute the "ZXVGSPL3.BAT" script. It will:
    - make "C:\ZXVGS" directory (if not existed),
    - copy file "MKVGSVGS.SYS" from "ZXVGS" subdirectory to "C:\ZXVGS",
    - make bootable diskimage "ZXVGSPL3.DSK".
 6. Copy the "ZXVGSPL3.DSK" file to a blank floppy disk with CPDWRITE.EXE,
typeing:
    CPDWRITE.EXE ZXVGSPL3.DSK
 7. Boot the computer from so prepared floppy dysk.
 8. After copying the diskimage to a floppy disk, files can be copied with
DTOC.EXE and CTOD.EXE of 22DISK by Sydex (proper "CPMDISKS.DEF" file is
included). Also QTRANS.EXE is able to copy the diskimage to this floppy disk
(as the CPDWRITE.EXE made the neccesary formatting).



To run ZXVGS PL3 on the XZX 2.9.0 emulator:
 1. Find the "xzx-2.9.0.tar.gz" archive and unpack it under Linux into the
"xzx-2.9.0/" directory (this directory is included in archiwe).
 2. Call the "xzx-2.9.0/" directory then run command:
	configure --enable-registered=no
 3. In file "xzx-2.9.0/src/free/monitor1.y" find function:
"static int yyerror(const char *s) { YYABORT; }" and remove the line
containing "YYABORT;" - to leave only empty "{}". Otherwise this functions
causes problems while compilation.
 4. In directory "xzx-2.9.0/src/" repleace the file "mem.c" with the one from
ZXVGS archive (write-protection of ROM2 and ROM3 is removed).
 5. In directory "xzx-2.9.0/src/free/" repleace the file "fdc.c" with the one
from ZXVGS archive (reworked at all - PLUS3DOS sevice is removed, sector
position calculation is improved). The registered XZX should work without
need of "fdc.c" file repleacing, however it is not tested.
 6. After above changes compile the emulator being in "xzx-2.9.0/" directory
with command:
	make
 7. When you replece the "mem.c" and "fdc.c" files after first compilation is
made - remeber to delete the "mem.o" and "fdc.o" files before "make".
 8. After compilation you can repleace the "plus3.rom" file with
"zxrompl3.rom" file in directory "xzx-2.9.0/roms/". The "zxrompl3.rom" can be
joined with itself to get 64kB, to avaid emulator warning). This step isn't
neccesary as ROM can be selected later.
 9. At the end (best as "root" user, due to permissions for directories in
"/usr/local/"), in the "xzx-2.9.0/" run the command:
	make install
what will make the emulator available to all users.
 10. Under MS-DOS (only, unfortunately) make the system disk diskimage (see
above installation on real hardware for details).
 11. After starting the emulator, press <F9> and select ZX+3. If the ROM is
correctly changed, after a moment the emulator should display a file selector
for "*.DSK" file. Select the system disk diskimage (made before under MS-DOS
with QTRANS.EXE).
 12. The emulator can be also started so:
	xzx -ma 3 -rompl3 zxrompl3.rom -fda zxvgspl3.dsk

There are still problems after changing disks (the emulator has also problems
with it - possibly due my patches). Unfortunately the the XZX debugger
doesn't help to see what is going on.


When you change directory using cyan requester remember to type "/" at the
end.


Files with archives on HTTP servers ("nnn" are three digits):
	ZXnnnMB2.zip	- archive with version dedicated files
	ZXVGSnnn.zip	- archive with hardware independent files
	XZX290F.zip	- XZX emulator with patches (see points 3, 4, 5) 450kB

Archives with the "*.V00" files:
	demos001.zip
	games001.zip
	games002.zip
	utils001.zip
	zines001.zip

Jarek Adamski
mailto:zxvgs@yahoogroups.com 
	(maillist subscription: mailto:zxvgs-subscribe@yahoogroups.com)
mailto:zxvgs@yarek.com
http://zxvgs.yarek.com/
http://groups.yahoo.com/group/zxvgs/files/
news://alt.pl.comp.spectrum

2003-04-19 english translation
2001-09-28 (C) Yarek.
