AM62x MCU+ SDK  10.01.00
Dispay Hardware Include Layer

Introduction

The Display Subsystem (DSS) provides the logic to interface display peripherals.

Sub Modules

 DSS Common Hardware Layer
 
 DSS Overlay Hardware Layer
 
 DSS Video Pipe Hardware Layer
 
 DSS Video Port Hardware Layer
 

Files

file  csl_dssTop.h
 DSS top level hardware interface file. This can be used across sub components of DSS.
 

Data Structures

struct  CSL_DssCscCoeff
 Structure containing coefficients for Color Space Conversion. More...
 
struct  CSL_DssSafetyChkCfg
 Configuration for doing safety checks. More...
 

Functions

static void CSL_dssCscCoeffInit (CSL_DssCscCoeff *cscCoeff)
 CSL_DssCscCoeff structure init function. More...
 
static void CSL_dssSafetyChkCfgInit (CSL_DssSafetyChkCfg *safetyCfg)
 CSL_DssSafetyChkCfg structure init function. More...
 

Macros

#define CSL_DSS_NUM_LUT_ENTRIES   ((uint32_t) 256U)
 Number of entries for CLUT/Gamma Correction. More...
 
#define CSL_DSS_MODULE_INVALID   ((uint32_t) 0xFFU)
 Invalid Module Id for DSS modules. More...
 

DSS Video Pipeline Type

To distinguish between VID (with scaler) and VIDL (without scaler)

#define CSL_DSS_VID_PIPE_TYPE_VID   ((uint32_t) 0x0)
 Video Pipe is of type VID. More...
 
#define CSL_DSS_VID_PIPE_TYPE_VIDL   ((uint32_t) 0x1)
 Video Pipe is of type VIDL. More...
 

DSS Common Region Id

Id for different Common Regions

#define CSL_DSS_COMM_REG_ID_0   ((uint32_t) 0x0U)
 Common Region 0. More...
 
#define CSL_DSS_COMM_REG_ID_1   ((uint32_t) 0x1U)
 Common Region 1. More...
 
#define CSL_DSS_COMM_REG_ID_MAX   ((uint32_t) 0x2U)
 Common Region Max Id. More...
 

DSS Video Pipeline Id

Id for different Video Pipelines

#define CSL_DSS_VID_PIPE_ID_VID1   ((uint32_t) 0x0U)
 Video Pipeline 1. More...
 
#define CSL_DSS_VID_PIPE_ID_VIDL1   ((uint32_t) 0x1U)
 Video Lite Pipeline 1. More...
 
#define CSL_DSS_VID_PIPE_ID_MAX   ((uint32_t) 0x2U)
 Video Pipeline Max Id. More...
 
#define CSL_DSS_VID_PIPE_ID_INVALID   ((uint32_t) 0xFFU)
 Video Pipeline invalid. More...
 

DSS Overlay Id

Id for DSS Overlays

#define CSL_DSS_OVERLAY_ID_1   ((uint32_t) 0x0U)
 Overlay 1. More...
 
#define CSL_DSS_OVERLAY_ID_2   ((uint32_t) 0x1U)
 Overlay 2. More...
 
#define CSL_DSS_OVERLAY_ID_MAX   ((uint32_t) 0x2U)
 Overlay Max Id. More...
 

DSS Video Port Id

Id for DSS Video Ports

#define CSL_DSS_VP_ID_1   ((uint32_t) 0x0U)
 Video Port 1. More...
 
#define CSL_DSS_VP_ID_2   ((uint32_t) 0x1U)
 Video Port 2. More...
 
#define CSL_DSS_VP_ID_MAX   ((uint32_t) 0x2U)
 Video Port Max Id. More...
 

DSS Video Port Id Mask

Mask for DSS Video Ports

#define CSL_DSS_VP_ID_1_MASK   ((uint32_t) 0x1U)
 Video Port 1. More...
 
#define CSL_DSS_VP_ID_2_MASK   ((uint32_t) 0x2U)
 Video Port 2. More...
 

DSS CSC Range

DSS Color Space Conversion range setting

#define CSL_DSS_CSC_RANGE_LIMITED   ((uint32_t) 0x0U)
 Limited range selected. More...
 
