Installation Instructions for Creative EMU10K1 drivers (v0.13)
English v1.3
-------------------------------------------------------------

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

Note: Some of the more recent models are not fully supported.
      Cards which share a common jack for analog and digital output
      (models?) only work in analog mode (these are common in Gateway
      machines).
      Also most of the new features in 5.1 models are not supported,
      for now they are no better than the older models, under linux.

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 emu10k1 soundcard drivers	(CONFIG_SOUND_EMU10K1 = m/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 "ac97_codec.o" (and
"emu10k1-joy.o" for 2.2 kernels).


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.

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 (only for 2.2 kernels)
---------------------------------------
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: You should not use this module with 2.4 kernels. Look for
joystick support in the kernel configuration menus.
