Merge git://git.kernel.org/pub/scm/linux/kernel/git/bunk/trivial
[linux-2.6] / Documentation / sound / oss / AD1816
1 Documentation for the AD1816(A) sound driver
2 ============================================
3
4 Installation:
5 -------------
6
7 To get your AD1816(A) based sound card work, you'll have to enable support for
8 experimental code ("Prompt for development and/or incomplete code/drivers")
9 and isapnp ("Plug and Play support", "ISA Plug and Play support"). Enable
10 "Sound card support", "OSS modules support" and "Support for AD1816(A) based
11 cards (EXPERIMENTAL)" in the sound configuration menu, too. Now build, install
12 and reboot the new kernel as usual.
13
14 Features:
15 ---------
16
17 List of features supported by this driver:
18 - full-duplex support
19 - supported audio formats: unsigned 8bit, signed 16bit little endian, 
20                            signed 16bit big endian, ยต-law, A-law
21 - supported channels: mono and stereo
22 - supported recording sources: Master, CD, Line, Line1, Line2, Mic
23 - supports phat 3d stereo circuit (Line 3)
24
25
26 Supported cards:
27 ----------------
28
29 The following cards are known to work with this driver:
30 - Terratec Base 1 
31 - Terratec Base 64 
32 - HP Kayak 
33 - Acer FX-3D
34 - SY-1816 
35 - Highscreen Sound-Boostar 32 Wave 3D
36 - Highscreen Sound-Boostar 16 
37 - AVM Apex Pro card 
38 - (Aztech SC-16 3D) 
39 - (Newcom SC-16 3D) 
40 - (Terratec EWS64S) 
41
42 Cards listed in brackets are not supported reliable. If you have such a card 
43 you should add the extra parameter:
44   options=1
45 when loading the ad1816 module via modprobe. 
46
47
48 Troubleshooting:
49 ----------------
50
51 First of all you should check, if the driver has been loaded
52 properly.
53
54 If loading of the driver succeeds, but playback/capture fails, check
55 if you used the correct values for irq, dma and dma2 when loading the module.
56 If one of them is wrong you usually get the following error message:
57
58 Nov  6 17:06:13 tek01 kernel: Sound: DMA (output) timed out - IRQ/DRQ config error?
59
60 If playback/capture is too fast or to slow, you should have a look at
61 the clock chip of your sound card. The AD1816 was designed for a 33MHz
62 oscillator, however most sound card manufacturer use slightly
63 different oscillators as they are cheaper than 33MHz oscillators. If
64 you have such a card you have to adjust the ad1816_clockfreq parameter
65 above. For example: For a card using a 32.875MHz oscillator use
66 ad1816_clockfreq=32875 instead of ad1816_clockfreq=33000.
67
68
69 Updates, bugfixes and bugreports:
70 --------------------------------
71
72 As the driver is still experimental and under development, you should
73 watch out for updates.  Updates of the driver are available on the
74 Internet from one of my home pages:
75   http://www.student.informatik.tu-darmstadt.de/~tek/projects/linux.html
76 or:
77   http://www.tu-darmstadt.de/~tek01/projects/linux.html
78
79 Bugreports, bugfixes and related questions should be sent via E-Mail to:
80   tek@rbg.informatik.tu-darmstadt.de
81
82 Thorsten Knabe <tek@rbg.informatik.tu-darmstadt.de>
83 Christoph Hellwig <hch@infradead.org>
84         Last modified: 2000/09/20