yaze(1) Local command yaze(1) NAME yaze-ag - yet another z80 emulator by ag SYNOPSIS yaze [-1] [-v] [-bbootfile] [-lloadadr] [-pbasepage] [-sstartup] [-zZ3ENV] command... cpm ... z80 ... DESCRIPTION yaze-ag has been designed to provide an exact simulation of the Z80 microprocessor on a Unix system. In addition to the instruction set emulator, a CP/M basic i/o system is provided that can reference Unix directories and Unix files containing images of CP/M disks. When a genuine CP/M operating system (ccp + bdos) or a clone system is loaded into the emulator, a complete CP/M system is avail− able, running on a Unix-/Linux-/RaspberryPi-/Mac-/Windows-Host. yaze-ag-2.51.0 is a further development of yaze-1.10. New in yaze-ag is the emulated Memory Management Unit (MMU) and the BIOS that supports CP/M 3.1 or ZPM3 (boot file yaze-cpm3.boot) which is used in yaze-ag. You can still run the CP/M 2.2 replacement "SuperDos" (boot file yaze.boot) in yaze-ag if you want. New in version 2.40.5 was the key translation module. So you can use e.g. the cursor keys and function keys in the CP/M command line or when Wordstar is running. Look at the files $HOME/cpm/*.ktt on the host. New in version 2.51.0 is the possibility to define a clock rate. This allows you to run the emulator e.g. with 4.0 MHz. Further there is a "window size handler" in the binary of yaze-ag. This handler determines the coordinates of the used Terminal emulator (e.g. xterm, gnome-terminal, mintty (Cygwin/Windows), ...). So the lines and columns variables in the System Control Block (SCB) of CP/M-3 are set by this handler. The patched Wordstar 4.00 (see drive A:) and the CP/M-3-Utilities (e.g. TYPE.COM, 3DIR.COM, DIR.COM, ...) uses this two variables in the SCB via stan− dardized BDOS3-Interface (call to 0005H) to setup the screen. yaze is a shell script. It is used to start yaze-ag. It first tests if the startup file .yazerc is in the current directory. If there is one, it immediately starts yaze_bin the binary of the Z80 emulator. If .yazerc does not exist, it tests if the directory $HOME/cpm exists. If not, it creates $HOME/cpm. Then it copies some yaze-disks-files (.ydsk) to $HOME/cpm which are necessary for running yaze-ag with CP/M 3.1 or ZPM3. Then it creates $HOME/cpm/doc_html and sets links to the complete documentation in this directory. This only hap− pens if the directory $HOME/cpm does not exists. Finally, it changes to $HOME/cpm and starts yaze_bin. This is done every time you start the shell script yaze and if .yazerc is not present in the current directory. yaze-ag can also be started with z80 or cpm. They are symbolic links to the shell script yaze. The older documentation is contained in the file yaze.doc (version yaze-1.10) and the new features of yaze-ag-2.51.0 describes the file yaze-ag.doc (see $HOME/cpm/doc_html/index.html). OPTIONS -1 set sector size to 128 bytes for all disks (only CP/M 3.1). If you create a disk file under the yaze-ag monitor or with the cdm(1) utility and you use the default sectors per track (see create) the sector size is also set to 2048 bytes (only CP/M 3.1). If you use software like a disk edit utility under CP/M 3.1 it can be necessary to set the sector size to 128 bytes. See also the monitor command 128 above in the sec− tion MONITOR COMMANDS. -v causes a summary of the system configuration to be displayed after loading. -b gives the name of a file to be loaded into the emu− lated processor's ram before the emulation is started. The file is loaded at the address given by the -l option, if one is present, or else at the basepage (see -p). If a boot file is not specified with the -b option, yaze-ag looks firstly for the file yaze-cpm3.boot in the current directory, then in /usr/local/lib/yaze to boot CP/M 3.1. If yaze− ag is compiled without the flag -DBOOTSYS yaze-ag looks for the file yaze.boot (instead of yaze- cpm3.boot) to boot the CP/M 2.2 replacement Super− dos. -l the hexadecimal address at which to load and start the bootstrap file, if a separate bootstrap is nec− essary. If you want to run CP/M 2.2 while yaze-ag is com− piled to load yaze-cpm3.boot (CP/M 3.1) you can start yaze-ag with the following options yaze -l -1 -b yaze.boot -p the top 2 hex digits of the location of the CP/M console command processor (CP/M 2.2). Also the location to which bootfile is loaded if a -l option is not present. -s a file containing monitor commands that are to be executed before starting the emulator. If no -s option is present, .yazerc from the current direc− tory or from the user's home directory is taken. -z the hexadecimal address in the emulated processor's ram of a 1KByte area that should be reserved for use by an extended CP/M clone such as ZCPR3. MONITOR COMMANDS When the emulator is started it executes commands first from the startup file, then from the tail of the command line (any strings which follow the options) and then from the tty if neither the startup file nor the command line included a "go" command. Control can be returned to the monitor by executing the CP/M sys.com command or, if yaze was compiled with -DDEBUG, by sending it a SIGINT signal. Command names can be shortened to a unique abbreviation. If yaze-ag was compiled with GNU Readline, command-line editing, filename completion and history recall are avail− able - see the readline documentation. The monitor commands are described in more detail in the file yaze.doc. The command '128' is described in yaze-ag.doc. help Display a command list help cmd Give details about cmd attach Attach CP/M device to a Unix file clock Display and set the clock rate Without a parameter it displays the current clock rate. With a parameter (for example 4000 for 4.0 MHz) the clock rate will be set. The parameter "0" returns to "max speed". If you want to set a permanent clock rate you can put a clock command into the yaze-ag startup file $HOME/cpm/.yazerc. detach Detach CP/M device from file setaccess Turns on/off access time stamps for mounted directories mount Mount a Unix file or directory as a CP/M disk remount Remount a CP/M disk umount Unmount a CP/M disk create Create a new disk 128 Set sector size to 128 for all disks (only CP/M 3.1). To reverse this option you have to restart yaze-ag. interrupt Set user interrupt key go Start/Continue CP/M execution ! Execute a Unix command quit Terminate yaze time Display elapsed time since last `time' command SUPPORTED OPERATING SYSTEMS Yaze-ag-2.51.0 can be compiled under all unix or unix-like operating systems. yaze-ag-2.51.0 are tested with: Solaris cc and gcc (SparcV9 and X86_64) Linux gcc (x86_64, x86_32, ARM6, ARM7 and ARM8) RaspberryPiOS RaspberryPi 1,2B,3B,3B+,4B (all with gcc) FreeBSD clang MacOS-X gcc ? Cygwin gcc (have a look to www.cygwin.com) Cygwin is a unix-like environment for windows. The "Standalone Binaries for Windows" are produced with Cygwin. SOURCE AND BINARIES You find the source (for all systems) and the binaries for windows (if you don't want to install the cygwin environ ment) under http://yaze-ag.de/ or http://www.mathematik.uni-ulm.de/users/ag/yaze-ag/ SEE ALSO cdm(1) AUTHORS Andreas Gerlich Frank D. Cringle only text emails please:(SPAM-Account) AGL's & Frank's Hacks 20. September 2020 yaze(1)