Merge commit 'v2.6.39' into 20110526
[linux-2.6.git] / Documentation / sound / oss / AudioExcelDSP16
1 Driver
2 ------
3
4 Information about Audio Excel DSP 16 driver can be found in the source
5 file aedsp16.c
6 Please, read the head of the source before using it. It contain useful
7 information.
8
9 Configuration
10 -------------
11
12 The Audio Excel configuration, is now done with the standard Linux setup.
13 You have to configure the sound card (Sound Blaster or Microsoft Sound System)
14 and, if you want it, the Roland MPU-401 (do not use the Sound Blaster MPU-401,
15 SB-MPU401) in the main driver menu. Activate the lowlevel drivers then select
16 the Audio Excel hardware that you want to initialize. Check the IRQ/DMA/MIRQ
17 of the Audio Excel initialization: it must be the same as the SBPRO (or MSS)
18 setup. If the parameters are different, correct it.
19 I you own a Gallant's audio card based on SC-6600, activate the SC-6600 support.
20 If you want to change the configuration of the sound board, be sure to
21 check off all the configuration items before re-configure it.
22
23 Module parameters
24 -----------------
25 To use this driver as a module, you must configure some module parameters, to
26 set up I/O addresses, IRQ lines and DMA channels. Some parameters are
27 mandatory while some others are optional. Here a list of parameters you can
28 use with this module:
29
30 Name            Description
31 ====            ===========
32 MANDATORY
33 io              I/O base address (0x220 or 0x240)
34 irq             irq line (5, 7, 9, 10 or 11)
35 dma             dma channel (0, 1 or 3)
36
37 OPTIONAL
38 mss_base        I/O base address for activate MSS mode (default SBPRO)
39                 (0x530 or 0xE80)
40 mpu_base        I/O base address for activate MPU-401 mode
41                 (0x300, 0x310, 0x320 or 0x330)
42 mpu_irq         MPU-401 irq line (5, 7, 9, 10 or 0)
43
44 The /etc/modprobe.conf will have lines like this:
45
46 options opl3 io=0x388
47 options ad1848 io=0x530 irq=11 dma=3
48 options aedsp16 io=0x220 irq=11 dma=3 mss_base=0x530
49
50 Where the aedsp16 options are the options for this driver while opl3 and
51 ad1848 are the corresponding options for the MSS and OPL3 modules.
52
53 Loading MSS and OPL3 needs to pre load the aedsp16 module to set up correctly
54 the sound card. Installation dependencies must be written in the modprobe.conf
55 file:
56
57 install ad1848 /sbin/modprobe aedsp16 && /sbin/modprobe -i ad1848
58 install opl3 /sbin/modprobe aedsp16 && /sbin/modprobe -i opl3
59
60 Then you must load the sound modules stack in this order:
61 sound -> aedsp16 -> [ ad1848, opl3 ]
62
63 With the above configuration, loading ad1848 or opl3 modules, will
64 automatically load all the sound stack.
65
66 Sound cards supported
67 ---------------------
68 This driver supports the SC-6000 and SC-6600 based Gallant's sound card.
69 It don't support the Audio Excel DSP 16 III (try the SC-6600 code).
70 I'm working on the III version of the card: if someone have useful
71 information about it, please let me know.
72 For all the non-supported audio cards, you have to boot MS-DOS (or WIN95)
73 activating the audio card with the MS-DOS device driver, then you have to
74 <ctrl>-<alt>-<del> and boot Linux.
75 Follow these steps:
76
77 1) Compile Linux kernel with standard sound driver, using the emulation
78    you want, with the parameters of your audio card,
79    e.g. Microsoft Sound System irq10 dma3
80 2) Install your new kernel as the default boot kernel.
81 3) Boot MS-DOS and configure the audio card with the boot time device
82    driver, for MSS irq10 dma3 in our example.
83 4) <ctrl>-<alt>-<del> and boot Linux. This will maintain the DOS configuration
84    and will boot the new kernel with sound driver. The sound driver will find
85    the audio card and will recognize and attach it.
86
87 Reports on User successes
88 -------------------------
89
90 > Date: Mon, 29 Jul 1996 08:35:40 +0100
91 > From: Mr S J Greenaway <sjg95@unixfe.rl.ac.uk>
92 > To: riccardo@cdc8g5.cdc.polimi.it (Riccardo Facchetti)
93 > Subject: Re: Audio Excel DSP 16 initialization code
94 >
95 > Just to let you know got my Audio Excel (emulating a MSS) working
96 > with my original SB16, thanks for the driver!
97
98
99 Last revised: 20 August 1998
100 Riccardo Facchetti
101 fizban@tin.it