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 DEFINE_PCI_DEVICE_TABLE(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 __devinit 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_create(index[dev], id[dev], THIS_MODULE, 0, &card); 75 if (err) 76 return err; 77 if ((reference_rate != 48000) && (reference_rate != 44100)) { 78 printk(KERN_ERR "ctxfi: Invalid reference_rate value %u!!!\n", 79 reference_rate); 80 printk(KERN_ERR "ctxfi: The valid values for reference_rate " 81 "are 48000 and 44100, Value 48000 is assumed.\n"); 82 reference_rate = 48000; 83 } 84 if ((multiple != 1) && (multiple != 2) && (multiple != 4)) { 85 printk(KERN_ERR "ctxfi: Invalid multiple value %u!!!\n", 86 multiple); 87 printk(KERN_ERR "ctxfi: The valid values for multiple are " 88 "1, 2 and 4, Value 2 is assumed.\n"); 89 multiple = 2; 90 } 91 err = ct_atc_create(card, pci, reference_rate, multiple, 92 pci_id->driver_data, subsystem[dev], &atc); 93 if (err < 0) 94 goto error; 95 96 card->private_data = atc; 97 98 /* Create alsa devices supported by this card */ 99 err = ct_atc_create_alsa_devs(atc); 100 if (err < 0) 101 goto error; 102 103 strcpy(card->driver, "SB-XFi"); 104 strcpy(card->shortname, "Creative X-Fi"); 105 snprintf(card->longname, sizeof(card->longname), "%s %s %s", 106 card->shortname, atc->chip_name, atc->model_name); 107 108 err = snd_card_register(card); 109 if (err < 0) 110 goto error; 111 112 pci_set_drvdata(pci, card); 113 dev++; 114 115 return 0; 116 117 error: 118 snd_card_free(card); 119 return err; 120 } 121 122 static void __devexit ct_card_remove(struct pci_dev *pci) 123 { 124 snd_card_free(pci_get_drvdata(pci)); 125 pci_set_drvdata(pci, NULL); 126 } 127 128 #ifdef CONFIG_PM_SLEEP 129 static int ct_card_suspend(struct device *dev) 130 { 131 struct snd_card *card = dev_get_drvdata(dev); 132 struct ct_atc *atc = card->private_data; 133 134 return atc->suspend(atc); 135 } 136 137 static int ct_card_resume(struct device *dev) 138 { 139 struct snd_card *card = dev_get_drvdata(dev); 140 struct ct_atc *atc = card->private_data; 141 142 return atc->resume(atc); 143 } 144 145 static SIMPLE_DEV_PM_OPS(ct_card_pm, ct_card_suspend, ct_card_resume); 146 #define CT_CARD_PM_OPS &ct_card_pm 147 #else 148 #define CT_CARD_PM_OPS NULL 149 #endif 150 151 static struct pci_driver ct_driver = { 152 .name = KBUILD_MODNAME, 153 .id_table = ct_pci_dev_ids, 154 .probe = ct_card_probe, 155 .remove = __devexit_p(ct_card_remove), 156 .driver = { 157 .pm = CT_CARD_PM_OPS, 158 }, 159 }; 160 161 module_pci_driver(ct_driver); 162