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