home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 June / SIMTEL_0692.cdr / msdos / fossil / odec_501.arc / DECCOMM.DOC < prev    next >
Encoding:
Text File  |  1988-08-22  |  6.4 KB  |  165 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                                     DECcomm
  7.  
  8.  
  9.                 A DEC Rainbow implementation of a FOSSIL driver
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                                 USER'S  MANUAL
  17.  
  18.                                  Version 5.01
  19.  
  20.                 August 22, 1988
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.                                 IMPORTANT NOTICE
  30.  
  31.      --------------------------------------------------------------------
  32.  
  33.      DecComm Asynchronous Communications Driver Revision 5.01
  34.      Copyright (C) 1988 by VEP Software, ALL RIGHTS RESERVED
  35.  
  36.      You are  free  to use and distribute this software in its unmodified
  37.      form for ANY  NONCOMMERCIAL  USE  WHATSOEVER.   Modified versions of
  38.      this software are NOT  to be distributed without the express written
  39.      consent of the author.   You  are  not  allowed to sell or otherwise
  40.      make money from the use of  this  software  without specific license
  41.      from the author.  You are invited  to  offer  contract  work  to the
  42.      author, who can be reached at:
  43.  
  44.             Vincent E. Perriello
  45.             VEP Software
  46.             111 Carroll Street
  47.             Naugatuck, CT 06770
  48.  
  49.  
  50.      or via Fidonet mail to Network 141 Node 491. Information or comments 
  51.      about the functioning of this driver are most welcome.
  52.  
  53. DECcomm - a Rainbow implementation of a FOSSIL driver              Page 1
  54.  
  55.  
  56. This   document  describes  the  function  and  usage  of  the    DECcomm
  57. comm/keyboard/ TSR driver for the DEC Rainbow.  It is  intended  for  use
  58. with Opus,  SEAdog,  BinkleyTerm  or  other  communications packages.  It
  59. implements all the  machine-specific  code that either Opus or the SEAdog
  60. mailer needs.  It's  a  FOSSIL driver.  That stands for "Fido-Opus-SEAdog
  61. Standard Interface Layer".  Please feel free to contact me if you want to
  62. know more about how to write  a  FOSSIL driver, or code that makes use of
  63. FOSSIL services.
  64.  
  65. Starting  with  Version  3.0,  DECcomm's  version  numbering  method  has
  66. changed.  Now the "Major Version" (the number  to the left of the decimal
  67. point)  will  always  refer  to  the  Revision  Level  of    the   FOSSIL
  68. specification  that  is  supported  by  that version of DECcomm, and  the
  69. "Minor  Version"  will  refer  to rev level of DECcomm within that  spec.
  70. Version  5.0  is the first version of DECcomm to claim full adherence  to
  71. the Revision 5 FOSSIL specification.
  72.  
  73. You should run DECcomm just once before starting up Opus, SEAdog or other
  74. FOSSIL communications package.  It's OK to do so more than once, however.
  75. DECcomm is capable of determining whether  or  not  a  copy  of itself is
  76. already in memory and will not clutter  up your system with "billions and
  77. billions" of copies.  When you run DECcomm,  it  should  come  up  with a
  78. title  screen,  tell  you  either  that  it  is loaded  or  that  it  was
  79. unnecessary  to  do  so (one was already there), and exit  back  to  DOS.
  80. DECcomm  should  normally  be  invoked  without  a command line argument.
  81. However, should  you  wish  to run DECcomm at a fixed baud rate of 19,200
  82. with CTS/RTS (this works well for USR HST's and Telebit TrailBlazers) you
  83. should invoke DECcomm with  an  argument.    Any argument.  I invoke mine
  84. with "DECcomm HST".
  85.  
  86. DECcomm in  its  present  form implements an extended form of the IBM INT
  87. 14H communications calls.   These extensions have been done carefully, in
  88. such a way as  to preserve compatibility with Tom Jennings' Generic Fido.
  89. It has been tested with  FIDO_GEN and works fine with it (though timeouts
  90. can occur on 300 baud downloads  due  to  the output buffering).  It also
  91. seems to work on Rainbow 100A's (don't  go  trying  it with FIDO_GEN 11w,
  92. though.  The problem with Fido 11w on  100A's is too nasty to be fixed by
  93. software alone).
  94.  
  95.  
  96. DECcomm - the Rainbow implementation of a FOSSIL driver            Page 2
  97. DECcomm 5.01 User's Guide
  98.  
  99.  
  100. The  extensions  to  the  "basic" FIDO_GEN spec implement fully  buffered
  101. input  and  output  with large buffers, for use in high-performance  file
  102. transfer  operations (ZMODEM and SEAlink, for example) and to make a  BBS
  103. look  much  faster than it actually is by hiding disk I/O behind  output.
  104. Some  basic  screen  primitives  (get and set cursor location and write a
  105. character to  screen)  are  also  included.  Finally, there is a keyboard
  106. routine that includes  much of the IBM PC keyboard scan codes, for use by
  107. Opus and other packages, such as BinkleyTerm and the SEAdog mailer. 
  108.  
  109.  
  110. The key code mapping supported is:
  111.  
  112. 1. (CTRL+SHIFT+any alpha or number key) maps to the same codes as 
  113.    (ALT+key) on IBM, e.g. CTRL-SHIFT-A = ALT A, etc.
  114.  
  115. 2. Function keys:
  116.  
  117.     (DEC)        (IBM)        (DEC)        (IBM)
  118.  
  119.     Interrupt  =      F1        AddtnlOptions =   F6
  120.     Remove       =      F2        F17          =   F7
  121.      Cancel       =      F3        F18          =   F8
  122.     MainScreen =      F4        F19          =   F9
  123.     Exit       =      F5        F20          =  F10
  124.  
  125.     Both the CTRL+function key and ALT (CTRL+SHIFT) + function key map
  126.     the same as on IBM.
  127.  
  128.     Find       =      Home        Remove          = Delete
  129.      Select     =      End         PrevScreen    = PageDown
  130.     InsertHere =      Insert        NextScreen    = PageUp
  131.  
  132.     Also, arrow keys map the same as IBM.
  133.  
  134.  
  135. DECcomm - the Rainbow implementation of a FOSSIL driver            Page 3
  136. DECcomm 5.01 User's Guide
  137.  
  138.  
  139.     The numeric keypad is mapped to work with any terminal package 
  140.     that maps the VT100 keypad like BinkleyTerm or ProComm. This is
  141.     what it looks like:
  142.  
  143.  
  144.                 +--------+--------+--------+--------+
  145.                 |        |        | Shift- | Shift- |
  146.                 |   F1   |   F2   |   F1   |   F2   |
  147.                 |        |        |        |        |
  148.                 +--------+--------+--------+--------+
  149.                 |        |        | Shift- | Shift- |
  150.                 |   F3   |   F4   |   F3   |   F4   |
  151.                 |        |        |        |        |
  152.                 +--------+--------+--------+--------+
  153.                 |        |        | Shift- | Shift- |
  154.                 |   F5   |   F6   |   F5   |   F6   |
  155.                 |        |        |        |        |
  156.                 +--------+--------+--------+--------+
  157.                 |        |        | Shift- |        |
  158.                 |   F7   |   F8   |   F7   |        |
  159.                 |        |        |        | Shift- |
  160.                 +--------+--------+--------+  F10   |
  161.                 |                 | Shift- |        |
  162.                 |       F10       |   F9   |        |
  163.                 |                 |        |        |
  164.                 +-----------------+--------+--------+
  165.