a few files useful when creating installation packages of this driver

git-svn-id: file:///srv/svn/repos/haiku/trunk/current@6898 a95241bf-73f2-0310-859d-f6bbb57e9c96
2004-03-04 23:38:41 +00:00
parent 7b83e8b24c
commit b335aba0e1
3 changed files with 185 additions and 0 deletions
@@ -0,0 +1,74 @@
+ICH AC97 driver
+==========
+
+This is a AC97 sound driver for certain chipsets.
+
+It does provide sound playback, but not recording.
+
+The driver is known to work with the following chipsets:
+	Intel ICH, ICH1, ICH2, ICH3, ICH4,
+	NVIDIA nForce (MCP), NVIDIA nForce 2 (MCP2)
+	and SIS 7012.
+
+The driver may work with the following chipsets:
+	AMD 8111, AMD 768.
+
+VIA and SIS 7018 chipsets are not supported.
+
+Author: Marcus Overhagen.
+Email: [email protected]
+
+If your Computer Crashes
+================
+
+If your computer crashes, you may want to remove the driver. 
+
+Reboot and hold down the space bar during booting. 
+Select "select save mode options", press enter.
+Select "Disable user add-ons", press enter to activate it
+Select "Return to main menu", press enter.
+Select "Continue booting", press enter
+Remove the driver file, using the uninstall.sh script.
+Reboot 
+
+How to Use
+========
+
+Run the install.sh script to install the driver.
+
+Open Media Preferences.
+Make sure Realtime audio is enabled.
+Restart the Media Services.
+After restart is completed:
+	select "AC97 (ICH)" as default Audio Output.
+	select "None In" as default Audio Input.
+Restart Media Services.
+
+Disclaimer
+=======
+
+Use at your own risk!
+
+If the Driver Doesn't Work
+================
+
+If the driver doesn't work, you may need to alter some
+settings in your computer's BIOS.
+1) If there is a BIOS option to select the operating system, 
+select "Other". Do not select "Windows98 / Windows 2000".
+2) If there is a BIOS option called "PnP OS installed" select "No"
+or "Disabled". Do not select "Yes" or "Enabled".
+3) If there is a BIOS option called "AC97 audio" select "Auto"
+or "Enabled". Do not select "Disabled".
+4) If there is a BIOS option to assign an IRQ to "INT2" or "PINB",
+make sure it is set to "Auto" or a free IRQ. Do not use "none".
+5) It may also help to enable a "AC97 modem" option.
+
+6) If you can't get it working, send me an email.
+I will send you a version that has debugging support included.
+After you get it, install it. Then send me a second email. 
+Make sure that you attach the file ich_ac97.log that is created
+in your home directory every time the driver is loaded. It
+includes important debug information, like the kind of codec used.
+Include the name of your motherboard and it's chipset, a URL
+to the board on it's manufactor's website would be nice.
@@ -0,0 +1,78 @@
+#!/bin/sh
+
+answer=`alert "
+
+Please read the readme file first!
+
+
+It contains recovery instructions, which you will need if your computer crashes, freezes or fails to start.
+
+
+Do you really want to install the ICH AC97  driver now?" "No" "Yes"`
+
+
+if [ $answer == "No" ]
+then
+	alert "ICH AC97 driver NOT installed!" "OK"
+	exit
+fi
+
+if [ -e /boot/beos/system/add-ons/kernel/drivers/bin/i801 ]
+then
+    answer=`alert "The default BeOS ICH AC97 driver (i801) needs to be disabled. 
+It will be restored if you uninstall this driver using the uninstall.sh file." "Abort" "OK"`
+    if [ $answer == "Abort" ]
+    then
+        alert "ICH AC97 driver NOT installed!" "OK"
+        exit
+    fi
+    curdir=`dirname "$0"`
+    if [ "$curdir" == "." ]
+    then
+        curdir=`pwd`
+    fi
+    cd /boot/beos/system/add-ons/kernel/drivers/bin
+    zip i801.zip i801  
+    rm i801
+    cd $curdir
+fi
+
+if [ -e ~/config/add-ons/kernel/drivers/dev/audio/old/ich_ac97 ]
+then
+    rm ~/config/add-ons/kernel/drivers/dev/audio/old/ich_ac97
+fi
+
+if [ -e ~/config/add-ons/kernel/drivers/dev/audio/multi/ich_ac97 ]
+then
+    rm ~/config/add-ons/kernel/drivers/dev/audio/multi/ich_ac97
+fi
+
+if [ -e ~/config/add-ons/kernel/drivers/bin/ich_ac97 ]
+then
+    rm ~/config/add-ons/kernel/drivers/bin/ich_ac97
+fi
+
+cp -v `dirname "$0"`/ich_ac97 ~/config/add-ons/kernel/drivers/bin 
+ln -v -s ~/config/add-ons/kernel/drivers/bin/ich_ac97 ~/config/add-ons/kernel/drivers/dev/audio/multi/ich_ac97
+
+kill -9 Media
+kill -9 media_server
+sleep 1
+kill -9 media_addon_server
+kill -9 audio_server
+sleep 1
+
+rescan ich_ac97
+
+alert "
+Installation Complete.
+
+Start the Media Server now.
+
+Enable Realtime audio. 
+Select 'AC97 (ICH)' as output and 'None In' as input. 
+
+Now restart the Media Services.
+Read the readme file if you experience problems."
+
+/boot/beos/preferences/Media &
@@ -0,0 +1,33 @@
+#!/bin/sh
+
+answer=`alert "Do you really want to remove the ICH_AC97 driver now?" "No" "Yes"`
+if [ $answer == "No" ]
+then
+	alert "ICH AC97 driver NOT uninstalled!" "OK"
+	exit
+fi
+
+if [ -e ~/config/add-ons/kernel/drivers/dev/audio/old/ich_ac97 ]
+then
+    rm ~/config/add-ons/kernel/drivers/dev/audio/old/ich_ac97
+fi
+
+if [ -e ~/config/add-ons/kernel/drivers/dev/audio/multi/ich_ac97 ]
+then
+    rm ~/config/add-ons/kernel/drivers/dev/audio/multi/ich_ac97
+fi
+
+if [ -e ~/config/add-ons/kernel/drivers/bin/ich_ac97 ]
+then
+    rm ~/config/add-ons/kernel/drivers/bin/ich_ac97
+fi
+
+if [ -e /boot/beos/system/add-ons/kernel/drivers/bin/i801.zip ]
+then
+    cd /boot/beos/system/add-ons/kernel/drivers/bin
+    unzip i801.zip  
+    rm i801.zip
+    cd `dirname "$0"`
+fi
+
+alert "ICH AC97 driver removed! Restart media services to stop it if it's still running." "OK"