AM62Px MCU+ SDK  09.02.01

Introduction

This is DSS documentation specific to AM62px SoC

Sub Modules

 Display Controller IOCTLs
 

Files

file  am62px/dss_soc.h
 DSS Driver AM62px SOC specific file.
 

Data Structures

struct  Dss_IrqParams
 Structure containing DSS interrupt information. Events should be enabled only for available Video Ports and Video Pipes. More...
 
struct  Dss_RmInfo
 Structure containing resources manager information. This enables display sharing between two different softwares. More...
 
struct  Dss_SocParams
 DSS SOC parameters. More...
 
struct  Dss_DctrlOldiParams
 Structure containing OLDI configuration. This structure is used as an argument to IOCTL_DSS_DCTRL_SET_OLDI_PARAMS. More...
 

Functions

static uint32_t Dss_dispIsVidInst (uint32_t instId)
 Check if the display driver instance is of type Video pipeline. More...
 
static uint32_t Dss_dispIsVidLInst (uint32_t instId)
 Check if the display driver instance is of type Video lite pipeline. More...
 
static void Dss_irqParamsInit (Dss_IrqParams *irqParams)
 Dss_IrqParams structure init function. More...
 
static void Dss_rmInfoInit (Dss_RmInfo *rmInfo)
 Dss_RmInfo structure init function. More...
 
static void Dss_socParamsInit (Dss_SocParams *socParams)
 Dss_SocParams structure init function. More...
 
static void Dss_dctrlOldiParamsInit (Dss_DctrlOldiParams *oldiParams)
 Dss_DctrlOldiParams structure init function. More...
 
void Dss_setDssSoftReset (void)
 Perform DSS Soft Reset. More...
 
void Dss_setOLDITxPowerDown (uint32_t oldiLinkMode, bool powerState)
 Set OLDI Power Domain Control to power on and off OLDI TX. More...
 

Macros

#define DSS_DCTRL_MAX_NODES   ((uint32_t) 9U)
 Defines maximum number of nodes for allocation including invalid node. More...
 
#define DSS_DCTRL_MAX_EDGES   ((uint32_t) 8U)
 Defines maximum number of edges for allocation. This is derived by looking at all possible DSS connections in the SoC. More...
 
#define DSS_FUNC_IRQ_DEFAULT_NUM   (CSLR_WKUP_R5FSS0_CORE0_INTR_DSS0_DISPC_INTR_REQ_0_0)
 

DSS DCTRL Instance IDs

#define DSS_DCTRL_INST_0   (0U)
 Display controller instance 0. More...
 
#define DSS_DCTRL_INST_MAX   (1U)
 Maximum number of display driver instances. More...
 

DSS Display Instance IDs

#define DSS_DISP_INST_VID1   (CSL_DSS_VID_PIPE_ID_VID1)
 Video 1 Pipeline display driver instance number. More...
 
#define DSS_DISP_INST_VIDL1   (CSL_DSS_VID_PIPE_ID_VIDL1)
 Video Lite 1 Pipeline display driver instance number. More...
 
#define DSS_DISP_INST_MAX   (CSL_DSS_VID_PIPE_ID_MAX)
 Maximum number of display driver instances. More...
 
#define DSS_DISP_INST_INVALIUD   (CSL_DSS_VID_PIPE_ID_INVALID)
 Maximum number of display driver instances. More...
 

DSS DCTRL Node type

Node types that are used by the set path to connect different modules and create a graph

#define DSS_DCTRL_NODE_TYPE_INVALID   ((uint32_t) 0x0U)
 
#define DSS_DCTRL_NODE_TYPE_PIPE   ((uint32_t) 0x1U)
 
#define DSS_DCTRL_NODE_TYPE_OVERLAY   ((uint32_t) 0x2U)
 
#define DSS_DCTRL_NODE_TYPE_VP   ((uint32_t) 0x3U)
 
#define DSS_DCTRL_NODE_TYPE_OUTPUT   ((uint32_t) 0x4U)
 

DSS DCTRL Node Id

