TI DMPAC SDE (Stereo Disparity Engine) Kernel APIs

Detailed Description

DMPAC Stereo Disparity Engine Kernels.

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...

Defines
#define	TIVX_KERNEL_DMPAC_SDE_NAME   "com.ti.hwa.dmpac_sde"
	dmpac_sde kernel name
#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.

Functions
void	tivxRegisterHwaTargetDmpacSdeKernels (void)
	Function to register HWA Kernels on the dmpac_sde Target.
void	tivxUnRegisterHwaTargetDmpacSdeKernels (void)
	Function to un-register HWA Kernels on the dmpac_sde Target.
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...

Macro Definition Documentation

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.

Definition at line 110 of file hwa_dmpac_sde.h.

Function Documentation

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]	graph	The reference to the graph.
[in]	configuration	The input object of a single params structure of type tivx_dmpac_sde_params_t.
[in]	left	The 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]	right	The 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]	output	The 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_node

A 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