home *** CD-ROM | disk | FTP | other *** search
/ Stars of Shareware: DFÜ und Kommunikation / SOS-DFUE.ISO / programm / dos / terminal / cvt220 / user.doc < prev   
Encoding:
Text File  |  1990-03-16  |  10.1 KB  |  220 lines
  1.                 CVT100, A Simple VT100 Emulator in Turbo C 2.0
  2.                        By Jerry Joplin CIS [70441,2627]
  3.               VT220 Modifications by Bob Bonomo CIS [76314,2200]
  4.  
  5.  
  6.          OPERATION
  7.  
  8.          The terminal emulator is menu driven.  The top line of the
  9.          terminal screen is reserved as a status line.  When the ALT key
  10.          is pressed, a list of choices is displayed on the status line
  11.          for setting the various parameters concerning the different
  12.          aspects of the programs operation.
  13.  
  14.          ALT  Function Key F1:  This activates the DOS shell.
  15.  
  16.          ALT  Function Key F4:  This activates the Transfer menu setup.
  17.                                 It can be set up to initiate the host
  18.                                 and/or the PC XMODEM protocol transfer.
  19.  
  20.          ALT  Function Key F5:  This activates the Communications menu
  21.                                 setup. Here the COM port is
  22.                                 established along with its associated
  23.                                 baud rate, parity, data bits
  24.                                 and stop bits.
  25.  
  26.          ALT  Function Key F6:  This key will activate the Video setup
  27.                                 menu.  Here the screen colors can be
  28.                                 set and the "snow" inhibit mode can be
  29.                                 set.
  30.  
  31.          ALT  Function Key F7:  This key when pressed enters the
  32.                                 keyboard setup menu.  Here the
  33.                                 program's interpretation of the
  34.                                 backspace key can be set.  The
  35.                                 keyboard can be programmed to produce a
  36.                                 'key-click' and the state of the
  37.                                 keypad can be defined.
  38.  
  39.           ALT Function Key F8:  An Emulation menu becomes active when
  40.                                 ALT F8 is pressed.  Here the many mode
  41.                                 settings for the emulator may be set.
  42.                                 These include origin mode,
  43.                                 insert/replace mode, auto wrap mode,
  44.                                 new line mode, cursor visibility,
  45.                                 background video attributes and the
  46.                                 logical screen width.
  47.  
  48.           ALT Function Key F9:  Function key ALT F9 brings up a File
  49.                                 menu.  The current settings for the
  50.                                 terminal can be saved in an setup file
  51.                                 that is read when the program is
  52.                                 started.  Also a log of incoming
  53.                                 characters can be controlled.
  54.  
  55.           ALT Function Key F10: This is used as the exit key.  When
  56.                                 pressed this will close any open log
  57.                                 files and exit.
  58.  
  59.          KEYBOARD keypad
  60.  
  61.          The most controversial part of any terminal emulator will
  62.          usually be the setup of the IBM PC keyboard to try and match
  63.          the Digital Equipment Corporation VT keypad.  Not an easy task.
  64.          This program tries to map as closely as possible the keypad for
  65.          an IBM PC to a DEC VT keypad.  The results are often better if
  66.          NUM LOCK is left on through out the entire session.
  67.  
  68.          If the keyboard is a PC, it does these keypad mappings:
  69.              keypad DASH (-) to comma (,)
  70.              keypad PLUS (+) to enter
  71.              keypad STAR (*) to minus (-)
  72.  
  73.          If the keyboard is the AT style it does these mappings:
  74.              keypad STAR  (*) to star  (*)
  75.              keypad MINUS (-) to minus (-)
  76.              keypad PLUS  (+) to comma (,)
  77.              keypad ENTER     to keypad enter
  78.  
  79.  
  80.  
  81.          PROTOCOL TRANSFER
  82.  
  83.          For automatic mode, press ALT F4, then using the different
  84.          function keys fill in the PC filename and host file name.
  85.          Select Upload or Download using the appropriate function key,
  86.          fill in the host command and parameters, and hit ENTER.  These
  87.          host commands can be saved to the setup file using the ALT F9
  88.          setup screen.  This automatic mode might not work with all
  89.          systems.  I tested it using SCO-XENIX (tm) and the XMODEM
  90.          program supplied.
  91.  
  92.          If using a multi-port card such as Computone InteliPort it will
  93.          be necessary to put the port in raw mode first and then reset
  94.          it after the transfer.  File XFER is such a script file.
  95.          Replace XMODEM below with XFER.  WARNING:  The program presumes
  96.          you know what you are doing.
  97.  
  98.          HOST Command:  XMODEM { -r | -s }  [-t]  filename
  99.                                -r for receive
  100.                                -s for send
  101.                                -t for text files
  102.  
  103.  
  104.          In manual mode you setup the host by issuing the appropriate
  105.          command for Upload or Download, then press ALT F4, fill in the
  106.          PC filename, press the function key for either upload or
  107.          download and hit ENTER.  The data field for upload or download
  108.          MUST be left blank. A non blank field indicates automatic mode.
  109.  
  110.               HOST Command:  XMODEM
  111.  
  112.  
  113.  
  114.          DATA ENTRY
  115.  
  116.          While entering data on the protocol transfer screen, the active
  117.          keys are ESC, HOME, END, RIGHT arrow, LEFT arrow, BACKSPACE,
  118.          DEL, INS, ENTER, and CTRL-END.  They perform their instinctive
  119.          functions.  CTRL-END deletes from the cursor position to end of
  120.          line.
  121.  
  122.  
  123.          EMULATION
  124.  
  125.          This program can best be described as a compromise between the
  126.          desire to make the code as simple and straight forward as
  127.          possible and the complexities and intricacies of a real life
  128.          DEC VT100.  So many things were left out of the terminal
  129.          emulation.
  130.  
  131.          Of the things left out of the emulation most notable will be
  132.          printer output commands and double high/width character lines.
  133.          Local echo is also absent.
  134.  
  135.          The emulator can not change the video from 80 to 132 columns
  136.          and vice-versa when these commands are received from the host.
  137.          The commands are received and recognized but it only changes
  138.          the logical width of the screen held by the emulation software.
  139.          It seems as if every video board manufacturer that has a board
  140.          capable of switching to 132 column mode has a different method
  141.          of changing into this mode.  However this mode can be utilized
  142.          by setting the screen to 132 columns *before* executing the
  143.          program.  Then the video system of the emulator will properly
  144.          use all of the columns.
  145.  
  146.          The BREAK key is CTRL-END.
  147.  
  148.          The only part that was added to the VT220 emulation is different
  149.          keys like HOME, INS, PGUP, ShiftF1-F10, etc.
  150.  
  151.  
  152.          FILE SYSTEM
  153.  
  154.          The setup information can be saved to a disk file when a
  155.          satisfactory setting has been reached.  When the program is
  156.          executed it looks in the current directory for a file named
  157.          'CVT220.SET' from which to load the setup parameters.  If this
  158.          file is not found it then looks in the directory where CVT220
  159.          was loaded from.  Default values are provided if this file is
  160.          not found.
  161.  
  162.          Incoming characters can be logged to disk.  When logging is
  163.          selected, all incoming characters are saved in a disk file
  164.          named 'CVT220.LOG'.  If a file by that name exists at the time
  165.          when logging is selected then output is appended to this file
  166.          otherwise a file will be created in the current directory.
  167.          Note that *NO interpretation* is performed on the characters
  168.          placed in the disk file. 
  169.  
  170.  
  171.          PROGRAM TERMINATION
  172.  
  173.          Any time the program is exited the communications port will be
  174.          closed to prevent incoming characters generating interrupts to
  175.          ISR's which don't exist in memory any longer.  Additionally the
  176.          log file will be closed if it is open on program exit.
  177.  
  178.          There are several errors which may cause the emulator to force
  179.          itself to exit.  If memory can not be allocated from the DOS
  180.          heap for the screen save buffer then the program will be
  181.          terminated with an error message.  Also the file IO functions
  182.          may terminate the program if a system error has occurred on a
  183.          read or write of a disk file.  This could be caused by a disk
  184.          full error or fault media.  *CAREFUL* because the program does
  185.          not currently trap the fatal error interrupt and disk errors
  186.          will produce the not-too-kind error message:
  187.  
  188.                   Not ready error writing drive A:
  189.                   Abort, Retry, Ignore?
  190.  
  191.          Choosing Abort will cause the terminal to exit without having
  192.          turned off communications interrupts.  This will cause a quick
  193.          system lockup if a character is received by the COM port.
  194.  
  195.  
  196.  
  197.          ACKNOWLEDGMENTS
  198.  
  199.          The VT100 emulation is based heavily on two versions of Kermit.
  200.          The most notable version of Kermit was MSKermit version 2.30
  201.          written in Microsoft Macro Assembler 3.0.  CKermit for Unix was
  202.          also used for program design and nomenclature.  Therefore this
  203.          Copyright appears as required.
  204.  
  205.                             Copyright (c) 1981, 1988
  206.             Trustees of Columbia University in the City of New York
  207.  
  208.             Permission is granted to any individual or institution
  209.             to use, copy, or redistribute this program and
  210.             documentation as long as it is not sold for profit and
  211.             as long as the Columbia copyright notice is retained.
  212.  
  213.  
  214.          Most of the code for XMODEM was taken from Al Stevens' Smallcom
  215.          project in Dr.  Dobbs Journal and was adapted to CVT220.  The
  216.          data entry part is also from DDJ.  The Unix XMODEM program was
  217.          written by Jim Demchuk and modified for batch mode by Bob
  218.          Bonomo.
  219.  
  220.