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