
This version (1.03) of the M-Audio Windows device driver contains the following modification and additions.

WINDOWS 3.1 SUPPORT

        The driver now has support for Windows 3.1.

PERFORMANCE ENHANCEMENTS

        This version of the driver has been re-written to use a High
        Performance software interface to the driver.  This interface
        allows the movement of larger amounts of data at higher rates
        while keeping the CPU utilization significantly lower.

MPC DSP LOAD MODULE

        There is now an additional DSP load module named IBMMPC.DSP.  This
        load module gives the driver the ability to concurrently play 11K or
        22K, eight bit, mono wave files with midi and an auxillary input.

MIDI VOICING ENHANCEMENTS

        Additional work has been peformed on the General MIDI voicing for the
        driver.  The voices have been retuned to provide better quality.

DRUM KIT ADDED

        The MIDI support now contains a drum kit for MPC compliance.

BUG FIXES

        Incorrect position data being passed back in wave play and wave record
        has been fixed.

        Reloading of DSP modules for each play no longer performed.

        Fixed bug of playing wave with loop count set to zero.

Cumulative Service Fixes
------------------------

1) Corrects a problem in the device driver interrupt handler that causes
   the system to hang if you exited Windows after playing WAV files and
   the restarted Windows and again tried to play WAV files without
   having rebooted the system in between these steps.

2) Corrects a problem with audio buffer capacity that causes certain
   applications such as Microsoft Video for Windows 1.0 to experience
   audio breakup on playback by adding a user customizable buffer
   control to the driver setup dialog box.

3) Corrects the Microsoft Multimedia Manufacturer and Product ID
   codes for compatibility with thos IDs registered with Microsoft.

4) Corrects the product identification string returned by the driver.

5) Updates the version of the driver to 1.03.

NOTES
       The Audio Adapter's LL/LR out connector contains a hardware
       loop back which is used by the adapter to self test.  The
       output signal from the LL/LR out connector is fed back into the
       LL/LR in connector when there is nothing plugged into either.
       When using Windows, if both the LL/LR in and the LL/LR out
       connectors are empty, you will hear a very tinny, echoing
       sound when the device driver is loaded.  This is due to feedback
       from the LL/LR out to the LL/LR in and back to the Speaker/Headphone
       connector.  To solve the problem, plug something into the LL/LR in
       or LL/LR out connector.  Any mini 3.5mm jack will do, including
       the Y cable that was shipped with the Audio Adapter.


This code is a Windows MME driver for the M-Audio Capture and Playback Adapter.
The support for the IBM M-ACPA consists of nine files.

                        FILE NAME       LOCATION

                        ACPA.DRV        \WINDLL
                       AUDIO.DLL        \WINDLL
                      README.           \WINDLL
                      ACPADD.SYS        \AUDIODD
                     IBMAUDS.DSP        \AUDIODD
                      IBMMPC.DSP        \AUDIODD
                     IBMPCMP.DSP        \AUDIODD
                     IBMPCMR.DSP        \AUDIODD
                    OEMSETUP.INF        \WINDLL

The driver can be installed by using the Windows Installation Applet.  To
install the driver using the Windows control panel driver installation
applet follow the instructions below.



To install a new driver using Windows:

        1.      Edit the "SYSTEM.INI" windows file. Under the driver section,
                remove any "wave=acpa.drv", "midi=acpa.drv", "aux=acpa.drv"
                entry.

        2.      If the ACPA.DRV or AUDIO.DLL exist in your \system
                sub-directory or Windows path, delete them. Delete any files
                with the extention ".dsp" from your Windows path, also delete
                the file ACPA.INI from your windows directory.

        3.      Start Windows and place your diskette in A:.

        4.      Select the Control Panel icon from the Main Group.

        5.      Choose the Drivers icon from the Control Panel.

                The "Installed Drivers" dialog box will appear, displaying a
                list of the installed drivers.

     For Windows 3.0:

        6.      Click on the Add button.

                The "Add Driver" dialog box will appear, listing the
                drivers available on your hard disk.

        7.      Click on the Add Unknown button.

                The "Add Unknown Drivers" dialog box appears, prompting you
                to choose the drive and filename for the driver you want to
                install.  Enter "A:\".  Then click on OK.

                IBM M-Audio Sound Driver will be added to the "Add Driver"
                dialog box.

        8.      Select IBM M-Audio sound driver.  Click on OK.

                Wave, MIDI, and Aux entries for IBM M-Audio sound driver
                will be added to the "Installed Drivers" Dialog Box.

        9.      Click on the Setup button.

                The "IBM ACPA Driver Setup" dialog box will appear.
                Select the appropriate input and output source from the
                dialog box.  Then choose OK.

       10.      Choose Yes to restart Windows for the new settings to take
                effect.

     For Windows 3.1:

        6.      Click on the Add button.

                The "List of Drivers" dialog box will appear, listing the
                drivers available on your hard disk.

        7.      Click on the OK button.

                The "Install Driver" dialog box will appear, prompting you
                to choose the drive and filename for the driver you want to
                install.  Enter "A:\".  Then click on OK.

                The "Add Unlisted or Updated Driver" dialog box will appear.
                The IBM M-Audio Sound Driver is added to this dialog box.

        8.      Select IBM M-Audio sound driver.  Click on OK.

        9.      The "IBM ACPA Driver Setup" dialog box will appear.  Select
                the appropriate input and output source from the dialog
                box.  Then choose OK.

       10.      The "System Setting Change" dialog box will appear.
                Choose Restart Now for the new settings to take
                effect.

