home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / cpm86 / README.TXT < prev   
Text File  |  2020-01-01  |  6KB  |  144 lines
  1. KERMIT FOR CP/M-86
  2.  
  3. The version of Kermit implemented under the CP/M-86 operating system
  4. is called Kermit-86 (as is the MSDOS/PCDOS version).  The source file
  5. names all start with the prefix "c86".  
  6.  
  7. ------------------------------
  8.  
  9. There are six machine-independent source modules in Kermit-86, and
  10. one machine-dependent module which is implemented separately for each
  11. machine supported.
  12.  
  13. The machine-independent modules are:
  14.     c86ker.a86 - top-level routines and system messages & prompts
  15.     c86ker.a86 - command parser
  16.     c86fil.a86 - send and receive local file handlers
  17.     c86pro.a86 - send and receive state table and protocol handler
  18.     c86trm.a86 - terminal mode routines
  19.     c86utl.a86 - CP/M-86 functions and utility routines
  20.  
  21. The machine-dependent modules are:
  22.     c86xap.a86 - NEC APC
  23.     c86xfj.a86 - Fujitsu Micro 16s
  24.     c86xfu.a86 - Future Computers FX20/FX30
  25.     c86xr2.a86 - DEC Rainbow (for version 2.9 - supports baud rates)
  26.     c86xrb.a86 - DEC Rainbow (for version 2.8)
  27.     c86xtx.a86 - Tektronix 4170
  28.     c86xv9.a86 - Victor 9000
  29.  
  30.   NOTE: The rest of this file, as well as the manual, refer to some older
  31.         file naming conventions.  In any case, it necessary to assemble the
  32.         six system-independent modules and the desired system-dependent 
  33.         module, and then to link them together.
  34.         
  35. ------------------------------
  36.  
  37. When implementing Kermit on your system, download all the machine-independent
  38. modules and the 86KERIO module for your system.  Then perform the following
  39. procedure to assemble a new command file.
  40.  
  41.     REN 86KERIO.A86=86KERIO.???    ; Where ??? represents your system
  42.     ASM86 86KERMIT $PZ        ; Assemble the source with no listing
  43.     GENCMD 86KERMIT            ; Generate a CMD file
  44.     REN KERMIT.CMD=86KERMIT.CMD    ; Make the CMD file real
  45.  
  46. Some of this work may be done for you already.  The H86 and CMD files for
  47. the Rainbow are available as RBKERMIT.H86 and RBKERMIT.CMD, and the APC
  48. files are available as APCKERMIT.H86 and APCKERMIT.CMD.  If you are able
  49. to download the H86 file, then you need only perform the last two steps.
  50. If you can do binary command file transfer, then you can obtain the CMD
  51. file directly and need only perform the final renaming step to make your
  52. Kermit operational.
  53.  
  54. The system dependencies in the 86KERIO file take several forms.  The major
  55. difference between machines is the location and operation of the communication
  56. port.  The other main difference is the method of screen control and
  57. cursor positioning employed.  If there is to be terminal emulation performed,
  58. then that code should also be placed in this module.
  59.  
  60. Much effort has been made to isolate the major portion of Kermit from these
  61. dependencies, so that all operations are performed by calling machine-dependent
  62. routines according to a specified interface.  The routines that are required
  63. to be present in the 86KERIO module are:
  64.  
  65. * For port handling *
  66.  
  67. prtout - sets the parity bit if necessary and outputs the character in AL
  68.     to the currently selected serial port.  All registers are preserved.
  69.  
  70. instat - returns to the "skip" location (3 bytes following its call) if
  71.     a character is ready to be read from the currently selected serial
  72.     port, otherwise simply returns.  All registers are preserved.
  73.  
  74. inchr - returns in AL the next character read from the currently selected
  75.     serial port.  All other registers are preserved.
  76.  
  77. cfibf - clears the serial port input buffer, to get rid of extra NAK packets
  78.     and other random garbage.  All registers are preserved.
  79.  
  80. prtbrk - signals a break on the currently selected serial port.  No registers
  81.     are preserved.
  82.  
  83. serini - performs all system-dependent initialization of interrupt vectors,
  84.     port characteristics, and screen handling.  No registers are preserved.
  85.  
  86. serfin - performs de-initialization to clean up the environment when leaving
  87.     Kermit.  No registers are preserved.
  88.  
  89. bdset - the SET subcommand to change baud rates on the serial port.  This
  90.     need not be implemented, and in fact is not on the Rainbow.  No
  91.     registers are preserved.
  92.  
  93. prtset - the SET subcommand to select the communications port for subsequent
  94.     use.  This is not currently implemented on either the APC or the
  95.     Rainbow.  No registers are preserved.
  96.  
  97. shobd - called from the SHOW routine to display the current baud rate value.
  98.     No registers are preserved.
  99.  
  100. shoprt - called from the SHOW routine to display the current port selection
  101.     value.  No registers are preserved.
  102.  
  103.  
  104. * For screen control *
  105.  
  106. poscur - positions the cursor to a specified row and column.  The offset in DX
  107.     points to two consecutive one-byte locations containing the new row
  108.     and column, respectively.  No registers are preserved.
  109.  
  110. clrscr - homes the cursor to row 1 and column 1, then clears the screen.  No
  111.     registers are preserved.
  112.  
  113. clrlin - returns the cursor to the left margin and clears the current cursor
  114.     line.  No registers are preserved.
  115.  
  116. clreol - clears from the cursor location to the end of the current cursor line.
  117.     No registers are preserved.
  118.  
  119. revon - turns on the reverse video attribute, if available.  No registers are
  120.     preserved.
  121.  
  122. revoff - turns off the reverse video attribute.  No registers are preserved.
  123.  
  124. bldon - turns on the bold or highlighting attribute, if available.  No
  125.     registers are preserved.
  126.  
  127. bldoff - turns off the bold attribute.  No registers are preserved.
  128.  
  129. dotab - positions the cursor to the next tab stop, blanking intermediate
  130.     columns.  Just return "skip" if the system hardware handles this when
  131.     a tab character is displayed, otherwise perform the necessary functions
  132.     and return.  No registers are preserved.
  133.  
  134. delstr - this is a string of bytes to be displayed during command entry
  135.     whenever a DEL character (7F hex) is keyed in.  Its net effect should
  136.     be to cause the DEL to act as if a backspace had been typed, that is,
  137.     to move the cursor left one column.  This string will vary depending
  138.     on whether the DEL character causes an echo to the screen.
  139.  
  140. system - this is a string of bytes to identify the system being used.  It
  141.     is displayed in the screen header followed by the string " CP/M-86
  142.     Kermit-86 - Vx.x"
  143.  
  144.