copy all local files to repo

cp/m files, sprites, circuit design

emu/z80pack-1.9/doc/COPYING

@@ -0,0 +1,22 @@
+Copyright (c) 1987-2006 Udo Munk
+
+Permission is hereby granted, free of charge, to any person
+obtaining a copy of this software and associated documentation
+files (the "Software"), to deal in the Software without
+restriction, including without limitation the rights to use,
+copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following
+conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.

emu/z80pack-1.9/doc/README-asm.txt

@@ -0,0 +1,85 @@
+Usage:
+
+z80asm -ofile -f[b|m|h] -l[file] -s[n|a] -x -v -dsymbol ... file ...
+
+A maximum of 512 source files is allowed. If the filename of a source
+doesn't have an extension the default extension ".asm" will be
+concated. Source file names may have a path, the maximum length of
+a full qualified filename is 2048 characters.
+For relative paths the extension must be used, because all characters
+after a "." would be used as extension!
+
+Option o:
+To override the default name of the output file. Without this option
+the name of the output file becomes the name of the input file,
+but with the extension ".bin". The output file may have a path,
+the maximum length is limited to 2048 characters.
+
+Option f:
+Format of the output file:
+
+	-fb -> binary file
+	-fm -> binary file with Mostek header
+	-fh -> Intel hex
+
+Option l:
+Without this option no list file will be generated. With -l a list
+file with the name of the source file but extension ".lis" will be
+generated. An optional file name with path (2048 characters maximum)
+may be added to this option.
+
+Option s:
+This option writes the unsorted symbol table (-s), sorted by name (-sn)
+or sorted by address (-sa) into the list file. This option only works
+together with option -l.
+
+Option x:
+Don't output data in pass 2 into object file for DEFS. This only works
+if unallocated data isn't followed by any code or initialized data!
+Usefull for CP/M BIOS's, where unallocated data doesn't need to be
+part of the system image, if the complete image won't fit on the system
+tracks.
+
+Option v:
+Verbose operation of the assembler.
+
+Option d:
+This option predefines symbols with a value of 0.
+The number of this option is not limited in the command line.
+
+Pseudo Operations:
+
+Definition of symbols and allocation of memory:
+
+	 ORG    <expression>    - set program address
+<symbol> EQU    <expression>    - define constant symbol
+<symbol> DEFL   <expression>    - define variable symbol
+<symbol> DEFB   <exp,'char',..> - write bytes in memory
+<symbol> DEFW   <exp,exp..>     - write words (16 bits) in memory
+<symbol> DEFM   <'string'>      - write character string in memory
+<symbol> DEFS   <expression>    - reserve space in memory
+
+
+Conditional assembly:
+
+IFDEF   <symbol>        - assemble if symbol defined
+IFNDEF  <symbol>        - assemble if symbol not defined
+IFEQ    <exp1,exp2>     - assemble if equal
+IFNEQ   <exp1,exp2>     - assemble if not equal
+ELSE                    - else for all conditionals
+ENDIF                   - end of conditional assembly
+
+
+Manipulation of list file:
+
+PAGE    <expression>    - number of lines/page
+EJECT                   - skip to new page
+LIST                    - listing on
+NOLIST                  - listing off
+TITLE   <'string'>      - define title for page header
+
+
+Others:
+
+INCLUDE <filename>      - include another source file
+PRINT   <'string'>      - print string to stdout in pass one

emu/z80pack-1.9/doc/README-cpm2.txt

@@ -0,0 +1,54 @@
+	Quickstart to run CP/M and MP/M on the Z80-CPU simulation
+
+1. Change to directory ~/z80pack/cpmsim/srcsim
+   make
+   make clean
+This compiles the CPU and hardware emulation needed to run CP/M and MP/M.
+
+2. Change to directory ~/z80pack/cpmsim/srccpm2
+   make
+   make clean
+This compiles support programs (see below), installs named pipes and so on.
+
+3. Make backup copies of your distribution disks!
+   cd ~/z80pack/cpmsim/disks/library
+   cp *.dsk ../backups
+
+4. Change to directory ~/z80pack/cpmsim
+   cpm2 - run CP/M 2.2
+   cpm3 - run CP/M 3.0
+   mpm  - this boots CP/M 2, run command mpm to boot MP/M 2
+
+Usage of the support programs:
+
+format:	to create an empty disk image for the CP/M simulation.
+	input: format <a | b | c | d | i | j>
+	output: in directory disks files drivea.cpm, driveb.cpm,
+		drivec.cpm, drived.cpm, drivei.cpm and drivej.cpm
+
+bin2hex:converts binary files to Intel hex.
+
+receive:This is a process spawned by cpmsim. It reads from the named
+	pipe auxout and writes all input from the pipe to the file,
+	which is given as first argument. cpmsim spawns this process
+	with the output filename auxiliary.cpm. Inside the simulator
+	this pipe is connected to I/O-port 5, which is assigned
+	to the CP/M device PUN:. So everything you write from CP/M
+	to device PUN: goes into the file auxiliary.cpm on the
+	UNIX host.
+
+send:	This process is to send a file from the UNIX host to the
+	simulator. Type send <filename> &, and then run cpmsim.
+	The process writes all data from file into the named pipe
+	auxin, which is also connected to I/O-port 5, which is
+	assigned to the CP/M device RDR:. You may use this to
+	transfer a file from the UNIX host to the simulator.
+	Under CP/M type pip file=RDR: to read the data send from
+	the process on the UNIX host.
+
+If you use PIP to transfer files between the UNIX host and the
+simulator, you can only use ASCII files, because pip uses cntl-z
+for EOF! To transfer a binary file from the UNIX host to the
+simulator convert it to Intel hex format with bin2hex. This
+can be converted back to a binary file under CP/M with the LOAD
+command.