Commit | Line | Data |
---|---|---|
1da177e4 LT |
1 | #ifndef __SOUND_CORE_H |
2 | #define __SOUND_CORE_H | |
3 | ||
4 | /* | |
5 | * Main header file for the ALSA driver | |
c1017a4c | 6 | * Copyright (c) 1994-2001 by Jaroslav Kysela <perex@perex.cz> |
1da177e4 LT |
7 | * |
8 | * | |
9 | * This program is free software; you can redistribute it and/or modify | |
10 | * it under the terms of the GNU General Public License as published by | |
11 | * the Free Software Foundation; either version 2 of the License, or | |
12 | * (at your option) any later version. | |
13 | * | |
14 | * This program is distributed in the hope that it will be useful, | |
15 | * but WITHOUT ANY WARRANTY; without even the implied warranty of | |
16 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
17 | * GNU General Public License for more details. | |
18 | * | |
19 | * You should have received a copy of the GNU General Public License | |
20 | * along with this program; if not, write to the Free Software | |
21 | * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA | |
22 | * | |
23 | */ | |
24 | ||
25 | #include <linux/sched.h> /* wake_up() */ | |
1a60d4c5 | 26 | #include <linux/mutex.h> /* struct mutex */ |
1da177e4 | 27 | #include <linux/rwsem.h> /* struct rw_semaphore */ |
1da177e4 | 28 | #include <linux/pm.h> /* pm_message_t */ |
5ef03460 | 29 | #include <linux/stringify.h> |
bcbb1553 | 30 | #include <linux/printk.h> |
1da177e4 | 31 | |
9004acc7 TI |
32 | /* number of supported soundcards */ |
33 | #ifdef CONFIG_SND_DYNAMIC_MINORS | |
7bb2491b | 34 | #define SNDRV_CARDS CONFIG_SND_MAX_CARDS |
9004acc7 TI |
35 | #else |
36 | #define SNDRV_CARDS 8 /* don't change - minor numbers */ | |
37 | #endif | |
38 | ||
39 | #define CONFIG_SND_MAJOR 116 /* standard configuration */ | |
40 | ||
1da177e4 | 41 | /* forward declarations */ |
1da177e4 | 42 | struct pci_dev; |
de477254 | 43 | struct module; |
313162d0 PG |
44 | struct device; |
45 | struct device_attribute; | |
1da177e4 LT |
46 | |
47 | /* device allocation stuff */ | |
48 | ||
49 | #define SNDRV_DEV_TYPE_RANGE_SIZE 0x1000 | |
50 | ||
512bbd6a TI |
51 | typedef int __bitwise snd_device_type_t; |
52 | #define SNDRV_DEV_TOPLEVEL ((__force snd_device_type_t) 0) | |
53 | #define SNDRV_DEV_CONTROL ((__force snd_device_type_t) 1) | |
54 | #define SNDRV_DEV_LOWLEVEL_PRE ((__force snd_device_type_t) 2) | |
55 | #define SNDRV_DEV_LOWLEVEL_NORMAL ((__force snd_device_type_t) 0x1000) | |
56 | #define SNDRV_DEV_PCM ((__force snd_device_type_t) 0x1001) | |
57 | #define SNDRV_DEV_RAWMIDI ((__force snd_device_type_t) 0x1002) | |
58 | #define SNDRV_DEV_TIMER ((__force snd_device_type_t) 0x1003) | |
59 | #define SNDRV_DEV_SEQUENCER ((__force snd_device_type_t) 0x1004) | |
60 | #define SNDRV_DEV_HWDEP ((__force snd_device_type_t) 0x1005) | |
61 | #define SNDRV_DEV_INFO ((__force snd_device_type_t) 0x1006) | |
62 | #define SNDRV_DEV_BUS ((__force snd_device_type_t) 0x1007) | |
63 | #define SNDRV_DEV_CODEC ((__force snd_device_type_t) 0x1008) | |
e76d8cea | 64 | #define SNDRV_DEV_JACK ((__force snd_device_type_t) 0x1009) |
3eafc959 | 65 | #define SNDRV_DEV_COMPRESS ((__force snd_device_type_t) 0x100A) |
512bbd6a TI |
66 | #define SNDRV_DEV_LOWLEVEL ((__force snd_device_type_t) 0x2000) |
67 | ||
68 | typedef int __bitwise snd_device_state_t; | |
69 | #define SNDRV_DEV_BUILD ((__force snd_device_state_t) 0) | |
70 | #define SNDRV_DEV_REGISTERED ((__force snd_device_state_t) 1) | |
71 | #define SNDRV_DEV_DISCONNECTED ((__force snd_device_state_t) 2) | |
72 | ||
73 | typedef int __bitwise snd_device_cmd_t; | |
74 | #define SNDRV_DEV_CMD_PRE ((__force snd_device_cmd_t) 0) | |
75 | #define SNDRV_DEV_CMD_NORMAL ((__force snd_device_cmd_t) 1) | |
76 | #define SNDRV_DEV_CMD_POST ((__force snd_device_cmd_t) 2) | |
77 | ||
78 | struct snd_device; | |
79 | ||
80 | struct snd_device_ops { | |
81 | int (*dev_free)(struct snd_device *dev); | |
82 | int (*dev_register)(struct snd_device *dev); | |
83 | int (*dev_disconnect)(struct snd_device *dev); | |
512bbd6a TI |
84 | }; |
85 | ||
86 | struct snd_device { | |
1da177e4 | 87 | struct list_head list; /* list of registered devices */ |
512bbd6a | 88 | struct snd_card *card; /* card which holds this device */ |
1da177e4 LT |
89 | snd_device_state_t state; /* state of the device */ |
90 | snd_device_type_t type; /* device type */ | |
91 | void *device_data; /* device structure */ | |
512bbd6a | 92 | struct snd_device_ops *ops; /* operations */ |
1da177e4 LT |
93 | }; |
94 | ||
512bbd6a | 95 | #define snd_device(n) list_entry(n, struct snd_device, list) |
1da177e4 | 96 | |
1da177e4 LT |
97 | /* main structure for soundcard */ |
98 | ||
512bbd6a | 99 | struct snd_card { |
d5750f67 HK |
100 | int number; /* number of soundcard (index to |
101 | snd_cards) */ | |
1da177e4 LT |
102 | |
103 | char id[16]; /* id string of this card */ | |
104 | char driver[16]; /* driver name */ | |
105 | char shortname[32]; /* short name of this soundcard */ | |
106 | char longname[80]; /* name of this soundcard */ | |
107 | char mixername[80]; /* mixer name */ | |
ff33f230 | 108 | char components[128]; /* card components delimited with |
d5750f67 | 109 | space */ |
1da177e4 LT |
110 | struct module *module; /* top-level module */ |
111 | ||
112 | void *private_data; /* private data for soundcard */ | |
512bbd6a | 113 | void (*private_free) (struct snd_card *card); /* callback for freeing of |
d5750f67 | 114 | private data */ |
1da177e4 LT |
115 | struct list_head devices; /* devices */ |
116 | ||
117 | unsigned int last_numid; /* last used numeric ID */ | |
118 | struct rw_semaphore controls_rwsem; /* controls list lock */ | |
119 | rwlock_t ctl_files_rwlock; /* ctl_files list lock */ | |
120 | int controls_count; /* count of all controls */ | |
121 | int user_ctl_count; /* count of all user controls */ | |
122 | struct list_head controls; /* all controls for this card */ | |
123 | struct list_head ctl_files; /* active control files */ | |
124 | ||
512bbd6a TI |
125 | struct snd_info_entry *proc_root; /* root for soundcard specific files */ |
126 | struct snd_info_entry *proc_id; /* the card id */ | |
1da177e4 LT |
127 | struct proc_dir_entry *proc_root_link; /* number link to real id */ |
128 | ||
118dd6bf | 129 | struct list_head files_list; /* all files associated to this card */ |
d5750f67 HK |
130 | struct snd_shutdown_f_ops *s_f_ops; /* file operations in the shutdown |
131 | state */ | |
1da177e4 LT |
132 | spinlock_t files_lock; /* lock the files for this card */ |
133 | int shutdown; /* this card is going down */ | |
c461482c | 134 | int free_on_last_close; /* free in context of file_release */ |
1da177e4 | 135 | wait_queue_head_t shutdown_sleep; |
a0830dbd | 136 | atomic_t refcount; /* refcount for disconnection */ |
7d2aae1e | 137 | struct device *dev; /* device assigned to this card */ |
7d2aae1e | 138 | struct device *card_dev; /* cardX object for sysfs */ |
1da177e4 LT |
139 | |
140 | #ifdef CONFIG_PM | |
1da177e4 | 141 | unsigned int power_state; /* power state */ |
1a60d4c5 | 142 | struct mutex power_lock; /* power lock */ |
1da177e4 | 143 | wait_queue_head_t power_sleep; |
1da177e4 LT |
144 | #endif |
145 | ||
146 | #if defined(CONFIG_SND_MIXER_OSS) || defined(CONFIG_SND_MIXER_OSS_MODULE) | |
512bbd6a | 147 | struct snd_mixer_oss *mixer_oss; |
1da177e4 LT |
148 | int mixer_oss_change_count; |
149 | #endif | |
150 | }; | |
151 | ||
152 | #ifdef CONFIG_PM | |
512bbd6a | 153 | static inline void snd_power_lock(struct snd_card *card) |
1da177e4 | 154 | { |
1a60d4c5 | 155 | mutex_lock(&card->power_lock); |
1da177e4 LT |
156 | } |
157 | ||
512bbd6a | 158 | static inline void snd_power_unlock(struct snd_card *card) |
1da177e4 | 159 | { |
1a60d4c5 | 160 | mutex_unlock(&card->power_lock); |
1da177e4 LT |
161 | } |
162 | ||
512bbd6a | 163 | static inline unsigned int snd_power_get_state(struct snd_card *card) |
1da177e4 LT |
164 | { |
165 | return card->power_state; | |
166 | } | |
167 | ||
512bbd6a | 168 | static inline void snd_power_change_state(struct snd_card *card, unsigned int state) |
1da177e4 LT |
169 | { |
170 | card->power_state = state; | |
171 | wake_up(&card->power_sleep); | |
172 | } | |
d5750f67 HK |
173 | |
174 | /* init.c */ | |
cbac4b0c | 175 | int snd_power_wait(struct snd_card *card, unsigned int power_state); |
d5750f67 | 176 | |
1da177e4 LT |
177 | #else /* ! CONFIG_PM */ |
178 | ||
179 | #define snd_power_lock(card) do { (void)(card); } while (0) | |
180 | #define snd_power_unlock(card) do { (void)(card); } while (0) | |
6fdb94bd | 181 | static inline int snd_power_wait(struct snd_card *card, unsigned int state) { return 0; } |
363129ea | 182 | #define snd_power_get_state(card) ({ (void)(card); SNDRV_CTL_POWER_D0; }) |
1da177e4 | 183 | #define snd_power_change_state(card, state) do { (void)(card); } while (0) |
1da177e4 LT |
184 | |
185 | #endif /* CONFIG_PM */ | |
186 | ||
512bbd6a | 187 | struct snd_minor { |
2af677fc | 188 | int type; /* SNDRV_DEVICE_TYPE_XXX */ |
6983b724 | 189 | int card; /* card number */ |
1da177e4 | 190 | int device; /* device number */ |
99ac48f5 | 191 | const struct file_operations *f_ops; /* file operations */ |
f87135f5 | 192 | void *private_data; /* private data for f_ops->open */ |
d80f19fa | 193 | struct device *dev; /* device for sysfs */ |
a0830dbd | 194 | struct snd_card *card_ptr; /* assigned card instance */ |
1da177e4 LT |
195 | }; |
196 | ||
7d2aae1e TI |
197 | /* return a device pointer linked to each sound device as a parent */ |
198 | static inline struct device *snd_card_get_device_link(struct snd_card *card) | |
199 | { | |
7d2aae1e | 200 | return card ? card->card_dev : NULL; |
7d2aae1e TI |
201 | } |
202 | ||
1da177e4 LT |
203 | /* sound.c */ |
204 | ||
f1902860 | 205 | extern int snd_major; |
1da177e4 | 206 | extern int snd_ecards_limit; |
d80f19fa | 207 | extern struct class *sound_class; |
1da177e4 LT |
208 | |
209 | void snd_request_card(int card); | |
210 | ||
12b131c4 JB |
211 | int snd_register_device_for_dev(int type, struct snd_card *card, |
212 | int dev, | |
213 | const struct file_operations *f_ops, | |
214 | void *private_data, | |
215 | const char *name, | |
216 | struct device *device); | |
217 | ||
218 | /** | |
219 | * snd_register_device - Register the ALSA device file for the card | |
220 | * @type: the device type, SNDRV_DEVICE_TYPE_XXX | |
221 | * @card: the card instance | |
222 | * @dev: the device index | |
223 | * @f_ops: the file operations | |
224 | * @private_data: user pointer for f_ops->open() | |
225 | * @name: the device file name | |
226 | * | |
227 | * Registers an ALSA device file for the given card. | |
228 | * The operators have to be set in reg parameter. | |
229 | * | |
230 | * This function uses the card's device pointer to link to the | |
231 | * correct &struct device. | |
232 | * | |
eb7c06e8 | 233 | * Return: Zero if successful, or a negative error code on failure. |
12b131c4 JB |
234 | */ |
235 | static inline int snd_register_device(int type, struct snd_card *card, int dev, | |
236 | const struct file_operations *f_ops, | |
237 | void *private_data, | |
238 | const char *name) | |
239 | { | |
240 | return snd_register_device_for_dev(type, card, dev, f_ops, | |
241 | private_data, name, | |
c2902c8a | 242 | snd_card_get_device_link(card)); |
12b131c4 JB |
243 | } |
244 | ||
512bbd6a | 245 | int snd_unregister_device(int type, struct snd_card *card, int dev); |
f87135f5 | 246 | void *snd_lookup_minor_data(unsigned int minor, int type); |
9d19f48c | 247 | int snd_add_device_sysfs_file(int type, struct snd_card *card, int dev, |
d80f19fa | 248 | struct device_attribute *attr); |
1da177e4 LT |
249 | |
250 | #ifdef CONFIG_SND_OSSEMUL | |
2af677fc | 251 | int snd_register_oss_device(int type, struct snd_card *card, int dev, |
99ac48f5 | 252 | const struct file_operations *f_ops, void *private_data, |
f87135f5 | 253 | const char *name); |
512bbd6a | 254 | int snd_unregister_oss_device(int type, struct snd_card *card, int dev); |
f87135f5 | 255 | void *snd_lookup_oss_minor_data(unsigned int minor, int type); |
1da177e4 LT |
256 | #endif |
257 | ||
258 | int snd_minor_info_init(void); | |
259 | int snd_minor_info_done(void); | |
260 | ||
261 | /* sound_oss.c */ | |
262 | ||
263 | #ifdef CONFIG_SND_OSSEMUL | |
264 | int snd_minor_info_oss_init(void); | |
265 | int snd_minor_info_oss_done(void); | |
1da177e4 | 266 | #else |
ad5fada5 PM |
267 | static inline int snd_minor_info_oss_init(void) { return 0; } |
268 | static inline int snd_minor_info_oss_done(void) { return 0; } | |
1da177e4 LT |
269 | #endif |
270 | ||
271 | /* memory.c */ | |
272 | ||
1da177e4 LT |
273 | int copy_to_user_fromio(void __user *dst, const volatile void __iomem *src, size_t count); |
274 | int copy_from_user_toio(volatile void __iomem *dst, const void __user *src, size_t count); | |
275 | ||
276 | /* init.c */ | |
277 | ||
512bbd6a | 278 | extern struct snd_card *snd_cards[SNDRV_CARDS]; |
746df948 | 279 | int snd_card_locked(int card); |
1da177e4 LT |
280 | #if defined(CONFIG_SND_MIXER_OSS) || defined(CONFIG_SND_MIXER_OSS_MODULE) |
281 | #define SND_MIXER_OSS_NOTIFY_REGISTER 0 | |
282 | #define SND_MIXER_OSS_NOTIFY_DISCONNECT 1 | |
283 | #define SND_MIXER_OSS_NOTIFY_FREE 2 | |
512bbd6a | 284 | extern int (*snd_mixer_oss_notify_callback)(struct snd_card *card, int cmd); |
1da177e4 LT |
285 | #endif |
286 | ||
53fb1e63 TI |
287 | int snd_card_create(int idx, const char *id, |
288 | struct module *module, int extra_size, | |
289 | struct snd_card **card_ret); | |
290 | ||
512bbd6a TI |
291 | int snd_card_disconnect(struct snd_card *card); |
292 | int snd_card_free(struct snd_card *card); | |
c461482c | 293 | int snd_card_free_when_closed(struct snd_card *card); |
10a8ebbb | 294 | void snd_card_set_id(struct snd_card *card, const char *id); |
512bbd6a | 295 | int snd_card_register(struct snd_card *card); |
1da177e4 LT |
296 | int snd_card_info_init(void); |
297 | int snd_card_info_done(void); | |
512bbd6a TI |
298 | int snd_component_add(struct snd_card *card, const char *component); |
299 | int snd_card_file_add(struct snd_card *card, struct file *file); | |
300 | int snd_card_file_remove(struct snd_card *card, struct file *file); | |
a0830dbd | 301 | void snd_card_unref(struct snd_card *card); |
1da177e4 | 302 | |
edab938e | 303 | #define snd_card_set_dev(card, devptr) ((card)->dev = (devptr)) |
1da177e4 LT |
304 | |
305 | /* device.c */ | |
306 | ||
512bbd6a TI |
307 | int snd_device_new(struct snd_card *card, snd_device_type_t type, |
308 | void *device_data, struct snd_device_ops *ops); | |
309 | int snd_device_register(struct snd_card *card, void *device_data); | |
310 | int snd_device_register_all(struct snd_card *card); | |
311 | int snd_device_disconnect(struct snd_card *card, void *device_data); | |
312 | int snd_device_disconnect_all(struct snd_card *card); | |
313 | int snd_device_free(struct snd_card *card, void *device_data); | |
314 | int snd_device_free_all(struct snd_card *card, snd_device_cmd_t cmd); | |
1da177e4 LT |
315 | |
316 | /* isadma.c */ | |
317 | ||
276bd31c | 318 | #ifdef CONFIG_ISA_DMA_API |
1da177e4 LT |
319 | #define DMA_MODE_NO_ENABLE 0x0100 |
320 | ||
321 | void snd_dma_program(unsigned long dma, unsigned long addr, unsigned int size, unsigned short mode); | |
322 | void snd_dma_disable(unsigned long dma); | |
323 | unsigned int snd_dma_pointer(unsigned long dma, unsigned int size); | |
276bd31c | 324 | #endif |
1da177e4 LT |
325 | |
326 | /* misc.c */ | |
b709e574 | 327 | struct resource; |
b1d5776d | 328 | void release_and_free_resource(struct resource *res); |
1da177e4 | 329 | |
1da177e4 LT |
330 | /* --- */ |
331 | ||
fae3d88a FW |
332 | /* sound printk debug levels */ |
333 | enum { | |
334 | SND_PR_ALWAYS, | |
335 | SND_PR_DEBUG, | |
336 | SND_PR_VERBOSE, | |
337 | }; | |
338 | ||
36ce99c1 | 339 | #if defined(CONFIG_SND_DEBUG) || defined(CONFIG_SND_VERBOSE_PRINTK) |
b9075fa9 | 340 | __printf(4, 5) |
36ce99c1 | 341 | void __snd_printk(unsigned int level, const char *file, int line, |
b9075fa9 | 342 | const char *format, ...); |
36ce99c1 TI |
343 | #else |
344 | #define __snd_printk(level, file, line, format, args...) \ | |
cf0baf16 | 345 | printk(format, ##args) |
36ce99c1 TI |
346 | #endif |
347 | ||
1da177e4 LT |
348 | /** |
349 | * snd_printk - printk wrapper | |
350 | * @fmt: format string | |
351 | * | |
f66fcedc | 352 | * Works like printk() but prints the file and the line of the caller |
1da177e4 LT |
353 | * when configured with CONFIG_SND_VERBOSE_PRINTK. |
354 | */ | |
355 | #define snd_printk(fmt, args...) \ | |
36ce99c1 | 356 | __snd_printk(0, __FILE__, __LINE__, fmt, ##args) |
1da177e4 LT |
357 | |
358 | #ifdef CONFIG_SND_DEBUG | |
1da177e4 LT |
359 | /** |
360 | * snd_printd - debug printk | |
0863afb3 | 361 | * @fmt: format string |
1da177e4 | 362 | * |
edab938e | 363 | * Works like snd_printk() for debugging purposes. |
1da177e4 LT |
364 | * Ignored when CONFIG_SND_DEBUG is not set. |
365 | */ | |
366 | #define snd_printd(fmt, args...) \ | |
36ce99c1 | 367 | __snd_printk(1, __FILE__, __LINE__, fmt, ##args) |
fae3d88a FW |
368 | #define _snd_printd(level, fmt, args...) \ |
369 | __snd_printk(level, __FILE__, __LINE__, fmt, ##args) | |
7c22f1aa | 370 | |
f66fcedc TI |
371 | /** |
372 | * snd_BUG - give a BUG warning message and stack trace | |
373 | * | |
374 | * Calls WARN() if CONFIG_SND_DEBUG is set. | |
375 | * Ignored when CONFIG_SND_DEBUG is not set. | |
376 | */ | |
bdbecf50 | 377 | #define snd_BUG() WARN(1, "BUG?\n") |
f66fcedc | 378 | |
bcbb1553 TG |
379 | /** |
380 | * Suppress high rates of output when CONFIG_SND_DEBUG is enabled. | |
381 | */ | |
382 | #define snd_printd_ratelimit() printk_ratelimit() | |
383 | ||
f66fcedc TI |
384 | /** |
385 | * snd_BUG_ON - debugging check macro | |
386 | * @cond: condition to evaluate | |
387 | * | |
d5702162 CS |
388 | * Has the same behavior as WARN_ON when CONFIG_SND_DEBUG is set, |
389 | * otherwise just evaluates the conditional and returns the value. | |
f66fcedc | 390 | */ |
d5702162 | 391 | #define snd_BUG_ON(cond) WARN_ON((cond)) |
1da177e4 LT |
392 | |
393 | #else /* !CONFIG_SND_DEBUG */ | |
394 | ||
86b27237 TI |
395 | __printf(1, 2) |
396 | static inline void snd_printd(const char *format, ...) {} | |
397 | __printf(2, 3) | |
398 | static inline void _snd_printd(int level, const char *format, ...) {} | |
399 | ||
fcef7836 | 400 | #define snd_BUG() do { } while (0) |
d5702162 CS |
401 | |
402 | #define snd_BUG_ON(condition) ({ \ | |
403 | int __ret_warn_on = !!(condition); \ | |
404 | unlikely(__ret_warn_on); \ | |
405 | }) | |
1da177e4 | 406 | |
bcbb1553 TG |
407 | static inline bool snd_printd_ratelimit(void) { return false; } |
408 | ||
1da177e4 LT |
409 | #endif /* CONFIG_SND_DEBUG */ |
410 | ||
62cf872a | 411 | #ifdef CONFIG_SND_DEBUG_VERBOSE |
1da177e4 LT |
412 | /** |
413 | * snd_printdd - debug printk | |
414 | * @format: format string | |
415 | * | |
edab938e | 416 | * Works like snd_printk() for debugging purposes. |
62cf872a | 417 | * Ignored when CONFIG_SND_DEBUG_VERBOSE is not set. |
1da177e4 | 418 | */ |
36ce99c1 TI |
419 | #define snd_printdd(format, args...) \ |
420 | __snd_printk(2, __FILE__, __LINE__, format, ##args) | |
1da177e4 | 421 | #else |
86b27237 TI |
422 | __printf(1, 2) |
423 | static inline void snd_printdd(const char *format, ...) {} | |
1da177e4 LT |
424 | #endif |
425 | ||
1da177e4 | 426 | |
1da177e4 LT |
427 | #define SNDRV_OSS_VERSION ((3<<16)|(8<<8)|(1<<4)|(0)) /* 3.8.1a */ |
428 | ||
429 | /* for easier backward-porting */ | |
430 | #if defined(CONFIG_GAMEPORT) || defined(CONFIG_GAMEPORT_MODULE) | |
1da177e4 LT |
431 | #define gameport_set_dev_parent(gp,xdev) ((gp)->dev.parent = (xdev)) |
432 | #define gameport_set_port_data(gp,r) ((gp)->port_data = (r)) | |
433 | #define gameport_get_port_data(gp) (gp)->port_data | |
434 | #endif | |
1da177e4 | 435 | |
8422fa11 | 436 | #ifdef CONFIG_PCI |
d9ea472c TI |
437 | /* PCI quirk list helper */ |
438 | struct snd_pci_quirk { | |
439 | unsigned short subvendor; /* PCI subvendor ID */ | |
440 | unsigned short subdevice; /* PCI subdevice ID */ | |
8bd4bb7a | 441 | unsigned short subdevice_mask; /* bitmask to match */ |
d9ea472c | 442 | int value; /* value */ |
62cf872a | 443 | #ifdef CONFIG_SND_DEBUG_VERBOSE |
d9ea472c TI |
444 | const char *name; /* name of the device (optional) */ |
445 | #endif | |
446 | }; | |
447 | ||
8bd4bb7a TI |
448 | #define _SND_PCI_QUIRK_ID_MASK(vend, mask, dev) \ |
449 | .subvendor = (vend), .subdevice = (dev), .subdevice_mask = (mask) | |
450 | #define _SND_PCI_QUIRK_ID(vend, dev) \ | |
451 | _SND_PCI_QUIRK_ID_MASK(vend, 0xffff, dev) | |
d9ea472c | 452 | #define SND_PCI_QUIRK_ID(vend,dev) {_SND_PCI_QUIRK_ID(vend, dev)} |
62cf872a | 453 | #ifdef CONFIG_SND_DEBUG_VERBOSE |
d9ea472c TI |
454 | #define SND_PCI_QUIRK(vend,dev,xname,val) \ |
455 | {_SND_PCI_QUIRK_ID(vend, dev), .value = (val), .name = (xname)} | |
8bd4bb7a TI |
456 | #define SND_PCI_QUIRK_VENDOR(vend, xname, val) \ |
457 | {_SND_PCI_QUIRK_ID_MASK(vend, 0, 0), .value = (val), .name = (xname)} | |
458 | #define SND_PCI_QUIRK_MASK(vend, mask, dev, xname, val) \ | |
459 | {_SND_PCI_QUIRK_ID_MASK(vend, mask, dev), \ | |
460 | .value = (val), .name = (xname)} | |
86b27237 | 461 | #define snd_pci_quirk_name(q) ((q)->name) |
d9ea472c TI |
462 | #else |
463 | #define SND_PCI_QUIRK(vend,dev,xname,val) \ | |
464 | {_SND_PCI_QUIRK_ID(vend, dev), .value = (val)} | |
8bd4bb7a TI |
465 | #define SND_PCI_QUIRK_MASK(vend, mask, dev, xname, val) \ |
466 | {_SND_PCI_QUIRK_ID_MASK(vend, mask, dev), .value = (val)} | |
467 | #define SND_PCI_QUIRK_VENDOR(vend, xname, val) \ | |
468 | {_SND_PCI_QUIRK_ID_MASK(vend, 0, 0), .value = (val)} | |
86b27237 | 469 | #define snd_pci_quirk_name(q) "" |
d9ea472c TI |
470 | #endif |
471 | ||
472 | const struct snd_pci_quirk * | |
473 | snd_pci_quirk_lookup(struct pci_dev *pci, const struct snd_pci_quirk *list); | |
474 | ||
d1458279 TI |
475 | const struct snd_pci_quirk * |
476 | snd_pci_quirk_lookup_id(u16 vendor, u16 device, | |
477 | const struct snd_pci_quirk *list); | |
8422fa11 | 478 | #endif |
d9ea472c | 479 | |
1da177e4 | 480 | #endif /* __SOUND_CORE_H */ |