]>
Commit | Line | Data |
---|---|---|
1a59d1b8 | 1 | /* SPDX-License-Identifier: GPL-2.0-or-later */ |
1da177e4 LT |
2 | #ifndef __SOUND_CORE_H |
3 | #define __SOUND_CORE_H | |
4 | ||
5 | /* | |
6 | * Main header file for the ALSA driver | |
c1017a4c | 7 | * Copyright (c) 1994-2001 by Jaroslav Kysela <perex@perex.cz> |
1da177e4 LT |
8 | */ |
9 | ||
8bfb181c | 10 | #include <linux/device.h> |
1da177e4 | 11 | #include <linux/sched.h> /* wake_up() */ |
1a60d4c5 | 12 | #include <linux/mutex.h> /* struct mutex */ |
1da177e4 | 13 | #include <linux/rwsem.h> /* struct rw_semaphore */ |
1da177e4 | 14 | #include <linux/pm.h> /* pm_message_t */ |
5ef03460 | 15 | #include <linux/stringify.h> |
bcbb1553 | 16 | #include <linux/printk.h> |
1da177e4 | 17 | |
9004acc7 TI |
18 | /* number of supported soundcards */ |
19 | #ifdef CONFIG_SND_DYNAMIC_MINORS | |
7bb2491b | 20 | #define SNDRV_CARDS CONFIG_SND_MAX_CARDS |
9004acc7 TI |
21 | #else |
22 | #define SNDRV_CARDS 8 /* don't change - minor numbers */ | |
23 | #endif | |
24 | ||
25 | #define CONFIG_SND_MAJOR 116 /* standard configuration */ | |
26 | ||
1da177e4 | 27 | /* forward declarations */ |
1da177e4 | 28 | struct pci_dev; |
de477254 | 29 | struct module; |
f2464064 | 30 | struct completion; |
1da177e4 LT |
31 | |
32 | /* device allocation stuff */ | |
33 | ||
289ca025 TI |
34 | /* type of the object used in snd_device_*() |
35 | * this also defines the calling order | |
36 | */ | |
9ce50543 | 37 | enum snd_device_type { |
289ca025 | 38 | SNDRV_DEV_LOWLEVEL, |
289ca025 TI |
39 | SNDRV_DEV_INFO, |
40 | SNDRV_DEV_BUS, | |
41 | SNDRV_DEV_CODEC, | |
9ce50543 | 42 | SNDRV_DEV_PCM, |
289ca025 | 43 | SNDRV_DEV_COMPRESS, |
9ce50543 TI |
44 | SNDRV_DEV_RAWMIDI, |
45 | SNDRV_DEV_TIMER, | |
46 | SNDRV_DEV_SEQUENCER, | |
47 | SNDRV_DEV_HWDEP, | |
9ce50543 | 48 | SNDRV_DEV_JACK, |
dc82e524 | 49 | SNDRV_DEV_CONTROL, /* NOTE: this must be the last one */ |
9ce50543 TI |
50 | }; |
51 | ||
52 | enum snd_device_state { | |
53 | SNDRV_DEV_BUILD, | |
54 | SNDRV_DEV_REGISTERED, | |
55 | SNDRV_DEV_DISCONNECTED, | |
56 | }; | |
57 | ||
512bbd6a TI |
58 | struct snd_device; |
59 | ||
60 | struct snd_device_ops { | |
61 | int (*dev_free)(struct snd_device *dev); | |
62 | int (*dev_register)(struct snd_device *dev); | |
63 | int (*dev_disconnect)(struct snd_device *dev); | |
512bbd6a TI |
64 | }; |
65 | ||
66 | struct snd_device { | |
1da177e4 | 67 | struct list_head list; /* list of registered devices */ |
512bbd6a | 68 | struct snd_card *card; /* card which holds this device */ |
9ce50543 TI |
69 | enum snd_device_state state; /* state of the device */ |
70 | enum snd_device_type type; /* device type */ | |
1da177e4 | 71 | void *device_data; /* device structure */ |
8b575824 | 72 | const struct snd_device_ops *ops; /* operations */ |
1da177e4 LT |
73 | }; |
74 | ||
512bbd6a | 75 | #define snd_device(n) list_entry(n, struct snd_device, list) |
1da177e4 | 76 | |
1da177e4 LT |
77 | /* main structure for soundcard */ |
78 | ||
512bbd6a | 79 | struct snd_card { |
d5750f67 HK |
80 | int number; /* number of soundcard (index to |
81 | snd_cards) */ | |
1da177e4 LT |
82 | |
83 | char id[16]; /* id string of this card */ | |
84 | char driver[16]; /* driver name */ | |
85 | char shortname[32]; /* short name of this soundcard */ | |
86 | char longname[80]; /* name of this soundcard */ | |
de65360b | 87 | char irq_descr[32]; /* Interrupt description */ |
1da177e4 | 88 | char mixername[80]; /* mixer name */ |
ff33f230 | 89 | char components[128]; /* card components delimited with |
d5750f67 | 90 | space */ |
1da177e4 LT |
91 | struct module *module; /* top-level module */ |
92 | ||
93 | void *private_data; /* private data for soundcard */ | |
512bbd6a | 94 | void (*private_free) (struct snd_card *card); /* callback for freeing of |
d5750f67 | 95 | private data */ |
1da177e4 LT |
96 | struct list_head devices; /* devices */ |
97 | ||
0fcd9f4b | 98 | struct device ctl_dev; /* control device */ |
1da177e4 LT |
99 | unsigned int last_numid; /* last used numeric ID */ |
100 | struct rw_semaphore controls_rwsem; /* controls list lock */ | |
101 | rwlock_t ctl_files_rwlock; /* ctl_files list lock */ | |
102 | int controls_count; /* count of all controls */ | |
66c6d1ef | 103 | size_t user_ctl_alloc_size; // current memory allocation by user controls. |
1da177e4 LT |
104 | struct list_head controls; /* all controls for this card */ |
105 | struct list_head ctl_files; /* active control files */ | |
106 | ||
512bbd6a | 107 | struct snd_info_entry *proc_root; /* root for soundcard specific files */ |
1da177e4 LT |
108 | struct proc_dir_entry *proc_root_link; /* number link to real id */ |
109 | ||
118dd6bf | 110 | struct list_head files_list; /* all files associated to this card */ |
d5750f67 HK |
111 | struct snd_shutdown_f_ops *s_f_ops; /* file operations in the shutdown |
112 | state */ | |
1da177e4 LT |
113 | spinlock_t files_lock; /* lock the files for this card */ |
114 | int shutdown; /* this card is going down */ | |
f2464064 | 115 | struct completion *release_completion; |
7d2aae1e | 116 | struct device *dev; /* device assigned to this card */ |
8bfb181c | 117 | struct device card_dev; /* cardX object for sysfs */ |
6bbc7fed | 118 | const struct attribute_group *dev_groups[4]; /* assigned sysfs attr */ |
8bfb181c | 119 | bool registered; /* card_dev is registered? */ |
e8ad415b TI |
120 | bool managed; /* managed via devres */ |
121 | bool releasing; /* during card free process */ | |
fabb26dc | 122 | int sync_irq; /* assigned irq, used for PCM sync */ |
c44027c8 | 123 | wait_queue_head_t remove_sleep; |
1da177e4 | 124 | |
d4cfb30f TI |
125 | size_t total_pcm_alloc_bytes; /* total amount of allocated buffers */ |
126 | struct mutex memory_mutex; /* protection for the above */ | |
2d670ea2 HW |
127 | #ifdef CONFIG_SND_DEBUG |
128 | struct dentry *debugfs_root; /* debugfs root for card */ | |
129 | #endif | |
d4cfb30f | 130 | |
1da177e4 | 131 | #ifdef CONFIG_PM |
1da177e4 | 132 | unsigned int power_state; /* power state */ |
e94fdbd7 | 133 | atomic_t power_ref; |
1da177e4 | 134 | wait_queue_head_t power_sleep; |
e94fdbd7 | 135 | wait_queue_head_t power_ref_sleep; |
1da177e4 LT |
136 | #endif |
137 | ||
6d2412b8 | 138 | #if IS_ENABLED(CONFIG_SND_MIXER_OSS) |
512bbd6a | 139 | struct snd_mixer_oss *mixer_oss; |
1da177e4 LT |
140 | int mixer_oss_change_count; |
141 | #endif | |
142 | }; | |
143 | ||
8bfb181c TI |
144 | #define dev_to_snd_card(p) container_of(p, struct snd_card, card_dev) |
145 | ||
1da177e4 | 146 | #ifdef CONFIG_PM |
512bbd6a | 147 | static inline unsigned int snd_power_get_state(struct snd_card *card) |
1da177e4 | 148 | { |
533a7ed9 | 149 | return READ_ONCE(card->power_state); |
1da177e4 LT |
150 | } |
151 | ||
512bbd6a | 152 | static inline void snd_power_change_state(struct snd_card *card, unsigned int state) |
1da177e4 | 153 | { |
533a7ed9 | 154 | WRITE_ONCE(card->power_state, state); |
1da177e4 LT |
155 | wake_up(&card->power_sleep); |
156 | } | |
d5750f67 | 157 | |
e94fdbd7 TI |
158 | /** |
159 | * snd_power_ref - Take the reference count for power control | |
160 | * @card: sound card object | |
161 | * | |
162 | * The power_ref reference of the card is used for managing to block | |
163 | * the snd_power_sync_ref() operation. This function increments the reference. | |
164 | * The counterpart snd_power_unref() has to be called appropriately later. | |
165 | */ | |
166 | static inline void snd_power_ref(struct snd_card *card) | |
167 | { | |
168 | atomic_inc(&card->power_ref); | |
169 | } | |
170 | ||
171 | /** | |
172 | * snd_power_unref - Release the reference count for power control | |
173 | * @card: sound card object | |
174 | */ | |
175 | static inline void snd_power_unref(struct snd_card *card) | |
176 | { | |
177 | if (atomic_dec_and_test(&card->power_ref)) | |
178 | wake_up(&card->power_ref_sleep); | |
179 | } | |
180 | ||
181 | /** | |
182 | * snd_power_sync_ref - wait until the card power_ref is freed | |
183 | * @card: sound card object | |
184 | * | |
185 | * This function is used to synchronize with the pending power_ref being | |
186 | * released. | |
187 | */ | |
188 | static inline void snd_power_sync_ref(struct snd_card *card) | |
189 | { | |
190 | wait_event(card->power_ref_sleep, !atomic_read(&card->power_ref)); | |
191 | } | |
192 | ||
d5750f67 | 193 | /* init.c */ |
b6cc78da | 194 | int snd_power_wait(struct snd_card *card); |
e94fdbd7 | 195 | int snd_power_ref_and_wait(struct snd_card *card); |
d5750f67 | 196 | |
1da177e4 LT |
197 | #else /* ! CONFIG_PM */ |
198 | ||
b6cc78da | 199 | static inline int snd_power_wait(struct snd_card *card) { return 0; } |
e94fdbd7 TI |
200 | static inline void snd_power_ref(struct snd_card *card) {} |
201 | static inline void snd_power_unref(struct snd_card *card) {} | |
202 | static inline int snd_power_ref_and_wait(struct snd_card *card) { return 0; } | |
203 | static inline void snd_power_sync_ref(struct snd_card *card) {} | |
363129ea | 204 | #define snd_power_get_state(card) ({ (void)(card); SNDRV_CTL_POWER_D0; }) |
1da177e4 | 205 | #define snd_power_change_state(card, state) do { (void)(card); } while (0) |
1da177e4 LT |
206 | |
207 | #endif /* CONFIG_PM */ | |
208 | ||
512bbd6a | 209 | struct snd_minor { |
2af677fc | 210 | int type; /* SNDRV_DEVICE_TYPE_XXX */ |
6983b724 | 211 | int card; /* card number */ |
1da177e4 | 212 | int device; /* device number */ |
99ac48f5 | 213 | const struct file_operations *f_ops; /* file operations */ |
f87135f5 | 214 | void *private_data; /* private data for f_ops->open */ |
d80f19fa | 215 | struct device *dev; /* device for sysfs */ |
a0830dbd | 216 | struct snd_card *card_ptr; /* assigned card instance */ |
1da177e4 LT |
217 | }; |
218 | ||
7d2aae1e TI |
219 | /* return a device pointer linked to each sound device as a parent */ |
220 | static inline struct device *snd_card_get_device_link(struct snd_card *card) | |
221 | { | |
8bfb181c | 222 | return card ? &card->card_dev : NULL; |
7d2aae1e TI |
223 | } |
224 | ||
1da177e4 LT |
225 | /* sound.c */ |
226 | ||
f1902860 | 227 | extern int snd_major; |
1da177e4 | 228 | extern int snd_ecards_limit; |
d80f19fa | 229 | extern struct class *sound_class; |
2d670ea2 HW |
230 | #ifdef CONFIG_SND_DEBUG |
231 | extern struct dentry *sound_debugfs_root; | |
232 | #endif | |
1da177e4 LT |
233 | |
234 | void snd_request_card(int card); | |
235 | ||
4b440be6 TI |
236 | void snd_device_initialize(struct device *dev, struct snd_card *card); |
237 | ||
40a4b263 TI |
238 | int snd_register_device(int type, struct snd_card *card, int dev, |
239 | const struct file_operations *f_ops, | |
240 | void *private_data, struct device *device); | |
241 | int snd_unregister_device(struct device *dev); | |
f87135f5 | 242 | void *snd_lookup_minor_data(unsigned int minor, int type); |
1da177e4 LT |
243 | |
244 | #ifdef CONFIG_SND_OSSEMUL | |
2af677fc | 245 | int snd_register_oss_device(int type, struct snd_card *card, int dev, |
80d7d771 | 246 | const struct file_operations *f_ops, void *private_data); |
512bbd6a | 247 | int snd_unregister_oss_device(int type, struct snd_card *card, int dev); |
f87135f5 | 248 | void *snd_lookup_oss_minor_data(unsigned int minor, int type); |
1da177e4 LT |
249 | #endif |
250 | ||
251 | int snd_minor_info_init(void); | |
1da177e4 LT |
252 | |
253 | /* sound_oss.c */ | |
254 | ||
255 | #ifdef CONFIG_SND_OSSEMUL | |
256 | int snd_minor_info_oss_init(void); | |
1da177e4 | 257 | #else |
ad5fada5 | 258 | static inline int snd_minor_info_oss_init(void) { return 0; } |
1da177e4 LT |
259 | #endif |
260 | ||
261 | /* memory.c */ | |
262 | ||
1da177e4 LT |
263 | int copy_to_user_fromio(void __user *dst, const volatile void __iomem *src, size_t count); |
264 | int copy_from_user_toio(volatile void __iomem *dst, const void __user *src, size_t count); | |
265 | ||
266 | /* init.c */ | |
267 | ||
746df948 | 268 | int snd_card_locked(int card); |
6d2412b8 | 269 | #if IS_ENABLED(CONFIG_SND_MIXER_OSS) |
1da177e4 LT |
270 | #define SND_MIXER_OSS_NOTIFY_REGISTER 0 |
271 | #define SND_MIXER_OSS_NOTIFY_DISCONNECT 1 | |
272 | #define SND_MIXER_OSS_NOTIFY_FREE 2 | |
512bbd6a | 273 | extern int (*snd_mixer_oss_notify_callback)(struct snd_card *card, int cmd); |
1da177e4 LT |
274 | #endif |
275 | ||
393aa9c1 TI |
276 | int snd_card_new(struct device *parent, int idx, const char *xid, |
277 | struct module *module, int extra_size, | |
278 | struct snd_card **card_ret); | |
e8ad415b TI |
279 | int snd_devm_card_new(struct device *parent, int idx, const char *xid, |
280 | struct module *module, size_t extra_size, | |
281 | struct snd_card **card_ret); | |
393aa9c1 | 282 | |
512bbd6a | 283 | int snd_card_disconnect(struct snd_card *card); |
c44027c8 | 284 | void snd_card_disconnect_sync(struct snd_card *card); |
512bbd6a | 285 | int snd_card_free(struct snd_card *card); |
c461482c | 286 | int snd_card_free_when_closed(struct snd_card *card); |
1563e4fa | 287 | int snd_card_free_on_error(struct device *dev, int ret); |
10a8ebbb | 288 | void snd_card_set_id(struct snd_card *card, const char *id); |
512bbd6a | 289 | int snd_card_register(struct snd_card *card); |
1da177e4 | 290 | int snd_card_info_init(void); |
6bbc7fed TI |
291 | int snd_card_add_dev_attr(struct snd_card *card, |
292 | const struct attribute_group *group); | |
512bbd6a TI |
293 | int snd_component_add(struct snd_card *card, const char *component); |
294 | int snd_card_file_add(struct snd_card *card, struct file *file); | |
295 | int snd_card_file_remove(struct snd_card *card, struct file *file); | |
f4fa9689 TI |
296 | |
297 | struct snd_card *snd_card_ref(int card); | |
298 | ||
299 | /** | |
300 | * snd_card_unref - Unreference the card object | |
301 | * @card: the card object to unreference | |
302 | * | |
303 | * Call this function for the card object that was obtained via snd_card_ref() | |
304 | * or snd_lookup_minor_data(). | |
305 | */ | |
306 | static inline void snd_card_unref(struct snd_card *card) | |
307 | { | |
308 | put_device(&card->card_dev); | |
309 | } | |
1da177e4 | 310 | |
edab938e | 311 | #define snd_card_set_dev(card, devptr) ((card)->dev = (devptr)) |
1da177e4 LT |
312 | |
313 | /* device.c */ | |
314 | ||
9ce50543 | 315 | int snd_device_new(struct snd_card *card, enum snd_device_type type, |
8b575824 | 316 | void *device_data, const struct snd_device_ops *ops); |
512bbd6a TI |
317 | int snd_device_register(struct snd_card *card, void *device_data); |
318 | int snd_device_register_all(struct snd_card *card); | |
e086e303 TI |
319 | void snd_device_disconnect(struct snd_card *card, void *device_data); |
320 | void snd_device_disconnect_all(struct snd_card *card); | |
72620d60 TI |
321 | void snd_device_free(struct snd_card *card, void *device_data); |
322 | void snd_device_free_all(struct snd_card *card); | |
c208a533 | 323 | int snd_device_get_state(struct snd_card *card, void *device_data); |
1da177e4 LT |
324 | |
325 | /* isadma.c */ | |
326 | ||
276bd31c | 327 | #ifdef CONFIG_ISA_DMA_API |
1da177e4 LT |
328 | #define DMA_MODE_NO_ENABLE 0x0100 |
329 | ||
330 | void snd_dma_program(unsigned long dma, unsigned long addr, unsigned int size, unsigned short mode); | |
331 | void snd_dma_disable(unsigned long dma); | |
332 | unsigned int snd_dma_pointer(unsigned long dma, unsigned int size); | |
c2b94954 | 333 | int snd_devm_request_dma(struct device *dev, int dma, const char *name); |
276bd31c | 334 | #endif |
1da177e4 LT |
335 | |
336 | /* misc.c */ | |
b709e574 | 337 | struct resource; |
b1d5776d | 338 | void release_and_free_resource(struct resource *res); |
1da177e4 | 339 | |
1da177e4 LT |
340 | /* --- */ |
341 | ||
fae3d88a FW |
342 | /* sound printk debug levels */ |
343 | enum { | |
344 | SND_PR_ALWAYS, | |
345 | SND_PR_DEBUG, | |
346 | SND_PR_VERBOSE, | |
347 | }; | |
348 | ||
36ce99c1 | 349 | #if defined(CONFIG_SND_DEBUG) || defined(CONFIG_SND_VERBOSE_PRINTK) |
b9075fa9 | 350 | __printf(4, 5) |
36ce99c1 | 351 | void __snd_printk(unsigned int level, const char *file, int line, |
b9075fa9 | 352 | const char *format, ...); |
36ce99c1 | 353 | #else |
43e575fa TI |
354 | #define __snd_printk(level, file, line, format, ...) \ |
355 | printk(format, ##__VA_ARGS__) | |
36ce99c1 TI |
356 | #endif |
357 | ||
1da177e4 LT |
358 | /** |
359 | * snd_printk - printk wrapper | |
360 | * @fmt: format string | |
361 | * | |
f66fcedc | 362 | * Works like printk() but prints the file and the line of the caller |
1da177e4 LT |
363 | * when configured with CONFIG_SND_VERBOSE_PRINTK. |
364 | */ | |
43e575fa TI |
365 | #define snd_printk(fmt, ...) \ |
366 | __snd_printk(0, __FILE__, __LINE__, fmt, ##__VA_ARGS__) | |
1da177e4 LT |
367 | |
368 | #ifdef CONFIG_SND_DEBUG | |
1da177e4 LT |
369 | /** |
370 | * snd_printd - debug printk | |
0863afb3 | 371 | * @fmt: format string |
1da177e4 | 372 | * |
edab938e | 373 | * Works like snd_printk() for debugging purposes. |
1da177e4 LT |
374 | * Ignored when CONFIG_SND_DEBUG is not set. |
375 | */ | |
43e575fa TI |
376 | #define snd_printd(fmt, ...) \ |
377 | __snd_printk(1, __FILE__, __LINE__, fmt, ##__VA_ARGS__) | |
378 | #define _snd_printd(level, fmt, ...) \ | |
379 | __snd_printk(level, __FILE__, __LINE__, fmt, ##__VA_ARGS__) | |
7c22f1aa | 380 | |
f66fcedc TI |
381 | /** |
382 | * snd_BUG - give a BUG warning message and stack trace | |
383 | * | |
384 | * Calls WARN() if CONFIG_SND_DEBUG is set. | |
385 | * Ignored when CONFIG_SND_DEBUG is not set. | |
386 | */ | |
bdbecf50 | 387 | #define snd_BUG() WARN(1, "BUG?\n") |
f66fcedc | 388 | |
bcbb1553 | 389 | /** |
f7b6603c MCC |
390 | * snd_printd_ratelimit - Suppress high rates of output when |
391 | * CONFIG_SND_DEBUG is enabled. | |
bcbb1553 TG |
392 | */ |
393 | #define snd_printd_ratelimit() printk_ratelimit() | |
394 | ||
f66fcedc TI |
395 | /** |
396 | * snd_BUG_ON - debugging check macro | |
397 | * @cond: condition to evaluate | |
398 | * | |
d5702162 CS |
399 | * Has the same behavior as WARN_ON when CONFIG_SND_DEBUG is set, |
400 | * otherwise just evaluates the conditional and returns the value. | |
f66fcedc | 401 | */ |
d5702162 | 402 | #define snd_BUG_ON(cond) WARN_ON((cond)) |
1da177e4 LT |
403 | |
404 | #else /* !CONFIG_SND_DEBUG */ | |
405 | ||
86b27237 TI |
406 | __printf(1, 2) |
407 | static inline void snd_printd(const char *format, ...) {} | |
408 | __printf(2, 3) | |
409 | static inline void _snd_printd(int level, const char *format, ...) {} | |
410 | ||
fcef7836 | 411 | #define snd_BUG() do { } while (0) |
d5702162 CS |
412 | |
413 | #define snd_BUG_ON(condition) ({ \ | |
414 | int __ret_warn_on = !!(condition); \ | |
415 | unlikely(__ret_warn_on); \ | |
416 | }) | |
1da177e4 | 417 | |
bcbb1553 TG |
418 | static inline bool snd_printd_ratelimit(void) { return false; } |
419 | ||
1da177e4 LT |
420 | #endif /* CONFIG_SND_DEBUG */ |
421 | ||
62cf872a | 422 | #ifdef CONFIG_SND_DEBUG_VERBOSE |
1da177e4 LT |
423 | /** |
424 | * snd_printdd - debug printk | |
425 | * @format: format string | |
426 | * | |
edab938e | 427 | * Works like snd_printk() for debugging purposes. |
62cf872a | 428 | * Ignored when CONFIG_SND_DEBUG_VERBOSE is not set. |
1da177e4 | 429 | */ |
43e575fa TI |
430 | #define snd_printdd(format, ...) \ |
431 | __snd_printk(2, __FILE__, __LINE__, format, ##__VA_ARGS__) | |
1da177e4 | 432 | #else |
86b27237 TI |
433 | __printf(1, 2) |
434 | static inline void snd_printdd(const char *format, ...) {} | |
1da177e4 LT |
435 | #endif |
436 | ||
1da177e4 | 437 | |
1da177e4 LT |
438 | #define SNDRV_OSS_VERSION ((3<<16)|(8<<8)|(1<<4)|(0)) /* 3.8.1a */ |
439 | ||
440 | /* for easier backward-porting */ | |
6d2412b8 | 441 | #if IS_ENABLED(CONFIG_GAMEPORT) |
1da177e4 LT |
442 | #define gameport_set_dev_parent(gp,xdev) ((gp)->dev.parent = (xdev)) |
443 | #define gameport_set_port_data(gp,r) ((gp)->port_data = (r)) | |
444 | #define gameport_get_port_data(gp) (gp)->port_data | |
445 | #endif | |
1da177e4 | 446 | |
d9ea472c TI |
447 | /* PCI quirk list helper */ |
448 | struct snd_pci_quirk { | |
449 | unsigned short subvendor; /* PCI subvendor ID */ | |
450 | unsigned short subdevice; /* PCI subdevice ID */ | |
8bd4bb7a | 451 | unsigned short subdevice_mask; /* bitmask to match */ |
d9ea472c | 452 | int value; /* value */ |
62cf872a | 453 | #ifdef CONFIG_SND_DEBUG_VERBOSE |
d9ea472c TI |
454 | const char *name; /* name of the device (optional) */ |
455 | #endif | |
456 | }; | |
457 | ||
8bd4bb7a TI |
458 | #define _SND_PCI_QUIRK_ID_MASK(vend, mask, dev) \ |
459 | .subvendor = (vend), .subdevice = (dev), .subdevice_mask = (mask) | |
460 | #define _SND_PCI_QUIRK_ID(vend, dev) \ | |
461 | _SND_PCI_QUIRK_ID_MASK(vend, 0xffff, dev) | |
d9ea472c | 462 | #define SND_PCI_QUIRK_ID(vend,dev) {_SND_PCI_QUIRK_ID(vend, dev)} |
62cf872a | 463 | #ifdef CONFIG_SND_DEBUG_VERBOSE |
d9ea472c TI |
464 | #define SND_PCI_QUIRK(vend,dev,xname,val) \ |
465 | {_SND_PCI_QUIRK_ID(vend, dev), .value = (val), .name = (xname)} | |
8bd4bb7a TI |
466 | #define SND_PCI_QUIRK_VENDOR(vend, xname, val) \ |
467 | {_SND_PCI_QUIRK_ID_MASK(vend, 0, 0), .value = (val), .name = (xname)} | |
468 | #define SND_PCI_QUIRK_MASK(vend, mask, dev, xname, val) \ | |
469 | {_SND_PCI_QUIRK_ID_MASK(vend, mask, dev), \ | |
470 | .value = (val), .name = (xname)} | |
86b27237 | 471 | #define snd_pci_quirk_name(q) ((q)->name) |
d9ea472c TI |
472 | #else |
473 | #define SND_PCI_QUIRK(vend,dev,xname,val) \ | |
474 | {_SND_PCI_QUIRK_ID(vend, dev), .value = (val)} | |
8bd4bb7a TI |
475 | #define SND_PCI_QUIRK_MASK(vend, mask, dev, xname, val) \ |
476 | {_SND_PCI_QUIRK_ID_MASK(vend, mask, dev), .value = (val)} | |
477 | #define SND_PCI_QUIRK_VENDOR(vend, xname, val) \ | |
478 | {_SND_PCI_QUIRK_ID_MASK(vend, 0, 0), .value = (val)} | |
86b27237 | 479 | #define snd_pci_quirk_name(q) "" |
d9ea472c TI |
480 | #endif |
481 | ||
f0a220de | 482 | #ifdef CONFIG_PCI |
d9ea472c TI |
483 | const struct snd_pci_quirk * |
484 | snd_pci_quirk_lookup(struct pci_dev *pci, const struct snd_pci_quirk *list); | |
485 | ||
d1458279 TI |
486 | const struct snd_pci_quirk * |
487 | snd_pci_quirk_lookup_id(u16 vendor, u16 device, | |
488 | const struct snd_pci_quirk *list); | |
f0a220de DR |
489 | #else |
490 | static inline const struct snd_pci_quirk * | |
491 | snd_pci_quirk_lookup(struct pci_dev *pci, const struct snd_pci_quirk *list) | |
492 | { | |
493 | return NULL; | |
494 | } | |
495 | ||
496 | static inline const struct snd_pci_quirk * | |
497 | snd_pci_quirk_lookup_id(u16 vendor, u16 device, | |
498 | const struct snd_pci_quirk *list) | |
499 | { | |
500 | return NULL; | |
501 | } | |
8422fa11 | 502 | #endif |
d9ea472c | 503 | |
1da177e4 | 504 | #endif /* __SOUND_CORE_H */ |