Installation Instructions for Creative EMU10K1 drivers (v0.5)
English v1.1
-------------------------------------------------------------

Card support
------------
- Creative Sound Blaster Live!
- Creative Sound Blaster PCI 512

Features
--------
- Open Sound System (OSS) compatible
- Full duplex wave playback/recording functionality (/dev/dsp)
- Simultaneous wave playback streams
- Analog mixer (AC97) support (/dev/mixer)
- MIDI UART support (/dev/midi)
- Joystick interface support (>= 2.2.x kernels only)
- Supports multiple EMU10K1-based cards


Requirements
------------
- The kernel must be compiled:
  - With loadable modules support		(CONFIG_MODULES = y)
  - With soundcard support			(CONFIG_SOUND = y/m)
  - Without any integrated soundcard drivers	(CONFIG_SOUND_* = n)
- "PnP-compatible OS installed" option in BIOS must be disabled
- Recommended system configuration: Min. 200 MHz Pentium-class w/ 32 MB RAM
- Kernel headers matching the kernel for which you are compiling the 
  driver.


Compilation
-----------
To compile the driver, simply type "make" in the main
directory.
Make sure the "KERNELVERSION" option is correctly detected,
if not edit the "Makefile" and manually override it.
This will generate the files "emu10k1.o" and "emu10k1-joy.o".


Installation
------------
1. As root type:

	make install

2. Add a new reference to the driver in /etc/conf.modules:

	alias sound emu10k1

3. Play some sound. The module should be auto-loaded.


If this doesn't work:
1. Determine your kernel sound modules installation location,
   usually /lib/modules/2.x.y/misc

2. Copy the driver to that location:

	cp emu10k1.o emu10k1-joy.o /lib/modules/2.x.y/misc

3. Unload all existing soundcard drivers, including soundcore

4. Remove all old soundcard references from /etc/conf.modules

5. Add a new reference to the driver in /etc/conf.modules:

	alias sound emu10k1
		or
	alias char-major-14 emu10k1

6. Generate module dependencies:

	depmod -a

7. Load the driver:

	modprobe emu10k1

Note for Debians' users: use /etc/modutils directory,
   create file emu10k1 here with the same content as is suggested in
   the paragraph (5.) and run update-modules afterwards - this
   will create the correct /etc/modules.conf file)


Joystick support
----------------
1. Enable the emu10k1 joystick port:

	insmod emu10k1-joy

2. Load the base joystick driver:

	insmod joystick

3. Load the specific joystick driver passing the joystick io port in
   the module options:

	insmod joy-analog js_an=io_port,xx (If you are using an analog joystick)

   You can check the io port value using:

	cat /proc/ioports

   And looking for the line with "emu10k1 joystick".


If the specific joystick driver doesn't let you specify alternative io ports:
1. Enable the emu10k1 joystick port and mirror it at a standard location:

	insmod emu10k1-joy io=0x200

   Possible values are 0x200, 0x208, 0x210, 0x218. If you have several emu10k1
   cards you can pass several options to the module:

	insmod emu10k1-joy io=0x200, 0x210, ...

2. Load base joystick driver:

	insmod joystick

3. Load specific joystick driver:

	insmod joy-analog


Read /usr/src/linux/Documentation/joystick.txt for more info.

Note: The use of this module in kernels 2.3.x is soon to be
deprecated as some improvements to the joystick drivers are
expected.