Node ids that are used by the set path to connect different modules and create a graph

#define DSS_DCTRL_NODE_INVALID   ((uint32_t) 0x0U)
 
#define DSS_DCTRL_NODE_VID1   ((uint32_t) 0x1U)
 
#define DSS_DCTRL_NODE_VIDL1   ((uint32_t) 0x2U)
 
#define DSS_DCTRL_NODE_OVR1   ((uint32_t) 0x3U)
 
#define DSS_DCTRL_NODE_OVR2   ((uint32_t) 0x4U)
 
#define DSS_DCTRL_NODE_VP1   ((uint32_t) 0x5U)
 
#define DSS_DCTRL_NODE_VP2   ((uint32_t) 0x6U)
 
#define DSS_DCTRL_NODE_OLDI   ((uint32_t) 0x7U)
 
#define DSS_DCTRL_NODE_DPI1   ((uint32_t) 0x8U)
 

Instance Ids for DSS Event Manager.

#define DSS_EVT_MGR_INST_ID_FUNC   ((uint32_t) 0x00U)
 Instance Id for functional interrupts. More...
 
#define DSS_EVT_MGR_INST_ID_MAX   ((uint32_t) 0x01U)
 Invalid Instance Id. More...
 
#define DSS_EVT_MGR_INST_ID_INVALID   ((uint32_t) 0xFFU)
 

Macro Definition Documentation

◆ DSS_DCTRL_INST_0

#define DSS_DCTRL_INST_0   (0U)

Display controller instance 0.

◆ DSS_DCTRL_INST_MAX

#define DSS_DCTRL_INST_MAX   (1U)

Maximum number of display driver instances.

◆ DSS_DISP_INST_VID1

#define DSS_DISP_INST_VID1   (CSL_DSS_VID_PIPE_ID_VID1)

Video 1 Pipeline display driver instance number.

◆ DSS_DISP_INST_VIDL1

#define DSS_DISP_INST_VIDL1   (CSL_DSS_VID_PIPE_ID_VIDL1)

Video Lite 1 Pipeline display driver instance number.

◆ DSS_DISP_INST_MAX

#define DSS_DISP_INST_MAX   (CSL_DSS_VID_PIPE_ID_MAX)

Maximum number of display driver instances.

◆ DSS_DISP_INST_INVALIUD

#define DSS_DISP_INST_INVALIUD   (CSL_DSS_VID_PIPE_ID_INVALID)

Maximum number of display driver instances.

◆ DSS_DCTRL_NODE_TYPE_INVALID

#define DSS_DCTRL_NODE_TYPE_INVALID   ((uint32_t) 0x0U)

◆ DSS_DCTRL_NODE_TYPE_PIPE

#define DSS_DCTRL_NODE_TYPE_PIPE   ((uint32_t) 0x1U)

◆ DSS_DCTRL_NODE_TYPE_OVERLAY

#define DSS_DCTRL_NODE_TYPE_OVERLAY   ((uint32_t) 0x2U)

◆ DSS_DCTRL_NODE_TYPE_VP

#define DSS_DCTRL_NODE_TYPE_VP   ((uint32_t) 0x3U)

◆ DSS_DCTRL_NODE_TYPE_OUTPUT

#define DSS_DCTRL_NODE_TYPE_OUTPUT   ((uint32_t) 0x4U)

◆ DSS_DCTRL_NODE_INVALID

#define DSS_DCTRL_NODE_INVALID   ((uint32_t) 0x0U)

◆ DSS_DCTRL_NODE_VID1

#define DSS_DCTRL_NODE_VID1   ((uint32_t) 0x1U)

◆ DSS_DCTRL_NODE_VIDL1

#define DSS_DCTRL_NODE_VIDL1   ((uint32_t) 0x2U)

◆ DSS_DCTRL_NODE_OVR1

#define DSS_DCTRL_NODE_OVR1   ((uint32_t) 0x3U)

◆ DSS_DCTRL_NODE_OVR2

#define DSS_DCTRL_NODE_OVR2   ((uint32_t) 0x4U)

