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 
33 #ifndef __AW_ALSA_PCM_ROUTE_H
34 #define __AW_ALSA_PCM_ROUTE_H
35 
36 /* ROUTE_FLOAT should be set to 0 for machines without FP unit - like iPAQ */
37 #define SND_PCM_PLUGIN_ROUTE_FLOAT 1
38 
39 #define SND_PCM_PLUGIN_ROUTE_RESOLUTION 16 /**< integer resolution for route plugin */
40 
41 #if SND_PCM_PLUGIN_ROUTE_FLOAT
42 /** route ttable entry type */
43 typedef float snd_pcm_route_ttable_entry_t;
44 #define SND_PCM_PLUGIN_ROUTE_HALF 0.5   /**< half value */
45 #define SND_PCM_PLUGIN_ROUTE_FULL 1.0   /**< full value */
46 #else
47 /** route ttable entry type */
48 typedef int snd_pcm_route_ttable_entry_t;
49 #define SND_PCM_PLUGIN_ROUTE_HALF (SND_PCM_PLUGIN_ROUTE_RESOLUTION / 2) /**< half value */
50 #define SND_PCM_PLUGIN_ROUTE_FULL SND_PCM_PLUGIN_ROUTE_RESOLUTION   /**< full value */
51 #endif
52 
53 typedef struct {
54     const char *pcm;
55     int channels;
56 } snd_pcm_route_slave_config_t;
57 
58 typedef struct {
59     int cchannel;
60     int schannel;
61 #if SND_PCM_PLUGIN_ROUTE_FLOAT
62     float route_value;
63 #else
64     int route_value;
65 #endif
66 } snd_pcm_route_ttable_config_t;
67 
68 typedef struct {
69     const char *type;
70     snd_pcm_route_slave_config_t slave;
71     snd_pcm_route_ttable_config_t ttable[];
72 } snd_pcm_route_config_t;
73 
74 #define TTABLE_CONFIG_END {-1, -1, 0}
75 
snd_pcm_route_is_ttable_config_end(const snd_pcm_route_ttable_config_t * entry)76 static inline int snd_pcm_route_is_ttable_config_end(const snd_pcm_route_ttable_config_t *entry)
77 {
78     if (entry->cchannel == -1 && entry->schannel == -1)
79         return 1;
80     return 0;
81 }
82 
83 #endif /* __AW_ALSA_PCM_ROUTE_H */
84