siq_cache.c File Reference

Service Information Query: cache functionality. More...

#include <string.h>
#include "siq_debug.h"
#include "siq_cache.h"
#include "siq_main.h"
#include "cldsmcc.h"

Data Structures
struct	s_SiqCachePat
struct	s_SiqCachePmt

Macros
#define	SIQ_DEFAULT_PMT_TOTAL   64
#define	VERSION_CHANGED   0xff

Typedefs
typedef struct s_SiqCachePat	S_SiqCachePat
typedef struct s_SiqCachePmt	S_SiqCachePmt

Functions
S_SiqCachePmt *	GetCachePmt (S_SiqInstance *siq, U16BIT serviceId)
BOOLEAN	SIQ_CacheInit (S_SiqInstance *siq)
void	SIQ_CacheExit (S_SiqInstance *siq)
void	SIQ_UpdatePatInfo (H_SiqInstance siq, S_SiqPatTable *pat)
	Tell SIQ of latest PAT for current transport stream. Calling this function is optional. However, if not used, then the platform must use SIQ_ServiceRemoved and SIQ_TransportChanged. More...
void	SIQ_TransportChanged (H_SiqInstance siq, U16BIT origNetworkId, U16BIT transportId)
	Inform SIQ when a demux is tuning to another transport stream. Not required if PAT is supplied to SIQ. More...
void	SIQ_ServiceRemoved (H_SiqInstance siq, U16BIT serviceId)
	Inform SIQ when a service has been removed from PAT. Not required if PAT is supplied to SIQ. More...
E_SIQ_STATUS	SIQ_RequirePmt (H_SiqInstance siq, U8BIT *pmt, U16BIT *pSid, U8BIT *pVer)
	Ask SIQ whether PMT section data is required. It assumes CRC has been checked and is passing valid PMT sections So the first byte of data must be PMT table id (i.e. 0x02). If SIQ does not receive PAT then this function adds SIQ knowledge of the service. More...
H_SiqPmtTable	SIQ_ParsePmt (H_SiqInstance siq, U8BIT *pmt)
	Provide PMT section data to SIQ. It assumes CRC has been checked and is passing valid PMT sections So the first byte of data must be PMT table id (i.e. 0x02). If SIQ does not receive PAT then this function adds SIQ knowledge of the service. More...
void	SIQ_ProcessPmt (H_SiqInstance siq, H_SiqPmtTable hNewTable, U16BIT serviceId, U8BIT version)
	Provide PMT section data to SIQ. It assumes CRC has been checked and is passing valid PMT sections So the first byte of data must be PMT table id (i.e. 0x02). If SIQ does not receive PAT then this function adds SIQ knowledge of the service. More...
H_SiqPmtTable	SIQ_CacheRetrievePmt (S_SiqInstance *siq, U16BIT serviceId, int *gettingPmt)
void	SIQ_CacheClearPmt (H_SiqInstance siq, U16BIT serviceId)
	Clear cached PMT information. More...
void	SIQ_CacheClear (S_SiqInstance *siq)
clDsmErr_t	SIQ_ServiceInfoChangeSubscribe (S_SiqInstance *siq, U16BIT serviceId)
	Subscribe a component to receive notification of any changes or alterations to the service information of a specified service. More...
void	SIQ_ServiceInfoChangeUnsubscribe (S_SiqInstance *siq, U16BIT serviceId)
	Unsubscribe component to previously subscribed service change or alteration updates. More...

Detailed Description

Service Information Query: cache functionality.

Date

29-09-2013

Author

Adam Sturtridge

Function Documentation

void SIQ_CacheClearPmt	(	H_SiqInstance	siq,
		U16BIT	serviceId
	)

Clear cached PMT information.

Parameters

H_SiqInstance	siq SIQ instance handle.
U16BIT	serviceId Service whose PMT needs to be cleared

Returns

void

H_SiqPmtTable SIQ_ParsePmt	(	H_SiqInstance	siq,
		U8BIT *	pmt
	)

