========================================================================
ZMASM           : README.TXT                                         
Release Version : 2.00 for "640K" DOS
Date            : 06-02-97                                            
Supported Cores : Z8/Z89C00 Family                                    
========================================================================
**************************** IMPORTANT *********************************

The  user  is  advised  to  read Section II. LICENSE AGREEMENT contained
herein.  If  the user proceeds to use the software contained herein, the
user agrees  to  abide  by the terms and conditions expressed in the Non-
Transferable License and Limited Warranty specified.

If  the  user  does not agree to be so bound, then the user is not autho-
rized  to  use  the software contained herein for any purpose whatsoever.

========================================================================
		       TABLE OF CONTENTS
========================================================================

    I. Introduction
   II. License Agreement              
  III. Files Shipped for this Version
   IV. Host Computer        
    V. Software Installation
   VI. Electronic Information Services (BBS/web site)
  VII. Product Support          
 VIII. Revision History Summary
   IX. Limitations and Precautions

========================================================================
   I. INTRODUCTION                                                       
========================================================================

Congratulations on  receiving Zilog's  new Macro Cross Assembler (ZMASM)
for software development  of Zilog's Z8/Z89C00 microcontroller families! 
ZMASM 640K DOS is designed as a stand-alone,  full-featured macro assem-
bler, for use by assembly language programmers.

The Assembler in this package  is the 640K DOS Version of the ZMASM 2.00
for Windows. ZMASM is highly compatible with Zilog's ZASM/MOBJ and assem-
blers from 2500AD and PLC at the syntax and semantic level  of assembler 
instructions.  Due  to architecture differences among  assemblers, ZMASM  
is not 100% compatible with  the  above assemblers.  Thus,  when porting 
codes from  these assemblers  into  ZMASM, it is strongly recommended to 
consult the TEXT file associated to that assembler.                                 

The  Assembler includes a brief user's guide  under the MANUAL directory,
plus sample files  under  the SAMPLES directory to get you familiar with 
the software. 

The   complete   User's  Manual   can  be   purchased   separately   via
P/N: ZMASM0W0ZAC.  The  Windows version  of  ZMASM, including the User's 
Manual, can be purchased via P/N: ZMASM0W0ZAS.

========================================================================
  II. License Agreement                                               
========================================================================

ZILOG, INC.
NON-TRANSFERABLE LICENSE AND LIMITED WARRANTY

This is a license; this product is not sold.

Zilog, Inc. ("Zilog")  agrees  to  license  you  its  enclosed  software,
"Zilog Macro Cross Assembler,  640K DOS-Only Version",  under  the follo-
wing terms and conditions:

THIS  IS  A  NON-TRANSFERABLE,  SINGLE-COPY-USER-COMPUTER OR WORKSTATION
SOFTWARE LICENSE  granted  to  you,  the  first  user,  by Zilog Inc., a
Delaware corporation  with  its  mailing  address  at  210 East Hacienda
Avenue,  Campbell, CA  95008-6600.  The  software  in  this  package  is
licensed to you, the first user. It is not sold.

COPYRIGHT INFORMATION
This  software  program,  and  any  documentation,  are protected by U.S.
copyright laws  and  international  copyright  treaties.  By  using  this
software, you acknowledge that you have read, understood  and agree to be
bound by all the provisions of this license.

LICENSE, COPY, AND USE RESTRICTIONS
In  exchange  for  consideration  to be agreed upon between Zilog and you,
ordinarily in the form of licensing fees paid by you to Zilog or the fact
that you  do not  have to create or purchase software elsewhere that will
perform the functions  contained herein,  Zilog licenses (not sells) this
single-user software to you, the first user,  for use on one computer for
which the software was designed.  This  means Zilog allows you to use the
software on a single machine, at any one time, at a single site.

In addition,  Zilog  authorizes  you  to  install  this software from its
original distribution file(s)  on as many computers as desired,  provided
each user agrees  to the terms  and conditions of this agreement and this
license text is never deleted.

You may make as many additional magnetic copies  of the original distribu-
tion file(s)  that  the  software  is  delivered  on  for  back-up and or
archival purposes  plus  you  may  install the software to a hard disk on
your  authorized  computers  as  a  working copy.  You  may not remove or
obscure the Zilog copyright, trademark, or license notices.

