Short:    AHI driver for Prelude(1200) v2.31
Uploader: wenzel@act-net.com (Thomas Wenzel)
Author:   wenzel@act-net.com (Thomas Wenzel)
Type:     hard/drivr
Version:  2.31

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


This is an AHI driver for the prelude soundcard (classic as well as 1200
version). To install, just unpack the archive into your SYS: partition or
run the included installer script.

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

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


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

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

Prelude:HiFi 16 bit stereo realtime   Same as Fast version but this one
                                      uses the HiFi mixing routines of AHI

Prelude:HiFi 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-98 Martin Blom.

Requirements
------------
A Prelude soundcard, of course :-)
prelude.library V2.41 or higher
AHI audio system V2 or higher
68020 CPU or better

This driver has been successfully tested with
---------------------------------------------
AmigaAMP 2.6
Play16 1.8
AHIRecorder 1.5
Shapeshifter 3.7
HippoPlayer 2.35
DeliTracker 2.27 with AHI noteplayer 1.8


Revision history
----------------
2.31 - The driver now keeps its fingers off the main (hardware) playback
       volume setting. That's the task of the mixer!

2.30 - Fixed some startup bugs causing trouble if the hardware
       was already in use

2.29 - Fixed a bug in the Prelude1200 recording routine
     - Removed the non-realtime modes

2.28 - Added support for the new Prelude1200 soundcard

2.27 - For Your Ears Only, two new frequencies: 54.86 kHz and 64 kHz!

2.26 - Configurable IRQ data transfer size (prelude.library 2.41 and up)

2.25 - Added HiFi modes
       Better calibration and offset correction for recording

2.24 - Split up the Mic input into MicLo and MicHi. Both are physically
       the same input but MicHi has extra 20dB gain. (Mic pre-amplifier)

2.23 - Trying to open the driver without a Prelude present lead to crashes.
       Fixed.

2.22 - Oops! Fullduplex didn't work. Sorry, now it's fixed!

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.

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

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

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

2.17 - First public release

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

Dies ist ein AHI Treiber für die Prelude Soundkarte (sowohl die Zorro-
als auch die A1200-Variante). Zum installieren, einfach den Inhalt dieses
Archives in die SYS: Partition entpacken oder das Installskript ausführen.


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

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

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

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

Prelude:HiFi 16 bit stereo realtime   Wie die "Fast" version, benutzt jedoch    
                                      die HiFi Mixing-Routinen von AHI         

Prelude:HiFi 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-98 Martin Blom.


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


Dieser Treiber wurde erfolgreich getestet mit
---------------------------------------------
AmigaAMP 2.6
Play16 1.8
AHIRecorder 1.5
Shapeshifter 3.7
HippoPlayer 2.35
DeliTracker 2.27 mit AHI Noteplayer 1.8


Entwicklungsgeschichte
----------------------
2.31 - Der Treiber läßt jetzt die Finger von der Haupt-Wiedergabelautstärke.
       Es ist Sache des Mixers, dies zu ändern!

2.30 - Fehler in der Initialisierung behoben, der zu Problemen bei
       mehrfachem Öffnen geführt hat

2.29 - Fehler in der Prelude1200-Aufnahmeroutine beseitigt
     - Non-realtime Modi entfernt

2.28 - Unterstützung der neuen Prelude1200 Soundkarte hinzugefügt

2.27 - For Your Ears Only, neue Abtastraten: 54.86 kHz and 64 kHz!

2.26 - Konfigurierbare IRQ-Datentransfergröße (ab prelude.library 2.41)

2.25 - HiFi Modi hinzugefügt
       Bessere Kalibrierung und Offsetkorrektur für Aufnahme

2.24 - Den Mic Eingang in MicLo und MicHi aufgeteilt. Beides ist
       physikalisch der gleiche Eingang, aber bei MicHi ist zusätzlich
       der 20dB Mikrofon-Vorverstärker eingeschaltet.

2.23 - Der Versuch, den Treiber ohne vorhandene Prelude zu öffnen, hat zu
       Abstürzen geführt. Korrigiert.

2.22 - Ups! Fullduplex hat nicht funktioniert. Entschuldigung, jetzt geht's!

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.

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

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

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.17 - Erste öffentliche Version
