DSPLIB User Guide
Functions
DSPLIB_q15tofl_ci.cpp File Reference

Go to the source code of this file.

Functions

template<typename dataTypeOut >
__SE_TEMPLATE_v1 q15tofl_se_init (int32_t blockSize)
 
template<>
__SE_TEMPLATE_v1 q15tofl_se_init< float > (int32_t blockSize)
 
template<>
__SE_TEMPLATE_v1 q15tofl_se_init< double > (int32_t blockSize)
 
template<typename dataTypeOut >
DSPLIB_STATUS DSPLIB_q15tofl_init_ci (DSPLIB_kernelHandle handle, const DSPLIB_bufParams1D_t *bufParamsIn, const DSPLIB_bufParams1D_t *bufParamsOut, const DSPLIB_q15tofl_InitArgs *pKerInitArgs)
 This function is the initialization function for the C7x implementation of the kernel. The function declaration conforms to the declaration of DSPLIB_q15tofl_init. More...
 
template DSPLIB_STATUS DSPLIB_q15tofl_init_ci< float > (DSPLIB_kernelHandle handle, const DSPLIB_bufParams1D_t *bufParamsIn, const DSPLIB_bufParams1D_t *bufParamsOut, const DSPLIB_q15tofl_InitArgs *pKerInitArgs)
 
template DSPLIB_STATUS DSPLIB_q15tofl_init_ci< double > (DSPLIB_kernelHandle handle, const DSPLIB_bufParams1D_t *bufParamsIn, const DSPLIB_bufParams1D_t *bufParamsOut, const DSPLIB_q15tofl_InitArgs *pKerInitArgs)
 
template<typename dataTypeOut >
void q15tofl_convert (dataTypeOut *restrict pOutLocal, int32_t blockSize)
 
template<>
void q15tofl_convert< float > (float *restrict pOutLocal, int32_t blockSize)
 
template<>
void q15tofl_convert< double > (double *restrict pOutLocal, int32_t blockSize)
 
template<typename dataTypeOut >
DSPLIB_STATUS DSPLIB_q15tofl_exec_ci (DSPLIB_kernelHandle handle, void *restrict pIn, void *restrict pOut)
 This function is the main execution function for the C7x implementation of the kernel. The function declaration conforms to the declaration of DSPLIB_q15tofl_exec. More...
 
template DSPLIB_STATUS DSPLIB_q15tofl_exec_ci< float > (DSPLIB_kernelHandle handle, void *restrict pIn, void *restrict pOut)
 
template DSPLIB_STATUS DSPLIB_q15tofl_exec_ci< double > (DSPLIB_kernelHandle handle, void *restrict pIn, void *restrict pOut)
 

Function Documentation

◆ q15tofl_se_init()

template<typename dataTypeOut >
__SE_TEMPLATE_v1 q15tofl_se_init ( int32_t  blockSize)
inline

◆ q15tofl_se_init< float >()

template<>
__SE_TEMPLATE_v1 q15tofl_se_init< float > ( int32_t  blockSize)
inline

Definition at line 51 of file DSPLIB_q15tofl_ci.cpp.

◆ q15tofl_se_init< double >()

template<>
__SE_TEMPLATE_v1 q15tofl_se_init< double > ( int32_t  blockSize)
inline

Definition at line 68 of file DSPLIB_q15tofl_ci.cpp.

◆ DSPLIB_q15tofl_init_ci()

template<typename dataTypeOut >
DSPLIB_STATUS DSPLIB_q15tofl_init_ci ( DSPLIB_kernelHandle  handle,
const DSPLIB_bufParams1D_t *  bufParamsIn,
const DSPLIB_bufParams1D_t *  bufParamsOut,
const DSPLIB_q15tofl_InitArgs *  pKerInitArgs 
)

This function is the initialization function for the C7x implementation of the kernel. The function declaration conforms to the declaration of DSPLIB_q15tofl_init.