You  may  not  modify  the software in any way, except when authorized in
advance by Zilog.  You  may  not  decompile,  disassemble,  or  otherwise
reverse engineer the software. This software is not for sale, and you may
not sublicense, rent,  lease, sell, or pledge on a temporary or permanent
basis the original copy or back-up copies  of the software or the documen-
tation to another user or company for commercial purposes.  While you may
distribute this software to others as noted above, the others to whom you
distribute  this  software  must  agree to only use the software per this
license file which must always be included.  Any  other  use  by  you  or
others is strictly prohibited. You or others must contact Zilog to obtain
a production version.

AUTHORIZED USE
This software  is  to  be used by you only for the purposes of evaluating
the software or operating  Zilog integrated circuits.  Other uses that do
not include the operation  of a Zilog integrated circuit by this software
are strictly prohibited to you or any third party to whom you may provide
this software for evaluation purposes.  If  a  third  party  to  whom you
provided  this software breaches  this Agreement, you will be responsible.

GOVERNMENT CUSTOMERS
This software  is  Commercial Computer Software under Federal Acquisition
Regulations  and agency supplements to them.  The software is provided to
the Federal Government  and its agencies only under the Restricted Rights
Provision of the Federal Acquisition Regulations applicable to commercial
computer software  developed  at  private  expense  and not in the public
domain.  The Use, Duplication, or Disclosure by the government is subject
to restrictions as set forth in subdivision (c) (1) (ii) of the Rights in
Technical  Data  and  Computer  Software  clause  at  DFARS  252-227-7013
(October, 1988) and FAR 52-227-19 (c) June, 1987).

NO WARRANTY AND LIMITATION OF LIABILITY, REMEDIES, AND DAMAGES
Zilog does not warrant that the functions contained in this software will
meet  your  requirements or that the operation of the software will be un-
interrupted or error free.  Except as stated above  in this section,  the
software is provided as is without warranty of any kind either express or
implied, including but not limited to,  the implied warranties of merchan-
tability or fitness for a particular purpose.  No  other person or entity
is  authorized  to  expand  or alter this Agreement.  Zilog shall have no
liability for incidental or consequential damages arising from use of the
software.  You  assume  the  entire risk as it applies to the quality and
performance of the software. Should the software prove defective, you and
not Zilog assume  the  entire cost of all necessary servicing, repair, or
correction.  You may have specific legal and other rights which vary from
jurisdiction  to  jurisdiction.   Some jurisdictions  do  not  allow  the
exclusion of implied warranties  so  the above exclusion may not apply to
you. Zilog's entire liability to you and your remedies will be limited to
the availabilty of the most current version of software from Zilog.

INTEGRATION
This license  constitutes  the entire agreement and understanding between
the parties and supersedes any  prior license  or  understanding  whether
oral or written relating to the subject of this license. This license may
only be modified by a written agreement signed by Zilog.

You may use  the  software provided  you do not violate the copyright and
you follow the above rules.  If  you  breach the above rules, the license
will be terminated and all software will be returned by you to Zilog. Any
and all fees paid to Zilog shall be forfeited.  You shall not be entitled
to a refund of fees.  Title  to the software,  related documentation, and
any copies are retained by Zilog.

========================================================================
 III. FILES SHIPPED FOR THIS VERSION                                    
========================================================================

INSTALLATION FILES
------------------
ZMASM.001
ZMASM.INF
README.TXT    
DISK.ID
SETUP.EXE

ZMASM DOS FILES: (in c:\ZMASMDOS after installation)
--------------------------------------------------------------------------
README.TXT    This text file you are reading
2500AD.TXT    Addresses Compatibility issues between ZMASM and 2500AD
PLC.TXT       Addresses Compatibility issues between ZMASM and PLC   
ZASM.TXT      Addresses Compatibility issues between ZMASM and ZASM
PROBLEM.TXT   Problem/Suggestion Report on-line form.
ZILOG.MCU     2.00 DOS 6.2 Zilog Device Database
ZDUMPDOS.EXE  2.00 DOS 6.2 Utility to generate Intel Hex Files
ZFDOS.EXE     2.00 DOS 6.2 Command Line Address Fixer
ZLDDOS.EXE    2.00 DOS 6.2 Linker Kernel                       
ZMADOS.EXE    2.00 DOS 6.2 Assembler executable file
SAMPLES       Directory for Sample Files
MANUAL        Directory for User's Guide

