home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / c64cross / c64slk.aaa < prev    next >
Text File  |  2020-01-01  |  10KB  |  214 lines
  1.                         Commodore 64/128 Kermit v2.2 (76)
  2.                               General Information
  3.                           Last updated: August 23, 1992
  4.                      by Kent Sullivan (kentsu@microsoft.com)
  5.  
  6.  
  7. Introduction
  8. ------------
  9.  
  10. Kermit v2.2 is a powerful public-domain telecommunications program for your
  11. Commodore 64 or 128 (in 64 mode).  This program, as its name suggests,
  12. implements the Kermit file transfer protocol and also has many other useful
  13. features.
  14.  
  15. As of May 1992, there are two "flavors" of Kermit v2.2.  The first is the
  16. one that has been available for some time.  It supports modems interfaced via
  17. the standard way--the Commodore 64/128's "user port".  The second is for
  18. modems interfaced via the SwiftLink-232 high-speed serial interface ONLY.  The
  19. first flavor of Kermit is minor version #73 while the second is minor version
  20. #76.
  21.  
  22. This file and all other files beginning with "c64slk" concern the SwiftLink-232
  23. flavor of Kermit v2.2 only, while the files beginning with "c64ker" concern the
  24. user port flavor of Kermit v2.2 only.  For more information on the "c64ker"
  25. files, see the file "c64ker.aaa".
  26.  
  27.  
  28. Description of Features
  29. -----------------------
  30.  
  31. Here is a list of features for C-64 Kermit v2.2 (these features are common
  32. between the user-port and SL-232 versions):
  33.  
  34. + Comprehensive terminal emulation: Kermit emulates most all of the features of
  35.   a DEC VT-100 terminal very closely, including support for VT-52 mode, personal
  36.   function (PF) keys, and the numeric keypad.  C-128 users may use their extra
  37.   numeric keypad and grey keys as well.  Kermit also implements the Insert/
  38.   Delete features of the VT-102.
  39.  
  40. + Multiple display options: Kermit can display 40 or 80 columns of text using a
  41.   bit-mapped screen on a standard 40-column monitor, or, on a C-128, using the
  42.   built-in 80-column screen (with an 80-column monitor).  Kermit also supports
  43.   the Batteries Included BI-80 80-column card for the C-64.
  44.  
  45. + Graphics terminal support: Kermit emulates the main features of the Tektronix
  46.   4010/4014 graphics terminal, with resolutions of 320x200 (C-64 screen) or
  47.   640x200 (C-128 screen).
  48.  
  49. + Flexible file transfers: Kermit has special file types to transfer PETSCII
  50.   (Commodore's special ASCII) and standard ASCII text files, binary files
  51.   (graphics screens, etc.), Speedscript (Compute!'s popular word processor)
  52.   files, and Power-C C language source code files.  All necessary conversions
  53.   are handled automatically.
  54.  
  55. The main feature difference between the two flavors of Kermit v2.2 is maximum
  56. baud rate.  The user port version of Kermit can communicate at speeds of 300
  57. and 1200 bps, or 2400 bps when used on a C-128 with the C-128's 80-column
  58. screen.  The SL-232 version of Kermit can communicate at higher speeds.
  59.  
  60.  
  61. Files Available from Columbia University's Official Kermit Archive
  62. ------------------------------------------------------------------
  63.  
  64. Below is a list of C-64/128 Kermit v2.2 files, user port version, available
  65. from the official Kermit archive, watsun.cc.columbia.edu.  The first two groups
  66. of files have the base filenames "c64slk" and "c64boot" and are located in the
  67. directory "kermit/c" (corresponds to Tape C).  These files are all plain ASCII
  68. text and are available for those situations where the more-convenient binary
  69. files cannot be used.  Some of the files related to user port Kermit are of
  70. use to SwiftLink-232 Kermit.  These files have the base filenames "c64ker" and
  71. are also located in the directory "kermit/c" (Tape C).  Finally, there is a
  72. binary archive of SwiftLink-232 Kermit (C-64 SDA [ARC] format) located in the
  73. directory "kermit/bin".
  74.  
  75.  
  76. Filename    Description
  77. --------    -----------
  78.  
  79. c64slk.aaa  This information file.
  80.  
  81. c64slk.ann  Announcement of SwiftLink-232 Kermit v2.2.
  82.  
  83. c64slk.get  Instructions for building Kermit v2.2 (76) from the ASCII source
  84.             file "c64slk.hex".
  85.  
  86. c64slk.hex  Kermit v2.2 (76), encoded in .HEX format.  See "Getting a Copy of
  87.             Kermit" below and the file "c64slk.get" for instructions.
  88.  
  89. c64slk.m65  6502 assembler source code for Kermit v2.2 (76).  See "Note to
  90.             Programmers" below.  You do not need this file unless you are a
  91.             programmer.
  92.  
  93. c64slk.sec  C-128 autoboot sector maker for Kermit v2.2 (76).  Use this program
  94.             if you would like to autoboot Kermit on a C-128.
  95.  
  96. c64slk.txt  Documentation addendum covering the differences in user port and
  97.             SL-232 Kermit.  See "c64ker.doc" below.
  98.  
  99.  
  100. Filename     Description
  101. --------     -----------
  102.  
  103. c64boot.bas  C-64 BASIC program which works with "c64boot.c" to download Kermit
  104.              from .HEX source file.  See "Getting a Copy of Kermit" below and
  105.              the file "c64slk.get" for instructions.
  106.  
  107. c64boot.c    C language program to be compiled on host computer.  Works with
  108.              "c64boot.bas" to download Kermit from .HEX source file.  See
  109.              "Getting a Copy of Kermit" below and the file "c64slk.get" for
  110.              instructions.
  111.  
  112.  
  113. Filename    Description
  114. --------    -----------
  115.  
  116. c64ker.doc  Kermit v2.2 (73) documentation in plain ASCII format.
  117.  
  118. c64ker.rom  Binary image, encoded in .HEX format, of replacement character ROM
  119.             for use with Batteries Included BI-80 80-column card (C-64).  Read
  120.             the notes prepended to "c64ker.rom" to learn when and why you would
  121.             want this file.
  122.  
  123.  
  124. Filename        Description
  125. --------        -----------
  126.  
  127. c64help.txt     Short text file explaining the contents of the binary archives
  128.                 (both user port and SL-232) stored at Columbia U.
  129.  
  130. c64kerv22b.sda  C-64 self-dissolving archive (SDA) of documentation for Kermit
  131.                 v2.2 (73).  Equivalent to the file "c64ker.doc" except it is
  132.                 broken up into seven smaller files.
  133.  
  134. c64slkv22s.sda  C-64 SDA of Kermit v2.2 (76), SLKERMIT.INI, C-128 autoboot
  135.                 sector maker, and documentation addendum covering differences
  136.                 between v2.2 (73) and v2.2 (76).
  137.  
  138.  
  139. Getting a Copy of Kermit
  140. ------------------------
  141.  
  142. Getting a copy of Kermit v2.2 (76) can present a chicken-and-egg situation: you
  143. want the program to do file transfers but you have no file-transfer program
  144. with which to get it.  For those situations, you can use some utilities to
  145. "bootstrap" a copy.  The process is covered in detail in the file "c64slk.get".
  146.  
  147. The process for creating your own Kermit executable ("bootstrapping") is not
  148. easy to do and it is very time-consuming.  Fortunately the process has recently
  149. been overhauled and is much easier to do now.  Even so, people without some C-64
  150. programming experience and reasonable experience with whatever time-sharing
  151. ("host") computer they have an account on may have considerable difficulty
  152. getting things to work.
  153.  
  154. Instead of creating a Kermit executable from scratch, try locating a friend
  155. with a copy of C-64 Kermit (most any version will do).  Use that Kermit to
  156. download the Kermit v2.2 (76) binary archive.  Once on your C-64/128, the
  157. binary can be unpacked simply by LOADing and RUNning it.
  158.  
  159. If you don't have access to a copy of C-64 Kermit, try locating a friend with
  160. a copy of IBM PC Kermit (MS-Kermit).  Download the C-64 Kermit binary to
  161. an IBM PC then use one of the many utilities that can read MS-DOS disks
  162. (Big Blue Reader is one) to transfer the file to C-64 format.  (You will
  163. need a 1571 or 1581 disk drive to do this; a 1541 won't work.)
  164.  
  165. You can also obtain Kermit from many sources other than Columbia University,
  166. such as bulletin boards, user groups, and major network services.  Four sites
  167. which are kept as current as possible are: Quantum Link (Telecommunications
  168. area), CompuServe (CBMAPP area), GEnie (Commodore Flagship area), and
  169. milton.u.washington.edu on the Internet (directory public/c64now/telecom).
  170.  
  171. If none of the above alternatives is feasible, you can order Kermit on a disk
  172. for a small fee.  Kent Sullivan distributes the following Kermit-related items:
  173.  
  174. Disk with C-64/128 Kermit v2.2 (76), SLKERMIT.INI, on-disk documentation,
  175.   and C-128 autoboot sector maker.  (Disk is in CBM 1541 format):         $5.00
  176.  
  177. C-64/128 Kermit v2.2 (73) & (76) User's Guide (laser-printed):            $7.50
  178.  
  179. Replacement character ROM for Batteries Included BI-80 80 column card
  180.   (Adds missing ASCII characters plus VT-100 character graphics.
  181.    Works with either flavor of Kermit v2.2):                              $7.50
  182.  
  183. All prices are postpaid (First Class Mail) to U.S. addresses.  Add $5.00 per
  184. order for shipment outside of the U.S. (airmail).  U.S. funds ONLY will be
  185. accepted.  Please make checks payable to "Kent Sullivan" and send orders to:
  186.  
  187.   Kent Sullivan
  188.   16611 NE 26th St.
  189.   Bellevue, WA 98008
  190.  
  191. Please allow 4-5 weeks for delivery within the U.S., longer for outside.
  192. Delivery time is shorter for orders paid for with guaranteed funds (cashier's
  193. check or money order).
  194.  
  195.  
  196. Note to Programmers
  197. -------------------
  198.  
  199. As you can see, the 6502 assembly language source code for Kermit is available
  200. (c64slk.m65).  You can use most any assembler to build the program.
  201. Development on a C-64 or C-128 system will be painful, however, due to the huge
  202. size of the source code.  We therefore recommend that you assemble the program
  203. on another platform (using a cross assembler) and transfer the binary to the
  204. C-64/128 for testing and use.
  205.  
  206. If you do not have access to a cross assembler, contact Kent Sullivan.  He has
  207. cross assemblers for both Unix and OS/2 systems which are compatible with the
  208. source code.  Also available is the source code for the C-128 boot sector.
  209.  
  210. Contact Kent at the address at the beginning of this file if you would like
  211. to receive the assembler and you have Internet access, or send $5.00 to the
  212. address in the previous section to receive it on an IBM PC floppy.  Please
  213. specify which version (Unix or OS/2) you would like (or both).
  214.