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.30.3 starts.)
---

Install yaze-ag-2.40:
=====================

Sections:

	 1. SOLARIS 8 (Sparc)
	 2. LINUX
	 3. FreeBSD
	 4. Cygwin (Windows)
	 5. Mac-OS-X (not yet ready)
	 6. Raspberry Pi 1
	 7. Raspberry Pi 2 Model B
	 8. Raspberry Pi 3 Model B (ARMv7, 32Bit)
	 9. Raspberry Pi 3 Model B (ARMv8, 64Bit)
	10. Orange Pi Plus/Plus2 (ARMv7, 32Bit)
	11. Radxa Rock/RockPro/RockLite

	Notes if you want to install yaze-ag in your system (Unix/Linux/FreeBSD)
	How do you start yaze-ag?
	How can I edit the .yazerc startup file as a WINDOWS user?
	Documentation
	Screen snapshoots of the old YAZE-AG-2.20 at start

 
1. If you want to run yaze-ag on 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 on 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 on 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 on 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".

 
5. If you want to run yaze-ag on 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.

 
6. If you want to run yaze-ag on Raspberry Pi 1 then

	open a terminal (LXterminal) (expand the size to 80x25 (25 lines))

	download yaze-ag-2.40_with_keytrans.tar.gz with the command:
	"wget http://www.mathematik.uni-ulm.de/users/ag/yaze-ag/devel/yaze-ag-2.40_with_keytrans.tar.gz"

	give the command "tar zxvlpf yaze-ag-2.40_with_keytrans.tar.gz" to unpack yaze-ag

	Then "cd yaze-ag-2.40_with_keytrans"

	copy 'Makefile_Raspberry_Pi_1' to 'Makefile' with the command:
	"cp Makefile_Raspberry_Pi_1 Makefile"

	Then call "make"...(the compilation needs some time)

	Then call "sudo make install" to install yaze-ag in your system.

	Go back to your home directory and
	remove the files in yaze-ag-2.40_with_keytrans and remove the directory
	yaze-ag-2.40_with_keytrans and yaze-ag-2.40_with_keytrans.tar.gz.

	Call "man yaze" to read the manual page.

	Call "yaze" or "cpm" or "z80" to run the emulator.
	(This will create the directory "$HOME/cpm".)

	(In the directory "$HOME/cpm/doc_html" is the complete documentation.
	 Open "index.html" with the Web-browser to read it!)

	Have fun :-)


	(If you want to use the wordstar (it's on A:) or the editor of the
	 Turbo-Modula-2 compiler, then expand the size of the terminal
	 to 80x25 (25 lines)!)

	With the command "mount" you can see the connected disk files (*.ydsk)
	and directories.

	With the comands "3DIR.COM", "I.COM", "II.COM" or "DIR.COM" you can
	print out the contents of the disks.

	With the command "HELP.COM" you get help of the CP/M system commands.

 
7. If you want to run yaze-ag on Raspberry Pi 2 Model B (ARMv7) then

	open a terminal (LXterminal) (expand the size to 80x25 (25 lines))

	download yaze-ag-2.40_with_keytrans.tar.gz with the command:
	"wget http://www.mathematik.uni-ulm.de/users/ag/yaze-ag/devel/yaze-ag-2.40_with_keytrans.tar.gz"

	give the command "tar zxvlpf yaze-ag-2.40_with_keytrans.tar.gz" to unpack yaze-ag

	Then "cd yaze-ag-2.40_with_keytrans"

	copy 'Makefile_Raspberry_Pi_2_Model_B' to 'Makefile' with the command:
	"cp Makefile_Raspberry_Pi_2_Model_B Makefile"

	Then call "make -j 4"...(the compilation needs some time)

	Then call "sudo make install" to install yaze-ag in your system.

	Go back to your home directory and
	remove the files in yaze-ag-2.40_with_keytrans and remove the directory
	yaze-ag-2.40_with_keytrans and yaze-ag-2.40_with_keytrans.tar.gz.

	Call "man yaze" to read the manual page.

	Call "yaze" or "cpm" or "z80" to run the emulator.
	(This will create the directory "$HOME/cpm".)

	(In the directory "$HOME/cpm/doc_html" is the complete documentation.
	 Open "index.html" with the Web-browser to read it!)

	Have fun :-)


	(If you want to use the wordstar (it's on A:) or the editor of the
	 Turbo-Modula-2 compiler, then expand the size of the terminal
	 to 80x25 (25 lines)!)

	With the command "mount" you can see the connected disk files (*.ydsk)
	and directories.

	With the comands "3DIR.COM", "I.COM", "II.COM" or "DIR.COM" you can
	print out the contents of the disks.

	With the command "HELP.COM" you get help of the CP/M system commands.

 
8. If you want to run yaze-ag on Raspberry Pi 3 Model B (ARMv7, 32Bit) then

	open a terminal (LXterminal) (expand the size to 80x25 (25 lines))

	download yaze-ag-2.40_with_keytrans.tar.gz with the command:
	"wget http://www.mathematik.uni-ulm.de/users/ag/yaze-ag/devel/yaze-ag-2.40_with_keytrans.tar.gz"

	give the command "tar zxvlpf yaze-ag-2.40_with_keytrans.tar.gz" to unpack yaze-ag

	Then "cd yaze-ag-2.40_with_keytrans"

	copy 'Makefile_Raspberry_Pi_3_Model_B_ARMv7_32Bit' to 'Makefile' with the command:
	"cp  Makefile_Raspberry_Pi_3_Model_B_ARMv7_32Bit  Makefile"

	Then call "make -j 4"...(the compilation needs some time)

	Then call "sudo make install" to install yaze-ag in your system.

	Go back to your home directory and
	remove the files in yaze-ag-2.40_with_keytrans and remove the directory
	yaze-ag-2.40_with_keytrans and yaze-ag-2.40_with_keytrans.tar.gz.

	Call "man yaze" to read the manual page.

	Call "yaze" or "cpm" or "z80" to run the emulator.
	(This will create the directory "$HOME/cpm".)

	(In the directory "$HOME/cpm/doc_html" is the complete documentation.
	 Open "index.html" with the Web-browser to read it!)

	Have fun :-)


	(If you want to use the wordstar (it's on A:) or the editor of the
	 Turbo-Modula-2 compiler, then expand the size of the terminal
	 to 80x25 (25 lines)!)

	With the command "mount" you can see the connected disk files (*.ydsk)
	and directories.

	With the comands "3DIR.COM", "I.COM", "II.COM" or "DIR.COM" you can
	print out the contents of the disks.

	With the command "HELP.COM" you get help of the CP/M system commands.

 
9. If you want to run yaze-ag on Raspberry Pi 3 Model B (ARMv8, 64Bit) then

	open a terminal (LXterminal) (expand the size to 80x25 (25 lines))

	download yaze-ag-2.40_with_keytrans.tar.gz with the command:
	"wget http://www.mathematik.uni-ulm.de/users/ag/yaze-ag/devel/yaze-ag-2.40_with_keytrans.tar.gz"

	give the command "tar zxvlpf yaze-ag-2.40_with_keytrans.tar.gz" to unpack yaze-ag

	Then "cd yaze-ag-2.40_with_keytrans"

	copy 'Makefile_Raspberry_Pi_3_Model_B_ARMv8_64Bit' to 'Makefile' with the command:
	"cp  Makefile_Raspberry_Pi_3_Model_B_ARMv8_64Bit  Makefile"

	Then call "make -j 4"...(the compilation needs some time)

	Then call "sudo make install" to install yaze-ag in your system.

	Go back to your home directory and
	remove the files in yaze-ag-2.40_with_keytrans and remove the directory
	yaze-ag-2.40_with_keytrans and yaze-ag-2.40_with_keytrans.tar.gz.

	Call "man yaze" to read the manual page.

	Call "yaze" or "cpm" or "z80" to run the emulator.
	(This will create the directory "$HOME/cpm".)

	(In the directory "$HOME/cpm/doc_html" is the complete documentation.
	 Open "index.html" with the Web-browser to read it!)

	Have fun :-)


	(If you want to use the wordstar (it's on A:) or the editor of the
	 Turbo-Modula-2 compiler, then expand the size of the terminal
	 to 80x25 (25 lines)!)

	With the command "mount" you can see the connected disk files (*.ydsk)
	and directories.

	With the comands "3DIR.COM", "I.COM", "II.COM" or "DIR.COM" you can
	print out the contents of the disks.

	With the command "HELP.COM" you get help of the CP/M system commands.

 
10. If you want to run yaze-ag on Orange Pi Plus/Plus2 (ARMv7, 32Bit) then

	open a terminal (LXterminal) (expand the size to 80x25 (25 lines))

	download yaze-ag-2.40_with_keytrans.tar.gz with the command:
	"wget http://www.mathematik.uni-ulm.de/users/ag/yaze-ag/devel/yaze-ag-2.40_with_keytrans.tar.gz"

	give the command "tar zxvlpf yaze-ag-2.40_with_keytrans.tar.gz" to unpack yaze-ag

	Then "cd yaze-ag-2.40_with_keytrans"

	copy 'Makefile_Orange_Pi_Plus2_ARMv7' to 'Makefile' with the command:
	"cp  Makefile_Orange_Pi_Plus2_ARMv7  Makefile"

	Then call "make -j 4"...(the compilation needs some time)

	Then call "sudo make install" to install yaze-ag in your system.

	Go back to your home directory and
	remove the files in yaze-ag-2.40_with_keytrans and remove the directory
	yaze-ag-2.40_with_keytrans and yaze-ag-2.40_with_keytrans.tar.gz.

	Call "man yaze" to read the manual page.

	Call "yaze" or "cpm" or "z80" to run the emulator.
	(This will create the directory "$HOME/cpm".)

	(In the directory "$HOME/cpm/doc_html" is the complete documentation.
	 Open "index.html" with the Web-browser to read it!)

	Have fun :-)


	(If you want to use the wordstar (it's on A:) or the editor of the
	 Turbo-Modula-2 compiler, then expand the size of the terminal
	 to 80x25 (25 lines)!)

	With the command "mount" you can see the connected disk files (*.ydsk)
	and directories.

	With the comands "3DIR.COM", "I.COM", "II.COM" or "DIR.COM" you can
	print out the contents of the disks.

	With the command "HELP.COM" you get help of the CP/M system commands.

 
11. If you want to run yaze-ag on Radxa Rock/RockPro/RockLite then

	open a terminal (LXterminal) (expand the size to 80x25 (25 lines))

	download yaze-ag-2.40_with_keytrans.tar.gz with the command:
	"wget http://www.mathematik.uni-ulm.de/users/ag/yaze-ag/devel/yaze-ag-2.40_with_keytrans.tar.gz"

	give the command "tar zxvlpf yaze-ag-2.40_with_keytrans.tar.gz" to unpack yaze-ag

	Then "cd yaze-ag-2.40_with_keytrans"

	copy 'Makefile_radxa_Rock_RockPro_RockLite' to 'Makefile' with the command:
	"cp  Makefile_radxa_Rock_RockPro_RockLite  Makefile"

	Then call "make -j 4"...(the compilation needs some time)

	Then call "sudo make install" to install yaze-ag in your system.

	Go back to your home directory and
	remove the files in yaze-ag-2.40_with_keytrans and remove the directory
	yaze-ag-2.40_with_keytrans and yaze-ag-2.40_with_keytrans.tar.gz.

	Call "man yaze" to read the manual page.

	Call "yaze" or "cpm" or "z80" to run the emulator.
	(This will create the directory "$HOME/cpm".)

	(In the directory "$HOME/cpm/doc_html" is the complete documentation.
	 Open "index.html" with the Web-browser to read it!)

	Have fun :-)


	(If you want to use the wordstar (it's on A:) or the editor of the
	 Turbo-Modula-2 compiler, then expand the size of the terminal
	 to 80x25 (25 lines)!)

	With the command "mount" you can see the connected disk files (*.ydsk)
	and directories.

	With the comands "3DIR.COM", "I.COM", "II.COM" or "DIR.COM" you can
	print out the contents of the disks.

	With the command "HELP.COM" you get help of the CP/M system commands.


 
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?
=========================

Users of Unix/Linux/FreeBSD/MacOSX/Raspberry_Pi:

	Start YAZE-AG-2.30.3 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 on drive A:).

	If you delete the option -DMMU yaze-ag can run only CP/M 2.2 (yaze.boot) then
	you have to delete -DBOOTSYS too.

	The .yazerc startup file ist in the $HOME/cpm directory.
	
Windows users:

	Start the emulator with the YAZE-AG icon on the Desktop,
	or start it with the YAZE-AG entry in the Start-Menu.


 
How can I edit the .yazerc startup file as a Windows user?
==========================================================

Windows users have the entry "Edit startup file .yazerc" in the Start-Menue in
the YAZE-AG entry.

There you can put .ydsk-files which are mounted at startup.
There is also an attach entry for the serial line which yaze-ag uses.

The last command must be the "go" entry to start the emulator.

 
Documentation
=============

The plain text documentation is obsolete!

Click on index.html in the $HOME/cpm/doc_html directory!
(Windows users have an entry for the documentation in the YAZE-AG entry in the
 Start-Menue.)

The whole documentation are in yaze-ag_doc.html, yaze_doc.html 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 (ybios.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.40 or if you find an error or you miss a
feature. Feel free and send an email to me.

20 May 2016
Dipl.-Ing. (FH) Andreas Gerlich
(University of Ulm, Germany)

only text emails please: address removed!!! (email of the project)
-------------------------------------------------------------------------------
 
* Begin of screen snapshoots *


Screen snapshoots of the old 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 *