Short:    AHI driver for Prelude soundcard, V2.21
Uploader: wenzel@unixserv.rz.fh-hannover.de
Author:   wenzel@unixserv.rz.fh-hannover.de
Type:     hard/drivr
Version:  2.21

==========================================================================
                                  English
==========================================================================


This is an AHI driver for the prelude soundcard. To install, just unpack
the archive into your SYS: partition.

Currently available modes are:
-----------------------------
Prelude:16 bit stereo            Stereo mode using a large buffer and a
                                 standard priority play/rec task

Prelude:16 bit stereo++          Same as above but with panning enabled


Prelude:16 bit stereo realtime   Stereo mode using a small buffer and a
                                 high priority play/rec softint

Prelude:16 bit stereo realtime++ Same as above but with panning enabled

I recommend using the realtime modes unless you experience heavy cpu load.


Legal stuff
-----------
This driver is copyrighted freeware. It may be distributed freely as long
as no modifications are made to the executable and this document. A nominal
fee may be asked to cover distribution costs.

AHI audio system is Copyright ©1994-97 Martin Blom.

Requirements
------------
A Prelude soundcard, of course :-)
AHI audio system V2 or greater
68020 CPU or better

This driver has been successfully tested with
---------------------------------------------
Play16 1.7
AHIRecorder 1.1
Shapeshifter 3.7
HippoPlayer 2.35
DeliTracker 2.27


Revision history
----------------
2.17 - First public release


2.18 - AHI_GetAudioAttrs() returned incorrect value for
       AHIDB_MaxRecordSamples. Fixed.
     - Recording function now makes use of a soft interrupt, too.

2.19 - Fixed a bug that could lead to hangups during initialisation
     - Minor speed improvements


2.20 - Further speed optimizations
     - Enabled auto calibration each time the hardware is allocated

2.21 - Changed buffering scheme to work better with AHI V3
     - Full cooperation with prelude.library
     - Now using a UserTag to distinguish between realtime and non-realtime:
       AHIDB_UserBase+0; TRUE means realtime.


==========================================================================
                                   Deutsch
==========================================================================

Dies ist ein AHI Treiber für die Prelude Soundkarte. Zum installieren,
einfach den Inhalt dieses Archives in die SYS: Partition entpacken.


Derzeitig verfügbare Modi:
--------------------------
Prelude:16 bit stereo            Stereo Modus, der einen großen Puffer und
                                 einen Wiedergabe/Aufnahme-Task mit normaler
                                 Priorität verwendet

Prelude:16 bit stereo++          Wie oben, jedoch zusätzlich mit Balance
                                 Einstellung

Prelude:16 bit stereo realtime   Stereo Modus, der einen kleinen Puffer und
                                 einen Software Interrupt hoher Priorität
                                 für Aufnahme und Wiedergabe verwendet

Prelude:16 bit stereo realtime++ Wie oben, jedoch zusätzlich mit Balance
                                 Einstellung

Ich empfehle, die realtime Modi zu verwenden, solage der Rechenzeitbedarf
des Treibers nicht übermäßig groß wird.


Rechtliches
-----------
Dieser Treiber ist Freeware, unterliegt aber dem Copyright. Er darf frei
vertrieben werden, wenn keine Änderungen am Treiber oder an der Doku-
mentation vorgenommen werden. Ein Unkostenbeitrag in Höhe der Vertriebs-
kosten darf erhoben werden.

Das AHI audio system ist Copyright ©1994-97 Martin Blom.


Voraussetzungen
---------------
Eine Prelude Soundkarte natürlich :-)
AHI audio system V2 oder größer
68020 Prozessor oder besser


Dieser Treiber wurde erfolgreich getestet mit
---------------------------------------------
Play16 1.7
AHIRecorder 1.1
Shapeshifter 3.7
HippoPlayer 2.35
DeliTracker 2.27


Entwicklungsgeschichte
----------------------
2.17 - Erste öffentliche Version


2.18 - AHI_GetAudioAttrs() gab einen falschen Wert für
       AHIDB_MaxRecordSamples zurück. Korrigiert.
     - Die Aufnahme Funktion benutzt jetzt auch einen Software Interrupt.


2.19 - Fehler behoben, der zu Hängern während der Initialisierung führen
       konnte.
     - Kleinere Optimierungen hinsichtlich der Geschwindigkeit


2.20 - Weitere Optimierungen hinsichtlich der Geschwindigkeit
     - Automatische Kalibrierung bei jeder Hardware Initialisierung
       eingeschaltet

2.21 - Prinzip der Pufferung geändert, damit der Treiber besser mit
       AHI V3 zusammenarbeitet
     - Vollständige Zusammenarbeit mit der prelude.library
     - Für die Unterscheidung zwischen Realtime und Non-Realtime wird jetzt
       ein User-Tag verwendet: AHIDB_UserBase+0; TRUE bedeutet Realtime.