home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / c64cross / c64ker.aaa < prev    next >
Text File  |  2020-01-01  |  11KB  |  224 lines
  1.                         Commodore 64/128 Kermit v2.2 (73)
  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 "c64ker" concern the user-port
  23. flavor of Kermit v2.2 only, while the files beginning with "c64slk" concern the
  24. SL-232 flavor of Kermit v2.2 only.  For more information on the "c64slk" files,
  25. see the file "c64slk.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 "c64ker" 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.  The third group of files is a set of binary archives
  70. (C-64 SDA [ARC] format) and are located in the directory "kermit/bin".
  71.  
  72. Filename    Description
  73. --------    -----------
  74.  
  75. c64ker.aaa  This information file.
  76.  
  77. c64ker.ann  Announcement of Kermit v2.2 and v2.1.  The ordering information in
  78.             this file is outdated.  This file is maintained for historical
  79.             purposes mainly.
  80.  
  81. c64ker.bwr  Tips, tricks, and "gotchas" to be aware of when using Kermit v2.2.
  82.  
  83. c64ker.doc  Kermit v2.2 (73) documentation in plain ASCII format.
  84.  
  85. c64ker.get  Instructions for building Kermit v2.2 (73) from the ASCII source
  86.             files "c64ker.hex" and "c64ker.ini".
  87.  
  88. c64ker.hex  Kermit v2.2 (73), encoded in .HEX format.  See "Getting a Copy of
  89.             Kermit" below and the file "c64ker.get" for instructions.
  90.  
  91. c64ker.ini  C-64 BASIC program which makes KERMIT.INI file required by Kermit
  92.             v2.2 (73).  See "Getting a Copy of Kermit" below and the file
  93.             "c64ker.get" for instructions.
  94.   
  95. c64ker.m65  6502 assembler source code for Kermit v2.2 (73).  See "Note to
  96.             Programmers" below.  You do not need this file unless you are a
  97.             programmer.
  98.  
  99. c64ker.pal  Information on how to tweak Kermit v2.2 (73) to work on European
  100.             (PAL) C-64s and C-128s.
  101.  
  102. c64ker.rom  Binary image, encoded in .HEX format, of replacement character ROM
  103.             for use with Batteries Included BI-80 80-column card (C-64).  Read
  104.             the notes prepended to "c64ker.rom" to learn when and why you would
  105.             want this file.
  106.  
  107. c64ker.sec  C-128 autoboot sector maker for Kermit v2.2 (73).  Use this program
  108.             if you would like to autoboot Kermit on a C-128.
  109.  
  110.  
  111. Filename     Description
  112. --------     -----------
  113.  
  114. c64boot.bas  C-64 BASIC program which works with "c64boot.c" to download Kermit
  115.              from .HEX source file.  See "Getting a Copy of Kermit" below and
  116.              the file "c64ker.get" for instructions.
  117.  
  118. c64boot.c    C language program to be compiled on host computer.  Works with
  119.              "c64boot.bas" to download Kermit from .HEX source file.  See
  120.              "Getting a Copy of Kermit" below and the file "c64ker.get" for
  121.              instructions.
  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. c64kerv22a.sda  C-64 self-dissolving archive (SDA) of Kermit v2.2 (73),
  131.                 KERMIT.INI, and C-128 autoboot sector maker.
  132.  
  133. c64kerv22b.sda  C-64 SDA of documentation for Kermit v2.2 (73).  Equivalent
  134.                 to the file "c64ker.doc" except it is broken up into seven
  135.                 smaller files.
  136.  
  137. c64ker1660.sda  C-64 SDA containing a patch to allow Kermit v2.2 (73) to be
  138.                 used with the CBM 1660 modem.  Also contains documentation for
  139.                 the patch.   Note: The files in this archive are not available
  140.                 in ASCII format; they were created by a third party.
  141.  
  142. c64kerfast.sda  C-64 SDA containing a patch to allow Kermit v2.2 (73) to
  143.                 communicate at 2400 bps on a C-64 (a C-128 is required
  144.                 normally).  Also contains documentation for the patch.  Note:
  145.                 The files in this archive are not available in ASCII format;
  146.                 they were created by a third party.
  147.  
  148.  
  149. Getting a Copy of Kermit
  150. ------------------------
  151.  
  152. Getting a copy of Kermit v2.2 (73) can present a chicken-and-egg situation: you
  153. want the program to do file transfers but you have no file-transfer program
  154. with which to get it.  For those situations, you can use some utilities to
  155. "bootstrap" a copy.  The process is covered in detail in the file "c64ker.get".
  156.  
  157. The process for creating your own Kermit executable ("bootstrapping") is not
  158. easy to do and it is very time-consuming.  Fortunately the process has recently
  159. been overhauled and is much easier to do now.  Even so, people without some C-64
  160. programming experience and reasonable experience with whatever time-sharing
  161. ("host") computer they have an account on may have considerable difficulty
  162. getting things to work.
  163.  
  164. Instead of creating a Kermit executable from scratch, try locating a friend
  165. with a copy of C-64 Kermit (most any version will do).  Use that Kermit to
  166. download the Kermit v2.2 (73) binary archives.  Once on your C-64/128, the
  167. binaries can be unpacked simply by LOADing and RUNning them.
  168.  
  169. If you don't have access to a copy of C-64 Kermit, try locating a friend with
  170. a copy of IBM PC Kermit (MS-Kermit).  Download the C-64 Kermit binaries to
  171. an IBM PC then use one of the many utilities that can read MS-DOS disks
  172. (Big Blue Reader is one) to transfer the files to C-64 format.  (You will
  173. need a 1571 or 1581 disk drive to do this; a 1541 won't work.)
  174.  
  175. You can also obtain Kermit from many sources other than Columbia University,
  176. such as bulletin boards, user groups, and major network services.  Four sites
  177. which are kept as current as possible are: Quantum Link (Telecommunications
  178. area), CompuServe (CBMAPP area), GEnie (Commodore Flagship area), and
  179. milton.u.washington.edu on the Internet (directory public/c64now/telecom).
  180.  
  181. If none of the above alternatives is feasible, you can order Kermit on a disk
  182. for a small fee.  Kent Sullivan distributes the following Kermit-related items:
  183.  
  184. Disk with C-64/128 Kermit v2.2 (73), KERMIT.INI, on-disk documentation,
  185.   and C-128 autoboot sector maker.  (Disk is in CBM 1541 format):         $5.00
  186.  
  187. C-64/128 Kermit v2.2 (73) & (76) User's Guide (laser-printed):            $7.50
  188.  
  189. Replacement character ROM for Batteries Included BI-80 80 column card
  190.   (Adds missing ASCII characters plus VT-100 character graphics.
  191.    Works with either flavor of Kermit v2.2):                              $7.50
  192.  
  193. All prices are postpaid (First Class Mail) to U.S. addresses.  Add $5.00 per
  194. order for shipment outside of the U.S. (airmail).  U.S. funds ONLY will be
  195. accepted.  Please make checks payable to "Kent Sullivan" and send orders to:
  196.  
  197.   Kent Sullivan
  198.   16611 NE 26th St.
  199.   Bellevue, WA 98008
  200.  
  201. Please allow 4-5 weeks for delivery within the U.S., longer for outside.
  202. Delivery time is shorter for orders paid for with guaranteed funds (cashier's
  203. check or money order).
  204.  
  205.  
  206. Note to Programmers
  207. -------------------
  208.  
  209. As you can see, the 6502 assembly language source code for Kermit is available
  210. (c64ker.m65).  You can use most any assembler to build the program.
  211. Development on a C-64 or C-128 system will be painful, however, due to the huge
  212. size of the source code.  We therefore recommend that you assemble the program
  213. on another platform (using a cross assembler) and transfer the binary to the
  214. C-64/128 for testing and use.
  215.  
  216. If you do not have access to a cross assembler, contact Kent Sullivan.  He has
  217. cross assemblers for both Unix and OS/2 systems which are compatible with the
  218. source code.  Also available is the source code for the C-128 boot sector.
  219.  
  220. Contact Kent at the address at the beginning of this file if you would like
  221. to receive the assembler and you have Internet access, or send $5.00 to the
  222. address in the previous section to receive it on an IBM PC floppy.  Please
  223. specify which version (Unix or OS/2) you would like (or both).
  224.