TI J721E Imaging User Guide
TI DMPAC SDE (Stereo Disparity Engine) Kernel APIs

Introduction

DMPAC Stereo Disparity Engine Kernels.

Sub Modules

 Enumerations
 Enumerations for DMPAC SDE error events.
 

Data Structures

struct  tivx_dmpac_sde_params_t
 The configuration data structure used by the TIVX_KERNEL_DMPAC_SDE kernel. More...
 

Functions

void tivxRegisterHwaTargetDmpacSdeKernels (void)
 Function to register HWA Kernels on the dmpac_sde Target. More...
 
void tivxUnRegisterHwaTargetDmpacSdeKernels (void)
 Function to un-register HWA Kernels on the dmpac_sde Target. More...
 
VX_API_ENTRY vx_node VX_API_CALL tivxDmpacSdeNode (vx_graph graph, vx_user_data_object configuration, vx_image left, vx_image right, vx_image output, vx_distribution confidence_histogram)
 [Graph] Creates a DMPAC_SDE Node. More...
 
void tivx_dmpac_sde_params_init (tivx_dmpac_sde_params_t *prms)
 Function to initialize SDE Parameters. More...
 

Macros

#define TIVX_KERNEL_DMPAC_SDE_NAME   "com.ti.hwa.dmpac_sde"
 dmpac_sde kernel name More...
 
#define TIVX_DMPAC_SDE_CMD_GET_ERR_STATUS   (0x10000001u)
 Control Command to get the combined error status Returns the combined error status of the last processed frame, incorporating error interrupts and watchdog timer error interrupt. A reference to vx_scalar is passed as an argument with this control command. The node returns a bit-mask of the error status in the U32 variable of vx_scalar. More...
 
#define TIVX_DMPAC_SDE_CMD_GET_PSA_STATUS   (0x10000002u)
 Control Command to retrieve the PSA signature values. More...
 

Macro Definition Documentation

◆ TIVX_KERNEL_DMPAC_SDE_NAME

#define TIVX_KERNEL_DMPAC_SDE_NAME   "com.ti.hwa.dmpac_sde"

dmpac_sde kernel name

◆ TIVX_DMPAC_SDE_CMD_GET_ERR_STATUS

#define TIVX_DMPAC_SDE_CMD_GET_ERR_STATUS   (0x10000001u)

Control Command to get the combined error status Returns the combined error status of the last processed frame, incorporating error interrupts and watchdog timer error interrupt. A reference to vx_scalar is passed as an argument with this control command. The node returns a bit-mask of the error status in the U32 variable of vx_scalar.

  • Error interrupt status bits (0–29) are directly taken from the sde_obj->err_stat variable.
  • If watchdog timer error is detected in sde (bit 1 in wd_err_status), this is flagged by setting bit 30 in the returned error status.
  • If watchdog timer error is detected in FOCO1 (bit 3 in wd_err_status), this is flagged by setting bit 31 in the returned error status.

◆ TIVX_DMPAC_SDE_CMD_GET_PSA_STATUS

#define TIVX_DMPAC_SDE_CMD_GET_PSA_STATUS   (0x10000002u)

Control Command to retrieve the PSA signature values.

Function Documentation

◆ tivxRegisterHwaTargetDmpacSdeKernels()

void tivxRegisterHwaTargetDmpacSdeKernels ( void  )

Function to register HWA Kernels on the dmpac_sde Target.

◆ tivxUnRegisterHwaTargetDmpacSdeKernels()

void tivxUnRegisterHwaTargetDmpacSdeKernels ( void  )

Function to un-register HWA Kernels on the dmpac_sde Target.

◆ tivxDmpacSdeNode()

VX_API_ENTRY vx_node VX_API_CALL tivxDmpacSdeNode ( vx_graph  graph,
vx_user_data_object  configuration,
vx_image  left,
vx_image  right,
vx_image  output,
vx_distribution  confidence_histogram 
)

[Graph] Creates a DMPAC_SDE Node.

Parameters
[in]graphThe reference to the graph.
[in]configurationThe input object of a single params structure of type tivx_dmpac_sde_params_t.
[in]leftThe left input image in VX_DF_IMAGE_U8, VX_DF_IMAGE_NV12 (Y plane only), VX_DF_IMAGE_U16, or TIVX_DF_IMAGE_P12 format.
[in]rightThe right input image in VX_DF_IMAGE_U8, VX_DF_IMAGE_NV12 (Y plane only), VX_DF_IMAGE_U16, or TIVX_DF_IMAGE_P12 format.
[out]outputThe output image in VX_DF_IMAGE_S16 format. Bit packing format: Sign[15], Integer[14:7], Fractional[6:3], Confidence[2:0].
The 3 bit 'Confidence' value is the result of passing the 7-bit confidence score through the user configured tivx_dmpac_sde_params_t::confidence_score_map range table to produce a 3-bit mapping.
[out]confidence_histogram(optional) Histogram of the full 7-bit confidence scores. Must be configured to 128 bins.
See also
TIVX_KERNEL_DMPAC_SDE_NAME
Returns
vx_node.
Return values
vx_nodeA node reference. Any possible errors preventing a successful creation should be checked using vxGetStatus

◆ tivx_dmpac_sde_params_init()

void tivx_dmpac_sde_params_init ( tivx_dmpac_sde_params_t prms)

Function to initialize SDE Parameters.

Parameters
prms[IN] Pointer to SDE parameters