◆ DSS_DCTRL_NODE_VP1

#define DSS_DCTRL_NODE_VP1   ((uint32_t) 0x5U)

◆ DSS_DCTRL_NODE_VP2

#define DSS_DCTRL_NODE_VP2   ((uint32_t) 0x6U)

◆ DSS_DCTRL_NODE_OLDI

#define DSS_DCTRL_NODE_OLDI   ((uint32_t) 0x7U)

◆ DSS_DCTRL_NODE_DPI1

#define DSS_DCTRL_NODE_DPI1   ((uint32_t) 0x8U)

◆ DSS_DCTRL_MAX_NODES

#define DSS_DCTRL_MAX_NODES   ((uint32_t) 9U)

Defines maximum number of nodes for allocation including invalid node.

◆ DSS_DCTRL_MAX_EDGES

#define DSS_DCTRL_MAX_EDGES   ((uint32_t) 8U)

Defines maximum number of edges for allocation. This is derived by looking at all possible DSS connections in the SoC.

DSS Functional Interrupt Number for R5

◆ DSS_FUNC_IRQ_DEFAULT_NUM

#define DSS_FUNC_IRQ_DEFAULT_NUM   (CSLR_WKUP_R5FSS0_CORE0_INTR_DSS0_DISPC_INTR_REQ_0_0)

◆ DSS_EVT_MGR_INST_ID_FUNC

#define DSS_EVT_MGR_INST_ID_FUNC   ((uint32_t) 0x00U)

Instance Id for functional interrupts.

<

Max Instance Id

◆ DSS_EVT_MGR_INST_ID_MAX

#define DSS_EVT_MGR_INST_ID_MAX   ((uint32_t) 0x01U)

Invalid Instance Id.

◆ DSS_EVT_MGR_INST_ID_INVALID

#define DSS_EVT_MGR_INST_ID_INVALID   ((uint32_t) 0xFFU)

Function Documentation

◆ Dss_dispIsVidInst()

static uint32_t Dss_dispIsVidInst ( uint32_t  instId)
inlinestatic

Check if the display driver instance is of type Video pipeline.

Parameters
instId[IN]Driver Instance Id.
Returns
TRUE if instance is Video pipeline else returns FALSE.

◆ Dss_dispIsVidLInst()

static uint32_t Dss_dispIsVidLInst ( uint32_t  instId)
inlinestatic

Check if the display driver instance is of type Video lite pipeline.

Parameters
instId[IN]Driver Instance Id.
Returns
TRUE if instance is Video lite pipeline else returns FALSE.

◆ Dss_irqParamsInit()

static void Dss_irqParamsInit ( Dss_IrqParams irqParams)
inlinestatic

Dss_IrqParams structure init function.

Parameters
irqParamsPointer to Dss_IrqParams structure.

◆ Dss_rmInfoInit()

static void Dss_rmInfoInit ( Dss_RmInfo rmInfo)
inlinestatic

Dss_RmInfo structure init function.

Parameters
rmInfoPointer to Dss_RmInfo structure.

◆ Dss_socParamsInit()

static void Dss_socParamsInit ( Dss_SocParams socParams)
inlinestatic

Dss_SocParams structure init function.

Parameters
socParamsPointer to Dss_SocParams structure.

◆ Dss_dctrlOldiParamsInit()

static void Dss_dctrlOldiParamsInit ( Dss_DctrlOldiParams oldiParams)
inlinestatic

Dss_DctrlOldiParams structure init function.

Parameters
oldiParams[IN]Pointer to Dss_DctrlOldiParams structure.

◆ Dss_setDssSoftReset()

void Dss_setDssSoftReset ( void  )

Perform DSS Soft Reset.

◆ Dss_setOLDITxPowerDown()

void Dss_setOLDITxPowerDown ( uint32_t  oldiLinkMode,
bool  powerState 
)

Set OLDI Power Domain Control to power on and off OLDI TX.

Parameters
oldiLinkModeOldi Map type. See CSL_DssVpOldiMapType for valid values
powerStateTrue to switch ON, false to switch OFF