dsm_control.c File Reference

Voyager glue support for DSM-CC Section Filter Manager. More...

#include <string.h>
#include "stb_os.h"
#include "stb_filter.h"
#include "cldsmcc.h"
#include "cldsmdbg.h"
#include "dsfm.h"
#include "dsiq.h"
#include "sbm.h"
#include "stbsipmt.h"
#include "dsm_debug.h"
#include "dsm_control.h"
#include "dsm_main.h"

Data Structures
struct	s_PmtInfo
struct	s_DsmMessage
struct	s_timer
struct	s_msgqueue
struct	s_DsmControl

Macros
#define	MAIN_STACK_SIZE   0x2000
#define	TIMER_RESOLUTION   100
#define	BOOT_TIMEOUT   0xFFFFFF
#define	RESTART_TIME   200
#define	START_MAGIC   0xDEED
#define	CLDSM_MAGIC   0xBADE
#define	ERA_BITS   4
#define	ERA_SHIFT   (32-ERA_BITS)
#define	ERA_LAST   ((1<<ERA_BITS)-1)
#define	ERA_FIRST   0x00
#define	DM_DEBUG_STATE   (DM_CONTROL|DM_CLIENT)

Typedefs
typedef struct s_PmtInfo	S_PmtInfo
typedef struct s_DsmMessage	S_Message
typedef struct s_timer	S_Timer
typedef struct s_msgqueue	S_MsgQueue
typedef struct s_DsmControl	S_DsmControl

Enumerations
enum	E_Q_PRIORITY { QP_TOP, QP_HIGH, QP_LOW, QP_TOTAL }
enum	E_DsmMsgType {   DSM_MSG_PMT_DATA, DSM_MSG_NEW_SECTION, DSM_MSG_CACHE_SECTION, DSM_MSG_UPDATE_FILTER,   DSM_MSG_PMT_REMOVED, DSM_MSG_CLOSE_DOWN }

Functions
int	SiqRequestPmt (DMXREF dmxref, U16BIT serviceId)
	Request PMT data to be supplied to SIQ for this service. The PMT data should be supplied to SIQ_ProcessPMT(). It should always supply PMT soon after the call to this function, and then, whenever the PMT version changes. This state should continue until F_DvpCancelPmt is called. If this service has been removed from the PAT, and the platform does not give PAT data to SIQ, then it must call SIQ_ServiceRemoved(). More...
int	StubRequestPmt (DMXREF dmxref, U16BIT serviceId)
H_DsmControl	DsmIndexToControl (U8BIT i)
U8BIT	DsmControlToIndex (H_DsmControl dsmctrl)
H_DsmControl	DSMCC_Open (S_DsmccConfig *config)
	Open DSM-CC and create controling instance. More...
void	DSMCC_Close (H_DsmControl dsmctrl)
	Close DSM-CC controling instance, and destroy all resources. More...
BOOLEAN	DSMCC_Start (H_DsmControl dsmctrl, S_DvbLocator *locator, U32BIT boot_carousel_id, DMXREF dmxref)
	Start DSM-CC controling instance. This will start search for boot carousel on service specified by locator. More...
void	DSMCC_Stop (H_DsmControl dsmctrl, E_DsmRstMode mode)
	Stop DSM-CC controling instance. Causes all carousels to unload. More...
void	DSMCC_Reboot (H_DsmControl dsmctrl)
	Reboot DSM-CC controling instance. Causes all carousels to unload and initiate search for boot carousel. More...
H_ObjCarousel	DSMCC_CurrentCarousel (H_DsmControl dsmctrl)
	Get currently loaded carousel handle. More...
U32BIT	DSMCC_CurrentCarouselId (H_DsmControl dsmctrl)
	Get currently loaded carousel ID. More...
BOOLEAN	DSMCC_SetCurrentCarousel (H_DsmControl dsmctrl, H_ObjCarousel hOC)
	Set current carousel. This does not unload any previously loaded carousels. More...
void	DSMCC_UnloadCarousel (H_DsmControl dsmctrl, H_ObjCarousel hOC, E_DsmRstMode mode)
	Unload specified Carousel. More...
void	DSMCC_SiqCacheClearPmt (H_DsmControl dsmctrl, U16BIT serviceId)
	Clear cached PMT for particular service. More...