MANUAL FILES: (in c:\ZMASMDOS\MANUAL after installation)
--------------------------------------------------------------------------
MANUAL.TXT
TABLE.TXT
ERR_ASM.TXT
ERR_LNK.TXT

Z8/Z89C00 SAMPLES FILES: (in c:\ZMASMDOS\SAMPLES\89175 after installation)
--------------------------------------------------------------------------
Z89175.LD   
Z89175_1.ASM   
Z89175_2.ASM   
Z89175_3.ASM   
Z89175.HEX  
Z89175.IHX  
Z89175.BAT  
Z89175HX.CMD  
Z89175LD.CMD  

Z8 SAMPLES FILES: (in c:\ZMASMDOS\SAMPLES\Z8 after installation)
------------------------------------------------------------------------
REACTION.S  
REACTION.LD 
REACTION.HEX
REACTION.BAT

Z89C00 SAMPLES FILES: (in c:\ZMASMDOS\SAMPLES\89C00 after installation)
------------------------------------------------------------------------
SUITE.ASM 
SUITE.LD  
SUITE.IHX 
SUITE.BAT 

NOTES:
1. ZMASM 2.00 for Windows production version is available from Zilog and
   can be  purchased using P/N: ZMASM0W0ZAS,  which includes  the User's 
   Manual. 

2. ZMASM 2.00 User's Manual can be bought separately using P/N: ZMASM0W0-
   ZAC.

========================================================================
  IV. HOST COMPUTER                                                    
========================================================================
  Minimum Requirements

  IBM PC (or 100-percent compatible) 386-based machine
  33MHZ
  4 MB RAM
  VGA Video Adapter
  Hard Disk Drive (2MB free space)
  3.5-inch, High-Density (HD) Floppy Disk Drive (optional)
  DOS 6.2 or Later

========================================================================
   V. SOFTWARE INSTALLATION                                             
========================================================================
To  properly  install  the  ZMASM  software,  first  start  the  DOS 6.2
operating  system,  then  follow  these  steps  below. The  installation
process must be followed to properly  decompress  the files prior to use,
that is, the files cannot be simply copied to the destination  directory.
The  installation  process   does  not   modify  the  "AUTOEXEC.BAT"  or 
"CONFIG.SYS" files.

There are two ways to install ZMASM software to your system. One is when
you downloaded  the  self-extracting file  from  our  BBS or website and
the other from an installation diskette.

 1. From Zilog's BBS or Web Site:
 --------------------------------
    a. Un-compress  the self-extracting file "ZMA200.EXE" to a temporary
       disk drive directory (example: to "C:\TMP" directory)                 

    b. Type  in  the  following  at  the  prompt  (enter  the characters
       between quotes): "setup"  while in your  "C:\TMP" directory. Then 
       press ENTER.

    c. A  dialog box will prompt  the user for the destination directory  
       into  which  the  software  will be installed (decompressed). The 
       default is "C:\ZMASMDOS".                          

       *** NOTE ***
       It is highly recommended to install ZMASM into a clean, new direc-
       tory. If you have a prior version of ZMASM,  rename its directory
       before installing the new version.  Then copy your source and pro-
       ject files to the new version's directory.

    d. It is suggested that you edit  and include the "ZMASMDOS" to your
       directory path or ZMASM batch files.

       To add to your directory path,  modify your "AUTOEXEC.BAT" by add-
       ing the line "PATH C:\ZMASMDOS;%PATH%", without the double quotes.

 2. From an Installation Diskette:
 ---------------------------------
    a. Insert  the Zilog Macro Assembler diskette into a compatible disk
       drive.

    b. Type  in  the  following  at  the  prompt  (enter  the characters
       between quotes): "a:\setup" (or "b:\setup"  if the diskette is in
       drive B:). Then press ENTER.

    c. Follow steps c and d above.

========================================================================
  VI. ELECTRONIC INFORMATION SERVICES                                  
========================================================================
1. The Zilog Bulletin Board Service (ZBBS)  can be  accessed  as follows:

     408/370-8024  (located in Campbell, CA USA)
     Up to 28.8K baud
     8 bits/no parity, 1 stop bit (8-N-1)
     Use ANSI/BBS terminal emulation setup.
     Follow on-screen instructions.

2. The Zilog Internet Home Page address is as follows:

     http://www.zilog.com

========================================================================
 VII. PRODUCT SUPPORT                                                  
