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.12 starts.)
---
Install yaze-ag-2.12:
=====================
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 and -mtune in "man gcc" and set the switches
like your hardware (default: none)
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) (SuSE Linux))
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 -mcpu like your hardware (default: -mcpu=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 -mcpu like your hardware (default: -mcpu=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 -mcpu like your hardware (default: -mcpu=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 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.12 with the shell script "yaze". Look to yaze.1 or
yaze(1) (man yaze) it describes also the strategy of the 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.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.12 or if you find an error or you miss a
feature. Feel free and send an email to me.
24. August 2005
Andreas Gerlich (email: removed !!!)
(University of Ulm, Germany)
-------------------------------------------------------------------------------
* Begin of screen snapshoots *
Screen snapshoots of YAZE-AG-2.12 at start:
===============================================================================
$ yaze
Yet Another Z80 Emulator by AG, version 2.12 (MMU)
Copyright 1995,1998 Frank D. Cringle. Pagetables Copyright by Michael Haardt.
MMU and CP/M 3.1 extensions Copyright (c) 2000,2002 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,2005 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.12 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,2005 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.12 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.12 (MMU)
Copyright 1995,1998 Frank D. Cringle. Pagetables Copyright by Michael Haardt.
MMU and CP/M 3.1 extensions Copyright (c) 2000,2002 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,2005 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 *