Provide PMT section data to SIQ. It assumes CRC has been checked and is passing valid PMT sections So the first byte of data must be PMT table id (i.e. 0x02). If SIQ does not receive PAT then this function adds SIQ knowledge of the service.

Parameters

H_SiqInstance	siqInstance SIQ instance handle.
U8BIT*	pmt raw PMT section data

Returns

void

void SIQ_ProcessPmt	(	H_SiqInstance	siq,
		H_SiqPmtTable	hNewTable,
		U16BIT	serviceId,
		U8BIT	version
	)

Provide PMT section data to SIQ. It assumes CRC has been checked and is passing valid PMT sections So the first byte of data must be PMT table id (i.e. 0x02). If SIQ does not receive PAT then this function adds SIQ knowledge of the service.

Provide PMT section data to SIQ. It assumes CRC has been checked and is passing valid PMT sections So the first byte of data must be PMT table id (i.e. 0x02). If SIQ does not receive PAT then this function adds SIQ knowledge of the service. This may initiate calls to F_ParseDataBcastId(), and may be followed by DSM-CC callback functions for Load Carousel or Load Object, where states can be any (including 'aborted').

Parameters

H_SiqInstance	siqInstance SIQ instance handle.
U8BIT*	pmt raw PMT section data

Returns

void

E_SIQ_STATUS SIQ_RequirePmt	(	H_SiqInstance	siq,
		U8BIT *	pmt,
		U16BIT *	pSid,
		U8BIT *	pVer
	)

Ask SIQ whether PMT section data is required. It assumes CRC has been checked and is passing valid PMT sections So the first byte of data must be PMT table id (i.e. 0x02). If SIQ does not receive PAT then this function adds SIQ knowledge of the service.

Parameters

H_SiqInstance	siq SIQ instance handle.
U8BIT*	pmt raw PMT section data header

Returns

E_SIQ_STATUS

clDsmErr_t SIQ_ServiceInfoChangeSubscribe	(	S_SiqInstance *	siq,
		U16BIT	serviceId
	)

Subscribe a component to receive notification of any changes or alterations to the service information of a specified service.

Parameters

clDsmInstHandle_t	instance DMSM-CC instance handle.
U16BIT	service_id Service to monitor.

Returns

clDsmErr_t

void SIQ_ServiceInfoChangeUnsubscribe	(	S_SiqInstance *	siq,
		U16BIT	serviceId
	)

Unsubscribe component to previously subscribed service change or alteration updates.

Parameters

clDsmInstHandle_t	instance DMSM-CC instance handle.
U16BIT	service_id Service to monitor.

Returns

n/a

void SIQ_ServiceRemoved	(	H_SiqInstance	siq,
		U16BIT	serviceId
	)

Inform SIQ when a service has been removed from PAT. Not required if PAT is supplied to SIQ.

Inform SIQ when a service has been removed from PAT. Not required if PAT is supplied to SIQ. This may initiate calls to DSM-CC callback functions for Load Carousel or Load Object, where states are 'aborted'.

Parameters

H_SiqInstance	siqInstance SIQ instance handle.
U16BIT	serviceId Service Id of removed service

Returns

void

void SIQ_TransportChanged	(	H_SiqInstance	siq,
		U16BIT	origNetworkId,
		U16BIT	transportId
	)

Inform SIQ when a demux is tuning to another transport stream. Not required if PAT is supplied to SIQ.

Inform SIQ when tuning to another transport stream. Not required if PAT is supplied to SIQ.

Parameters

H_SiqInstance	siqInstance SIQ instance handle.
U16BIT	transportId Id of new transport stream

Returns

void

void SIQ_UpdatePatInfo	(	H_SiqInstance	siq,
		S_SiqPatTable *	pat
	)

Tell SIQ of latest PAT for current transport stream. Calling this function is optional. However, if not used, then the platform must use SIQ_ServiceRemoved and SIQ_TransportChanged.

Parameters

H_SiqInstance	siqInstance SIQ instance handle.
S_SiqPatTable*	pat structure with PAT information

Returns

none.