Yamaha TG100
Serial Device Driver
Version 1.3
                         
Overview
--------
The Yamaha Serial Device Driver allows Windows 3.1 users to attach the Yamaha
TG100 to their computer's serial port.  Follow the directions in the manual
concerning cabling and the appropriate switch setting on the rear panel.

Note:
-----
This device driver is only compatible with Windows 3.1.

Hardware Installation
---------------------
Connect the TG100 to the computer using the cable recommended in the 
Reference Manual and set the switch on the back as described in the Reference
Manual.

Note that the driver will not load if the TG100 is not connected to the
specified COM port and/or is not powered on when Windows loads.  The driver
verifies the existence of the TG100 before fully initializing.

Standard mode users should also be aware that due to the way the Windows COM
drivers are written, it is impossible to place the TG100 on a shared
interrupt port.  In ISA bus machines, if there are more than two COM ports,
ports 1 and 3 share interrupt 4 and ports 2 and 4 share interrupt 3.  On MCA 
machines, port 1 uses interrupt 4 and all other ports share interrupt 3.  On
EISA machines either sharing scheme is possible depending on the type of COM
boards used.

Therefore, standard mode users should set the TG100 on COM port 1 to assure 
compatibility and, on ISA or some EISA machines (depending on the type of COM
board) disable COM port 3.

Software Installation
---------------------
To install the device driver, simply bring up the Windows Control Panel
application (typically found in Main group) and select the Drivers icon.
Press the Add button and select the Unlisted or Updated Driver entry from the
list box and press OK.  Respond to Windows prompt concerning the location of
the driver and press OK.  The driver will then display a list of COM ports
available for the TG100.  Select the appropriate COM port and press OK. 
Windows will then ask if you wish to restart Windows.  You must restart
Windows for the installation to be completed.

If you install the driver while running in Standard mode on a 386 and later 
want to run in Enhanced mode, it will be necessary to re-install the driver 
to cause Windows to load the 386 driver files.  If you install the driver in 
Enhanced mode first and later want to run in Standard mode no actions are 
necessary:  Windows will have already loaded all of the necessary files.

Enhanced versus Standard Mode
-----------------------------
Although this driver is capable of supporting Windows in both Standard and
Enhanced Mode, the servicing of interrupts can only be guaranteed while 
running in Enhanced Mode. For this reason it is strongly recommend that Windows
be run in Enhanced Mode while using this driver for both recording and Playback.

* Note: If you are only interested in Playback, then you should have no 
problems running Windows in Standard Mode.

SYSTEM.INI Settings
-------------------
The following values can be defined under the [TG100.DRV] section of your 
SYSTEM.INI file:

SysExWait=nn
------------
Because of the interrupt latency in Windows, it is impossible for slow 
machines to keep up with a SysEx dump a byte at a time.  For this reason, 
when the device driver recognizes that the TG100 is sending a SysEx dump, 
it will hold on to the COM port until the completion of all pieces of a SysEx 
dump.  Upon recognizing the completion of the SysEx dump the driver will pass 
the SysEx data to the MIDI application.  Note that the entire SysEx dump must 
first be received  by the driver before data is passed to the MIDI application.

By default the device driver will wait 40 milliseconds to determine that a 
SysEx dump is complete.  If no more data is received in this time interval 
the data received will then be forwarded to the MIDI application.

You can change this interval by setting the SysExWait setting in the 
TG100.DRV section of the SYSTEM.INI file.  The value given is in 
milliseconds: i.e. SysExWait=100 would cause the driver to wait 100 
milliseconds instead of the default 40 milliseconds.

Users should consider adjusting this value if they are having problems getting 
complete SysEx dumps.

COMPort=n
---------
This specifies which COM port the TG100 is attached to and must appear in 
the TG100.DRV section of the SYSTEM.INI file.

BufferSize=nnnn
---------------
This specifies the number of bytes that should be made available to handling 
SysEx dumps.  This can be any value from 1 to 65535: the default value is 
10240.

Users should consider adjusting this value if they plan on receiving large 
SysEx dumps from MIDI devices attached to the TG100.

MIDIINPersistence=nn
--------------------
This specifies the number of bytes the driver will read from the TG100 
before returning control to Windows (except in the case of SysEx dumps which
are read until the dump time interval specified by the SysExWait expires).  
The default value is 50 which should be adequate for most installations.

