home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / lambda / soundpot / a / crowecpm.lbr / CROWECPM.DZC / CROWECPM.DOC
Encoding:
Text File  |  1993-10-26  |  7.3 KB  |  156 lines
  1.                  CROWECPM-----A Z80 ASSEMBLER
  2.  
  3.  
  4. The assembler provides all the features of Zilog's assembler except
  5. for macros, conditional assembly and lower case. It was originally 
  6. written to be used with cassette or paper tape, with the desired pass
  7. number entered from the console. The assembler is now set up to recieve
  8. the pass numbers from a buffer in the program itself. The output of the 
  9. assembler is sent to files except the error listing which is sent to the
  10. console. For each pass, the source is re-read and the appropriate output
  11. generated. Pass 1 builds the symbol table and is required. Pass 2 outputs
  12. the assembly listing, pass 3 writes Intel format hex object and pass 4
  13. gives an assembly listing of those lines containing errors on the console.
  14. The assembler has been modified to perform pass 4 before writing the files
  15. (passes 2 and 3) so that errors can be seen and corrected before the time
  16. consuming output is done.
  17.  
  18. The linkage routines are written so that the assembler can be run as
  19. a standard CP/M .COM file with the following command format: 
  20.  
  21.         CROWECPM FILENAME.YY  
  22.  
  23. The characters in the normal file extension position are Y/N selects
  24. (default is Y), the first for listing file and the second for the hex
  25. object file. The source must have a file extension of .Z80 while the
  26. listing is created with an extension of .PRN and the object with an
  27. extension of .HEX. Only minimal error checking and reporting is done
  28. when creating files. If no source file with the correct name is found
  29. a message is displayed. If any other disk error on a BDOS call occurs,
  30. that is reported. In either case, the routine waits for a keystroke
  31. before exiting to CP/M.
  32.  
  33. SYNTAX--------------------------------------------------------------------
  34.  
  35. The CROWECPM assembler requires that the source file be written using 
  36. standard Zilog mnemonics. In addition it requires that tabs be used as
  37. field delimiters. Labels may have colons following but this is not required.
  38. Comments can be entered anywhere (in any field) following a semicolon as
  39. is usually the case. Hexidecimal numbers that begin with a letter must be
  40. preceded by a 0 and conclude with an H with no imbedded spaces. Since the
  41. source of the assembler is included, and it is syntactically correct, it
  42. can be used as a model of assembly language programming.
  43.  
  44. FUNCTIONAL OPERATORS-------------------------------------------------------
  45.  
  46. +        MONADIC PLUS
  47. -        MONADIC MINUS
  48. .NOT. or \    LOGICAL NOT
  49. .HIGH.        VALUE OF MOST SIGNIFICANT BIT
  50. .LOW.        VALUE OF LEAST SIGNIFICNANT BIT
  51. .RES.        RESULT
  52. **        EXPONENTIATION
  53. *        MULTIPLICATION
  54. /        DIVISION
  55. .MOD.        MODULO
  56. .SHR.        LOGIGAL SHIFT RIGHT
  57. .SHL.        LOGICAL SHIFT LEFT
  58. +        ADDITION
  59. -        SUBTRACTION
  60. .AND. or &    LOGICAL AND
  61. .OR. or ^    LOGICAL OR
  62. .XOR.        LOGICAL EXCLUSIVE OR
  63. .EQ. or =    EQUALS
  64. .GT. or >    GREATER THAN
  65. .LT. or <    LESS THAN
  66. .UGT.         UNSIGNED GREATER THAN 
  67. .ULT.        UNSIGNED LESS THAN
  68.  
  69. PSEUDO-OPS-----------------------------------------------------------------
  70.  
  71. The following Pseudo-ops are supported by CROWECPM:
  72.  
  73. ORG ---Sets the address reference
  74. EQU ---For assigning a value to a label (can appear only once per label)
  75. DEFL --Also assigns a value to a label but can be used to assign different
  76.     values to a label at different places in the program 
  77. END ---Must conclude the program. Can be followed with the starting address
  78.     of the target program.
  79. DEFB --Defines the content of one byte of memory at the address the OP 
  80.     appears in the program.
  81. DEFB 'x'--Same as above but defines the byte to be the ascii code for the 
  82.     character between the quotes. (x in the example)
  83. DEFW --Defines the contents of two bytes of memory
  84. DEFS --Reserves bytes in memory beginning with the address the OP appears
  85. DEFM 'x'--Defines the contents memory to be the ascii code of the characters
  86.     appearing between the quotes----MUST NOT EXCEED 32 CHARACTERS-----
  87. TITLE 's'-Defines the program title. It is printed in the listing headers.
  88. __________________________________________________________________________
  89. WARNING___________________________________________________________________
  90.  
  91. An additional note about the assembler the way it stands:  there
  92. is a limit of 32 characters for a quoted string as operand of a DEFM
  93. statement.  If this limit is exceeded NO error message is generated, the
  94. string is truncated.  If you're not careful, the terminating '$' for
  95. a CP/M output string could be lost and the results would be unpredictable.
  96. __________________________________________________________________________
  97. __________________________________________________________________________
  98.  
  99. LISTING THE .PRN FILE-----------------------------------------------------
  100.  
  101. The assembler has a strange way of creating the .PRN file which will
  102. cause problems on many printers. A program is included with the disk 
  103. to solve this bug and must be used to send your listing file to the 
  104. printer. See PRINTPRN.DOC for details.
  105. __________________________________________________________________________
  106.  
  107. The CROWCPM.Z80 file has the linkages incorporated into it, near the
  108. end.  As it now stands, the symbol table is limited only by the amount of
  109. available memory since the assembler reads the start address of BDOS from
  110. locations 6&7 and sets that as the top of available symbol space.  
  111.  
  112. There has been one minor improvement to the assembler: you can now
  113. specify that the .LST or .HEX files should be sent to drive B rather than
  114. the current default drive by putting a B in the proper position in the 
  115. normal filename extension.  E.g. CROWECPM CROWECPM.NB would assemble the 
  116. file CROWECPM.Z80, skip the .LST file and send the .HEX file to drive B.
  117. The source file must still reside on the same drive as the assembler.
  118.  
  119. The source is currently set up for the CROWECPM assembler. To assemble it
  120. with M80 you will need to add ASEG and .Z80 commands to it.
  121.  
  122. ****************************************************************************
  123.  
  124. Bug fixes from Thomas Hameenaho
  125.  
  126. The first bug resulted when the single quote character in EX AF,AF'
  127. caused the assembler to expect the following characters
  128. to be a text string. Now I test if the character preceding the ' is
  129. a 'F', if so, the 'QUOTE' flag should not be set.
  130.  
  131. The other bug (LBFSZ-1) resulted because the minus character (instead
  132. of the "_" character) was declared legal in a label.
  133. Probably a typing error when entering the source code.
  134.  
  135. So now CROWCPM.COM will assemble CROWECPM.Z80.
  136.  
  137.     Thomas Hameenaho
  138.     Djaknegatan 7
  139.     S-754 23 Uppsala
  140.     Sweden
  141. *****************************************************************************
  142.  
  143. Enhancements from Micro Cornucopia
  144.  
  145. The assembler we received was machine dependent. Rather than just changing
  146. it so that it would run on the Kaypro we replaced the machine dependent
  147. code with standard CP/M function calls. As a result the assembler should
  148. now run on any standard CP/M machine. We have tested it with the Big Board
  149. running double density and a Kaypro with a Winchester sub-system. If you
  150. have any problems with the assembler or improve it in any way please contact
  151. us.
  152.  
  153.     Micro Cornucopia
  154.     PO BOX 223
  155.     Bend OR 97709
  156. ******************************************************************************