1 /*
2 * xfi linux driver.
3 *
4 * Copyright (C) 2008, Creative Technology Ltd. All Rights Reserved.
5 *
6 * This source file is released under GPL v2 license (no other versions).
7 * See the COPYING file included in the main directory of this source
8 * distribution for the license terms and conditions.
9 */
10
11 #include <linux/init.h>
12 #include <linux/pci.h>
13 #include <linux/moduleparam.h>
14 #include <linux/pci_ids.h>
15 #include <linux/module.h>
16 #include <sound/core.h>
17 #include <sound/initval.h>
18 #include "ctatc.h"
19 #include "cthardware.h"
20
21 MODULE_AUTHOR("Creative Technology Ltd");
22 MODULE_DESCRIPTION("X-Fi driver version 1.03");
23 MODULE_LICENSE("GPL v2");
24 MODULE_SUPPORTED_DEVICE("{{Creative Labs, Sound Blaster X-Fi}");
25
26 static unsigned int reference_rate = 48000;
27 static unsigned int multiple = 2;
28 MODULE_PARM_DESC(reference_rate, "Reference rate (default=48000)");
29 module_param(reference_rate, uint, S_IRUGO);
30 MODULE_PARM_DESC(multiple, "Rate multiplier (default=2)");
31 module_param(multiple, uint, S_IRUGO);
32
33 static int index[SNDRV_CARDS] = SNDRV_DEFAULT_IDX;
34 static char *id[SNDRV_CARDS] = SNDRV_DEFAULT_STR;
35 static bool enable[SNDRV_CARDS] = SNDRV_DEFAULT_ENABLE_PNP;
36 static unsigned int subsystem[SNDRV_CARDS];
37
38 module_param_array(index, int, NULL, 0444);
39 MODULE_PARM_DESC(index, "Index value for Creative X-Fi driver");
40 module_param_array(id, charp, NULL, 0444);
41 MODULE_PARM_DESC(id, "ID string for Creative X-Fi driver");
42 module_param_array(enable, bool, NULL, 0444);
43 MODULE_PARM_DESC(enable, "Enable Creative X-Fi driver");
44 module_param_array(subsystem, int, NULL, 0444);
45 MODULE_PARM_DESC(subsystem, "Override subsystem ID for Creative X-Fi driver");
46
47 static const struct pci_device_id ct_pci_dev_ids[] = {
48 /* only X-Fi is supported, so... */
49 { PCI_DEVICE(PCI_VENDOR_ID_CREATIVE, PCI_DEVICE_ID_CREATIVE_20K1),
50 .driver_data = ATC20K1,
51 },
52 { PCI_DEVICE(PCI_VENDOR_ID_CREATIVE, PCI_DEVICE_ID_CREATIVE_20K2),
53 .driver_data = ATC20K2,
54 },
55 { 0, }
56 };
57 MODULE_DEVICE_TABLE(pci, ct_pci_dev_ids);
58
59 static int
60 ct_card_probe(struct pci_dev *pci, const struct pci_device_id *pci_id)
61 {
62 static int dev;
63 struct snd_card *card;
64 struct ct_atc *atc;
65 int err;
66
67 if (dev >= SNDRV_CARDS)
68 return -ENODEV;
69
70 if (!enable[dev]) {
71 dev++;
72 return -ENOENT;
73 }
74 err = snd_card_new(&pci->dev, index[dev], id[dev], THIS_MODULE,
75 0, &card);
76 if (err)
77 return err;
78 if ((reference_rate != 48000) && (reference_rate != 44100)) {
79 dev_err(card->dev,
80 "Invalid reference_rate value %u!!!\n",
81 reference_rate);
82 dev_err(card->dev,
83 "The valid values for reference_rate are 48000 and 44100, Value 48000 is assumed.\n");
84 reference_rate = 48000;
85 }
86 if ((multiple != 1) && (multiple != 2) && (multiple != 4)) {
87 dev_err(card->dev, "Invalid multiple value %u!!!\n",
88 multiple);
89 dev_err(card->dev,
90 "The valid values for multiple are 1, 2 and 4, Value 2 is assumed.\n");
91 multiple = 2;
92 }
93 err = ct_atc_create(card, pci, reference_rate, multiple,
94 pci_id->driver_data, subsystem[dev], &atc);
95 if (err < 0)
96 goto error;
97
98 card->private_data = atc;
99
100 /* Create alsa devices supported by this card */
101 err = ct_atc_create_alsa_devs(atc);
102 if (err < 0)
103 goto error;
104
105 strcpy(card->driver, "SB-XFi");
106 strcpy(card->shortname, "Creative X-Fi");
107 snprintf(card->longname, sizeof(card->longname), "%s %s %s",
108 card->shortname, atc->chip_name, atc->model_name);
109
110 err = snd_card_register(card);
111 if (err < 0)
112 goto error;
113
114 pci_set_drvdata(pci, card);
115 dev++;
116
117 return 0;
118
119 error:
120 snd_card_free(card);
121 return err;
122 }
123
124 static void ct_card_remove(struct pci_dev *pci)
125 {
126 snd_card_free(pci_get_drvdata(pci));
127 }
128
129 #ifdef CONFIG_PM_SLEEP
130 static int ct_card_suspend(struct device *dev)
131 {
132 struct snd_card *card = dev_get_drvdata(dev);
133 struct ct_atc *atc = card->private_data;
134
135 return atc->suspend(atc);
136 }
137
138 static int ct_card_resume(struct device *dev)
139 {
140 struct snd_card *card = dev_get_drvdata(dev);
141 struct ct_atc *atc = card->private_data;
142
143 return atc->resume(atc);
144 }
145
146 static SIMPLE_DEV_PM_OPS(ct_card_pm, ct_card_suspend, ct_card_resume);
147 #define CT_CARD_PM_OPS &ct_card_pm
148 #else
149 #define CT_CARD_PM_OPS NULL
150 #endif
151
152 static struct pci_driver ct_driver = {
153 .name = KBUILD_MODNAME,
154 .id_table = ct_pci_dev_ids,
155 .probe = ct_card_probe,
156 .remove = ct_card_remove,
157 .driver = {
158 .pm = CT_CARD_PM_OPS,
159 },
160 };
161
162 module_pci_driver(ct_driver);
163
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.