firewire: core: fix fw_send_request kerneldoc comment
[firewire-audio.git] / sound / isa / als100.c
blob5fd52e4d707998769f317b8dbbaf3d7e0839f9f4
2 /*
3 card-als100.c - driver for Avance Logic ALS100 based soundcards.
4 Copyright (C) 1999-2000 by Massimo Piccioni <dafastidio@libero.it>
6 Thanks to Pierfrancesco 'qM2' Passerini.
8 This program is free software; you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation; either version 2 of the License, or
11 (at your option) any later version.
13 This program is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with this program; if not, write to the Free Software
20 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
23 #include <linux/init.h>
24 #include <linux/wait.h>
25 #include <linux/time.h>
26 #include <linux/pnp.h>
27 #include <linux/moduleparam.h>
28 #include <sound/core.h>
29 #include <sound/initval.h>
30 #include <sound/mpu401.h>
31 #include <sound/opl3.h>
32 #include <sound/sb.h>
34 #define PFX "als100: "
36 MODULE_AUTHOR("Massimo Piccioni <dafastidio@libero.it>");
37 MODULE_DESCRIPTION("Avance Logic ALS1X0");
38 MODULE_LICENSE("GPL");
39 MODULE_SUPPORTED_DEVICE("{{Avance Logic,ALS100 - PRO16PNP},"
40 "{Avance Logic,ALS110},"
41 "{Avance Logic,ALS120},"
42 "{Avance Logic,ALS200},"
43 "{3D Melody,MF1000},"
44 "{Digimate,3D Sound},"
45 "{Avance Logic,ALS120},"
46 "{RTL,RTL3000}}");
48 static int index[SNDRV_CARDS] = SNDRV_DEFAULT_IDX; /* Index 0-MAX */
49 static char *id[SNDRV_CARDS] = SNDRV_DEFAULT_STR; /* ID for this card */
50 static int enable[SNDRV_CARDS] = SNDRV_DEFAULT_ENABLE_ISAPNP; /* Enable this card */
51 static long port[SNDRV_CARDS] = SNDRV_DEFAULT_PORT; /* PnP setup */
52 static long mpu_port[SNDRV_CARDS] = SNDRV_DEFAULT_PORT; /* PnP setup */
53 static long fm_port[SNDRV_CARDS] = SNDRV_DEFAULT_PORT; /* PnP setup */
54 static int irq[SNDRV_CARDS] = SNDRV_DEFAULT_IRQ; /* PnP setup */
55 static int mpu_irq[SNDRV_CARDS] = SNDRV_DEFAULT_IRQ; /* PnP setup */
56 static int dma8[SNDRV_CARDS] = SNDRV_DEFAULT_DMA; /* PnP setup */
57 static int dma16[SNDRV_CARDS] = SNDRV_DEFAULT_DMA; /* PnP setup */
59 module_param_array(index, int, NULL, 0444);
60 MODULE_PARM_DESC(index, "Index value for als100 based soundcard.");
61 module_param_array(id, charp, NULL, 0444);
62 MODULE_PARM_DESC(id, "ID string for als100 based soundcard.");
63 module_param_array(enable, bool, NULL, 0444);
64 MODULE_PARM_DESC(enable, "Enable als100 based soundcard.");
66 struct snd_card_als100 {
67 int dev_no;
68 struct pnp_dev *dev;
69 struct pnp_dev *devmpu;
70 struct pnp_dev *devopl;
71 struct snd_sb *chip;
74 static struct pnp_card_device_id snd_als100_pnpids[] = {
75 /* ALS100 - PRO16PNP */
76 { .id = "ALS0001", .devs = { { "@@@0001" }, { "@X@0001" }, { "@H@0001" } } },
77 /* ALS110 - MF1000 - Digimate 3D Sound */
78 { .id = "ALS0110", .devs = { { "@@@1001" }, { "@X@1001" }, { "@H@1001" } } },
79 /* ALS120 */
80 { .id = "ALS0120", .devs = { { "@@@2001" }, { "@X@2001" }, { "@H@2001" } } },
81 /* ALS200 */
82 { .id = "ALS0200", .devs = { { "@@@0020" }, { "@X@0020" }, { "@H@0001" } } },
83 /* ALS200 OEM */
84 { .id = "ALS0200", .devs = { { "@@@0020" }, { "@X@0020" }, { "@H@0020" } } },
85 /* RTL3000 */
86 { .id = "RTL3000", .devs = { { "@@@2001" }, { "@X@2001" }, { "@H@2001" } } },
87 { .id = "", } /* end */
90 MODULE_DEVICE_TABLE(pnp_card, snd_als100_pnpids);
92 #define DRIVER_NAME "snd-card-als100"
94 static int __devinit snd_card_als100_pnp(int dev, struct snd_card_als100 *acard,
95 struct pnp_card_link *card,
96 const struct pnp_card_device_id *id)
98 struct pnp_dev *pdev;
99 int err;
101 acard->dev = pnp_request_card_device(card, id->devs[0].id, NULL);
102 if (acard->dev == NULL)
103 return -ENODEV;
105 acard->devmpu = pnp_request_card_device(card, id->devs[1].id, acard->dev);
106 acard->devopl = pnp_request_card_device(card, id->devs[2].id, acard->dev);
108 pdev = acard->dev;
110 err = pnp_activate_dev(pdev);
111 if (err < 0) {
112 snd_printk(KERN_ERR PFX "AUDIO pnp configure failure\n");
113 return err;
115 port[dev] = pnp_port_start(pdev, 0);
116 dma8[dev] = pnp_dma(pdev, 1);
117 dma16[dev] = pnp_dma(pdev, 0);
118 irq[dev] = pnp_irq(pdev, 0);
120 pdev = acard->devmpu;
121 if (pdev != NULL) {
122 err = pnp_activate_dev(pdev);
123 if (err < 0)
124 goto __mpu_error;
125 mpu_port[dev] = pnp_port_start(pdev, 0);
126 mpu_irq[dev] = pnp_irq(pdev, 0);
127 } else {
128 __mpu_error:
129 if (pdev) {
130 pnp_release_card_device(pdev);
131 snd_printk(KERN_ERR PFX "MPU401 pnp configure failure, skipping\n");
133 acard->devmpu = NULL;
134 mpu_port[dev] = -1;
137 pdev = acard->devopl;
138 if (pdev != NULL) {
139 err = pnp_activate_dev(pdev);
140 if (err < 0)
141 goto __fm_error;
142 fm_port[dev] = pnp_port_start(pdev, 0);
143 } else {
144 __fm_error:
145 if (pdev) {
146 pnp_release_card_device(pdev);
147 snd_printk(KERN_ERR PFX "OPL3 pnp configure failure, skipping\n");
149 acard->devopl = NULL;
150 fm_port[dev] = -1;
153 return 0;
156 static int __devinit snd_card_als100_probe(int dev,
157 struct pnp_card_link *pcard,
158 const struct pnp_card_device_id *pid)
160 int error;
161 struct snd_sb *chip;
162 struct snd_card *card;
163 struct snd_card_als100 *acard;
164 struct snd_opl3 *opl3;
166 error = snd_card_create(index[dev], id[dev], THIS_MODULE,
167 sizeof(struct snd_card_als100), &card);
168 if (error < 0)
169 return error;
170 acard = card->private_data;
172 if ((error = snd_card_als100_pnp(dev, acard, pcard, pid))) {
173 snd_card_free(card);
174 return error;
176 snd_card_set_dev(card, &pcard->card->dev);
178 if ((error = snd_sbdsp_create(card, port[dev],
179 irq[dev],
180 snd_sb16dsp_interrupt,
181 dma8[dev],
182 dma16[dev],
183 SB_HW_ALS100, &chip)) < 0) {
184 snd_card_free(card);
185 return error;
187 acard->chip = chip;
189 strcpy(card->driver, "ALS100");
190 strcpy(card->shortname, "Avance Logic ALS100");
191 sprintf(card->longname, "%s, %s at 0x%lx, irq %d, dma %d&%d",
192 card->shortname, chip->name, chip->port,
193 irq[dev], dma8[dev], dma16[dev]);
195 if ((error = snd_sb16dsp_pcm(chip, 0, NULL)) < 0) {
196 snd_card_free(card);
197 return error;
200 if ((error = snd_sbmixer_new(chip)) < 0) {
201 snd_card_free(card);
202 return error;
205 if (mpu_port[dev] > 0 && mpu_port[dev] != SNDRV_AUTO_PORT) {
206 if (snd_mpu401_uart_new(card, 0, MPU401_HW_ALS100,
207 mpu_port[dev], 0,
208 mpu_irq[dev], IRQF_DISABLED,
209 NULL) < 0)
210 snd_printk(KERN_ERR PFX "no MPU-401 device at 0x%lx\n", mpu_port[dev]);
213 if (fm_port[dev] > 0 && fm_port[dev] != SNDRV_AUTO_PORT) {
214 if (snd_opl3_create(card,
215 fm_port[dev], fm_port[dev] + 2,
216 OPL3_HW_AUTO, 0, &opl3) < 0) {
217 snd_printk(KERN_ERR PFX "no OPL device at 0x%lx-0x%lx\n",
218 fm_port[dev], fm_port[dev] + 2);
219 } else {
220 if ((error = snd_opl3_timer_new(opl3, 0, 1)) < 0) {
221 snd_card_free(card);
222 return error;
224 if ((error = snd_opl3_hwdep_new(opl3, 0, 1, NULL)) < 0) {
225 snd_card_free(card);
226 return error;
231 if ((error = snd_card_register(card)) < 0) {
232 snd_card_free(card);
233 return error;
235 pnp_set_card_drvdata(pcard, card);
236 return 0;
239 static unsigned int __devinitdata als100_devices;
241 static int __devinit snd_als100_pnp_detect(struct pnp_card_link *card,
242 const struct pnp_card_device_id *id)
244 static int dev;
245 int res;
247 for ( ; dev < SNDRV_CARDS; dev++) {
248 if (!enable[dev])
249 continue;
250 res = snd_card_als100_probe(dev, card, id);
251 if (res < 0)
252 return res;
253 dev++;
254 als100_devices++;
255 return 0;
257 return -ENODEV;
260 static void __devexit snd_als100_pnp_remove(struct pnp_card_link * pcard)
262 snd_card_free(pnp_get_card_drvdata(pcard));
263 pnp_set_card_drvdata(pcard, NULL);
266 #ifdef CONFIG_PM
267 static int snd_als100_pnp_suspend(struct pnp_card_link *pcard, pm_message_t state)
269 struct snd_card *card = pnp_get_card_drvdata(pcard);
270 struct snd_card_als100 *acard = card->private_data;
271 struct snd_sb *chip = acard->chip;
273 snd_power_change_state(card, SNDRV_CTL_POWER_D3hot);
274 snd_pcm_suspend_all(chip->pcm);
275 snd_sbmixer_suspend(chip);
276 return 0;
279 static int snd_als100_pnp_resume(struct pnp_card_link *pcard)
281 struct snd_card *card = pnp_get_card_drvdata(pcard);
282 struct snd_card_als100 *acard = card->private_data;
283 struct snd_sb *chip = acard->chip;
285 snd_sbdsp_reset(chip);
286 snd_sbmixer_resume(chip);
287 snd_power_change_state(card, SNDRV_CTL_POWER_D0);
288 return 0;
290 #endif
292 static struct pnp_card_driver als100_pnpc_driver = {
293 .flags = PNP_DRIVER_RES_DISABLE,
294 .name = "als100",
295 .id_table = snd_als100_pnpids,
296 .probe = snd_als100_pnp_detect,
297 .remove = __devexit_p(snd_als100_pnp_remove),
298 #ifdef CONFIG_PM
299 .suspend = snd_als100_pnp_suspend,
300 .resume = snd_als100_pnp_resume,
301 #endif
304 static int __init alsa_card_als100_init(void)
306 int err;
308 err = pnp_register_card_driver(&als100_pnpc_driver);
309 if (err)
310 return err;
312 if (!als100_devices) {
313 pnp_unregister_card_driver(&als100_pnpc_driver);
314 #ifdef MODULE
315 snd_printk(KERN_ERR "no ALS100 based soundcards found\n");
316 #endif
317 return -ENODEV;
319 return 0;
322 static void __exit alsa_card_als100_exit(void)
324 pnp_unregister_card_driver(&als100_pnpc_driver);
327 module_init(alsa_card_als100_init)
328 module_exit(alsa_card_als100_exit)