Variables
unsigned int	gDebugState = DM_DEBUG_STATE
S_DsmControl *	instances [MAX_INSTANCES] = { NULL, NULL }

Detailed Description

Voyager glue support for DSM-CC Section Filter Manager.

Date

17 October 2014

Author

Adam Sturtridge

Function Documentation

void DSMCC_Close

(

H_DsmControl

dsmctrl

)

Close DSM-CC controling instance, and destroy all resources.

Parameters

H_DsmControl

dsmctrl DSM control instance handle

Returns

void

H_ObjCarousel DSMCC_CurrentCarousel

(

H_DsmControl

dsmctrl

)

Get currently loaded carousel handle.

Parameters

H_DsmControl

dsmctrl DSM control instance handle

Returns

H_ObjCarousel carousel handle - NULL if none loaded

U32BIT DSMCC_CurrentCarouselId

(

H_DsmControl

dsmctrl

)

Get currently loaded carousel ID.

Parameters

H_DsmControl

dsmctrl DSM control instance handle

Returns

U32BIT carousel id - INVALID_CAROUSEL_ID if none loaded

H_DsmControl DSMCC_Open

(

S_DsmccConfig *

config

)

Open DSM-CC and create controling instance.

Parameters

S_DsmccConfig

*config Configuration of control instance.

Returns

void

void DSMCC_Reboot

(

H_DsmControl

dsmctrl

)

Reboot DSM-CC controling instance. Causes all carousels to unload and initiate search for boot carousel.

Parameters

H_DsmControl

instance DSM control instance handle

Returns

void

BOOLEAN DSMCC_SetCurrentCarousel	(	H_DsmControl	dsmctrl,
		H_ObjCarousel	hOC
	)

Set current carousel. This does not unload any previously loaded carousels.

Parameters

H_DsmControl	dsmctrl DSM control instance handle
H_ObjCarousel	hOC Handle to carousel

Returns

BOOLEAN - TRUE if success (i.e. had valid carousel handle)

void DSMCC_SiqCacheClearPmt	(	H_DsmControl	dsmctrl,
		U16BIT	serviceId
	)

Clear cached PMT for particular service.

Parameters

H_DsmControl	dsmctrl DSM control instance handle.
U16BIT	serviceId Service whose PMT needs to be cleared

Returns

void

BOOLEAN DSMCC_Start	(	H_DsmControl	dsmctrl,
		S_DvbLocator *	locator,
		U32BIT	boot_carousel_id,
		DMXREF	dmxref
	)

Start DSM-CC controling instance. This will start search for boot carousel on service specified by locator.

Parameters

H_DsmControl	instance DSM control instance handle
S_DvbLocator	*locator DVB location of service.
U32BIT	boot_carousel_id carousel id. When set to invalid, DSM-CC will attempt to start on carousel specified by recognised data broadcast id descriptor.
DMXREF	dmxref demux reference to be used in section filter API

Returns

BOOLEAN - TRUE if success

void DSMCC_Stop	(	H_DsmControl	dsmctrl,
		E_DsmRstMode	mode
	)

Stop DSM-CC controling instance. Causes all carousels to unload.

Parameters

H_DsmControl	dsmctrl DSM control instance handle
E_DsmRstMode	mode Mode of operation when unloading

Returns

void

void DSMCC_UnloadCarousel	(	H_DsmControl	dsmctrl,
		H_ObjCarousel	hOC,
		E_DsmRstMode	mode
	)

Unload specified Carousel.

Parameters

H_DsmControl	dsmctrl DSM control instance handle
H_ObjCarousel	hOC Handle to carousel
E_DsmRstMode	mode Mode of operation when unloading

Returns

void

int SiqRequestPmt	(	DMXREF	dmxref,
		U16BIT	serviceId
	)

Request PMT data to be supplied to SIQ for this service. The PMT data should be supplied to SIQ_ProcessPMT(). It should always supply PMT soon after the call to this function, and then, whenever the PMT version changes. This state should continue until F_DvpCancelPmt is called. If this service has been removed from the PAT, and the platform does not give PAT data to SIQ, then it must call SIQ_ServiceRemoved().

Parameters

DMXREF	dmxref Demux handle used by DVB stack
U16BIT	serviceId Service that SIQ requires PMT updates.

Returns

zero is failure, non-zero is success