2 * Copyright (c) 2016 Alex Teaca <iateaca@FreeBSD.org>
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
8 * 1. Redistributions of source code must retain the above copyright
9 * notice, this list of conditions and the following disclaimer.
10 * 2. Redistributions in binary form must reproduce the above copyright
11 * notice, this list of conditions and the following disclaimer in the
12 * documentation and/or other materials provided with the distribution.
14 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND
15 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
29 #ifndef _AUDIO_EMUL_H_
30 #define _AUDIO_EMUL_H_
32 #include <sys/types.h>
33 #include <sys/soundcard.h>
36 * Audio Player data structures
52 * audio_init - initialize an instance of audio player
53 * @dev_name - the backend sound device used to play / capture
54 * @dir - dir = 1 for write mode, dir = 0 for read mode
55 * Returns NULL on error and the address of the audio player instance
57 struct audio *audio_init(const char *dev_name, uint8_t dir);
60 * audio_set_params - reset the sound device and set the audio params
61 * @aud - the audio player to be configured
62 * @params - the audio parameters to be set
63 * Returns -1 on error and 0 on success
65 int audio_set_params(struct audio *aud, struct audio_params *params);
68 * audio_playback - plays samples to the sound device using blocking operations
69 * @aud - the audio player used to play the samples
70 * @buf - the buffer containing the samples
71 * @count - the number of bytes in buffer
72 * Returns -1 on error and 0 on success
74 int audio_playback(struct audio *aud, const void *buf, size_t count);
77 * audio_record - records samples from the sound device using blocking
79 * @aud - the audio player used to capture the samples
80 * @buf - the buffer to receive the samples
81 * @count - the number of bytes to capture in buffer
82 * Returns -1 on error and 0 on success
84 int audio_record(struct audio *aud, void *buf, size_t count);
86 #endif /* _AUDIO_EMUL_H_ */