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 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 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 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 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