home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / lambda / soundpot / p / z80mr.lbr / AZM-COM.DZC / AZM-COM.DOC
Encoding:
Text File  |  1993-10-25  |  3.5 KB  |  68 lines
  1.  
  2. The Z80MR creates two output files from an assembly language source file
  3. with a .AZM extention. The assembly language file can be any combination
  4. of Z80 mnemonics or assembler commands and pseudo-ops in the correct form
  5. as described in the file Z80MR.DOC. Each line of the source program is 
  6. seperated by a carriage return linefeed and can be created on any editor.
  7.  
  8. The object file is the executable machine code represented by ascii 
  9. characters in a form known as Intel Hex Format. The object file will
  10. have the same filename as the source file but will have a .HEX extension.
  11. This format must be translated into the actual machine executable 
  12. binary values in order to be run on a computer. This can be done with 
  13. LOAD.COM or DDT.COM which came with your CP/M. (described later). Many
  14. EPROM burners only except the program to be burned in Hex format.
  15.  
  16. The listing file is the other ouput by the assembler. It is ascii
  17. representation of the code actually produced by the assembler. There
  18. are many options available for controlling what is included in the
  19. listing file as described in Z80MR.DOC. The listing file will have the
  20. same filename as the source file but will have a .PRN extension.
  21.  
  22. Invoking the Assembler.....................................................
  23.  
  24. To assemble the file TEST.AZM the following command can be used:
  25.  
  26.     Z80MR TEST <carriage return>
  27.  
  28. The assembler will read in the file TEST.AZM from the current drive and
  29. create an object file TEST.HEX and a listing file TEST.PRN.
  30.  
  31. Controlling Output.........................................................
  32.  
  33. Either of the output files (or both) may be omitted. In addition, the files
  34. may be located on different drives. Since the source file must always have
  35. a .AZM extention we may use the extention to control the output.
  36.  
  37.     Z80MR TEST.sol
  38.  
  39. The letter in the 's' position tells the assembler where to find the source
  40. file and may be any disk drive letter from A to D. The  letter in the 'o'
  41. position tells the assembler where to locate the object file and may be
  42. A-D as above or Z if the file is not desired. The letter in the 'l' position
  43. tells the assembler what to do with the listing file. It can be any drive
  44. letter from A-D or Z if the file is not desired. In addition the listing
  45. file may be sent to the console if an X is in that position.
  46.  
  47. Loading Hex Files..........................................................
  48.  
  49. The object file must be translated from Hex format to machine executable
  50. values by another program. If the program was written to ORG at 100H the
  51. program may be loaded with the CP/M utility LOAD.COM. All of the programs
  52. on this disk with a .COM extension are ORGed at 100H. This is where CPM
  53. loads its transient programs. To load TEST.HEX with LOAD.COM just enter
  54.  
  55.     LOAD    TEST
  56.  
  57. The extention of .HEX is assumed.
  58.  
  59. If you have a program that does not ORG at 100H you must use DDT to read
  60. in the .HEX file which it does by translating the Hex format to binary
  61. as it reads it into memory. Once in memory you may manipulate it with
  62. DDT even SAVE an image of the program in memory actually creating a .COM
  63. file. If you write a program that ORGs where CP/M resides you can wipe
  64. out CP/M and have to reset the computer to recover. See the file PHASE.DOC
  65. for some more information on ORGing files at High memory locations.
  66.  
  67. :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
  68.