========================================================================

1. If you experience any problems while operating this product or if you
   note  any  inaccuracies  while reading the supplied text file manuals,
   please  fill  out  the  Problem/Suggestion Report Form  in  the  file 
   "PROBLEM.TXT".  Then  mail or fax it to Zilog.

   Because this product  is  distributed  free of charge, Zilog reserves
   the right to limit support, including updates,  as  market conditions
   dictate. Customers unsatisfied  with  this  are encourage to purchase
   the Windows version, ZMASM0W0ZAS.

========================================================================
VIII. REVISION HISTORY SUMMARY                                         
========================================================================

    2.00 First Production Release.
    1.00 Beta Release.             

========================================================================
   X. LIMITATIONS and PRECAUTIONS                    
========================================================================
NOTE: The 640K DOS version  of  ZMASM  will  suffer problems  due to the
      available 640K memory,  such  as  assembly  file size,  number  of 
      symbols, number of linkable files, etc. The users only  remedy  is 
      to reduce system usage  of  the  available 640K memory or purchase 
      the Windows version of the ZMASM, P/N ZMASM0W0ZAS.

1. Updated help for ZFDOS.

   Usage: ZFDOS [<options>] <mapfile> [<srcfile> ...]
   options: -r<relocatable listing input file extension>
	    -a<absolute listing output file extension>

2. Updated help for ZDUMPDOS.

   Usage: ZDUMPDOS [-?] [-c] [-d] [-i] [-q] [-s] [-u] [-v] <object>
   -c       Emit raw data in C format(factory analysis use) 
   -d       Dump file symbolically(factory analysis use)
   -i       Emit raw data in Intel Hex format
   -q       Supress banner display
   -s       Emit symbols
   -u       Unassemble raw data(factory analysis use)
   -v       Emit raw data in Verilog format(factory analysis use)
   <object> This is the  ZMASM  produced object  file  to be used as the
	    input to ZDUMPDOS.  It can be an assembler output file (*.O)
	    or a linker output file (*.LD).

3. For Z8 large programs  using  the  16-bit tools,  sections  should be 
   limited  to  less  than 32 KB,  although  there  can be any number of 
   sections, so the application can be of arbitrary size.  

4. For Z89C00 large programs using the 16-bit tools, sections  should be 
   limited to less than  16 Kwords.  There can be any number of sections, 
   so the application  can be  of arbitrary size.

5. For Z8E001:  
 
   5.1 Please note the following Vector Names for Z8E001:

       Vector  Equivalent     Vector    
       Name      Name        Address         Description
       ---------------------------------------------------
       IRQ0        T0         0002H          T0 Interrupt 
       IRQ1        INT0       0004H          INT0 Interrupt
       IRQ2        T1         0006H          T1 Interrupt
       IRQ3        INT1       0008H          INT1 Interrupt
       IRQ4        INT2       000AH          INT2 Interrupt
       IRQ5        T2         000CH          T2 Interrupt
       RESET                  0020H          System Reset 

   5.2 The following are the latest Register Names  recognized  by ZMASM:
       (Reference : TIMERB.LST )                   

       TCTLLO     %0C0
       TCTLHI     %0C1
       WDTLO      %0C2
       WDTHI      %0C3
       T0ARLO     %0C4
       T1ARLO     %0C5
       T0ARHI     %0C6
       T1ARHI     %0C7
       T2AUTO     %0C8
       T3AUTO     %0C9
       T2VAL      %0CA
       T3VAL      %0CB
       T0VAL      %0CC
       T1VAL      %0CD

       PTAIN      %0D0
       PTAOUT     %0D1
       PTACTL     %0D2
       PTASFR     %0D3
       PTBIN      %0D4
       PTBOUT     %0D5
       PTBCTL     %0D6
       PTBSFR     %0D7

       IREQ       %0FA
       IMASK      %0FB
       FLAG       %0FC
       REGPTR     %0FD
       STKPTR     %0FF

   5.3 The Register Name "WDTSMR"  is  not  implemented  on this release.
       Please use "EQU" directive as shown:

       WDTSMR:    EQU     %0C1

6. New instructions specific  to Z86193 device are not supported on this 
   release. Use of macro commands is recommended.

7. Placing directives and assembly instructions in the first column will 
   be considered as labels.

========================================================================
  END                                                                   
========================================================================
