import of upstream 2.4.34.4 from kernel.org
[linux-2.4.git] / Documentation / sound / forte
1
2      forte - an OSS/Lite driver for FortéMedia FM801 sound chips
3      ===========================================================
4
5 This is a driver for cards using the FortéMedia FM801 audio
6 controller.  The Genius Sound Maker Live card and the onboard audio in
7 HP Workstation zx2000 has been tested.
8
9 Both IA-32 and IA-64 architectures are supported, but the driver
10 should work on any platform.
11
12 The FM801 controller supports a variety of AC'97 codecs.  This driver
13 lets the OSS core code figure the codec out, and should thus support
14 any codec with support in the Linux kernel.
15
16 The driver supports /dev/mixer and /dev/dsp for generic OSS audio
17 support.  In general it adheres to the OSS spec to the extent it can
18 be done with the way the hardware works.  The FM801 controller doesn't
19 support scatter-gather, so if the application sets fragment size too
20 low, it puts strict requirements on interrupt processing speed.  The
21 driver tries to compensate by enforcing bigger buffers than requested
22 by the application if the fragment size is low.
23
24 The forte driver includes both standard read()/write() and the
25 unsupported mmap() interface used by Quake.  mmap() is only supported
26 in playback mode.
27
28 U8 and S16 audio formats are supported, mono/stereo, as well as most
29 all sample rates implemented by the chip.  Default is 48 KHz, 16-bit,
30 mono.
31
32 MIDI, FM audio, and the gameport controller are not currently
33 supported.
34
35
36 The latest version of this driver can be found at:
37
38     http://mkp.net/forte/
39
40
41 Martin K. Petersen, July 2002