1. fir.zip Driver
2. README.TXT File Contents

README.TXT Driver File Contents (fir.zip)

********************************************************************************
                        Standard Microsystems Corporation

                            Confidential Information

                              VCOMM Device Driver
                            Beta Version 0.4 for Testing
********************************************************************************


This diskette contains two binary files that implement the SMC prototype driver
for Infrared communication as described by IrDA and a simple INF script for
installing the driver in the Windows 95 system.  This version of the VCOMM 
driver implements all IrDA speeds.

1. UPDATES

This version of the Vcomm driver offers the following improvements:
   * support for the upper ISA DMA channels (5-7) in the 16-bit mode
   * support redirected DMA channels in the PCI-ISA bridge 
   * supports 576kbps fast IrDA speed


2. INSTALLATION

To install these files, unpack the zip archive attachment.  This archive
contains three files:

   serial.vxd
   irlapfrm.vxd
   smc_inst.inf
   readme.txt

There are three alternative methods of installing the SMC IrDA Vcomm driver:

   - using WINSTALL.EXE program
   or
   - using the INF file provided (automated installation)
   or
   - by hand.

Remember that the installation of the Infrared driver is not trivial and
that it requires the knowledge of the configuration of the system resources.
There exist no standard hardware configurations for the Infrared
communications - each installation depends TOTALLY on the particular
system configuration.

ALL INSTALLATION METHODS REQUIRE PRIOR INSTALLATION OF MICROSOFT'S MSIR20
PRODUCT. OBTAIN THIS PRODUCT (MSIR20) FROM MICROSOFT DIRECTLY BEFORE
INSTALLING SMC'C INFRARED VCOMM DRIVER.

2.1 Automated installation using WINSTALL.

   Insert the distribution diskette in the disk drive. Then use <Start>-<Run>
   menu to select the WINSTALL.EXE program. Run this program.

   This installation utility will query the user for the values of the
   hardware resources that are configured for the SMC'c IrCC controller.

   Be sure to select the values that reflect your hardware setup.

2.2 Automated installation using the SMC_INST.INF

This method may be chosen 

Make sure that the hardware resources settings:
   - Serial IR base
   - Fast IR base
   - DMA channel
   - IRQ number
are reflected in the INF file's Windows 95 registry keys:

HKLM,\Enum\Infrared\Framer,Devtype,0,FDC37C957FR/300
HKLM,\Enum\Infrared\Framer,DMA1Channel,0,1
HKLM,\Enum\Infrared\Framer,HsPortName,0,COM3
HKLM,\Enum\Infrared\Framer,MinTurnTime,1,0x00000007
HKLM,\Enum\Infrared\Framer,SpeedNoTrans,0,1C0
HKLM,\Enum\Infrared\Framer,Speedo,0,1ff

The above settings are for the:
   - Serial IR base at 0x3E8 (COM3)
   - Fast IR base at 0x300
   - ISA DMA channel 1
   - (IRQ number is associated with the COM port.  If the default assignement
      must be changed - the place to do so is the Device Manager in the 
      Control Panel)

If the settings of the Registry Keys in the SMC_INST.INF file have to 
be changed - simply edit this file with the text editor to reflect the
proper settings of your system.

Now, <Right-Click> on the SMC_INST.INF file and choose Install option.

The process is automated from here.


2.3 Manual installation.

Copy two vxd files to your windows\system (or where ever you place your 
system vxd files.)  Be sure to save copies of your original files in case 
you need to restore operation at a later time.

Now enter the Registry editor (\Win95\REGEDIT.EXE) and go to the 
    HKEY_LOCAL_MACHINE
        Enum
           Infrared
              Framer

and manually add the following keys (again with the appropriate for your
system settings):
    Devtype  (Type String): "FDC37C957FR/300"
    DMA1Channel (Type String): 1
    HsPortName (Type String): "COM3"
    MinTurnTime (Type DWORD): 07
    SpeedNoTrans (Type String): "1C0"
    Speedo (Type String): "1ff"

Make sure that the above keys are entered *exactly* as they appear here:
following the Upper/Lower Cases!

Exit REGEIT.
       
The third file contains a copy of this note.


3. CONFIGURATION 

3.1 IrCC Configuration

It is implicitly assumed that the I/O controller logic responsible for
the Infrared communication is configured prior to the installation and 
loading of the VCOMM driver. To configure the SMC IrCC core refer to the 
appropriate device sheets.


3.2 VCOMM Registry Parameters Configuration

If the system configuration changes due to the hardware resources 
assignements in BIOS, simply reedit the appropriate keys in the
sytem Registry.

Below the Vcomm pertinent keys are explained:

DevType
------- defines the SCE port for the serial device.  Change the 240 to 
whatever port address is used by your SCE board.  The second number "0" 
is currently unused. The third number "0" can be changed to a "1" to force 
full IrDA operation on all speeds. 

DMA1Channel
----------- defines the DMA channel number on the ISA bus that used by
the driver software for the DMA transfers. 

Drivers
------- defines the name of the framer software.

HsPortName
---------- is the name of the serial port that defines the SMC 93xx device.
Make certain this value matches the configuration of your system if it is
different than COM3.

MinTurnTime
----------- defines a value controlling the minimum turn-around time
between receiving a packet and transmitting a reply.  The value of "7"
specifies as short a value as appropriate for the SMC hardware.

PortName
-------- variable is defined by the irmon program will be changed the
next time you run irmon.

SpeedNoTrans
------------ defines internal controls for the serial driver.  Do not 
change this variable.

Speedo
------ defines the valid speeds for operation of this port.  This variable
controls what speeds irmon will allow for selection for the data portion
of an infrared connection.  The bit mask defines the speeds:

   001   2400 baud is valid
   002   9600 baud is valid
   004   19200 baud is valid
   008   38400 baud is valid
   010   57600 baud is valid
   020   115200 baud is valid
   040   576000 baud is valid
   080   1152000 baud is valid
   100   4000000 baud is valid

The 13f above defines all speeds except 576000 (known to be defective) and
1152000 (not currently supported by this driver due to hardware problems 
in my test system.)


3.3 System Parameters Configuration.

The above VCOMM parameters make use of COM3 as the serial port. Make sure
that the COM3 port uses the interrupt that does not conflict with other
system resources. It is a good idea to use Device Manager to reconfigure
the resources of COM3 port to use IRQ5 instead of IRQ4 - UNLESS interrupt
sharing is tested on the particular system. 

It is also important that the IrCC core is configured to use this particular
combination of COM port / Interrupt number.  This configuration is done by
the sytem BIOS or a specialized custom script executed during boot.
 

4. OPERATION

When the IrCC core is configured properly and the VCOMM driver parameters
are set accordingly then it is possible to use Infrared Monitor to 
initialize and test the infrared link between the two stations.

Infrared Monitor is available from Microsoft as a part of Microsoft's 
infrared stack. Infrared Monitor installs into the Control Panel.
When running Infrared Monitor with the Fast IR speeds make sure to 
manually select the "Limit connection speed" option in <Options>
panel of the Infrared Monitor.  All valid speeds (selected by the Speedo
parameter) should be available.

Further communication could be tested using a number of generic or third
party software. For example use Direct Cable Connection to setup the
connection and view shared entities or use Windows Explorer to view
the other station's resources.