Note:
        There is a potential problem that exists with multiple applications
        trying to use the M-AUDIO hardware at the same time from different
        operating system enviroments.  An example of this would be executing
        a Windows Multi-Media application using audio and switching to the
        DOS box and running a DOS application that uses the M-AUDIO hardware.
        The file ACPADD.SYS is used by the driver to serialize the use of the
        hardware.  This will prevent contention for the hardware with any other
        application that uses the ACPADD.SYS or a derivative of it.  In order
        for this scheme to work a modification must be made to the SYSTEM.INI.
        In the SYSTEM.INI under the [drivers] section there should be three
        entries associated with acpa.  The three entries should appear as
        follows:

                wave=acpa.drv
                midi=acpa.drv
                aux=acpa.drv

        The above three lines must be modified to the following:

                wave=acpa.drv wave
                midi=acpa.drv midi
                aux=acpa.drv aux


MIDI Configuration:

        MME uses the MIDI Mapper to support MIDI.  In order for the M-AUDIO
        driver to support MIDI it must be configured to work with the Mapper.
        All modifications are saved in the file midimap.cfg.  Because MME
        does not provide a means of merging data into this file the setup
        must be performed manually.  Before configuring the Mapper
        considerations must be given as to the files that will be used with
        the synthesizer.  MIDI files exist that comply with the Microsoft
        format and with General MIDI format.

        The Microsoft format files actually contain two versions of a song.
        One version resides on the lower tracks, one through ten, and the
        other resides on the higher tracks, thirteen through sixteen.  The
        version on the lower tracks is normally used by what Microsoft
        defines as extended synthesizers having 16-note polyphony and the
        version on the higher tracks is used by what they define as base
        synthesizers having 6-note polyphony.  Each version is complete
        with a percussion track.

        The General MIDI format makes all sixteen tracks available for one
        song.  General MIDI also defines a single track for percussion
        (track ten). General MIDI also defines its polyphony as 24-note.

        The M-AUDIO MIDI synthesizer can be mapped as either a base or
        extended synthesizer with the following implications:

        Mapped as an extended synthesizer.

        If mapped as an extended synthesizer 16 note polyphony can not be
        achieved, however most General MIDI files will play as is.
        Microsoft files will also play as is.

        Mapped as a base synthesizer.

        Most General MIDI files will not play at all. Full 6-note polyphony
        can be achieved.  Microsoft files can be played.

        With the preceeding implications in mind we recommend that you map
        the M-AUDIO MIDI synthesizer as an extended synthesizer.




 To configure the Mapper for an extended synthesizer follow the instructions
 below:


        1.      Start Windows.

        2.      Perform the driver installation instructions above.

        3.      Select the Control Panel icon from the Main Group.

        4.      Choose the MIDI Mapper icon from the Control Panel.

                Depending on the hardware configuration of your system, You
                might get a dialog box displayed at this point warning that
                the current MIDI setup references a MIDI device which is not
                installed in your system.  The warning will ask if you want
                to continue.  Click YES.

        5.      Under Show, select Setups and Click on New.

        6.      In the "New MIDI Setup" dialog box type a name you want to
                call this MIDI mapping (M-AUDIO) in the name field followed
                by a description if desired (IBM M-AUDIO mapping). Click OK.

        7.      A new dialog box labeled MIDI Setup: followed by the name
                you entered in the previous step will be displayed.  Under
                the column labeled 'Port Name' place the mouse cursor on row
                one.  Click on the down arrow to display the options that
                can be selected for the chosen port.  For subsequent rows
                you must first click on the row to get the down arrow to
                display.  Select the option 'IBM M-AUDIO MIDI SYNTH'.  Repeat
                this process for ports two through ten.  Click OK when
                finished.

        8.      The voicing for the M-AUDIO synthesizer has been mapped to
                correspond with that of General Midi mapping.  All of the
                voices should have a one to one mapping, ie. voice 16 of the
                mapper should map to voice 16 of the synthesizer.  This is the
                default mapping so nothing else has to be done.

        9.      These are the only modifications that are needed for the
                Synth module.  Make sure that the name you selected is
                displayed in the name field on the "MIDI Mapper" dialog box.
                If it is not, click on the down arrow in the name field and
                select your name.  If you are using Windows 3.0, click on
                OK to switch to your new Synth module.  If you are using
                Windows 3.1, close the dialog box.


        Note: If you choose to map as a base synthesizer you will need to
        map channels thirteen through sixteen as the IBM M-AUDIO MIDI SYNTH
        and also change the destination of track sixteen to track ten.
        This will map percussion to the right track.



