/**
	@file
		DHL_PSI_Priv.h

	@brief
		DHL PSI 모듈 Private header

	Copyright 2006~2010 Digital STREAM Technology, Inc.
	All Rights Reserved
*/


#ifndef __DHL_PSI_PRIV_H__
#define __DHL_PSI_PRIV_H__


#include "DHL_Types.h"
#include "DHL_PSI.h"


#ifdef __cplusplus
extern "C" {
#endif



#if COMMENT
____Overview____(){}
#endif

/**
	@file DHL_PSI_Priv.h
	
	이곳에 이 모듈에 대해 설명이 필요한 각종 내용 기술..
	
	module overview
		- 
		-

	APIs
	
	implementations
	
	dependencies		
	
	nv parameters
		
	

*/


#if COMMENT
____Config____(){}
#endif


// section 수신시 crc를 다시 한번 검사하게 한다.
#define DST_CRC_RECHECK 0	//BKTODO: 1->0

// section 수신시 filtering이 제대로 됐는지 sw 방식으로 확인하게 한다.
#define DST_SW_FILTERING 1


#if COMMENT
____Types____(){}
#endif


typedef struct
{
	tDHL_PSI_Mode psiMode;
	tDHL_PSI_Update updateMode;
	UINT16 maxData;
	UINT16 maxSections;
	tDHL_PSI_EventProc eventProc;
	UINT32 userParam;

} tDHL_PSI_StartParam;

typedef struct
{
	int index;	// 필터컨트롤 array(g_fc in DHL_PSI_Rx.c)의 index, 초기화 할때 값이 정해진다.
	void*	Filter_ID;	// 드라이버에서 사용하는 필터의 ID, event 발생한 filter를 찾을 때 사용. (pointer to smessage_stream_t)
	tDHL_PSI_ControlHandle handle;	// psi 필터 컨트롤 핸들, 사용자는 오직 이 핸들을 통해서 필터 컨트롤에 접근 할 수 있음.
	BOOL active;
	BOOL isPaused;

	UINT16 pid;
	
	tDHL_PSI_Filter *pFltData;

	tDHL_PSI_StartParam param;

	// operation parameters
	INT32			curSection;					/* The last section received */

	// crc parameters
	UINT32			lastCRC;					/* Used for psiCRCChange */
	UINT32			runningCRC;					/* Used to combine all CRC's for sections in table */
	BOOLEAN			lastCRCValid;				/* TRUE if lastCRC has valid data */
	
	// version parameters
	INT32			curVersion; 				/* Version number of previous completed section/table */
	INT32			nextVersion;					/* Version number for table being gathered. no meaning for section */

	tDHL_PSI_DataArray	*curDataArray;		/* A complete descriptor waiting to be taken */
		// section 모드에서는 항상 마지막으로 수신된 data array를 가지고 있다.
		// 빨리 가져가지 않으면 새 data로 overwrite 되어 버린다.

	tDHL_PSI_DataArray	*nextDataArray; 	/* An incomplete descriptor for data still being gathered */
		// section mode에서는 nextDataArray는 사용하지 않는다.

	// debugging
	UINT32			receiveCount;				/* Accumulated reception count of this section */
	UINT32			goodCount;
	UINT8*			pRawBuff;
} tDHL_PSI_FiltCtl;




#if COMMENT
____Defines____(){}
#endif

/*
	defines for flags of dhl_psi_alloc_memory..
*/
#define DHL_PSI_MEMORY_SM_POOL  0x1 // alloc from SM POOL
#define DHL_PSI_MEMORY_CLEAR    0x2

/* for dhl_psi_set_filter_value */
typedef enum {
	eFILTERATTR_TID=0x1,
	eFILTERATTR_CURNEXTINDICATOR=0x2,
	eFILTERATTR_TIDEXTENSION=0x4,
	eFILTERATTR_TOPFIELD=0x20, // MSB only of TID extension
	eFILTERATTR_BOTTOMFIELD=0x40, // LSB only of TID extension
	eFILTERATTR_ETMID=0x80,
	eFILTERATTR_FIRSTPAYLOAD=0x100,
	eFILTERATTR_VERSION=0x200, // do not receive specific version
} tDHL_FilterAttr;


#if COMMENT
____Functions____(){}
#endif

void dhl_psi_set_filter_value(tDHL_PSI_Filter *pFilter, tDHL_FilterAttr attrType, UINT32 value);

void *dhl_psi_alloc_memory(UINT32 size, UINT32 flags);

void dhl_psi_free_memory(void *block);

void dhl_psi_free_data_array(tDHL_PSI_DataArray *psi);

void dhl_psi_set_filter_value(tDHL_PSI_Filter *pFilter, tDHL_FilterAttr attrType, UINT32 value);

/**	@brief 
		입력으로 들어온 psi 데이터로 필터 컨트롤 내부에 data array를 만든다.
		섹션에 포함된 길이 정보만큼만 처리하며 처리된 데이터 크기를 리턴한다.
		
	@param pFltCtl[out] 필터 컨트롤. 
		pFltCtl->curDataArray에 섹션or테이블 데이터를 할당.
	@param pdata[in] 수신된 psi 데이터의 시작주소.
	@param len[in] 수신된 psi 데이터의 총 길이. 
		여러개의 섹션이 포함될 수 있으므로 섹션내 길이 값보다 더 클 수 있음.
	@param procLen[out] 수신된 psi 데이터의 총 길이. 
		여러개의 섹션이 포함될 수 있으므로 섹션내 길이 값보다 더 클 수 있음.

	@return 
		처리된 데이터의 길이. 
*/
tDHL_PSI_Event dhl_psi_post_data_received(
			tDHL_PSI_FiltCtl *pFltCtl, UINT8 *pdata, 
			int len, int *procLen);

void update_psi_filter(tDHL_PSI_FiltCtl *pFltCtl);

// oneshot 용도
void pause_psi_filter(tDHL_PSI_FiltCtl* pFltCtl);
void resume_psi_filter(tDHL_PSI_FiltCtl* pFltCtl);


DHL_RESULT dhl_psi_start(tDHL_TSD tsd, UINT16 pid, 
		tDHL_PSI_Filter *pref,
		tDHL_PSI_StartParam *param,
		tDHL_PSI_ControlHandle *pHandle);

void dhl_psi_stop(tDHL_PSI_ControlHandle handle);

DHL_RESULT dhl_psi_read_data(tDHL_PSI_ControlHandle handle, 
		tDHL_PSI_DataArray **ppData);


void dhl_psi_init(void);

void dhl_psi_uninit(void);

void dhl_psi_show(void);

#ifdef __cplusplus
} /* extern "C" */
#endif



#endif	/* __DHL_PSI_PRIV_H__ */