diff options
Diffstat (limited to 'sound/avirt.h')
-rw-r--r-- | sound/avirt.h | 122 |
1 files changed, 122 insertions, 0 deletions
diff --git a/sound/avirt.h b/sound/avirt.h new file mode 100644 index 0000000..1a5c546 --- /dev/null +++ b/sound/avirt.h @@ -0,0 +1,122 @@ +// SPDX-License-Identifier: GPL-2.0 +/* + * AVIRT - ALSA Virtual Soundcard + * + * Copyright (c) 2010-2018 Fiberdyne Systems Pty Ltd + * + * avirt.h - AVIRT system-level header + */ + +#ifndef __SOUND_AVIRT_H +#define __SOUND_AVIRT_H + +#include <sound/core.h> +#include <sound/pcm.h> +#include <linux/configfs.h> + +#define MAX_STREAMS 16 +#define MAX_NAME_LEN 80 + +#define DINFO(logname, fmt, args...) \ + snd_printk(KERN_INFO "AVIRT: %s: " fmt "\n", logname, ##args) + +#define DERROR(logname, fmt, args...) \ + snd_printk(KERN_ERR "AVIRT: %s: " fmt "\n", logname, ##args) + +#define DDEBUG(logname, fmt, args...) \ + snd_printk(KERN_DEBUG "AVIRT: %s: " fmt "\n", logname, ##args) + +/** + * AVIRT Audio Path configure function type + * Each Audio Path registers this at snd_avirt_audiopath_register time. + * It is then called by the core once AVIRT has been configured + */ +typedef int (*snd_avirt_audiopath_configure)(struct snd_card *card, + struct config_group *stream_group, + unsigned int stream_count); + +/** + * AVIRT Audio Path info + */ +struct snd_avirt_audiopath { + const char *uid; /* Unique identifier */ + const char *name; /* Pretty name */ + unsigned int version[3]; /* Version - Major.Minor.Ext */ + const struct snd_pcm_hardware *hw; /* ALSA PCM HW conf */ + const struct snd_pcm_ops *pcm_ops; /* ALSA PCM op table */ + snd_avirt_audiopath_configure configure; /* Config callback function */ + + void *context; +}; + +/* + * Audio stream configuration + */ +struct snd_avirt_stream { + char name[MAX_NAME_LEN]; /* Stream name */ + char map[MAX_NAME_LEN]; /* Stream Audio Path mapping */ + unsigned int channels; /* Stream channel count */ + unsigned int device; /* Stream PCM device no. */ + unsigned int direction; /* Stream direction */ + struct snd_pcm *pcm; /* ALSA PCM */ + struct config_item item; /* configfs item reference */ +}; + +/** + * AVIRT core info + */ +struct snd_avirt_coreinfo { + unsigned int version[3]; +}; + +/** + * snd_avirt_audiopath_register - register Audio Path with AVIRT + * @audiopath: Audio Path to be registered + * @core: ALSA virtual driver core info + * @return: 0 on success or error code otherwise + */ +int snd_avirt_audiopath_register(struct snd_avirt_audiopath *audiopath, + struct snd_avirt_coreinfo **coreinfo); + +/** + * snd_avirt_audiopath_deregister - deregister Audio Path with AVIRT + * @audiopath: Audio Path to be deregistered + * @return: 0 on success or error code otherwise + */ +int snd_avirt_audiopath_deregister(struct snd_avirt_audiopath *audiopath); + +/** + * snd_avirt_audiopath_get - retrieves the Audio Path by it's UID + * @uid: Unique ID for the Audio Path + * @return: Corresponding Audio Path + */ +struct snd_avirt_audiopath *snd_avirt_audiopath_get(const char *uid); + +/** + * snd_avirt_stream_count - get the stream count for the given direction + * @direction: The direction to get the stream count for + * @return: The stream count + */ +int snd_avirt_stream_count(unsigned int direction); + +/** + * snd_avirt_stream_from_config_item - Convert config_item to a snd_avirt_stream + * @item: The config_item to convert from + * @return: The item's snd_avirt_stream if successful, NULL otherwise + */ +static inline struct snd_avirt_stream * + snd_avirt_stream_from_config_item(struct config_item *item) +{ + return item ? container_of(item, struct snd_avirt_stream, item) : NULL; +} + +/** + * snd_avirt_pcm_period_elapsed - PCM buffer complete callback + * @substream: pointer to ALSA PCM substream + * + * This should be called from a child Audio Path once it has finished processing + * the PCM buffer + */ +void snd_avirt_pcm_period_elapsed(struct snd_pcm_substream *substream); + +#endif // __SOUND_AVIRT_H |