core.h revision 36ce99c1dcab2978fc1900f19b431adedd8f99f6
11da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#ifndef __SOUND_CORE_H
21da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#define __SOUND_CORE_H
31da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
41da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/*
51da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds *  Main header file for the ALSA driver
6c1017a4cdb68ae5368fbc9ee42c77f1f5dca8916Jaroslav Kysela *  Copyright (c) 1994-2001 by Jaroslav Kysela <perex@perex.cz>
71da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds *
81da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds *
91da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds *   This program is free software; you can redistribute it and/or modify
101da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds *   it under the terms of the GNU General Public License as published by
111da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds *   the Free Software Foundation; either version 2 of the License, or
121da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds *   (at your option) any later version.
131da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds *
141da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds *   This program is distributed in the hope that it will be useful,
151da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds *   but WITHOUT ANY WARRANTY; without even the implied warranty of
161da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
171da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds *   GNU General Public License for more details.
181da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds *
191da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds *   You should have received a copy of the GNU General Public License
201da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds *   along with this program; if not, write to the Free Software
211da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds *   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
221da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds *
231da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds */
241da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
259004acc70e8c49c50c4c7b652f906f1e0ed5709dTakashi Iwai#include <linux/module.h>
261da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#include <linux/sched.h>		/* wake_up() */
271a60d4c5a0c4028559585a74e48593b16e1ca9b2Ingo Molnar#include <linux/mutex.h>		/* struct mutex */
281da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#include <linux/rwsem.h>		/* struct rw_semaphore */
291da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#include <linux/pm.h>			/* pm_message_t */
309d19f48cfe2570562c2c6226780a7ca627b0f1f1Takashi Iwai#include <linux/device.h>
315ef03460a6ffc1d3ee6b6f2abc6765d3e224cf89Takashi Iwai#include <linux/stringify.h>
321da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
339004acc70e8c49c50c4c7b652f906f1e0ed5709dTakashi Iwai/* number of supported soundcards */
349004acc70e8c49c50c4c7b652f906f1e0ed5709dTakashi Iwai#ifdef CONFIG_SND_DYNAMIC_MINORS
359004acc70e8c49c50c4c7b652f906f1e0ed5709dTakashi Iwai#define SNDRV_CARDS 32
369004acc70e8c49c50c4c7b652f906f1e0ed5709dTakashi Iwai#else
379004acc70e8c49c50c4c7b652f906f1e0ed5709dTakashi Iwai#define SNDRV_CARDS 8		/* don't change - minor numbers */
389004acc70e8c49c50c4c7b652f906f1e0ed5709dTakashi Iwai#endif
399004acc70e8c49c50c4c7b652f906f1e0ed5709dTakashi Iwai
409004acc70e8c49c50c4c7b652f906f1e0ed5709dTakashi Iwai#define CONFIG_SND_MAJOR	116	/* standard configuration */
419004acc70e8c49c50c4c7b652f906f1e0ed5709dTakashi Iwai
421da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/* forward declarations */
431da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#ifdef CONFIG_PCI
441da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvaldsstruct pci_dev;
451da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#endif
461da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
471da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/* device allocation stuff */
481da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
491da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#define SNDRV_DEV_TYPE_RANGE_SIZE		0x1000
501da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
51512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwaitypedef int __bitwise snd_device_type_t;
52512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwai#define	SNDRV_DEV_TOPLEVEL	((__force snd_device_type_t) 0)
53512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwai#define	SNDRV_DEV_CONTROL	((__force snd_device_type_t) 1)
54512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwai#define	SNDRV_DEV_LOWLEVEL_PRE	((__force snd_device_type_t) 2)
55512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwai#define	SNDRV_DEV_LOWLEVEL_NORMAL ((__force snd_device_type_t) 0x1000)
56512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwai#define	SNDRV_DEV_PCM		((__force snd_device_type_t) 0x1001)
57512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwai#define	SNDRV_DEV_RAWMIDI	((__force snd_device_type_t) 0x1002)
58512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwai#define	SNDRV_DEV_TIMER		((__force snd_device_type_t) 0x1003)
59512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwai#define	SNDRV_DEV_SEQUENCER	((__force snd_device_type_t) 0x1004)
60512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwai#define	SNDRV_DEV_HWDEP		((__force snd_device_type_t) 0x1005)
61512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwai#define	SNDRV_DEV_INFO		((__force snd_device_type_t) 0x1006)
62512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwai#define	SNDRV_DEV_BUS		((__force snd_device_type_t) 0x1007)
63512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwai#define	SNDRV_DEV_CODEC		((__force snd_device_type_t) 0x1008)
64e76d8ceaaff9d7fc1ba2b1963a9f34151832223bMark Brown#define	SNDRV_DEV_JACK          ((__force snd_device_type_t) 0x1009)
65512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwai#define	SNDRV_DEV_LOWLEVEL	((__force snd_device_type_t) 0x2000)
66512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwai
67512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwaitypedef int __bitwise snd_device_state_t;
68512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwai#define	SNDRV_DEV_BUILD		((__force snd_device_state_t) 0)
69512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwai#define	SNDRV_DEV_REGISTERED	((__force snd_device_state_t) 1)
70512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwai#define	SNDRV_DEV_DISCONNECTED	((__force snd_device_state_t) 2)
71512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwai
72512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwaitypedef int __bitwise snd_device_cmd_t;
73512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwai#define	SNDRV_DEV_CMD_PRE	((__force snd_device_cmd_t) 0)
74512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwai#define	SNDRV_DEV_CMD_NORMAL	((__force snd_device_cmd_t) 1)
75512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwai#define	SNDRV_DEV_CMD_POST	((__force snd_device_cmd_t) 2)
76512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwai
77512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwaistruct snd_device;
78512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwai
79512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwaistruct snd_device_ops {
80512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwai	int (*dev_free)(struct snd_device *dev);
81512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwai	int (*dev_register)(struct snd_device *dev);
82512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwai	int (*dev_disconnect)(struct snd_device *dev);
83512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwai};
84512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwai
85512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwaistruct snd_device {
861da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	struct list_head list;		/* list of registered devices */
87512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwai	struct snd_card *card;		/* card which holds this device */
881da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	snd_device_state_t state;	/* state of the device */
891da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	snd_device_type_t type;		/* device type */
901da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	void *device_data;		/* device structure */
91512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwai	struct snd_device_ops *ops;	/* operations */
921da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds};
931da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
94512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwai#define snd_device(n) list_entry(n, struct snd_device, list)
951da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
961da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/* monitor files for graceful shutdown (hotplug) */
971da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
981da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvaldsstruct snd_monitor_file {
991da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	struct file *file;
100a9edfc60227a1dc5c741666ff252a6055b73b184Karsten Wiese	const struct file_operations *disconnected_f_op;
101118dd6bfe7e0cddc8ab417ead19cc76000e92773Takashi Iwai	struct list_head shutdown_list;	/* still need to shutdown */
102118dd6bfe7e0cddc8ab417ead19cc76000e92773Takashi Iwai	struct list_head list;	/* link of monitor files */
1031da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds};
1041da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
1051da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/* main structure for soundcard */
1061da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
107512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwaistruct snd_card {
108d5750f67853350373fc1d5698c3a58ea16eddf4cHenrik Kretzschmar	int number;			/* number of soundcard (index to
109d5750f67853350373fc1d5698c3a58ea16eddf4cHenrik Kretzschmar								snd_cards) */
1101da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
1111da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	char id[16];			/* id string of this card */
1121da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	char driver[16];		/* driver name */
1131da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	char shortname[32];		/* short name of this soundcard */
1141da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	char longname[80];		/* name of this soundcard */
1151da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	char mixername[80];		/* mixer name */
116ff33f2303b0ea8e5ac15af91de8d8538a5d58db1Takashi Iwai	char components[128];		/* card components delimited with
117d5750f67853350373fc1d5698c3a58ea16eddf4cHenrik Kretzschmar								space */
1181da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	struct module *module;		/* top-level module */
1191da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
1201da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	void *private_data;		/* private data for soundcard */
121512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwai	void (*private_free) (struct snd_card *card); /* callback for freeing of
122d5750f67853350373fc1d5698c3a58ea16eddf4cHenrik Kretzschmar								private data */
1231da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	struct list_head devices;	/* devices */
1241da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
1251da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	unsigned int last_numid;	/* last used numeric ID */
1261da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	struct rw_semaphore controls_rwsem;	/* controls list lock */
1271da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	rwlock_t ctl_files_rwlock;	/* ctl_files list lock */
1281da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	int controls_count;		/* count of all controls */
1291da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	int user_ctl_count;		/* count of all user controls */
1301da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	struct list_head controls;	/* all controls for this card */
1311da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	struct list_head ctl_files;	/* active control files */
1321da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
133512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwai	struct snd_info_entry *proc_root;	/* root for soundcard specific files */
134512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwai	struct snd_info_entry *proc_id;	/* the card id */
1351da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	struct proc_dir_entry *proc_root_link;	/* number link to real id */
1361da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
137118dd6bfe7e0cddc8ab417ead19cc76000e92773Takashi Iwai	struct list_head files_list;	/* all files associated to this card */
138d5750f67853350373fc1d5698c3a58ea16eddf4cHenrik Kretzschmar	struct snd_shutdown_f_ops *s_f_ops; /* file operations in the shutdown
139d5750f67853350373fc1d5698c3a58ea16eddf4cHenrik Kretzschmar								state */
1401da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	spinlock_t files_lock;		/* lock the files for this card */
1411da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	int shutdown;			/* this card is going down */
142c461482c8072bb073e6146db320d3da85cdc89adTakashi Iwai	int free_on_last_close;		/* free in context of file_release */
1431da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	wait_queue_head_t shutdown_sleep;
1447d2aae1e88660cf09be913e9754e45189dc33412Takashi Iwai	struct device *dev;		/* device assigned to this card */
1457d2aae1e88660cf09be913e9754e45189dc33412Takashi Iwai#ifndef CONFIG_SYSFS_DEPRECATED
1467d2aae1e88660cf09be913e9754e45189dc33412Takashi Iwai	struct device *card_dev;	/* cardX object for sysfs */
1477d2aae1e88660cf09be913e9754e45189dc33412Takashi Iwai#endif
1481da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
1491da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#ifdef CONFIG_PM
1501da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	unsigned int power_state;	/* power state */
1511a60d4c5a0c4028559585a74e48593b16e1ca9b2Ingo Molnar	struct mutex power_lock;	/* power lock */
1521da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	wait_queue_head_t power_sleep;
1531da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#endif
1541da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
1551da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#if defined(CONFIG_SND_MIXER_OSS) || defined(CONFIG_SND_MIXER_OSS_MODULE)
156512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwai	struct snd_mixer_oss *mixer_oss;
1571da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	int mixer_oss_change_count;
1581da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#endif
1591da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds};
1601da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
1611da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#ifdef CONFIG_PM
162512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwaistatic inline void snd_power_lock(struct snd_card *card)
1631da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{
1641a60d4c5a0c4028559585a74e48593b16e1ca9b2Ingo Molnar	mutex_lock(&card->power_lock);
1651da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds}
1661da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
167512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwaistatic inline void snd_power_unlock(struct snd_card *card)
1681da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{
1691a60d4c5a0c4028559585a74e48593b16e1ca9b2Ingo Molnar	mutex_unlock(&card->power_lock);
1701da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds}
1711da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
172512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwaistatic inline unsigned int snd_power_get_state(struct snd_card *card)
1731da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{
1741da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	return card->power_state;
1751da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds}
1761da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
177512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwaistatic inline void snd_power_change_state(struct snd_card *card, unsigned int state)
1781da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{
1791da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	card->power_state = state;
1801da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	wake_up(&card->power_sleep);
1811da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds}
182d5750f67853350373fc1d5698c3a58ea16eddf4cHenrik Kretzschmar
183d5750f67853350373fc1d5698c3a58ea16eddf4cHenrik Kretzschmar/* init.c */
184cbac4b0cb62d01cb0aaec7778410b8856f01186bTakashi Iwaiint snd_power_wait(struct snd_card *card, unsigned int power_state);
185d5750f67853350373fc1d5698c3a58ea16eddf4cHenrik Kretzschmar
1861da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#else /* ! CONFIG_PM */
1871da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
1881da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#define snd_power_lock(card)		do { (void)(card); } while (0)
1891da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#define snd_power_unlock(card)		do { (void)(card); } while (0)
1906fdb94bd95dc7a2effcbffa7a1d9e792cade57b6Linus Torvaldsstatic inline int snd_power_wait(struct snd_card *card, unsigned int state) { return 0; }
1911da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#define snd_power_get_state(card)	SNDRV_CTL_POWER_D0
1921da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#define snd_power_change_state(card, state)	do { (void)(card); } while (0)
1931da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
1941da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#endif /* CONFIG_PM */
1951da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
196512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwaistruct snd_minor {
1972af677fc884fc6dc79e65c99050ea607ac8bab9bClemens Ladisch	int type;			/* SNDRV_DEVICE_TYPE_XXX */
1986983b7240cd229787c3ee00e663ea94ea649d96aClemens Ladisch	int card;			/* card number */
1991da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	int device;			/* device number */
20099ac48f54a91d02140c497edc31dc57d4bc5c85dArjan van de Ven	const struct file_operations *f_ops;	/* file operations */
201f87135f56cb266e031f5ec081dfbde7e43f55e80Clemens Ladisch	void *private_data;		/* private data for f_ops->open */
202d80f19fab89cba8a6d16193154c8ff3edab00942Greg Kroah-Hartman	struct device *dev;		/* device for sysfs */
2031da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds};
2041da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
2057d2aae1e88660cf09be913e9754e45189dc33412Takashi Iwai/* return a device pointer linked to each sound device as a parent */
2067d2aae1e88660cf09be913e9754e45189dc33412Takashi Iwaistatic inline struct device *snd_card_get_device_link(struct snd_card *card)
2077d2aae1e88660cf09be913e9754e45189dc33412Takashi Iwai{
2087d2aae1e88660cf09be913e9754e45189dc33412Takashi Iwai#ifdef CONFIG_SYSFS_DEPRECATED
2097d2aae1e88660cf09be913e9754e45189dc33412Takashi Iwai	return card ? card->dev : NULL;
2107d2aae1e88660cf09be913e9754e45189dc33412Takashi Iwai#else
2117d2aae1e88660cf09be913e9754e45189dc33412Takashi Iwai	return card ? card->card_dev : NULL;
2127d2aae1e88660cf09be913e9754e45189dc33412Takashi Iwai#endif
2137d2aae1e88660cf09be913e9754e45189dc33412Takashi Iwai}
2147d2aae1e88660cf09be913e9754e45189dc33412Takashi Iwai
2151da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/* sound.c */
2161da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
217f1902860161ff212c515e7ea629e880fec856a37Clemens Ladischextern int snd_major;
2181da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvaldsextern int snd_ecards_limit;
219d80f19fab89cba8a6d16193154c8ff3edab00942Greg Kroah-Hartmanextern struct class *sound_class;
2201da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
2211da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvaldsvoid snd_request_card(int card);
2221da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
22312b131c4cf3eb1dc8a60082a434b7b100774c2e7Johannes Bergint snd_register_device_for_dev(int type, struct snd_card *card,
22412b131c4cf3eb1dc8a60082a434b7b100774c2e7Johannes Berg				int dev,
22512b131c4cf3eb1dc8a60082a434b7b100774c2e7Johannes Berg				const struct file_operations *f_ops,
22612b131c4cf3eb1dc8a60082a434b7b100774c2e7Johannes Berg				void *private_data,
22712b131c4cf3eb1dc8a60082a434b7b100774c2e7Johannes Berg				const char *name,
22812b131c4cf3eb1dc8a60082a434b7b100774c2e7Johannes Berg				struct device *device);
22912b131c4cf3eb1dc8a60082a434b7b100774c2e7Johannes Berg
23012b131c4cf3eb1dc8a60082a434b7b100774c2e7Johannes Berg/**
23112b131c4cf3eb1dc8a60082a434b7b100774c2e7Johannes Berg * snd_register_device - Register the ALSA device file for the card
23212b131c4cf3eb1dc8a60082a434b7b100774c2e7Johannes Berg * @type: the device type, SNDRV_DEVICE_TYPE_XXX
23312b131c4cf3eb1dc8a60082a434b7b100774c2e7Johannes Berg * @card: the card instance
23412b131c4cf3eb1dc8a60082a434b7b100774c2e7Johannes Berg * @dev: the device index
23512b131c4cf3eb1dc8a60082a434b7b100774c2e7Johannes Berg * @f_ops: the file operations
23612b131c4cf3eb1dc8a60082a434b7b100774c2e7Johannes Berg * @private_data: user pointer for f_ops->open()
23712b131c4cf3eb1dc8a60082a434b7b100774c2e7Johannes Berg * @name: the device file name
23812b131c4cf3eb1dc8a60082a434b7b100774c2e7Johannes Berg *
23912b131c4cf3eb1dc8a60082a434b7b100774c2e7Johannes Berg * Registers an ALSA device file for the given card.
24012b131c4cf3eb1dc8a60082a434b7b100774c2e7Johannes Berg * The operators have to be set in reg parameter.
24112b131c4cf3eb1dc8a60082a434b7b100774c2e7Johannes Berg *
24212b131c4cf3eb1dc8a60082a434b7b100774c2e7Johannes Berg * This function uses the card's device pointer to link to the
24312b131c4cf3eb1dc8a60082a434b7b100774c2e7Johannes Berg * correct &struct device.
24412b131c4cf3eb1dc8a60082a434b7b100774c2e7Johannes Berg *
24512b131c4cf3eb1dc8a60082a434b7b100774c2e7Johannes Berg * Returns zero if successful, or a negative error code on failure.
24612b131c4cf3eb1dc8a60082a434b7b100774c2e7Johannes Berg */
24712b131c4cf3eb1dc8a60082a434b7b100774c2e7Johannes Bergstatic inline int snd_register_device(int type, struct snd_card *card, int dev,
24812b131c4cf3eb1dc8a60082a434b7b100774c2e7Johannes Berg				      const struct file_operations *f_ops,
24912b131c4cf3eb1dc8a60082a434b7b100774c2e7Johannes Berg				      void *private_data,
25012b131c4cf3eb1dc8a60082a434b7b100774c2e7Johannes Berg				      const char *name)
25112b131c4cf3eb1dc8a60082a434b7b100774c2e7Johannes Berg{
25212b131c4cf3eb1dc8a60082a434b7b100774c2e7Johannes Berg	return snd_register_device_for_dev(type, card, dev, f_ops,
25312b131c4cf3eb1dc8a60082a434b7b100774c2e7Johannes Berg					   private_data, name,
254c2902c8ae06762d941fab64198467f78cab6f8cdTakashi Iwai					   snd_card_get_device_link(card));
25512b131c4cf3eb1dc8a60082a434b7b100774c2e7Johannes Berg}
25612b131c4cf3eb1dc8a60082a434b7b100774c2e7Johannes Berg
257512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwaiint snd_unregister_device(int type, struct snd_card *card, int dev);
258f87135f56cb266e031f5ec081dfbde7e43f55e80Clemens Ladischvoid *snd_lookup_minor_data(unsigned int minor, int type);
2599d19f48cfe2570562c2c6226780a7ca627b0f1f1Takashi Iwaiint snd_add_device_sysfs_file(int type, struct snd_card *card, int dev,
260d80f19fab89cba8a6d16193154c8ff3edab00942Greg Kroah-Hartman			      struct device_attribute *attr);
2611da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
2621da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#ifdef CONFIG_SND_OSSEMUL
2632af677fc884fc6dc79e65c99050ea607ac8bab9bClemens Ladischint snd_register_oss_device(int type, struct snd_card *card, int dev,
26499ac48f54a91d02140c497edc31dc57d4bc5c85dArjan van de Ven			    const struct file_operations *f_ops, void *private_data,
265f87135f56cb266e031f5ec081dfbde7e43f55e80Clemens Ladisch			    const char *name);
266512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwaiint snd_unregister_oss_device(int type, struct snd_card *card, int dev);
267f87135f56cb266e031f5ec081dfbde7e43f55e80Clemens Ladischvoid *snd_lookup_oss_minor_data(unsigned int minor, int type);
2681da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#endif
2691da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
2701da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvaldsint snd_minor_info_init(void);
2711da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvaldsint snd_minor_info_done(void);
2721da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
2731da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/* sound_oss.c */
2741da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
2751da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#ifdef CONFIG_SND_OSSEMUL
2761da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvaldsint snd_minor_info_oss_init(void);
2771da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvaldsint snd_minor_info_oss_done(void);
2781da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#else
279ad5fada51d33b408ad3d2d0848ef6744b5daf06fPavel Machekstatic inline int snd_minor_info_oss_init(void) { return 0; }
280ad5fada51d33b408ad3d2d0848ef6744b5daf06fPavel Machekstatic inline int snd_minor_info_oss_done(void) { return 0; }
2811da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#endif
2821da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
2831da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/* memory.c */
2841da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
2851da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvaldsint copy_to_user_fromio(void __user *dst, const volatile void __iomem *src, size_t count);
2861da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvaldsint copy_from_user_toio(volatile void __iomem *dst, const void __user *src, size_t count);
2871da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
2881da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/* init.c */
2891da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
290512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwaiextern struct snd_card *snd_cards[SNDRV_CARDS];
291746df94898554b3d8e91d855e934852e626c701cTakashi Iwaiint snd_card_locked(int card);
2921da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#if defined(CONFIG_SND_MIXER_OSS) || defined(CONFIG_SND_MIXER_OSS_MODULE)
2931da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#define SND_MIXER_OSS_NOTIFY_REGISTER	0
2941da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#define SND_MIXER_OSS_NOTIFY_DISCONNECT	1
2951da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#define SND_MIXER_OSS_NOTIFY_FREE	2
296512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwaiextern int (*snd_mixer_oss_notify_callback)(struct snd_card *card, int cmd);
2971da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#endif
2981da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
29953fb1e63599438bd5f6fbb852023d80916d83983Takashi Iwaiint snd_card_create(int idx, const char *id,
30053fb1e63599438bd5f6fbb852023d80916d83983Takashi Iwai		    struct module *module, int extra_size,
30153fb1e63599438bd5f6fbb852023d80916d83983Takashi Iwai		    struct snd_card **card_ret);
30253fb1e63599438bd5f6fbb852023d80916d83983Takashi Iwai
303512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwaiint snd_card_disconnect(struct snd_card *card);
304512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwaiint snd_card_free(struct snd_card *card);
305c461482c8072bb073e6146db320d3da85cdc89adTakashi Iwaiint snd_card_free_when_closed(struct snd_card *card);
30610a8ebbb08c4b08292598947bbe534e04d6ee705Jaroslav Kyselavoid snd_card_set_id(struct snd_card *card, const char *id);
307512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwaiint snd_card_register(struct snd_card *card);
3081da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvaldsint snd_card_info_init(void);
3091da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvaldsint snd_card_info_done(void);
310512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwaiint snd_component_add(struct snd_card *card, const char *component);
311512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwaiint snd_card_file_add(struct snd_card *card, struct file *file);
312512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwaiint snd_card_file_remove(struct snd_card *card, struct file *file);
3131da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
3141da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#ifndef snd_card_set_dev
315edab938e63e463da86e4aa7b94628ce8f2b8a137Pavel Machek#define snd_card_set_dev(card, devptr) ((card)->dev = (devptr))
3161da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#endif
3171da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
3181da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/* device.c */
3191da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
320512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwaiint snd_device_new(struct snd_card *card, snd_device_type_t type,
321512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwai		   void *device_data, struct snd_device_ops *ops);
322512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwaiint snd_device_register(struct snd_card *card, void *device_data);
323512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwaiint snd_device_register_all(struct snd_card *card);
324512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwaiint snd_device_disconnect(struct snd_card *card, void *device_data);
325512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwaiint snd_device_disconnect_all(struct snd_card *card);
326512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwaiint snd_device_free(struct snd_card *card, void *device_data);
327512bbd6a85230f16389f0dd51925472e72fc8a91Takashi Iwaiint snd_device_free_all(struct snd_card *card, snd_device_cmd_t cmd);
3281da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
3291da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/* isadma.c */
3301da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
331276bd31ce5af01350465861af7aa6a25864eb108Al Viro#ifdef CONFIG_ISA_DMA_API
3321da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#define DMA_MODE_NO_ENABLE	0x0100
3331da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
3341da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvaldsvoid snd_dma_program(unsigned long dma, unsigned long addr, unsigned int size, unsigned short mode);
3351da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvaldsvoid snd_dma_disable(unsigned long dma);
3361da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvaldsunsigned int snd_dma_pointer(unsigned long dma, unsigned int size);
337276bd31ce5af01350465861af7aa6a25864eb108Al Viro#endif
3381da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
3391da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/* misc.c */
340b709e57440b9d5f38b8c73e1310127d51777bba0Takashi Iwaistruct resource;
341b1d5776d865951c213a1caaab5d8bf5de7615dbdTakashi Iwaivoid release_and_free_resource(struct resource *res);
3421da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
3431da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/* --- */
3441da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
34536ce99c1dcab2978fc1900f19b431adedd8f99f6Takashi Iwai#if defined(CONFIG_SND_DEBUG) || defined(CONFIG_SND_VERBOSE_PRINTK)
34636ce99c1dcab2978fc1900f19b431adedd8f99f6Takashi Iwaivoid __snd_printk(unsigned int level, const char *file, int line,
34736ce99c1dcab2978fc1900f19b431adedd8f99f6Takashi Iwai		  const char *format, ...)
34836ce99c1dcab2978fc1900f19b431adedd8f99f6Takashi Iwai     __attribute__ ((format (printf, 4, 5)));
34936ce99c1dcab2978fc1900f19b431adedd8f99f6Takashi Iwai#else
35036ce99c1dcab2978fc1900f19b431adedd8f99f6Takashi Iwai#define __snd_printk(level, file, line, format, args...) \
35136ce99c1dcab2978fc1900f19b431adedd8f99f6Takashi Iwai	prinkt(format, ##args)
35236ce99c1dcab2978fc1900f19b431adedd8f99f6Takashi Iwai#endif
35336ce99c1dcab2978fc1900f19b431adedd8f99f6Takashi Iwai
3541da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/**
3551da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds * snd_printk - printk wrapper
3561da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds * @fmt: format string
3571da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds *
358f66fcedc84dd06d42a0dba3894d238498509e8b7Takashi Iwai * Works like printk() but prints the file and the line of the caller
3591da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds * when configured with CONFIG_SND_VERBOSE_PRINTK.
3601da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds */
3611da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#define snd_printk(fmt, args...) \
36236ce99c1dcab2978fc1900f19b431adedd8f99f6Takashi Iwai	__snd_printk(0, __FILE__, __LINE__, fmt, ##args)
3631da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
3641da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#ifdef CONFIG_SND_DEBUG
3651da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/**
3661da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds * snd_printd - debug printk
3670863afb32b77fc89c7110b3d10fb048cb56bb1b5Martin Waitz * @fmt: format string
3681da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds *
369edab938e63e463da86e4aa7b94628ce8f2b8a137Pavel Machek * Works like snd_printk() for debugging purposes.
3701da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds * Ignored when CONFIG_SND_DEBUG is not set.
3711da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds */
3721da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#define snd_printd(fmt, args...) \
37336ce99c1dcab2978fc1900f19b431adedd8f99f6Takashi Iwai	__snd_printk(1, __FILE__, __LINE__, fmt, ##args)
3747c22f1aaa23370bf9ba2dd3abbccbed70dced216Takashi Iwai
375f66fcedc84dd06d42a0dba3894d238498509e8b7Takashi Iwai/**
376f66fcedc84dd06d42a0dba3894d238498509e8b7Takashi Iwai * snd_BUG - give a BUG warning message and stack trace
377f66fcedc84dd06d42a0dba3894d238498509e8b7Takashi Iwai *
378f66fcedc84dd06d42a0dba3894d238498509e8b7Takashi Iwai * Calls WARN() if CONFIG_SND_DEBUG is set.
379f66fcedc84dd06d42a0dba3894d238498509e8b7Takashi Iwai * Ignored when CONFIG_SND_DEBUG is not set.
380f66fcedc84dd06d42a0dba3894d238498509e8b7Takashi Iwai */
381bdbecf50064b75ecce2e10ce2621de0d0fac7de6Takashi Iwai#define snd_BUG()		WARN(1, "BUG?\n")
382f66fcedc84dd06d42a0dba3894d238498509e8b7Takashi Iwai
383f66fcedc84dd06d42a0dba3894d238498509e8b7Takashi Iwai/**
384f66fcedc84dd06d42a0dba3894d238498509e8b7Takashi Iwai * snd_BUG_ON - debugging check macro
385f66fcedc84dd06d42a0dba3894d238498509e8b7Takashi Iwai * @cond: condition to evaluate
386f66fcedc84dd06d42a0dba3894d238498509e8b7Takashi Iwai *
387f66fcedc84dd06d42a0dba3894d238498509e8b7Takashi Iwai * When CONFIG_SND_DEBUG is set, this macro evaluates the given condition,
388f66fcedc84dd06d42a0dba3894d238498509e8b7Takashi Iwai * and call WARN() and returns the value if it's non-zero.
389f66fcedc84dd06d42a0dba3894d238498509e8b7Takashi Iwai *
390f66fcedc84dd06d42a0dba3894d238498509e8b7Takashi Iwai * When CONFIG_SND_DEBUG is not set, this just returns zero, and the given
391f66fcedc84dd06d42a0dba3894d238498509e8b7Takashi Iwai * condition is ignored.
392f66fcedc84dd06d42a0dba3894d238498509e8b7Takashi Iwai *
393f66fcedc84dd06d42a0dba3894d238498509e8b7Takashi Iwai * NOTE: the argument won't be evaluated at all when CONFIG_SND_DEBUG=n.
394f66fcedc84dd06d42a0dba3894d238498509e8b7Takashi Iwai * Thus, don't put any statement that influences on the code behavior,
395f66fcedc84dd06d42a0dba3894d238498509e8b7Takashi Iwai * such as pre/post increment, to the argument of this macro.
396f66fcedc84dd06d42a0dba3894d238498509e8b7Takashi Iwai * If you want to evaluate and give a warning, use standard WARN_ON().
397f66fcedc84dd06d42a0dba3894d238498509e8b7Takashi Iwai */
3985ef03460a6ffc1d3ee6b6f2abc6765d3e224cf89Takashi Iwai#define snd_BUG_ON(cond)	WARN((cond), "BUG? (%s)\n", __stringify(cond))
3991da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
4001da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#else /* !CONFIG_SND_DEBUG */
4011da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
402fcef7836a31c6432b41a38867d413ed3d6aa8261Andrew Morton#define snd_printd(fmt, args...)	do { } while (0)
403fcef7836a31c6432b41a38867d413ed3d6aa8261Andrew Morton#define snd_BUG()			do { } while (0)
404945eed02cd619f525e097319cd3d18c58d01da87Takashi Iwaistatic inline int __snd_bug_on(int cond)
405fcef7836a31c6432b41a38867d413ed3d6aa8261Andrew Morton{
406fcef7836a31c6432b41a38867d413ed3d6aa8261Andrew Morton	return 0;
407fcef7836a31c6432b41a38867d413ed3d6aa8261Andrew Morton}
408945eed02cd619f525e097319cd3d18c58d01da87Takashi Iwai#define snd_BUG_ON(cond)	__snd_bug_on(0 && (cond))  /* always false */
4091da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
4101da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#endif /* CONFIG_SND_DEBUG */
4111da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
41262cf872a8eec1f11aacbec0ac3fe3698bfa9b403Takashi Iwai#ifdef CONFIG_SND_DEBUG_VERBOSE
4131da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/**
4141da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds * snd_printdd - debug printk
4151da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds * @format: format string
4161da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds *
417edab938e63e463da86e4aa7b94628ce8f2b8a137Pavel Machek * Works like snd_printk() for debugging purposes.
41862cf872a8eec1f11aacbec0ac3fe3698bfa9b403Takashi Iwai * Ignored when CONFIG_SND_DEBUG_VERBOSE is not set.
4191da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds */
42036ce99c1dcab2978fc1900f19b431adedd8f99f6Takashi Iwai#define snd_printdd(format, args...) \
42136ce99c1dcab2978fc1900f19b431adedd8f99f6Takashi Iwai	__snd_printk(2, __FILE__, __LINE__, format, ##args)
4221da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#else
42336ce99c1dcab2978fc1900f19b431adedd8f99f6Takashi Iwai#define snd_printdd(format, args...)	do { } while (0)
4241da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#endif
4251da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
4261da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
4271da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#define SNDRV_OSS_VERSION         ((3<<16)|(8<<8)|(1<<4)|(0))	/* 3.8.1a */
4281da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
4291da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/* for easier backward-porting */
4301da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#if defined(CONFIG_GAMEPORT) || defined(CONFIG_GAMEPORT_MODULE)
4311da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#ifndef gameport_set_dev_parent
4321da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#define gameport_set_dev_parent(gp,xdev) ((gp)->dev.parent = (xdev))
4331da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#define gameport_set_port_data(gp,r) ((gp)->port_data = (r))
4341da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#define gameport_get_port_data(gp) (gp)->port_data
4351da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#endif
4361da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#endif
4371da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
438d9ea472c743ccd7344055cb118bc210befbd8007Takashi Iwai/* PCI quirk list helper */
439d9ea472c743ccd7344055cb118bc210befbd8007Takashi Iwaistruct snd_pci_quirk {
440d9ea472c743ccd7344055cb118bc210befbd8007Takashi Iwai	unsigned short subvendor;	/* PCI subvendor ID */
441d9ea472c743ccd7344055cb118bc210befbd8007Takashi Iwai	unsigned short subdevice;	/* PCI subdevice ID */
4428bd4bb7a35e8ebb015a531218614c48e10a3c4eeTakashi Iwai	unsigned short subdevice_mask;	/* bitmask to match */
443d9ea472c743ccd7344055cb118bc210befbd8007Takashi Iwai	int value;			/* value */
44462cf872a8eec1f11aacbec0ac3fe3698bfa9b403Takashi Iwai#ifdef CONFIG_SND_DEBUG_VERBOSE
445d9ea472c743ccd7344055cb118bc210befbd8007Takashi Iwai	const char *name;		/* name of the device (optional) */
446d9ea472c743ccd7344055cb118bc210befbd8007Takashi Iwai#endif
447d9ea472c743ccd7344055cb118bc210befbd8007Takashi Iwai};
448d9ea472c743ccd7344055cb118bc210befbd8007Takashi Iwai
4498bd4bb7a35e8ebb015a531218614c48e10a3c4eeTakashi Iwai#define _SND_PCI_QUIRK_ID_MASK(vend, mask, dev)	\
4508bd4bb7a35e8ebb015a531218614c48e10a3c4eeTakashi Iwai	.subvendor = (vend), .subdevice = (dev), .subdevice_mask = (mask)
4518bd4bb7a35e8ebb015a531218614c48e10a3c4eeTakashi Iwai#define _SND_PCI_QUIRK_ID(vend, dev) \
4528bd4bb7a35e8ebb015a531218614c48e10a3c4eeTakashi Iwai	_SND_PCI_QUIRK_ID_MASK(vend, 0xffff, dev)
453d9ea472c743ccd7344055cb118bc210befbd8007Takashi Iwai#define SND_PCI_QUIRK_ID(vend,dev) {_SND_PCI_QUIRK_ID(vend, dev)}
45462cf872a8eec1f11aacbec0ac3fe3698bfa9b403Takashi Iwai#ifdef CONFIG_SND_DEBUG_VERBOSE
455d9ea472c743ccd7344055cb118bc210befbd8007Takashi Iwai#define SND_PCI_QUIRK(vend,dev,xname,val) \
456d9ea472c743ccd7344055cb118bc210befbd8007Takashi Iwai	{_SND_PCI_QUIRK_ID(vend, dev), .value = (val), .name = (xname)}
4578bd4bb7a35e8ebb015a531218614c48e10a3c4eeTakashi Iwai#define SND_PCI_QUIRK_VENDOR(vend, xname, val)			\
4588bd4bb7a35e8ebb015a531218614c48e10a3c4eeTakashi Iwai	{_SND_PCI_QUIRK_ID_MASK(vend, 0, 0), .value = (val), .name = (xname)}
4598bd4bb7a35e8ebb015a531218614c48e10a3c4eeTakashi Iwai#define SND_PCI_QUIRK_MASK(vend, mask, dev, xname, val)			\
4608bd4bb7a35e8ebb015a531218614c48e10a3c4eeTakashi Iwai	{_SND_PCI_QUIRK_ID_MASK(vend, mask, dev),			\
4618bd4bb7a35e8ebb015a531218614c48e10a3c4eeTakashi Iwai			.value = (val), .name = (xname)}
462d9ea472c743ccd7344055cb118bc210befbd8007Takashi Iwai#else
463d9ea472c743ccd7344055cb118bc210befbd8007Takashi Iwai#define SND_PCI_QUIRK(vend,dev,xname,val) \
464d9ea472c743ccd7344055cb118bc210befbd8007Takashi Iwai	{_SND_PCI_QUIRK_ID(vend, dev), .value = (val)}
4658bd4bb7a35e8ebb015a531218614c48e10a3c4eeTakashi Iwai#define SND_PCI_QUIRK_MASK(vend, mask, dev, xname, val)			\
4668bd4bb7a35e8ebb015a531218614c48e10a3c4eeTakashi Iwai	{_SND_PCI_QUIRK_ID_MASK(vend, mask, dev), .value = (val)}
4678bd4bb7a35e8ebb015a531218614c48e10a3c4eeTakashi Iwai#define SND_PCI_QUIRK_VENDOR(vend, xname, val)			\
4688bd4bb7a35e8ebb015a531218614c48e10a3c4eeTakashi Iwai	{_SND_PCI_QUIRK_ID_MASK(vend, 0, 0), .value = (val)}
469d9ea472c743ccd7344055cb118bc210befbd8007Takashi Iwai#endif
470d9ea472c743ccd7344055cb118bc210befbd8007Takashi Iwai
471d9ea472c743ccd7344055cb118bc210befbd8007Takashi Iwaiconst struct snd_pci_quirk *
472d9ea472c743ccd7344055cb118bc210befbd8007Takashi Iwaisnd_pci_quirk_lookup(struct pci_dev *pci, const struct snd_pci_quirk *list);
473d9ea472c743ccd7344055cb118bc210befbd8007Takashi Iwai
474d9ea472c743ccd7344055cb118bc210befbd8007Takashi Iwai
4751da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#endif /* __SOUND_CORE_H */
476