home *** CD-ROM | disk | FTP | other *** search
/ Language/OS - Multiplatform Resource Library / LANGUAGE OS.iso / dsp / dspgroup / mac320.arc / OFFLOAD.DOC < prev    next >
Encoding:
Text File  |  1985-02-24  |  5.0 KB  |  135 lines
  1. OFFLOAD DOWNLOADER
  2.  
  3. OFFLOAD is general purpose downloader and terminal emulation program for use
  4. with a wide variety of maufacturer's supplied emulation equipment.  OFFLOAD is
  5. supplied in versions for the IBM and TI computers:
  6.  
  7.     OFFTI    is for the TI professional computer
  8.     OFFIBM    is for the IBM pc
  9.  
  10. In the remainder of this discussion the two of these implementations will be
  11. referred to as OFFLOAD.
  12.  
  13.  
  14. The OFFLOAD utility supports  either XON/XOFF or ACK/NACK protocol on
  15. download, and several download formats.  The default settings are ACK/NACK
  16. (wherein the receiving unit sends '0' <cr> in response to a correctly received
  17. object record) and TEKTRONIX HEX download format.  The default settings can be
  18. changed by an options parameter at the time of OFFLOAD invocation.
  19.  
  20. OFFLOAD is invoked as:
  21.  
  22.     OFFLOAD OBJECT <options>
  23.  
  24. where:
  25.  
  26. OBJECT is a drive/file specification indicating a file of type .HEX
  27.  
  28. <options> is an optional list of operational parameters:
  29.  
  30.     TK    indicates TEK HEX download format (default)
  31.     TI    indicates TI tagged object format
  32.     M   indicates MOTOROLA S record format
  33.     N    indicates INTEL HEX object format
  34.         use N for downloading to the COP400 MOLE
  35.  
  36.  
  37.  
  38.  
  39.     A    indicates ACK/NACK protocol  (default)
  40.     X    indicates XON/XOFF protocol
  41.  
  42.  
  43.  
  44. OFFLOAD performs the necessary format conversion during the download
  45. process, you need not execute HEXCONV to create the desired object
  46. code format.
  47.  
  48. As an example, to download a file OBJECT.HEX on drive B:, using an IBM pc
  49. with TI tagged object format, and XON/XOFF protocol, the command would be:
  50.  
  51.     OFFIBM    B:OBJECT    XTI
  52.  
  53. There can be no spaces in the options list, and the order of the parameters
  54. is immaterial.
  55.  
  56.  
  57.  
  58.  
  59. OFFLOAD enters in the terminal emulation mode, under which you must establish
  60. the initial dialogue with the emulation equipment.  When you have established
  61. communication with the device and are ready to download the file press
  62. Control/c.  After the download function is completed OFFLOAD re-enters the
  63. terminal emulation mode to allow program debugging.  Program upload is NOT
  64. SUPPORTED.
  65. SYMBOLIC DEBUGGING
  66.  
  67. Offload provides access to the symbols defined by your program. You must
  68. first cause the assembler to create a symbol table .SYM file at the time
  69. of assembly. The MACxx documentation defines the assembly parameter list
  70. as .XYZ where X,Y are the source and object drive specifications, and
  71. Z defines the type of assembly and assembler output. The presence of a
  72. fourth character, immediately following the Z option instructs the assembler
  73. to create a symbol file on the drive specified by the fourth character.
  74. In order for the .SYM file to be available to the OFFLOAD program this
  75. .SYM file must reside on the same dirve as the object file. For example,
  76. to assemble a source file on drive A:, and create an object and symbol
  77. file on drive B:, without generating a screen listing:
  78.  
  79.     MACxx    source.ABEA
  80.  
  81. Where:
  82.     .A    defines A as the drive containing source.asm
  83.      B    defines the drive for the file source.hex
  84.      E    says show only only the assembly errors
  85.      B  (the final parameter) defines the drive for source.sym
  86.  
  87.  
  88. OFFLOAD searches the directory containing the object file .HEX for
  89. an associated symbol file .SYM. If the symbol file is found OFFLOAD
  90. reads the symbol table and develops a symbol table which allows you
  91. to access your program symbols by name. In the following (F1) refers
  92. to the single key Function 1, and it is assumed that a .SYM file is
  93. present along with your object file.
  94.  
  95. In the terminal emulation phases of its operation, OFFLOAD allows you
  96. to reference your program symbols by name. References to your symbol
  97. table must be bracketed by the (F1) key. OFFLOAD collects the sequence
  98. of characters between two successive (F1) keys, searches through the
  99. symbol table, and replaces the symbol name by the four hex character
  100. representation of the symbol value.  Thus if the emulation hardware
  101. command for display memory is DM, and if you wish to display memory
  102. at the location LOOP in your program, you may enter:
  103.  
  104.     DM (F1)LOOP(F1)
  105.  
  106. After you type the first (F1) key, the cursor will be seen to
  107. cover a question mark, indicating that OFFLOAD is in the process
  108. of gathering the symbol name, and you must end that name with a
  109. matching (F1) key. When the trailing (F1) is found, OFFLOAD will
  110. erase the symbol name, and transmit the four character sequence
  111. representing the symbol value. Assuming that LOOP is located at
  112. 1234H in your program the above sequence will be equivalent to
  113.  
  114.     DM 1234
  115.  
  116. If OFFLOAD cannot find the symbol the display will show:
  117.  
  118.     LOOP undefined (KEY)
  119.  
  120. and await a key press. When you press a key the entire message
  121. will be erased to restore the screen to the state before your entry
  122. of the symbol name.
  123.  
  124. Note, that the emulation hardware may require that you identify hex
  125. values by some precursor character, such as %,$, or >. OFFLOAD does
  126. not supply these tag characters.  If your emulation hardware requires,
  127. say the > character, then you must type this character before the (F1)
  128. sequence:
  129.  
  130.     DM >(F1)symbol(F1)
  131.  
  132.  
  133.  
  134.  
  135.