USING THE ZAD SYSTEM


--------STARTUP PROCEDURE--------

[1] The Fox Trainer need not be connected when using the editor ("Edit
File", ZAD v3.1), the cross-assembler ("Assemble Text File"), the print
utility ("Print Listing/BIN File"), or disassembler ("Disassemble Object
File"). These functions will work on an isolated IBM-PC or compatible.
For all other functions, a Fox Trainer must be connected to one of the
available serial ports using the supplied cable. It is best to connect
the serial cable before power is turned on. See page 3-3 in the ZAD
Manual for the Fox for more information.

[2] Apply power to the Fox Trainer and the PC. When the Fox Trainer
display reads "ready" (or "1800" if nonvolatile RAMs are installed),
press GO.

[3] Press and hold USER KEY, then press GO again. The numeric display will
briefly show "PC", and will then become blank. The Fox Trainer is now
waiting for control commands from the PC.

[4] When the PC has properly booted, insert the ZAD diskette (unless the ZAD
software has been installed on your hard disk) and type "ZAD "
to start the program. The current version of the software is ZAD v3.1
(March, 1991). ZAD v3.1 is different from previous versions primarily in
that it contains an integrated editor (E.EXE).

[5] When you invoke a function that requires dialog with the Fox Trainer ,
an options window appears. At this time, you may select the port and
baud rate (default: COM1/9600 baud). Once a channel to the Fox Trainer
has been opened, a green LED lamp on the Fox Trainer 's interface board
will be turned on to indicate this condition.

[6] For a detailed description of the ZAD system, please refer to the ZAD
Manual. The full-screen monitor/debugger (menu selection "Interactive
Monitor/Debugger") is described in Chapter 7 of the ZAD Manual.

[7] The ZAD Editor is called "E", and may be used either from within the ZAD
environment or independent of ZAD. If you wish to use the editor for
non-Z80 related editing, you need only the files E.EXE and E.CFG. Enter
"E [filename.xyz]" to begin editing. The editor's configuration file,
E.CFG, contains preferences you select for key assignments and default
settings, and should be present with E.EXE if you ever copy the files
to another diskette.

[8] The ZAD and Editor programs, and the data files, must exist on the same
directory of the same disk for the system to work properly. At this time,
it is not possible to have these files in separate directories or on
separate disks.

[9] Schools are granted perimssion by CAMI Research to copy the ZAD program,
Editor, and associated files onto individual floppy disks that are issued
to students. In this way, students may enter and syntax-check programs
BEFORE they come to the laboratory if they have a PC available at home,
in the library, or elsewhere. The ZAD Manual may be supplied directly to
school bookstores for purchase by students.

[10] A new feature that is not yet documented in the ZADFOX manual allows
for a data disk that is separate from the disk on which the ZAD programs
reside. If you wish to direct output to or read files from a separate
disk, press ALT-D while viewing the main ZAD control screen. The label
in the upper left corner "Active Disk" changes to "System Disk d: /
Program Disk d:". Continue pressing ALT-D until you select the desired
program disk label. The editor's configuration file, E.CFG, will be
read from the selected program disk when the editor is invoked.


--------ZAD DISKETTE CONTENTS--------

README - this document.

ZADFOX.EXE - the ZAD program, v3.1.

ZADFOXV.EXE - an alternate version of the ZAD program that will prevent
display problems on antiquated video hardware. Try ZAD first.
If you experience display snow or flickering when using
the full-screen monitor function, you may change to ZADV to
correct the problem at the expense of execution speed. If you
can stand the snow, it will not hurt anything.

E.EXE - the editor program. When you select "Edit File" from within
ZAD, E is automatically invoked.

E.CFG - the editor's configuration file. This file specifies the key
assignments of your preference, as well as default settings
invoked when the editor is started. Once the editor is open,
press ALT-K to open the key assignments window if you wish to
make any changes.

ERRORS.SRC - a source file demonstrating the error flagging capabilities of
the cross-assembler.

ZADEX.SRC - a source file demonstrating the use of pseudo-ops in assembly
language programming.

MUSIC.SRC - a large source program (>600 lines) for use in demonstrating
the size and speed capabilities of the cross-assembler. Much
larger programs are possible.

Z80OPS.SRC - a source file containing ALL valid Z80 instruction mnemonics.

EDLIN.COM - a copy of the generic line editor that is supplied with
MS-DOS. Any standard ASCII editor may be used to examine and
change the source or list file.



--------FILE EXTENSION CONVENTIONS--------

.SRC - a Z80 SOURCE program written in assembly language.

.BIN - a BINARY file, containing either executable Z80 machine code created
by the cross-assembler, or a RAM image stored on the disk using the
UPLOAD function. This file format is unique to ZAD, and cannot be
interpreted by other software.

.LST - a LIST file created by the assembler containing all the infor-
mation in the source file plus a list of the executable Z80 code, a
symbol table, and page headers giving the filename, date, time, and
page number.

.DIS - a DISASSEMBLED source program synthesized by reverse translating the
executable Z80 code. It is impossible to derive symbol names by this
process, so only instruction mnemonics and absolute branch addresses
are shown.

.HEX - an Intel format HEX file, useful to some EPROM programmers.

.S - a Motorola S-record file, useful to some EPROM programmers.

.OBJ - a pure binary format compatible with the MCT EPROM programmer
sold by CAMI Research.

.EXE - executable modules for the PC operating system.

.CFG - configuration file for the ZAD Editor.


When the cross-assembler operates, the default file format for the assembled
output is .BIN, which can be interpreted only by ZAD. The confirmation
window that appears before the cross-assembler begins allows you to select
one of the other formats (.HEX, .S, or .OBJ) to produce a file compatible
with an EPROM programmer or other software.

If you have comments or questions, please let us know.

CAMI Research Inc.
75 Westmoreland Ave.
Arlington, MA 02174

Tel: (617) 648-6389
Fax: (617) 646-2480



ZAD and MICRO-TRAINER are trademarks of CAMI Research Inc. FOX is a trademark
of E&L Instruments. CAMI Research and E&L Instruments are not associated.