# YAZE-AG - Yet Another Z80 Emulator by AG (V 2.51.3)

## (HTML - Documentation)

## Introduction

yaze-ag is designed to provide an exact simulation of the Z80 microprocessor on a

- UNIX (Solaris) (Sparc, x86_64)
- Linux (x86_32, x86_64 and ARM)
- Raspberry Pi 1 (ARMv6(ARM1176JZF-S), single core, 700 MHz (see https://www.raspberrypi.org)
- Raspberry Pi 2 Model B (ARMv7(Cortex-A7), quad core, 900 MHz (see https://www.raspberrypi.org)
- Raspberry Pi 3 Model B (ARMv7/ARMv8(Cortex-A53), quad core, 1,2 GHz (see https://www.raspberrypi.org)
- Raspberry Pi 3 Model B+ (ARMv7/ARMv8(Cortex-A53), quad core, 1,4 GHz (see https://www.raspberrypi.org)
- Raspberry Pi 4 Model B (4GB + 8GB) (ARMv7/ARMv8(Cortex-A72), quad core, 1,5 GHz (see https://www.raspberrypi.org)
- Orange Pi Plus2 (ARMv7(Cortex-A7), quad core, 1,6 GHz) (see http://www.orangepi.org/orangepiplus2/)
- Radxa Rock/RockPro/RockLite (ARMv7(Cortex-A9), quad core, 1,6 GHz) (see http://radxa.com)
- FreeBSD
- Mac OS X
- Windows system (cygwin environment).

It is fast, emulates undocumented opcodes, and passes instruction regression tests against real Z80 hardware.

NEW in yaze-ag version 2.xx.x is the support of an emulated Memory Management Unit (MMU) and the BIOS which supports CP/M 3.1 .

YAZE-AG is a Z80-CPU-Emulator and NOT a CP/M-Emulator!

Inside the Emulator runs an original CP/M or a replacement of CP/M.

YAZE-AG uses the free CP/M 3.1 replacement "ZPM3N10" of Simeon Cran (bootfile "yaze-cpm3.boot") or the CP/M 2.2 replacement "Superdos" (bootfile "yaze.boot").

## How do you find new versions and the web page of YAZE-AG?

For detail information and new versions look to the web page of YAZE-AG

http://yaze-ag.de/

it's a redirect to

http://www.mathematik.uni-ulm.de/users/ag/yaze-ag/ (the original page at the University of Ulm, Germany)

An another way to find the web page of YAZE-AG is a search with Google. Give the search pattern "z80 emulator" and the link to "YAZE-AG - Yet Another Z80 Emulator by AG" is in the first page of the search results.

## BOOTSYS - CPM3.SYS loader (V 2.00; February 11, 2022)

BOOTSYS relocates the resident and banked part of a CPM3.SYS to their places into memory and starts CP/M 3.1.

I develop it because CPMLDR of DRI/Caldera and ZPM3LDR of Simeon Cran does not work with the big CPM3.SYS file (43 KB) in yaze-ag.

With Bootsys You can restart CP/M 3.1 under CP/M 3.1/2.2 itself (cold boot)!

- README for the CPM3.SYS loader BOOTSYS - README_BOOTSYS (it's updated at February 16, 2022)
  - See the chapter "4. Some Words to BOOTSYS" in yaze-ag.doc - it describes why I had to developed BOOTSYS
- The source of BOOTSYS - BOOTSYS.Z80 (intel-hex, uuencoded )
  - Sorry the comments are in German language ;-)
  - Tip: If you want to download it use the intel-hex or the uuencoded part
- BOOTSYS compiled - BOOTSYS.COM (intel-hex, uuencoded)

## Documentation of YAZE-AG-2.51.3

- A little documentation how you install yaze-ag-2.51.3 on Unix/Linux/Cygwin/MacOSx/RAspberry Pi - INSTALL-2.51.3.
  - Please read it because I have expanded the Install process and you have to edit the Makefile.
    There are also important informations for Windows users!!!
- How you install the Windows binaries go to the project web page http://yaze-ag.de and look there for the link Standalone Binaries for Windows.
- You start yaze-ag with the shell script "yaze". Please read yaze(1) (New) it describes the binary "yaze_bin" and the shell script "yaze" and what it install at first time.
- Windows users start the emulator with a link/icon on the Desktop or with the entry in the Start-Menue or with the batch file "yaze.bat"
  (See Standalone Binaries for Windows on the project webpage.)
  - For the options of "yaze_bin.exe" read yaze(1) (New).
- With the cdm(1) utility you can handle the <CPM_disk> files (.ydsk) which are used by yaze-ag.
  (Since YAZE-AG 2.30 you can use the import and export utilities R.COM and W.COM inside the emulator!)
- The features of the old version 1.06/1.10 - README-1.10
- The documentation of the old version 1.10 - yaze.doc
- A README to release 2.51.2 - README-2.51.3
- The documentation only of the new features until yaze-ag-2.51.2 - yaze-ag.doc (New)
- The new feature of previous version yaze-ag-2.40.5 was the keytranslation - yaze-keys.pdf
- A README of the CP/M 3.1 bios files (*.Z80 - Files) - README_BIOS3_Z80
- The man page of the terminalemulator mintty.exe which is used for yaze-ag - mintty.pdf
- Help of CP/M 3.1 - HELP.HLP

February 16, 2022

Dipl.-Ing (FH) Andreas Gerlich

(University of Ulm, Germany)

XMPP/Jabber: agl@jwchat.org

IRC: agl @ IRCNet (rare online)

only text emails please: (email of the project)

( Last change February 16, 2022 )