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
|
/*
* Copyright 2019-2020 NXP
* All rights reserved.
*
* SPDX-License-Identifier: BSD-3-Clause
*/
#ifndef _FSL_ASRC_P2P_EDMA_H_
#define _FSL_ASRC_P2P_EDMA_H_
#include "fsl_edma.h"
#include "fsl_asrc.h"
/*!
* @addtogroup asrc_edma_driver
* @{
*/
/*******************************************************************************
* Definitions
******************************************************************************/
/*! @name Driver version */
/*@{*/
#define FSL_ASRC_EDMA_DRIVER_VERSION (MAKE_VERSION(2, 1, 0)) /*!< Version 2.1.0 */
/*@}*/
/*!< @brief ASRC IN edma QUEUE size */
#define ASRC_XFER_IN_QUEUE_SIZE 4U
#define ASRC_XFER_OUT_QUEUE_SIZE (ASRC_XFER_QUEUE_SIZE * 2U)
typedef struct _asrc_edma_handle asrc_edma_handle_t;
/*! @brief ASRC eDMA transfer callback function for finish and error */
typedef void (*asrc_edma_callback_t)(ASRC_Type *base, asrc_edma_handle_t *handle, status_t status, void *userData);
/*! @brief ASRC trigger peripheral function pointer */
typedef void (*asrc_start_peripheral_t)(bool start);
/*! @brief destination peripheral configuration */
typedef struct _asrc_p2p_edma_config
{
uint8_t watermark; /*!< peripheral watermark */
uint8_t channel; /*!< peripheral channel number */
asrc_start_peripheral_t startPeripheral; /*!< trigger peripheral start */
} asrc_p2p_edma_config_t;
/*!@ brief asrc in edma handler */
typedef struct _asrc_in_edma_handle
{
edma_handle_t *inDmaHandle; /*!< DMA handler for ASRC in */
uint8_t tcd[(ASRC_XFER_IN_QUEUE_SIZE + 1U) * sizeof(edma_tcd_t)]; /*!< TCD pool for eDMA send. */
uint32_t sampleWidth; /*!< input data width */
uint32_t fifoThreshold; /*!< ASRC input fifo threshold */
uint32_t *asrcQueue[ASRC_XFER_IN_QUEUE_SIZE]; /*!< Transfer queue storing queued transfer. */
size_t transferSize[ASRC_XFER_IN_QUEUE_SIZE]; /*!< Data bytes need to transfer */
volatile uint8_t queueUser; /*!< Index for user to queue transfer. */
volatile uint8_t queueDriver; /*!< Index for driver to get the transfer data and size */
uint32_t state; /*!< Internal state for ASRC eDMA transfer */
const asrc_p2p_edma_config_t *peripheralConfig; /*!< peripheral configuration pointer */
} asrc_in_edma_handle_t;
/*!@ brief asrc out edma handler */
typedef struct _asrc_out_edma_handle
{
edma_handle_t *outDmaHandle; /*!< DMA handler for ASRC out */
uint8_t tcd[(ASRC_XFER_OUT_QUEUE_SIZE + 1U) * sizeof(edma_tcd_t)]; /*!< TCD pool for eDMA send. */
uint32_t sampleWidth; /*!< output data width */
uint32_t fifoThreshold; /*!< ASRC output fifo threshold */
uint32_t *asrcQueue[ASRC_XFER_OUT_QUEUE_SIZE]; /*!< Transfer queue storing queued transfer. */
size_t transferSize[ASRC_XFER_OUT_QUEUE_SIZE]; /*!< Data bytes need to transfer */
volatile uint8_t queueUser; /*!< Index for user to queue transfer. */
volatile uint8_t queueDriver; /*!< Index for driver to get the transfer data and size */
uint32_t state; /*!< Internal state for ASRC eDMA transfer */
const asrc_p2p_edma_config_t *peripheralConfig; /*!< peripheral configuration pointer */
} asrc_out_edma_handle_t;
/*! @brief ASRC DMA transfer handle.*/
struct _asrc_edma_handle
{
asrc_in_edma_handle_t in; /*!< asrc in handler */
asrc_out_edma_handle_t out; /*!< asrc out handler */
asrc_channel_pair_t channelPair; /*!< channel pair */
void *userData; /*!< User callback parameter */
asrc_edma_callback_t callback; /*!< Callback for users while transfer finish or error occurs */
};
/*******************************************************************************
* APIs
******************************************************************************/
#if defined(__cplusplus)
extern "C" {
#endif
/*!
* @name eDMA Transactional
* @{
*/
/*!
* @brief Initializes the ASRC IN eDMA handle.
*
* This function initializes the ASRC DMA handle, which can be used for other ASRC transactional APIs.
* Usually, for a specified ASRC channel pair, call this API once to get the initialized handle.
*
* @param base ASRC base pointer.
* @param channelPair ASRC channel pair
* @param handle ASRC eDMA handle pointer.
* @param callback Pointer to user callback function.
* @param inDmaHandle DMA handler for ASRC in.
* @param periphConfig peripheral configuration.
* @param userData User parameter passed to the callback function.
*/
void ASRC_TransferInCreateHandleEDMA(ASRC_Type *base,
asrc_edma_handle_t *handle,
asrc_channel_pair_t channelPair,
asrc_edma_callback_t callback,
edma_handle_t *inDmaHandle,
const asrc_p2p_edma_config_t *periphConfig,
void *userData);
/*!
* @brief Initializes the ASRC OUT eDMA handle.
*
* This function initializes the ASRC DMA handle, which can be used for other ASRC transactional APIs.
* Usually, for a specified ASRC channel pair, call this API once to get the initialized handle.
*
* @param base ASRC base pointer.
* @param channelPair ASRC channel pair
* @param handle ASRC eDMA handle pointer.
* @param callback Pointer to user callback function.
* @param outDmaHandle DMA handler for ASRC out.
* @param periphConfig peripheral configuration.
* @param userData User parameter passed to the callback function.
*/
void ASRC_TransferOutCreateHandleEDMA(ASRC_Type *base,
asrc_edma_handle_t *handle,
asrc_channel_pair_t channelPair,
asrc_edma_callback_t callback,
edma_handle_t *outDmaHandle,
const asrc_p2p_edma_config_t *periphConfig,
void *userData);
/*!
* @brief Configures the ASRC P2P channel pair.
*
*
* @param base ASRC base pointer.
* @param handle ASRC eDMA handle pointer.
* @param asrcConfig asrc configurations.
* @param inSampleRate ASRC input sample rate.
* @param outSampleRate ASRC output sample rate.
*/
status_t ASRC_TransferSetChannelPairConfigEDMA(ASRC_Type *base,
asrc_edma_handle_t *handle,
asrc_channel_pair_config_t *asrcConfig,
uint32_t inSampleRate,
uint32_t outSampleRate);
/*!
* @brief Get output sample buffer size can be transferred by edma.
*
* @note This API is depends on the ASRC output configuration, should be called after the
* ASRC_TransferSetChannelPairConfigEDMA.
*
* @param base asrc base pointer.
* @param handle ASRC channel pair edma handle.
* @param inSampleRate input sample rate.
* @param outSampleRate output sample rate.
* @param inSamplesize input sampleS size.
* @retval output buffer size in byte.
*/
uint32_t ASRC_GetOutSamplesSizeEDMA(
ASRC_Type *base, asrc_edma_handle_t *handle, uint32_t inSampleRate, uint32_t outSampleRate, uint32_t inSamplesize);
/*!
* @brief Performs a non-blocking ASRC m2m convert using EDMA.
*
* @note This interface returns immediately after the transfer initiates.
* @param base ASRC base pointer.
* @param handle ASRC eDMA handle pointer.
* @param xfer Pointer to the DMA transfer structure.
* @retval kStatus_Success Start a ASRC eDMA send successfully.
* @retval kStatus_InvalidArgument The input argument is invalid.
* @retval kStatus_ASRCQueueFull ASRC EDMA driver queue is full.
*/
status_t ASRC_TransferEDMA(ASRC_Type *base, asrc_edma_handle_t *handle, asrc_transfer_t *xfer);
/*!
* @brief Aborts a ASRC IN transfer using eDMA.
*
* This function only aborts the current transfer slots, the other transfer slots' information still kept
* in the handler. If users want to terminate all transfer slots, just call ASRC_TransferTerminalP2PEDMA.
*
* @param base ASRC base pointer.
* @param handle ASRC eDMA handle pointer.
*/
void ASRC_TransferInAbortEDMA(ASRC_Type *base, asrc_edma_handle_t *handle);
/*!
* @brief Aborts a ASRC OUT transfer using eDMA.
*
* This function only aborts the current transfer slots, the other transfer slots' information still kept
* in the handler. If users want to terminate all transfer slots, just call ASRC_TransferTerminalP2PEDMA.
*
* @param base ASRC base pointer.
* @param handle ASRC eDMA handle pointer.
*/
void ASRC_TransferOutAbortEDMA(ASRC_Type *base, asrc_edma_handle_t *handle);
/*!
* @brief Terminate In ASRC Convert.
*
* This function will clear all transfer slots buffered in the asrc queue. If users only want to abort the
* current transfer slot, please call ASRC_TransferAbortPP2PEDMA.
*
* @param base ASRC base pointer.
* @param handle ASRC eDMA handle pointer.
*/
void ASRC_TransferInTerminalEDMA(ASRC_Type *base, asrc_edma_handle_t *handle);
/*!
* @brief Terminate Out ASRC Convert.
*
* This function will clear all transfer slots buffered in the asrc queue. If users only want to abort the
* current transfer slot, please call ASRC_TransferAbortPP2PEDMA.
*
* @param base ASRC base pointer.
* @param handle ASRC eDMA handle pointer.
*/
void ASRC_TransferOutTerminalEDMA(ASRC_Type *base, asrc_edma_handle_t *handle);
/*! @} */
#if defined(__cplusplus)
}
#endif
/*!
* @}
*/
#endif
|