#define CSL_DSS_CSC_RANGE_FULL   ((uint32_t) 0x1U)
 Full range selected. More...
 
#define CSL_DSS_CSC_RANGE_CUSTOM   ((uint32_t) 0x2U)
 Custom range selected. More...
 

DSS Safety Check Mode

Mode of operation of the safety check module

#define CSL_DSS_SAFETY_CHK_FRAME_FREEZE_DETECT    ((uint32_t) CSL_DSS_VID_SAFETY_ATTRIBUTES_CAPTUREMODE_VAL_FRAMEFREEZE)
 Frame freeze detect enabled. More...
 
#define CSL_DSS_SAFETY_CHK_DATA_INTEGRITY    ((uint32_t) CSL_DSS_VID_SAFETY_ATTRIBUTES_CAPTUREMODE_VAL_DATACHECK)
 Data correctness check enabled. More...
 

DSS Safety Check Frame Skip

Indicates which frames to be skipped while doing safety check

#define CSL_DSS_SAFETY_CHK_FRAME_SKIP_NO    ((uint32_t) CSL_DSS_VID_SAFETY_ATTRIBUTES_FRAMESKIP_VAL_DISABLE)
 No frames are skipped. More...
 
#define CSL_DSS_SAFETY_CHK_FRAME_SKIP_EVEN    ((uint32_t) CSL_DSS_VID_SAFETY_ATTRIBUTES_FRAMESKIP_VAL_EVEN)
 Even Frames are skipped starting from second frame after enable. More...
 
#define CSL_DSS_SAFETY_CHK_FRAME_SKIP_ODD    ((uint32_t) CSL_DSS_VID_SAFETY_ATTRIBUTES_FRAMESKIP_VAL_ODD)
 Odd Frames are skipped starting from first frame after enable. More...
 

Macro Definition Documentation

◆ CSL_DSS_VID_PIPE_TYPE_VID

#define CSL_DSS_VID_PIPE_TYPE_VID   ((uint32_t) 0x0)

Video Pipe is of type VID.

◆ CSL_DSS_VID_PIPE_TYPE_VIDL

#define CSL_DSS_VID_PIPE_TYPE_VIDL   ((uint32_t) 0x1)

Video Pipe is of type VIDL.

◆ CSL_DSS_COMM_REG_ID_0

#define CSL_DSS_COMM_REG_ID_0   ((uint32_t) 0x0U)

Common Region 0.

◆ CSL_DSS_COMM_REG_ID_1

#define CSL_DSS_COMM_REG_ID_1   ((uint32_t) 0x1U)

Common Region 1.

◆ CSL_DSS_COMM_REG_ID_MAX

#define CSL_DSS_COMM_REG_ID_MAX   ((uint32_t) 0x2U)

Common Region Max Id.

◆ CSL_DSS_VID_PIPE_ID_VID1

#define CSL_DSS_VID_PIPE_ID_VID1   ((uint32_t) 0x0U)

Video Pipeline 1.

◆ CSL_DSS_VID_PIPE_ID_VIDL1

#define CSL_DSS_VID_PIPE_ID_VIDL1   ((uint32_t) 0x1U)

Video Lite Pipeline 1.

◆ CSL_DSS_VID_PIPE_ID_MAX

#define CSL_DSS_VID_PIPE_ID_MAX   ((uint32_t) 0x2U)

Video Pipeline Max Id.

◆ CSL_DSS_VID_PIPE_ID_INVALID

#define CSL_DSS_VID_PIPE_ID_INVALID   ((uint32_t) 0xFFU)

Video Pipeline invalid.

◆ CSL_DSS_OVERLAY_ID_1

#define CSL_DSS_OVERLAY_ID_1   ((uint32_t) 0x0U)

Overlay 1.

◆ CSL_DSS_OVERLAY_ID_2

#define CSL_DSS_OVERLAY_ID_2   ((uint32_t) 0x1U)

Overlay 2.

◆ CSL_DSS_OVERLAY_ID_MAX

#define CSL_DSS_OVERLAY_ID_MAX   ((uint32_t) 0x2U)

Overlay Max Id.