This function determines the configuration for the streaming engine resources based on the function call parameters, and the configuration is saved in bufPBlock array. In the kernel call sequence, DSPLIB_q15tofl_exec_ci would be called later independently by the application. When DSPLIB_q15tofl_exec_ci runs, it merely retrieves the configuration from the bufPBlock and uses it to set up the hardware resources. This arrangement is so that DSPLIB_q15tofl_exec_ci does not lose cycles to determine the hardware configuration.

Parameters
[in]handle: Active handle to the kernel
[in]bufParamsIn: Pointer to the structure containing dimensional information of input buffer
[out]bufParamsOut: Pointer to the structure containing dimensional information of ouput buffer
[in]pKerInitArgs: Pointer to the structure holding init parameters
Returns
Status value indicating success or failure. Refer to DSPLIB_STATUS.

Definition at line 86 of file DSPLIB_q15tofl_ci.cpp.

◆ DSPLIB_q15tofl_init_ci< float >()

template DSPLIB_STATUS DSPLIB_q15tofl_init_ci< float > ( DSPLIB_kernelHandle  handle,
const DSPLIB_bufParams1D_t *  bufParamsIn,
const DSPLIB_bufParams1D_t *  bufParamsOut,
const DSPLIB_q15tofl_InitArgs *  pKerInitArgs 
)

◆ DSPLIB_q15tofl_init_ci< double >()

template DSPLIB_STATUS DSPLIB_q15tofl_init_ci< double > ( DSPLIB_kernelHandle  handle,
const DSPLIB_bufParams1D_t *  bufParamsIn,
const DSPLIB_bufParams1D_t *  bufParamsOut,
const DSPLIB_q15tofl_InitArgs *  pKerInitArgs 
)

◆ q15tofl_convert()

template<typename dataTypeOut >
void q15tofl_convert ( dataTypeOut *restrict  pOutLocal,
int32_t  blockSize 
)
inline

◆ q15tofl_convert< float >()

template<>
void q15tofl_convert< float > ( float *restrict  pOutLocal,
int32_t  blockSize 
)
inline

Definition at line 135 of file DSPLIB_q15tofl_ci.cpp.

◆ q15tofl_convert< double >()

template<>
void q15tofl_convert< double > ( double *restrict  pOutLocal,
int32_t  blockSize 
)
inline

Definition at line 156 of file DSPLIB_q15tofl_ci.cpp.

◆ DSPLIB_q15tofl_exec_ci()

template<typename dataTypeOut >
DSPLIB_STATUS DSPLIB_q15tofl_exec_ci ( DSPLIB_kernelHandle  handle,
void *restrict  pIn,
void *restrict  pOut 
)

This function is the main execution function for the C7x implementation of the kernel. The function declaration conforms to the declaration of DSPLIB_q15tofl_exec.

The function uses SE engine to load 16-bit Q15 format data from memory, converts it into float / double and store it to the memory uing SA generator.

Parameters
[in]handle: Active handle to the kernel
[in]pIn: Pointer to buffer holding the input data
[out]pOut: Pointer to buffer holding the output data
Returns
Status value indicating success or failure. Refer to DSPLIB_STATUS.
Performance Considerations:
For best performance,
  • the input and output data buffers are expected to be in L2 memory
  • the buffer pointers are assumed to be 64-byte aligned

Definition at line 178 of file DSPLIB_q15tofl_ci.cpp.

◆ DSPLIB_q15tofl_exec_ci< float >()

template DSPLIB_STATUS DSPLIB_q15tofl_exec_ci< float > ( DSPLIB_kernelHandle  handle,
void *restrict  pIn,
void *restrict  pOut 
)

◆ DSPLIB_q15tofl_exec_ci< double >()

template DSPLIB_STATUS DSPLIB_q15tofl_exec_ci< double > ( DSPLIB_kernelHandle  handle,
void *restrict  pIn,
void *restrict  pOut 
)