Linux Kernel  3.7.1
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
jazz16.c
Go to the documentation of this file.
1 
2 /*
3  * jazz16.c - driver for Media Vision Jazz16 based soundcards.
4  * Copyright (C) 2009 Krzysztof Helt <[email protected]>
5  * Based on patches posted by Rask Ingemann Lambertsen and Rene Herman.
6  * Based on OSS Sound Blaster driver.
7  *
8  * This file is subject to the terms and conditions of the GNU General Public
9  * License. See the file COPYING in the main directory of this archive for
10  * more details.
11  *
12  */
13 
14 #include <linux/init.h>
15 #include <linux/module.h>
16 #include <linux/io.h>
17 #include <linux/delay.h>
18 #include <asm/dma.h>
19 #include <linux/isa.h>
20 #include <sound/core.h>
21 #include <sound/mpu401.h>
22 #include <sound/opl3.h>
23 #include <sound/sb.h>
24 #define SNDRV_LEGACY_FIND_FREE_IRQ
25 #define SNDRV_LEGACY_FIND_FREE_DMA
26 #include <sound/initval.h>
27 
28 #define PFX "jazz16: "
29 
30 MODULE_DESCRIPTION("Media Vision Jazz16");
31 MODULE_SUPPORTED_DEVICE("{{Media Vision ??? },"
32  "{RTL,RTL3000}}");
33 
34 MODULE_AUTHOR("Krzysztof Helt <[email protected]>");
35 MODULE_LICENSE("GPL");
36 
37 static int index[SNDRV_CARDS] = SNDRV_DEFAULT_IDX; /* Index 0-MAX */
38 static char *id[SNDRV_CARDS] = SNDRV_DEFAULT_STR; /* ID for this card */
39 static bool enable[SNDRV_CARDS] = SNDRV_DEFAULT_ENABLE; /* Enable this card */
40 static unsigned long port[SNDRV_CARDS] = SNDRV_DEFAULT_PORT;
41 static unsigned long mpu_port[SNDRV_CARDS] = SNDRV_DEFAULT_PORT;
42 static int irq[SNDRV_CARDS] = SNDRV_DEFAULT_IRQ;
43 static int mpu_irq[SNDRV_CARDS] = SNDRV_DEFAULT_IRQ;
44 static int dma8[SNDRV_CARDS] = SNDRV_DEFAULT_DMA;
45 static int dma16[SNDRV_CARDS] = SNDRV_DEFAULT_DMA;
46 
47 module_param_array(index, int, NULL, 0444);
48 MODULE_PARM_DESC(index, "Index value for Media Vision Jazz16 based soundcard.");
49 module_param_array(id, charp, NULL, 0444);
50 MODULE_PARM_DESC(id, "ID string for Media Vision Jazz16 based soundcard.");
51 module_param_array(enable, bool, NULL, 0444);
52 MODULE_PARM_DESC(enable, "Enable Media Vision Jazz16 based soundcard.");
53 module_param_array(port, long, NULL, 0444);
54 MODULE_PARM_DESC(port, "Port # for jazz16 driver.");
55 module_param_array(mpu_port, long, NULL, 0444);
56 MODULE_PARM_DESC(mpu_port, "MPU-401 port # for jazz16 driver.");
57 module_param_array(irq, int, NULL, 0444);
58 MODULE_PARM_DESC(irq, "IRQ # for jazz16 driver.");
59 module_param_array(mpu_irq, int, NULL, 0444);
60 MODULE_PARM_DESC(mpu_irq, "MPU-401 IRQ # for jazz16 driver.");
61 module_param_array(dma8, int, NULL, 0444);
62 MODULE_PARM_DESC(dma8, "DMA8 # for jazz16 driver.");
63 module_param_array(dma16, int, NULL, 0444);
64 MODULE_PARM_DESC(dma16, "DMA16 # for jazz16 driver.");
65 
66 #define SB_JAZZ16_WAKEUP 0xaf
67 #define SB_JAZZ16_SET_PORTS 0x50
68 #define SB_DSP_GET_JAZZ_BRD_REV 0xfa
69 #define SB_JAZZ16_SET_DMAINTR 0xfb
70 #define SB_DSP_GET_JAZZ_MODEL 0xfe
71 
73  struct snd_sb *chip;
74 };
75 
76 static irqreturn_t jazz16_interrupt(int irq, void *chip)
77 {
78  return snd_sb8dsp_interrupt(chip);
79 }
80 
81 static int __devinit jazz16_configure_ports(unsigned long port,
82  unsigned long mpu_port, int idx)
83 {
84  unsigned char val;
85 
86  if (!request_region(0x201, 1, "jazz16 config")) {
87  snd_printk(KERN_ERR "config port region is already in use.\n");
88  return -EBUSY;
89  }
90  outb(SB_JAZZ16_WAKEUP - idx, 0x201);
91  udelay(100);
92  outb(SB_JAZZ16_SET_PORTS + idx, 0x201);
93  udelay(100);
94  val = port & 0x70;
95  val |= (mpu_port & 0x30) >> 4;
96  outb(val, 0x201);
97 
98  release_region(0x201, 1);
99  return 0;
100 }
101 
102 static int __devinit jazz16_detect_board(unsigned long port,
103  unsigned long mpu_port)
104 {
105  int err;
106  int val;
107  struct snd_sb chip;
108 
109  if (!request_region(port, 0x10, "jazz16")) {
110  snd_printk(KERN_ERR "I/O port region is already in use.\n");
111  return -EBUSY;
112  }
113  /* just to call snd_sbdsp_command/reset/get_byte() */
114  chip.port = port;
115 
116  err = snd_sbdsp_reset(&chip);
117  if (err < 0)
118  for (val = 0; val < 4; val++) {
119  err = jazz16_configure_ports(port, mpu_port, val);
120  if (err < 0)
121  break;
122 
123  err = snd_sbdsp_reset(&chip);
124  if (!err)
125  break;
126  }
127  if (err < 0) {
128  err = -ENODEV;
129  goto err_unmap;
130  }
132  err = -EBUSY;
133  goto err_unmap;
134  }
135  val = snd_sbdsp_get_byte(&chip);
136  if (val >= 0x30)
138 
139  if ((val & 0xf0) != 0x10) {
140  err = -ENODEV;
141  goto err_unmap;
142  }
144  err = -EBUSY;
145  goto err_unmap;
146  }
148  err = snd_sbdsp_get_byte(&chip);
149  snd_printd("Media Vision Jazz16 board detected: rev 0x%x, model 0x%x\n",
150  val, err);
151 
152  err = 0;
153 
154 err_unmap:
155  release_region(port, 0x10);
156  return err;
157 }
158 
159 static int __devinit jazz16_configure_board(struct snd_sb *chip, int mpu_irq)
160 {
161  static unsigned char jazz_irq_bits[] = { 0, 0, 2, 3, 0, 1, 0, 4,
162  0, 2, 5, 0, 0, 0, 0, 6 };
163  static unsigned char jazz_dma_bits[] = { 0, 1, 0, 2, 0, 3, 0, 4 };
164 
165  if (jazz_dma_bits[chip->dma8] == 0 ||
166  jazz_dma_bits[chip->dma16] == 0 ||
167  jazz_irq_bits[chip->irq] == 0)
168  return -EINVAL;
169 
171  return -EBUSY;
172 
173  if (!snd_sbdsp_command(chip,
174  jazz_dma_bits[chip->dma8] |
175  (jazz_dma_bits[chip->dma16] << 4)))
176  return -EBUSY;
177 
178  if (!snd_sbdsp_command(chip,
179  jazz_irq_bits[chip->irq] |
180  (jazz_irq_bits[mpu_irq] << 4)))
181  return -EBUSY;
182 
183  return 0;
184 }
185 
186 static int __devinit snd_jazz16_match(struct device *devptr, unsigned int dev)
187 {
188  if (!enable[dev])
189  return 0;
190  if (port[dev] == SNDRV_AUTO_PORT) {
191  snd_printk(KERN_ERR "please specify port\n");
192  return 0;
193  } else if (port[dev] == 0x200 || (port[dev] & ~0x270)) {
194  snd_printk(KERN_ERR "incorrect port specified\n");
195  return 0;
196  }
197  if (dma8[dev] != SNDRV_AUTO_DMA &&
198  dma8[dev] != 1 && dma8[dev] != 3) {
199  snd_printk(KERN_ERR "dma8 must be 1 or 3\n");
200  return 0;
201  }
202  if (dma16[dev] != SNDRV_AUTO_DMA &&
203  dma16[dev] != 5 && dma16[dev] != 7) {
204  snd_printk(KERN_ERR "dma16 must be 5 or 7\n");
205  return 0;
206  }
207  if (mpu_port[dev] != SNDRV_AUTO_PORT &&
208  (mpu_port[dev] & ~0x030) != 0x300) {
209  snd_printk(KERN_ERR "incorrect mpu_port specified\n");
210  return 0;
211  }
212  if (mpu_irq[dev] != SNDRV_AUTO_DMA &&
213  mpu_irq[dev] != 2 && mpu_irq[dev] != 3 &&
214  mpu_irq[dev] != 5 && mpu_irq[dev] != 7) {
215  snd_printk(KERN_ERR "mpu_irq must be 2, 3, 5 or 7\n");
216  return 0;
217  }
218  return 1;
219 }
220 
221 static int __devinit snd_jazz16_probe(struct device *devptr, unsigned int dev)
222 {
223  struct snd_card *card;
224  struct snd_card_jazz16 *jazz16;
225  struct snd_sb *chip;
226  struct snd_opl3 *opl3;
227  static int possible_irqs[] = {2, 3, 5, 7, 9, 10, 15, -1};
228  static int possible_dmas8[] = {1, 3, -1};
229  static int possible_dmas16[] = {5, 7, -1};
230  int err, xirq, xdma8, xdma16, xmpu_port, xmpu_irq;
231 
232  err = snd_card_create(index[dev], id[dev], THIS_MODULE,
233  sizeof(struct snd_card_jazz16), &card);
234  if (err < 0)
235  return err;
236 
237  jazz16 = card->private_data;
238 
239  xirq = irq[dev];
240  if (xirq == SNDRV_AUTO_IRQ) {
241  xirq = snd_legacy_find_free_irq(possible_irqs);
242  if (xirq < 0) {
243  snd_printk(KERN_ERR "unable to find a free IRQ\n");
244  err = -EBUSY;
245  goto err_free;
246  }
247  }
248  xdma8 = dma8[dev];
249  if (xdma8 == SNDRV_AUTO_DMA) {
250  xdma8 = snd_legacy_find_free_dma(possible_dmas8);
251  if (xdma8 < 0) {
252  snd_printk(KERN_ERR "unable to find a free DMA8\n");
253  err = -EBUSY;
254  goto err_free;
255  }
256  }
257  xdma16 = dma16[dev];
258  if (xdma16 == SNDRV_AUTO_DMA) {
259  xdma16 = snd_legacy_find_free_dma(possible_dmas16);
260  if (xdma16 < 0) {
261  snd_printk(KERN_ERR "unable to find a free DMA16\n");
262  err = -EBUSY;
263  goto err_free;
264  }
265  }
266 
267  xmpu_port = mpu_port[dev];
268  if (xmpu_port == SNDRV_AUTO_PORT)
269  xmpu_port = 0;
270  err = jazz16_detect_board(port[dev], xmpu_port);
271  if (err < 0) {
272  printk(KERN_ERR "Media Vision Jazz16 board not detected\n");
273  goto err_free;
274  }
275  err = snd_sbdsp_create(card, port[dev], irq[dev],
276  jazz16_interrupt,
277  dma8[dev], dma16[dev],
278  SB_HW_JAZZ16,
279  &chip);
280  if (err < 0)
281  goto err_free;
282 
283  xmpu_irq = mpu_irq[dev];
284  if (xmpu_irq == SNDRV_AUTO_IRQ || mpu_port[dev] == SNDRV_AUTO_PORT)
285  xmpu_irq = 0;
286  err = jazz16_configure_board(chip, xmpu_irq);
287  if (err < 0) {
288  printk(KERN_ERR "Media Vision Jazz16 configuration failed\n");
289  goto err_free;
290  }
291 
292  jazz16->chip = chip;
293 
294  strcpy(card->driver, "jazz16");
295  strcpy(card->shortname, "Media Vision Jazz16");
296  sprintf(card->longname,
297  "Media Vision Jazz16 at 0x%lx, irq %d, dma8 %d, dma16 %d",
298  port[dev], xirq, xdma8, xdma16);
299 
300  err = snd_sb8dsp_pcm(chip, 0, NULL);
301  if (err < 0)
302  goto err_free;
303  err = snd_sbmixer_new(chip);
304  if (err < 0)
305  goto err_free;
306 
307  err = snd_opl3_create(card, chip->port, chip->port + 2,
308  OPL3_HW_AUTO, 1, &opl3);
309  if (err < 0)
310  snd_printk(KERN_WARNING "no OPL device at 0x%lx-0x%lx\n",
311  chip->port, chip->port + 2);
312  else {
313  err = snd_opl3_hwdep_new(opl3, 0, 1, NULL);
314  if (err < 0)
315  goto err_free;
316  }
317  if (mpu_port[dev] > 0 && mpu_port[dev] != SNDRV_AUTO_PORT) {
318  if (mpu_irq[dev] == SNDRV_AUTO_IRQ)
319  mpu_irq[dev] = -1;
320 
321  if (snd_mpu401_uart_new(card, 0,
323  mpu_port[dev], 0,
324  mpu_irq[dev],
325  NULL) < 0)
326  snd_printk(KERN_ERR "no MPU-401 device at 0x%lx\n",
327  mpu_port[dev]);
328  }
329 
330  snd_card_set_dev(card, devptr);
331 
332  err = snd_card_register(card);
333  if (err < 0)
334  goto err_free;
335 
336  dev_set_drvdata(devptr, card);
337  return 0;
338 
339 err_free:
340  snd_card_free(card);
341  return err;
342 }
343 
344 static int __devexit snd_jazz16_remove(struct device *devptr, unsigned int dev)
345 {
346  struct snd_card *card = dev_get_drvdata(devptr);
347 
348  dev_set_drvdata(devptr, NULL);
349  snd_card_free(card);
350  return 0;
351 }
352 
353 #ifdef CONFIG_PM
354 static int snd_jazz16_suspend(struct device *pdev, unsigned int n,
356 {
357  struct snd_card *card = dev_get_drvdata(pdev);
358  struct snd_card_jazz16 *acard = card->private_data;
359  struct snd_sb *chip = acard->chip;
360 
362  snd_pcm_suspend_all(chip->pcm);
363  snd_sbmixer_suspend(chip);
364  return 0;
365 }
366 
367 static int snd_jazz16_resume(struct device *pdev, unsigned int n)
368 {
369  struct snd_card *card = dev_get_drvdata(pdev);
370  struct snd_card_jazz16 *acard = card->private_data;
371  struct snd_sb *chip = acard->chip;
372 
373  snd_sbdsp_reset(chip);
374  snd_sbmixer_resume(chip);
376  return 0;
377 }
378 #endif
379 
380 static struct isa_driver snd_jazz16_driver = {
381  .match = snd_jazz16_match,
382  .probe = snd_jazz16_probe,
383  .remove = __devexit_p(snd_jazz16_remove),
384 #ifdef CONFIG_PM
385  .suspend = snd_jazz16_suspend,
386  .resume = snd_jazz16_resume,
387 #endif
388  .driver = {
389  .name = "jazz16"
390  },
391 };
392 
393 static int __init alsa_card_jazz16_init(void)
394 {
395  return isa_register_driver(&snd_jazz16_driver, SNDRV_CARDS);
396 }
397 
398 static void __exit alsa_card_jazz16_exit(void)
399 {
400  isa_unregister_driver(&snd_jazz16_driver);
401 }
402 
403 module_init(alsa_card_jazz16_init)
404 module_exit(alsa_card_jazz16_exit)