1 /*
2 * Copyright (c) 2019-2025 Allwinner Technology Co., Ltd. ALL rights reserved.
3 *
4 * Allwinner is a trademark of Allwinner Technology Co.,Ltd., registered in
5 * the the people's Republic of China and other countries.
6 * All Allwinner Technology Co.,Ltd. trademarks are used with permission.
7 *
8 * DISCLAIMER
9 * THIRD PARTY LICENCES MAY BE REQUIRED TO IMPLEMENT THE SOLUTION/PRODUCT.
10 * IF YOU NEED TO INTEGRATE THIRD PARTY’S TECHNOLOGY (SONY, DTS, DOLBY, AVS OR MPEGLA, ETC.)
11 * IN ALLWINNERS’SDK OR PRODUCTS, YOU SHALL BE SOLELY RESPONSIBLE TO OBTAIN
12 * ALL APPROPRIATELY REQUIRED THIRD PARTY LICENCES.
13 * ALLWINNER SHALL HAVE NO WARRANTY, INDEMNITY OR OTHER OBLIGATIONS WITH RESPECT TO MATTERS
14 * COVERED UNDER ANY REQUIRED THIRD PARTY LICENSE.
15 * YOU ARE SOLELY RESPONSIBLE FOR YOUR USAGE OF THIRD PARTY’S TECHNOLOGY.
16 *
17 *
18 * THIS SOFTWARE IS PROVIDED BY ALLWINNER"AS IS" AND TO THE MAXIMUM EXTENT
19 * PERMITTED BY LAW, ALLWINNER EXPRESSLY DISCLAIMS ALL WARRANTIES OF ANY KIND,
20 * WHETHER EXPRESS, IMPLIED OR STATUTORY, INCLUDING WITHOUT LIMITATION REGARDING
21 * THE TITLE, NON-INFRINGEMENT, ACCURACY, CONDITION, COMPLETENESS, PERFORMANCE
22 * OR MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
23 * IN NO EVENT SHALL ALLWINNER BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
24 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
25 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
26 * LOSS OF USE, DATA, OR PROFITS, OR BUSINESS INTERRUPTION)
27 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
28 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
29 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
30 * OF THE POSSIBILITY OF SUCH DAMAGE.
31 */
32 #ifndef __SOUND_KSOUND_H
33 #define __SOUND_KSOUND_H
34 
35 #ifdef __cplusplus
36 extern "C" {
37 #endif
38 
39 #include "pcm_common.h"
40 
41 typedef struct snd_pcm_substream snd_pcm_substream_t;
42 
43 /* pcm */
44 int ksnd_pcm_open(int card_num, int device_num, int stream, int mode, void **substream);
45 int ksnd_pcm_release(int card_num, int device_num, int stream);
46 int ksnd_pcm_hw_refine(void *substream, void *params);
47 int ksnd_pcm_prepare(void *substream_handle);
48 int ksnd_pcm_reset(void *substream_handle);
49 int ksnd_pcm_hw_params(void *substream_handle, void *params_wrapper);
50 int ksnd_pcm_hw_free(void *substream_handle);
51 snd_pcm_sframes_t ksnd_pcm_writei(void *substream_handle, const void *buffer, snd_pcm_uframes_t size);
52 snd_pcm_sframes_t ksnd_pcm_readi(void *substream_handle, void *buffer, snd_pcm_uframes_t size);
53 int ksnd_pcm_start(void *substream_handle);
54 int ksnd_pcm_drain(void *substream_handle);
55 int ksnd_pcm_drop(void *substream_handle);
56 int ksnd_pcm_pause(void *substream_handle, int enable);
57 int ksnd_pcm_sw_params(void *substream_handle, void *params_wrapper);
58 int ksnd_pcm_sync_ptr(void *substream_handle, void *status, void *control, unsigned int flags);
59 int ksnd_pcm_delay(void *substream_handle, void *delay);
60 int ksnd_pcm_channel_info(void *substream_handle, void *info_wrapper);
61 void ksnd_pcm_hw_mmap_dcache_update(void *substream_handle, snd_pcm_uframes_t offset,
62         snd_pcm_uframes_t size);
63 int ksnd_pcm_wait(void *substream_handle, int index, int timeout);
64 int ksnd_pcm_rewind(snd_pcm_substream_t *substream, snd_pcm_uframes_t frames);
65 int ksnd_pcm_dsleep_init(void *substream_handle);
66 int ksnd_pcm_dsleep_release(void *substream_handle, int index);
67 
68 /* ctl */
69 int ksnd_ctl_num(const char *name);
70 int ksnd_ctl_get(const char *name, const char *elem, void *info);
71 int ksnd_ctl_get_bynum(const char *name, const unsigned int elem_num, void *info);
72 int ksnd_ctl_set(const char *name, const char *elem, unsigned int val);
73 int ksnd_ctl_set_bynum(const char *name, const unsigned int elem_num, unsigned int val);
74 int ksnd_ctl_add_elem(const char *name, void *info);
75 int ksnd_ctl_remove_elem(const char *name, const unsigned int elem_num);
76 
77 int ksnd_ctl_set_multi_args(const char *name, const char *elem, int num, ...);
78 #ifdef __cplusplus
79 }
80 #endif
81 
82 #endif /* __SOUND_KSOUND_H */
83