home *** CD-ROM | disk | FTP | other *** search
/ C/C++ Interactive Guide / c-cplusplus-interactive-guide.iso / c_ref / csource4 / 276_01 / az80.doc < prev    next >
Text File  |  1989-10-03  |  43KB  |  1,097 lines
  1. /*
  2.     HEADER:        CUG276;
  3.     TITLE:        Z-80 Cross-Assembler (Portable);
  4.     FILENAME:    AZ80.DOC;
  5.     VERSION:    0.1;
  6.     DATE:        08/27/1988;
  7.     SEE-ALSO:    AZ80.H;
  8.     AUTHORS:    William C. Colley III;
  9. */
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.                            Z-80 Cross-Assembler (Portable)
  25.  
  26.  
  27.                                      Version 0.1
  28.  
  29.  
  30.                    Copyright (c) 1986-1988 William C. Colley, III
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.                               The manual such as it is.
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.           Legal Note:    This package may be used for any commercial or
  50.                          non-commercial purpose.  It may be copied and
  51.                          distributed freely provided that any fee charged
  52.                          by the distributor of the copy does not exceed the
  53.                          sum of:  1) the cost of the media the copy is
  54.                          written on,  2) any required costs of shipping the
  55.                          copy, and  3) a nominal handling fee.  Any other
  56.                          distribution requires the written permission of
  57.                          the author.  Also, the author's copyright notices
  58.                          shall not be removed from the program source, the
  59.                          program object, or the program documentation.
  60.  
  61.  
  62.  
  63.                                   Table of Contents
  64.  
  65.           1.0  How to Use the Cross-Assembler Package ..................  3
  66.           2.0  Format of Cross-Assembler Source Lines ..................  4
  67.                2.1  Labels .............................................  5
  68.                2.2  Numeric Constants ..................................  5
  69.                2.3  String Constants ...................................  6
  70.                2.4  Expressions ........................................  6
  71.           3.0  Machine Opcodes .........................................  7
  72.           4.0  Pseudo Opcodes ..........................................  8
  73.                4.1  Pseudo-ops -- DB, DEFB, DEFM .......................  8
  74.                4.2  Pseudo-ops -- DC ...................................  9
  75.                4.3  Pseudo-ops -- DEFS, DS .............................  9
  76.                4.4  Pseudo-ops -- DEFW, DW .............................  9
  77.                4.5  Pseudo-ops -- END ..................................  9
  78.                4.6  Pseudo-ops -- EQU .................................. 10
  79.                4.7  Pseudo-ops -- COND, ELSE, ENDC, ENDIF, IF .......... 10
  80.                4.8  Pseudo-ops -- INCL ................................. 11
  81.                4.9  Pseudo-ops -- ORG .................................. 11
  82.                4.10 Pseudo-ops -- PAGE ................................. 11
  83.                4.11 Pseudo-ops -- TITLE ................................ 12
  84.                4.12 Pseudo-ops -- DEFL, VAR ............................ 12
  85.           5.0  Assembly Errors ......................................... 12
  86.                5.1  Error * -- Missing Statement ....................... 12
  87.                5.2  Error ( -- Parenthesis Imbalance ................... 13
  88.                5.3  Error " -- Missing Quotation Mark .................. 13
  89.                5.4  Error B -- Branch Target Too Far Away .............. 13
  90.                5.5  Error D -- Illegal Digit ........................... 13
  91.                5.6  Error E -- Illegal Expression ...................... 13
  92.                5.7  Error I -- IF-ENDIF Imbalance ...................... 14
  93.                5.8  Error L -- Illegal Label ........................... 14
  94.                5.9  Error M -- Multiply Defined Label .................. 14
  95.                5.10 Error O -- Illegal Opcode .......................... 14
  96.                5.11 Error P -- Phasing Error ........................... 14
  97.                5.12 Error R -- Illegal Register Specification .......... 15
  98.                5.12 Error S -- Illegal Syntax .......................... 15
  99.                5.13 Error T -- Too Many Arguments ...................... 15
  100.                5.14 Error U -- Undefined Label ......................... 15
  101.                5.15 Error V -- Illegal Value ........................... 15
  102.           6.0  Warning Messages ........................................ 15
  103.                6.1  Warning -- Illegal Option Ignored .................. 16
  104.                6.2  Warning -- -l Option Ignored -- No File Name ....... 16
  105.                6.3  Warning -- -o Option Ignored -- No File Name ....... 16
  106.                6.4  Warning -- Extra Source File Ignored ............... 16
  107.                6.5  Warning -- Extra Listing File Ignored .............. 16
  108.                6.6  Warning -- Extra Object File Ignored ............... 16
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.                                      1
  121.  
  122.  
  123.  
  124.           7.0  Fatal Error Messages .................................... 16
  125.                7.1  Fatal Error -- No Source File Specified ............ 16
  126.                7.2  Fatal Error -- Source File Did Not Open ............ 17
  127.                7.3  Fatal Error -- Listing File Did Not Open ........... 17
  128.                7.4  Fatal Error -- Object File Did Not Open ............ 17
  129.                7.5  Fatal Error -- Error Reading Source File ........... 17
  130.                7.6  Fatal Error -- Disk or Directory Full .............. 17
  131.                7.7  Fatal Error -- File Stack Overflow ................. 17
  132.                7.8  Fatal Error -- If Stack Overflow ................... 17
  133.                7.9  Fatal Error -- Too Many Symbols .................... 17
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.                                      2
  182.  
  183.  
  184.  
  185.           1.0  How to Use the Cross-Assembler Package
  186.  
  187.                First, the question, "What does a cross-assembler do?" needs
  188.           to be addressed as there is considerable confusion on this point.
  189.           A cross-assembler is just like any other assembler except that it
  190.           runs on some CPU other than the one for which it assembles code.
  191.           For example, this package assembles Z-80 source code into Z-80
  192.           object code, but it runs on an 8088, a 68000, or whatever other
  193.           CPU you happen to have a C compiler for.  The reason that cross-
  194.           assemblers are useful is that you probably already have a CPU
  195.           with memory, disk drives, a text editor, an operating system, and
  196.           all sorts of hard-to-build or expensive facilities on hand.  A
  197.           cross-assembler allows you to use these facilites to develop code
  198.           for a Z-80.
  199.  
  200.                Note that if you compile this cross-assembler on a Z-80
  201.           system, it becomes a normal assembler instead of a cross-
  202.           assembler.  That is, it compiles Z-80 source code to Z-80 object
  203.           code while running on a Z-80.
  204.  
  205.                This program requires one input file (your Z-80 source code)
  206.           and zero to two output files (the listing and the object).  The
  207.           input file MUST be specified, or the assembler will bomb on a
  208.           fatal error.  The listing and object files are optional.  If no
  209.           listing file is specified, no listing is generated, and if no
  210.           object file is specified, no object is generated.  If the object
  211.           file is specified, the object is written to this file in "Intel
  212.           hexadecimal" format.
  213.  
  214.                The command line for the cross-assembler looks like this:
  215.  
  216.                     AZ80 source_file { >list_file } { -o object_file }
  217.  
  218.           where the { } indicates that the specified item is optional.
  219.  
  220.                Some examples are in order:
  221.  
  222.                az80 tests6.asm                    source:   testz80.asm
  223.                                                   listing:  none
  224.                                                   object:   none
  225.  
  226.                az80 testz80.asm -l testz80.prn    source:   testz80.asm
  227.                                                   listing:  testz80.prn
  228.                                                   object:   none
  229.  
  230.                az80 testz80.asm