Linux-2.6.12-rc2
[pandora-kernel.git] / Documentation / sound / oss / ESS
1 Documentation for the ESS AudioDrive chips
2
3 In 2.4 kernels the SoundBlaster driver not only tries to detect an ESS chip, it
4 tries to detect the type of ESS chip too. The correct detection of the chip 
5 doesn't always succeed however, so unless you use the kernel isapnp facilities
6 (and you chip is pnp capable) the default behaviour is 2.0 behaviour which
7 means: only detect ES688 and ES1688.
8
9 All ESS chips now have a recording level setting. This is a need-to-have for
10 people who want to use their ESS for recording sound.
11
12 Every chip that's detected as a later-than-es1688 chip has a 6 bits logarithmic
13 master volume control.
14
15 Every chip that's detected as a ES1887 now has Full Duplex support. Made a 
16 little testprogram that shows that is works, haven't seen a real program that
17 needs this however.
18
19 For ESS chips an additional parameter "esstype" can be specified. This controls
20 the (auto) detection of the ESS chips. It can have 3 kinds of values:
21
22 -1   Act like 2.0 kernels: only detect ES688 or ES1688.
23 0        Try to auto-detect the chip (may fail for ES1688)
24 688  The chip will be treated as  ES688
25 1688  ,,  ,,   ,,  ,,    ,,   ,, ES1688
26 1868  ,,  ,,   ,,  ,,    ,,   ,, ES1868
27 1869  ,,  ,,   ,,  ,,    ,,   ,, ES1869
28 1788  ,,  ,,   ,,  ,,    ,,   ,, ES1788
29 1887  ,,  ,,   ,,  ,,    ,,   ,, ES1887
30 1888  ,,  ,,   ,,  ,,    ,,   ,, ES1888
31
32 Because Full Duplex is supported for ES1887 you can specify a second DMA
33 channel by specifying module parameter dma16. It can be one of: 0, 1, 3 or 5.
34