/** @file DHL_PSI.h @brief MPEG section filter API for SI/PSI/PSIP reception Copyright 2006~2010 Digital STREAM Technology, Inc. All Rights Reserved */ #ifndef __DHL_PSI_H__ #define __DHL_PSI_H__ #include "DHL_Demux.h" #ifdef __cplusplus extern "C" { #endif #if COMMENT ____Overview____(){} #endif #if COMMENT ____Config____(){} #endif #define FILTER_MAX_BYTE 16 /* section filter에서 설정할 수 있는 최대 바이트 수 */ // etm id 까지만 포함하면 되니까 13 byte 면 된다. --> BK: 13-> FILTER_SIZE(=16)@bsettop_smessage_rave.c #if COMMENT ____Types____(){} #endif /** @brief PSI 수신 및 callback이 불리는 단위. DHL_PSI_StartMonitor() API의 인자로 사용된다. 여러 섹션이 하나의 테이블을 이루는 경우 (PAT, VCT 등) 색션 단위의 수신을 할지, 테이블 단위의 수신을 할지 지정한다. 하나의 섹션으로만 구성된 테이블의 경우 (PMT, STT, ETT 등) ePSIMODE_TABLE 은 의미가 없다. */ typedef enum { ePSIMODE_SECTION, ///< section 단위 수신 및 callback. ePSIMODE_TABLE, ///< table 단위의 수신 및 callback. } tDHL_PSI_Mode; /** @brief 동일한 섹션이 수신되는 경우의 동작 지정. DHL_PSI_StartMonitor() API의 인자로 사용된다. */ typedef enum { ePSIUPDATE_ONESHOT=1, ///< 1회만 callback 하고 중단. ePSIUPDATE_VERCHANGE, ///< 버전이 변경될 때 마다 callback. ePSIUPDATE_CRCCHANGE, ///< CRC가 변경되면 (내용이 바뀌면) callback. ePSIUPDATE_CONTINEOUS, ///< 수신되는 모든 섹션(테이블) 마다 callback. } tDHL_PSI_Update; /** @brief 섹션 필터 마스크 패턴 DHL_PSI_StartMonitor() API의 인자로 사용된다. SoC 하드웨어에 따라 두번째 및 세번째 바이트 필터링은 지원하지 않을 수도 있다. 가능하면 이 부분의 필터는 사용하지 않도록 한다. DHL에서 요구하는 필터 패턴의 최대 길이는 FILTER_MAX_BYTE 이다. (2,3번째 바이트 포함) STT 수신하는 경우의 예: - data = { cd, 00, 00, 00, 00, 00, ..} - mask = { ff, 00, 00, 00, 00, 00, ..} - mode = { ff, 00, 00, 00, 00, 00, ..} PMT program number 1 수신 예: - data = { 02, 00, 00, 00, 01, 00, ..} - mask = { ff, 00, 00, ff, ff, 00, ..} - mode = { ff, 00, 00, ff, ff, 00, ..} PAT version 3을 제외한 다른 버전 수신하는 경우의 예: - data = { 00, 00, 00, 00, 00, 06, ..} - mask = { ff, 00, 00, 00, 00, 3e, ..} - mode = { ff, 00, 00, 00, 00, 00, ..} */ typedef struct { #if 1//BRCM UINT8 mask[FILTER_MAX_BYTE]; // compare if mask bit is 0. if same, it is matched. UINT8 coef[FILTER_MAX_BYTE]; UINT8 excl[FILTER_MAX_BYTE]; // compare #else UINT8 data[FILTER_MAX_BYTE]; ///< 비교s bit data UINT8 mask[FILTER_MAX_BYTE]; ///< mask bit이 1이면 비교를 수행, 0이면 무시(mode bit값 무시) UINT8 mode[FILTER_MAX_BYTE]; #endif /**< mode bit이 1인 곳은 비교된 bits가 하나라도 다르면 무시, 한 바이트 내에서 mode bit이 0이 곳은 비교된 bits가 모두 같으면 무시. @todo not equal filter가 바이트 단위를 넘어서는 경우 (예: 16bits 엔트리가 있는데 16bits 전체에 not equal filter를 걸고 싶은 경우)는 현재 지원하지 않고, 사용되는 곳도 없음. 향 후 필요하게 되면 별도의 대응이 필요함. */ } tDHL_PSI_Filter; /** @brief 콜백 이벤트 타입 tDHL_PSI_EventProc 콜백과 함께 전달되는 이벤트 종류. */ typedef enum { ePSIEVENT_NOEVENT=0, ePSIEVENT_DATARECEIVED, ///< 데이터가 수신되었음. ePSIEVENT_DUP3PACKET=0x10, ePSIEVENT_LOSTPACKET, ePSIEVENT_DISCONTINUITY, ePSIEVENT_SPLICINGPOINT, ePSIEVENT_SYNCERR, ePSIEVENT_SCRAMBLEDERROR, ePSIEVENT_MEMORYERROR, ePSIEVENT_SECTIONTOOBIG, ePSIEVENT_CRCERROR, ePSIEVENT_VERSIONCHANGED, ePSIEVENT_CRCUNCHANGED, ePSIEVENT_MAXSECTIONOVERFLOW, ePSIEVENT_LASTSECTIONOVERFLOW, ePSIEVENT_FIFOFULLEVENT, ePSIEVENT_KILLUSRTASK, } tDHL_PSI_Event; /** @brief 사용자에게 반환되는 PSI 필터 핸들. DHL_PSI_StartMonitor() API에서 만들어지고, DHL_PSI_StopMonitor() API에서 free 된다. */ typedef UINT32 tDHL_PSI_ControlHandle; /** @brief 각종 이벤트(데이터 수신 또는 에러) 가 발생될 때 호출되는 콜백 함수 프로토타입. DHL_PSI_StartMonitor() API 호출시에 caller가 지정한다. */ typedef void (*tDHL_PSI_EventProc)(tDHL_PSI_Event event, tDHL_PSI_ControlHandle handle, UINT32 userParam); /** tDHL_PSI_DataArray 안의 섹션 포인터 배열의 크기. 규격 상 section은 최대 256개 까지 구성될 수 있으나, 보통은 수 개 내외이므로 이 정도만 잡으면 된다. 주의: DHL 내부에서는 tDHL_PSI_DataArray array 크기를 필요한 만큼 동적으로 알맞게 할당할 필요가 있음. */ #define DYNARRAY_SECTPTR 10 /* Debugger thinks there is this many anreies */ /** @brief 수신된 섹션 데이터를 사용자에게 전달하기 위한 데이터 배열 구조. 섹션 모드로 수신한 경우라면 하나의 섹션만 전달되지만, 테이블 모드로 수신한 경우라면 섹션들의 집합이 array 형태로 전달된다. */ typedef struct { tDHL_PSI_ControlHandle handle; /* request ID */ UINT16 pid; /* pid which this section came from */ INT32 numSections; /* number of section */ INT32 maxSections; /* max number of sections structure can hold */ UINT8 *sectPtr[DYNARRAY_SECTPTR]; /* dynamic array of 1 or more section pointers */ } tDHL_PSI_DataArray; #if COMMENT ____Defines____(){} #endif #if COMMENT ____API____(){} #endif /** @brief 수신된 psi 데이터를 가져온다. */ DHL_RESULT DHL_PSI_ReadPSIData(tDHL_PSI_ControlHandle handle, tDHL_PSI_DataArray **ppData); /** @brief 처리 (사용)이 끝난 psi data array를 메모리에서 해제한다. */ void DHL_PSI_FreePSIData(tDHL_PSI_DataArray *pData); /** @name 필터 마스크 패턴 생성 utility 함수들. @{ */ /** @brief 섹션 수신에 사용될 필터 패턴 데이터를 준비한다. 필터 데이터는 Heap에 동적으로 할당한다. 필터 초기값은 all pass filter 상태로 만들어진다. 하지만 디톨트 상태로 수정없이 사용하는 경우는 없을 것임. @param[out] ppFilter 만들어진 필터 데이터 포인터의 포인터. */ DHL_RESULT DHL_PSI_AllocGenericFilter(tDHL_PSI_Filter **ppFilter); /** @brief table id로 필터 마스크 패턴을 구성한다. */ DHL_RESULT DHL_PSI_AllocFilterWithTid(tDHL_PSI_Filter **ppFilter, UINT8 tid, BOOL curnext_indicator); /** @brief table id와 tid extension으로 필터 마스크 패턴을 구성한다. */ DHL_RESULT DHL_PSI_AllocFilterWithTidEx(tDHL_PSI_Filter **ppFilter, UINT8 tid, UINT16 tidExtension, BOOL curnext_indicator); /** @brief 필터 패턴 데이터를 free한다. Alloc 하였으나 더 이상 사용하지 않게 된 필터 데이터를 메모리에서 해제한다. 주의 1) DHL_PSI_StartMonitor 가 성공적으로 호출되어 tDHL_PSI_ControlHandle 에 등록된 filter는 DHL_PSI_StopMonitor 이 불리면서 같이 해제 되므로, 별도로 DHL_PSI_FreeFilter 를 부르지 않아도 된다. 주의 2) DHL_OS_Free 처럼 포인터의 포인터를 pass 하는게 아니라, 포인터를 pass 한다. 사용에 주의할 것! @param[in] pFilter 해제할 필터 데이터 포인터. */ void DHL_PSI_FreeFilter(tDHL_PSI_Filter *pFilter); /*@}*/ /** @brief PSI 수신을 시작한다. 데이터가 수신되고, callback이 호출될 조건이 되면 eventProc이 호출된다. caller는 retPSIControl을 기억해 두어야 한다. 나중에 stop 할 때 필요함. @param[in] tsd TS 입력 포트 식별자 @param[in] pid 섹션/테이블이 포함된 pid @param[in] psiMode 섹션/테이블 데이터 수신 단위 @param[in] updateMode 동일한 데이터 수신에 대한 동작 모드 @param[in] prefList 필터 마스크 패턴 @param[in] maxData @param[in] maxSections 섹션 최대 갯수 @param[in] eventProc 콜백 함수 @param[in] userParam 사용자 파라미터 @param[out] pHandle 새롭게 할당 된 psi 필터 핸들. */ DHL_RESULT DHL_PSI_StartMonitor(tDHL_TSD tsd, UINT16 pid, tDHL_PSI_Mode psiMode, tDHL_PSI_Update updateMode, tDHL_PSI_Filter *prefList, UINT16 maxData, UINT16 maxSections, tDHL_PSI_EventProc eventProc, UINT32 userParam, tDHL_PSI_ControlHandle *pHandle); /** @brief PSI 수신을 중단한다. 내부에 동작 중이던 모든 작업을 중단한다. 아직 마무리 되지 않은 섹션 메모리들은 모두 free 된다. 이 후에 더이상 psiCtl을 사용하면 안된다. @param[in] handle 정지/해제 할 psi 핸들. */ void DHL_PSI_StopMonitor(tDHL_PSI_ControlHandle handle); DHL_RESULT DHL_PSI_Init(void); DHL_RESULT DHL_PSI_Uninit(void); #ifdef __cplusplus } /* extern "C" */ #endif #endif /* __DHL_PSI_H__ */