/* DMW_EpgInterface.h New EPG Middleware Interface 1 (EPG1 compatible version) There are one interface supported, which is mostly compatible with old EPG 1.0 MW.. Copyright 2004 Digital STREAM Technology, Inc. All Rights Reserved $Id: DMW_EpgBase.h v1.00 2004/07 cafrii Exp $ */ #ifndef __DMW_EPG_INTERFACE_H__ #define __DMW_EPG_INTERFACE_H__ #include "DMW_EpgBase.h" /* Epg 2.0 New Core Header file */ #include "DMW_ChannelDemux.h" /* cafrii 050624 add for xvct */ #include "DHL_AVCAP.h" /* 2010.02.02 foxhunt : add for AudioType */ /*---------- EIA-766 Rating ---------------*/ typedef enum { RATING766_NONE = 0, /* Missing Rating을 의미함. TV_None, MPAA-NR이 아님. */ RATING766_US_Entire_Audience, RATING766_US_Children, RATING766_US_MPAA, RATING766_CANADA_English, RATING766_CANADA_French, } RATING766_T; typedef struct { RATING766_T type; UINT8 value; UINT8 D, L, S, V, FV; } DMW_Rating766; /*---------- Region 5 Rating --------------- */ #define MAX_RATING_DIMS_NUM 20 /* D-RRT guide line 문서 */ #define MAX_RATING_RGNS_NUM 8 /* refer ATSC A65B $6.9.4 up to 8 regions allowed per event */ typedef struct { UINT8 region_id; UINT8 num_dimensions; struct { UINT8 index; /* dimension index */ UINT8 value; /* value */ } dimension[MAX_RATING_DIMS_NUM]; /* 사용되고 있지 않아서 삭제 UINT16 rating_description_length; UINT8 *rating_description; */ } DMW_RatingRegion; typedef struct { UINT8 region_count; DMW_RatingRegion region[MAX_RATING_RGNS_NUM]; } DMW_Rating5; /* Audio Program Information cafrii 060609, add userparam. */ typedef struct { UINT16 elementaryPid; UINT32 ISO639_LanguageCode; UINT8 serviceType; /* service type in PMT info. not important now. */ tDHL_AudioCodingType audioType; /* probably AC3, but keep it for later use */ UINT32 userData; /* user (app) can use this variable for free. */ } DMW_AudioElement, *DMW_AudioElementPtr; /* 하위 16 bit는 받기를 원하는 최대 event 갯수이다. 일반적으로 OSD 제한 때문에 일정 갯수 이상은 필요하지 않는 경우가 있을 수 있다. */ #define GET_EVENT_BASIC 0x000000 #define GET_EVENT_RATING 0x010000 #define GET_EVENT_CAPTION 0x020000 #define GET_EVENT_TITLE 0x040000 #define GET_EVENT_TEXT 0x080000 #define GET_EVENT_STATIC_MEM 0x100000 //neverdai 110713 static memory를 사용함. // -인자 중 하나인 aFoundEvents로 static memory를 전달함 // -caller는 넉넉한 memory size를 할당해야 할 필요 있음. // -또한 titleText, eventETM같이 얻어올 데이터에 대해서도 메모리 할당이 되어 있어야 함. // -caption은 따로 메모리가 할당되지 않음. // -메모리 초기화도 caller의 몫 #define GET_EVENT_ALL 0x0FFFFF//0xFFFFFF //neverdai 하위 16bit는 갯수, 바로 위 상위 4bit는 얻어올 데이터, 그 위 상의 4bit는 option임. //따라서 Get_EVENT_ALL을 0x0FFFFF로 하는게 좋음. #define DEFAULT_MAX_EVENT_NUMBER 200 /* cafrii 060620 add */ #define RRT1_MAX_DIM 3 /* iskang 0800619 add RRT region의 최대 dimension number */ typedef struct { UINT16 programId; /* EIT event 각각의 event ID를 의미한다. */ /* EIT내의 event 정보에 있는 시간 정보 */ UINT32 programLength; /* seconds units */ UINT32 startTime; /* number of GPS seconds */ #if 0 // 2010.01.29 foxhunt : DMW_Rating5를 사용하자. ratingRegionCount는 DMW_Rating5의 region_count 임 UINT8 ratingRegionCount; /*Content Advisory descriptor*/ DMW_Rating *rating; /* event descriptor인 contentAdvisoryDesc 내용을 분석해서 만든 값들이다. region count갯수만큼 있고, dimension은 풀어서 기록하고 있음. */ #else DMW_Rating5 rating; /* 이 field는 pointer가 아니다. */ #endif /* cafrii 030608 add */ captionServiceDescriptorPtr_t caption; /* EIT 내의 event 내의 title 정보이다. */ UINT8 titleTextLength; UINT8 *titleText; /* 이 event랑 연결된 ETM 정보이다. ETT로부터 얻어왔다. */ UINT16 eventETMLength; UINT8 *eventETM; } DMW_EpgEvent, *DMW_EpgEventPtr; typedef DmcEpgEventType EpgUpdateEventType; /* 원래 enum 값으로 정의된 상수인데 더이상 사용하지 않을 것이므로 enum은 삭제하였고 이 type은 compatibility를 위해 그냥 int형으로 정의함. */ typedef STATUS (*EpgUpdateCallbackFn) (EpgUpdateEventType evt, UINT32 param1, UINT32 param2); /*---------------------------- // Porting시의 주의 사항: // // EventProc에서 넘겨주는 사용자 event type의 형식이 // 기존의 EpgUpdateEventType 에서 ---> DmcEpgEventType 로 변경되었음.. // // EpgUpdateEventType 이름들: evtEpgUpdateStarted, evtEpgXXX.. // // DmcEpgEventType 이름들: epgEventStarted, epgEventXXX.. // // 이 이벤트 들은 그 숫자의 의미가 정확히 일치하지 않으며 (대략 비슷하긴 하지만) // 같이 넘겨주는 parameter들도 의미가 완전히 다르다. // // 따라서 EpgEventProc은 다시 작성하는게 좋을 듯.. */ /*---------------------------- // 전체 구조 // // // 기본적으로 모든 EpgInterface 들은 EpgBase 기반 위에서 정의된다. // Update를 시작/종료 하는 것은 EpgBase API를 이용해서 수행되지만, // EpgData retrieve는 아래 Interface를 통해서 이루어진다. */ /* compatible APIs */ STATUS DMW_EPG_Init(void); /* 초기화 */ STATUS DMW_EPG_UpdateCurrentRf(int rf, int source_id, EpgUpdateCallbackFn callback); /* RF 채널의 EPG 검색 */ STATUS DMW_EPG_UpdateCurrentChannel(int iUCMId, EpgUpdateCallbackFn func); /* UID 채널의 EPG 검색 */ STATUS DMW_EPG_DeleteAll(void); /* 모든 채널 정보 삭제.. */ STATUS DMW_EPG_GetEventsInRange(int iUCMId, UINT32 nStartTime, UINT32 nDuration, DMW_EpgEventPtr *aFoundEvents, int *piEventCounts, UINT32 flag); /* nStartTime GPS 시간 부터 nDuration 영역의 시간 구간과 겹치는 event 정보를 리턴.. 비록 Epg Update는 RF 단위가 기본이지만, EpgEvent 정보 데이터를 읽을 때에는 Minor channel (subchannel) 단위로 가져온다.. */ STATUS DMW_EPG_GetEventInTime(int iUCMId, UINT32 nTime, DMW_EpgEventPtr *pFoundEvent, UINT32 flag); /* cafrii 060605 add */ STATUS DMW_EPG_GetEventInTimeByRf(int rf, int source_id, UINT32 nTime, DMW_EpgEventPtr *pFoundEvent, UINT32 flag); void DMW_EPG_FreeEpgEvents(DMW_EpgEvent *pEvent, int iCount); /* GetEventsXX 함수로 가져온 event 정보를 free 시키는 함수 하나하나씩 free 할 수 없고 통째로 free를 시켜야 함.. (중요!) pEvent는 iCount 갯수 만큼의 EpgEvent 가 저장된 array의 선두 포인터이다. */ /* cafrii 091105 add */ STATUS DMW_EPG_GetEventByEvid(int iUCMId, UINT16 evid, DMW_EpgEventPtr *pFoundEvent, UINT32 flag); STATUS DMW_EPG_GetEventByEvidAndRf(int rf, int source_id, UINT16 evid, DMW_EpgEventPtr *ppReturnEvent, UINT32 flag); /* cafrii 060814 add */ void DMW_EPG_GetScanStatus(int uid, DmcEpgStatus *pStat); /*------------------- utility APIs */ STATUS DMW_GetPsipDescriptor(UINT8 *descriptors, UINT16 len, UINT8 tag, UINT16 instance, UINT8 **descriptor); /* descriptor list 에서 지정한 tag를 갖는 특정 descriptor를 추출하여 리턴한다. */ STATUS DMW_ParseRatingDescriptor(UINT8 *descriptors, int descriptor_length, DMW_Rating5 *pRating); /* descriptor list 에서 CA descriptor를 찾고 분석하여 DMW_Rating 정보를 완성하여 리턴한다. */ /* Rating info */ STATUS DMW_EPG_GetRatingInfo(int iUCMId, UINT32 nTime, DMW_Rating5 *pRating); STATUS DMW_EPG_GetRatingInfoByRF(int rf, UINT16 source_id, UINT32 nTime, DMW_Rating5 *pRating); STATUS DMW_EPG_GetRatingInfoInPMT(DMW_Rating5 *pRating); /* Caption Info */ STATUS DMW_EPG_GetCaptionDescriptor(int iUCMId, UINT32 nTime, captionServiceDescriptorPtr_t *pccdesc); STATUS DMW_EPG_GetCaptionDescriptorInPMT(captionServiceDescriptorPtr_t *pCC_Service); /* EIA-766 Rating */ void DMW_EPG_ConvertToRating766Info(DMW_RatingRegion *pRegion, DMW_Rating766 *pR766); BOOL DMW_EPG_IsValidRating766Info(DMW_Rating766 *pr766); char *DMW_EPG_Rating766String(DMW_Rating766 *pInfo, char *buf); /* cafrii 060609, support RRT(region 5) API */ BOOL DMW_EPG_CheckRatingBlockByRRT(DMW_Rating5 *pRating, BOOL *pbNoRating); STATUS DMW_EPG_GetRatingStringByRRT(DMW_Rating5 *pRating, UINT16 *str, int nBufSize); /*------------------- EpgUTIL */ #if 0 UINT16 DMW_Decode_MultipleStringStructure(UINT8 text_length, UINT8 *text_p, char *lang, UINT16 max_dec_length, UINT16 *decoded_text); #endif void DMW_EPG_FreeMLInfo(DMW_AudioElementPtr aLingualInfos); STATUS DMW_EPG_GetMLInfoInPMT(MPEG_PMT* pmt, DMW_AudioElementPtr *aLingualInfos, int *iLingualCount); STATUS DMW_EPG_GetMLInfoInVctDescriptors(UINT8 *descriptors, int descriptor_length, DMW_AudioElementPtr *aMLInfo, int *piCount); /* cafrii 050725 add */ STATUS DMW_EPG_GetMLInfoInVct(xvctChannelPtr_t vctch, DMW_AudioElementPtr *aMLInfo, int *piCount); /* cafrii 050627 add */ #if 0 STATUS DMW_EPG_GetLanguageCodeFromDescriptors(UINT8 *pDesc, int nDescLen, int instance, UINT32 *pLangCode, int *pServiceType); /* cafrii 050617 add 주어진 descriptors 리스트에서 Language 정보를 추출하여 리턴한다. */ #endif void DMW_EPG_RegisterEpgIntfSymbols(void); void DMW_EPG_FreeEpgEvent(DMW_EpgEvent *pEvent); /* iskang */ /*---------------------------- // Epg data scan policy // // // Background scan: // 채널 튜닝 이후에, 또는 DTV sleep time 시에 유휴 시간을 이용하여 Epg data를 수집하는 방법 // DMW_EPG_UpdateCurrentRf 를 사용하여 timeout 없이 RF 단위로 Scan.. // EpgBase API를 직접 사용한다면 eit_only flag를 먼저 사용할 수도 있을 것임.. // // Forground scan: // EPG OSD를 띄워야 하는 상황에서 forground로 epg data를 수집하기 // OSD에서 먼저 보여줘야 하는 데이터부터 우선 수집한다. // 현실적으로 모든 데이터가 다 수신되기를 기다릴 수는 없으므로 timeout을 두고 // 복수개의 채널을 순서대로 돌아가면서 수신.. // OSD를 보여준 뒤에도 계속 background로 scan 작업을 하도록 하여, update될 때마다 // OSD를 update한다. // TestGetMultiChannelEpg 예제를 참고하기 바람. */ #endif /* __DMW_EPG_INTERFACE_H__ */ /******************************************************************** $Log: DMW_EpgInterface.h,v $ 1.02 2004/12/23 descriptor parser API 몇개 추가 1.01 2004/11/30 DMW_EPG2_GetRating prototype changed 1.00 2004/11/? History 관리 시작 *********************************************************************/