/* DMW_EpgBase.h EPG Middleware baseline implementation Copyright 2004 Digital STREAM Technology, Inc. All Rights Reserved $Id: DMW_EpgBase.h v1.00 2004/07 cafrii Exp $ */ #ifndef __DMW_EPG_BASE_H__ #define __DMW_EPG_BASE_H__ #define DMW_EPG_SUPPORT_RRT 1 #define DMW_EPG_SUPPORT_ELAPSED_TIMER 1 /* cafrii 060814 add 1이면 각 채널/서브채널별로 scan에 소요된 counter를 가동하여 총 누적 검색 시간이 어느정도인지 통계를 낸다. */ #include "DMW_EpgBasePriv.h" /* EpgBase private header file.. these are not public function and structures.. do not use this.. */ /* UpdateStart reason value 어떤 이유로 epg udpate가 시작되었는지 알려줌 */ enum { EpgUpdateStartByUserCall = 1, EpgUpdateStartByMgtChange = 2, }; /* Callback 함수의 인자로 전달될 이벤트 타입과 동반되는 parameter 정의. cafrii 041102, 기존 Epg 1.0 과의 event id 값이 충돌나지 않도록 시작 값을 조정함 */ typedef enum { epgEventStarted = 101, /* param 1 : reason: EpgUpdateStartxxxx 값 중 하나 */ /* param 2 : none */ epgEventChannelStarted, /* cafrii 041123 add */ /* 해당 채널의 Epg 검색이 시작되었음을 알린다. param 1 : DmcEpgChannelCbParam * param 2 : none */ epgEventSubChannelStarted, /* cafrii 041123 add */ /* 해당 subchannel의 epg 검색이 시작되었음을 알린다. param 1 : DmcEpgSubChannelCbParam * param 2 : none */ epgEventEitReceived, /* param 1 : (DmcEpgStatus *) current Epg scan status of this channel param 2 : index of Eit table just received valid only when param is not (-1)UL */ epgEventEttReceived, /* param 1 : (DmcEpgStatus *) current Epg scan status of this channel param 2 : LSB[16]: index of Ett table MSB[16]: index of event in Eit 0x0000ffff means that this is channel-ETT. 0xffffffff means that table is not identified. */ epgEventEitComplete, /* param 1 : channel id param 2 : subchannel index */ epgEventSubchannelComplete, /* param 1 : channel id param 2 : subchannel index */ epgEventChannelComplete, /* param 1 : id param 2 : none */ epgEventCompleteInfo, /* cafrii 041123 add */ /* 좀 더 자세한 'complete' 정보를 전달한다. 위의 세가지 complete event 에 추가하여 호출된다. param 1 : epgEventEitComplete/SubchannelComplete/ChannelComplete 중 하나 param 2 : DmcEpgCompleteCbParam * */ /* epgEventCancelled, <-- 이런 event는 더이상 제공하지 않음.. */ /* param 1 : id param 2 */ epgEventUpdateChannelEtt, /* cafrii 050203 add */ /* 어떤 채널의 ett-v 가 수신되었음. epgEventEttReceived 와는 별도로 따로 불린다. 이미 수신된 ett-v 에 대해서도 또 다시 불릴 수도 있다. (중복 체크 안함) 따라서 application 에서 중복 체크를 해야 할 것이다. Application 에서는 채널 관련 정보를 UCM CSD에 update 할 수 있다. param 1 : DmcEpgChannelEttCbParam * param 2 : none */ epgEventChannelEttUpdated, /* cafrii 041129 add */ /* 어떤 채널의 ett-v 가 update 되었으며 이 정보가 UCM CSD에 update 되었음을 알린다. Application 에서는 필요하면 UCM을 NvRam 에 저장해야 한다. 이 event는 AutoCsdUpdate flag가 1인 상태로 compile 해야만 사용된다. param 1 : none param 2 : none */ epgEventError, /* EPG 검색 도중에 에러가 발생했을때 error description 을 전송 에러가 발생하더라도 치명적인 에러가 아닌 한 EPG scan 작업은 계속 시도된다. param 1 : (int) error value param 2 : (const char *) error description */ /*----------------------------------------------------*/ epgEventNotifyStt, /* 새로운 STT가 도착, 또는 STT 값의 Jump 등. param 1 : sttSection_t pointer, not just system_time param 2 : age of system_time recpetion (in seconds) */ epgEventNotifyProgramChange, /* 현재 Program Event가 변경되었음을 알림. param 1 : new event_id param 2 : eitEvent_t 정보를 포함하는 어떤 데이터.. */ epgEventRrtUpdated, /* param1 : rrt param2 : */ /*----------------------------------------------------*/ epgEventSddsFound, /* sdds 서비스 채널이 발견 되었음을 알림. param 1 : UINT32 num_list; number of sdds program info list (param 2) param 2 : DmcEpgSddsProgramInfo *list 'list' is array of struct sdds_program_info_t. 'num_list' is number of 'list' which is sdds service. this is usually 1, but A/97 allows multiple subchannel scenario. Note1 if list's pid value is zero, application should search matching PMT and should find out carousel PID. Spec mentions VCT also should have carousel PID in VCT's SLD, but Korean DTV SDDS test stream do not have PID info in VCT. Note2 'list' pointer points to temporary space. (stack) Please backup somewhere safe for use later after callback return. */ } DmcEpgEventType; #ifdef __DEFINE_EPG_EVENT_TYPE_STR__ char *DmcEpgEventTypeString(DmcEpgEventType t) { return ( (t) == epgEventStarted ? "EpgStarted" : (t) == epgEventChannelStarted ? "EpgChStart" : (t) == epgEventSubChannelStarted ? "EpgSubchStart" : (t) == epgEventEitReceived ? "EitReceived" : (t) == epgEventEttReceived ? "EttReceived" : (t) == epgEventEitComplete ? "EitComplete" : (t) == epgEventSubchannelComplete ? "SubchComplete" : (t) == epgEventChannelComplete ? "ChannelComplete" : (t) == epgEventCompleteInfo ? "CompleteInfo" : (t) == epgEventUpdateChannelEtt ? "UpdateEttV" : (t) == epgEventChannelEttUpdated ? "EttVUpdated" : (t) == epgEventNotifyStt ? "Stt" : (t) == epgEventNotifyProgramChange ? "ProgramChange" : (t) == epgEventRrtUpdated ? "RrtUpdated" : (t) == epgEventError ? "EpgError" : "??"); } #else char *DmcEpgEventTypeString(DmcEpgEventType t); #endif /* EpgScanFlag Epg Update를 시작할 때 특정 table을 우선해서 받거나 scan 동작을 제어할 때 사용된다. 현재 eit first flag만 구현이 되어 있음.. */ enum { epgScanFlag_PartialTable = 0x0080, epgScanFlag_PartialTblMask = 0x007F, /* table: 0 ~ 128 --> 7bit */ epgScanFlag_EitFirst = 0x0100, /* 먼저 모든 subchannel의 Eit만 우선해서 받는다. 즉 현재 PTC에 3개의 subchannel이 존재한다면, 모든 3개 sub channel의 Eit만 먼저 수신을 하고, Eit가 다 수신되면 계속해서 자동으로 Ett 수신에 들어간다. 만약에 특정 subchannel을 지정하였다면 그 채널의 Eit를 먼저 받고, 그 다음에 그 채널의 Ett를 다 받고, 그 다음에 다른 subchannel 수신.. */ epgScanFlag_SkipAnalog = 0x0200, /* cafrii 060320 add */ }; /* Epg Status Enum 현재 EpgDB의 scan 상태를 나타내는 값들.. Dmc_EpgCheckScanStatus 함수의 결과로 사용된다. */ typedef enum { EPG_STATUS_NOT_FOUND = 1, /* 지정한 sub 채널 정보가 없음.. */ EPG_STATUS_INCOMPLETE = 2, /* 현재 진행중임.. */ EPG_STATUS_EIT_COMPLETE = 3, /* Eit 만 완료되었음.. */ EPG_STATUS_SUBCH_COMPLETE = 4, /* subchannle이 다 완료되었음.. */ EPG_STATUS_CH_COMPLETE = 5, /* 지정한 sub 채널을 포함하는 PTC 채널이 모두 완료되었음.. */ /* EPG_STATUS_SUBCH_SKIPPED = 6, */ } EPG_STATUS; #define EpgStatusString(e) \ (e) == EPG_STATUS_NOT_FOUND ? "NotFound" : \ (e) == EPG_STATUS_INCOMPLETE ? "Incomplete" : \ (e) == EPG_STATUS_EIT_COMPLETE ? "EitOnlyComplete" : \ (e) == EPG_STATUS_SUBCH_COMPLETE ? "SubchannelComplete" : \ (e) == EPG_STATUS_CH_COMPLETE ? "ChannelComplete" : "??" /* DmcEpgStatus 일부 EpgEventProc에서 넘겨주는 EpgStatus 구조체 */ typedef struct DmcEpgStatus_t { int id; int source_id; EPG_STATUS cStatus; /* EPG_STATUS_XXX 값 중의 하나.. */ int nElapsedSec; /* 이 subchannel을 scan하는데 사용된 총 누적 검색 시간. compile option에 따라서 지원되지 않을 수도 있음. */ int nEitReceived; int nEitTotal; /* 받아야 할 전체 Eit table */ int nEttReceived; int nEttTotal; /* 받아야 할 전체 Ett table (현재까지 밝혀진 것까지만.. Eit를 받으면서 계속 늘어날것임) */ } DmcEpgStatus; /* cafrii 041123 add epgEventChannelStarted 이벤트의 파라미터 */ typedef struct DmcEpgChannelCbParam_t { int id; /* id of this PTC.. 보통 rf 번호를 사용한다. */ tDHL_TSD *tsd; /* stream source */ mgtSectionPtr_t mgt; tvctPtr_t tvct; cvctPtr_t cvct; /* 이 둘중에 하나는 반드시 non-NULL 이다. */ int n_subchannel; } DmcEpgChannelCbParam; /* cafrii 041123 add epgEventSubChannelStarted 이벤트의 파라미터 */ typedef struct DmcEpgSubChannelCbParam_t { int index; /* subchannel index.. 0 ~ n_subchannel-1 */ UINT16 source_id; struct { UINT16 short_name[7]; UINT16 major_channel_number; UINT16 minor_channel_number; UINT16 program_number; } vct_info; /* 반드시 subchannel info의 vct_info 와 동일해야 한다. */ } DmcEpgSubChannelCbParam; /* cafrii 041123 add epgEventCompleteInfo 이벤트의 parameter */ typedef struct DmcEpgCompleteCbParam_t { /* channel id */ int id; /* subchannel id */ int index; UINT16 source_id; } DmcEpgCompleteCbParam; /* cafrii 050203 add epgEventUpdateChannelEtt 이벤트의 parameter */ typedef struct DmcEpgChannelEttCbParam_t { /* channel id */ int id; /* subchannel id */ int index; UINT16 source_id; /* channel text */ UINT16 extended_text_message_length; UINT8 *extended_text_message; /* MSS format */ /* note! caller should not use this pointer and data after function returns. caller can use these data inside callback function only. */ } DmcEpgChannelEttCbParam; /* cafrii 050404 add epgEventNotifyProgramChange 의 파라미터 구조체 */ typedef struct DmcEpgProgramChangeCbParam_t { int channel_id; int source_id; int event_id; int eit_index; /* 이 event가 발견된 첫 Eit index.. probably 0.. */ UINT32 system_time; /* cafrii 050729 add */ /* 현재 STT GPS time */ UINT32 start_time; UINT32 length_in_seconds; int descriptor_length; UINT8* descriptors; /* 주의!! 이 unparsed descriptor는 Eit에 있는 descriptor를 그대로 pointing한다. 이 callback이 종료되면 언제 free 될지 모르므로 필요한 정보가 있다면 별도로 복사하여 저장을 해 둘 필요가 있다. */ } DmcEpgProgramChangeCbParam; /* cafrii 100727 add epgEventSddsFound 이벤트의 parameter */ typedef struct DmcEpgSddsProgramInfo_t { int id; /* 이 RF 채널을 식별하는 id 이다. 이 값의 정확한 사용은 app 마다 다르다. 보통은 rf 번호를 그대로 사용하지만, tuner가 여러개인 경우, pvr이 있는 경우 등은 좀 더 복잡한 체계를 사용한다. */ UINT16 program_number; UINT16 pid; /* if pid is zero, it means that VCT does not have valid pid info. user should search PMT to find out pid. */ } DmcEpgSddsProgramInfo; typedef void (*DmcEpgEventProc) (DmcEpgEventType evt, UINT32 param1, UINT32 param2); /* EpgUpdate 에서 사용되는 event proc 함수의 prototype. evt는 전달되는 이벤트 종류 param1/param2 는 이벤트 별로 정의된 파라미터 */ /* APIs.. */ STATUS Dmc_EpgInit(void); STATUS Dmc_EpgUpdateStart(int id, tDHL_TSD *tsd, DmcEpgEventProc eventproc, UINT32 source_id, UINT32 flag); /* cafrii 041019 add 'tsd' argument update를 시작.. */ STATUS Dmc_EpgUpdateCancel(void); /* 현재 진행중인 update를 cancel한다.. 채널 변경, autoscan 작업을 시작할 때 사용. */ STATUS Dmc_EpgDelete(int id); /* 해당 id의 EpgDB를 삭제한다. */ STATUS Dmc_EpgDeleteRange(int idStart, int idEnd); /* cafrii 041019 add idStart 부터 idEnd 사이의 모든 EpgDB를 삭제한다. */ STATUS Dmc_EpgDeleteAll(void); /* 모든 EpgDB를 삭제.. */ void Dmc_EpgPrintAllTables(int id, int source_id, BOOL bSimpleDisplay); /* EpgDB를 debug consol에 출력한다. */ STATUS Dmc_EpgNotifyMgtVersionChange(void); /* Mgt가 변경되었음을 명시적으로 알려줄 때 사용하는 함수.. EPG MW 내에서 Mgt 관리자를 사용하여 자동적으로 알아서 처리하므로 Application에서 특별히 사용할 경우는 없을 것이다. */ EPG_STATUS Dmc_EpgCheckScanStatus(int id, int source_id, DmcEpgStatus *pStat); /* 지정한 채널의 Epg download 상태를 리턴한다. */ STATUS Dmc_EpgGetEstimatedSttSection(int id, sttSection_t *pFlatStt, UINT32 *pAge); /* cafrii 050528 add */ STATUS Dmc_EpgGetEstimatedStt(int id, UINT32 *pSystemTime, UINT32 *pAge); /* obsoleted */ /* void Dmc_EpgSetMonitorSourceId(int source_id); */ /* cafrii 070801 delete */ int Dmc_EpgGetDescriptor(UINT8 *descriptors, UINT16 len, UINT8 tag, UINT16 instance, UINT8 **descriptor); #if DMW_EPG_SUPPORT_RRT /* cafrii 060822 add */ typedef enum { RRT_OPTION_UNBLOCK = 0, RRT_OPTION_BLOCK = 1, RRT_OPTION_TOGGLE = 100, } EPG_RRT_BLOCK_OPTION; rrtSectionPtr_t Dmc_EpgGetCurrentRrt(void); void Dmc_EpgSetCurrentRrt(rrtSectionPtr_t rrt); /* cafrii 060822, change prototype, support toggle function */ BOOL Dmc_EpgSetRrtOption(int dim, int value, EPG_RRT_BLOCK_OPTION action); void Dmc_EpgRrtForceUpdateMode(BOOL bForceUpdateMode); UINT32 Dmc_EpgCurrentRrtUpdateCount(void); #endif /* Utilities */ BOOL Dmc_IsEquivalentMgt(mgtSectionPtr_t mgt1, mgtSectionPtr_t mgt2); /* for debugging 이 함수들은 DMW_EpgDebug.c 에 정의되어 있다. */ char *Dmc_ChannelNumberString(int major, int minor, char *buf); /* cafrii 041126 add two conversion function */ UINT8 *Dmc_ConvertKs2Mss(char *str, UINT8 **pMssPtr, int *pMssLen); STATUS Dmc_ConvertMss2Ks(UINT8 *mssPtr, UINT16 mssLen, char *buf, int max_buflen, char *lang, int instance); void Dmc_PrintMultipleString(UINT8 *buffer, UINT16 len, int indent, int detailLevel); char *GpsTimeString2(UINT32 gps, char *buf, int level); char *GpsTimeString(UINT32 gps, char *buf); void Dmc_PrintEit(eitPtr_t eitPtr, int indent, ettSectionPtr_t *ettArray); void Dmc_PrintEtt(ettSectionPtr_t ettSectPtr, int indent); void Dmc_PrintRrt(rrtSectionPtr_t rrt, int indent, BOOL bDetail); void Dmc_SetGpsTimeSync(sttSection_t *stt); void Dmc_EpgRegisterEpgSymbols(void); #endif /* __DMW_EPG_BASE_H__ */ /****************************************************************************** $Log: DMW_EpgBase.h,v $ 1.03 2005/2/3 add epgEventUpdateChannelEtt event and the related 1.02 2004/11/29 epgEventChannelEttUpdated 추가 1.01 2004/11/26 Dmc_ConvertKs2Mss / Dmc_ConvertMss2Ks 함수 추가 1.00 2004/?/? History 관리 시작 ******************************************************************************/