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
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
|
/**
******************************************************************************
* @file opus_interface_stm.h
* @author SRA-A&SP
* @version V1.0.0
* @date 08-May-2019
* @brief This file contains definitions for the opus interface.
******************************************************************************
* @attention
*
* <h2><center>© COPYRIGHT(c) 2019 STMicroelectronics</center></h2>
*
* Redistribution and use in source and binary forms, with or without modification,
* are permitted provided that the following conditions are met:
* 1. Redistributions of source code must retain the above copyright notice,
* this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright notice,
* this list of conditions and the following disclaimer in the documentation
* and/or other materials provided with the distribution.
* 3. Neither the name of STMicroelectronics nor the names of its contributors
* may be used to endorse or promote products derived from this software
* without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
* DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
* SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
* CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
* OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*
******************************************************************************
*/
/* Define to prevent recursive inclusion -------------------------------------*/
#ifndef __OPUS_INTERFACE_STM_H
#define __OPUS_INTERFACE_STM_H
#ifdef __cplusplus
extern "C" {
#endif
/* Includes ------------------------------------------------------------------*/
#include "opus.h"
#include "opus_private.h"
#include "ble_gatt_aci.h"
/**
* @brief Return states values.
*/
typedef enum
{
OPUS_IF_SUCCESS = 0x00, /*!< Success.*/
OPUS_IF_ERROR = 0x01, /*!< Error.*/
OPUS_IF_INVALID_PARAM = 0x02, /*!< Invalid Opus parameters.*/
OPUS_IF_ENC_NOT_CONFIG = 0x03, /*!< BlueVoiceOPUS encoder not configured.*/
OPUS_IF_DEC_NOT_CONFIG = 0x04, /*!< BlueVoiceOPUS decoder not configured.*/
} OPUS_IF_Status;
/**
* @brief Opus encoder configuration parameters.
*/
typedef struct
{
float ms_frame; /*!< audio frame size [ms] (2.5, 5, 10, 20, 40, 60).*/
uint32_t sample_freq; /*!< Audio sampling frequency [Hz] (8000, 12000, 16000, 24000, 48000).*/
uint8_t channels; /*!< Number of audio input channels. */
int application; /*!< Specifies the application type (OPUS_APPLICATION_VOIP, OPUS_APPLICATION_AUDIO, OPUS_APPLICATION_RESTRICTED_LOWDELAY) see opus_define.h. */
uint32_t bitrate; /*!< Specifies the choosen encoding bitrate [bps] (from 6000 to 510000). */
uint8_t complexity; /*!< Specifies the choosen encoding complexity (from 0 to 10). */
} OPUS_IF_ENC_ConfigTypeDef;
/**
* @brief Opus decoder configuration parameters.
*/
typedef struct
{
float ms_frame; /*!< audio frame size [ms] (2.5, 5, 10, 20, 40, 60). */
uint32_t sample_freq; /*!< Audio sampling frequency [Hz] (8000, 12000, 16000, 24000, 48000). */
uint8_t channels; /*!< Number of audio input channels */
uint32_t bitrate; /*!< Specifies the choosen encoding bitrate [bps] (from 6000 to 510000). */
} OPUS_IF_DEC_ConfigTypeDef;
/**
* @brief Encoder initialization.
* @param Opus encoder configuration.
* @param opus_err: @ref opus_errorcodes
* @retval OPUS_IF_Status: Value indicating success or error (in case of error check opus_err).
*/
OPUS_IF_Status OPUS_IF_ENC_Init(OPUS_IF_ENC_ConfigTypeDef *ENC_configOpus, int *opus_err);
/**
* @brief Encoder deinit function.
* @param None.
* @retval None.
*/
void OPUS_IF_ENC_Deinit(void);
/**
* @brief This function returns if the the Opus Encoder is configured.
* @param None.
* @retval uint8_t: 1 if the Encoder is configured 0 otherwise.
*/
uint8_t OPUS_IF_ENC_IsConfigured(void);
/**
* @brief Decoder initialization.
* @param Opus decoder configuration.
* @param opus_err: @ref opus_errorcodes
* @retval OPUS_IF_Status: Value indicating success or error (in case of error check opus_err).
*/
OPUS_IF_Status OPUS_IF_DEC_Init(OPUS_IF_DEC_ConfigTypeDef *DEC_configOpus, int *opus_err);
/**
* @brief Decoder deinit function.
* @param None.
* @retval None.
*/
void OPUS_IF_DEC_Deinit(void);
/**
* @brief This function returns if the the Opus Decoder is configured.
* @param None.
* @retval uint8_t: 1 if the Decoder is configured 0 otherwise.
*/
uint8_t OPUS_IF_DEC_IsConfigured(void);
/**
* @brief Set bitrate to be used for encoding
* @param bitrate: Indicate the bitrate in bit per second.
* @param opus_err: @ref opus_errorcodes.
* @retval OPUS_IF_Status: Value indicating success or error (in case of error check opus_err).
*/
OPUS_IF_Status OPUS_IF_ENC_Set_Bitrate(OPUS_IF_ENC_ConfigTypeDef *ENC_configOpus, int bitrate, int *opus_err);
/**
* @brief Set constant bitrate option for the encoder.
* @param None.
* @retval OPUS_IF_Status: Value indicating success or error.
*/
OPUS_IF_Status OPUS_IF_ENC_Set_CBR(void);
/**
* @brief Set variable bitrate option for the encoder.
* @param None.
* @retval OPUS_IF_Status: Value indicating success or error.
*/
OPUS_IF_Status OPUS_IF_ENC_Set_VBR(void);
/**
* @brief Set complexity to be used for encoding
* @param complexity: value from o to 10.
* @param opus_err: @ref opus_errorcodes.
* @retval OPUS_IF_Status: Value indicating success or error (in case of error check opus_err).
*/
OPUS_IF_Status OPUS_IF_ENC_Set_Complexity(OPUS_IF_ENC_ConfigTypeDef *ENC_configOpus, int complexity, int *opus_err);
/**
* @brief Force the encoder to use only SILK
* @param None.
* @retval OPUS_IF_Status: Value indicating success or error.
*/
OPUS_IF_Status OPUS_IF_ENC_Force_SILKmode(void);
/**
* @brief Force the encoder to use only CELT.
* @param None.
* @retval OPUS_IF_Status: Value indicating success or error.
*/
OPUS_IF_Status OPUS_IF_ENC_Force_CELTmode(void);
/**
* @brief Encoding functions.
* @param buf_in: pointer to the PCM buffer to be encoded.
* @param buf_out: pointer to the Encoded buffer.
* @retval Number of bytes in case of success, 0 viceversa.
*/
int OPUS_IF_ENC_Encode(uint8_t * buf_in, uint8_t * buf_out);
/**
* @brief Decoding functions.
* @param buf_in: pointer to the Encoded buffer to be decoded.
* @param len: length of the buffer in.
* @param buf_out: pointer to the Decoded buffer.
* @retval Number of decoded samples or @ref opus_errorcodes.
*/
int OPUS_IF_DEC_Decode(uint8_t * buf_in, uint32_t len, uint8_t * buf_out);
#ifdef __cplusplus
}
#endif
#endif /* __OPUS_INTERFACE_STM_H */
/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
|
