/******************************************************************** * * Dmw_Channel.h - header for Dmw_Channel sources * * Channel Decoding Module (DMC) header file * * Copyright 2004 Digital STREAM Technology, Inc. * All Rights Reserved * * $Id: DMW_Channel.h, v?? cafrii Exp $ * ********************************************************************/ #ifndef DMW_CHANNEL_H #define DMW_CHANNEL_H #ifdef __cplusplus extern "C" { #endif #include "DMW_Platform.h" #include "DHL_AVCAP.h" #include "DHL_FE.h" #include "DMW_Status.h" #include "DMW_ChannelDemux.h" #include "DMW_Dummy.h" //----------------------------------------------------------------- // HAL // //----------- // 채널 타입 // typedef enum { ChannelType_Air = 0, // 지상파 채널 타입. ChannelType_Cable = 1, // 케이블 채널 타입. } ChannelType; // RF number를 frequency로 해석할 때 어느 타입이냐에 따라 실제 주파수 값이 다르게 나온다. // 그 외의 모든 작업은 채널 타입과 거의 무관하다. extern ChannelType g_CurChannelType; // 현재 채널 유형. 0: AIR, 1: Cable // Air와 Cable이 공존할 수는 없다. (하나의 RF 번호를 놓고 해석 방법이 달라지므로..) // // 이 변수를 직접 수정하지 않도록 한다. // const type이므로 일반적인 방법으로는 수정할 수 없다. // 꼭 초기화 함수를 이용해야 한다. // // cafrii, 030323 // compiler의 optimization 문제로 const를 다시 삭제함. #define ChannelTypeString(type) ( \ (type) == ChannelType_Air ? "Air" : \ (type) == ChannelType_Cable ? "Cable" : "??") //-------------- // 주파수 표준 extern tDHL_FreqStd g_CableSystem; // // g_CurChannelType이 Air인 경우에는 이 값은 FREQ_AIR 이어야 한다. // #define FreqStdString(s) ((s)==0 ? "FreqAir" : (s)==1 ? "FreqCable" : (s)==2 ? "FreqIRC" : (s)==3 ? "FreqHRC" : "Freq??") //----------- // 모듈레이션 타입 // typedef enum { // cafrii 041104 add // report 전용 Modulation_Invalid = -1, // request/report 겸용 Modulation_NTSC = 0, Modulation_8VSB = 1, Modulation_64QAM = 2, Modulation_256QAM = 3, // request 전용 Modulation_CableAuto = 4, Modulation_QAM = 5, // OREN과 같이 firmware에서 자동 detect하는 경우에 사용한다. } ModulationType; // DMW ChannelMW에서는 ModulationMode, ServiceType 모두 같은 의미로 사용한다. // #define ServiceTypeString(type) ( \ type == Modulation_NTSC ? "NTSC" : \ type == Modulation_8VSB ? "8VSB" : \ type == Modulation_64QAM ? "64QAM" : \ type == Modulation_256QAM ? "256QAM" : \ type == Modulation_CableAuto ? "CableAuto" : \ type == Modulation_QAM ? "QAM" : "??") #define ModulationTypeString(t) ServiceTypeString(t) // cafrii 050316 add // // NTSC Tuning 시에 사용될 Tuner 주파수 설정 모드 // // FULL Search 모드는 Analog Autoscan시 CableSystem Auto-detect 용으로만 사용을 제한한다. // 이 모드는 TunerSetChannel 에는 사용할 수 없다. // // 디지털 튜닝 시에는 이 모드값은 모두 무시되며 항상 TUNE_FIXED 방식으로 튜닝된다. // typedef enum { FREQTUNE_FIXED = 0, // 지정한 주파수로만 설정 (RF, offset). default mode FREQTUNE_SHORT_SEARCH = 1, // Short Search : 지정한 주파수 (RF, offset) 주변 영역 검색 //FREQTUNE_FULL_SEARCH = 2, // Full Search : offset을 무시하고 Full range 검색 } FreqTuneMode; //-------------- // 각종 timeout variables // cafrii 050415 add extern int g_Timeout_SignalLock; extern int g_Timeout_AnalogSignalLock; extern int g_Timeout_VctLoading; extern int g_Timeout_PatLoading; extern int g_Timeout_PmtLoading; #define DMC_CHECK_HEAP_SIZE 0 // cafrii 060831 add, // for memory leak test // 각종 callback, event 등의 처리 작업시마다 // heap 상태를 계속 체크해서 디버그 창에 표시.. #if 0 ____Types____() #endif typedef BOOL (*DMC_FN_CHECK)(void); // cancel check function typedef void (*DMC_FN_COMPLETED)(STATUS status, UINT32 userParam, void *pAdditionalParam); // general CompleteFunction #define TLVideoContext UINT32 typedef void (*DMC_FN_USERDATA)(TLVideoContext *); // CC User data callback typedef void (*DMC_FN_NOTIFY)(UINT32, UINT32); // Dmc notification callback function type typedef STATUS (*DMC_FN_DPC)(UINT32, UINT32, UINT32, UINT32); // Dmc DPC callback functiontype #if 0 ____DMW_HAL____() #endif //-------------- // HAL API for middle ware codes. // ModulationType DMW_HAL_TunerDemod2Modulation(tDHL_Demod demod); tDHL_Demod DMW_HAL_Modulation2TunerDemod(ModulationType mode); BOOL DMW_HAL_DetectAnalogVideoChannel(void); STATUS DMW_HAL_SetChannelStandard(tDHL_FreqStd std); STATUS DMW_HAL_TunerScanSetChannel(UINT32 ch, ModulationType type, INT32* pOffset, FreqTuneMode mode, DMC_FN_CHECK chkfn); STATUS DMW_HAL_TunerSetChannel (UINT32 ch, ModulationType type, INT32 offset, FreqTuneMode mode, DMC_FN_CHECK chkfn); STATUS DMW_HAL_TunerSetFrequency(UINT32 freqInKHz, ModulationType mode, BOOL (*chkfn)()); STATUS DMW_HAL_AfcSearchMultiple(int nFreq, UINT32 *aFreq, int timeout, DMC_FN_CHECK ckfn); BOOL DMW_HAL_DetectNIMChannel(void); int DMW_HAL_GetSignalStrength(void); float DMW_HAL_GetSNR(void); int DMW_HAL_GetCurrentRF(void); // cafrii 060630 add void DMW_HAL_ResetLastRF(void); // cafrii 060714 add ModulationType DMW_HAL_GetModulationMode(void); int DMW_HAL_GetFDCLockStatus(void); int DMW_HAL_GetFDCSignalStrength(void); float DMW_HAL_GetFDCSNR(void); void DMW_HAL_RegisterChannelHalSymbols(void); #if 0 ____FreqTable____() #endif //------------------------------ // 채널 주파수 테이블. DMW_ChannelFreq.c // #define HIGHEST_AIR_CHANNEL 83 #define HIGHEST_CABLE_CHANNEL 135 extern UINT32 FindCenterFrequency(int RF, INT32 freqOffset, tDHL_FreqStd std); // // cafrii 050316 add // // 주어진 RF 채널 번호에 해당하는 center frequency를 리턴한다. 단위는 Hz // freqOffset을 지정하면 그 offset 분이 반영되어 리턴된다. // // 입력한 값에 문제가 있으면 0을 리턴. // extern int FindAirRF(UINT32 freq, INT32 *freq_offset); extern int FindCableRF(UINT32 freq, INT32 *freq_offset); extern int FindMultiStandardRF(UINT32 freq, INT32 *freq_offset, tDHL_FreqStd std); // // 주어진 주파수 값에 해당하는 RF 채널 번호(정수값)를 리턴한다. // freq: // VSB인 경우 freq는 pilot tone 주파수이다. // 6MHz band의 lower-edge 주파수 + 310KHz // 아날로그인 경우는 picture carrier // center freq - 1.75MHz == lower-edge + 1.25MHz // freq_offset: // freq_offset은 아날로그인 경우에만 사용하는 것으로서, // 테이블 상의 picture carrier와의 차이 값을 리턴한다. // // return 값: // 발견된 RF 채널 번호. 발견되지 않으면 -1을 리턴한다. //----------------------------------------------------------------- // // Dmc_ChangeDisplayXXX()에 사용되는 상수들.. // Color constant // typedef enum { VOUT_YPBPR = 1, VOUT_MONITOR = 2, VOUT_RGB = 3, } VOUT_COLOR; // Format constant // typedef enum { VOUT_NATURAL = 0, VOUT_480I = 1, VOUT_480P = 2, VOUT_720P = 4, VOUT_1080I = 8, VOUT_480I_SC = 10, // S-Video+CVBS output VOUT_480I_CC = 11, // YPbPr+CVBS output VOUT_1366_768P = 12, // LVDS } VOUT_FORMAT; // Screen ratio constant // typedef enum { VOUT_WIDE = 0, VOUT_NARROW = 1, } VOUT_RATIO; typedef enum { VAUX_NONE = 0, // No Aux VAUX_VG = 1, // Standard Aux, video and graphics VAUX_VONLY = 1, // Standard Aux, video only } VOUT_AUX; #if 0 ____DMW_PROGRAM____() #endif //------------------------------------------------------------------ // ProgramInfo 구조체 typedef enum TUNE_METHOD_t { TUNE_METHOD_NONE = 0, TUNE_METHOD_ByPIDs = 1, TUNE_METHOD_ByCVCT = 2, TUNE_METHOD_ByTVCT = 3, TUNE_METHOD_ByVCT = 4, TUNE_METHOD_ByPSI = 5, TUNE_METHOD_ByUser = 6, //TUNE_METHOD_By1394 = ?? } TUNE_METHOD; #define TuneMethodString(m) ( \ (m)==TUNE_METHOD_ByPIDs ? "By PIDs" : \ (m)==TUNE_METHOD_ByCVCT ? "By CVCT" : \ (m)==TUNE_METHOD_ByTVCT ? "By TVCT" : \ (m)==TUNE_METHOD_ByVCT ? "By xVCT" : \ (m)==TUNE_METHOD_ByPSI ? "By PSI" : \ (m)==TUNE_METHOD_ByUser ? "By User" : "Unknown") // 현재 시청중인 프로그램 및 AV decoding에 대한 정보. // typedef struct ProgramAVInfo_t { BOOLEAN active; BOOLEAN analog; // FALSE if digital // input port // tDHL_CapVideoInput input_video; tDHL_CapAudioInput input_audio; UINT32 rf; // RF channel number ModulationType mod; // digital only parameters // TUNE_METHOD method; // 1:PIDs, 2:CVCT, 3:TVCT, 4:PSI UINT32 audio_pid; // Audio PID UINT32 video_pid; // Video PID UINT32 pcr_pid; // PCR PID tDHL_AudioCodingType audio_type; tDHL_VideoCodingType video_type; int major, minor; // by xVCT. int program_number; // by PSI. program number in PAT/PMT // source format info // BOOL seq_hdr_valid; // TRUE if seq_hdr is valid tDHL_VideoSeqHdr seq_hdr; // video parameters // BOOL video_freezed; // TRUE if video is freezed now.. BOOL video_hidden; // TRUE if video is hidden now.. UINT32 video_scrambled_count; UINT32 audio_scrambled_count; // PSI control parameters // MPEG_PAT *pat; MPEG_PMT *pmt; tDHL_PSI_ControlHandle patPsiCtl; tDHL_PSI_ControlHandle pmtPsiCtl; #if USE_CH_MW_ALL_PMT_DOWNLOAD // 전체 프로그램의 pmt array. pmt의 순서는 pat에 있는 순서와 일치해야 함. MPEG_PMT **pmtList; // 현재 시청 중이 아닌 다른 채널의 pmt를 받기 위한 monitor handle tDHL_PSI_ControlHandle pmtPsiCtl2; #endif // User parameters // UINT32 userParam; // cafrii 060804 add } ProgramAVInfo; #if 0 ____TuneParam____() #endif //----------------------------------------------------------- // TuneParam 구조체는 DmcTask 내부에서 채널 튜닝을 할 때 필요한 모든 정보를 // 포함하고 있다. // // MW 함수 내부에서만 사용되며, Application task에서 Dmc task로 // 정보를 전달할때 사용된다. // // 또는 DmcTask 내부적으로 필요에 의해서 만든다. // // ChannelTuneFlag // cafrii 031231 change // CTF_Mask_Tuning 내의 값들은 이제 더이상 bit flag가 아니라 enumeration 값들이다. // bitwise AND 연산자를 사용해서 check하면 안되고 꼭 masking해서 == 연산자를 사용하기 바람. // #define CTF_Automatic 0 // 0 : Automatic. if xVCT info is invalid, use PSI info. // CVCT -> (TVCT) -> PSI. #define CTF_VCTOnly 1 // 0 : Do not use PSI channel info. VCT only. #define CTF_PSIOnly 2 // 1 : Do not use VCT info. Use only PSI channel info. #define CTF_SemiAutomatic 3 // 3 : Weak automatic change to PSI mode. // VCT를 못 받거나 (NoVCT), 받은 VCT가 잘못되었거나 (InvalidVCT) // 찾는 채널이 없으면 (ChannelNotFound) 자동으로 PSI로 넘어감. // 모든 PSIP 관련 조건은 정상인데, Video Decoding이 실패하면 (VideoError) // 자동으로 PSI로 넘어가지는 않는다. // RetryMode에서는 별 의미가 없는 flag이다. Philips 요구사항에 의해 만들었음. #define CTF_Mask_Tuning 0x3 #define CTF_SkipQamModulation 0x4 // cafrii 070608 add // 일부 QAM을 지원하지 않는 platform에서는 VSB만 support함. #define CTF_UseVideoFlatten 0x8 // Use flattening function when stop/start video context. // 아직은 이 플래그를 사용하지 않는다. // 그냥 1394에서는 flatten을 막아버렸다. #define CTF_RetryMainChannel 0x10 #define CTF_RetryOtherChannel 0x20 // // 이 두 플래그는 VCT 기반의 Tuning (Automatic, SemiAuto 포함) 에서 사용됨. // // RetryMainChannel : // VCT의 specific tuning 방식으로 채널 튜닝 후 성공하지 못했을때 대표채널 튜닝으로 1회 재시도.. // ex: RfTune(RF 20, 14-2, RetryMainChannel) 로 call한 경우 // 먼저 14-2로 specific tuning을 try하고 실패하면 그 PTC내에서 대표채널 튜닝. // 주로 사용자가 14.2와 같이 digit key를 누른 경우에 사용됨. // // RetryOtherChannel : // VCT 기반 튜닝에 실패할 경우 다시 다음 채널로 retry를 한다. // major-minor 를 0-0으로 지정하면 unspecified tuning모드에서 retry가 되어 // 가장 낮은 채널부터 하나씩 try.. // specific tuning 모드에서도 사용가능. // ex: RfTune(14-3, RetryOther) 로 지정하면 14-3, 14-4의 순서로 진행. // // 검색 순서는 가장 낮은 Major/minor 채널부터.. // 채널이 없거나 에러가 나면 그다음 minor 채널로 retry. // RetryMainChannel과 동시에 사용될 수도 있다. // // VCT table의 TSID와 다른 채널(remote channel)은 무조건 제외한다. (설령 family 채널이라도..) // Family channel만을 대상으로 튜닝하고 싶으면 SkipNonFamilyChannel flag 사용하면 됨. // 두 플래그 동시 사용 가능.. // ex: RfTune(RF 20, 14-2, RetryMain, RetryOther, SkipNonFamily) // 먼저 14-2 시도. 실패하면 MainChannel 시도 (14-1이 table에 있을 경우 14-1 시도) // Main 채널 실패하면 14-3 이후부터 또 시도.. // 13-1과 같은 채널이 이 PTC에 있어도 무시 (13-1은 family가 아님) // #define CTF_RetryMainProgram 0x40 // 아직 지원하지 않고 있음. 그 의미가 명확하지 않아서.. #define CTF_RetryOtherProgram 0x80 // PSI 처리에 사용된다. // RetryMainProgram : // 지정한 프로그램을 튜닝 시도한 후 문제가 있을 경우 대표프로그램 튜닝을 1회 재시도. // RetryOtherProgram : // 프로그램 튜닝에 에러가 생기면 다른 프로그램으로 retry.. // // 채널을 try하는 순서는 PAT array에 나타난 index 순서이다. // 대표 프로그램은 첫번째 프로그램을 말한다. //#define CTF_TryAnyProgram CTF_RetryOtherProgram // 이름을 변경하였음. // backward compatibility를 위해서 TryAnyProgram도 그냥 놔두자. #define CTF_SkipNonFamilyChannel 0x100 // Family 채널이란 Major 번호가 일치하는 channel 그룹을 의미한다. // 이 모드에서는 API call 인자로 지정한 Major와 동일한 채널만 검색. // // 이 옵션은 CTF_RetryOtherChannel을 사용할 경우에만 사용할 수 있다. // #define CTF_DontRetryTVCTOnCable 0x200 // Cable 환경에서 CVCT 수신에 실패할 경우 TVCT로 // 주의! CVCT가 일단 수신이 된 이후의 에러(예:syntax 상의 에러)에 대해서는 항상 retry를 안한다. // CVCT가 수신이 아예 안된 경우에는 이 플래그가 SET가 아니면 retry를 한다. // // 일단 RfTune에서만 적용함. // UCM에 Tvct/Cvct 구별 정보가 없으므로 UidTune에서는 적용하기가 좀 애매함. #define CTF_RetryAnalogIfSignalUnlock 0x400 // 만약 digital signal이 lock이 안되면 NTSC로 튜닝을 하는 모드. // 일단 caller는 TuneParam->type은 digital로 해서 Tuning함수를 call해야 한다. // 만약 digital lock이 안되면 analog로 자동 전환이 된다. // APP는 analog로 자동 전환 되었는지의 여부를 등록된 callback을 통해서 알수 있다. #define CTF_TunerAutoFreqAdjust 0x800 // Tuner frequency 설정시에 auto adjust를 할것인지의 여부. // Set이면 auto adjust를 한다. // 자세한 내용은 Tuner Driver함수 참조. //#define CTF_DontUseAppBannerCallback 0x1000 // TRUE이면 AppBannerCallback을 부르지 않는다. // 일반적으로 UID tune을 사용할 경우에는 미리 banner를 보여주고 // callback에서 banner를 보여주지는 않는다. #define CTF_ShowHiddenChannelAlso 0x2000 // cafrii 040114 add // TRUE이면 VCT에서 hidden으로 처리된 채널도 동일하게 일반 채널처럼 튜닝을 한다. // 디폴트는 FALSE이며 이 경우에는 다른 플래그에 따라 동작이 달라진다. // Retry 모드이면 그 다음 채널로 건너뛰고, // NoRetry 모드이면 statusNotFound 에러 처리를 한다. // 아직 구현중... //#define CTF_UpdateChannelDB 0x4000 // Tuning을 하면서 새롭게 발견된 채널들은 그때그때 DB에 update를 함. // 주로 DRF 튜닝에 사용된다. // 이 채널 데이터는 "임시" 이기 때문에 persistent하면 안될듯.. 어떻게 volatile로 할까.. // 새롭게 update된 DB entry는 callback을 통해 caller에게 report된다. (new 또는 modified) // #define CTF_TunerSetOnly 0x8000 // cafrii 040831 add // 튜너의 주파수 설정, Demodulator 설정 까지만 수행한다. // POD 동작 모드에서 ChannelForceTune 에서 사용된다. // #define CTF_ForceSetTuner 0x10000 // cafrii 060630 add // 일반적으로 동일 RF로 이미 tuner설정이 되어 있는 경우 tuner 설정 skip하는데, // 이 flag가 set이면 항상 강제로 tuner set을 수행한다. #define CTF_SkipPrescanPidInfo 0x20000 // cafrii 041202 add // set 이면 prescan PID 정보를 사용하지 않고 항상 VCT/PSI 로부터 새로 읽어들인다. // #define CTF_UseQamAutoMode 0x40000 // cafrii 060724 add // QAM auto mode를 지원하는 demodulator인 경우 // DEMOD_QAM_AUTO를 이용해서 튜닝을 한다. #define CTF_DontUseVctRecover 0x80000 // cafrii 070201 add // Institutional TV의 경우 field와 달리 invalid vct의 가능성이 낮고 // descrambler 동작을 위해서 반드시 정확한 pmt가 필요하기 때문에 // vct recover 기능을 사용하지 않도록 한다. // TuneParam // 1. AV Decoding에 필요한 Request Parameter. RfTune의 함수 인자로 application이 제공. // 2. TuneCallback을 통해서 tuning의 결과가 넘겨질때 Dmc code가 app로 제공함. typedef struct TuneParam_t { //------------ User Request parameters ---------------------------- // Tuner setting.. int rf; ModulationType type; // Tuner service_type. 0:NTSC, 1:VSB, 2:64QAM, 3:256QAM BOOL tuneRequired; // // --> cafrii 060630 delete, // 이 변수는 더이상 사용되지 않는다. // // if you want to set tuner hardware also, set this TRUE. // unless, 'tuner setting' will be skipped. // tuning을 하지 않는다면 type 값은 아날로그인지, 디지털 인지만 구별하는데 사용된다. // 그러나 rf 값은 내부적으로 기억되는 값이므로 설령 사용되지 않더라도 반드시 올바른 값을 지정해주자. INT32 freqOffset; // cafrii 050315 change name // frequency offset from RF number UINT32 flag; // tune preference flag. 실제로 그 역할은 별로 없음. // // Rf tune은 xVCT->PSI 순서로 preference가 정해져 있으므로 사용하지 않는다. // Uid tune은 xVCT 이거나 PSI 이거나 둘 중에 하나만 가능하도록 고정되어 있다. // (CTF_VCTOnly 또는 CTF_PSIOnly) // Smart tune에서는 이 변수를 사용하지 않는다. // major number가 0이면 PSI tune을 의미하도록 되어 있음. // by xVCT UINT16 major, minor; // xVCT channel info. // CVCT first. (if cable) // and if fail or Air, TVCT later. // if tuning is failed at last, following action will be decided according to flag. // by PSI UINT16 progNumber; // PAT/PMT program info. // if progNumber is zero, use first program in PAT. // Video/Audio decoding.. UINT32 pcrPid, vidPid, audPid; // pre-scanned PID info. // if you want to skip pids info, just set to 0 for all of these. tDHL_VideoCodingType vidType; tDHL_AudioCodingType audType; // cafrii 061114 add // driver에서 AC3와 MPEG audio 구분하지 못한다면 별도로 app에서 // 정보를 넘겨줘야 한다. #if 0 //---------------- internal -------------------------------------- // // 이하 필드는 DMC task에서 AV decoding 작업에 필요한 내부 상태 변수를 저장하는 공간이다. MPEG_PAT *pat; MPEG_PMT *pmt; xvctPtr_t vctPtr; VideoStreamDescriptor *vidDesc; tDHL_AudioCodingType audType; #endif } TuneParam; typedef struct CaptureParam_t { tDHL_CapVideoInput input_video; tDHL_CapAudioInput input_audio; } CaptureParam; #if 0 ____CompleteCallback____() #endif //----------------------------- // // UID Tune으로 채널 튜닝시 TuneCallback으로 넘겨지는 Param // typedef struct AppRfTuneCallbackParam_t { ProgramAVInfo *program; // last tune status. struct xvct *vct; MPEG_PAT *pat; MPEG_PMT *pmt; const TuneParam *tuneParam; // 사용자가 tuning에 넘겨준 그 pointer는 아니다. // 일부 flow logic에 의해서 최초 내용과 달라졌을 수도 있다. // callback 함수가 리턴된 이후에는 이 포인터는 더이상 유효하지 않다. // application은 이 내용을 절대로 변경하면 안된다. } AppRfTuneCallbackParam; typedef AppRfTuneCallbackParam AppUidTuneCallbackParam; // // UID Tune 방식은 사라졌지만 기존의 structure는 그대로 유지한다. // typedef void (*DMC_FN_TUNE_COMPLETED)(STATUS status, UINT32 userParam, AppRfTuneCallbackParam *param); // // tune command의 경우에 특별하게 사용되는 function type // #if 0 ____NotifyCallback____() #endif //----------------------------------------------------------------- // 각종 Notification Event 구조체들.. // cafrii 070322 remove.. // FormatChange, TimingChange 등은 이미 오래 전부터 사용하지 않는 정보들임.. // #if 0 // FormatChangeParam: // DMC_NOTIFY_QueryChangeTiming notification 이벤트와 함께 넘겨지는 // parameter #define FORMAT_CHANGE_AT_RUNTIME 1 #define FORMAT_CHANGE_AT_VIDEOSTART 2 // channel change, video start, etc... // // FormatChangeParam::reason 에 사용되는 값. typedef struct { int reason; // [IN] 1: running change 2: new channel BOOL bSourceFormatChanged; // [IN] TRUE if source format is changed BOOL analog; // [IN] TRUE if current video is analog const TLVideoDisplay *display; // [IN] reference: current display const DetailedVideoTiming *timing; // [IN] reference: current timing TLVideoContext *context; // [IN] reference: current VideoContext AuxVideoSetting aux; // [IN] reference: current aux setting tDHL_DispARC adjustment; // [IN] reference: current adjustment tDHL_VideoSeqHdr *lastSeqHdr; // [IN] reference: last MPEG sequence header // you can find new sequence header from 'context' // if analog context, this is NULL BOOL changeNow; // [OUT] TRUE if app want to change timing right now! const DetailedVideoTiming *returnTiming; // [OUT] the timing app want. const TLVideoDisplay *returnDisplay; // [OUT] the display app want. AuxVideoSetting returnAux; // [OUT] the aux app want. tDHL_DispARC returnAdjustment; // [OUT] AR adjustment } FormatChangeParam; // TimingChangeCompleteParam: // DMC_NOTIFY_TimingChangeComplete notification 이벤트와 함께 넘겨지는 // parameter // // 이 이벤트는 Timing Change Query에서 Application이 changeNow를 리턴하면 // 항상 불려진다. // timing이 정말로 변경되었는지 아닌지의 정보를 리턴한다. // // timing과는 관계없는 parameter (tDHL_DispARC) 같은 정보는 // 실제로 적용이 되었는지 아닌지를 알 수는 없다. // 오로지 Main과 Aux의 display timing에 관해서만 정보를 준다. // typedef struct { STATUS status; // [IN] 가장 마지막에 발생한 에러. BOOL changed; // [IN] timing이 변경 되었는가? // timing은 변경되었지만 다른 에러가 발생했을 수도 있으며, // timing이 변경되지 않았을 수도 있다. const TLVideoDisplay *display; // [IN] 현재 display const DetailedVideoTiming *timing; // [IN] 현재 timing // Note! // 만약 timing(resolution)이 변경되지 않았다면 기존의 값을 리턴한다. // 새로운 timing으로 변경되었는지는 정확히 알 수는 없다. // } TimingChangeCompleteParam; #endif // 0 // cafrii 060609 add // ScreenAdjustmentParam: // DMC_NOTIFY_ScreenAdjustment 이벤트와 함께 전달되는 param // // typedef struct { // input: BOOL bSourceWide; BOOL bDisplayWide; // output: // HAL api는 hd, sd 별도로 arc 적용이 지원된다. (물론 platform에 따라 지원 정도는 차이가 남) tDHL_DispARC adjustment_hd; tDHL_DispARC adjustment_sd; // if adjustment == ARA_USER_SPECIFIC, coordination info required. // cafrii 070102, no support ARA in MW level. // app can use ARA directly by using driver callback. //TL_RECT cord; DHL_Rect rect; // cafrii 060928 add BOOL bKeepCurrent; // cafrii 080929 } ScreenAdjustmentParam; // PSIChangeNotifyInfo: // DMC_NOTIFY_PATChanged, DMC_NOTIFY_PMTChanged 이벤트와 함께 넘겨지는 // parameter // // PAT change event의 경우, 사용자는 어떤 program을 decoding할 것인지 // 선택할 수 있다. // PAT change event는 실제로 PAT processing을 하기 전에 불리며 // program_index 필드를 통해서 program을 선택하게 된다. // // PMT change event일 경우에는 사용자는 // // typedef struct { BOOL pmtchanged; // [IN] 0 : pat change, 1 : pmt change MPEG_PAT *pat; // [IN] new PAT MPEG_PMT *pmt; // [IN] new PMT // cafrii 060804 add UINT32 userParam; // [IN] user parameter passed at channel tuning // usually channel id info (UID or similar) // cafrii 060804 add const ProgramAVInfo *av; // [IN] current AV info. do not change values inside. // AV mutex is locked state. // first PSI는 자동적으로 걸러져서 report되지 않기 때문에 // user가 이 flag를 신경쓸 필요 없음. //BOOL first; // [IN] TRUE if this is first PSI after channel tuning. // normally, this first PSI should be ignored. // cafrii 060303 // user가 ignore 할 수 있는 option은 삭제함. 더이상 지원하지 않음. //BOOL ignore; // [OUT] TRUE if app want to ignore this PSI. // PAT : throw new pat away, and do not start PMT monitoring. // PMT : throw new pmt away, and do not restart video. int program_index; // [OUT] PAT only. // The program index (not program number) you want to play. // subject to change!! } PSIChangeNotifyInfo; // cafrii 110331 add // argument of DMC_NOTIFY_AllPsiReceived // typedef struct { const ProgramAVInfo *av; // current AV info. do not change values inside. } AllPsiRxNotifyInfo; //------------------------------ // DMW_NOTIFY_MajorChangeEvent // typedef struct MajorChangeEventParam_t { BOOL ignore; // [OUT] 0: if app want to ignore this major change. 1: leave all thing to DMC. } MajorChangeEventParam; typedef struct AudioDecodeStartParam_t { UINT16 audPid; // [IN] Audio PID.. it may be 0 when NO AUDIO channel. UINT16 pcrPid; // [IN] PCR PID tDHL_AudioCodingType audType; // [IN] int mode; // [IN] MOCHA_ATSC_INPUT or MOCHA_NTSC_INPUT STATUS result; // [OUT] if result is statusNotImpl, DMC MW do default action. // default is statusNotImpl. // if result is not statusOK, then Tuning will failed. } AudioDecodeStartParam; typedef struct AudioDecodeStopParam_t { int mode; // [IN] MOCHA_ATSC_INPUT or MOCHA_NTSC_INPUT STATUS result; // [OUT] if result is statusNotImpl, DMC MW do default action. // default is statusNotImpl. // if result is not statusOK, then Tuning will failed. } AudioDecodeStopParam; typedef struct AudioPidSelectParam_t { MPEG_PMT *pmt; // pmt->streams[x].stream_type 을 보고 Audio stream을 선택. (MPEG-1, 2, AAC, ..) // language는 descriptor중에서 ISO 639 Language descriptor를 보고 선택. xvctChannelPtr_t vctChannel; // channel->descriptor_length, channel->descriptors를 이용하여 SLD 정보 추출. UINT16 returnAudioPid; tDHL_AudioCodingType returnAudioType; } AudioPidSelectParam; typedef struct VideoPidSelectParam_t { MPEG_PMT *pmt; xvctChannelPtr_t vctChannel; UINT16 returnVideoPid; tDHL_VideoCodingType returnVideoType; } VideoPidSelectParam; typedef struct { UINT16 vid_pid; UINT16 aud_pid; UINT16 pcr_pid; UINT16 pmt_pid; } DecodingPidReadyParam; // arzhna, 100203 // pod 정보를 얻어오기 위한 struct typedef struct { BOOL isPodInserted; } PodStatusParam; //------------------------------ // // 각종 Notify 이벤트 // typedef enum DMC_NOTIFY_Event_t { //--------------------------- //DMC_NOTIFY_QueryChangeTiming = 101, // // DMC 쪽에서 바로 timing을 변경할 것인지를 query 한다. // changeNow 값이 TRUE이면 변경을 한다. // returnTiming 값이 non-NULL이면 app 에서 요구한 그 타이밍을 사용하고, // NULL이면 MW에서 직접 timing을 변경한다. // Parameter: // [0] FormatChangeParam * //DMC_NOTIFY_TimingChangeComplete, // // source format 변경 등의 이유로 resolution 변경이 완료되었다. // // Parameter: // [0] TimingChangeCompleteParam * // DMC_NOTIFY_ScreenAdjustment = 103, // Parameter: // [0] ScreenAdjustmentParam * //--------------------------- DMC_NOTIFY_PATChanged = 201, DMC_NOTIFY_PMTChanged, // Parameter: // [0] PSIChangeNotifyInfo * DMC_NOTIFY_PATChangeError, DMC_NOTIFY_PMTChangeError, DMC_NOTIFY_AllPsiReceived, // 모든 pmt가 다 받아졌음을 알림. // Parameter: // [0] AllPsiRxNotifyInfo * //--------------------------- DMW_NOTIFY_MajorChangeEvent = 211, // Parameter: // [0] MajorChangeEventParam * //--------------------------- DMW_NOTIFY_AudioDecodeStart = 221, // Audio decoding이 시작될 때 call됨. // 아무것도 하지 않으면 디폴트 동작을 함. (Dmc_AudioStart call) // 만약 특정 처리를 하기를 원하면 수행 후에 result를 setting. // Parameter: // [0] AudioDecodeStartParam * DMW_NOTIFY_AudioDecodeStop = 222, // Audio decoding이 끝날때 call됨. // Parameter: // [0] AudioDecodeStopParam * DMW_NOTIFY_SelectAudio = 223, // Audio Program을 선택할 때, // Parameter: // [0] AudioPidSelectParam * DMW_NOTIFY_SelectVideo = 224, // Video Program을 선택할 때, // Parameter: // [0] VideoPidSelectParam * //--------------------------- DMW_NOTIFY_VideoFreezeEndEvent = 231, // Parameter: // [0] BOOL *bProcessed: default is FALSE. // default action is Mute Off. // If you process mute off by yourself, set this flag TRUE. DMW_NOTIFY_AudioInfo = 240, // Parameter: // none DMW_NOTIFY_DecodingPidReady = 241, // Parameter: // [0] DecodingPidReadyParam * // //--------------------------- DMC_NOTIFY_ErrorInVideo = 301, // // Video 관련하여 에러가 발생하여 화면에 문제가 생김. // 사용자의 조작에 의하여 복구가 가능할 수 있음. DMC_NOTIFY_CriticalError, // // 시스템 에러가 발생. // 리부팅이 필요함. //--------------------------- DMC_NOTIFY_CaPmt = 401, // // Channel Tune 혹은 PMT Change 등으로 변경된 PMT를 // Cable Card에 전달해야함 // CableCard가 없는 project에서는 이 이벤트를 처리 하지 않는다. DMC_NOTIFY_IsPodInserted, // // Channel Tune 혹은 PMT Change 등으로 변경된 PMT를 // Cable Card에 전달해야함 // CableCard가 없는 project에서는 이 이벤트를 처리 하지 않는다. } DMC_NOTIFY_Event; #ifdef __DEFINE_DMC_STRING_FN__ // Dmc_Channel_Task.c 에서는 아래 함수를 정의를 하며, 다른 source에서는 선언을 한다. // 구현 (definition)을 이곳에 두는 이유는 enum definition이 이곳에 있기 때문.. const char *Dmc_NotifyEventString(int ev) { return ( //(ev) == DMC_NOTIFY_QueryChangeTiming ? "DnfQueryChangeTiming" : //(ev) == DMC_NOTIFY_TimingChangeComplete ? "DnfTimingChangeComplete" : (ev) == DMC_NOTIFY_ScreenAdjustment ? "DnfScreenAdjust" : (ev) == DMC_NOTIFY_PATChanged ? "DnfPATChanged" : (ev) == DMC_NOTIFY_PMTChanged ? "DnfPMTChanged" : (ev) == DMC_NOTIFY_AllPsiReceived ? "DnfAllPsiRx" : (ev) == DMC_NOTIFY_PMTChangeError ? "DnfPMTChangeError" : (ev) == DMW_NOTIFY_MajorChangeEvent ? "DnfMajorChangeEvent" : (ev) == DMW_NOTIFY_AudioDecodeStart ? "DnfAudioDecodeStart" : (ev) == DMW_NOTIFY_AudioDecodeStop ? "DnfAudioDecodeStop" : (ev) == DMW_NOTIFY_SelectAudio ? "DnfSelectAudio" : (ev) == DMW_NOTIFY_SelectVideo ? "DnfSelectVideo" : (ev) == DMW_NOTIFY_VideoFreezeEndEvent ? "DnfVideoFreezeEndEvent" : (ev) == DMW_NOTIFY_AudioInfo ? "DnfAudioInfo" : (ev) == DMW_NOTIFY_DecodingPidReady ? "DnfDecodingPidReady" : (ev) == DMC_NOTIFY_ErrorInVideo ? "DnfErrorInVideo" : (ev) == DMC_NOTIFY_CriticalError ? "DnfCriticalError" : (ev) == DMC_NOTIFY_CaPmt ? "DnfCaPmt" : (ev) == DMC_NOTIFY_IsPodInserted ? "DnfIsPodInserted" : "Dnf??" ); } #else // 일반 다른 module에서는 선언만 하도록 한다. // const char *Dmc_NotifyEventString(int ev); #endif //------------------------------- // 각종 초기화 및 등록 함수 STATUS Dmc_InitChannelTask(void); void Dmc_EndChannelTask(void); //------------------------------- // 채널 변경 함수 #define ONE_PART_CHANNEL_INDICATOR 1024 // minor 번호 자리에 이 값이 들어 있으면 major의 값을 OnePartChannel 번호로 해석하여 튜닝을 한다. /* major minor +-----------------+ +-----------------+ 0000 0011 1111 xxxx 0000 00xx xxxx xxxx (low 10 bits) nnnn nn nnnn nnnn (total 14 bits, 16383 max) */ #define IsOnePartChannelNumber(major) ((major) >= 0x3f0) #define ConvertToOnePartChannelNumber(major,minor) \ ((((major) & 0x00F)<<10) + ((minor) & 1023)) // ex: // g_UCM[x].Major = ConvertToOnePartChannelNumber(major, minor); // g_UCM[x].Minor = ONE_PART_CHANNEL_INDICATOR; #define ConvertToTwoPartChannelNumber(ch,major,minor) \ (((major) = 0x3f0 + (((ch)>>10) & 0xf)), ((minor) = ((ch) & 0x3ff))) // ex: // ConvertToTwoPartChannelNumber(g_UCM[x].Major, major, minor); // Dmc_ChangeRfChannel(major, minor, ...); // unified access to VCT major/minor, cafrii 040727 add // // example) major = MajorNumberInCVCT(&cvct->channel[0]); // minor = MinorNumberInCVCT(&cvct->channel[0]); // #define MajorNumberInCVCT(ch) (IsOnePartChannelNumber((ch)->major_channel_number) ? \ ConvertToOnePartChannelNumber((ch)->major_channel_number, (ch)->minor_channel_number) : \ (ch)->major_channel_number) #define MinorNumberInCVCT(ch) (IsOnePartChannelNumber((ch)->major_channel_number) ? \ ONE_PART_CHANNEL_INDICATOR : (ch)->minor_channel_number) #define MajorNumberInTVCT(ch) ((ch)->major_channel_number) #define MinorNumberInTVCT(ch) ((ch)->minor_channel_number) #if 0 ____APIs____() #endif #if 0 ____Tune_APIs____() #endif STATUS Dmc_ChangeRfChannelByTuneParam(TuneParam *param, BOOL bWaitForCompletion, void *fn, UINT32 userparam); // // Change channel by tuneParam. STATUS Dmc_ChangeRfChannel(int rf, ModulationType type, BOOL bWaitForCompletion, void *fn, UINT32 userparam); // // Change channel of 'rf' and 'type'. // it works without UCM DB. // tune policy is 'CTF_Automatic' in which mode we scan xVCT -> PSI. // STATUS Dmc_ChangeRfChannel2(int rf, ModulationType type, int pPid, int vPid, int aPid, int major, int minor, int progNumber, BOOL bWaitForCompletion, void *fn, UINT32 userparam); // // STATUS Dmc_ChangeExtInput(tDHL_CapVideoInput video, tDHL_CapAudioInput audio, BOOL bWaitForCompletion); // // change to external input // STATUS Dmc_StopVideo(void); // // Stop All video (and associated audio). // Can be used all channel/input type. (Analog/Digital/1394) STATUS Dmc_RestartVideo(void); STATUS Dmc_FreezeVideo(UINT32 bFreeze, BOOL bWaitComplete); STATUS Dmc_HideVideo(UINT32 bHide, BOOL bWaitComplete); STATUS Dmc_ChangeAudioStream(UINT32 audioPID, UINT32 pcrPID, tDHL_AudioCodingType audioType); // cafrii 070412 add more arguments STATUS Dmc_EnqueueDPC(DMC_FN_DPC dpcfn, UINT32 param1, UINT32 param2, UINT32 param3, UINT32 param4, BOOL bWaitComplete); BOOL Dmc_CheckCancel(void); // // Check if current message (TRUE returned if cancelled) // // this function is useful in APP callback task. // App can use this function to check current msg is cancelled or not. // // NOTE! Do not call this function in arbitrary task except DMC task. // If called from arbitrary task, it will return FALSE. //------------------------------- // Utility functions #define AuxVideoSetting void* STATUS Dmc_ChangeDisplay(VOUT_COLOR color, VOUT_FORMAT format, VOUT_RATIO ratio, tDHL_DispARC ScrAdj, AuxVideoSetting AuxType); // // Changes display and timing. // 'color', 'format', 'Ratio_4x3' is one of VOUT_XXX constants. // 'ScrAdj' is one of tDHL_DispARC enumeration values. // default value is DEFAULT_ADJUSTMENT. // If invalid adjustment option is used, default value will be used instead. // 'AuxType' is one of VAUX_XXX constants. // // This function is working synchronously. STATUS Dmc_ChangeVideoAdjustment(tDHL_DispARC adj_hd, tDHL_DispARC adj_sd); //-------- // Following functions are convenient functions to use Dmc_ChangeDisplayEx. // int Dmc_WhichATSCFormat(tDHL_VideoSeqHdr *seq); // // This function find out which ATSC format current input MPEG stream belongs to. // It returns the stream number of ATSC Sarnoff 36 stream. DHL_OS_TASK_ID Dmc_GetCurrentTaskID(void); // // Get Current Task ID. BOOL Dmc_IsDmcTask(void); // // Return TRUE if current task is DMC task tDHL_TSD *Dmc_GetCurrentTsd(void); // // Get Current active TSD. DMC_FN_NOTIFY Dmc_RegisterNotificationCallback(DMC_FN_NOTIFY callback); // notification callback. // 각종 변경 정보가 발생하면 callback을 call한다. // unregister하려면 NULL을 지정. void DMC_RegisterVideoCallback(BOOL bset); // video관련 callback의 설정/해지를 위한 함수 // autoscan할 때 불필요한 callback이 호출되어서 발생할 수 있는 문제를 차단함 UINT32 Dmc_GetSystemRunningTime(void); // cafrii 060720 add STATUS Dmc_ChangeAudioStream(UINT32 audioPID, UINT32 pcrPID, tDHL_AudioCodingType audioType); //cafrii 070830 add // // restart audio only. STATUS Dmc_ChangeVideoStream(UINT32 videoPID, UINT32 pcrPID, tDHL_VideoCodingType videoType); //cafrii 070830 add. // // restart video only. //----------------------------------------------------------------- #if 0 ____ChannelAV____() #endif // Dmc_ChannelAV.c //------------------------------ // PSI 정보 참조 //extern MPEG_PAT *dmc_pat; //extern MPEG_PMT *dmc_pmt; //void Dmc_LockPsiMutex(BOOL bLock); // Rule about psi table access: // 1. dmc_pat/dmc_pat를 참조하는 모든 임의의 태스크는 lock 된 상태에서 접근해야 한다. // 2. DMC 태스크는 dmc_pat/dmc_pat를 변경할 경우 lock 된 상태에서 변경해야 한다. // 3. dmc_p?tPsiCtl은 read only용도로만 사용하여야 하며, // 4. 역시 참조를 하기 위해서는 lock된 상태에서 접근해야 한다. ProgramAVInfo *Dmc_LockAVMutex(void); void Dmc_UnlockAVMutex(void); void Dmc_GetCurrentProgramInfo(ProgramAVInfo *program); // 현재 시청중인 화면이 정보. // 특히 RF로 튜닝한 경우 어떤 상태인지 아는데 유용하다. int Dmc_GetCurrentProgramNumber(void); // 현재 시청중인 program number를 리턴. // ProgramInfo에 있는 값과는 약간 다를 수 있다. // ProgramInfo에 있는 값들은 모두 마지막으로 Decoding이 동작하였을 시점에서의 값이며, // Dmc_GetCurrentProgramNumber()가 리턴하는 값은 현재의 program_number이다. // 만약 현재 Video가 Stop 상태라면, program_number는 디폴트 값(-1)을 리턴한다. BOOL Dmc_GetVideoSequenceHeader(tDHL_VideoSeqHdr *seq); // // Get Current sequence header. // Return FALSE if Sequence header is not available now. #if !USE_EPG_MW_PSI_DOWNLOAD STATUS Dmc_PausePsiMonitor(UINT32 bPause); // // Pause/Resume PSI monitor (PAT, PMT) // // If this function is called in DMC callback task, // 'bWaitCompletion' is ignored and working synchronously. #endif void Dmc_PrintProgramInfo(int dbglevel); DMC_FN_NOTIFY Dmc_RegisterDecodeStartCallback(DMC_FN_NOTIFY callback); // 1394 PTS set callback // callback의 param1은 program_number, param2는 bIgnoredInDmc.. // PMT가 새로 수신될 때마다 불리는 callback DMC_FN_NOTIFY Dmc_RegisterDecodeStopCallback(DMC_FN_NOTIFY callback); // VideoStop이 될때마다 불리는 callback // 현재 argument는 모두 undefined void Dmc_RegisterChannelSymbols(void); #ifdef __cplusplus } #endif #endif // DMW_CHANNEL_H /******************************************************************** 1.06 2005/4/15 timeout variables extern 1.05 2005/3/28 DMW_HAL_AfcSearchMultiple 에 timeout param 추가 1.04 2005/3/16 NtscFreqOffset->freqOffset 이름 변경 NTSC FineTune을 위한 FreqTuneMode 추가 1.03 2004/12/06 DMW_HAL_TunerSetFrequency 추가 1.02 2004/12/02 CTF_SkipPrescanPidInfo 추가 1.01 2004/12/01 AppBannerParam에 program number 추가 1.00 2004/11/? History 관리 시작 040831 add CTF_TunerSetOnly 040528 add EnqueDPC add userparam in channelTuneCallback move ChannelDemux APIs to its own header dmc_p?tPsiCtl export 040114 add flag of hidden channel processing ********************************************************************/