DSPLIB_blk_eswap

Introduction

Kernel for endian-swap of all input data.

• The data in \(dstPtr\) array is endian swapped, meaning that the byte-order of the bytes within each elements in input array \(srcPtr\) is reversed. This facilitates moving of big-endian data to a little-endian system or vice-versa.
• The kernel supports both In-place and Out-of-place endian swap.
  • In-place endian swap occurs when \(dstPtr = NULL\), allowing the swap to occur without using any additional storage
  • Out-of-place endian swap occurs when \(dstPtr \neq NULL\)

• Following datatypes are supported :
  • DSPLIB_INT16, DSPLIB_INT32, DSPLIB_INT64, DSPLIB_UINT16, DSPLIB_UINT32, DSPLIB_UINT64, DSPLIB_FLOAT32, DSPLIB_FLOAT64

Data Structures
struct	DSPLIB_blk_eswap_InitArgs
	Structure containing the parameters to initialize the kernel. More...

Functions
int32_t	DSPLIB_blk_eswap_getHandleSize (DSPLIB_blk_eswap_InitArgs *pKerInitArgs)
	This is a query function to calculate the size of internal handle. More...
DSPLIB_STATUS	DSPLIB_blk_eswap_init (DSPLIB_kernelHandle handle, DSPLIB_bufParams1D_t *bufParamsIn, DSPLIB_bufParams1D_t *bufParamsOut, const DSPLIB_blk_eswap_InitArgs *pKerInitArgs)
	This function should be called before the DSPLIB_blk_eswap_exec function is called. This function takes care of any one-time operations such as setting up the configuration of required hardware resources such as the streaming engine and streaming address generator. The results of these operations are stored in the handle. More...
DSPLIB_STATUS	DSPLIB_blk_eswap_init_checkParams (DSPLIB_kernelHandle handle, const DSPLIB_bufParams1D_t *bufParamsIn, const DSPLIB_bufParams1D_t *bufParamsOut, const DSPLIB_blk_eswap_InitArgs *pKerInitArgs)
	This function checks the validity of the parameters passed to DSPLIB_blk_eswap_init function. This function is called with the same parameters as the DSPLIB_blk_eswap_init, and this function must be called before the DSPLIB_blk_eswap_init is called. More...
DSPLIB_STATUS	DSPLIB_blk_eswap_exec_checkParams (DSPLIB_kernelHandle handle, const void *restrict pIn, const void *restrict pOut)
	This function checks the validity of the parameters passed to DSPLIB_blk_eswap_exec function. This function is called with the same parameters as the DSPLIB_blk_eswap_init, and this function must be called before the DSPLIB_blk_eswap_init is called. More...
DSPLIB_STATUS	DSPLIB_blk_eswap_exec (DSPLIB_kernelHandle handle, void *restrict pIn, void *restrict pOut)
	This function is the main kernel swapping function. More...

Function Documentation

DSPLIB_blk_eswap_getHandleSize()

int32_t DSPLIB_blk_eswap_getHandleSize

(

DSPLIB_blk_eswap_InitArgs *

pKerInitArgs

)

This is a query function to calculate the size of internal handle.

Parameters

[in]

pKerInitArgs

: Pointer to structure holding init parameters

Returns

Size of the buffer in bytes

Remarks

Application is expected to allocate buffer of the requested size and provide it as input to other functions requiring it.

Definition at line 25 of file DSPLIB_blk_eswap.cpp.

DSPLIB_blk_eswap_init()

DSPLIB_STATUS DSPLIB_blk_eswap_init	(	DSPLIB_kernelHandle	handle,
		DSPLIB_bufParams1D_t *	bufParamsIn,
		DSPLIB_bufParams1D_t *	bufParamsOut,
		const DSPLIB_blk_eswap_InitArgs *	pKerInitArgs
	)

This function should be called before the DSPLIB_blk_eswap_exec function is called. This function takes care of any one-time operations such as setting up the configuration of required hardware resources such as the streaming engine and streaming address generator. The results of these operations are stored in the handle.

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.

Remarks

Application is expected to provide a valid handle.

Definition at line 86 of file DSPLIB_blk_eswap.cpp.

DSPLIB_blk_eswap_init_checkParams()

DSPLIB_STATUS DSPLIB_blk_eswap_init_checkParams	(	DSPLIB_kernelHandle	handle,
		const DSPLIB_bufParams1D_t *	bufParamsIn,
		const DSPLIB_bufParams1D_t *	bufParamsOut,
		const DSPLIB_blk_eswap_InitArgs *	pKerInitArgs
	)

This function checks the validity of the parameters passed to DSPLIB_blk_eswap_init function. This function is called with the same parameters as the DSPLIB_blk_eswap_init, and this function must be called before the DSPLIB_blk_eswap_init is called.

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 output buffer
[in]	pKerInitArgs	: Pointer to the structure holding init parameters

Returns

Status value indicating success or failure. Refer to DSPLIB_STATUS.

Remarks

None

Definition at line 34 of file DSPLIB_blk_eswap.cpp.

DSPLIB_blk_eswap_exec_checkParams()

DSPLIB_STATUS DSPLIB_blk_eswap_exec_checkParams	(	DSPLIB_kernelHandle	handle,
		const void *restrict	pIn,
		const void *restrict	pOut
	)

This function checks the validity of the parameters passed to DSPLIB_blk_eswap_exec function. This function is called with the same parameters as the DSPLIB_blk_eswap_init, and this function must be called before the DSPLIB_blk_eswap_init is called.

Parameters

[in]	handle	: Active handle to the kernel
[in]	pIn	: Pointer to the structure input buffer
[out]	pout	: Pointer to the output buffer

Returns

Status value indicating success or failure. Refer to DSPLIB_STATUS.

Remarks

None

Definition at line 69 of file DSPLIB_blk_eswap.cpp.

DSPLIB_blk_eswap_exec()

DSPLIB_STATUS DSPLIB_blk_eswap_exec	(	DSPLIB_kernelHandle	handle,
		void *restrict	pIn,
		void *restrict	pOut
	)

This function is the main kernel swapping function.

Please refer to details under DSPLIB_blk_eswap_exec

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.

Assumptions:

• None

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

Remarks

Before calling this function, application is expected to call DSPLIB_blk_eswap_init and DSPLIB_blk_eswap_exec_checkParams functions. This ensures resource configuration and error checks are done only once for several invocations of this function.

Definition at line 181 of file DSPLIB_blk_eswap.cpp.