1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
|
// SPDX-License-Identifier: GPL-2.0
/*
* ALSA Virtual Soundcard
*
* alsa.h - Top level ALSA interface
*
* Copyright (C) 2010-2018 Fiberdyne Systems Pty Ltd
*/
#ifndef __AVIRT_ALSA_H__
#define __AVIRT_ALSA_H__
#include <linux/platform_device.h>
#include <sound/pcm.h>
#define MAX_NAME_LEN 32
#define PRINT_ERR(errno, errmsg, ...) \
pr_err("[%s()] %s [ERRNO:%d]", __func__, errmsg, ##__VA_ARGS__, errno);
#define CHK_ERR(errno) \
do { \
if (errno < 0) \
return errno; \
} while (0)
#define CHK_ERR_V(errno, errmsg, ...) \
do { \
if (errno < 0) { \
PRINT_ERR(errno, errmsg, ##__VA_ARGS__) \
return errno; \
} \
} while (0)
#define CHK_NULL(x) \
do { \
if (!x) \
return -EFAULT; \
} while (0)
#define CHK_NULL_V(x, errmsg, ...) \
do { \
if (!x) { \
PRINT_ERR(EFAULT, errmsg, ##__VA_ARGS__) \
return -EFAULT; \
} \
} while (0)
/*
* Substream device configuration
*/
struct avirt_alsa_dev_config {
const char devicename[MAX_NAME_LEN];
int channels;
};
/**
* Collection of devices
*/
struct avirt_alsa_dev_group {
struct avirt_alsa_dev_config *config;
int devices;
};
/**
* ALSA driver data
*/
struct avirt_alsa_driver {
struct snd_card *card;
struct avirt_alsa_dev_group playback;
struct avirt_alsa_dev_group capture;
};
/**
* avirt_alsa_init - Initializes the ALSA driver
* @return: 0 on success or error code otherwise
*/
int avirt_alsa_init(void);
/**
* avirt_alsa_configure_pcm- Configure the PCM device
* @config: Device configuration structure array
* @direction: Direction of PCM (SNDRV_PCM_STREAM_XXX)
* @numdevices: Number of devices (array length)
* @return: 0 on success or error code otherwise
*/
int avirt_alsa_configure_pcm(struct avirt_alsa_dev_config *config,
int direction, unsigned numdevices);
/**
* avirt_alsa_register - Registers the ALSA driver
* @devptr: Platform driver device
* @return: 0 on success or error code otherwise
*/
int avirt_alsa_register(struct platform_device *devptr);
/**
* avirt_alsa_deregister - Deregisters the ALSA driver
* @devptr: Platform driver device
* @return: 0 on success or error code otherwise
*/
int avirt_alsa_deregister(void);
/**
* avirt_alsa_get_dev_group - Gets the device group for the specified direction
* @direction: SNDRV_PCM_STREAM_PLAYBACK or SNDRV_PCM_STREAM_CAPTURE
* @return: Either the playback or capture device group on success,
* or NULL otherwise
*/
struct avirt_alsa_dev_group *avirt_alsa_get_dev_group(int direction);
/**
* pcm_buff_complete_cb - PCM buffer complete callback
* @substream: pointer to ALSA PCM substream
* @return 0 on success or error code otherwise
*
* This should be called from a child Audio Path once it has finished processing
* the PCM buffer
*/
int pcm_buff_complete_cb(struct snd_pcm_substream *substream);
#endif // __AVIRT_ALSA_H__
|
