home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / GENUTIL / DIGFOS20.ZIP / DIGFOS.DOC < prev    next >
Text File  |  1994-07-04  |  13KB  |  397 lines
  1.  
  2.                        DIGIFOSSIL V2.0 - July 4, 1994
  3.  
  4.                         FOSSIL Driver for DigiBoards
  5.                         & DIGIBOARD Driver for FOSSIL
  6.                         =============================
  7.  
  8.                                        Technique Computer Systems
  9.                                        814 Lampson Street
  10.                                        Victoria, BC   V9A 6B2
  11.                                        CANADA
  12.                                        BBS: (604) 361-1541
  13.                                        FAX: (604) 361-4789
  14.  
  15.  
  16.   What is DIGIFOSSIL?
  17.   -------------------
  18.   DIGIFOSSIL is the program (DFTSR) you need  in order to get a huge number
  19.   of applications written for  FOSSIL systems working on  your BBS, if your
  20.   BBS uses  an intelligent  Digiboard (such as  the PC/Xe,  PC/Xi or COM/Xi
  21.   series).  (if you need a FOSSIL for a nonDigiboard system, try either X00
  22.   or BNU, which are available from many BBSs).
  23.  
  24.   DIGIFOSSIL also  includes a program  (FDTSR) to run  your Digiboard based
  25.   BBS on a non-digiboard (FOSSIL) setup.   This allows you to use a product
  26.   such as Wildcat! IM (where they haven't implemented FOSSIL support).
  27.  
  28.  
  29.   What is a FOSSIL anyway?
  30.   ------------------------
  31.   Other than the acheological definition, FOSSIL (Fido/Opus/Seadog Standard
  32.   Interface  layer)  was  created  to  provide  a  standard  communications
  33.   interface  during  the  evolution  of  some  other  BBS  software (namely
  34.   Fido(tm),  Opus  and Seadog(tm)).  It  provided a superset  of the serial
  35.   port BIOS calls available on the early IBM PC, and provided a way to port
  36.   programs from  one system  to another that  may not  contain IBM hardware
  37.   hardware compatible serial ports.
  38.  
  39.   By  writing  programs that  use  a standard  set  of calls,  all  that is
  40.   required  to move  the  system to  dissimilar  hardware is  a  new FOSSIL
  41.   driver.
  42.  
  43.   The list  of applications  that support  FOSSIL include  many BBS systems
  44.   themselves, such  as PCBoard/M, QuickBBS  and also  includes many popular
  45.   doors such as Tradewars & Scrabble(tm).
  46.  
  47.  
  48.   What does DIGIFOSSIL do?
  49.   ------------------------
  50.   It  provides  the  translation  services so  that  calls  made  to FOSSIL
  51.   standards are  translated into  equivalent Digiboard  driver calls.  This
  52.   allows  HUNDREDS  of  applications  written  for  FOSSIL  to  run  on  an
  53.   Intelligent Digiboard, as if  they were running on  a FOSSIL based system
  54.   using  normal  serial  ports.   Of  course  by  using  the  the  buffered
  55.   intelligent  Digiboard,   you  can  drastically   improve  your  system's
  56.  
  57.  
  58.                                     - 1 -
  59.  
  60.         DigiFossil (c) Copyright 1992-1994 Technique Computer Systems
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.   performance over using regular serial ports.
  69.  
  70.   FOSSILDIGI  also  provides  the REVERSE  translation  faclities  to allow
  71.   digiboard based products to run on FOSSIL drivers.
  72.  
  73.  
  74.   Running FOSSIL on DIGIBOARD Hardware
  75.   ------------------------------------
  76.   As part of your AUTOEXEC.BAT, add a line that says:
  77.  
  78.      DFTSR
  79.  
  80.   When DFTSR  starts, it  will identify  itself, and  indicate the  type of
  81.   Digiboard installed.  DFTSR currently takes  about 15k of memory, and can
  82.   be  loaded  into  'HIGHRAM'  using QEMM's  LOADHI,  or  DOS  5's LOADHIGH
  83.   commands.  DFTSR  must be loaded  AFTER the DigiBoard  (XIDOS5) driver is
  84.   loaded, and if you are multitasking using Desqview, DFTSR handles support
  85.   for ALL channels  and should be  loaded before Desqview.   DFTSR does not
  86.   enable FOSSIL support, that is done separately with DF.
  87.  
  88.   Note that  the ONLY supported  multitasked is Desqview,  OS/2 and Windows
  89.   MAY work, but are totally unsupported.
  90.  
  91.  
  92.   Using Applications that require FOSSIL Drivers
  93.   ----------------------------------------------
  94.   To enable and disable FOSSIL support, use the DF program.  The format is:
  95.    DF <command> <portnumber>
  96.  
  97.   The <command> can be any of the following:
  98.     FOSSIL      - turn on FOSSIL support
  99.     DIGI        - turn off FOSSIL support (return to native DIGI)
  100.     FOSSIL-LOCK - turn on FOSSIL support, but prevent baud rate and
  101.                   flow control changes.
  102.     STAT        - display information about DIGIFOSSIL
  103.  
  104.   <portnumber> is the port  on which you want to  enable support.  If it is
  105.   not  specified,  it  will  use  the  value  of  the  environment variable
  106.   WCPORTID.
  107.  
  108.   examples:
  109.      DF FOSSIL 1          - turn on FOSSIL support for port 1
  110.      DF DIGI              - turn off support for port WCPORTID
  111.      DF FOSSIL-LOCK 1     - turn on FOSSIL support for port 1
  112.                             but don't allow the door to change
  113.                             the baud rate.
  114.  
  115.   Although DIGIFOSSIL may not  run all applications, it  should run most of
  116.   those that  require or  support FOSSILs.  If  a program  does not mention
  117.   that it will utilize a FOSSIL, it probably doesn't use it, and won't work
  118.   with DIGIFOSSIL.
  119.  
  120.   When  running  an application  that  uses  FOSSIL calls,  simply  use the
  121.   program DF to enable  or disable FOSSIL support  in the DIGIFOSSIL driver
  122.  
  123.  
  124.                                     - 2 -
  125.  
  126.         DigiFossil (c) Copyright 1992-1994 Technique Computer Systems
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.   (DFTSR which was loaded in your AUTOEXEC.BAT).  To run DF, simply specify
  135.   which Digiboard channel, and whether to enable or disable support.  If no
  136.   port number is given,  DF will use the  port specified by the environment
  137.   variable WCPORTID.
  138.  
  139.   ** NOTE **
  140.   **    Be sure that if you enable FOSSIL support for
  141.   **    for a particular door or application, remember to disable
  142.   **    again when that door exits
  143.   ** NOTE **
  144.  
  145.   When using  doors that  support FOSSIL, COM1  (w/FOSSIL), is  the same as
  146.   Digiboard channel 0.  With Wildcat!, WCPORTID=1 is equivilent to COM1 (or
  147.   Digiboard channel 0).
  148.  
  149.   If you have a door that does NOT  support a locked DTE rate (that is when
  150.   the baud  rate to  the modem  is higher  than the  actual link connection
  151.   speed), AND  you are  using a  modem that  has a  locked DTE,  you should
  152.   enable the  FOSSIL with  the DF  FOSSIL-LOCK command  rather than  the DF
  153.   FOSSIL command.  This will prevent the application from changing the baud
  154.   rate or flow control.
  155.  
  156.   ** NOTE! **
  157.       Programmers  writing code  that  makes FOSSIL  calls should
  158.       note COM1, refers  to channel 0 (DX=0)  with respect to the
  159.       actual FOSSIL and DigiBoard drivers.
  160.  
  161.  
  162.   Examples
  163.   --------
  164.   This is an  example DOOR.BAT for  Wildcat IM (on  a Digiboard system), to
  165.   run Chris Hall's excellent Scrabble door.
  166.  
  167.   DOOR1.BAT
  168.      @ECHO OFF
  169.      REM This batch file is located in your HOME directory,
  170.      REM and is copied to the work directory and executed.
  171.      REM It needs to change to the right location of the
  172.      REM door and run the program
  173.      REM
  174.      REM  ******* Enable Fossil
  175.      DF FOSSIL
  176.      CD \DOORS\scrab
  177.      scrabdor node%WCNODEID%.cfg
  178.      CD \WC30
  179.      REM  ******* Remember to turn it off again
  180.      DF DIGI
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.                                     - 3 -
  191.  
  192.         DigiFossil (c) Copyright 1992-1994 Technique Computer Systems
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.   DIGI to FOSSIL translation (FDTSR)
  201.   ----------------------------------
  202.  
  203.   Back in February it was necessary to write another similar (but opposite)
  204.   program to  translate Digiboard  calls into  FOSSIL to  allow Wildcat! IM
  205.   (which still didn't support FOSSIL) to run on a FOSSIL based system.  The
  206.   basic  setup   is  similar  to   DFTSR,  just  load   FDTSR.EXE  in  your
  207.   AUTOEXEC.BAT, and  before running  a FOSSIL  based product  make sure you
  208.   issue a  DF FOSSIL  commad and before  running a  Digiboard based product
  209.   (such as Wildcat), issue a DF DIGI command.
  210.  
  211.  
  212.   Known Gotchas!
  213.   --------------
  214.   DIGIFOSSIL will not  restore port parameters  when you turn  it off so if
  215.   you run an application  that sets a particular  feature on the port (such
  216.   as XON/XOFF), when DIGIFOSSIL is  disabled, XON/XOFF stays enabled.  This
  217.   has  caused  some  problems  with  BBS  systems.   Enabling  DF  with the
  218.   FOSSIL-LOCK  command  rather  than the  ON  command  prevents  DOORs from
  219.   changing both the speed  and flow options, and  may help.  Also, programs
  220.   written for Digiboards  directly (such as QmodemPRO)  may also change the
  221.   port parameters and not restore them.
  222.  
  223.  
  224.   Files
  225.   -----
  226.   The following files should be included in this archive, and for
  227.   authenticity, it should  contain the PKZIP  authenticity verification for
  228.   TECHNIQUE COMPUTER SYSTEMS.
  229.  
  230.       DF.EXE         - to enable and disable DIGIFOSSIL support
  231.       DFTSR.EXE      - the DIGIFOSSIL driver
  232.       FDTSR.EXE      - the FOSSILDIGI driver
  233.       DF.DOC         - this document file
  234.  
  235.  
  236.   Registration & Ordering (NOT!)
  237.   ------------------------------
  238.   DIGIFOSSIL is FREE.   It is distributed  in a fully  functional form.  If
  239.   you feel that  you must send money  to the author, the  address is at the
  240.   top  of  this  document,  and   moneys  received  will  be  considered  a
  241.   subscription to the Plywood PC BBS (at $10 for six months).
  242.  
  243.  
  244.   Support
  245.   -------
  246.   For further information, or technical  support of DIGIFOSSIL, please call
  247.   the Plywood  PC BBS  at 604-361-1541(V32bis/HST),  and join  conference 2
  248.   (DIGIFOSSIL  support),  fax  me  at   the  above  address,  or  email  to
  249.   SCOTT@plywoodbbs.victoria.bc.ca.
  250.  
  251.   Due to the fact  that DIGIFOSSIL is free, I  cannot (and will not) return
  252.   (non-collect) long distance telepone calls.
  253.  
  254.  
  255.  
  256.                                     - 4 -
  257.  
  258.         DigiFossil (c) Copyright 1992-1994 Technique Computer Systems
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.   Trouble Shooting
  267.   ----------------
  268.   IF you have  troubles during operation  of the DIGIFOSSIL,  please make a
  269.   note of the conditions under which it happened, and if you are able, open
  270.   another DOS window in Desqview, and type
  271.  
  272.         DF STAT <port-number>
  273.  
  274.   where <port-number> is  the port that has  failed.  This information that
  275.   this  provides  will be  most  helpful  in trying  to  diagnose  what has
  276.   happened.
  277.  
  278.  
  279.   Credits
  280.   -------
  281.   I have a  few people to  thank.  Firstly, I  would like to  thank my boss
  282.   (Ken), for  his patiene  of letting me  crash our  BBS at  work MANY MANY
  283.   times in  the development of  DIGIFOSSIL, and  to a one  of my co-workers
  284.   (Ron) for saying  "but we can't  run Scrabble now  we've gone to Wildcat!
  285.   IM",   and  to  various  sysops  who  have  assisted  in  the  testing of
  286.   DIGIFOSSIL.
  287.  
  288.  
  289.   History
  290.   -------
  291.   Version 2.0 - July 4/94
  292.       - Add new FDTSR program to allow DIGI applicatiosn to run on
  293.         FOSSIL systems
  294.       - various implementation fixes within translation routines
  295.  
  296.   Version 1.3 - May 6/93
  297.       - Fixed  initial  recognition  routines,   it  should  now  find  ALL
  298.         digiboards, and correctly identify them.
  299.       - Changed the flow control parameters  a bit, and also prevented flow
  300.         control from being changed if the port was opened with LOCK.
  301.       - Changed DOCs to reflect new BBS phone #
  302.       - Improved the  menthod in  which DIGIFOSSIL  identifies itself.  All
  303.         software should now detect the FOSSIL is installed
  304.  
  305.   Version 1.2 - Jan 20/1993
  306.       - Various internal optimizations
  307.       - Fixed some problems with software detecting DF being installed
  308.       - DFTSR now loads on system where the first channel isn't channel 0
  309.  
  310.   Version 1.1 - Jan 11/1993
  311.       - Added support for forcing Locked DTEs.
  312.       - Added beg screen to unregistered version.  (lack of user support)
  313.       - Fixed typos in the orderform.
  314.       - Added better support for detecting errors during installation.
  315.  
  316.   Version 1.0 - Dec 25/1992
  317.       - Initial Release
  318.  
  319.  
  320.  
  321.  
  322.                                     - 5 -
  323.  
  324.         DigiFossil (c) Copyright 1992-1994 Technique Computer Systems
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.   Legal Stuff
  333.   -----------
  334.   DIGIFOSSIL is Copyright 1992-1993, Technique Computer Systems, all rights
  335.   reserved.  This product is provided "AS-IS" without warranty of any kind.
  336.   All  risk as  to the  results and  performance are  assumed by  the user.
  337.   Technique Computer Systems will not be  liable for any damages, direct or
  338.   indirect, resulting from the use, or inability to use, this product.
  339.  
  340.   Wildcat! isn't actually a trademark of Mustang Software Inc
  341.   DigiBoard is a trademark of DigiBoard Corporation
  342.   Fossil (Fido(tm)/Opus/Seadog(tm) interface layer), is the
  343.                 combined product and ideas of Tom Jennings, Thom
  344.                 Henderson, Vince Perriello, & Wynn Wagner (& many
  345.                 more).
  346.   Fido is a trade mark of Tom Jennings
  347.   Seadog is a trade mark of Thom Henderson and/or System
  348.                 Enhancements Associates.
  349.   QEMM and Desqview are trade marks of Quarterdeck Office Systems.
  350.   Scrabble is a trade mark of Hasbro Inc.
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.                                     - 6 -
  389.  
  390.         DigiFossil (c) Copyright 1992-1994 Technique Computer Systems
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.