1 /*
2  * Copyright (c) 2022 Huawei Device Co., Ltd.
3  * Licensed under the Apache License, Version 2.0 (the "License");
4  * you may not use this file except in compliance with the License.
5  * You may obtain a copy of the License at
6  *
7  *     http://www.apache.org/licenses/LICENSE-2.0
8  *
9  * Unless required by applicable law or agreed to in writing, software
10  * distributed under the License is distributed on an "AS IS" BASIS,
11  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12  * See the License for the specific language governing permissions and
13  * limitations under the License.
14  */
15 
16 #ifndef ALSA_SND_RENDER_H
17 #define ALSA_SND_RENDER_H
18 
19 #include "alsa_soundcard.h"
20 
21 #ifdef __cplusplus
22 extern "C" {
23 #endif
24 
25 typedef void* RenderPriData;
26 
27 struct AlsaRender {
28     struct AlsaSoundCard soundCard;
29     enum AudioPortPin descPins;
30     bool muteState;
31     bool periodEvent; /* produce poll event after each period */
32     snd_pcm_sframes_t bufferSize;
33     snd_pcm_sframes_t periodSize;
34     unsigned int bufferTime;    /* (0.5s): ring buffer length in us */
35     unsigned int periodTime;    /* (0.1s): period time in us */
36     int resample;
37     RenderPriData priData;
38 
39     /* render scene */
40     int32_t (*Init)(struct AlsaRender*);
41     int32_t (*SelectScene)(struct AlsaRender *, enum AudioPortPin, const struct PathDeviceInfo *);
42     int32_t (*Open)(struct AlsaRender *);
43     int32_t (*Start)(struct AlsaRender *);
44     int32_t (*Stop)(struct AlsaRender *);
45     int32_t (*Close)(struct AlsaRender *);
46     int32_t (*Write)(struct AlsaRender *, const struct AudioHwRenderParam *);
47     int32_t (*GetMmapPosition)(struct AlsaRender *);
48     int32_t (*MmapWrite)(struct AlsaRender *, const struct AudioHwRenderParam *);
49 
50     /* volume operation */
51     int32_t (*GetVolThreshold)(struct AlsaRender *, long *, long *);
52     int32_t (*GetVolume)(struct AlsaRender *, long *);
53     int32_t (*SetVolume)(struct AlsaRender *, long);
54 
55     /* gain operation */
56     int32_t (*GetGainThreshold)(struct AlsaRender *, float *, float *);
57     int32_t (*GetGain)(struct AlsaRender *, float *);
58     int32_t (*SetGain)(struct AlsaRender *, float);
59 
60     /* mute operation */
61     bool  (*GetMute)(struct AlsaRender *);
62     int32_t (*SetMute)(struct AlsaRender *, bool);
63 
64     /* channel mode operation */
65     int32_t (*GetChannelMode)(struct AlsaRender *, enum AudioChannelMode *);
66     int32_t (*SetChannelMode)(struct AlsaRender *, enum AudioChannelMode);
67 
68     /* set pause or resume state */
69     int32_t (*SetPauseState)(struct AlsaRender *, bool);
70 };
71 
72 struct AlsaRender *RenderCreateInstance(const char* adapterName);
73 struct AlsaRender *RenderGetInstance(const char *adapterName);
74 int32_t RenderSetParams(struct AlsaRender *renderIns, const struct AudioHwRenderParam *handleData);
75 void  RenderSetPriData(struct AlsaRender *renderIns, RenderPriData data);
76 RenderPriData RenderGetPriData(struct AlsaRender *renderIns);
77 
78 /*
79     Different platforms implement this function rewriting render implementation
80  */
81 int32_t RenderOverrideFunc(struct AlsaRender *renderIns);
82 
83 #ifdef __cplusplus
84 }
85 #endif
86 
87 #endif /* ALSA_SND_RENDER_H */