home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / cpm / utils / asmutl / z80asm24.lbr / Z80ASM.DZC / Z80ASM.DOC
Text File  |  1987-10-13  |  4KB  |  110 lines
  1.  
  2.  
  3.                 Z
  4.                  8
  5.                   0
  6.                    A
  7.                     S
  8.                      M
  9.  
  10.  
  11.                 Zilog/Mostek
  12.  
  13.                 Z80-CPU
  14.  
  15.  
  16.                 Assembly
  17.                         Language
  18.                                 Processor
  19.  
  20.  
  21.                 (C) Copyright 1977 LCS
  22.                 All Rights Reserved
  23.  
  24.  
  25.                 Latest Revision:        21-July-1977
  26.  
  27.  
  28.         Z 8 0 A S M
  29.  
  30.  
  31.      Z80ASM is an assembler for the Zilog/Mostek Z80-CPU microprocessor.
  32. It is designed to run under the CP/M operating system from Digital
  33. Research.  CP/M will run on either an 8080a system or a Z80 system.
  34. Z80ASM will run in the CP/M minimum (16k) system but will utilize more
  35. memory for symbol table storage in larger (up to 64k) CP/M systems.
  36.  
  37.      Z80ASM reads a source (asm) file produced by the CP/M "ED" text
  38. editor program and produces an optional listing (on the lst: device) and
  39. an optional object code (hex) file in intel format hex.  The "hex" file
  40. can be loaded for execution using "DDT" or "LOAD" commands of CP/M or it
  41. can be punched on paper tape using the "pip" program.
  42.  
  43.      Input statements are free format (i.e. not column oriented).
  44. Between fields any number of blank or tab characters may be present but
  45. within a field there may be no blank or tab characters.  However,
  46. statements labels must be in the first position of the line.  Statement
  47. labels may have a colon following them but the colon is not required.
  48. Comments are preceded by a semicolon and may appear by themselves or
  49. following all of the fields on a source line.
  50.  
  51.  
  52.      All the Zilog/Mostek mnemonics are supported with the following
  53. exceptions:
  54.  
  55.      1. The Z80CPU technical manual has conflicting information regarding
  56.         the syntax of the rlc, rl, rrc, and rr instructions when the a
  57.         register is used as the operand.  On page 50 the forms
  58.         "rlca", "rla", "rrca", "rra" are used while on page 68 the form
  59.         "rr a" is shown.  Z80ASM will support only the "rra", etc. form.
  60.  
  61.      2. The Z80CPU manual does not describe the pseudo operators available
  62.         except that "equ" and "defs" are used on page 67 in the sample
  63.         program.  The list below describes the pseudo operators available
  64.         in z80asm and their argument formats:
  65.  
  66.      <label> equ     <expression>    assign value to label
  67.              org     <expression>    assign value to program counter
  68.              defs    <expression>    reserve storage
  69.              defw    <expression>    define word (2 bytes)
  70.              defb    <expression>    define byte (format 1)
  71.              defb    '-string-'      define byte (format 2)
  72.              eject                   listing eject
  73.              end     <expression>    define execution address
  74.         note: for defw and defb only one operand is allowed.
  75.      expressions:
  76.  
  77.      expressions may be any number of the items listed below separated
  78. by +, -, and * for addition, subtraction, and multiplication respectively.
  79.  
  80.      expression elements:
  81.              <label>         1 to 11 character statement label
  82.              <number>h       hexadecimal number
  83.              <number>b       binary (bit) number
  84.              <number>        decimal number
  85.                 $            program counter reference
  86.                'x'           x=any printable character
  87.  
  88.      examples of expressions are:
  89.              label1+5
  90.              0ffh
  91.              10100001b+6
  92.              $-6
  93.              '9'+1
  94.  
  95.      The input file must have an extension of "asm" and the output file
  96. will have an extension of "hex" if it is created.  Z80ASM is called
  97. using a command with the following format:
  98.  
  99.      z80asm <filename>.<ab>
  100.  
  101.      <filename>      1 to 8 character CP/M file name (must be .asm)
  102.      <ab>            option controls-
  103.                                      a=y or n for listing
  104.                                      b=y or n for hex file
  105.                      if <filename> only format is used the a and b
  106.                      default to yy
  107.  
  108.      Note: Even if the listing is not requested any errors that will occur
  109. will be listed on the lst: device.
  110.