home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR24 / SIO115.ZIP / SIOUSER.TXT < prev    next >
Text File  |  1993-09-30  |  47KB  |  1,098 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.                                      USERS MANUAL
  27.  
  28.               SIO.SYS and VSIO.SYS, Serial Communications Device Driver
  29.                for OS/2 V2 (and up) and its Virtual DOS Machines (VDM).
  30.  
  31.                         Copyright (c) 1993 by Raymond L. Gwinn
  32.                                  12469 Cavalier Drive
  33.                               Woodbridge, Virginia 22192
  34.                                  All Rights Reserved
  35.  
  36.                                   September 30, 1993
  37.  
  38.                                         Email
  39.                                  CompuServe 71154,575
  40.                              Internet p00321@psilink.com
  41.  
  42.                                          FAX
  43.                                     1-703-494-0595
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.                                      INTRODUCTION
  56.  
  57.           SIO.SYS and VSIO.SYS are companion device drivers for Version 2
  58.           (and up) of the OS/2 operating system.
  59.  
  60.           Both drivers (SIO/VSIO) have been coded with performance in mind,
  61.           possibly sacrificing some compatibility.  For this reason, SIO
  62.           and VSIO are not exact replacements for the OS/2 drivers COM and
  63.           VCOM.  However, all serial communications programs tested by the
  64.           author work correctly using SIO/VSIO.
  65.  
  66.           This manual is intended for the SIO user.  A separate SIO
  67.           Technical Reference Manual is sent along with registered versions
  68.           of SIO.  The Technical Reference Manual also documents some
  69.           advanced options and features that are not documented here.
  70.  
  71.           This manual and the software distributed with it is provided with
  72.           no guarantees.  Use it at your own risk.
  73.  
  74.           Support
  75.  
  76.           Extensive testing has been done to insure that this product works
  77.           on the widest possible range of OS/2 V2 (and up) systems.  In
  78.           most cases, problems can be resolved by reading this manual
  79.           carefully.
  80.  
  81.           Support is provided in section 1 (Other Vendors) of the OS/2
  82.           Vendor Forum on CompuServe (GO OS2AVEN).  Regular checks are made
  83.           in this Forum for SIO support questions.
  84.  
  85.           In addition, support is provided by Email and FAX.  Voice support
  86.           would overwhelm the author.  If, after reading the manual
  87.           carefully, you are unable to resolve a problem, you may fill out
  88.           PROBLEM.TXT (adding information as necessary) and Email/FAX it to
  89.           one of the following:
  90.  
  91.                                         Email
  92.                                  CompuServe 71154,575
  93.                              Internet p00321@psilink.com
  94.  
  95.                                          FAX
  96.                                     1-703-494-0595
  97.  
  98.           PROBLEM.TXT is included in the distribution ZIP.
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.                                                                          ii
  107.  
  108.                                   TABLE OF CONTENTS
  109.  
  110.  
  111.           INTRODUCTION  . . . . . . . . . . . . . . . . . . . . . . . .   i
  112.                SIO Technical Reference Manual . . . . . . . . . . . . .   i
  113.                Support  . . . . . . . . . . . . . . . . . . . . . . . .   i
  114.                     OS/2 Vendor Forum on CompuServe . . . . . . . . . .   i
  115.  
  116.           WHAT IS SIO . . . . . . . . . . . . . . . . . . . . . . . . .   1
  117.  
  118.           WHAT IS VSIO  . . . . . . . . . . . . . . . . . . . . . . . .   2
  119.  
  120.           GETTING STARTED . . . . . . . . . . . . . . . . . . . . . . .   3
  121.  
  122.           Installing SIO/VSIO . . . . . . . . . . . . . . . . . . . . .   3
  123.                Quick Start  . . . . . . . . . . . . . . . . . . . . . .   3
  124.  
  125.           COMMAND LINE OPTIONS  . . . . . . . . . . . . . . . . . . . .   4
  126.                COM1 thru COMn . . . . . . . . . . . . . . . . . . . . .   4
  127.                I/O port address . . . . . . . . . . . . . . . . . . . .   4
  128.                IRQ number . . . . . . . . . . . . . . . . . . . . . . .   4
  129.                Forced 16550A  . . . . . . . . . . . . . . . . . . . . .   4
  130.  
  131.           PCMCIA  . . . . . . . . . . . . . . . . . . . . . . . . . . .   6
  132.  
  133.           AUTOMATIC IRQ ASSIGNMENT  . . . . . . . . . . . . . . . . . .   7
  134.  
  135.           DOS SETTINGS  . . . . . . . . . . . . . . . . . . . . . . . .   8
  136.                SIO_Allow_Access_COMn  . . . . . . . . . . . . . . . . .   8
  137.                SIO_Virtualize_COM_Ports . . . . . . . . . . . . . . . .   8
  138.                SIO_Virtualize_16550A  . . . . . . . . . . . . . . . . .   8
  139.                SIO_Virtual_RTS_is_HS  . . . . . . . . . . . . . . . . .   8
  140.  
  141.           Differences between SIO/VSIO and COM/VCOM . . . . . . . . . .   9
  142.  
  143.           PROBLEMS AND SOLUTIONS  . . . . . . . . . . . . . . . . . .    10
  144.                IRQ for a port appears to be wrong . . . . . . . . . .    10
  145.                The modem will not initialize  . . . . . . . . . . . .    10
  146.                WinFax locks up during install . . . . . . . . . . . .    10
  147.                Telemate does not recognize VX00 as a FOSSIL . . . . .    10
  148.                Comm output is very slow from DOS  . . . . . . . . . .    10
  149.                FaxWorks' driver FMD.SYS . . . . . . . . . . . . . . .    10
  150.                Procomm stops receiving  . . . . . . . . . . . . . . .    11
  151.                WinFax does not work well. . . . . . . . . . . . . . .    12
  152.                     Class 1 FAX modem . . . . . . . . . . . . . . . .    12
  153.                     Class 2 FAX modem . . . . . . . . . . . . . . . .    12
  154.  
  155.           IRQ SHARING ON ISA  . . . . . . . . . . . . . . . . . . . .    13
  156.  
  157.           Appendix A, Hardware Port and IRQ Assignments . . . . . . .    14
  158.                Addresses and IRQs for COM1 and COM2 . . . . . . . . .    14
  159.                Defacto standard for COM3 and COM4 . . . . . . . . . .    14
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.                                                                         iii
  168.  
  169.                Addresses and IRQ for COM3 through COM8 on the PS/2  .    14
  170.  
  171.           Appendix B, SIO Chips . . . . . . . . . . . . . . . . . . .    15
  172.                8250 . . . . . . . . . . . . . . . . . . . . . . . . .    15
  173.                8250A  . . . . . . . . . . . . . . . . . . . . . . . .    15
  174.                16450  . . . . . . . . . . . . . . . . . . . . . . . .    16
  175.                16C451 . . . . . . . . . . . . . . . . . . . . . . . .    16
  176.                16550 (Non A . . . . . . . . . . . . . . . . . . . . .    16
  177.                16550A . . . . . . . . . . . . . . . . . . . . . . . .    16
  178.                16550AF  . . . . . . . . . . . . . . . . . . . . . . .    16
  179.                16550AFN . . . . . . . . . . . . . . . . . . . . . . .    16
  180.                16550s Made by Western Digital . . . . . . . . . . . .    17
  181.                16C551 . . . . . . . . . . . . . . . . . . . . . . . .    17
  182.                16C552 . . . . . . . . . . . . . . . . . . . . . . . .    17
  183.                16C554 . . . . . . . . . . . . . . . . . . . . . . . .    17
  184.                82510  . . . . . . . . . . . . . . . . . . . . . . . .    17
  185.  
  186.           Appendix C, Multi-Port Serial I/0 Cards . . . . . . . . . .    18
  187.                STB 4COM . . . . . . . . . . . . . . . . . . . . . . .    18
  188.  
  189.           INDEX . . . . . . . . . . . . . . . . . . . . . . . . . . .    19
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.                                                                           1
  198.  
  199.                                      WHAT IS SIO
  200.  
  201.           SIO is a Serial Input/Output (SIO) communications driver.  It
  202.           provides an interface between application programs and the serial
  203.           communications hardware.
  204.  
  205.           SIO had been designed as a high performance replacement for the
  206.           OS/2 device driver COM.SYS.  See the programmers reference manual
  207.           for information about the known differences between COM.SYS and
  208.           SIO.SYS.
  209.  
  210.           SIO only works with 8250 (type) serial I/O devices.  Such devices
  211.           include, but is not limited to the 8250A, 16450, 16550, 16550A
  212.           and the 82510.  If you have a PC that is an IBM or near
  213.           compatible which has a serial communication port, it is likely
  214.           that it contains one of these devices.  SIO will identify the
  215.           type of serial devices that it finds at load time.
  216.  
  217.           Like other Device Drivers, SIO will do very little standing
  218.           alone.  There must be an application(s) program that makes use of
  219.           SIO's functions before one will benefit from SIO.
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.                                                                           2
  228.  
  229.                                      WHAT IS VSIO
  230.  
  231.           VSIO is a Virtual Device Driver (VDD).  Virtual device drivers
  232.           provide services for DOS programs executing under OS/2.  Most
  233.           Virtual Device Drivers emulate a specific hardware device and/or
  234.           BIOS service.  The primary job of a Virtual Device Driver is to
  235.           convert misbehaved DOS input/output into well behaved
  236.           input/output.
  237.  
  238.           Using the protection mechanism of the 386 (and up) processor, a
  239.           Virtual Device Driver can instruct OS/2 to trap all input/output
  240.           for given hardware ports.  Once trapped, the Virtual Device
  241.           Driver (VDD) appropriately routes information to/from the
  242.           Physical Device Driver (PDD) and to/from the DOS program.
  243.  
  244.           VSIO creates a virtual (imaginary) 16550A or 16450 (UART) in
  245.           software.  VSIO does not emulate any BIOS services.  All of the
  246.           hardware registers of the virtual UART are simulated by VSIO. 
  247.           VSIO does not attempt to simulate the timing of the real UARTs. 
  248.           DOS programs that depend on the timing of real hardware UARTs may
  249.           have problems executing under VSIO.
  250.  
  251.           All DOS programs that execute under VSIO should have RTS/CTS
  252.           handshaking enabled regardless of the baud rate.  Note that this
  253.           enabling of RTS/CTS handshaking is independent of the RTS/CTS
  254.           handshaking used by SIO.
  255.  
  256.           The virtualization (simulation) provided by VSIO is not (and can
  257.           not be) exact.  However, most well written DOS programs should
  258.           not have problems.
  259.  
  260.           VSIO will only work with SIO installed and the versions of
  261.           SIO/VSIO must match.  If VSIO refuses to install, you most likely
  262.           have a version mismatch.  VSIO will not work with any other
  263.           device driver like COM.SYS.
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.                                                                           3
  272.  
  273.                                    GETTING STARTED
  274.  
  275.           Installing SIO/VSIO
  276.  
  277.           SIO is distributed as a ZIP file.  To extract the individual
  278.           files from the distribution file you need the program PKUNZIP or
  279.           an equivalent.  PKUNZIP is a product of PKWARE and can be
  280.           downloaded from almost any bulletin board system (BBS).  You
  281.           probably already have PKUNZIP and know how to use it, otherwise I
  282.           doubt that you would be reading this.  When PKUNZIP is used to
  283.           extract the various files, -AV should appear after each file name
  284.           as it is extracted.  In addition, the message:
  285.  
  286.                Authentic files Verified!
  287.  
  288.           should appear after the extraction process.  If this message does
  289.           not appear, or appears with a name other than Raymond L. Gwinn,
  290.           the file is not an original SIO distribution file.
  291.  
  292.           The only file that the basic user actually needs is SIO.SYS. 
  293.           Virtual DOS machine (VDM) users will also want VSIO.SYS.  Copy
  294.           one or both of these files to a convenient directory or
  295.           subdirectory on your system.
  296.  
  297.           Quick Start
  298.  
  299.           Copy SIO.SYS and VSIO.SYS to the root directory of your boot
  300.           drive or diskette.
  301.  
  302.           If you are going to use standard communications ports, either
  303.           COM1 or COM2 on an ISA buss (AT or clone), or COM1 through COM4
  304.           on a PS/2, then add the following line to your CONFIG.SYS file:
  305.  
  306.                DEVICE=SIO.SYS
  307.                DEVICE=VSIO.SYS
  308.  
  309.           Be sure to REMark out the COM.SYS and VCOM.SYS device drivers if
  310.           they exist in your CONFIG.SYS.
  311.  
  312.           With the above statements you will be able to use standard COM1
  313.           and/or COM2 (if they exist) on any PC system know to the author.
  314.  
  315.           If your setup is more complex, you must read on.
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.                                                                           4
  324.  
  325.                                  COMMAND LINE OPTIONS
  326.  
  327.           The command line options are included in the command line that
  328.           loads SIO in the CONFIG.SYS file.  VSIO has no command line
  329.           options.  Command line options are usually grouped by port within
  330.           parenthesis.
  331.  
  332.           If you use only COM1 and/or COM2, at the standard IRQ and port
  333.           addresses, you will not need any command line options.  However,
  334.           up to four serial communications ports, COM1 thru COM4, can be
  335.           specified at any base port address and any IRQ.  On PS/2 systems
  336.           and some ISA cards, SIO/VSIO supports multiple communications
  337.           devices sharing the same IRQ.
  338.  
  339.           The basic command line syntax is as follows:
  340.  
  341.                DEVICE=SIO.SYS (Cn, An, In, Ig, Fc) [(Cn, An, In, Ig, Fc)]
  342.  
  343.           Where
  344.                "Cn" is the comm port number (1 thru 4) or the string COM1
  345.                thru COMn.  The port number may proceeded by an asterisk "*"
  346.                to indicate that the port may be used as a PCMCIA comm port
  347.                (eg *1 or *COM1).
  348.  
  349.                "An" is a hexadecimal number that defines the base hardware
  350.                I/O port address for the communications port.  If this field
  351.                is left blank, the default I/O port address is used for the
  352.                comm port.  Note that default I/O addresses exist only for
  353.                COM1 through COM4 on AT type systems and for COM1 through
  354.                COM8 on PS/2 systems.
  355.  
  356.                "In" is an IRQ number (0 thru 15) or the string IRQ0 thru
  357.                IRQ15.  It is best if one leaves this field blank and allows
  358.                SIO to determine the IRQ, see AUTOMATIC IRQ ASSIGNMENT
  359.                below.
  360.  
  361.                "Ig" is an ignored parameter.  If exists for compatibility
  362.                with COM.SYS.
  363.  
  364.                "Fc" is the Forced 16550A chip parameter.  If an F is placed
  365.                in this position, a 16550A UART chip type is forced
  366.                regardless of the automatically detected chip type.
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.                                                                           5
  375.  
  376.  
  377.           For a PC with COM1 and COM2 of standard configuration, the
  378.           following command line will load SIO correctly:
  379.  
  380.                DEVICE=SIO.SYS (1, 3F8, 4) (2, 2f8, 3)
  381.  
  382.           A more readable, but identical, command line is:
  383.  
  384.                DEVICE=SIO.SYS (COM1,3F8,IRQ4) (COM2,2F8,IRQ3)
  385.  
  386.           Forcing a 16550A on COM1 would be as follows:
  387.  
  388.                DEVICE=SIO.SYS (COM1,3F8,IRQ4,,F) (COM2,2F8,IRQ3)
  389.  
  390.           In a similar manner, up to sixteen serial communications ports
  391.           (four in the downloadable version) can be defined and supported
  392.           by SIO and VSIO.
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.                                                                           6
  401.  
  402.                                         PCMCIA
  403.  
  404.           OS/2 Version 2.1 introduced limited PCMCIA support which includes
  405.           PCMCIA modems.  I am told that the PCMCIA support will be changed
  406.           in the future, so the following information may change.
  407.  
  408.           SIO supports PCMCIA comm ports or modems.  However, several other
  409.           device drivers or programs are needed to use a PCMCIA modem under
  410.           OS/2.  One of the needed drivers is provided with OS/2 version
  411.           2.1 and is called PCMCIA.SYS which provided "Card Services".
  412.  
  413.           Another needed driver, "Socket Services", is usually supplied by
  414.           the computer manufacturer (or supplier).
  415.  
  416.           A third driver is usually supplied by the modem manufacture (or
  417.           supplier).  This driver is referred to as the "Client Driver".
  418.  
  419.           What all of the above boils down to is that these drivers, or
  420.           their equivalents are needed to enable the PCMCIA modem.  Once
  421.           enabled, SIO can then use the modem.
  422.  
  423.           The Client Driver (or equivalent) usually allows the modems I/O
  424.           address and IRQ to be assigned.  If so, the address and IRQ
  425.           assigned at the Client Driver must match an address/IRQ
  426.           combination for a comm port known to SIO.  This is not a problem
  427.           if one is using standard addresses and IRQs for the comm ports.
  428.  
  429.           If the OS/2 drivers are not available, you can also try to enable
  430.           your PCMCIA modem using a DOS VDM and drivers/programs supplied
  431.           for DOS.  This has worked for many users.
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.                                                                           7
  440.  
  441.  
  442.                                AUTOMATIC IRQ ASSIGNMENT
  443.  
  444.           SIO will automatically locate the IRQ that a comm port is
  445.           attached to.  The IRQ used by SIO for a given comm port is
  446.           assigned in the following manner:
  447.  
  448.           1 - If an IRQ is specified in the SIO command line then that IRQ
  449.           is used.  However, SIO will display a warning message if the IRQ
  450.           seems to be other than specified.
  451.  
  452.           2 - If no IRQ is specified in the command line, and if SIO
  453.           detected the IRQ then the detected IRQ is used.
  454.  
  455.           3 - If no IRQ is specified in the command, and if SIO could NOT
  456.           detect an IRQ then the default IRQ for the comm port is used. 
  457.           SIO will also display a warning message in this case.
  458.  
  459.           The following STYLE command line is recommended for all but the
  460.           most unusual systems.  That is, specify only the port number for
  461.           those above COM2 (to tell SIO to support those ports) and let SIO
  462.           do the rest.
  463.  
  464.           DEVICE=SIO.SYS (COM3) (COM4)
  465.  
  466.           If you do not have a COM3 or COM4, or if the mouse is using the
  467.           only comm port above COM2 then the following command line should
  468.           be used.
  469.  
  470.           DEVICE=SIO.SYS
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.                                                                           8
  479.  
  480.                                      DOS SETTINGS
  481.  
  482.           VSIO gets its operational characteristics from DOS Settings. 
  483.           Several basic DOS Settings are provided.  They specify the type
  484.           of access (if any) that a DOS program is to have to a
  485.           communication port that SIO controls.
  486.  
  487.           All of the DOS Settings default to what most users should use
  488.           most of the time (which is ON).  Also, all of the DOS Settings
  489.           are prefixed with SIO_.
  490.  
  491.           The provided DOS Settings and their meaning follow:
  492.  
  493.                "SIO_Allow_Access_COMn" (where n is 1 thru 4).  This DOS
  494.                setting defaults to ON.  If this setting is turned OFF for
  495.                any or all of the ports, the DOS program will not be allowed
  496.                any access to that port(s).
  497.  
  498.                "SIO_Virtualize_COM_Ports"  This Dos setting defaults to ON
  499.                and it applies to all communications ports used by the DOS
  500.                session.  When ON, this DOS setting means VSIO is to act as
  501.                an interface between the SIO and the DOS program.  When OFF,
  502.                the DOS program is given direct access to the hardware ports
  503.                of the UART(s).
  504.  
  505.                "SIO_Virtualize_16550A"  This DOS setting defaults to ON and
  506.                it applies to all communications ports used by the DOS
  507.                session.  When ON, VSIO will simulate a 16550A.  When OFF,
  508.                VSIO will simulate a 16450.  Some DOS programs may not work
  509.                when a 16550A is simulated.  Turning this setting off may
  510.                allow the program to work (but slower).
  511.  
  512.                "SIO_Virtual_RTS_is_HS"  This DOS setting defaults to ON and
  513.                it applies to all communications ports used by the DOS
  514.                session.  When ON, VSIO treats RTS as a handshaking signal
  515.                from the DOS session.  When OFF, VSIO passed the RTS setting
  516.                directly to the hardware.  This setting MUST be on for all
  517.                high speed DOS communications.  The only application, known
  518.                to the author, where this signal may (should) be turned off
  519.                is DOS programs that use true half duplex.
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.                                                                           9
  528.  
  529.                       Differences between SIO/VSIO and COM/VCOM
  530.  
  531.           What follows is some of the differences between SIO/VSIO and
  532.           COM/VCOM that are know to the author.
  533.  
  534.           1 -  COM.SYS will automatically seek out and support four
  535.                comm ports, COM1 through COM4.  SIO.SYS will
  536.                automatically seek out and support only COM1 and COM2. 
  537.                If SIO.SYS is to support more than two comm ports, they
  538.                must be defined in the command line that loads SIO.SYS. 
  539.                For example, DEVICE=SIO.SYS (COM3) (COM4) will cause
  540.                SIO.SYS to support four comm ports.
  541.  
  542.           2 -  In the absence of overrides in the command line,
  543.                COM.SYS will seek out four comm ports in the sequence
  544.                of I/O ports 3F8h, 2F8h, 3E8h and 2E8h.  The first port
  545.                found in this sequence is given the logical name COM1,
  546.                the second is COM2 etc.  This means that the comm port
  547.                at 2F8h could become COM1.  In the opinion of the
  548.                author, this confuses some users to frustration.
  549.  
  550.                With no command line overrides, SIO.SYS uses a fixed
  551.                I/O port concept.  That is, COM1 is always at I/O port
  552.                3F8h, COM2 is always at 2F8h, etc.  Another way of
  553.                looking at this is;  if no comm port exists at port
  554.                3F8h, then you do not have a COM1.  SIO.SYS will not
  555.                move another (found) comm port into the logical COM1
  556.                slot.
  557.  
  558.           3 -  VSIO opens a comm port for a DOS session with sharing
  559.                allowed.  VCOM uses an "exclusive use" open for DOS
  560.                sessions.
  561.  
  562.           4 -  SIO.SYS always controls the FIFOs of the 16550 UART. 
  563.                SIO.SYS will not allow an application program (OS2 or DOS)
  564.                to disable the FIFOs of a real 16550.
  565.  
  566.           5 -  SIO.SYS will accept any number between 50 and 115200 as a
  567.                valid baud rate.  For example, if an application program
  568.                attempts to set a baud rate of 9990 bps, COM.SYS will reject
  569.                it and SIO.SYS will accept it.
  570.  
  571.           6 -  The last decimal digit of a baud rate given to SIO must be
  572.                zero.  SIO.SYS will not support baud rates like 75 or 134.5. 
  573.                If given, they will be rounded to 80 and 130 respectively.
  574.  
  575.           7 -  SIO/VSIO execute faster than COM/VCOM.  This means that some
  576.                applications, that are timing dependant, may not work under
  577.                SIO/VSIO that do work under COM/VCOM.
  578.  
  579.           8 -  VSIO optionally (and by default) simulates a 16550A for DOS
  580.                sessions.  VCOM simulates a 8250/16450.
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.                                                                          10
  589.  
  590.  
  591.                                 PROBLEMS AND SOLUTIONS
  592.  
  593.           1 -  Port already in use is displayed.
  594.  
  595.                This message is displayed when the comm port or the IRQ is
  596.                in use.  If the comm port is not actually in use, the IRQ is
  597.                most likely in use.
  598.  
  599.           2 -  SIO displays a warning message that the IRQ for a port
  600.                appears to be wrong, but the port works.
  601.  
  602.                SIO probably detected more than one IRQ attached to the comm
  603.                port.  This indicates a possible hardware problem with your
  604.                system that you may want to have checked.
  605.  
  606.           3 - The modem will not initialize.
  607.  
  608.                Configure your comm program(s) to insert a delay between
  609.                modem initialization characters as they are sent to the
  610.                modem.
  611.  
  612.           4 - WinFax locks up during install.
  613.  
  614.                During the WinFax install, temporally turn OFF the DOS
  615.                setting SIO_Virtualize_COM_Ports.  Once installation is
  616.                complete, the setting SIO_Virualize_COM_Ports can be
  617.                restored.
  618.  
  619.           5 - Telemate does not recognize VX00 as a FOSSIL.
  620.  
  621.                Set the baud rate in Telemate to less than 57600.
  622.  
  623.           6 -  Comm output is very slow from DOS.
  624.  
  625.                This is a problem common to many DOS BBS and Door programs. 
  626.                They attempt to synchronize the local screen with the
  627.                transmitted data.  That is, they send a character, wait
  628.                until it is sent and then display the character on the local
  629.                screen.  This does not cause a problem for the signal
  630.                tasking DOS environment.  However, this procedure causes at
  631.                least two (probably more) context switches in the multi-
  632.                tasking environment of OS2, which in turn brings the
  633.                processor to its knees.  One possible solution is for the
  634.                programmer to synchronize line by line instead of character
  635.                by character.
  636.  
  637.           7 -  FaxWorks' driver FMD.SYS cannot access a comm port when SIO
  638.                is used, but works okay with COM.SYS.
  639.  
  640.                The problem may be that the comm port is in use (often by a
  641.                DOS program).  In all cases known to the author, this has
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.                                                                          11
  650.  
  651.                been the case.  That is, FMD.SYS can not access the port
  652.                because it is in use, and FMD.SYS does not report the
  653.                problem in a manner that is understandable to many users.
  654.  
  655.                COM.SYS seems to have a bug that will allow an OS2 device
  656.                driver (like FMD.SYS) to use a comm port when it is in use
  657.                by a another device driver, and it (COM.SYS) does not cause
  658.                an error when it should.  The exact conditions of this is
  659.                not fully understood by the author and the above supposition
  660.                may not be totally correct.
  661.  
  662.           8 -  Procomm stops receiving
  663.  
  664.                Procomm seems to have a bug in its implementation of RTS/CTS
  665.                handshaking.  The problem shows up most often when Procomm
  666.                is windowed.  Under certain conditions, Procomm will turn
  667.                the virtual RTS OFF and does not turn it ON again.  This
  668.                prevents VSIO from sending further data to Procomm if
  669.                SIO_Virtual_RTS_is_HS is turned ON.  A solution to the
  670.                problem that seems to work is to turn SIO_Virtual_RTS_is_HS
  671.                OFF.  Note that SIO_Virtual_RTS_is_HS should be ON under
  672.                almost all other conditions.
  673.  
  674.  
  675.  
  676.  
  677.  
  678.  
  679.  
  680.                                                                          12
  681.  
  682.  
  683.           9 - WinFax does not work well.
  684.  
  685.                a- Connect problems with recipient's fax station
  686.  
  687.                b- Cannot send more than one page of a multiple page fax
  688.  
  689.                c- Transmission fails between pages
  690.  
  691.                d- Transmitted pages are corrupted, missing parts, or cut
  692.                off.
  693.  
  694.                Class 1 FAX modem.
  695.                          The modem init strings set by WinFax 3.0 will work
  696.                          in the single-layered comm world of DOS and
  697.                          Windows.  However, these modem init strings will
  698.                          not work in the multi-layered comm environment
  699.                          used by OS/2.  Specifically, WinFax 3.0 sets the
  700.                          modem to use only Xon/Xoff flow control.  Ideally,
  701.                          both Xon/Xoff and Hardware handshaking needs to be
  702.                          set.  If only one handshake can be set, set the
  703.                          modem to Hardware handshake.  For USR FAX modems,
  704.                          use &H3.  Additionally, for WinFax 3.04 and up,
  705.                          place the following in your WINFAX.INI file:
  706.                               HdwFlowControl=1
  707.  
  708.                Class 2 FAX modem.
  709.                          It seems to the author that hardware handshake
  710.                          screws up some (possibly all) class 2 FAX modems. 
  711.                          Therefore, when using a class 2 modem, WinFax
  712.                          should be configured to use XON/XOFF handshaking. 
  713.                          For WinFax 3.04 and up, place the following in
  714.                          your WINFAX.INI file:
  715.                               HdwFlowControl=0
  716.  
  717.                          The author feels that the inability to use
  718.                          hardware handshake with class 2 FAX modems is a
  719.                          serious design deficiency.
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.                                                                          13
  728.  
  729.                                   IRQ SHARING ON ISA
  730.  
  731.           Sharing the same IRQ for multiple communications ports on ISA
  732.           systems is not for the weak of heart (or mind).  If you have
  733.           problems with shared IRQs, DO NOT contact the author.  Contact
  734.           the board or computer manufacturer for help.
  735.  
  736.           Some general rules are as follows:
  737.  
  738.           1 - Two different boards (plugged into different slots) can not
  739.           share the same IRQ.  This is a hardware limitation of ISA systems
  740.           and can not be corrected by software.  This means that you can
  741.           not plug in two internal modems, set them for the same IRQ and
  742.           expect them to work.  This does not apply to PS/2 systems.  The
  743.           problem of multiple boards sharing the same IRQ was corrected in
  744.           the PS/2's buss design.
  745.  
  746.           2 - SIO can not (will not) share an IRQ with other device drivers
  747.           at the same time.  SIO releases IRQs that it is currently not
  748.           using.  This is different form how COM.SYS works.  This
  749.           difference may show up as an unexpected "port already in use"
  750.           error that does not occur with COM.SYS.  I have received reports
  751.           that the SDLC drivers try to concurrently share IRQs with the
  752.           ASYNC driver.  SIO.SYS will not allow this while COM.SYS will.
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.                                                                          14
  761.  
  762.                     Appendix A, Hardware Port and IRQ Assignments
  763.  
  764.           I have obtained the following information from various sources. 
  765.           Accuracy is not guaranteed.  In fact, nothing in this document is
  766.           guaranteed.
  767.  
  768.           Addresses and IRQs for COM1 and COM2
  769.  
  770.                COM1 uses 03F8h and IRQ4
  771.                COM2 uses 02F8h and IRQ3
  772.  
  773.           Defacto standard for COM3 and COM4 for PC, XT and AT
  774.  
  775.                COM3 uses 03E8h and IRQ4
  776.                COM4 uses 02E8h and IRQ3
  777.  
  778.           Addresses and IRQ for COM3 through COM8 on the PS/2
  779.  
  780.                COM3 uses 3220h and IRQ3
  781.                COM4 uses 3228h and IRQ3
  782.                COM5 uses 4220h and IRQ3
  783.                COM6 uses 4228h and IRQ3
  784.                COM7 uses 5220h and IRQ3
  785.                COM8 uses 5228h and IRQ3
  786.  
  787.           All PCs (know to the author) prior to the PS/2 and EISA only use
  788.           10 bits to address hardware I/0 ports.  Systems prior to the PS/2
  789.           and EISA can not address the standard PS/2 addresses for COM3
  790.           through COM8.  If an AT or below attempts to address COM3 through
  791.           COM8 using the PS/2 addresses, only the low 10 bits of the
  792.           address are used.  That is, the high digit of the hexadecimal
  793.           address will be ignored.  This means that any reference to COM3
  794.           through COM8 will actually address ports 220h through 22Fh on
  795.           older PCs.
  796.  
  797.           One should avoid expansion boards that use ports 220h through
  798.           22Fh unless the expansion board is a serial I/O board. 
  799.  
  800.           SIO will (attempt to) determine the hardware architecture
  801.           (ISA/EISA and PS/2) that it is being executed on and use the
  802.           appropriate hardware port addresses for COM1 thru COM4 as
  803.           defaults.
  804.  
  805.  
  806.  
  807.  
  808.  
  809.  
  810.  
  811.                                                                          15
  812.  
  813.                                 Appendix B, SIO Chips
  814.  
  815.  
  816.           The following is a collection of comments developed from hearsay,
  817.           random documents, experience, and technical specifications. So,
  818.           take it with a grain of salt.  Order information from the various
  819.           manufactures if you want accurate information.
  820.  
  821.           Very good reference books are available from National
  822.           Semiconductor Corporation.  They cover most of the SIO devices
  823.           (also called UARTs) that you will find in many PCs and clones.  I
  824.           am not sure that books can be ordered directly from National
  825.           semiconductor. They may require that you get it from a
  826.           distributor.  In any case, the address on the back of the one
  827.           manual is:
  828.  
  829.                National Semiconductor Corporation
  830.                2900 Semiconductor Drive
  831.                P.O. Box 58090
  832.                Santa Clara, CA 95052-8090
  833.  
  834.                Tel:(408)721-5000
  835.                TWX:(910)339-9240
  836.  
  837.           8250
  838.  
  839.           As best that I know, the 8250 was the first SIO chip (integrated
  840.           circuit) that was used by the IBM PC and many clones.  In my
  841.           opinion, it was a poor choice on the part of IBM.  I feel many
  842.           superior devices, at comparable prices, were readily available. 
  843.           At that time, I feel the 8251A or the 8530 would have been better
  844.           choices.  But, they used the 8250 and therefore we must use it.
  845.  
  846.           From a hardware standpoint the 8250 is a relatively slow device. 
  847.           It is advisable that programmers not perform successive inputs or
  848.           outputs to this device.  It seems that software programs can load
  849.           the various registers of the 8250 faster than it can process the
  850.           information.  The 8250 had a total of 7 registers.  The
  851.           specifications state that 56kb is the maximum baud rate.
  852.  
  853.           8250A
  854.  
  855.           I believe the 8250A is the 8250 with some bug fixes.  I have no
  856.           idea what the bugs may have been.  A quick glance at the
  857.           specifications shows the speed of the 8250 and 8250A to be much
  858.           the same.  The 8250A added an 8th register.  This additional
  859.           register enables software to detect if an 8250 is installed.  The
  860.           specifications state that 56kb is the maximum baud rate.
  861.  
  862.  
  863.  
  864.  
  865.  
  866.  
  867.  
  868.                                                                          16
  869.  
  870.           16450
  871.  
  872.           The 16450 seems to be a speeded up version of the 8250A.  There
  873.           is no direct way (that I know of) for software to detect the
  874.           difference between an 8250A and a 16450.  I believe the 16450 was
  875.           developed to eliminate the need for software to insert delays
  876.           between successive accesses to the device.  The specifications
  877.           indicate the 16450 is a much faster device than its predecessors. 
  878.           The additional speed is only the speed at which the processor can
  879.           access the device.  The maximum baud rate for the 16450 is still
  880.           stated at 56kb.  However, I have been told by some people that
  881.           they have run the 16450 successfully at much higher speeds. I do
  882.           not believe there was ever a 16450A.
  883.  
  884.           16C451
  885.  
  886.           The 16C451 is a CMOS version of the 16450.  CMOS is a term for
  887.           the material and manufacturing process used to make the part. 
  888.           CMOS typically uses less power than other technologies.  If you
  889.           are not designing hardware, you should view the 16C451 as a
  890.           16450.
  891.  
  892.           16550 (Non A)
  893.  
  894.           It is hard to find a 16550 (Non A).  I was told by National
  895.           Semiconductor that they did everything they could to get all
  896.           16550s back.  SIO will detect a 16550 and tell you if you have
  897.           one.  I am told that the 16550 was installed in early PS/2
  898.           systems.
  899.  
  900.           The 16550 was the first shot at a FIFOed version of the 8250
  901.           family from National semiconductor.  However, I was told by
  902.           National Semiconductor that the FIFOs of the 16550 are not
  903.           reliable and they should not be enabled.  SIO will treat a 16550
  904.           like a 16450.  In this mode, they are reliable.  National
  905.           Semiconductor would not provide me with a specification for the
  906.           16550.  However, I suspect its maximum baud rate is the same as
  907.           the 16550A which is 256kb.
  908.  
  909.           16550A, 16550AF and 16550AFN
  910.  
  911.           In the manuals that I have, National Semiconductor does not
  912.           explain the differences between the 16550A and the 16550AF.  I
  913.           suspect the AF part may have a few bug fixes.  I believe the N in
  914.           AFN describes packaging, ceramic versus plastic, DIP versus
  915.           surface mount etc.
  916.  
  917.           In the opinion of the author, there is no substitute for the
  918.           16550A (and its successors) in the 8250 type series.  The 16550A
  919.           is compatible with most software written for the entire family of
  920.           8250 type devices.  Programs that are 16550A aware can provide
  921.           much improved performance over previous devices.
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.                                                                          17
  930.  
  931.  
  932.           The maximum baud rate for the 16550A is specified at 256kb. 
  933.           However, due to the hardware design of the PC et al, 115kb is the
  934.           maximum baud rate that can be programmed by software.
  935.  
  936.           The 16550A can be plugged into the same socket that contains an
  937.           8250, 8250A or 16450.  If your SIO expansion board has the SIO
  938.           chips in sockets, you can upgrade to the 16550A by simply
  939.           removing the old chips and replacing them with 16550As.
  940.  
  941.           The key to the performance increase of the 16550A is its FIFOs. 
  942.           It has 16 byte FIFOs for both transmit and receive data.
  943.  
  944.           16550s Made by Western Digital
  945.  
  946.           I have been told, but I have not verified for myself, that 16550s
  947.           made by Western Digital have a problem with their FIFOs when
  948.           working at 2400 baud or below.
  949.  
  950.           16C551
  951.  
  952.           The 16C551 is a CMOS version of the 16550AF.  See the above
  953.           description of the 16C451 for a discussion of CMOS.  Do not feel
  954.           you need to upgrade from a 16550A or AF to a 16C551.  There is no
  955.           gain from an existing users point of view.
  956.  
  957.           16C552
  958.  
  959.           The 16C552 is two 16C551s on a single chip.
  960.  
  961.           16C554
  962.  
  963.           The 16C554 is four 16C551s on a single chip.
  964.  
  965.           82510
  966.  
  967.           I believe Intel is the only company that manufactures the 82510. 
  968.           The 82510 is feature rich with several modes of operation.  Its
  969.           default mode is to operate as a 16450.  The 82510 has a 4 byte
  970.           FIFO for both transmit and receive data.  A 4 byte FIFO is
  971.           sufficient to provide significant performance over a basic 16450.
  972.  
  973.           The 82510 is small in size.  Therefore, it is found in many lap
  974.           tops.
  975.  
  976.           The 82510 is somewhat of a sleeper.  I believe it would be much
  977.           more widely used if Intel had promoted it more.  However, given a
  978.           choice between the 82510 and the 16550A, I would select the
  979.           16550A.
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.                                                                          18
  988.  
  989.                        Appendix C, Multi-Port Serial I/0 Cards
  990.  
  991.           I have received many requests for information about multi-port
  992.           serial I/O card.  I will describe the boards that I know about
  993.           (or have heard about) here.  I will add to the list as I receive
  994.           precise information from manufactures, users, or I develop it
  995.           myself.
  996.  
  997.           STB 4COM  (ISA buss)
  998.  
  999.           I am very impressed with the STB 4COM card, they have almost got
  1000.           it.  Yes, its the same company that makes the VGA cards.  The
  1001.           4COM card uses a 16554 which is the equivalent of four 16550A. 
  1002.           Comm ports can use IRQs 2/9, 3, 4, 5, 10, 11, 12, and 15.  Any or
  1003.           all ports can share IRQs, and they have done this right.  I
  1004.           tested SIO with all four ports of the 4COM on IRQ12 and they
  1005.           worked correctly.  The user can select any of the following I/O
  1006.           port address for a comm port: 3F8, 2F8, 3E8, 2E8, 1A8, 1E8, 1F8,
  1007.           2A8.
  1008.  
  1009.           The 4COM card is priced at $110 and I ordered mine from Steve
  1010.           Winter of Prerapture Solutions.  Steve can be reached by
  1011.           telephone at 1-919-286-1502 for information and foreign callers. 
  1012.           In the US orders can be placed by calling 1-800-735-5266.  Their
  1013.           mailing address is:
  1014.                Prerapture Solutions
  1015.                1806 Albany St.
  1016.                Durham NC 27705-3135
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.                                                                          19
  1025.  
  1026.                                         INDEX
  1027.  
  1028.           16450 . . . . . . . . . . . . . . . . . . . . . . . . . . . .  16
  1029.           16550 Non A . . . . . . . . . . . . . . . . . . . . . . . . .  16
  1030.           16550A  . . . . . . . . . . . . . . . . . . . . . . . . . . .  16
  1031.           16550AF . . . . . . . . . . . . . . . . . . . . . . . . . . .  16
  1032.           16550AFN  . . . . . . . . . . . . . . . . . . . . . . . . . .  16
  1033.           16550s Made by Western Digital  . . . . . . . . . . . . . . .  17
  1034.           16C451  . . . . . . . . . . . . . . . . . . . . . . . . . . .  16
  1035.           16C551  . . . . . . . . . . . . . . . . . . . . . . . . . . .  17
  1036.           16C552  . . . . . . . . . . . . . . . . . . . . . . . . . . .  17
  1037.           16C554  . . . . . . . . . . . . . . . . . . . . . . . . . . .  17
  1038.           8250  . . . . . . . . . . . . . . . . . . . . . . . . . . . .  15
  1039.           8250A . . . . . . . . . . . . . . . . . . . . . . . . . . . .  15
  1040.           82510 . . . . . . . . . . . . . . . . . . . . . . . . . . . .  17
  1041.           Addresses and IRQ for COM3 through COM8 on the PS/2 . . . . .  14
  1042.           Addresses and IRQs for COM1 and COM2  . . . . . . . . . . . .  14
  1043.           Allow_Access_COMn . . . . . . . . . . . . . . . . . . . . . . . 8
  1044.           Appendix A, Hardware Notes  . . . . . . . . . . . . . . . . .  14
  1045.           Appendix B, SIO Chips . . . . . . . . . . . . . . . . . . . .  15
  1046.           Appendix C, Multi-Port Serial I/0 Cards . . . . . . . . . . .  18
  1047.           AUTOMATIC IRQ ASSIGNMENT  . . . . . . . . . . . . . . . . . . . 7
  1048.           COMn already in use . . . . . . . . . . . . . . . . . . . . .  10
  1049.           CompuServe  . . . . . . . . . . . . . . . . . . . . . . . . . . i
  1050.           CONFIG.SYS  . . . . . . . . . . . . . . . . . . . . . . . . . . 3
  1051.           Defacto standard for COM3 and COM4  . . . . . . . . . . . . .  14
  1052.           Differences between SIO/VSIO and COM/VCOM . . . . . . . . . . . 9
  1053.           DOS SETTINGS  . . . . . . . . . . . . . . . . . . . . . . . . . 8
  1054.           Email . . . . . . . . . . . . . . . . . . . . . . . . . . . . . i
  1055.           FAX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . i
  1056.           FAX Modems
  1057.                Class 1 FAX modem  . . . . . . . . . . . . . . . . . . .  12
  1058.                Class 2 FAX modem  . . . . . . . . . . . . . . . . . . .  12
  1059.           FaxWorks  . . . . . . . . . . . . . . . . . . . . . . . . . .  10
  1060.           FIFO  . . . . . . . . . . . . . . . . . . . . . . . . . .  16, 17
  1061.           FMD.SYS . . . . . . . . . . . . . . . . . . . . . . . . . . .  10
  1062.           GETTING STARTED . . . . . . . . . . . . . . . . . . . . . . . . 3
  1063.           Installing SIO/VSIO . . . . . . . . . . . . . . . . . . . . . . 3
  1064.           IRQ . . . . . . . . . . . . . . . . . . . . . . . . . . . 4, 6, 7
  1065.           IRQ SHARING ON ISA  . . . . . . . . . . . . . . . . . . . . .  13
  1066.           National Semiconductor Corporation  . . . . . . . . . . . . .  15
  1067.           OS2AVEN . . . . . . . . . . . . . . . . . . . . . . . . . . . . i
  1068.           PCMCIA  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
  1069.           PDD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
  1070.           Physical Device Driver  . . . . . . . . . . . . . . . . . . . . 2
  1071.           PKUNZIP . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
  1072.                Authentic files  . . . . . . . . . . . . . . . . . . . . . 3
  1073.           PROBLEMS AND SOLUTIONS  . . . . . . . . . . . . . . . . . . .  10
  1074.           Quick Start . . . . . . . . . . . . . . . . . . . . . . . . . . 3
  1075.           RTS/CTS handshaking . . . . . . . . . . . . . . . . . . . . . . 2
  1076.           SIO Chips . . . . . . . . . . . . . . . . . . . . . . . . . .  15
  1077.           SIO Technical Reference Manual  . . . . . . . . . . . . . . . . i
  1078.  
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.                                                                          20
  1086.  
  1087.           SIO_Virtual_RTS_is_HS . . . . . . . . . . . . . . . . . . . . . 8
  1088.           STB 4COM  . . . . . . . . . . . . . . . . . . . . . . . . . .  18
  1089.           Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . i
  1090.           UART  . . . . . . . . . . . . . . . . . . . . . . . . . . . .  15
  1091.           VDD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
  1092.           Virtual Device Driver . . . . . . . . . . . . . . . . . . . . . 2
  1093.           Virtualize_16550A_For_COM . . . . . . . . . . . . . . . . . . . 8
  1094.           Virtualize_COM_Ports  . . . . . . . . . . . . . . . . . . . . . 8
  1095.           WHAT IS SIO . . . . . . . . . . . . . . . . . . . . . . . . . . 1
  1096.           WHAT IS VSIO  . . . . . . . . . . . . . . . . . . . . . . . . . 2
  1097.           WinFax  . . . . . . . . . . . . . . . . . . . . . . . . .  10, 12
  1098.