My english is not so good, I hope you understand what I write here.
---
(At the end there are some screen snapshots when yaze-ag-2.20 starts.)
---
Install yaze-ag-2.20:
=====================
Sections:
1. SOLARIS 8 (Sparc)
2. LINUX
3. FreeBSD
4. Cygwin (Windows)
5. Mac-OS-X (not yet ready)
1. If you want to run yaze-ag under SOLARIS 8 (Sparc) then
(gcc 3.x.x)
copy Makefile_solaris to Makefile
edit Makefile in the section optimizing: Refer the
switches -mcpu in "man gcc" and set the switches
like your hardware (default: v9)
then call "make"
If you want to install the emulator in the system read the
notes above in this document.
To install the files in /usr/local/bin and /usr/local/lib/yaze
give the command "make install" as root.
2. If you want to run yaze-ag unter LINUX then
(gcc version 3.3 20030226 (prerelease) (openSuSE)
copy Makefile_linux to Makefile
edit Makefile in the section optimizing:
Refer the section optimizing (gcc 2.x.x and gcc 3.x.x) and
set -march like your hardware (default: -march=pentium3)
then call "make".
If you want to install the emulator in the system read the
notes above in this document.
To install the files in /usr/local/bin and /usr/local/lib/yaze
give the command "make install" as root.
3. If you want to run yaze-ag under FreeBSD then
copy Makefile_freebsd to Makefile
edit Makefile in the section optimizing:
Refer the section optimizing (gcc 2.x.x and gcc 3.x.x) and
set -march like your hardware (default: -march=pentium3)
then call "make".
If you want to install the emulator in the system read the
notes above in this document.
To install the files in /usr/local/bin and /usr/local/lib/yaze
give the command "make install" as root.
4. If you want to run yaze-ag under Cygwin (Windows) then
(gcc version 3.3.2 (cygwing special))
copy Makefile_cygwin to Makefile
edit Makefile in the section optimizing:
Refer the section optimizing (gcc 2.x.x and gcc 3.x.x) and
set -march like your hardware (default: -march=pentium3)
then call "make".
If you want to install the emulator in the system read the
notes above in this document.
To install the files in /usr/local/bin and /usr/local/lib/yaze
give the command "make install".
4. If you want to run yaze-ag under Mac-OS-X then
(gcc ?.?.?)
You have to use the Makefile_solaris
Refer to section "SOLARIS".
Which switches are to set, that I don't know at this time.
Notes if you want to install yaze-ag in your system
===================================================
"make install" do following: (BINDIR, LIBDIR ... are defined in the Makefiles)
in BINDIR
install yaze_bin (yaze-ag executable (the Z80 emulator))
install cdm (CP/M Disk Manager)
install yaze (a shell script which copies some CP/M disks
if necessary and starts yaze_bin, see yaze(1))
symbolic link cpm --> yaze
symbolic link z80 --> yaze
in LIBDIR
install yaze-cpm3.boot (bootsys + cpm3.sys) (ZPM3)
install yaze.boot (Superdos a CP/M 2.2 replacement)
in MANDIR
install yaze.1 (man page of yaze-ag)
install cdm.1 (man page of the CP/M Disk Manager)
install cpm.1 (reference to yaze.1)
install z80.1 (reference to yaze.1)
in DSKDIR
Install some disks which are copied by the shell script "yaze"
to $HOME/cpm if necessary (have a look to yaze(1) ).
in DOCDIR
install the whole documentation there. The shell script "yaze"
makes links to this documents in $HOME/cpm/doc.
in DOCHTMLDIR
install the whole documentation there in HTML format. The shell
script "yaze" makes links to this documents in $HOME/cpm/doc_html.
How do you start yaze-ag?
=========================
Start YAZE-AG-2.20 with the shell script "yaze". Look to yaze.1 or
yaze(1) (man yaze) it describes also the strategy of the shell script yaze.
If you does no changes in the Makefile yaze-ag (yaze_bin) will be compiled
with the options -DMMU and -DBOOTSYS. So yaze-ag will load and run
yaze-cpm3.boot at 0100H (BOOTSYS.com+CPM3.SYS) instead of yaze.boot (CP/M 2.2).
If the option -DBOOTSYS is deleted yaze-ag starts CP/M 2.2 (yaze.boot) - then
you can start CP/M 3.1 by simple running cpm3.com (the unix file yaze-cpm3.boot
is the same as cpm3-ok.com).
If you delete the option -DMMU yaze-ag can run only CP/M 2.2 (yaze.boot) then
you have to delete -DBOOTSYS too.
Dokumentation
=============
Look to 00-INDEX.doc it describes the several document files!
The whole dokumentation are in yaze-ag.doc, yaze.doc and the README's,
Yaze-ag.doc and README_BOOTSYS describes my new CP/M 3.1 Bootloader BOOTSYS and
describes why I had to developed BOOTSYS and how BOOTSYS works.
README_BIOS3_Z80 describes the Z80 ASM-files of the CP/M 3.1 BIOS on drive P:
which act as an interface to the yaze-bios (bios.c).
On every yaze-disk is a file with the name "0-README.1ST". This file describes
the contents of the disk.
Let me know if you test yaze-ag-2.20 or if you find an error or you miss a
feature. Feel free and send an email to me.
08 June 2008
Andreas Gerlich
(University of Ulm, Germany)
only text emails please: 
(SPAM-Account)
-------------------------------------------------------------------------------
* Begin of screen snapshoots *
Screen snapshoots of YAZE-AG-2.20 at start:
===============================================================================
$ yaze
Yet Another Z80 Emulator by AG, version 2.20 (MMU)
Copyright 1995,1998 Frank D. Cringle. Pagetables Copyright by Michael Haardt.
MMU and CP/M 3.1 extensions Copyright (c) 2000,2008 by Andreas Gerlich.
yaze-ag comes with ABSOLUTELY NO WARRANTY; for details
see the file "COPYING" in the distribution directory.
RAM: 1024 KByte, 4 KByte PAGESIZE, 256 PAGES
MMU: 16 TABLES, 16 PAGEPOINTERS per TABLE, selected MMU-PAGETABLE: 0
Running '/usr/local/lib/yaze/yaze-cpm3.boot'
BOOTSYS - CPM3.SYS, V 1.20 12.03.2005 Copyright (c) 2000,2008 by A.Gerlich
No CP/M vektors found, try to boot CP/M 3.1 in cooperation with yaze-ag ...
Loading CP/M 3.1 ...
62K TPA
DRIVES: A B . . E F G H I J . . M N O P
CP/M 3.1 BIOS for yaze-ag, V 1.00 15.01.2002, Copyright (c) by A.Gerlich
A>
A>
A>
A>mmuprint (<-- Prints the status of the MMU)
RAM: 1024 KByte, 4 KByte PAGESIZE, 256 PAGES
MMU: 16 TABLES, 16 PAGEPOINTERS per TABLE, selected MMU-PAGETABLE: 1
Z80-\ T00 T01 T02 T03 T04 T05 T06 T07 T08 T09 T10 T11 T12 T13 T14 T15
ADDR \--------------------------------------------------------------------------
0000 : 10 > 0< 20 30 40 50 6E 1F 8E 9E AE BE CE DE EE FE
1000 : 1 > 11< 21 31 41 51 6D 2F 8D 9D AD BD CD DD ED FD
2000 : 2 > 12< 22 32 42 52 6C 3F 8C 9C AC BC CC DC EC FC
3000 : 3 > 13< 23 33 43 53 6B 4F 8B 9B AB BB CB DB EB FB
4000 : 4 > 14< 24 34 44 54 6A 5F 8A 9A AA BA CA DA EA FA
5000 : 5 > 15< 25 35 45 55 69 6F 89 99 A9 B9 C9 D9 E9 F9
6000 : 6 > 16< 26 36 46 56 68 7F 88 98 A8 B8 C8 D8 E8 F8
7000 : 7 > 17< 27 37 47 57 67 77 87 97 A7 B7 C7 D7 E7 F7
8000 : 8 > 18< 28 38 48 58 66 76 86 96 A6 B6 C6 D6 E6 F6
9000 : 9 > 19< 29 39 49 59 65 75 85 95 A5 B5 C5 D5 E5 F5
A000 : A > 1A< 2A 3A 4A 5A 64 74 84 94 A4 B4 C4 D4 E4 F4
B000 : B > 1B< 2B 3B 4B 5B 63 73 83 93 A3 B3 C3 D3 E3 F3
C000 : C > 1C< 2C 3C 4C 5C 62 72 82 92 A2 B2 C2 D2 E2 F2
D000 : D > 1D< 2D 3D 4D 5D 61 71 81 91 A1 B1 C1 D1 E1 F1
E000 : E > 1E< 2E 3E 4E 5E 60 70 80 90 A0 B0 C0 D0 E0 F0
F000 : F > F< F F F F F F F F F F F F F F
--------------------------------------------------------------------------------
A>
A>
===============================================================================
Screen output of YAZE-AG-2.20 if CP/M 3.1 is already running and you
would start CPM3.COM (BOOTSYS transferes BOOTSYS and the joined CPM3.SYS
from bank 1 (TPA bank) to bank 0 (SYS bank) switch to bank 0 and starts
CP/M 3.1 in bank 0):
===============================================================================
$ yaze
Yet Another Z80 emulator ...
... (see above)
...
...
CP/M 3.1 BIOS for yaze-ag ...
A>
A> (<-- CP/M 3.1 is running)
A>
A>cpm3
BOOTSYS - CPM3.SYS, V 1.20 12.03.2005 Copyright (c) 2000,2008 by A.Gerlich
CP/M 3.1 is already running and bank 1 is selected! Now move all to bank 0 ...
Now all is transfered and bank 0 is selected -> CPM3.SYS will be loaded. :-)
(this message comes after a switch from bank 1 to bank 0)
Loading CP/M 3.1 ...
62K TPA
DRIVES: A B . . E F G H I J . . M N O P
CP/M 3.1 BIOS for yaze-ag, V 1.00 15.01.2002, Copyright (c) by A.Gerlich
A>
A>
===============================================================================
Screen output of YAZE-AG-2.20 if CP/M 2.2 is started and CPM3.COM will be run:
(if -DBOOTSYS is deleted in the Makefile the output is the same)
===============================================================================
$ yaze -l -1 -b yaze.boot (-l (loading address) must be -1 to relocate the
the CP/M 2.2 (superdos) in yaze.boot.)
Yet Another Z80 Emulator by AG, version 2.20 (MMU)
Copyright 1995,1998 Frank D. Cringle. Pagetables Copyright by Michael Haardt.
MMU and CP/M 3.1 extensions Copyright (c) 2000,2008 by Andreas Gerlich.
yaze-ag comes with ABSOLUTELY NO WARRANTY; for details
see the file "COPYING" in the distribution directory.
RAM: 1024 KByte, 4 KByte PAGESIZE, 256 PAGES
MMU: 16 TABLES, 16 PAGEPOINTERS per TABLE, selected MMU-PAGETABLE: 0
Running '/usr/local/lib/yaze/yaze.boot'
A>
A> (<-- CP/M 2.2 (superdos) is running and bank 0 is selected)
A>
A>cpm3
BOOTSYS - CPM3.SYS, V 1.20 12.03.2005 Copyright (c) 2000,2008 by A.Gerlich
Loading CP/M 3.1 ...
62K TPA
DRIVES: A B . . . F G H . . . . M N O P
CP/M 3.1 BIOS for yaze-ag, V 1.00 15.01.2002, Copyright (c) by A.Gerlich
A>
A> (<-- CP/M 3.1 is running)
A>
===============================================================================
* End of screen snapshoots *