TIOVX User Guide

Detailed Description

Helper APIs used used for host side kernel validation.

Defines

#define TIVX_KERNEL_COMMON_VALID_RECT_MAX_IMAGE   (5u)
 Maximum number of images (input/output) supported in calculating valid rectangles.
 

Functions

vx_status tivxPublishKernels (vx_context context, const Tivx_Host_Kernel_List *kernel_list, uint32_t num_kernels)
 Publishes the kernels list on the host side.
 
vx_status tivxUnPublishKernels (vx_context context, const Tivx_Host_Kernel_List *kernel_list, uint32_t num_kernels)
 Unpublishes the kernels list on the host side.
 
static void tivxKernelValidRectParams_init (tivxKernelValidRectParams *prms)
 Function to initialize Valid Rect Parameter structure Currently the entire structure is memset to 0. More...
 
vx_status tivxKernelConfigValidRect (tivxKernelValidRectParams *prms)
 Function to calculate and configure valid region This API loops over all the input and output image's valid rectangles and figures out overlapping rectangle and sets it as valid rectangle in the output image. More...
 
void tivxKernelsHostUtilsAddKernelTargetDsp (vx_kernel kernel)
 Function to add platform-specific DSP kernel target. More...
 
void tivxKernelsHostUtilsAddKernelTargetMcu (vx_kernel kernel)
 Function to add platform-specific R5F kernel target. More...
 

Function Documentation

◆ tivxKernelValidRectParams_init()

static void tivxKernelValidRectParams_init ( tivxKernelValidRectParams *  prms)
inlinestatic

Function to initialize Valid Rect Parameter structure Currently the entire structure is memset to 0.

Parameters
prms[in] Valid Rectange Parameters

STATIC INLINE FUNCTION DEFINITIONS

Definition at line 221 of file tivx_kernels_host_utils.h.

◆ tivxKernelConfigValidRect()

vx_status tivxKernelConfigValidRect ( tivxKernelValidRectParams *  prms)

Function to calculate and configure valid region This API loops over all the input and output image's valid rectangles and figures out overlapping rectangle and sets it as valid rectangle in the output image.

Each kernel may also require few lines/pixels of padding on each side of the image. Host side kernel can provide this information to this API and it will adjust valid rectangle considering padding requirement also.

This is utility API.

Parameters
prms[in] Valid Rectange Parameters

◆ tivxKernelsHostUtilsAddKernelTargetDsp()

void tivxKernelsHostUtilsAddKernelTargetDsp ( vx_kernel  kernel)

Function to add platform-specific DSP kernel target.

Cores which are assigned per SoC are below: J721E: TIVX_TARGET_DSP1 and TIVX_TARGET_DSP2 J721S2: TIVX_TARGET_DSP1 J784S4: TIVX_TARGET_DSP1 J722S: TIVX_TARGET_DSP1 and TIVX_TARGET_DSP2 AM62A: TIVX_TARGET_DSP1

◆ tivxKernelsHostUtilsAddKernelTargetMcu()

void tivxKernelsHostUtilsAddKernelTargetMcu ( vx_kernel  kernel)

Function to add platform-specific R5F kernel target.

Cores which are assigned per SoC are below: J721E: TIVX_TARGET_MCU2_0 and TIVX_TARGET_MCU2_1 J721S2: TIVX_TARGET_MCU2_0 and TIVX_TARGET_MCU2_1 J784S4: TIVX_TARGET_MCU2_0 and TIVX_TARGET_MCU2_1 J722S: TIVX_TARGET_MCU2_0 AM62A: TIVX_TARGET_MCU1_0