| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 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 |