-
Notifications
You must be signed in to change notification settings - Fork 0
/
stm32h573i_discovery_audio.h
407 lines (342 loc) · 15.9 KB
/
stm32h573i_discovery_audio.h
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
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
/**
******************************************************************************
* @file stm32h573i_discovery_audio.h
* @author MCD Application Team
* @brief This file contains the common defines and functions prototypes for
* the stm32h573i_discovery_audio.c driver.
******************************************************************************
* @attention
*
* Copyright (c) 2023 STMicroelectronics.
* All rights reserved.
*
* This software is licensed under terms that can be found in the LICENSE file
* in the root directory of this software component.
* If no LICENSE file comes with this software, it is provided AS-IS.
*
******************************************************************************
*/
/* Define to prevent recursive inclusion -------------------------------------*/
#ifndef STM32H573I_DK_AUDIO_H
#define STM32H573I_DK_AUDIO_H
#ifdef __cplusplus
extern "C" {
#endif
/* Includes ------------------------------------------------------------------*/
#include "stm32h573i_discovery_conf.h"
#include "stm32h573i_discovery_errno.h"
#include "../Components/Common/audio.h"
#ifndef USE_AUDIO_CODEC_CS42L51
#define USE_AUDIO_CODEC_CS42L51 1U
#endif
#if (USE_AUDIO_CODEC_CS42L51 == 1)
/* Include audio component Driver */
#include "../Components/cs42l51/cs42l51.h"
#endif
/** @addtogroup BSP
* @{
*/
/** @addtogroup STM32H573I_DK
* @{
*/
/** @addtogroup STM32H573I_DK_AUDIO
* @{
*/
/** @defgroup STM32H573I_DK_AUDIO_Exported_Types AUDIO Exported Types
* @{
*/
typedef struct
{
uint32_t Device; /* Output or input device */
uint32_t SampleRate; /* From 8kHz to 192 kHz */
uint32_t BitsPerSample; /* From 8 bits per sample to 32 bits per sample */
uint32_t ChannelsNbr; /* 1 for mono and 2 for stereo */
uint32_t Volume; /* In percentage from 0 to 100 */
} BSP_AUDIO_Init_t;
typedef struct
{
uint32_t Instance; /* Audio OUT instance */
uint32_t Device; /* Audio OUT device to be used */
uint32_t SampleRate; /* Audio OUT Sample rate */
uint32_t BitsPerSample; /* Audio OUT Sample Bit Per Sample */
uint32_t Volume; /* Audio OUT volume */
uint32_t ChannelsNbr; /* Audio OUT number of channel */
uint32_t IsMute; /* Mute state */
uint32_t State; /* Audio OUT State */
uint32_t IsMspCallbacksValid; /* Is Msp Callbacks registered */
}AUDIO_OUT_Ctx_t;
/* Audio in context */
typedef struct
{
uint32_t Device; /* Audio IN device to be used */
uint32_t SampleRate; /* Audio IN Sample rate */
uint32_t BitsPerSample; /* Audio IN Sample resolution */
uint32_t ChannelsNbr; /* Audio IN number of channel */
uint8_t *pBuff; /* Audio IN record buffer */
uint32_t Size; /* Audio IN record buffer size */
uint32_t Volume; /* Audio IN volume */
uint32_t State; /* Audio IN State */
uint32_t IsMspCallbacksValid; /* Is Msp Callbacks registered */
} AUDIO_IN_Ctx_t;
typedef struct
{
uint32_t AudioFrequency;
uint32_t AudioMode;
uint32_t DataSize;
uint32_t MonoStereoMode;
uint32_t ClockStrobing;
uint32_t Synchro;
uint32_t OutputDrive;
uint32_t SynchroExt;
uint32_t FrameLength;
uint32_t ActiveFrameLength;
uint32_t SlotActive;
} MX_SAI_Config_t;
#if (USE_HAL_SAI_REGISTER_CALLBACKS == 1)
typedef struct
{
pSAI_CallbackTypeDef pMspSaiInitCb;
pSAI_CallbackTypeDef pMspSaiDeInitCb;
} BSP_AUDIO_OUT_Cb_t;
typedef struct
{
pSAI_CallbackTypeDef pMspSaiInitCb;
pSAI_CallbackTypeDef pMspSaiDeInitCb;
} BSP_AUDIO_IN_Cb_t;
#endif /* (USE_HAL_SAI_REGISTER_CALLBACKS == 1) */
/**
* @}
*/
/** @defgroup STM32H573I_DK_AUDIO_Exported_Constants AUDIO Exported Constants
* @{
*/
#define AUDIO_I2C_ADDRESS 0x94U
/* Audio sample rate */
#define AUDIO_FREQUENCY_192K 192000U
#define AUDIO_FREQUENCY_176K 176400U
#define AUDIO_FREQUENCY_96K 96000U
#define AUDIO_FREQUENCY_88K 88200U
#define AUDIO_FREQUENCY_48K 48000U
#define AUDIO_FREQUENCY_44K 44100U
#define AUDIO_FREQUENCY_32K 32000U
#define AUDIO_FREQUENCY_22K 22050U
#define AUDIO_FREQUENCY_16K 16000U
#define AUDIO_FREQUENCY_11K 11025U
#define AUDIO_FREQUENCY_8K 8000U
/* Audio Out devices */
#define AUDIO_OUT_DEVICE_NONE 0U
#define AUDIO_OUT_DEVICE_SPEAKER 1U
#define AUDIO_OUT_DEVICE_HEADPHONE 2U
#define AUDIO_OUT_DEVICE_SPK_HP 3U
#define AUDIO_OUT_DEVICE_AUTO 4U
/* Audio bits per sample */
#define AUDIO_RESOLUTION_8B 8U
#define AUDIO_RESOLUTION_16B 16U
#define AUDIO_RESOLUTION_24B 24U
#define AUDIO_RESOLUTION_32B 32U
/* Audio mute state */
#define AUDIO_MUTE_DISABLED 0U
#define AUDIO_MUTE_ENABLED 1U
/* Audio Out states */
#define AUDIO_OUT_STATE_RESET 0U
#define AUDIO_OUT_STATE_PLAYING 1U
#define AUDIO_OUT_STATE_STOP 2U
#define AUDIO_OUT_STATE_PAUSE 3U
/* Audio Out states */
/* Volume Input Output selection */
#define AUDIO_VOLUME_INPUT 0U
#define AUDIO_VOLUME_OUTPUT 1U
/* Codec commands */
#define CODEC_PDWN_SW 1U
#define CODEC_MUTE_ON 1U
#define CODEC_MUTE_OFF 0U
/* Audio Out instances number */
#define AUDIO_OUT_INSTANCES_NBR 1U
/* SAI peripheral configuration defines */
#define AUDIO_OUT_SAI SAI2_Block_A
#define AUDIO_OUT_SAI_CLK_ENABLE() __HAL_RCC_SAI2_CLK_ENABLE()
#define AUDIO_OUT_SAI_CLK_DISABLE() __HAL_RCC_SAI2_CLK_DISABLE()
#define AUDIO_OUT_SAI_MCLK_ENABLE() __HAL_RCC_GPIOI_CLK_ENABLE()
#define AUDIO_OUT_SAI_MCLK_GPIO_PORT GPIOI
#define AUDIO_OUT_SAI_MCLK_PIN GPIO_PIN_4
#define AUDIO_OUT_SAI_MCLK_AF GPIO_AF10_SAI2
#define AUDIO_OUT_SAI_SCK_ENABLE() __HAL_RCC_GPIOI_CLK_ENABLE()
#define AUDIO_OUT_SAI_SCK_GPIO_PORT GPIOI
#define AUDIO_OUT_SAI_SCK_PIN GPIO_PIN_5
#define AUDIO_OUT_SAI_SCK_AF GPIO_AF10_SAI2
#define AUDIO_OUT_SAI_SD_ENABLE() __HAL_RCC_GPIOI_CLK_ENABLE()
#define AUDIO_OUT_SAI_SD_GPIO_PORT GPIOI
#define AUDIO_OUT_SAI_SD_PIN GPIO_PIN_6
#define AUDIO_OUT_SAI_SD_AF GPIO_AF10_SAI2
#define AUDIO_OUT_SAI_FS_ENABLE() __HAL_RCC_GPIOI_CLK_ENABLE()
#define AUDIO_OUT_SAI_FS_GPIO_PORT GPIOI
#define AUDIO_OUT_SAI_FS_PIN GPIO_PIN_7
#define AUDIO_OUT_SAI_FS_AF GPIO_AF10_SAI2
#define AUDIO_NRST_ENABLE() __HAL_RCC_GPIOI_CLK_ENABLE()
#define AUDIO_NRST_GPIO_PORT GPIOI
#define AUDIO_NRST_PIN GPIO_PIN_11
/* SAI DMA Stream definitions */
#define AUDIO_OUT_SAI_DMA_CLK_ENABLE() __HAL_RCC_GPDMA1_CLK_ENABLE()
#define AUDIO_OUT_SAI_DMA_CHANNEL GPDMA1_Channel2
#define AUDIO_OUT_SAI_DMA_REQUEST GPDMA1_REQUEST_SAI2_A
#define AUDIO_OUT_SAI_DMA_IRQ GPDMA1_Channel2_IRQn
#define AUDIO_OUT_SAI_DMA_IRQHandler GPDMA1_Channel2_IRQHandler
/*------------------------------------------------------------------------------
AUDIO IN CONFIGURATION
------------------------------------------------------------------------------*/
/* SAI peripheral configuration defines */
#define AUDIO_IN_SAI SAI2_Block_B
#define AUDIO_IN_SAI_CLK_ENABLE() __HAL_RCC_SAI2_CLK_ENABLE()
#define AUDIO_IN_SAI_CLK_DISABLE() __HAL_RCC_SAI2_CLK_DISABLE()
#define AUDIO_IN_SAI_AF GPIO_AF10_SAI2
#define AUDIO_IN_SAI_SD_ENABLE() __HAL_RCC_GPIOG_CLK_ENABLE()
#define AUDIO_IN_SAI_SD_GPIO_PORT GPIOG
#define AUDIO_IN_SAI_SD_PIN GPIO_PIN_10
/* SAI DMA Stream definitions */
#define AUDIO_IN_SAI_DMA_CLK_ENABLE() __HAL_RCC_GPDMA1_CLK_ENABLE()
#define AUDIO_IN_SAI_DMA_CHANNEL GPDMA1_Channel1
#define AUDIO_IN_SAI_DMA_REQUEST GPDMA1_REQUEST_SAI2_B
#define AUDIO_IN_SAI_DMA_IRQ GPDMA1_Channel1_IRQn
#define AUDIO_IN_SAI_DMA_IRQHandler GPDMA1_Channel1_IRQHandler
/* SAI PDM input definitions */
#define AUDIO_IN_SAI_PDM SAI1_Block_A
#define AUDIO_IN_SAI_PDM_CLK_ENABLE() __HAL_RCC_SAI1_CLK_ENABLE()
#define AUDIO_IN_SAI_PDM_CLK_DISABLE() __HAL_RCC_SAI1_CLK_DISABLE()
#define AUDIO_IN_SAI_PDM_CLK_IN_ENABLE() __HAL_RCC_GPIOD_CLK_ENABLE()
#define AUDIO_IN_SAI_PDM_CLK_IN_PIN GPIO_PIN_11
#define AUDIO_IN_SAI_PDM_CLK_IN_PORT GPIOD
#define AUDIO_IN_SAI_PDM_DATA_IN_ENABLE() __HAL_RCC_GPIOD_CLK_ENABLE()
#define AUDIO_IN_SAI_PDM_DATA_IN_PIN GPIO_PIN_6
#define AUDIO_IN_SAI_PDM_DATA_IN_PORT GPIOD
#define AUDIO_IN_SAI_PDM_DATA_CLK_AF GPIO_AF2_SAI1
#define AUDIO_IN_SAI_PDM_IRQHandler SAI1_IRQHandler
#define AUDIO_IN_SAI_PDM_IRQ SAI1_IRQn
/* SAI PDM DMA Stream definitions */
#define AUDIO_IN_SAI_PDM_DMA_CLK_ENABLE() __HAL_RCC_GPDMA1_CLK_ENABLE()
#define AUDIO_IN_SAI_PDM_DMA_CHANNEL GPDMA1_Channel3
#define AUDIO_IN_SAI_PDM_DMA_REQUEST GPDMA1_REQUEST_SAI1_A
#define AUDIO_IN_SAI_PDM_DMA_IRQ GPDMA1_Channel3_IRQn
#define AUDIO_IN_SAI_PDM_DMA_IRQHandler GPDMA1_Channel3_IRQHandler
/* Audio In instances number:
Instance 0 is SAI path
Instance 1 is SAI PDM path
*/
#define AUDIO_IN_INSTANCES_NBR 2U
/* Audio input devices count */
#define AUDIO_IN_DEVICE_NUMBER 2U
/* Analog microphone input from 3.5 audio jack connector */
#define AUDIO_IN_DEVICE_ANALOG_MIC 0x00U
/* MP34DT01TR digital microphone on PCB top side */
#define AUDIO_IN_DEVICE_DIGITAL_MIC1 0x01U /* digital microphone 1 */
#define AUDIO_IN_DEVICE_DIGITAL_MIC AUDIO_IN_DEVICE_DIGITAL_MIC1
/* Audio in states */
#define AUDIO_IN_STATE_RESET 0U
#define AUDIO_IN_STATE_RECORDING 1U
#define AUDIO_IN_STATE_STOP 2U
#define AUDIO_IN_STATE_PAUSE 3U
/**
* @}
*/
/** @addtogroup STM32H573I_DK_AUDIO_Exported_Variables
* @{
*/
/* Audio in and out context */
extern AUDIO_OUT_Ctx_t Audio_Out_Ctx[AUDIO_OUT_INSTANCES_NBR];
extern AUDIO_IN_Ctx_t Audio_In_Ctx[AUDIO_IN_INSTANCES_NBR];
/* Audio component object */
extern void *Audio_CompObj;
/* Audio driver */
extern AUDIO_Drv_t *Audio_Drv;
/* Play */
extern SAI_HandleTypeDef haudio_out_sai;
/* Record */
extern SAI_HandleTypeDef haudio_in_sai;
/* Audio in and out DMA handles used by SAI */
extern DMA_HandleTypeDef hDmaSaiTx, hDmaSaiRx;
/**
* @}
*/
/** @defgroup STM32H573I_DK_AUDIO_OUT_Exported_Functions AUDIO OUT Exported Functions
* @{
*/
int32_t BSP_AUDIO_OUT_Init(uint32_t Instance, BSP_AUDIO_Init_t *AudioInit);
int32_t BSP_AUDIO_OUT_DeInit(uint32_t Instance);
int32_t BSP_AUDIO_OUT_Play(uint32_t Instance, uint8_t *pData, uint32_t NbrOfBytes);
int32_t BSP_AUDIO_OUT_Pause(uint32_t Instance);
int32_t BSP_AUDIO_OUT_Resume(uint32_t Instance);
int32_t BSP_AUDIO_OUT_Stop(uint32_t Instance);
int32_t BSP_AUDIO_OUT_Mute(uint32_t Instance);
int32_t BSP_AUDIO_OUT_UnMute(uint32_t Instance);
int32_t BSP_AUDIO_OUT_IsMute(uint32_t Instance, uint32_t *IsMute);
int32_t BSP_AUDIO_OUT_SetVolume(uint32_t Instance, uint32_t Volume);
int32_t BSP_AUDIO_OUT_GetVolume(uint32_t Instance, uint32_t *Volume);
int32_t BSP_AUDIO_OUT_SetSampleRate(uint32_t Instance, uint32_t SampleRate);
int32_t BSP_AUDIO_OUT_GetSampleRate(uint32_t Instance, uint32_t *SampleRate);
int32_t BSP_AUDIO_OUT_SetDevice(uint32_t Instance, uint32_t Device);
int32_t BSP_AUDIO_OUT_GetDevice(uint32_t Instance, uint32_t *Device);
int32_t BSP_AUDIO_OUT_SetBitsPerSample(uint32_t Instance, uint32_t BitsPerSample);
int32_t BSP_AUDIO_OUT_GetBitsPerSample(uint32_t Instance, uint32_t *BitsPerSample);
int32_t BSP_AUDIO_OUT_SetChannelsNbr(uint32_t Instance, uint32_t ChannelNbr);
int32_t BSP_AUDIO_OUT_GetChannelsNbr(uint32_t Instance, uint32_t *ChannelNbr);
int32_t BSP_AUDIO_OUT_GetState(uint32_t Instance, uint32_t *State);
#if (USE_HAL_SAI_REGISTER_CALLBACKS == 1)
int32_t BSP_AUDIO_OUT_RegisterDefaultMspCallbacks(uint32_t Instance);
int32_t BSP_AUDIO_OUT_RegisterMspCallbacks(uint32_t Instance, BSP_AUDIO_OUT_Cb_t *CallBacks);
#endif /* (USE_HAL_SAI_REGISTER_CALLBACKS == 1) */
void BSP_AUDIO_OUT_TransferComplete_CallBack(uint32_t Instance);
void BSP_AUDIO_OUT_HalfTransfer_CallBack(uint32_t Instance);
void BSP_AUDIO_OUT_Error_CallBack(uint32_t Instance);
void BSP_AUDIO_OUT_IRQHandler(uint32_t Instance, uint32_t Device);
HAL_StatusTypeDef MX_SAI2_ClockConfig(SAI_HandleTypeDef *hsai, uint32_t SampleRate);
HAL_StatusTypeDef MX_SAI2_Init(SAI_HandleTypeDef *hsai, MX_SAI_Config_t *MXInit);
/**
* @}
*/
/** @defgroup STM32H573I_DK_AUDIO_IN_Exported_Functions AUDIO IN Exported Functions
* @{
*/
int32_t BSP_AUDIO_IN_Init(uint32_t Instance, BSP_AUDIO_Init_t *AudioInit);
int32_t BSP_AUDIO_IN_DeInit(uint32_t Instance);
int32_t BSP_AUDIO_IN_Record(uint32_t Instance, uint8_t *pData, uint32_t NbrOfBytes);
int32_t BSP_AUDIO_IN_Pause(uint32_t Instance);
int32_t BSP_AUDIO_IN_Resume(uint32_t Instance);
int32_t BSP_AUDIO_IN_Stop(uint32_t Instance);
int32_t BSP_AUDIO_IN_SetVolume(uint32_t Instance, uint32_t Volume);
int32_t BSP_AUDIO_IN_GetVolume(uint32_t Instance, uint32_t *Volume);
int32_t BSP_AUDIO_IN_SetSampleRate(uint32_t Instance, uint32_t SampleRate);
int32_t BSP_AUDIO_IN_GetSampleRate(uint32_t Instance, uint32_t *SampleRate);
int32_t BSP_AUDIO_IN_SetDevice(uint32_t Instance, uint32_t Device);
int32_t BSP_AUDIO_IN_GetDevice(uint32_t Instance, uint32_t *Device);
int32_t BSP_AUDIO_IN_SetBitsPerSample(uint32_t Instance, uint32_t BitsPerSample);
int32_t BSP_AUDIO_IN_GetBitsPerSample(uint32_t Instance, uint32_t *BitsPerSample);
int32_t BSP_AUDIO_IN_SetChannelsNbr(uint32_t Instance, uint32_t ChannelNbr);
int32_t BSP_AUDIO_IN_GetChannelsNbr(uint32_t Instance, uint32_t *ChannelNbr);
int32_t BSP_AUDIO_IN_GetState(uint32_t Instance, uint32_t *State);
/* Specific PDM recodr APIs */
int32_t BSP_AUDIO_IN_RecordPDM(uint32_t Instance, uint8_t* pBuf, uint32_t NbrOfBytes);
#if (USE_HAL_SAI_REGISTER_CALLBACKS == 1)
int32_t BSP_AUDIO_IN_RegisterDefaultMspCallbacks(uint32_t Instance);
int32_t BSP_AUDIO_IN_RegisterMspCallbacks(uint32_t Instance, BSP_AUDIO_IN_Cb_t *CallBacks);
#endif /* USE_HAL_SAI_REGISTER_CALLBACKS == 1 */
void BSP_AUDIO_IN_TransferComplete_CallBack(uint32_t Instance);
void BSP_AUDIO_IN_HalfTransfer_CallBack(uint32_t Instance);
void BSP_AUDIO_IN_Error_CallBack(uint32_t Instance);
void BSP_AUDIO_IN_IRQHandler(uint32_t Instance, uint32_t Device);
HAL_StatusTypeDef MX_SAI1_ClockConfig(SAI_HandleTypeDef *hsai, uint32_t SampleRate);
HAL_StatusTypeDef MX_SAI1_Init(SAI_HandleTypeDef* hsai, MX_SAI_Config_t *MXConfig);
/**
* @}
*/
/**
* @}
*/
/**
* @}
*/
/**
* @}
*/
#ifdef __cplusplus
}
#endif
#endif /* STM32H573I_DK_AUDIO_H */