xref: /openbmc/linux/include/sound/seq_kernel.h (revision 8bd1369b)
1 #ifndef __SOUND_SEQ_KERNEL_H
2 #define __SOUND_SEQ_KERNEL_H
3 
4 /*
5  *  Main kernel header file for the ALSA sequencer
6  *  Copyright (c) 1998 by Frank van de Pol <fvdpol@coil.demon.nl>
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 #include <linux/time.h>
25 #include <sound/asequencer.h>
26 
27 typedef struct snd_seq_real_time snd_seq_real_time_t;
28 typedef union snd_seq_timestamp snd_seq_timestamp_t;
29 
30 /* maximum number of queues */
31 #define SNDRV_SEQ_MAX_QUEUES		32
32 
33 /* max number of concurrent clients */
34 #define SNDRV_SEQ_MAX_CLIENTS 		192
35 
36 /* max number of concurrent ports */
37 #define SNDRV_SEQ_MAX_PORTS 		254
38 
39 /* max number of events in memory pool */
40 #define SNDRV_SEQ_MAX_EVENTS		2000
41 
42 /* default number of events in memory pool */
43 #define SNDRV_SEQ_DEFAULT_EVENTS	500
44 
45 /* max number of events in memory pool for one client (outqueue) */
46 #define SNDRV_SEQ_MAX_CLIENT_EVENTS	2000
47 
48 /* default number of events in memory pool for one client (outqueue) */
49 #define SNDRV_SEQ_DEFAULT_CLIENT_EVENTS	200
50 
51 /* max delivery path length */
52 /* NOTE: this shouldn't be greater than MAX_LOCKDEP_SUBCLASSES */
53 #define SNDRV_SEQ_MAX_HOPS		8
54 
55 /* max size of event size */
56 #define SNDRV_SEQ_MAX_EVENT_LEN		0x3fffffff
57 
58 /* call-backs for kernel port */
59 struct snd_seq_port_callback {
60 	struct module *owner;
61 	void *private_data;
62 	int (*subscribe)(void *private_data, struct snd_seq_port_subscribe *info);
63 	int (*unsubscribe)(void *private_data, struct snd_seq_port_subscribe *info);
64 	int (*use)(void *private_data, struct snd_seq_port_subscribe *info);
65 	int (*unuse)(void *private_data, struct snd_seq_port_subscribe *info);
66 	int (*event_input)(struct snd_seq_event *ev, int direct, void *private_data, int atomic, int hop);
67 	void (*private_free)(void *private_data);
68 	/*...*/
69 };
70 
71 /* interface for kernel client */
72 __printf(3, 4)
73 int snd_seq_create_kernel_client(struct snd_card *card, int client_index,
74 				 const char *name_fmt, ...);
75 int snd_seq_delete_kernel_client(int client);
76 int snd_seq_kernel_client_enqueue(int client, struct snd_seq_event *ev, int atomic, int hop);
77 int snd_seq_kernel_client_dispatch(int client, struct snd_seq_event *ev, int atomic, int hop);
78 int snd_seq_kernel_client_ctl(int client, unsigned int cmd, void *arg);
79 
80 #define SNDRV_SEQ_EXT_MASK	0xc0000000
81 #define SNDRV_SEQ_EXT_USRPTR	0x80000000
82 #define SNDRV_SEQ_EXT_CHAINED	0x40000000
83 
84 typedef int (*snd_seq_dump_func_t)(void *ptr, void *buf, int count);
85 int snd_seq_expand_var_event(const struct snd_seq_event *event, int count, char *buf,
86 			     int in_kernel, int size_aligned);
87 int snd_seq_dump_var_event(const struct snd_seq_event *event,
88 			   snd_seq_dump_func_t func, void *private_data);
89 
90 /* interface for OSS emulation */
91 int snd_seq_set_queue_tempo(int client, struct snd_seq_queue_tempo *tempo);
92 
93 /* port callback routines */
94 void snd_port_init_callback(struct snd_seq_port_callback *p);
95 struct snd_seq_port_callback *snd_port_alloc_callback(void);
96 
97 /* port attach/detach */
98 int snd_seq_event_port_attach(int client, struct snd_seq_port_callback *pcbp,
99 			      int cap, int type, int midi_channels, int midi_voices, char *portname);
100 int snd_seq_event_port_detach(int client, int port);
101 
102 #ifdef CONFIG_MODULES
103 void snd_seq_autoload_init(void);
104 void snd_seq_autoload_exit(void);
105 #else
106 #define snd_seq_autoload_init()
107 #define snd_seq_autoload_exit()
108 #endif
109 
110 #endif /* __SOUND_SEQ_KERNEL_H */
111