AHIdrv-Filesave

This archive contains the example source code of the
infamous AHI FILESAVE driver for programmers who want
to write hardware drivers.
The reason for yet another source is that the original
is too old and does not build anymore without 
substancial changes.
For example: the dependancies are created from SFD 
files. But SFDC-Master on aminet doesn't work with 
the PERL version provided in the SDK. This means that
you have to do it manually. 
There are also a lot of depricated or obsolete calls. 
Another example that AOS4.1 provides a more
convenient way to acquire sysbase in seperate processes.
So instead of another port attempt, this driver was 
build from the ground up for AOS4.1.

Changes since last release:
- Created a new AHI OS4.1 skeleton driver
- Backported filesave driver code 
- Replaced all depricated or obsolete calls
- Added skeleton file for use with idlTool
- Added Codebench project (time to say goodbye to NotePad)

Note: The AOS4.1 SDK provides a tool (sdk:c/MakeAudioMode 
to create audiomode files. In the sdk:documentation/tools/
MakeAudioMode/ directory there is also an example 
.modespec file. 
This FILESAVE driver needs unique values from the audiomode
to select the audio format of the save file. 
Those identifiers are not supported by MakeAudioMode AFAIK. 
This FILESAVE demonstration driver is the only one using it anyways.
If you want to build and test this source then you can use the
FILESAVE Audiomode file in devs:Audiomodes. If you really want 
to you can use the assembly sources in the AHI6 sources on 
aminet to build your own. 

Special thanks to Lyle Hazelwood for guiding me through the process.

Requirements:
- An amiga running AmigaOS4.1 FE Upd2 (obviously :-) )
- SDK V53.30
- Codebench V0.55 (optional but hightly recommended). 

Usage:
- Copy headers to sdk: "Copy AHIdrv-Filesave/SDK_includes/#? 
                                      sdk:local/common/include ALL"
- When you open the codebench project for the first time, 
  it wants to adjust the path to where you have extracted the sources.
  just press Yes and enjoy.
- Backup the filesave.audio file in devs:ahi and copy created to driver 
  to devs:AHI. A reboot is required to activate the new driver. 
- Use "Play a test sound" in the AHI pref that was provided with AOS4.1,
  The "sound" pref from the enhancer software will not play a testsound
  with this driver. If the enhancer software is installed then the old AHI pref
  is backed up in Storage/Enhancer_Software_Vx.x_Backup. Just use it from
  that location to generate the test sound.

Licences:

AHI V6 was released under (L)GPL. But there is an exeption for the 
driver code that was used in this amigaOS4.1. 
Therefore I release this source as public domain.

From COPYING.DRIVERS in the AHI V6 source code:
" As a special exception of the LGPL, AHI sound card drivers do not
need to be GPL or LGPL compatible. Any license is acceptable, and the
source code does not have to be provided.

That being said, driver authors are strongly encouraged to release
their drivers as open source software, for the benefit of the whole
Amiga community. "