Columbia Kermit

home *** CD-ROM | disk | FTP | other *** search

/ Columbia Kermit / kermit.zip / c64cross / c64ker.txt < prev next >

Wrap

Text File | 2020-01-01 | 85KB | 3,107 lines

Commodore 64/128 Kermit User's Guide Version 2.2 Electronic Version -- Copyright 1988 Dr. Evil Laboratories All rights reserved Commodore 64/128 Kermit Version 2.0, 2.1, & 2.2 enhancements by Ray Moody User's Guide v2.2 by Kent Sullivan Kent Sullivan 16611 NE 26th St. Bellevue, WA 98008 Rev. 4 - 1/1/92 i Summary: C-64/128 Kermit Version 2.2 What Kermit Is The term "Kermit" denotes both a specific protocol for transferring files between computers AND those computer pro- grams which can do the transferring. Kermit as a protocol is often called the Kermit Protocol to distinguish it from an actual computer program. Various versions of the Kermit program for different computers also have longer, official names to distinguish themselves. Commodore 64/128 Kermit is a public-domain telecommunications program that utilizes the Kermit protocol for file transfers. C-64/128 Kermit was originally known as Kermit-65. Begin- ning with version 2.0, the name was officially changed to Commodore 64/128 Kermit to reflect the fact that support for the C-128's 80 column screen had been added. The "65" in Kermit-65 signifies that the Commodore 64 has as its CPU the 6510A, a member of the 6500 series family, which also includes the Apple II. In fact, Kermit for the Commo- dore 64/128 was originally translated from Apple II Kermit. Recent Improvements The following describes the improvements made to Kermit for version 2.2. If you are a first-time user of Kermit, you may want to move directly to the Introduction section. As this manual was originally intended to accompany v2.1 (released in May, 1988), also included is a summary of v2.1 improvements. V2.2 really only has one significant change from v2.1: reli- able communication at 2400 bps is now possible (but ONLY when using the C-128 screen driver). There was quite a bit of interest in this feature so we decided it was worth adding right away, before any of the other scheduled additions/fixes listed in the Future Plans for Kermit sec- tion of Appendix A. The main improvements to v2.1 are as follows: + Enhanced DEC VT-100 terminal emulation with support for the VT-100 keypad. Kermit should now work fine with operating systems such as VMS. V2.1 has some VT-102 features added as well: Insert/Delete Line/Character. ii + Limited Tektronix 4010 graphics terminal emulation. Ker- mit can plot both graphics and text with a resolution of 320 x 200 (C-64) or 640 x 200 (C-128). + Commodore 128 grey key and numeric keypad support. The grey keys and the numeric keypad, not normally accessible on a C-128 in C-64 mode, are active within Kermit. + A special file-type for transferring C Power (now sold as Power C) source code files. You can now download C source code ASCII files as well as upload C Power source files. All necessary character translations are handled automatically. + A screen driver for the Batteries Included BI-80 80 column card. This device gives a display as nice as the Commodore 128's 80-column hardware, but lacks many attri- butes such as blinking and bold. In addition to these major improvements, many smaller changes were made. Several bugs were squashed that affected VT-100 emulation, the STATUS command, and other things. For related information, please see Appendix A: Implementation Notes. Hall of Fame Many people have worked on Commodore 64/128 Kermit since its first appearance in March, 1984, continually adding improve- ments and fixing bugs. Below is a list of the people who have worked on the C-64/128 Kermit project over the years. Programming: David Dermott Eric Lavitsky Michael Marchiondo Ray Moody Frank Prindle Documentation: Eric Lavitsky Kent Sullivan C-64/128 Kermit User's Guide Page iii Table of Contents Summary: C-64/128 Kermit Version 2.2 .................. i What Kermit Is ...................................... i Recent Improvements ................................. i Hall of Fame ........................................ ii Introduction: The Kermit User's Guide ................. 1 What You Need to Know ............................... 1 Recommended Texts ................................... 1 Kermit Availability ................................. 2 Syntax of Commands .................................. 2 Tutorial: Introduction to Kermit ...................... 3 Booting Kermit ...................................... 3 Choosing a Screen Driver ............................ 3 The Three Modes of Kermit ........................... 4 Command Mode ...................................... 4 Connect Mode ...................................... 6 File-Transfer Mode ................................ 7 Troubleshooting: If You Have Problems ................. 10 Emulation: Terminal-Type Features ..................... 11 VT-100 Emulation .................................... 11 VT-102 Emulation .................................... 12 VT-52 Emulation ..................................... 12 Tektronix 4010 Emulation ............................ 13 Alpha Text Mode ................................... 13 Point Plot Mode ................................... 14 Vector Plot Mode .................................. 14 Displays: Screen Driver Comparison .................... 15 C-128 80 Column Driver .............................. 15 C-64 80 Column Driver ............................... 15 Batteries Included BI-80 Driver (Standard) .......... 15 Batteries Included BI-80 Driver (Custom) ............ 16 C-64 40-Column Driver ............................... 16 File Transfers: Transferring Files .................... 17 Choosing the Correct File-type ...................... 17 ASCII File-type ................................... 17 Binary File-type .................................. 17 C-Power File-type ................................. 18 PETSCII File-type ................................. 18 Script File-type .................................. 18 Setting the File-byte-size .......................... 18 Using Eight-bit-quoting ............................. 19 Special File-Transfer Mode Features ................. 19 Reference: Command Descriptions ....................... 20 Command List ........................................ 20 Command Summary ..................................... 20 Bye ............................................... 20 Connect ........................................... 20 Directory ......................................... 21 Disk .............................................. 21 Exit .............................................. 22 Finish ............................................ 22 Page iv C-64/128 Kermit User's Guide Get ............................................... 22 Quit .............................................. 22 Receive ........................................... 23 Restore ........................................... 23 Save .............................................. 23 Send .............................................. 24 Set ............................................... 24 Set Baud ........................................ 24 Set Bold ........................................ 25 General Notes on Color .......................... 25 Set Border ...................................... 25 Set Character ................................... 26 Set Dark-background ............................. 26 Set Debugging ................................... 26 Set Eight-bit-quoting ........................... 26 Set Escape ...................................... 27 Set File-byte-size .............................. 27 Set File-type ................................... 27 Set File-warning ................................ 28 Set Flow-control ................................ 28 Set IBM ......................................... 28 Set Light-background ............................ 29 Set Local-echo .................................. 29 Set Parity ...................................... 29 Set Receive ..................................... 30 Set Receive Eight-bit-quote-char .............. 30 Set Receive End-of-line ....................... 31 Set Receive Packet-length ..................... 31 Set Receive Pad-char .......................... 31 Set Receive Padding ........................... 31 Set Receive Quote-char ........................ 32 Set Receive Timeout ........................... 32 Set RS232-registers ............................. 32 Set Screen-driver ............................... 33 Set Send ........................................ 33 Set Terminal-emulation .......................... 34 Set Word-size ................................... 34 Show .............................................. 34 Status ............................................ 35 Appendix A: Implementation Notes ...................... 36 Summary of Kermit Capabilities ...................... 36 Known Restrictions .................................. 36 Future Plans for Kermit ............................. 37 Appendix B: Default Initialization Settings ........... 38 Appendix C: Keyboard Layouts .......................... 39 Commodore 64 Map .................................... 39 Commodore 128 Map ................................... 40 Appendix D: UNIX (TM) Termcap Settings ................ 41 Appendix E: BI-80 Replacement ROM Information ......... 42 C-64/128 Kermit User's Guide Page 1 Introduction: The Kermit User's Guide What You Need to Know This manual introduces Kermit to new users as well as pro- vides an organized reference for experienced users. Some basic knowledge of computers is required to use Kermit. New users should understand the basics of computers and telecom- munications. Please see Recommended Texts below for a short list of books recommended for background knowledge. Don't become frustrated if you have problems initially using Kermit. Careful reading of this manual will clear up most problems that you might have. If you have questions, don't be afraid to ask around. Kermit is a very popular program, so many people know how to use it. You may direct any ques- tions to Ray or me at the address on the front of this manual as well. This manual is available in both laser-printed and elec- tronic form. This, the electronic version, comes as part of the standard Kermit disk from most distribution sites (including Kent Sullivan). The electronic version can be printed out using most any sequential file printer or word processor since all special features like underlining and bold have been removed. The laser-printed version of the manual is available from Kent Sullivan for $7.50 (US funds ONLY; WA residents please add 8.2% sales tax). Recommended Texts The following is a short list of recommended background texts. The area covered is listed first, followed by the title of the text and publishing information. + Basic Commodore Computing: Commodore 64/64C/128 User's Guides. + Basic Telecommunications: Compute!'s Telecomputing on the Commodore 64, Compute! Books. + The Kermit Protocol: Kermit: A File-Transfer Protocol for Universities, 2 parts, Byte magazine, June & July, 1984, & Kermit, A File Transfer Protocol, Digital Press (1987). Page 2 C-64/128 Kermit User's Guide Kermit Availability All Kermit distribution for versions that Ray and I have worked on (versions 2.0 and later) is now handled by Kent Sullivan. In the past, Dr. Evil Laboratories handled distribution, but that company is now out of business. If you have any questions or recommendations concerning Kermit, please contact Kent Sullivan. Kermit is also available for download on many local BBS systems and national information services. Syntax of Commands Most Kermit commands are simple English phrases. Commands are represented in this document in capital letters (i.e. CONNECT) to set them off from any surrounding text. Many standard representations for keys are used. Below is a table showing the representations and the corresponding keys: Representation Actual key <C=> Commodore <CAPS LOCK> Caps Lock * <CLR> Clear (Shifted Home) <CTRL> Control <DEL> Delete <ESC> Escape * <F1>,<F2>,...,<F8> Function key 1,2,...,8 <HELP> Help * <HOME> Home <INST> Insert (Shifted Delete) <LINEFEED> Linefeed * <RETURN> Return <SPACE> Spacebar <STOP> Stop <TAB> Tab * (*) These keys are available on the C-128 keyboard only. For a list of keys that have been re-defined to implement special characters, please see Appendix C: Keyboard Layouts. C-64/128 Kermit User's Guide Page 3 Tutorial: Introduction to Kermit Booting Kermit Kermit is written for the Commodore 64 and 128 (in 64 mode). One Commodore disk drive (or compatible) is required, and a modem. Almost any modem will work except the Commodore 1660. To boot Kermit, follow these easy steps: For Commodore 64: 1. Turn on monitor, drive, and computer. 2. Insert the Kermit disk, label side up, into device 8, drive 0, and close the drive door. 3. Type: LOAD ""BOOT"",8,1 and press <RETURN>. For Commodore 128: 1. Insert the Kermit disk, label side up, into device 8, drive 0, and close the drive door. 2. Turn on the monitor, drive, and computer. 3. Kermit will automatically boot on power-up. Once loaded, you should see the following in black on a grey screen with a blue border: Commodore 64/128 Kermit version 2.2 (70) Type '?' for help Kermit-65> A blinking block cursor should be just to the right of the ">". If you don't see this on your screen, turn off all your equipment and try again. If you still have problems booting Kermit, please see the Troubleshooting section. Choosing a Screen Driver Kermit can use many kinds of displays. You can use either 40 columns or 80 columns (software-driven) on a standard C- 64, or, if you have a Batteries Included BI-80 80-column card, you can use it too. All of these options are avail- able on a C-128, plus the C-128's built-in 80-column display. Kermit defaults to the setting found in its ini- tialization file. Each of the screen drivers has its advantages and disadvan- tages. Not all of the drivers, for example, are capable of supporting features such as underlining or bold. Please see the Screen Driver Comparison section for further details. Page 4 C-64/128 Kermit User's Guide If you want to switch to a different screen driver now, please see the example given in the Command Mode section below. The Three Modes of Kermit Kermit has three basic operational modes: Command, Connect, and File-Transfer. In Command mode, you can communicate directly with Kermit to change various program settings and also enter either of the two other modes. In Connect mode you can communicate with another computer (known in many other terminal programs as Terminal mode). In File-Transfer mode you may send to and receive files from the computer to which you are connected. Let's begin by learning about Com- mand mode and the Kermit parser. Command Mode When Kermit first boots, you are placed automatically in Command mode. From here you can communicate with the pro- gram by typing commands at the "Kermit-65>" prompt. Command mode is really the program's command "parser", which is that part of a computer program which takes your command input and tries to interpret it and then execute the appropriate action. Kermit's command parser is very easy to use. Let's begin with a look at the main level commands. At the top of the screen you should see "Type '?' for help". So let's do just that: Type a "?". A list of Kermit's main commands (there are 16 of them) should appear on the screen in two columns like this: Kermit-65>? Keyword, one of the following: bye connect directory disk exit finish get help quit receive restore save send set show status The "?" is a very helpful feature of the command parser. You can type a "?" at ANY point in the middle of a command to receive a list of the valid ways to complete the command. A complete list of commands may be found in the Command Descriptions section. Let's try a slightly more difficult command to give you practice with the parser. For example, let's say we want to C-64/128 Kermit User's Guide Page 5 change which screen display we are using. After looking at the various main level commands, we deduce that the SET com- mand might be the way to get the job done. Type: SET fol- lowed by a space and then a "?". Kermit should respond with a list that looks like this: Kermit-65>set ? Keyword, one of the following: baud bold border character dark-background debugging eight-bit-quoting escape file-byte-size file-type file-warning flow-control ibm light-background local-echo parity receive rs232-registers send screen-driver terminal-emulation word-size After looking through this list, we can determine we need the SCREEN-DRIVER sub-option. Notice that the parser con- veniently reprinted the SET command so that we can continue where we left off. So, type: SCREEN-DRIVER followed by a space and a "?". Now we have another list, looking like this: Kermit-65> set screen-driver ? Keyword, one of the following: 40-columns 80-columns bi-80 commodore-128 custom-bi-80 It should now be obvious what to do to change to a different screen driver. Try it out. Now, let's go back to 80 columns. One thing you are probably wondering is, "Do I have to type ALL of that out?" Luckily, no, you don't. The left arrow key (upper left corner of the keyboard) is the "Escape" key in Kermit. This key will spell out a command one level at a time for you if you provide it with the first few characters of the command. Note: if you are using a C-128, you can also use <ESC>. To try this out, type: SET SC and hit the left arrow key. Kermit should spell out SCREEN-DRIVER and put a space at the end. Notice that we had to use "sc" and not just "s". Consulting the list above, we can see why. Both SEND and SCREEN-DRIVER begin with an "s". If we had just typed "s", Kermit would have chosen SEND because it is the first command in the list that meets the specified requirements. The same applies for why we spelled out SET. SEND is before SET in the main command list, making the left arrow useless. So keep in mind that you must always use Page 6 C-64/128 Kermit User's Guide enough characters to uniquely identify the command before hitting the left arrow. Ok, let's finish our command. Type "8" and hit the left arrow. Kermit should finish the com- mand. Now press <RETURN>. Presto! We're back to 80-column mode, saving 19 character's worth of typing. Not all commands are nearly this long, but the left arrow (along with the "?") can be very helpful. NOTE: Once you are familiar with the parser, you can save even more keystrokes by using just the abbreviations for the commands. In other words, you don't HAVE to use the left arrow key. For example, you could just type "SET SC 8" to set the screen driver to C-64 80 columns. There are a few other useful tricks to know about the parser. They are: 1) Pressing <CLR> or <CTRL> - <L> instead of <RETURN> to execute a command will clear the screen first and then execute the command. 2) Pressing <CTRL> - <W> while typing a command will back the cursor up to the previous word, erasing any associ- ated text. 3) Pressing <CTRL> - <U> while typing a command will can- cel the command by backing the cursor up to the "Kermit-65>" prompt. Connect Mode Connect mode is the mode in which you will spend most of your time while using Kermit because it is in this mode that you can communicate with another computer (often known as the remote host). Now let's prepare to connect to another computer. Type: CONNECT. This command will take us out of Command mode and into Connect mode. If you type CONNECT then hit <CLR>, the screen will be cleared before entering Connect mode. Every time you enter Connect mode, you will see the message: [Connecting to host: Type ^Y c to return] This tells us that we are in Connect mode and that to return to Command mode we should type <CTRL> - <Y> then type "c". Try it out. Then return to Connect mode. Now we will call the other computer. A Commodore 1670 or other Hayes compatible modem can dial directly from Connect mode via its built-in dialing commands, but with most other modems you will have to dial manually. In other words, Ker- mit does NOT have the capability to auto-dial a modem C-64/128 Kermit User's Guide Page 7 directly. Also please note that Kermit currently does NOT work with the Commodore 1660 modem. It will, however, be supported in a future version. Please see Appendix A: Implementation Notes for further information. We need to check a few things before dialing. Each computer you connect to may have different baud, parity, and word- size requirements. Kermit defaults to the settings found in the initialization file: 1200 bps transmission speed, eight bit word length, no parity, and VT-100 terminal emulation. These settings may be different if you did not get your copy of Kermit from Kent Sullivan. To adjust any of these param- eters, escape back to Command mode and use the SET command as we did above to change the screen-driver. For example, to change to 300 bps transmission speed, type: SET BAUD 300. Remember to use the "?" to get help at any level. If you wish to save any changes you make as new defaults, please see the SAVE command explanation in the Command Descriptions section. Once you have set up your communications parameters correctly, all that's left to do is dial the phone and con- nect to the remote host. File-Transfer Mode Once you have connected to a remote host you may wish to send and/or receive files. With Kermit you can send and receive most any kind of file, as Kermit has automatic translation features for many types of files. For example, you can automatically convert a PETSCII (Commodore's special ASCII) text file to ASCII when sending it to another machine, and vice versa. For a list of the various file- types supported, see the SET FILE-TYPE command explanation in the Command Descriptions section. The procedures for transferring files with Kermit can differ widely depending on the system to which you are connected. This tutorial can't possibly cover every possible situation. Instead, we will walk through a simple transfer and point out some things of which you should be aware. The MOST important thing when attempting to transfer files with Ker- mit is to have your file-transfer parameters set correctly! You may want to skip ahead to the Transferring Files section for more information. Now, we will show two examples: 1) uploading a PETSCII sequential text file, converting it to standard ASCII, and 2) downloading a C language program source code file for use with the C Power (now sold as Power C) C compiler for the 64/128. Page 8 C-64/128 Kermit User's Guide Text File: We are sending and the other end is receiving. In note form, here is what we need to do: 1) Check file-transfer parameters!! Make sure the FILE- TYPE is set to PETSCII. 2) Start Kermit on the host machine using the appropriate command. 3) Tell the host Kermit to RECEIVE the file. 4) Escape to Command mode in our Kermit (<CTRL> - <Y> then <"c">). Type SEND followed by the filename of the Com- modore text file you wish to send. When the two Kermits have finished transferring the file, you will be returned to Command mode. Type: CONNECT and continue with your login session. NOTE: The recommended parameters (work most of the time) are: File type is PETSCII File byte size is EIGHT-BIT Everything else should retain its default value. C Power File: We are receiving and the host is sending. In note form, here is what we need to do: 1) Check parameters!! Make sure the FILE-TYPE is set to C-POWER. 2) Start Kermit on the host machine using the appropriate command. 3) Tell the host Kermit to SEND the file. 4) Escape to Command mode in our Kermit (<CTRL> - <Y> then <"c">). Type RECEIVE followed by the filename of the C source code file you wish to receive in C Power format. 5) When the two Kermits have finished transferring the file, you will be returned to Command mode. Type: CON- NECT and continue with your login session. NOTE: The recommended parameters (work most of the time) are: C-64/128 Kermit User's Guide Page 9 File type is C-POWER File byte size is EIGHT-BIT Word size is EIGHT-BIT Everything else should retain its default value. If you have persistent problems with transferring files, don't hesitate to ask someone for help. Also try VERBOSE debugging to see more of what is happening during transfers. Kermit is very flexible, but flexible can mean complicated! We now have completed the introductory tutorial. The next section of this manual, Troubleshooting, may help if you have some problems using Kermit. The Command Descriptions section describes in detail each of Kermit's commands and will prove to be invaluable to successfully using this pro- gram. Good Luck with Kermit! Page 10 C-64/128 Kermit User's Guide Troubleshooting: If You Have Problems Here are some common problems and their most likely solu- tions. The best troubleshooting usually comes from someone who has experience using Kermit, but this isn't always available. 1) Problem: Kermit won't boot. Solution: Make sure all of your equipment is hooked up correctly. If the red error light blinks on your disk drive, you might a) have a bad disk or b) be missing the initialization file, KERMIT.INI. See the Known Restrictions section of Appendix A for more information. 2) Problem: I can't get out of Connect mode. Solution: Remember to type <CTRL> - <Y>, let up, then hit the letter "c". The escape character might also be set to something other than <CTRL> - <Y>. You can check it with the SHOW ESCAPE command and change it with the SET ESCAPE command. 3) Problem: When I connect to a host machine, all I get is garbage. Solution: Check the baud, parity and word-size parame- ters. You may have to hang up and try again if you change some of the parameters. 4) Problem: I can't see what I am typing, but I see what the host machine is sending. Solution: Check to see if the host machine is supposed to echo characters back to you. You might need to SET LOCAL-ECHO ON. 5) Problem: I downloaded a binary file but the file I received was garbage. Solution: Remember to SET EIGHT-BIT QUOTING ON. Also, check the file type on the host Kermit. It should be set to BINARY as well as on your end. 6) Problem: All of a sudden output stopped appearing on the screen and nothing I type shows up either. Solution: You may have hit the <C=> key accidently, which pauses all data transmission temporarily. Press it again to re-start transmission. C-64/128 Kermit User's Guide Page 11 Emulation: Terminal-Type Features Kermit is a very powerful terminal emulator. For text displays, it can emulate both a VT-100 (with or without added VT-102 features) and a VT-52. For graphics work, Ker- mit has limited Tektronix 4010 emulation. Emulation can be turned completely off as well. It is beyond the scope of this manual to present each of the escape sequences that these terminals use. This section will instead describe in general terms what each of the emu- lations can do, and provide a table of which Tek commands are supported. VT-100 Emulation Most people will use Kermit's VT-100 emulation more than any other. The DEC VT-100 terminal is an industry standard, and so is supported on virtually every medium-to-large-sized operating system. The VT-100 terminal provides you with many powerful features that make communicating with a remote host (especially at speeds under 9600 bps) much more effi- cient and therefore, quicker. The major VT-100 features are summarized below: 1) Scrolling regions. This feature of the VT-100 allows selected parts of the screen to be scrolled, cutting down on character transmission greatly-- making telecommunicating faster. 2) Text attributes. Text on a VT-100 can be displayed in normal or bold, and be vanilla, underlined, or blinking (or any logical combination), and displayed on either a dark or light background. Kermit has the added feature of selectable colors for text, bold text, dark- background, light-background, and border for most screen drivers. 3) Numeric keypad. A VT-100 has a numeric keypad that includes four personal function (PF) keys. Kermit has this feature on both a C-64 & 128. 4) Graphics characters. A VT-100 has a wide range of graphics characters that can be used for graphs and charts. 5) Status line. Kermit has an extra 25th screen line that can be used as a system status line on operating sys- tems such as UNIX (TM). Note that a standard VT-100 terminal does NOT have a status line. Page 12 C-64/128 Kermit User's Guide For a chart showing what keys have been re-defined in Ker- mit, please see Appendix C: Keyboard Layouts. Also, if you are using Kermit on a machine running UNIX (TM), please see Appendix D: UNIX (TM) Termcap Settings, for information on how to customize your termcap to take full advantage of Kermit's features. Not all of the VT-100's features were feasible to support in Kermit. Below is a list of the restrictions to the VT-100 emulation: 1) No 132 column mode 2) No double high/double wide characters 3) Limited terminal reports (only the important ones are emulated) 4) No foreign character sets 5) No smooth scrolling 6) No terminal LEDs For related information, please see the Screen Driver Com- parison section. VT-102 Emulation Only the four most important VT-102 terminal features are present in Kermit. These are Insert Character, Delete Char- acter, Insert Line, and Delete Line. The Insert Character function, as on a real VT-102 terminal, is really a switch- able Insert/Replace mode. These additional features allow MUCH faster, more efficient communication, since the C-64/128 handles much of the time- consuming work (inserting and deleting lines & moving char- acters around on a line). If you are able to utilize the VT-102 features, you will be pleasantly surprised at how much quicker certain operations are, such as editing text files. VT-52 Emulation Kermit emulates a VT-52 terminal as a subset of its VT-100 emulation, just as a real VT-100 terminal does. It is a complete emulation, except that the graphics character set is the VT-100's, not a true VT-52's. All of the real VT-100 terminals we have seen also use the VT-100 character set in C-64/128 Kermit User's Guide Page 13 place of the true VT-52 set in VT-52 mode. Tektronix 4010 Emulation Kermit supports a limited kind of Tektronix 4010 emulation. Two resolutions are supported: 320 x 200 (C-64) and 640 x 200 (C-128 80 col.). You can use the Tektronix emulation even if you are using a BI-80 card, as Kermit will automati- cally switch between the appropriate graphics screen and the BI-80. All plots and text are plotted using the current character color and are plotted on the current background color. Both the 320 x 200 and 640 x 200 screens are a lit- tle too wide horizontally scale-wise compared with a real Tektronix 4010 terminal. We thought it was better to use the full width of the screen given the limited resolution than to have perfect scaling. Kermit supports three Tek modes: Alpha Text, Point Plot, and Vector Plot, for a total of eight different Tek commands. The commands are: Sequence Action <ESC> FF (Form Feed) Activate Tek emulation and clear screen RS (Record Separator) Switch to incremental plot mode US (Unit Separator) Switch to alpha text mode GS (Group Separator) Switch to vector plot mode CAN (Cancel) Deactivate Tek emulation and clear screen Tek mode is also exited when many VT-100/52 escape sequences are received. These include any sequences beginning with <ESC> "[" or <ESC> <upper-case letter>. Also, once Tek mode is activated, any further <ESC> FF sequences received will clear the current graphics screen. Finally, the current text screen is not saved when Tek mode is entered, and the current Tek screen is not saved when Tek mode is exited. Alpha Text Mode Alpha Text mode uses the standard ASCII character set and can display 79 columns by 24 lines of text if Tek mode is entered from any of the screen drivers except C-64 40 columns. If Tek mode is entered from the C-64 40 column screen driver, up to 40 columns of text can be displayed. This mode is used generally to label graphs. No on-screen Page 14 C-64/128 Kermit User's Guide editing should be attempted while in this mode. Point Plot Mode In this mode the drawing pen is given a direction to move and whether to have the pen up (no line drawn) or down (line drawn) when moving. This allows considerable freedom in drawing odd-shaped objects. Vector Plot Mode In Vector Plot Mode, just the endpoints of a line to be drawn are specified. This allows lines to be drawn quickly, since not all the points on the lines must be specified individually. C-64/128 Kermit User's Guide Page 15 Displays: Screen Driver Comparison Each of Kermit's screen drivers has different capabilities. Below is a discussion of the various limitations of the dif- ferent screen drivers. C-128 80 Column Driver This driver is the best that Kermit has. All video attri- butes are supported with no limitations, and the highest Tek resolution (640 x 200) is available. The only feature not available with this driver, that is on some others, is a border. This is because the C-128's 80 column chip (the 8563 VDC) does not support a border. One note: many people who use the 80-column mode on the C- 128 do so on a monochrome monitor. With this setup, only THREE colors are possible: bright, normal, and black. This can pose a problem when trying to set up readable light- and dark-background screens. One solution to this is to buy a grey scale attachment for the 80-column video cable to pro- vide a wider range of grey shades. C-64 80 Column Driver This screen driver is traditionally the most popular, mainly because more people have C-64s than C-128s. When using this driver, even on a C-128, the Tek 320 x 200 mode will be used for graphics. This driver is full-featured except for one minor limitation. Because of the way hi-res graphics screens are created on a C-64, if two characters with different attributes are placed adjacent horizontally, the first character sometimes will not have the correct attribute. For example, if a bold character is printed immediately followed by a flashing character, the bold character may change to a flashing char- acter. This can easily be avoided by inserting a space between the two characters. Batteries Included BI-80 Driver (Standard) The BI-80, an excellent 80-column card for the C-64 (also C-128 in 64 mode), is no longer in production and generally very hard to find used. We added support for it because it offers the same text resolution as the C-128's 80 column screen, making it clearer than the standard C-64 80 column screen. There are several limitations when using this driver. The Page 16 C-64/128 Kermit User's Guide main limitation is that the BI-80 character set is not rede- finable through software, meaning that some characters like the braces, tilde, underscore, etc., are not available. Also, the VT-100/52 graphics character set is not available. A closest match was made on many of the characters, but some of them look pretty unrecognizable. Also, the only character attribute available is reverse. All other modes, such as blinking, bold, and underlined, are mapped into reverse, so you can at least tell when the text is not plain vanilla. Finally, no color change options are available as the BI-80 card operates only in black and white mode with no border. Batteries Included BI-80 Driver (Custom) This driver is for use with the custom BI-80 character ROM available from Kent Sullivan. This driver makes use of the re-defined characters in the replacement ROM. The full ASCII character set is available, as well as the VT- 100/52 graphics character set. All other restrictions from the standard BI-80 driver apply. Please see Appendix E: BI-80 Replacement ROM Information for details on how to obtain a replacement character ROM. C-64 40-Column Driver This driver supports all character attributes and screen functions. Its main limitation is its width-- 40 columns is generally not very useful when communicating with most large computer systems. C-64/128 Kermit User's Guide Page 17 File Transfers: Transferring Files Transferring files with Kermit isn't really any more diffi- cult than with most other Commodore telecommunications packages/protocols. In fact, Kermit is much more flexible-- but flexibility can be confusing. There are three major parameters to be concerned with when transferring files. They are: 1) File-type, 2) File-byte- size, and 3) Eight-bit-quoting. Let's discuss each of them in turn, beginning with File-type. Choosing the Correct File-type Kermit currently supports five different file types. They are: a) ASCII b) Binary c) C-Power d) PETSCII e) Script Each of these file types has a distinct use. When to use one file-type over another can be confusing initially. So, we'll discuss each of them separately, starting with ASCII. ASCII File-type This file-type is used a lot less often than you might think at first. Because Commodore computers (except for the Ami- gas and PCs) use their own, modified character set arrange- ment (PETSCII), most text files you transfer to and from your Commodore will be PETSCII files, not standard ASCII. You will use this file-type only when you a) wish to down- load a standard ASCII file and NOT convert it to a form usable on your Commodore (PETSCII), or b) you have, for some reason, a standard ASCII file that you wish to upload to another computer. If you happen to choose this file-type when you really needed PETSCII, you will be able to tell immediately, as the case of all the text will be reversed. Binary File-type The Binary file-type is not used as often as some of the other file-types. This file-type is used to transfer Commo- dore programs that are executable (i.e. a BASIC program or a machine language game), or memory images such as graphics screens. In other, more technical, terms, this file-type Page 18 C-64/128 Kermit User's Guide allows you to transfer files without performing any charac- ter translation. Note that it's generally a good idea to have Eight-bit-quoting set on when transferring binary files, but more about that below. C-Power File-type This file-type is designed specifically to transfer source code files for use with the C Power (now sold as Power C) C compiler for the C-64 and C-128. C Power files have, in addition to the standard PETSCII file-type base, a few re- defined characters that are needed for C programming, such as braces, the underscore, the pipe, etc. When you use this file-type, any standard C source code files you download to your Commodore will be converted to C Power format. On the other side of the coin, any C Power files you upload to another computer will be converted to standard ASCII source code files. PETSCII File-type This file-type is the most common file-type, and so it is the default Kermit file-type. When you use this file-type, any Commodore text file you upload to another computer will be converted to standard ASCII text. Going the other direc- tion, when you download a standard ASCII text file to your Commodore, it will be translated to PETSCII. If you choose this file type when you really meant ASCII, the case of all the letters in the text will be reversed. Script File-type This is a special file-type for use when transferring files for the Commodore Speedscript word processor (Compute! Pub- lications). Speedscript files have a special file format. If you want to download a standard text file from another computer for Speedscript, you must use this format. The same applies for sending a Speedscript file to another com- puter that uses standard ASCII text files. Note that no attempt is made to translate any of Speedscript's special text formatting or control codes-- you will have to make the appropriate changes manually. Setting the File-byte-size This parameter is often confusing because it sounds a lot like the Word-size parameter. These two parameters are actually quite different. Whereas Word-size describes the width of the data path, File-byte-size describes the size of the data words within files being transferred. C-64/128 Kermit User's Guide Page 19 This parameter can always be left set to EIGHT-BIT. Techni- cally, it is really only necessary to be set to EIGHT-BIT when you are transferring Binary or PETSCII files. Using Eight-bit-quoting This feature allows you to transfer Binary or PETSCII files to and from computers that would normally be unable to han- dle them. Eight-bit-quoting allows you to send files with eight-bit data words over a seven-bit data path. This parameter can always be left set to ON. For instance, I often communicate with a machine where my communications parameters have to be Word-size of Seven-bit and Even Parity. In this kind of environment I would nor- mally be unable to send a program file to a friend on that machine, as program files are Binary (eight-bits). But if I make sure Eight-bit-quoting is ON, everything will be fine. Technically, Eight-bit-quoting prefixes each byte of data that is over seven bits long (greater than ASCII 127 decimal in value) so that it can be transferred along a seven-bit data path. Special File-Transfer Mode Features There are three helpful features available when transferring files. These features are standard in most versions of Ker- mit. They are: Key Sequence Action <RETURN> Force local Kermit to re-send current packet <CTRL> - <X> Cancel transmission of current file <CTRL> - <Y> Cancel transmission of entire batch of files All of these commands are available when receiving a file or files. Because C-64/128 Kermit can't send more than one file per SEND command (a feature called "wildcard send"), the <CTRL> - <Y> feature is not applicable when sending a file. Page 20 C-64/128 Kermit User's Guide Reference: Command Descriptions Command List Kermit v2.2 has 16 major commands, many of which have sub- options. Below is a list of the major commands. Bye Connect Directory Disk Exit Finish Get Help Quit Receive Restore Save Send Set Show Status Command Summary Each of the major commands are described below in alphabeti- cal order. Following the description is one or more exam- ples using the command previously described. Please note that all commands may be entered in either lower or upper case-- case distinction is not made by the Kermit parser. Bye This command causes C-64/128 Kermit to tell the remote Ker- mit, which must be in server mode, to exit and, if applica- ble, terminate its job (or process, etc.). The remote Ker- mit then closes the connection. C-64/128 Kermit finishes by exiting to BASIC. Bye has no arguments, with the format: Kermit-65>bye Connect The CONNECT command puts Kermit into Connect Mode (see the Introduction to Kermit section for more information on Con- nect Mode). Kermit can then begin communication with another computer as a terminal (as defined by the SET TERMINAL-EMULATION command). Connect has no arguments, with the format: Kermit-65>connect To return to Command Mode (see the Introduction to Kermit section for more information on Command Mode), type the escape character followed by a <"c">. The default escape character is <CTRL> - <Y>. The escape character may be fol- lowed by characters other than <"c">. The other valid options and what they do can be viewed by substituting a <"?"> for the <"c">, giving the following display: C-64/128 Kermit User's Guide Page 21 One of the following: ? - this help message. b - send a break signal. c - close the connection. s - status of connection. 0 - send a null. escape-char - transmit the escape character. Directory The DIRECTORY command returns a disk directory of the speci- fied files on device 8 (the normal device number for the first serial Commodore disk drive). DIRECTORY with no argu- ments returns a complete disk directory. The directory may be paused by pressing <SPACE> and resumed by pressing any key, and aborted by pressing <STOP>. The format is: Kermit-65>directory [filename] where [filename] is a valid CBM DOS filename. Some exam- ples: Kermit-65>directory (directory of all files on device 8) Kermit-65>directory ker* (directory of files be- ginning with "ker") Kermit-65>directory k?w (directory of files 3 characters long, begin- ning with "k" and ending with "w") Disk The DISK command allows you to send DOS commands directly to the disk drive controller. This command is useful for ini- tializing the drive, formatting a disk, and deleting unwanted files. This command supports all the standard Com- modore DOS commands, except that NO spaces in filenames are allowed. This is actually a "feature" of the parser and will be corrected in a future version. DISK with no argu- ments will return the drive error in standard DOS format if the drive's red light is blinking. The format is: Kermit-65>disk [string] where [string] is a valid CBM DOS command. Some examples: Page 22 C-64/128 Kermit User's Guide Kermit-65>disk s0:k* (delete all files begin- ning with "k" on device 8) Kermit-65>disk i0: (initialize device 8) Kermit-65>disk n0:files,01 (format disk in device 8, giving it name "files" and id "01"-- note the lack of spaces in the disk name chosen) Exit The EXIT command causes C-64/128 Kermit to stop execution and return control of the machine to BASIC. This command is the same as the QUIT command. Kermit may be restarted immediately with the command RUN. If you type NEW, Kermit can still be restarted most of the time with the command SYS 2064. Exit has no arguments. The format of this command is: Kermit-65>exit Finish This command causes C-64/128 Kermit to tell the remote Ker- mit, which must be in server mode, to exit. When C-64/128 Kermit receives the acknowledgement that this is being done, you are prompted for another command. Finish has no argu- ments, with the format: Kermit-65>finish Get This command causes C-64/128 Kermit to request that the other Kermit (which must be running in server mode) to transmit the specified file to the C-64/128 Kermit. The format of this command is: Kermit-65>get [file-specification] where [file-specification] is a valid file specification for the system on which the other Kermit is running. Quit This command causes C-64/128 Kermit to stop execution and return control of the machine to BASIC. QUIT is identical to the EXIT command (see EXIT above for more information). QUIT has no arguments. The format this command is: C-64/128 Kermit User's Guide Page 23 Kermit-65>quit Receive The RECEIVE command causes C-64/128 Kermit to wait for the remote Kermit to initiate a file transfer (using a command like SEND). The format for this command is: Kermit-65>receive [filename] where [filename] is any valid CBM DOS file name not contain- ing spaces. If no file name is given, C-64/128 Kermit will wait for a file transfer initialization sequence from the other Kermit. If a file name is given, that file name will be used to store the received file(s), regardless of what name is supplied by the other Kermit. If more than one file is received, the second file will have a ".00" appended to it. The third file will have a ".01", and so on. The file name will be truncated appropriately to accommodate the ".XX" suffix. If FILE-WARNING is turned OFF, the ".XX" suf- fix scheme will not be used-- transmission will stop with disk error 63, FILE EXISTS. Some examples: Kermit-65>receive Kermit-65>receive myfile Restore The RESTORE command is used to re-initialize Kermit parame- ters that have been previously saved with the SAVE command. Kermit searches the disk in device 8 for a file named KERMIT.INI. If this file is present on disk, Kermit loads the parameters contained therein and restarts itself with those new parameters. If no KERMIT.INI file is found, Ker- mit crashes, exiting to BASIC. You must insert a disk con- taining a KERMIT.INI file in order to restart Kermit. RESTORE has no arguments, with the command format: Kermit-65>restore Save The SAVE command saves to the disk in device 8 the current Kermit settings and parameters in the file KERMIT.INI. If a KERMIT.INI already exists on the disk, no attempt is made to write over the existing file. The blinking red light on the disk drive indicates error #63, FILE EXISTS. It can be scratched using the DISK command, however. The parameters may later be recalled with the RESTORE command. SAVE has no arguments, with the format: Page 24 C-64/128 Kermit User's Guide Kermit-65>save Send The SEND command allows you to send a file to the remote Kermit. The command format is: Kermit-65>send [filename] where [filename] is any valid CBM DOS filename. Please note that the C-64/128 currently does not have a wildcard send capability. In other words, the entire file name must be specified-- no pattern matching is allowed. Also, only one file may be sent per SEND command. Set The SET command is used to alter various Kermit parameters. The format of this command is: Kermit-65>set [option] [suboption]... where [option] is one of the following: Baud Bold Border Character Dark-background Debugging Eight-bit-quoting Escape File-byte-size File-type File-warning Flow-control IBM Light-background Local-echo Parity Receive RS232-registers Screen-driver Send Terminal-emulation Word-size Many of the above options have sub-options. A description of the options and sub-options follows. Set Baud The SET BAUD command is used to set the speed at which com- munications will take place. The format is: Kermit-65>set baud [value] where [value] is one of the following: 300 1200 2400 Please note that communication speeds above 1200 are possi- ble ONLY on a C-128 when using the COMMODORE-128 screen driver. Because of hardware limitations, speeds above 1200 baud are not possible on a C-64. Also, please note that this command does not support speeds under 300 bps. You C-64/128 Kermit User's Guide Page 25 will need to use the SET RS232-REGISTERS command instead. See the SET RS232-REGISTERS section and the Known Restric- tions section of Appendix A for further information. Set Bold The SET BOLD command sets the bold character color, which can be used for highlighting text in VT-100 emulation mode. An example of bold text is the "Type ? for help" message when Kermit boots. The default bold color is white. The format of this command is: Kermit-65>set bold [color] where [color] is one of the following: Black Blue Brown Cyan Dark-grey Green Light-blue Light-green Light-grey Light-red Medium-grey Orange Purple Red White Yellow General Notes on Color The above colors correspond to the C-64 VIC chip colors. A closest mapping was done for the C-128 8563 VDC (the 80- column chip) BUT: 1) orange is really a dark purple while 2) medium-grey has a greenish tint. Also, note that: 1) The C-128 display has no border (just like a real VT- 100). 2) The BI-80 has no color options or border-- and, any highlighted text is printed as reverse. 3) None of the SET commands for color currently have a corresponding SHOW command. A real VT-100 terminal doesn't have any color options at all-- simply light text on a dark background, or vice versa. So, most of Kermit's screen drivers give you an added capa- bility with their color options. Set Border The SET BORDER command sets the border color, which is available only when using the C-64 40 or 80 column screen drivers. The default border color is blue. The format of this command is: Kermit-65>set border [color] where [color] is one of the colors listed under the "Set Page 26 C-64/128 Kermit User's Guide Bold" section. Set Character The SET CHARACTER command sets the normal character color. The default character color is black. The format for this command is: Kermit-65>set character [color] where [color] is one of the colors listed under the "Set Bold" section. Set Dark-background The SET DARK-BACKGROUND command sets the VT-100 dark back- ground color (the one normally used). This is also the background color used in VT-52 mode or when no terminal emu- lation is used. The default dark-background color is medium-grey. The format for this command is: Kermit-65>set dark-background [color] where [color] is one of the colors listed under the "Set Bold" section. Set Debugging The SET DEBUGGING command is used to set the type of debug- ging generated by C-64/128 Kermit during a file transfer. The format is: Kermit-65>set debugging [keyword] where [keyword] is either OFF, TERSE, or VERBOSE. OFF causes all debugging output to be suppressed. TERSE directs a copy of each packet to the screen, printing any control characters as <CTRL> - <"char">. VERBOSE prints identifying text for each field in the header and prints the actual data section of the packet in the same manner TERSE uses. Set Eight-bit-quoting This command turns on or turns off the eight-bit-quoting feature. Eight bit quoting is used to transmit eight-bit bytes over a seven-bit data path. If the WORD-SIZE is SEVEN-BIT, eight bit quoting allows full eight-bit data to still be transmitted. If the WORD-SIZE is EIGHT-BIT, the quoting is ignored as it is not needed. The format of the command is: Kermit-65>set eight-bit-quoting [keyword] C-64/128 Kermit User's Guide Page 27 where [keyword] is ON or OFF. Set Escape This command sets the escape character, which is the charac- ter used to "escape" back to Command Mode from Connect Mode. The command takes a hexadecimal value of the chosen charac- ter to use as the escape character. The default character is <CTRL> - <Y> ($19). It is usually a good idea to set this character to something which is not used (or at least not used very often) on the system to which C-64/128 Kermit is connected. The format of the command is: Kermit-65>set escape [hex value] where [hex value] is the ASCII value, in hex, of the charac- ter to use as the escape character. Set File-byte-size This command sets the byte size C-64/128 Kermit will use for files being received or transmitted. The file byte size can almost always be EIGHT-BIT, as this setting will work for most SEVEN-BIT and EIGHT-BIT data files. The format of this command is: Kermit-65>set file-byte-size [size] where [size] is SEVEN-BIT or EIGHT-BIT. Set File-type This command tells Kermit what type of file is being sent or received. It is important that this parameter be set correctly since it is used to determine the exact file length when sending files in addition to determining special processing which may have to be done (i.e. when receiving a text file, write all characters in PETSCII). The format of this command is: Kermit-65>set file-type [type] where [type] is ASCII, BINARY, C-POWER, PETSCII, or SCRIPT. An ASCII type file is any standard ASCII text file. A BINARY type file is a memory image (i.e. machine language program, graphics screen, etc.) and is normally transferred in eight-bit mode. A C-POWER type file is a C language source file for use with the C Power C compiler from Pro- Line (now sold as Power C by Spinnaker). A PETSCII type file is a CBM ASCII text file. A SCRIPT type file is a file produced by the Speedscript word processor published by Com- Page 28 C-64/128 Kermit User's Guide pute! Publications. Set File-warning This command determines what C-64/128 Kermit will do when it receives a file with a filename that already exists. If FILE-WARNING is turned ON, C-64/128 Kermit will not overwrite the old file. Instead, it will create a file with the original file name with a ".00" appended to it. It will increment the ".XX" number until it succeeds in creating a unique file name. If FILE-WARNING is turned OFF, C-64/128 Kermit will stop with disk error 63, FILE EXISTS. The for- mat of this command is: Kermit-65>set file-warning [keyword] where [keyword] is either ON or OFF. Set Flow-control The SET FLOW-CONTROL command enables or disables XON/XOFF flow control. With flow control on, C-64/128 Kermit will automatically send a <CTRL> - <S> to the host computer when it can't keep up (i.e. buffer full) to prevent loss of char- acters. Kermit will then send a <CTRL> - <Q> when it is ready to receive more data. This option is recommended for communication speeds of 1200 baud or higher. The format of this command is: Kermit-65>set flow-control [keyword] where [keyword] is either ON or OFF. Set IBM The SET IBM command sets up C-64/128 Kermit to communicate with certain IBM mainframes. This command is needed on a limited number of systems. The format of this command is: Kermit-65>set ibm [keyword] where [keyword] is either ON or OFF. With IBM mode on, C- 64/128 Kermit waits for the IBM turnaround character (XON, <CTRL> - <Q>) before sending any characters to the other Kermit. It also forces the parity type to be mark, the word length to be seven-bit, turns on local echo for the CONNECT command and turns off flow-control. All of these changes are temporary. When IBM mode is turned off, any parameters C-64/128 Kermit User's Guide Page 29 altered are returned to their previous values. Set Light-background The SET LIGHT-BACKGROUND command sets the VT-100 light back- ground color (the one not normally used). The light back- ground is generally used only by programs to catch your attention (usually by flashing the background color quickly). The default light-background color is light-grey. The format for this command is: Kermit-65>set light-background [color] where [color] is one of the colors listed under the "Set Bold" section. Set Local-echo The SET LOCAL-ECHO command specifies whether characters should be echoed locally when connected to another computer. If LOCAL-ECHO is set ON, any character typed on the C-64/128 will be echoed immediately to the C-64/128 as well as being sent to the other computer. This setup is useful when you are connected to another personal computer. If LOCAL-ECHO is set OFF, the characters typed on the C-64/128 are sent only to the other computer (which would normally echo the characters). This arrangement is used by most mainframe hosts. The format of this command is: Kermit-65>set local-echo [keyword] where [keyword] is either ON or OFF. Set Parity This command determines the type of parity to use during communication. Kermit normally uses characters which con- sist of eight data bits with no parity bit. For systems or transmission media which require a specific parity type, Kermit can send characters as seven data bits plus a parity bit. The format of this command is: Kermit-65>set parity [keyword] where [keyword] is one of the following: Page 30 C-64/128 Kermit User's Guide NONE (default) - eight data bits and no parity bit. MARK - seven data bits with the parity bit set to one. SPACE - seven data bits with the parity bit set to zero. EVEN - seven data bits with the parity bit set to make the overall parity even. ODD - seven data bits with the parity bit set to make the overall parity odd. Set Receive It is possible to set various parameters associated with the receiving of data from the Kermit on the other end of the connection (the remote Kermit). SET RECEIVE will enable you to set the various Receive parameters. The format of this command is: Kermit-65>set receive <suboption> The suboptions of the SET RECEIVE command are: Eight-bit-quote-char End-of-line Packet-length Pad-char Padding Quote-char Timeout These suboptions are described below. Set Receive Eight-bit-quote-char This command sets the character to be used to quote charac- ters when EIGHT-BIT QUOTING is ON. The default value is hexadecimal 26 (decimal 38, ASCII "&"). Please see Set Eight-bit-quoting for further information. The format of this command is: Kermit-65>set receive eight-bit-quote-char [value] where [value] is the ASCII value of the character (in hex) C-64/128 Kermit User's Guide Page 31 to use for eight-bit quoting. Set Receive End-of-line This command sets the end of line character that C-64/128 Kermit expects to receive from the remote Kermit. This is the character which terminates a packet of data during file transmission. The default value is hexadecimal 0D (ASCII <CTRL> - <M>, which is <RETURN>). The format of this com- mand is: Kermit-65>set receive end-of-line [value] where [value] is the ASCII value of the character to use for the end of line character (in hex). Set Receive Packet-length This command sets the receive packet length. The value for this parameter must be between hexadecimal 0A (decimal 10) and $60 (decimal 96). Packet lengths outside of this range are illegal. The default value is $5E (94 decimal). The format of this command is: Kermit-65>set receive packet-length [value] where [value] is the ASCII value of the receive packet length (in hex). Set Receive Pad-char This parameter is the padding character that is expected from the remote Kermit. The parameter must be a hex number between 0 and $1F or $7F. All other values are illegal. The default value is 0 (ASCII NUL). The format of this com- mand is: Kermit-65>set receive pad-char [value] where [value] is the ASCII value of the character to be used as a pad character (in hex). Set Receive Padding This command sets the number of padding characters to request before each packet coming from the other Kermit. The default value is 0. The format of this command is: Kermit-65>set receive padding [value] where [value] is the number (in hex) of padding characters to use. NOTE: This command, along with SET RECEIVE PAD- CHAR, is only used under very unusual circumstances. At Page 32 C-64/128 Kermit User's Guide this time, no Kermit program for any machine is known to need padding, and if one did, it would request it without intervention. Set Receive Quote-char This command sets the quoting character that C-64/128 Kermit will expect on incoming files. This is the character used to quote control characters. The default value is $23 (ASCII "#"). The format of this command is: Kermit-65>set receive quote-char [value] where [value] is the ASCII value of the quoting character (in hex). Set Receive Timeout This command sets the number of seconds that C-64/128 Kermit will wait for acknowledgement before it will retry sending or receiving the current packet of data (during a RECEIVE, SEND, or GET). The default value is 15 seconds (hex 0F). The format of this command is: Kermit-65>set receive timeout [value] where [value] is the number of seconds to wait for a message from the remote Kermit (in hex). Set RS232-registers This command sets the 2 RS-232 registers in the C-64/128 that control the baud rate, parity, etc. The 2 registers are treated as a 16 bit hex integer. The first 2 digits are the SECOND register and the last 2 digits are the FIRST register. If only 2 digits are entered, the second register is cleared. The format of this command is: Kermit-65>set rs232-registers [value] where [value] is a four-byte long hex integer. Some exam- ples: C-64/128 Kermit User's Guide Page 33 Kermit-65>set rs232-registers 0006 sets the registers to 06, 00 for 300 baud, 8 bits, no parity Kermit-65>set rs232-registers a026 sets the registers to $26, $A0 for 300 baud, 7 bits, mark parity. See the Commodore 64 or 128 Programmer's Reference Guides for a complete description of the RS-232 registers. Please note that this command is rarely used-- it is a holdover from the earliest versions of Kermit. You can use the SET BAUD and SET PARITY commands to set the baud and parity for most cases. See the Known Restrictions section of Appendix A for exceptions. Set Screen-driver This command switches the display mode. Kermit is capable of displaying text in 40 and 80 columns, using the Batteries Included BI-80 80 column card, and also using the Commodore 128's 80 column screen. Not all of the displays are capable of completely accurate displays. For example, the standard Batteries Included 80 column character set does not include certain standard ASCII characters. In all cases the best compromise was made to provide the most accurate display (Please see the Screen Driver Comparison section for further information). The format of this command is: Kermit-65>set screen-driver [keyword] where [keyword] is 40-COLUMNS, 80-COLUMNS, BI-80, COMMODORE-128, or CUSTOM-BI-80. Set Send It is possible to set various parameters associated with the sending of data to the remote Kermit. SET SEND enables you to set the various SEND parameters. These parameters should not normally be changed since, as part of the transfer ini- tialization process, the two Kermits exchange their RECEIVE parameters. The capability of setting these parameters is provided so that the transfer initialization can be com- pleted even if the default parameters are not correct. The format of this command is: Kermit-65>set send <suboption> The suboptions of the SET SEND command are: Eight-bit-quote-char End-of-line Packet-length Pad-char Padding Quote-char Timeout The suboption descriptions for the SET SEND command are the same as those for the SET RECEIVE command (except that they affect sending, not receiving, parameters). So, to avoid Page 34 C-64/128 Kermit User's Guide redundancy, please refer to the appropriate suboption descriptions under the Set Receive section for further information. Set Terminal-emulation Kermit is capable of emulating two popular terminals, as well as act as a dummy (glass) terminal. The SET TERMINAL- EMULATION command changes the type of terminal Kermit emu- lates. The format for this command is: Kermit-65>set terminal-emulation [type] where [type] is NONE, VT-52, or VT-100. Kermit provides very accurate emulation of the DEC VT-52 and VT-100 termi- nals. In VT-100 mode, Kermit can perform most all functions of a VT-100 terminal, including displaying a graphics char- acter set as well as emulating certain VT-102 sequences. See Terminal-Type Features for more info. Set Word-size This option sets the data word length for communication with another computer. Although word lengths below seven bits exist, C-64/128 Kermit only supports seven and eight bit word lengths. The format of this command is: Kermit-65>set word-size [length] where [length] is either SEVEN-BIT or EIGHT-BIT. Show The SHOW command allows you to examine the status of many of the SET parameters. The format is: Kermit-65>show <option> <suboption>... The options available to SHOW are: All Baud Debugging Eight-bit-quoting Escape File-byte-size File-type File-warning Flow-control IBM Local-echo Parity Receive RS232-Registers Send Terminal-emulation Word-size The SHOW ALL command will display the settings for most of the parameters that may be SET. The other SHOW options and suboptions will display the current value of just that par- ticular parameter. Note: The 4 color commands and the C-64/128 Kermit User's Guide Page 35 SCREEN-DRIVER command are not currently supported. Status STATUS displays the current values of various counts associ- ated with the most recent file transfer. This includes the number of characters that have been sent and received from the remote Kermit with the amount of characters which were actual data as well as the overhead for both send and receive. Also included is the last error encountered (if any) and the disk drive error status (absent if no error). STATUS has no arguments with the format: Kermit-65>status Page 36 C-64/128 Kermit User's Guide Appendix A: Implementation Notes This appendix contains information mainly of interest to people who are familiar with Kermit-- experienced users and programmers. First time users may not find too much useful information here. Summary of Kermit Capabilities C-64/128 Kermit v2.2 Capabilities at a Glance: Local operation: Yes Remote operation: Yes Transfer text files: Yes Transfer binary files: Yes Wildcard send: No ^X/^Y interruption: Yes Filename collision avoidance: Yes Can time out: Yes 8th-bit prefixing: Yes Repeat count prefixing: No Alternate block checks: No Terminal emulation: Yes Communication settings: Yes Transmit BREAK: Yes IBM communication: Yes Transaction logging: No Session logging (raw download): No Raw upload: No Act as server: No Talk to server: Yes Advanced server commands: No Local file management: Yes Handle file attributes: No Command/init files: Yes Printer control: No Known Restrictions Kermit is a comprehensive telecommunications package. Because it is continually under development, however, some features are not fully implemented. These incomplete features therefore have some restrictions as to their use. They are: + The SET BAUD command does not support baud rates under 300 bps. To set speeds of 50, 75, 110, or 150 bps, you C-64/128 Kermit User's Guide Page 37 will have to set the RS-232 registers directly. Please see the SET RS232-REGISTERS section for more informa- tion on this procedure. + Any changes made using the SET RS232-REGISTERS command will not be reflected in the BAUD, PARITY, or WORD-SIZE parameters. + If the initialization file, KERMIT.INI, isn't on the same disk as Kermit when you boot, Kermit will crash, exiting to BASIC. You can recover from this condition by inserting a disk containing a KERMIT.INI and typing RUN. You MUST have a disk with a KERMIT.INI file on it in order to boot Kermit. + Kermit currently does not work with the Commodore 1660 modem. This modem is backwards in terms of picking up and hanging up the phone. We will fix this in a future version of Kermit. Future Plans for Kermit New features can always be added, it seems, to a program. We are currently considering implementing the following features for a future version of Kermit: + Modem support. Kermit needs to be able to work with the Commodore 1660 modem and other "oddballs". This would require a SET MODEM-TYPE command. + Long packets. Long packets allow more data to be sent per packet, speeding up file transmission considerably. + Remote server commands. With this command Kermit would be able to answer the phone automatically and send/receive files without anyone present. Kermit would function as a very simple bulletin board in a way. + New parser. The current parser is VERY large, ineffi- cient, and riddled with numerous bugs. + TAKE command. This command would allow multiple ini- tialization files. In other words, you could have an initialization file for every different configuration you use. Page 38 C-64/128 Kermit User's Guide Appendix B: Default Initialization Settings This appendix is of use mainly to experienced Kermit users. Kermit loads various default settings from disk on power-up (or when the command RESTORE is issued). Kermit reads in the settings from a file called KERMIT.INI. Below are the default settings for all of the parameters contained in KERMIT.INI. Parameter Setting Debugging Terse Terminal Emulation VT-100 IBM Mode Off Local Echo Off Baud Rate 1200 Parity None Word Size Eight Flow Control On Eight Bit Quoting On File Warning On Escape Character ^Y File Type PETSCII File Byte Size Eight Bit RS232 Registers $0000 Receive Padding Character ^@ Amount of Padding 00 Eight Bit Quoting Character & End of Line Character ^M Packet Length $5D Quote Character # Timeout Character 0A Send Padding Character ^@ Amount of Padding 00 Eight Bit Quoting Character & End of Line Character ^M Packet Length $5D Quote Character # Timeout Character 0A C-64/128 Kermit User's Guide Page 39 Appendix C: Keyboard Layouts Commodore 64 Map Kermit redefines a few keys on the Commodore 64 keyboard both to send ASCII characters that are not found in the standard Commodore character set and to send some special VT-100/52 key sequences. These redefined keys are most use- ful when communicating with a mainframe host. The following is a list of the redefined keys: If You Type This You Send This <Left Arrow> <ESC> <Up Arrow> <Hat> <Shifted "="> or <F1> <Underscore> <Shifted British Pound> or <F2> <Pipe> <Shifted "@"> or <F3> <Grave accent> <Shifted Up Arrow> or <F4> <Tilde> <Shifted "+"> or <F5> <Left Brace> <Shifted "-"> or <F6> <Right Brace> <British Pound> <Backslash> <STOP> <CTRL> - <C> <CLR> <CTRL> - <L> <HOME> <CTRL> - <H> <DEL> <DEL> <INST> <BREAK> Cursor Keys VT-100/52 Cursor Key Sequences <CTRL> - <F1> VT-100/52 PF 1 <CTRL> - <F3> VT-100/52 PF 2 <CTRL> - <F5> VT-100/52 PF 3 <CTRL> - <F7> VT-100/52 PF 4 <CTRL> - <0> through <CTRL> - <9> VT-100/52 Num. Keypad 0 through 9 <CTRL> - "-" VT-100/52 Num. Keypad "-" <CTRL> - "." VT-100/52 Num. Keypad "." <CTRL> - "," VT-100/52 Num. Keypad "," <CTRL> - "+" VT-100/52 Num. Keypad "," (dupli- cate) <CTRL> - <RETURN> VT-100/52 Num. Keypad <ENTER> Also, the <C=> key will temporarily stop character display. It acts as a toggle, and will start the display again when Page 40 C-64/128 Kermit User's Guide pressed a second time. This works only in Connect mode. Commodore 128 Map The Commodore 128 has an expanded layout that includes all of the Commodore 64 redefined keys. In other words, the Commodore 128 keyboard layout is a superset of the Commodore 64 layout. The following is a list of the special C-128 keys. If You Type This You Send This <ESC> <ESC> <HELP> <"?"> <LINEFEED> <CTRL> - <J> <TAB> <CTRL> - <I> Grey Cursor Keys VT-100/52 Cursor Key Sequences Numeric Keypad 0 through 9 VT-100/52 Num. Keypad 0 through 9 Numeric Keypad "-" VT-100/52 Num. Keypad "-" Numeric Keypad "." VT-100/52 Num. Keypad "." Numeric Keypad "+" VT-100/52 Num. Keypad "," Also, <CAPS LOCK> is functional. All lowercase letters are changed to upper case when this key is in the down position. C-64/128 Kermit User's Guide Page 41 Appendix D: UNIX (TM) Termcap Settings Kermit emulates a DEC VT-100 terminal with a complete VT-52 mode, graphics character set, and extra VT-102 editing features. On UNIX (TM), you can use most of Kermit's features by setting your terminal type to VT-100. However, to use the extra features such as the VT-102 editing sequences, a visual bell, and a sysline (25th line used for system status programs), you will need to use the following as your termcap instead: Kc|vt100|Commodore 64/128 Kermit in VT-100 mode:\ :ae=\E(1:AL=\E[%dL:al=\E[L:as=\E(0:bc=^H:bl=^G:bs:\ :cd=\E[J:ce=\E[K:cl=\E[H\E[2J:cm=\E[%i%d;%dH:co#80:\ :cr=^M:cs=\E[%i%d;%dr:DC=\E[%dP:dc=\E[P:\ :DL=\E[%dM:dl=\E[M:DO=\E[%dB:do=^J:\ :ds=\E7\E[25H\E[2K\E8:ei=\E[4l:es:fs=\E8:ho=\E[H:hs:\ :im=\E[4h:k1=\EOP:k2=\EOQ:k3=\EOR:k4=\EOS:\ :kb=\177:kd=\E[B:ke=\E>:kl=\E[D:kn=4:kr=\E[C:\ :ks=\E=:ku=\E[A:l1=PF1:l2=PF2:l3=PF3:l4=PF4:\ :LE=\E[%dD:le=^H:li#24:ll=\E[24H:mb=\E[5m:\ :md=\E[1m:me=\E[m:mi:mr=\E[7m:ms:nd=\E[C:pt:\ :rc=\E8:RI=\E[%dC:rs=\E<\Ec:sc=\E7:se=\E[m:\ :so=\E[7m:sr=\EM:ta=^I:te=\E[?7h:ti=\E[?7l:\ :ts=\E7\E[%i25;%dH\E[m\E(1\E[1K:ue=\E[m:\ :UP=\E[%dA:up=\E[A:us=\E[4m:vb=\E[?5h\E,\E[?5l:\ :vt#3:xo This custom termcap also fixes several minor bugs and omis- sions in the standard VT-100 termcap entry found in Berkeley 4.3 BSD UNIX. Note that any British Pound signs in the above termcap entry should really be backslashes. Commodore computers map the backslash onto the British Pound sign, as they don't have the backslash in their character sets. Page 42 C-64/128 Kermit User's Guide Appendix E: BI-80 Replacement ROM Information Kent Sullivan is now making available a replacement character ROM for the BI-80 card. This replacement ROM adds the ASCII characters that are missing from the Commodore character set (backslash, braces, underscore, tilde, grave accent, pipe, and hat) plus the VT-100 line graphics charac- ter set. To add these characters, some sacrifices had to be made. As you may know, the Commodore 64/128 and the BI-80 have two separate character sets: upper/lower case and upper case/graphics. The upper/lower case set remains as is in the new ROM, so most commercial programs that work on a BI- 80 are not affected (such as the Paperclip word processor from Batteries Included). The upper case/graphics character set has been changed quite a bit, so some programs may be affected (such as a BASIC program that uses extensive char- acter graphics). The new ROM is $7.50 (US funds only; WA residents please add 8.2% sales tax) and comes with complete installation instructions.