Uniaud for OS/2

Introduction
=============

Uniaud is a Universal Audio Support Driver for OS/2. Uniaud was a project
created by InnoTek Systemberatung GmbH, now hosted by Netlabs.

Uniaud is based on the Linux ALSA project. Uniaud supports a broad range
of PCI audio cards/chipsets, including AC'97 and HDA audio codecs. AC'97
audio codecs will be found in systems with integrated (onboard) audio,
typically built up through 2004. HDA codecs will be found in modern systems
with integrated audio, built during or after 2004.

Uniaud also supports some older audio hardware.


Copyrights and License
======================

Uniaud32
--------
(C) 2000-2002 InnoTek Systemberatung GmbH
(C) 2000-2001 Sander van Leeuwen (sandervl@xs4all.nl)
(c) Copyright IBM Corporation 1990,2000.
All rights reserved.
Copyright (c) 2011-2021 David Azarewicz

Uniaud32 is a derivative work of the IBM DDK.

Parts of Uniaud32 copied from/inspired by the Linux ALSA project;
those parts are (c) Linux ALSA maintainers.

 This program is free software; you can redistribute it and/or modify
 it under the terms of the GNU General Public License as published by
 the Free Software Foundation; either version 2 of the License, or
 (at your option) any later version.

 This program is distributed in the hope that it will be useful,
 but WITHOUT ANY WARRANTY; without even the implied warranty of
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 GNU General Public License for more details.

 You should have received a copy of the GNU General Public License
 along with this program; if not, write to the Free Software
 Foundation, Inc., 59 Temple Place, Suite 330, Boston,
 MA  02111-1307  USA

The source code can be retrieved from http://trac.netlabs.org/uniaud.
In compliance to the GNU General Public License, the source code
can of course be modified/compiled to run on other products as long
as modifications will also be published as outlined in the GNU GPL.

Uniaud16
--------
Copyright (c) IBM Corporation 1994 - 1997.
Copyright (c) 2011-2021 David Azarewicz

Uniaud16 is a derivative work of the IBM DDK. Uniaud16 is not GPL.


Installation
============

The Uniaud distribution comes in a self executing Warpin installer package.
Simply execute to install or update. The installer will automatically
detect if Uniaud is already installed and will choose to either update
the existing installation or create a new installation.

Then simply reboot at the end of the installation. Restarting the desktop
will not suffice, as the driver needs to be loaded from CONFIG.SYS.

WARNING: If you are using ACPI.PSD make sure it is version 3.23.04 or
later or kernel traps may occur when running these drivers.


Driver Command Line Options
===========================

DEVICE=x:\MMOS2\UNIAUD32.SYS /A:0 /V /C:CARDNAME
  - /A:n - Use audio adapter n where the first adapter is 0.
  - /V - Verbose

DEVICE=x:\MMOS2\UNIAUD16.SYS /V /C /M /L
  - /V - Verbose
  - /C - Enable CD output
  - /M - Enable Microphone output
  - /L - Enable Line-In output
Default: /C ((verbose messages; CD output enabled)


Removal
=======

To temporarily disable Uniaud, simply comment the following two lines in
CONFIG.SYS:

DEVICE=x:\MMOS2\UNIAUD32.SYS
DEVICE=x:\MMOS2\UNIAUD16.SYS


To uninstall Uniaud two steps are required. These steps must be
performed in the order shown below.

1. To remove the MMPM configuration, change directory to the
   following directory on your boot drive:
     \MMOS2\INSTALL\UNIAUD

   Then run
     uninstal.exe

2. To remove the files from your disk, run Warpin and uninstall
   the UNIAUD package.

If there is no uninstal.exe program in \MMOS2\INSTALL\UNIAUD, or if there
is no \MMOS2\INSTALL\UNIAUD directory on your system, simply re-install
the latest official Uniaud Warpin package. This will create the necessary
files and then you can use the above procedure to uninstall Uniaud.


Getting Support and Reporting Problems
======================================

Known Problems with v3.01.xx versions
-------------------------------------
* On a T-60, sound only works from a cold boot from power off. The older
  v2.02.06 works okay on a T-60, so if this bothers you please use the
  older version.

More information can be found in the the Uniaud support wiki at:
  https://www.arcanoae.com/wiki/uniaud/

For additional information and to report problems please visit:
  http://trac.netlabs.org/uniaud


Change Log
==========
Uniaud32 v.3.01.03 23-Oct-2021 - David Azarewicz
  Update from Paul Smedley using audio code from Linux v5.14.17

Uniaud32 v.3.01.02 24-Jul-2021 - David Azarewicz
  Update from Paul Smedley using audio code from Linux v5.10.50

Uniaud32 v.3.01.01 18-Mar-2021 - David Azarewicz
  Major update from Paul Smedley using audio code from Linux v5.10.20

Uniaud32 v.2.02.06 06-May-2020 - David Azarewicz
  Some minor mixer updates.

Uniaud32 v.2.02.05 01-Sep-2018 - David Azarewicz
  Removed broken /C switch.
  Added ens1371 driver.

Uniaud32 v.2.02.04 06-Jan-2018 - David Azarewicz
  Misc minor changes for specific Intel HDA systems (From Andy).
  Added limited MSI support.

Uniaud32 v.2.02.03 08-Jun-2017 - David Azarewicz
  Modified adapter selection so only one adapter is selected when /A is used.