PERFORMANCE

The ability to use all of the M-Audio modes will depend on several factors
relating to your host machine and environment.  These items include host
system speed, channel speed, host processor disk performance (speed and
fragmentation) and memory availability.  Performance problems can be
identified by the following behavior:

1)  Sections of good audio intermixed with noise.

2)  Sections of good audio intermixed with silence.


If you are experiencing problems attempt to alleviate the problem using
the following suggestions:

Record

1)  Make sure that verify is off on disk writes.

2)  Use a VDISK as the file destination of a recording.

3)  Defragment the hard disk before recording.

4)  Record as a foreground activity.


Playback

1)  Move the audio file to a VDISK and play it from that location.

If the above suggestions do not solve the problem a higher performance system
will be required to use the faster data rate modes.  In slower performance
systems lower data rate modes must be used for proper operation.

Cumulative Service considerations
---------------------------------

Using the new user configurable audio buffer control:

The new defaults with this CSD driver for the M-ACPA are perfect for most
user applications.  If, however, you experience a problem with audio
breakup you may be able to correct it by increasing or decreasing the
size of the audio buffer.

To access this new control go to Program Manager under Microsoft Windows
3.1 and open the program group titled "Main".

Start the Control Panel application and then open the "Drivers" icon.

From the "Drivers" icon select the driver for the IBM M-ACPA Driver
and press the "Setup" pushbutton.

At this point you should see the setup dialog window for the M-ACPA
device driver and you should see a "slider" control to make the
audio buffer size smaller or larger by using the mouse to move the
slider index to the left or right.

If you are having audio problems and you want to try changing the
buffer size to correct them follow these rules:

   Make the buffer "smaller" if you have a slower processor like an
   80386DX, 80386SX, or Intel 80386 architecture compatible like an
   IBM 80386SLC.

   Make the buffer "larger" if you have a faster processor like and
   80486DX, 80486SX, 80486SLC, Pentium or Intel 80486 architecture
   compatible microprocessor from another vendor.

In all cases these instructions refer to changing the size relative
to the CSD default size for the buffer.  The new buffer size will
be recorded in the ACPA.INI file in your windows directory and the
new size will be used each time you start Windows.

After selecting a new size press the "OK" pushbutton.

When Windows prompts you to restart the system, select NOT to
restart the system until you are sure the new buffer size is
correct (helps your audio breakup problem).  If you select
NOT to restart Windows at this time you then have an opportunity
to re-run the application and see if the problem has been corrected.

You can follow the procedure several times until you find a buffer
size that works.  If you have moved the buffer size to either of
it's extremes then the problem you are experiencing cannot be corrected
by changing the audio buffer size.  Contact your IBM support center
for further assistance.

If you do find a new buffer size that works for you, shutdown Windows
via the File, Exit menu pulldown on Program Manager to pick up the
new values permantly.


If you have any questions about performing these procedures you can
contact your IBM Multimedia Support center and they can assist you
in this reconfiguration of the audio buffer size.

