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