            C-Media OS/2 Audiotreiber Version 0.2.3
            ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Inhalt
======
1.   Beschreibung
2.   Ausstattungsmerkmale
3.   Entwicklungsgeschichte
4.   Voraussetzungen
5.   Installation / Deinstallation
6.   CONFIG.SYS Optionen
7.   Bekannte Probleme
8.   Liste der Dateien
9.   Ungetestete Funktionen
10.  Mitteilungen an den Autor
11.  Gewhrleistung


1. Beschreibung
===============

Dies ist eine Portierung des Open Source Treibers der Firma C-Media 
Electronics, Inc fr Linux. Als Basis diente Sander van Leeuwen's
Soundblaster Live! Projekt. Obwohl der Treiber im Prinzip alle Merkmale
komplett implementiert, sollte man ihn dennoch als Betasoftware betrachten. 
(Siehe Gewhrleistung)


2. Ausstattungsmerkmale
=======================

- Ein Wiedergabekanal fr Waveaudio
- Ein Aufnahmekanal fr Waveaudio
- Gleichzeitige Aufnahme und Wiedergabe
- Untersttzung der IOCTL90 Mixer Schnittstelle (Entwickelt von Joe Nord
  bei Crystal Semiconductor, werden von den Crystal OS/2 Audiotreibern
  verwendet)
- Untersttzung fr vierkanalige Audioausgabe (experimentell)


3. Entwicklungsgeschichte
=========================

0.2.3	- Streambezogene Lautstrkeeinstellung funtioniert jetzt auch 
	  bei Chiprevision 68 (manchmal auch als CMI8768 bezeichnet)

0.2.2	- Unverffentlichte Testversion

0.2.1	- Untersttzung fr Interruptnummern grer 15

0.2.0	- Zustzliche Option um Mikrofonverstrker einzuschalten

0.1.9   - Trap, wenn Applikationen versuchen 0 kHz Sampling Rate zu verwenden.
        - kein Sound in ODIN, sobald ein (ODIN-)Programm abstrzt.

0.1.8	- Aufnehmen von S/P DIF Eingang mglich
	- "C-Media Control" Programm zum Setzen von S/P DIF Optionen
	- Workaround fr verzerrte S/P DIF Ausgabe auf Rev. 39+ Chips
	- Lautstrkeregler fr PC - Lautsprecher
	- Fix fr Fehler bei APM suspend/resume whrend des Abspielens von MIDI

0.1.7	- MMPM/2 MIDI Untersttzung (OPL3 FM Synthese)

0.1.6	- Bootproblem mit Rev. 55 Chips behoben
	- APM Untersttzung
	- DirectSound Interface fr ODIN reaktiviert
	- Workaround fr mglichen Ressourcekonflikt mit COM.SYS

