home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD1.mdf / assemblr / tools / unload86 / unload86.doc < prev   
Encoding:
Text File  |  1988-08-09  |  4.8 KB  |  137 lines
  1. UNLOAD86.COM is a program that converts or "unloads" a file into it's INTeL 
  2. hex representation.  Alternately, it will also output a BNPF, BHLF, OR B10F
  3. type file for those users that require these formats.  This program was 
  4. written in response to the need to have INTeL hex files for downloading to
  5. an EPROM programmer.  As MS-DOS programs don't support INTeL hex, the need
  6. to convert binary files to hex arose.  Most development systems, INTeL, CP/M,
  7. & others do support INTeL hex, and most EPROM programmers expect it.
  8.  
  9.  
  10. Use of the program is simple:
  11.  
  12.  
  13. UNLOAD86  <RETURN>
  14.  
  15. prints a breif help screen.
  16.  
  17. The main form of the unload86 invocation is:
  18.  
  19. UNLOAD86 FILENAME.TYP[/OPTIONS]
  20.  
  21. There must be no spaces beween the filespec, and the slash!  The options are:
  22.  
  23. B  output a BNPF file instead of INTeL hex.  This option overrides any other
  24. selections.  If the B option is chosen, no other options will work, and the
  25. program will output a straight 8-bit BNPF file, uless it has been modified
  26. for BHLF, or B10F.
  27.  
  28. E forces the use of extended address records.
  29.  
  30. P allows selection of an EPROM size so that all unused locations are filled
  31. with the user specified data (defaults to FF)  This option is followed
  32. immediately by a parameter number 0-F.  This parameter is:
  33.  
  34. 0  32 bytes.  Creates a file to fill a 32 byte ROM.  All unused locations
  35. are filled with the user defined data.  As with all these options, if the
  36. file is already longer than 32 bytes, an error message will be displayed
  37. on the system console, and the operation will be aborted.  The file left in
  38. this case is a useful INTeL hex file, but isn't padded up to size as it is
  39. already too big for the device specified.  32 byte devices are generally 
  40. little bipolar ROMs often used as memory decoders
  41.  
  42. 1  64 bytes.  This is also generally a bipolar device.
  43.  
  44. 2  128 bytes.  Bipolar.
  45.  
  46. 3  256 bytes.  1702A EPROM, some bipolars
  47.  
  48. 4  512 bytes.  2704 EPROM.
  49.  
  50. 5  1k bytes.  2708 EPROM.
  51.  
  52. 6  2k bytes.  2716 EPROM.
  53.  
  54. 7  4k bytes.  2732 EPROM.
  55.  
  56. 8  8K bytes.  2764 EPROM.
  57.  
  58. 9  16K bytes.  27128 EPROM.
  59.  
  60. A  32K bytes.  27256 EPROM.
  61.  
  62. B  64K bytes.  27512 EPROM.
  63.  
  64. C  *128K bytes.  27010 EPROM.
  65.  
  66. D  *256K bytes.  Not yet available.
  67.  
  68. E  *512K bytes.  Not yet available.
  69.  
  70. F  *1M bytes.  Not yet available.
  71.  
  72.    * These options force the generation of extended addressing and thus
  73.      do not require the use of the 'E' option.
  74.  
  75.  
  76. It should be noted that all INTeL hex output, regardless of options selected,
  77. is padded up to the next 32 byte increment.
  78.  
  79.  
  80. EXAMPLES:
  81.  
  82.  
  83. UNLOAD86 FOOBAR.COM/B    <-- produces a BNPF file called FOOBAR.BNP
  84.  
  85. UNLOAD86 FOOBAR.COM/EB   <-- produces a BNPF file called FOOBAR.BNP
  86.  
  87. UNLOAD86 FOOBAR.COM/E    <-- produces a hex file called FOOBAR.HEX
  88.                              w/extended addressing
  89.  
  90. UNLOAD86 FOOBAR.COM      <-- produces a hex file called FOOBAR.HEX
  91.  
  92. UNLOAD86 FOOBAR.COM/P0   <-- produces a hex file called FOOBAR.HEX
  93.                              padded to 32 bytes.
  94.  
  95. UNLOAD86 FOOBAR.COM/PF   <-- produces a hex file called FOOBAR.HEX
  96.                              padded to 1M byte, w/ extended addressing
  97.  
  98. UNLOAD86 FOOBAR.COM/PFE  <-- produces a hex file called FOOBAR.HEX
  99.                              padded to 1M byte, w/ extended addressing
  100.  
  101. UNLOAD86 FOOBAR.COM/EPF  <-- produces a hex file called FOOBAR.HEX
  102.                              padded to 1M byte, w/ extended addressing
  103.  
  104. UNLOAD86 FOOBAR.COM/EPFB <-- produces a BNPF file called FOOBAR.BNP
  105.  
  106.  
  107.  
  108. Notes, patches, etc.:
  109.  
  110. UNLOAD86 cannot realisticly handle binary input larger than a megabyte as
  111. the extended addressing scheme runs out of addresses.  If you unload a file
  112. larger than 1 megabyte, the extended addressing will wrap around if it has
  113. been selected with the /E or the /Px options.  When we get to a need for
  114. INTeL hex files derived from files of this size, hopefully INTeL will have
  115. come up with yet another patch to this specification.  Of course, you could
  116. always use BNPF...
  117.  
  118. There are several user patchable options that can be patched with DEBUG.
  119. They are as follows:
  120.  
  121. 102:  FF   This is the data that is padded when using the /Px option.
  122.            Change to meet your requirements.
  123.  
  124. 103:  'PN' Change to 'HL' for BHLF output instead of BNPF, or '10' for B10F.
  125.            Or any other two ASCII characters for other variations of this.
  126.  
  127. 106:  'HEX' Output file type for INTeL hex.  Change to meet your needs
  128.  
  129. 10B:  'BNP' Output file type for BNPF.  Change to 'BHL' for BHLF, or
  130.             'B10' for B10F, or to whatever filetype you prefer for this
  131.             format.
  132.  
  133. This program was written by Mark D. Pickerill on the Pro-Log ABL-2 CP/M
  134. microcomputer. (what else?)  It bears no resemblance to UNLOAD 2.2 or
  135. 3.3 for CP/M by the same author.
  136.  
  137.