home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / midi / fmsyn104.zip / README.TXT < prev    next >
Text File  |  1993-09-10  |  8KB  |  181 lines
  1. FM Midi Synth driver Version 1.04
  2. Copyright (c) 1993 by Jamie O'Connell
  3.  
  4. The FM MIDI Synth driver is a replacement driver for sound 
  5. cards that implement FM synthesis.  It features an extensive 
  6. MIDI implementation as well as support for loadable instrument 
  7. banks and a Control Panel applet for run-time configuration of 
  8. driver parameters.  It is designed to work with as many 
  9. different sound cards from various manufacturers as possible. 
  10.  
  11. Installing the FM MIDI Synth driver
  12.  
  13. The first step is to unzip the FM Synth driver and related
  14. files (including the one you are reading) to either a
  15. diskette, or a directory on your hard drive.  The driver
  16. will be installed from this location (make note of the disk
  17. and/or directory name).
  18.  
  19. More hardware configuration parameters are provided than are
  20. available for most drivers.  In order to optimally configure
  21. the FM Synth driver, it is important to have prior knowledge
  22. of the hardware configuration of your sound card.
  23.  
  24. The FM Synth driver is installed via the Windows Control
  25. Panel Drivers applet.  The following steps are performed
  26. when installing a new driver:
  27.  
  28. 1) Remove any existing FM driver.  It is recommended that 
  29. any existing FM driver be removed before installation is
  30. attempted.  While it is possible to have more than one FM
  31. driver installed, it is essential that only one be in use
  32. at a given time.  Note: Only the FM driver should need 
  33. removal, not the Wave, MIDI or Aux. driver.  To remove a 
  34. driver, open the Drivers applet, select the FM driver to 
  35. remove (this could be the Adlib driver, the SB Pro 2 FM 
  36. Synth, the Voyetra OPL3 FM driver, or some other name).  
  37. Press the remove button and answer OK to the dialog box 
  38. which warns that the driver may be needed by the system.
  39.  
  40. 2) Restart Windows.  After removing a driver, you must
  41. restart or exit Windows before adding the FM Synth driver.
  42. This is because the driver has only been removed from the
  43. SYSTEM.INI file, and is still present in memory -- a new
  44. driver can not be loaded until the current one is remove
  45. from memory.
  46.  
  47. 3) Install the FM Synth driver.  Open the Drivers applet
  48. from the Control Panel and press the Add button.  Select
  49. Unlisted or Updated Driver from the list and press the OK
  50. button.  Type the full directory name, or floppy drive (ex:
  51. B:\ or C:\NEWDRV or wherever you put it) of the location
  52. where the driver resides into the dialog box and press OK.
  53. A dialog box containing the name: Jamie O'Connell - FM Synth
  54. MIDI Driver will be presented.  Ensure that it selected and 
  55. press OK.
  56.  
  57. Note: If you receive a message stating that the CTL3DV2.DLL
  58. driver is already on the system, or a message stating that 
  59. the driver is in use (when you know you've removed it and 
  60. restarted), don't despair!  The message simply refers to the
  61. fact that some other application is currently using the 
  62. CTL3DV2.DLL file.  The driver has most likely been 
  63. successfully installed: don't restart yet.  Repeat the 3rd 
  64. installation step, but this time select Current, when asked 
  65. whether to use a New or Current driver.
  66.  
  67. Next the FM Synth hardware configuration dialog is
  68. displayed.  This dialog only needs to be filled out once,
  69. but the selections are critical to proper driver operation
  70. (the dialog can be opened again later, if required, by
  71. opening Drivers, selecting the FM MIDI Synth and pressing
  72. the Setup button).
  73.  
  74. Note: when re-installing a newer version of the FM Synth 
  75. driver, you must first remove the older version as detailed 
  76. above.
  77.  
  78. Configuration
  79.  
  80. The FM Synth Setup dialog contains two sections: I/O Port
  81. Address and sound card FM chip type.
  82.  
  83. I/O Port Address
  84.  
  85. The I/O Port Address is the physical port of the FM sound
  86. chip.  In some sound cards this may be different from the
  87. cards base address.  For instance, the original Sound
  88. Blaster 1.5 has a base port address of 220 hex, but the FM
  89. chips are located at port address 228 hex.  You would choose
  90. port 228 for this card.
  91.  
  92. FM Chip Type
  93.  
  94. The FM chip type depends on which card you posses.  The
  95. earliest Adlib and Sound Blaster FM Cards contained a single
  96. Yamaha OPL2 sound chip.  The first version of the Sound
  97. Blaster Pro added a second OPL2 chip.  Early Media Vision
  98. Pro Audio Spectrum cards also have the 2 OPL2 configuration.
  99. Newer sound cards, including the SB Pro 2, and the MV PAS 16
  100. use a single Yamaha OPL3 chip.  The OPL3 contains the
  101. equivalent of 2 OPL2 chips plus some other features such as
  102. 4 Operator support.  Almost all sound cards implement Adlib
  103. compatibility: Port: 388 hex, 1 OPL2 chip, though choosing
  104. this setting may reduce the capabilities of the driver (The
  105. Adlib is a mono only card capable of 9 melodic, and 5
  106. percussive simultaneous voices).
  107.  
  108. It should be noted that the FM Synth driver does not require
  109. knowledge of either the DMA or IRQ for the sound card, as
  110. these are only used for the digital sound, and MIDI portions
  111. of the cards.  Following is a table of settings for some
  112. common sound cards with factory setup configurations.  If
  113. your card is not listed, or has been changed from the
  114. factory setup, consult the user manual issued with the card:
  115.  
  116. Name                I/O Port    Chip
  117.                     (hex)       Type
  118. --------------------------------------
  119. Adlib FM Card       388         1 OPL2
  120. Sound Blaster 1.5   228         1 OPL2
  121. Sound Blaster Pro   220         2 OPL2
  122. (original)
  123. Sound Blaster Pro 2 220         1 OPL3
  124. MV PAS (original)   388         2 OPL2
  125. MV Pro Audio        388         1 OPL3
  126. Spectrum 16
  127.  
  128. If the Port address for your card is not listed in the
  129. dialog box, select Other and type the hexadecimal port
  130. address into the edit field.  Next choose the chip type and
  131. press the OK button.  If an FM chip is detected, the dialog
  132. box will close, and a restart warning is issued.  Go ahead
  133. and restart Windows once again.  If an FM chip is not
  134. detected, a message stating that the hardware settings on
  135. the card do not match the selected driver I/O Port address
  136. is issued.  In this case, you must change the I/O Port
  137. Address setting -- as stated before, Port 388 can almost
  138. always be specified.
  139.  
  140. After restarting Windows, a Control Panel applet, FM Synth,
  141. will be available for run-time configuration.  A Windows
  142. help file is attached to a button on the applet.
  143.  
  144. Programming the driver
  145.  
  146. See the SYSEX.TXT file for System Exclusive information.
  147. In addition there is a limited programming interface.  
  148. See the STMB.H or STMB.PAS files for more information.
  149.  
  150. Changes 
  151.  
  152. Version 1.01 repairs a bug caused when the driver was handed
  153. illegal MIDI data.  In addition, the default is to now NOT
  154. switch percussion mode off and on for channel 10, upon
  155. receipt of program change 127 or 126.  If you would like
  156. this behavior, add to the [Mode] section of the FMSYNTH.INI 
  157. (in the Windows directory) the followinfg switch switch:
  158.  
  159.   [Mode]
  160.   OldPercSwitch=1   
  161.  
  162. Also see the CHGFMSYN.TXT file for additional information. 
  163.  
  164. Getting Help
  165.  
  166. If you experience problems when using the driver, or have suggestions 
  167. about the program, documentation, etc., you can contact me directly or 
  168. post messages here in the Sound Card section of Compuserve's Sight & 
  169. Sound or MIDI forums.  I'll be monitoring the sections, and keeping the 
  170. latest driver versions there.
  171.  
  172.     Jamie O'Connell [73030,351]
  173.  
  174.  
  175. DISCLAIMER
  176.  
  177. This program is provided without any warranty, expressed or implied,
  178. including but not limited to fitness for a particular purpose.
  179.  
  180.  
  181.