======================================================================== ZMASM : README.TXT Release Version : 2.10 for "640K" DOS version Date : 02-04-98 Supported Cores : Z8/Z8plus/Z89C00/Z180/Z380 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/Z8plus/Z89C00/Z180/Z380 microcon- troller and microprocessor families! ZMASM 640K DOS is designed as a stand-alone, full-featured macro assembler, for use by assembly language programmers. The Assembler in this package is the 640K DOS Version of the ZMASM 2.10 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. Notes: ------ 1. ZMASM Users Manual DC#ST97DSP0401 was based on ZMASM Version 2.10 ======================================================================== 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 ZMASMFAQ.TXT Commonly Asked Questions/Answers. PROBLEM.TXT Problem/Suggestion Report on-line form. ZILOG.MCU 2.10 DOS 6.2 Zilog Device Database ZDUMPDOS.EXE 2.10 DOS 6.2 Utility to generate Intel Hex Files ZFDOS.EXE 2.00 DOS 6.2 Command Line Address Fixer ZLDDOS.EXE 2.10 DOS 6.2 Linker Kernel ZMADOS.EXE 2.10 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 Z80180 SAMPLES FILES: (in c:\ZMASMDOS\SAMPLES\80180 after installation) ------------------------------------------------------------------------ DISTEST.BAT DISTEST.HEX DISTEST.S DISTEST.LD 185MACRO.LIB Z80380 SAMPLES FILES: (in c:\ZMASMDOS\SAMPLES\80380 after installation) ------------------------------------------------------------------------ ADC.BAT ADC.HEX ADC.ASM ADC.LD Z80180 INCLUDE FILES: (in c:\ZMASMDOS\INCLUDE\80180 after installation) ------------------------------------------------------------------------ 182MACRO.LIB 185MACRO.LIB Z80380 INCLUDE FILES: (in c:\ZMASMDOS\INCLUDE\80380 after installation) ------------------------------------------------------------------------ 380DEF.INC 382DEF.INC NOTES: 1. ZMASM 2.10 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.10 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 "ZMAD210.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. *** NOTE *** THE INSTALLATION SHOULD NOT BE RUN UNDER WINDOWS. 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 ======================================================================== ZMASM: Rel. 2.10 ---------------- o Fixed problem when exponent of zero is used. o Fixed Z8 relocatable register to register addressing. o Fixed Z8 relative jump in absolute mode. o Fixed Z89C00 structure assembly with >= and < operators. o Added Z180/Z380 Support ZMASM: Rel. 2.00 ---------------- o First Production 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 ZDUMPDOS. Usage: ZDUMPDOS [-?] [-c] [-d] [-i] [-q] [-s] [-u] [-v] -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) 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). 2. 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. 3. 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. 4. For Z8E001: 4.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 4.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 4.3 The Register Name "WDTSMR" is not implemented on this release. Please use "EQU" directive as shown: WDTSMR: EQU %0C1 5. New instructions specific to Z86193 device are not supported on this release. Use of macro commands is recommended. 6. Placing directives and assembly instructions in the first column will be considered as labels. 7. Z180/Z380: ZCONVERT does not accept 32-bit Intel Hex code. 8. Z382 processor is not directly supported on this release, however the user can still write code for it if they manage the memory map and peripherals themselves. 9. Multiplication, division and shift operations are not supported for relocatable arithmetic expressions. Thus, following examples are considered as illegal expressions by ZAMSM Ex: xref x1, x2 var1 equ 1 / x1 var2 equ 1 * x2 var3 equ x >> 2 10. Forward Referenced labels are not supported. The label int_table in the below example is forward reference and will be flagged as error by ZMASM. hdlc_base_vec equ 3 tx0_vec: equ int_table + hdlc_base_vec*2 start: ...... ...... in_table: DW %55aa ======================================================================== END ========================================================================