0.1.4	- IOCTL90 Mixercallback untersttzt
	- IOCTL90 Globale Wave-Lautstrkeeinstellung (LBMixer's DAC control)
	  ACHTUNG: Die streambezogene Lautstrkeeinstellung wird dadurch
		   deaktiviert. Ist das nicht gewnscht, mu entsprechende
		   Regler in LBMixer abgeschaltet werden.
	- Mastervolume und Masterbalance einstellbar via LBMixer (-mv)
	- CD-, Line und Aux-Eingnge vollstndig stumm, wenn Lautstrke 0
	- zustzliche Optionen fr den 32bit Treiber (siehe 6.)
	  ACHTUNG: Wird diese Version ber eine ltere installiert, siehe 5.
	- SPDIF-Ausgabe (nur bei 44.1kHz und 48kHz)
	- niedrigere Interruptrate, schnellere Interruptbearbeitung

0.1.3	- DART Untersttzung fr Warp 3
	- Aux Eingang benutzbar
	- Gelegentliches Hngenbleiben diverser MP3 Player behoben
	- Hintere Lautsprecher aktiviert
	- 4-kanalige DART Ausgabe mglich

0.1.1	- Erste ffentliche Betaversion


4. Voraussetzungen
===================

- eCS, OS/2 Warp 4, Warp 3 oder Warp Server for e-Business

- 486er Prozessor (oder hher)

- C-Media CMI8738 Audio Chip als Onboard- oder Soundkarten-
  lsung. Von uns wurden bisher folgende Komponenten gestest:

  Mainboards:	ASUS A7M266
		ECS P3VAP-A+
		IWILL K*266

  Notebooks:	NatureTech 790S

  Soundkarten:	Zoltrix Nightingale
		Leadtek WinFast 4Xsound
		Trust Sound Expert, Item No: 12667


5. Installation / Deinstallation
================================

Folgende Schritte sind zur Installation des Treibers ntig:
- Stellen Sie sicher, da Ihr BIOS den Chip konfiguriert (I/O Adresse
  und IRQ zuordnet). Falls Ihr BIOS eine Einstellung 'PnP OS' oder
  hnlich enthlt, schalten Sie diese aus.
- Entpacken des Archives
- Ausfhren von install.cmd
- 'C-Media 8738 Audio' auswhlen und mit der Installation 
  fortfahren. 
- Starten Sie den Rechner neu.

ACHTUNG:	Wird eine ltere Version "berinstalliert", *VERMEIDEN*
		Sie den Punkt "CONFIG.SYS aktualisieren" in MINSTALL.
		Ansonsten kann es dazu kommen, da der Treiber doppelt
		eingetragen wird.

Zur Deinstallation des Treibers gehen Sie genau so vor wie oben
beschrieben, geben aber Null Karten an wenn das Installationsprogramm
nach der Anzahl der Karten im System fragt.

Um den Joystick Port benutzen zu knnen, mu ein zustzlicher Joystick-
treiber installiert werden.


6. CONFIG.SYS Optionen
======================

DEVICE=J:\MMOS2\CMPCI16.SYS /V /C /M /L /A
- /V: verbose (Ausgabe des Copyrights whrend des Bootens)
- /C: CD Audio Eingang aktivieren
- /M: Mikrophon Eingang aktivieren
- /L: Linein Eingang aktivieren
- /A: Auxin Eingang aktivieren

Die Installation setzt die /V und /C Optionen im CONFIG.SYS Eintrag.


DEVICE=J:\MMOS2\CMPCI32.SYS /V /D /R
- /V: verbose (Ausgabe des Copyrights whrend des Bootens)
- /D: Ausgabe der Start und Endadresse des Treibers
      (Sinnvoll um bei Abstrzen den schuldigen Treiber zu ermitteln 
       (CS:EIP im Trapscreen))
- /R: Hintere Audiokanle auf Line-In Buchse legen
- /S: S/P DIF Ausgabe aktivieren
- /2: zweiten S/P DIF Eingang benutzen
- /I: S/P DIF Eingangssignal invertieren
- /M: Mikrofonverstrker aktivieren


Die Installation setzt die /V Option im CONFIG.SYS Eintrag.


7. Bekannte Probleme
====================

- Absturz in PMMERGE bei der Installation auf einem System mit einem 
  GRADD basierten Grafikkartentreiber (z.B. dem Scitech Displaydoctor).
  Um dies zu umgehen verschieben Sie nach der Auswahl des Treiber das
  Programmfenster rechts fast ganz aus dem Bildschirm und drcken dann Enter.

- Kein Ton durch inaktive Soundkarten Treiber in MMOS2\MMPM2.INI.
  Um diese Problem zu beheben deinstallieren Sie bitte sowohl den C-Media -
  als auch ihren alten Audiotreiber.
  Sie knnen ihren alten Audiotreiber auch manuell entfernen:
        - deinstallieren Sie den C-Media Treiber
        - Editieren Sie die MMOS2\MMPM2.INI Datei
               - Suchen Sie nach dem 'Waveaudio=' Eintrag und lschen alle
                 Namen in der Zeile
               - Suchen Sie nach dem 'Ampmix=' Eintrag und lschen alle
                 Namen in der Zeile
                 (Ergebnis: Waveaudio=
                            Ampmix= 
                 )
        - Installieren Sie erneut den C-Media Treiber
          In der Datei MMOS2\MMPM2.INI Sollte nun Folgendes stehen:
                 Waveaudio=CMEDIAWAVE01
                 Ampmix=CMEDIAAMPMIX01
        - Starten Sie den Rechner neu

- Lautstrke der hinteren Lautsprecher lt sich im Vierkanalmodus nicht 
  einstellen. Fr dieses Problem gibt es zur Zeit noch keine Lsung :-(.
  Vielleicht hat C-Media ja mal ein Einsehen und rckt die Spezifikation
  raus...

- Per-Stream Lautstrkeeinstellung funktioniert nicht, wenn S/P DIF Ausgabe
  aktiviert ist. Dieses Problem tritt nur auf Rev. 39 oder neueren Chips auf.



8. Liste der Dateien
====================

Zur Installation bentiget Dateien:

	install.cmd		Installationsprogramm
	audfiles.scr		Skriptdatei fr minstall.exe
	audplay.ico		Icondatei
	audhelp.hlp		Hilfedatei fr minstall.exe
	cardinfo.dll		Resourcedatei fr minstall.exe
	control.scr		Skriptdatei fr minstall.exe
	midiplay.ico		Icondatei
	cmpci16.sys		16 Bit MMPM/2 Audiotreiber
	cmpci32w4.sys		32 Bit C-Media Audiotreiber, geeignet fr 
				alle Warp 4, Warp 3 und WSeB Fixpacks
	cmpci32kee.sys		32 Bit C-Media Audiotreiber, verwendet das 
				neue KEE API, das ab Warp 4 + Fixpack 13 oder
				Warp Server for e-Business vorhanden ist 
	cmpciset.exe		C-Media Control Applikation
	updini.scr		Skriptdatei fr minstall.exe
	spiinfo.dll		Resourcedatei fr minstall.exe 


9. Ungetestete Funktionen
=========================

Der Treiber enthlt einige Funktionen, die vom Author aufgrund
fehlender Hardware nicht getestet werden konnten. Das sind:

- andere C-Media Chiptypen wie z.B. CMI8338A, CMI8338B und CMI8738B



10. Mitteilungen an den Author
==============================

Wenn Sie einen Fehler in dem Treiber finden, erreichen Sie den Autor
per Email unter:

	r.ihle@s-t.de

Fehlerreports sollten die folgenden Information beinhalten:
- C-Media Chip Typ
- OS/2 Version und Nummer des installierten Fixpacks
- Beschreibung der Vorgehensweise zur Reproduktion des Fehlers
- Die Trap Beschreibung (Registerinhalt) Falls sie einen Absturz melden,
  fgen Sie die /D Option dem CMPCI32.SYS Eintrag in der CONFIG.SYS hinzu
  und schreiben Sie die ausgegeben Start- und Endaddresse des Treibers
  whrend des Bootens auf.

Bitte bedenken Sie, dass der Autor nicht zu Problemen, die nicht offen-
sichtlich vom Treiber herrhren, benachrichtigt werden mchte. 

Senden Sie *KEINE* Mail an die Autoren des Linux Treibers bzw. des SB Live! 
Treibers wegen Problemen mit diesem OS/2 Treiber. Falls es sich herausstellt, 
dass ein Problem in dem Treiber auf einen Fehler in ihrem Quellcode beruht 
wird der Autor sie selbst benachrichtigen.


11 Gewhrleistung
=================

EXCEPT AS OTHERWISE RESTRICTED BY LAW, THIS WORK IS PROVIDED
WITHOUT ANY EXPRESSED OR IMPLIED WARRANTIES OF ANY KIND, INCLUDING
BUT NOT LIMITED TO, ANY IMPLIED WARRANTIES OF FITNESS FOR A
PARTICULAR PURPOSE, MERCHANTABILITY OR TITLE.  EXCEPT AS
OTHERWISE PROVIDED BY LAW, NO AUTHOR, COPYRIGHT HOLDER OR
LICENSOR SHALL BE LIABLE TO YOU FOR DAMAGES OF ANY KIND, EVEN IF 
THEY HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