◆ CSL_DSS_VP_ID_1

#define CSL_DSS_VP_ID_1   ((uint32_t) 0x0U)

Video Port 1.

◆ CSL_DSS_VP_ID_2

#define CSL_DSS_VP_ID_2   ((uint32_t) 0x1U)

Video Port 2.

◆ CSL_DSS_VP_ID_MAX

#define CSL_DSS_VP_ID_MAX   ((uint32_t) 0x2U)

Video Port Max Id.

◆ CSL_DSS_VP_ID_1_MASK

#define CSL_DSS_VP_ID_1_MASK   ((uint32_t) 0x1U)

Video Port 1.

◆ CSL_DSS_VP_ID_2_MASK

#define CSL_DSS_VP_ID_2_MASK   ((uint32_t) 0x2U)

Video Port 2.

◆ CSL_DSS_CSC_RANGE_LIMITED

#define CSL_DSS_CSC_RANGE_LIMITED   ((uint32_t) 0x0U)

Limited range selected.

◆ CSL_DSS_CSC_RANGE_FULL

#define CSL_DSS_CSC_RANGE_FULL   ((uint32_t) 0x1U)

Full range selected.

◆ CSL_DSS_CSC_RANGE_CUSTOM

#define CSL_DSS_CSC_RANGE_CUSTOM   ((uint32_t) 0x2U)

Custom range selected.

◆ CSL_DSS_SAFETY_CHK_FRAME_FREEZE_DETECT

#define CSL_DSS_SAFETY_CHK_FRAME_FREEZE_DETECT    ((uint32_t) CSL_DSS_VID_SAFETY_ATTRIBUTES_CAPTUREMODE_VAL_FRAMEFREEZE)

Frame freeze detect enabled.

◆ CSL_DSS_SAFETY_CHK_DATA_INTEGRITY

#define CSL_DSS_SAFETY_CHK_DATA_INTEGRITY    ((uint32_t) CSL_DSS_VID_SAFETY_ATTRIBUTES_CAPTUREMODE_VAL_DATACHECK)

Data correctness check enabled.

◆ CSL_DSS_SAFETY_CHK_FRAME_SKIP_NO

#define CSL_DSS_SAFETY_CHK_FRAME_SKIP_NO    ((uint32_t) CSL_DSS_VID_SAFETY_ATTRIBUTES_FRAMESKIP_VAL_DISABLE)

No frames are skipped.

◆ CSL_DSS_SAFETY_CHK_FRAME_SKIP_EVEN

#define CSL_DSS_SAFETY_CHK_FRAME_SKIP_EVEN    ((uint32_t) CSL_DSS_VID_SAFETY_ATTRIBUTES_FRAMESKIP_VAL_EVEN)

Even Frames are skipped starting from second frame after enable.

◆ CSL_DSS_SAFETY_CHK_FRAME_SKIP_ODD

#define CSL_DSS_SAFETY_CHK_FRAME_SKIP_ODD    ((uint32_t) CSL_DSS_VID_SAFETY_ATTRIBUTES_FRAMESKIP_VAL_ODD)

Odd Frames are skipped starting from first frame after enable.

◆ CSL_DSS_NUM_LUT_ENTRIES

#define CSL_DSS_NUM_LUT_ENTRIES   ((uint32_t) 256U)

Number of entries for CLUT/Gamma Correction.

◆ CSL_DSS_MODULE_INVALID

#define CSL_DSS_MODULE_INVALID   ((uint32_t) 0xFFU)

Invalid Module Id for DSS modules.

Function Documentation

◆ CSL_dssCscCoeffInit()

static void CSL_dssCscCoeffInit ( CSL_DssCscCoeff cscCoeff)
inlinestatic

CSL_DssCscCoeff structure init function.

Parameters
cscCoeffPointer to CSL_DssCscCoeff structure

◆ CSL_dssSafetyChkCfgInit()

static void CSL_dssSafetyChkCfgInit ( CSL_DssSafetyChkCfg safetyCfg)
inlinestatic

CSL_DssSafetyChkCfg structure init function.

Parameters
safetyCfgPointer to CSL_DssSafetyChkCfg structure