Uniaud for OS/2 4, 4.51/4.52 and eComStation 1.0/1.1/1.2/1.2R/2.0
========================================================================

Thank you for downloading Uniaud 
Uniaud is still under development and we need your feedback to improve 
uniaud. Its very important that you also report soundcards that work! 

Uniaud is project created by InnoTek Systemberatung GmbH

Uniaud is based on the Linux ALSA project. Uniaud supports a broad range
of PCI audio cards/chipsets and AC 97 audio codecs. AC 97 audio codecs
you will find in modern systems with a Pentium II or higher build onto the
motherboard. AC 97 depends for a part of the motherboard chipset
and a small audio codec. 

Uniaud supports most audio chipsets on the market. 

How to report bugs
==================

The best option is to use the corresponding debug package for this version
of Uniaud, and UniInfo.zip, both available from Netlabs ftp.

All bug reports should goto Uniaud Trac which 
can be found on: http://svn.netlabs.org/uniaud/report
If you do not have a login, you can login as guest with password netlabs.

Describe your bug briefly. Most importantly include the following files:

1. If your system boots, but you don't get sound or sound is broken
or played to fast, goto an OS/2 command line. And type the following:
"copy alsahlp$ uniaud.log".

2. Next from the command line run "unimix.exe -list >mixer.txt".

3. Download pci.exe Veit Kannegieser from
http://hobbes.nmsu.edu/cgi-bin/h-browse?sh=1&dir=//pub/os2/util/misc
In this directory you will find a file called
pciXXXvka.zip. Where XXX is the version number. Use the search option
in your webbrowser to search this page for the text PCI.
Download this file and unzip it in a directory.
From a command line run PCI.EXE >hardware.txt.
This will generate an overview off all hardware in your system.

When you have entered your bug in Track you can attach the files to
the bug via your web browser.

What todo with a TRAP screen:
=============================

If you get a TRAP (a black screen with for example
TRAP 000e) after you installed UNIAUD. You should only do this
if you have a floppy drive in your system or a memory dump partition
(we provide no support on how to put up this last item).

Press CTRL ALT F10 twice (note never do this on a running system!!). 
You will now be asked to insert a diskette (please note the complete
diskette will be wiped!!). You _only_ need to fill up one diskette
to get the trap screen. Then restart your system, you can run this script:
http://home.earthlink.net/~steve53/os2diags/DumpTrapScreen.zip
to extract the trap s creen from the diskette.


F.A.Q.
=====
Q. What is OS/2?
A1. If You ask this You really don't need UniAud.
A2. Go to: www.eComStation.com.

Q. What is UniAud?
A. The UniAud project is the universal audio driver for OS/2 or eComStation OS,
   based on ALSA project

Q. Uniaud detected my card successfully but no sound
A. Try to install uniaud with amount of installed cards = 0 (see section below)
   reboot and then install uniaud with amount of cards = 1

Q. Uniaud detected my card successfully but when I try to play something I got 
   error: MCI Error 5134: No device driver found.
A. With eComstation 1.2 and 1.2R there, start minstall.exe and choose
   the last option in the main menu to reset your mmecs settings.
   Then reinstall Uniaud. 
   
   With eComStation 1.1/1.0 or MCP 1/2 or Warp 4, choose to uninstall Uniaud
   (read description below in this file). Reboot your system and reinstall 
   Uniaud. 

Q. I installed MIDI support, but when I click on a Midi file I hear no music.
   What is happening ? 

A. Most audio cards don't support MIDI. So if there is no MIDI playback
   its most likely not support by Uniaud in conjunction with your chipset.

How to install Uniaud
========================

If Uniaud is already installed, it is safest to make a backup of your old
drivers and just copy uniaud32.sys and uniaud16.sys over them.

Otherwise:

Start install.cmd and click on click on yes or OK where requested by
minstall. You will get 1 or 2 dialogs where you can toggle the amount 
of installed cards between 0 to 1. This is set by default to 
1 don not change this setting. After minstall is finished reboot your
system.

If you are having loops in the sound (when audio is played).
Or you get lockups of your system or a kerneltrap, do the following.
Restart your system. And when in he upper left hand in the corner
of the screen you see a white little blob. This little blob
is shown before the boot logo (with the OS/2 or eComStation logo is shown).
Press the key combination ALT F1. Then choose from the "Recovery Choices"
choose "F5 full hardware detection".

You can check the so called buildlevel of the Uniaud32.sys
and uniaud16.sys by typing bldlevel.exe driveletter:\MMOS2\UNIAUDXX.SYS
and you will see the buildlevel of the files you have. 
If you already have UNIAUD installed and you have updated drivers
you can copy the UNIAUD16.SYS and UNIAUD32.SYS to \MMOS2 manualy.

How to uninstall Uniaud
========================

If for some reason you are having trouble with Uniaud. Putting a REM in the 
config.sys is not the proper way to uninstall Uniaud. Start 
install.cmd again. Click on yes or OK where asked and for the "amount of
cards" change the 1 into a 0. After minstall is finished.
Reboot your machine. 

If already have minstall installed on your system and you are upgrading
to a new release you don't need to uninstall the old version of Uniaud.

How can I support the project ?
================================

We need your feedback. Make a donation and of course report bugs.
You can always get the latest version of uniaud from:
ftp://ftp.netlabs.org/pub/uniaud/

Making a donation to the project
================================
Via Mensys website you can a make a financial donation:
http://shop.mensys.nl/uk/netlabs


OS/2 Universal Audio Config.sys options:
========================================

DEVICE=D:\MMOS2\UNIAUD32.SYS /V /C:CARDNAME
- /V	Verbose
- /C:CARDNAME
        Where CARDNAME is :
        - SBLIVE      : Sound Blaster Live!
        - CS4281      : Cirrus Logic CS4281
        - ALS4000     : Avance Logic ALS4000
        - CMEDIA      : C-Media CMI8738, CMI8338
        - ICH         : Intel ICHx, NFORCE1/2/3
        - CS46XX      : Cirrus Logic CS4280, CS46XX
        - VIA82XX     : VIA VT82C686A/B/C, VT8233A/C, VT8235
        - ESS1938     : ESS Solo-1 (ESS 1938)
        - MAESTRO     : ESS Maestro1/2/2E, TerraTec DMX
        - MAESTRO3    : ESS Maestro3/Allegro/Canyon3D-2
        - YAMAHA      : Yamaha YMF 724/724F/740/740C/744/754
        - ENSONIQ     : Ensoniq AudioPCI ES1371/73, Creative Labs SB PCI64/128
        - ALI5451     : ALI 5451
        - TRIDENT     : Trident 4D Wave, SI7018
       Force detection of specified audio hardware

DEVICE=D:\MMOS2\UNIAUD16.SYS /V /C /M /L
- /V	Verbose
- /C    Enable CD output
- /M    Enable Microphone output
- /L    Enable Line-In output

