home *** CD-ROM | disk | FTP | other *** search
/ PC Online 1996 October / PCO_10.ISO / filesbbs / cfos2.arj / VCFOS2.DOC < prev    next >
Encoding:
Text File  |  1996-08-06  |  6.6 KB  |  203 lines
  1.         vcFos/2 -- OS/2 Virtual FOSSIL Driver
  2.         ----------------------------------------------------------------
  3.  
  4.  
  5.  
  6.         Hi!
  7.         ---
  8.  
  9.         This is the README for vcFos/2, the OS/2 virtual FOSSIL driver
  10.         for cFos/2.
  11.  
  12.         For more info on how to contact us etc., see README.OS2.
  13.  
  14.         For registering information see the ORDER.* files.
  15.  
  16.  
  17.  
  18.  
  19.         What is it?
  20.         -----------
  21.  
  22.         vcFos/2 is a virtual FOSSIL driver for OS/2 DOS boxes. That is,
  23.         it 'emulates' a FOSSIL driver in a DOS box. 'Emulate' means, that
  24.         vcFos/2 is no full FOSSIL driver with it's own logic etc., but it
  25.         simply is an interface and translator between FOSSIL functions and
  26.         OS/2 phyiscal device drivers (PDDs).
  27.  
  28.         vcFos/2 does only support cFos/2 COM-ports to prevent trouble
  29.         with other serial drivers (COM.SYS etc).
  30.  
  31.         vcFos/2 currently supports all FOSSIL functions including the
  32.         'Install/Deinstall application' functions 0x7e/0x7f. Some functions,
  33.         however, are not fully functional, see below 'Bugs'.
  34.  
  35.         vcFos/2 uses a 'taming' mechanism for the 'get status' FOSSIL
  36.         function. The status is 'cached' in vcFos/2 and only updated when
  37.         really needed, but at least every 50 milliseconds. This should be
  38.         ok for most applications.
  39.  
  40.         vcFos/2 uses internal receiver and transmitter buffers to speed up
  41.         the receiption and transmission of data. The size of these buffers
  42.         is currently 1kb.
  43.  
  44.         vcFos/2 allocates about 1kb in your DOS box for some of the FOSSIL
  45.         functions as well as the FOSSIL and driver signatures.
  46.  
  47.  
  48.  
  49.  
  50.         How to install:
  51.         ---------------
  52.  
  53.         Include a line in your CONFIG.SYS file like:
  54.  
  55.            DEVICE=c:\cfos\vcfos.sys <settings>
  56.  
  57.         The settings map FOSSIL ports to OS/2-COM-ports. They look
  58.         like <FOSSIL-port>=<COM-port-name>, i.e. the following example
  59.         would load vcFos/2 and map FOSSIL port 2 to COM5 and port 3
  60.         to COM6:
  61.  
  62.            DEVICE=c:\cfos\vcfos.sys 2=COM5 3=COM6
  63.  
  64.         The other COM-ports will not be supported by vcFos/2. vcFos/2
  65.         will give control to the next driver in the INT 14 chain. Use
  66.         vcFos/2 only on cFos/2 ports for now. This may be enhanced in
  67.         a future version.
  68.  
  69.         Note: FOSSIL ports start at 0, COM ports start at 1. So, many
  70.            DOS software that uses FOSSIL lets you set the COM-port as
  71.            COMx. The above example will create COM-ports in the
  72.            DOS-boxes named COM3 (FOSSIL port 2) and COM3 (port 3).
  73.  
  74.         If you do not specify any settings, vcFos/2 will load with
  75.         the FOSSIL ports 0-7 mapped to the OS/2-COM-ports COM1..COM8,
  76.         but will only support those ports cFos/2 is loaded for.
  77.  
  78.         You may specify up to 8 port mappings.
  79.  
  80.         When vcFos/2 is loaded it checks for cFos/2 of at least version
  81.         0.81. If none found, vcFos/2 will beep and not load.
  82.  
  83.         vcFos/2 MUST be loaded in CONFIG.SYS; it can NOT be loaded at
  84.         the DEVICE entry of a DOS-Box.
  85.  
  86.  
  87.  
  88.  
  89.         How does this mapping work?
  90.         ---------------------------
  91.  
  92.         vcFos/2 provides up to 8 FOSSIL ports in a DOS-Box. Those FOSSIL
  93.         ports have numbers, starting at 0.  You may specify a "mapping"
  94.         for each FOSSIL port to an cFos/2 COM-port, i.e. you specify
  95.         which cFos/2 port is accessed, when a certain FOSSIL port is
  96.         accessed.
  97.  
  98.         Regard the following example:
  99.  
  100.            DEVICE=CFOS.SYS COM5
  101.            DEVICE=VCFOS.SYS 7=COM5
  102.  
  103.         When you open a DOS-box, you may now access the FOSSIL port 7
  104.         (which, because of the naming convertions mentioned in the
  105.         above paragraph is often named COM8) _from_inside_the_dos_box_!
  106.  
  107.         The vcFos/2 COM-port namings inside a DOS-box have nothing
  108.         to do with those names of the OS/2 (or cFos/2) ports! As you
  109.         see, the DOS-box-COM-port COM8 is "routed" to the OS/2 COM-port
  110.         COM5 by vcFos/2.
  111.  
  112.         Be sure that you specify the right FOSSIL ports in your
  113.         DOS-software. If some mailer were to be installed under the
  114.         above example, you would have to set the COM-port to 8, or COM8.
  115.  
  116.         Note that vcFos/2 will only map ports made available by cFos/2.
  117.  
  118.  
  119.  
  120.  
  121.         How to run DOS applications from OS/2 applications:
  122.         ---------------------------------------------------
  123.  
  124.         vcFos/2 will issue a 'device open' call to cFos/2 if the user
  125.         does an FOSSIL 'open' function. This 'device open' is done with
  126.         sharing and SHARE_DENYNONE mode and may fail if the port was
  127.         initially opened in any other mode.
  128.  
  129.         I tested vcFos/2 with XENIA 1.98 (OS/2) and it did not work.
  130.         This may be, because XENIA up to 1.98.03 opens the COM ports
  131.         in SHARE_DENYALL mode and the subsequent open request of vcFos/2
  132.         fails. Registered XENIA users should use 1.98.04, which works ok.
  133.  
  134.         So far I did not test any other OS/2 applications with vcFos/2,
  135.         so just experiment yourself and mail me the results.
  136.  
  137.  
  138.  
  139.  
  140.         Case studies:
  141.         -------------
  142.  
  143.         I successfully tested vcFos/2 with:
  144.  
  145.         FrontDoor 2.20, Telix 3.50 (FOSSIL support), Terminate 3.00,
  146.         BinkleyTerm 2.50ee
  147.  
  148.  
  149.  
  150.  
  151.         Known Bugs
  152.         ----------
  153.  
  154.         -- Does not support Ctrl-C/Ctrl-K check so far.
  155.  
  156.  
  157.  
  158.  
  159.         Debugging
  160.         ---------
  161.  
  162.         vcFos/2 creates a small logfile named C:\VCTRACE. This file will
  163.         contain some info on the loading process and other. You may
  164.         dump FOSSIL tracing info to this file as well, see CFU.DOC.
  165.  
  166.         This type of debugging is crude, but may help in some cases.
  167.  
  168.         As a matter of fact, it is not possible to display data while
  169.         a VDD is loaded, so all status and error messages of the
  170.         loading process are written to C:\VCTRACE. Have a look at this
  171.         file if something works weird.
  172.  
  173.  
  174.  
  175.  
  176.         Differences to cFos/DOS
  177.         -----------------------
  178.  
  179.         -- No statusline
  180.         -- No ISDN appendage
  181.         -- Only parts of the INT 14 support (e.g. no baudrate-change hangup
  182.            feature and only the 4 FOSSIL status bits)
  183.  
  184.  
  185.  
  186.  
  187.         More restrictions
  188.         -----------------
  189.  
  190.         -- No special cFos/2 support. In the future vcFos/2 will recognize
  191.            cFos/2 and support it. This will speed up some things.
  192.  
  193.  
  194.  
  195.  
  196.         Plans for the future / EOF
  197.         --------------------------
  198.  
  199.         Fix the above listed bugs, differences and restrictions.
  200.  
  201.  
  202.         Thanx for using a member of the cFos family.
  203.