/******************************************************************* * DMW_ChannelHAL.c * * * * Copyright 2003 Digital STREAM Technology, Inc. * All Rights Reserved * * $Id: DMW_ChannelHAL.c,v 1.0 2003/01/00 who Exp $ * ********************************************************************/ #include "DMW_Platform.h" #include "DHL_OSAL.h" #include "DHL_FE.h" #include "DHL_DBG.h" #include "DMW_Config.h" #include "DMW_DebugUtil.h" // MW files #include "DMW_Channel.h" #include "DMW_Status.h" #include "DMW_Mutex.h" DHL_MODULE("$chh", 0); //------------------------------------------------------------------- // // Define constant // //#define USE_DHL_API 1 //------------------------------------------------------------------- // // Global variables // //#define USE_DETAIL_TUNE_API 1 // // RF 번호를 이용한 Tuning을 하는게 아니라 직접 주파수 값을 이용하여 Tuning을 한다. // 앞으로는 모두 이 방식을 사용할 것이다. // 테스트, 검증이 끝나기 전까지는 일단 예전 코드 (0) 부분을 유지한다. // 적당한 시점에서 미사용 코드 삭제 예정.. // //-------------- // 채널 타입 // ChannelType g_CurChannelType = ChannelType_Air; // // 현재 채널 유형. 0: AIR, 1: Cable // Air와 Cable이 공존할 수는 없다. (하나의 RF 번호를 놓고 해석 방법이 달라지므로..) // // 이 변수를 직접 수정하지 않도록 한다. // const type이므로 일반적인 방법으로는 수정할 수 없다. // 꼭 초기화 함수를 이용해야 한다. // // cafrii, 030323 // compiler의 optimization 문제로 const를 다시 삭제함. //-------------- // 주파수 표준 tDHL_FreqStd g_CableSystem = eDHL_FREQ_AIR; // // 현재 사용중인 주파수 표준 // // 이 값은 지상파, 또는 케이블 시스템을 결정하는 값이므로 케이블 채널 테이블을 선택하는 기준이 된다. // 또한, 이 값은 NVM에 저장되어야 한다. (Application 몫) // //------------------------------------------------------------------- // // Tuner Resource Lock Semaphores // // Mutex = { SemID, Owner, lockCnt, FailCnt, UseOsMutex, Name, flag, traceLvl } // DMW_MUTEX tunerMutex = { 0, 0, 0, 0, FALSE, "TunerMtx", OS_SEM_FIFO, FALSE, }; static void dmw_tuner_lock_sema4(BOOL bLock) { if (bLock) DMW_LockMutex(&tunerMutex); else DMW_UnlockMutex(&tunerMutex); } #if 0 _______________() #endif ModulationType DMW_HAL_TunerDemod2Modulation(tDHL_Demod demod) { ModulationType mode; mode = demod == eDHL_DEMOD_NTSC ? Modulation_NTSC : demod == eDHL_DEMOD_8VSB ? Modulation_8VSB : demod == eDHL_DEMOD_64QAM? Modulation_64QAM : demod == eDHL_DEMOD_256QAM ? Modulation_256QAM : demod == eDHL_DEMOD_QAM_AUTO ? Modulation_QAM : demod == eDHL_DEMOD_AUTODETECT ? Modulation_CableAuto : Modulation_Invalid; return mode; } tDHL_Demod DMW_HAL_Modulation2TunerDemod(ModulationType mode) { tDHL_Demod demod; demod = mode == Modulation_NTSC ? eDHL_DEMOD_NTSC : mode == Modulation_8VSB ? eDHL_DEMOD_8VSB : mode == Modulation_64QAM ? eDHL_DEMOD_64QAM : mode == Modulation_256QAM ? eDHL_DEMOD_256QAM : mode == Modulation_QAM ? eDHL_DEMOD_QAM_AUTO : mode == Modulation_CableAuto ? eDHL_DEMOD_AUTODETECT : eDHL_DEMOD_INVALID; return demod; } #if 0 _______________() #endif // cafrii 060630 add // 마지막 RF/Modulation 값을 기억한다. // Modulation 값은 언제든지 읽어올 수 있으므로 그렇게 큰 필요는 없다. // int g_TunerRf; ModulationType g_TunerModulation; BOOL DMW_HAL_DetectAnalogVideoChannel() { DHL_RESULT dhlResult; UINT8 Lock; tDHL_Demod demod; dhlResult = DHL_FE_GetLockStatus(DEFAULT_TUNER_ID, &Lock, &demod); return (dhlResult==DHL_OK && Lock) ? TRUE : FALSE; } // import from UCM.c // Freq Standard 관련 기능은 Channel DB와는 독립적인 하위 기능이므로 분리해서 // Tuner HAL과 같이 관리한다. // STATUS DMW_HAL_SetChannelStandard(tDHL_FreqStd nFreqStd) { // 현재가 Air 모드이면 무시. // // Cable System이 이미 'system'이라면 무시.. // // 서로 다른 CableSystem으로 설정되면 현재 DB가 의미가 없어지므로 다 지우는게 맞겠지만, // Application이 알아서 하도록 한다. dprint(2, " frequency std set to %d, %s\n", nFreqStd, FreqStdString(nFreqStd)); if (nFreqStd != eDHL_FREQ_STD&& nFreqStd != eDHL_FREQ_IRC&& nFreqStd != eDHL_FREQ_HRC) nFreqStd = eDHL_FREQ_AIR; // Air가 기본.. // cafrii 060630 add // system이 변경되면 last tune info를 reset시킨다. // if (g_CableSystem != nFreqStd) { g_CableSystem = nFreqStd; dprint(2, " reset tuner info\n"); g_TunerRf = 0; g_TunerModulation = Modulation_Invalid; } // 이제 실제 Driver layer에 설정을 한다. // // DHL_FE_SetChannelStandard(DEFAULT_TUNER_ID, nFreqStd); if (g_CableSystem == eDHL_FREQ_AIR) g_CurChannelType = ChannelType_Air; else g_CurChannelType = ChannelType_Cable; return statusOK; } //------------------------------------------- // DMW_HAL_TunerScanSetChannel // // // STATUS DMW_HAL_TunerScanSetChannel(UINT32 ch, ModulationType type, INT32* pOffset, FreqTuneMode mode, BOOL (*chkfn)()) { STATUS nReturn = statusOK; UINT32 frequency; UINT32 new_freq; INT32 offset; DHL_RESULT dhlResult; tDHL_Demod demod; if (pOffset == NULL) return statusInvalidArgument; demod = DMW_HAL_Modulation2TunerDemod(type); if (demod == eDHL_DEMOD_INVALID) return statusInvalidArgument; offset = *pOffset; // offset 값은 caller가 지정한 frequency offset 이며, 이 값을 최대한 존중하여 튜닝을 한다. // // Tuning 모드에 따라서 내부적으로 auto-search 과정을 수행, 다른 주파수가 새로 발견될 수 있는데, // 이때 발견된 frequency offset은 *pOffset에 다시 저장되어 리턴된다. // dmw_tuner_lock_sema4(TRUE); //---------------------- Air (Terrestrial) --------------------- // if (g_CurChannelType == ChannelType_Air) { DMW_HAL_SetChannelStandard(eDHL_FREQ_AIR); frequency = FindCenterFrequency(ch, offset, eDHL_FREQ_AIR); if (frequency == 0) { dprint(0, "!! center frequency of rf %d, offset %d err\n", ch, offset); nReturn = statusInvalidArgument; goto label_exit; } dprint(2, "SetTuner, AIR, %s, rf %d, offset %d, freq %dKHz\n", ServiceTypeString(type), ch, offset, frequency/1000); if (type == Modulation_NTSC) { // NTSC의 경우에는 실제로 검색된 frequency offset을 pOffset을 이용해서 넘겨줘야 한다. // 만약 측정이 불가능할 경우라면 그냥 caller가 제시한 offset을 그대로 사용한다. // if (mode == FREQTUNE_SHORT_SEARCH) { dprint(2, " short search: AFC (%dKHz)\n", frequency/1000); new_freq = DMW_HAL_AfcSearchMultiple(1, &frequency, 0, NULL); // 새로운 frequency가 발견되었으면 변경된 만큼 offset을 다시 조정. // if (new_freq && new_freq != frequency) { *pOffset = *pOffset + (new_freq - frequency); dprint(2, " frequency adjusted to %dKHz, new offset %dKHz\n", new_freq/1000, (*pOffset)/1000); } } else // FREQTUNE_FIXED 모드 { dprint(2, " fixed mode: DHL_FE_Start (%dKHz, NTSC)\n", frequency/1000); // FREQTUNE_FIXED에는 그냥 caller가 제시한 주파수로 try를 한번 한다. // pOffset 을 통해 새롭게 리턴되는 값은 없다.. dprint(2, " DHL_FE_Start (%dKHz, NTSC)\n", frequency/1000); dhlResult = DHL_FE_Start(DEFAULT_TUNER_ID, frequency/1000, eDHL_DEMOD_NTSC, NULL); // cafrii 070710 cancel bugfix //nReturn = dhlResult ? statusError : statusOK; nReturn = dhlResult == DHL_FAIL_CANCELLED_BY_USER ? statusCancelled : dhlResult ? statusError : statusOK; } } else if (type == Modulation_8VSB) { dprint(2, " DHL_FE_Start (%dKHz, VSB)\n", frequency/1000); dhlResult = DHL_FE_Start(DEFAULT_TUNER_ID, frequency/1000, eDHL_DEMOD_8VSB, NULL); // cafrii 070710 cancel bugfix //nReturn = dhlResult ? statusError : statusOK; nReturn = dhlResult == DHL_FAIL_CANCELLED_BY_USER ? statusCancelled : dhlResult ? statusError : statusOK; } else { dprint(0, "!! unknown service type %d in Air channel.\n", type); nReturn = statusInvalidArgument; // No QAM allowed!!!! } } //---------------------- Cable (STD/HRC/IRC) ------------------------- else { DMW_HAL_SetChannelStandard(g_CableSystem); frequency = FindCenterFrequency(ch, offset, g_CableSystem); if (frequency == 0) { dprint(0, "!! center frequency of rf %d, offset %d err\n", ch, offset); nReturn = statusInvalidArgument; goto label_exit; } dprint(2, "SetTuner, CABLE %s, %s, rf %d, offset %d, freq %dKHz\n", (g_CableSystem == eDHL_FREQ_IRC) ? "IRC": (g_CableSystem == eDHL_FREQ_HRC) ? "HRC" : "STD", ServiceTypeString(type), ch, offset, frequency/1000); if (type == Modulation_NTSC) { if (mode == FREQTUNE_SHORT_SEARCH) { dprint(2, " short search: AFC (%dKHz)\n", frequency/1000); new_freq = DMW_HAL_AfcSearchMultiple(1, &frequency, 0, NULL); // 새로운 frequency가 발견되었으면 변경된 만큼 offset을 다시 조정. // if (new_freq && new_freq != frequency) { *pOffset = *pOffset + (new_freq - frequency); dprint(2, " frequency adjusted to %dKHz, new offset %dKHz\n", new_freq/1000, (*pOffset)/1000); } } else // FREQTUNE_FIXED 모드 { dprint(2, " fixed mode: DHL_FE_Start (%dKHz, NTSC)\n", frequency/1000); // DHL 내부에서 적절한 standard로 바뀐다. // 만약 application option에 따라 standard가 변경되어야 한다면 // 별도의 DHL API를 이용하여 preset을 해야 한다. 현재 그 기능은 미구현. dhlResult = DHL_FE_Start(DEFAULT_TUNER_ID, frequency/1000, eDHL_DEMOD_NTSC, NULL); // cafrii 070710 cancel bugfix //nReturn = dhlResult ? statusError : statusOK; nReturn = dhlResult == DHL_FAIL_CANCELLED_BY_USER ? statusCancelled : dhlResult ? statusError : statusOK; } } else { dprint(2, " DHL_FE_Start (%dKHz, %s)\n", frequency/1000, ServiceTypeString(type)); dhlResult = DHL_FE_Start(DEFAULT_TUNER_ID, frequency/1000, demod, NULL); // cafrii 070710 cancel bugfix //nReturn = dhlResult ? statusError : statusOK; nReturn = dhlResult == DHL_FAIL_CANCELLED_BY_USER ? statusCancelled : dhlResult ? statusError : statusOK; } } label_exit: // cafrii 060630 add // 항상 tuner의 마지막 상태를 tracking 하도록 한다. // 나중에 lock check, 또는 mod check를 할 때 g_TunerModulation은 결정된다. if (nReturn == statusOK) g_TunerRf = ch; else g_TunerRf = 0; // analog의 경우는 별도로 lock check를 안하는 경우도 있기 때문에 // PLL 설정만 성공하면 NTSC 모드라고 본다. // if (nReturn == statusOK && type == Modulation_NTSC) g_TunerModulation = Modulation_NTSC; else g_TunerModulation = Modulation_Invalid; dmw_tuner_lock_sema4(FALSE); return nReturn; } //------------------------------------------- // DMW_HAL_TunerSetChannel // // // STATUS DMW_HAL_TunerSetChannel(UINT32 ch, ModulationType type, INT32 offset, FreqTuneMode mode, BOOL (*chkfn)()) { STATUS status; status = DMW_HAL_TunerScanSetChannel(ch, type, &offset, mode, chkfn); return status; } //------------------------------------------- // DMW_HAL_TunerSetFrequency // // // cafrii 041206 add for cable system autodetect feature.. // // cafrii 061221, analog fine tune is not supported in this function // STATUS DMW_HAL_TunerSetFrequency(UINT32 freqInKHz, ModulationType mode, BOOL (*chkfn)()) { DHL_RESULT dhlResult; tDHL_Demod demod; demod = DMW_HAL_Modulation2TunerDemod(mode); // report 전용인 값들은 사용 불가. // if (demod == eDHL_DEMOD_INVALID) { dprint(0, "!! invalid modtype %d (%s)\n", mode, ServiceTypeString(mode)); return statusInvalidArgument; } g_TunerRf = 0; // cafrii 060714 add bugfix! // DEMOD_AUTO_DETECT 가 아닌 이상 check fn은 별로 필요하지는 않다. // dhlResult = DHL_FE_Start(DEFAULT_TUNER_ID, freqInKHz, demod, NULL); // cafrii 070710 cancel bugfix //return (dhlResult==DHL_OK ? statusOK : statusError); return (dhlResult == DHL_FAIL_CANCELLED_BY_USER ? statusCancelled : dhlResult ? statusError : statusOK); } BOOL DMW_HAL_DetectNIMChannel() { DHL_RESULT dhlResult; UINT8 Lock; tDHL_Demod demod; dhlResult = DHL_FE_GetLockStatus(DEFAULT_TUNER_ID, &Lock, &demod); // cafrii 060630 add, tuner status tracking.. if (dhlResult == DHL_OK && Lock) { g_TunerModulation = DMW_HAL_GetModulationMode(); return TRUE; } else { g_TunerModulation = Modulation_Invalid; return FALSE; } } int DMW_HAL_GetSignalStrength() { DHL_RESULT dhlResult; int str; dhlResult = DHL_FE_GetSignalStrength(DEFAULT_TUNER_ID, (UINT32 *)&str); if (dhlResult) str = 0; return str; } float DMW_HAL_GetSNR() { DHL_RESULT dhlResult; float snr; UINT32 snr1000; dhlResult = DHL_FE_GetSignalStatus(DEFAULT_TUNER_ID, eDHL_SIGNAL_SNR2, &snr1000); if (dhlResult) snr = 0.; else snr = snr1000/1000.; return snr; } // cafrii 060630 add int DMW_HAL_GetCurrentRF(void) { return g_TunerRf; } void DMW_HAL_ResetLastRF(void) { g_TunerRf = 0; } ModulationType DMW_HAL_GetModulationMode() { DHL_RESULT dhlResult; tDHL_Demod demod; ModulationType mod; dhlResult = DHL_FE_GetModFormat(DEFAULT_TUNER_ID, &demod); // cafrii 060630, add tuner status tracking.. if (dhlResult) { g_TunerModulation = Modulation_Invalid; return Modulation_Invalid; } if (0); else if (demod == eDHL_DEMOD_NTSC) mod = Modulation_NTSC; else if (demod == eDHL_DEMOD_8VSB) mod = Modulation_8VSB; else if (demod == eDHL_DEMOD_64QAM) mod = Modulation_64QAM; else if (demod == eDHL_DEMOD_256QAM) mod = Modulation_256QAM; else if (demod == eDHL_DEMOD_QAM_AUTO) mod = Modulation_64QAM; // 사실 이런게 나오면 안됨.. else mod = Modulation_Invalid; g_TunerModulation = mod; return mod; } // not tested yet.. // int DMW_HAL_SetTunerLockTimeout(int vsb, int q64, int q256, int ntsc) { // 단위는 0.1 초 // cafrii 050413 // 이 함수는 더이상 동작하지 않는다.. // /// int vsbTimeout, int qam64Timeout, int qam256Timeout, int ntscTimeout ) //DD_SetLockTimeout(vsb, q64, q256, ntsc); return statusOK; } //--------------------------------------------------------------------------- // DMW_HAL_AfcSearchMultiple // // // 지정한 주파수 영역에서 아날로그 신호 검색을 하여 발견된 주파수를 리턴한다. // // 드라이버에서 AFC 기능이 지원되지 않으면 직접 Lock check API를 이용해서 // Lock 여부로 판단한다. timeoutTick 값은 이 경우에만 사용이 되며, // timeout으로 0의 값을 지정할 경우 각 Frequency 별로 1회만 체크한다. // STATUS DMW_HAL_AfcSearchMultiple(int nFreq, UINT32 *aFreq, int timeoutTick, BOOL (*ckfn)()) { // cafrii 050328 add timeoutTick param. // // 함수 인자의 주파수 단위는 Hz. #if SUPPORT_NTSC_FINE_TUNE int i; UINT32 f2 = 0; AFC_SearchStart(gTuner); for (i=0; i (unsigned int)timeoutTick) break; // 다음 주파수로 다시 시도.. if (ckfn && ckfn()) { f2 = 0; dprint(2, "afc search cancelled\n"); goto label_exit; } DHL_OS_Delay(100); } // 다음 주파수로 다시 시도.. dprint(3, " freq[%d] %dkHz not locked. %s\n", i, aFreq[i]/1000, i==nFreq-1 ? "" : "try next.."); } f2 = 0; label_exit: dmw_tuner_lock_sema4(FALSE); return f2; #endif // SUPPORT_NTSC_FINE_TUNE } #if 0 _____Fdc_Tune___() #endif //------------------- // Driver function // STATUS DMW_HAL_FdcTune(unsigned long ulFrequency, unsigned short usBitRate, int nSpectrumInversion ) { #if SUPPORT_FDC_TUNER int err; dprint(1, "DMW_HAL_FdcTun(freq %d, bitrate %d, spectrum_inv %d\n", ulFrequency, usBitRate, nSpectrumInversion); err = FDC(ulFrequency/1000, usBitRate, nSpectrumInversion); if (err) { dprint(0, "!! FDC err %d\n", err); } return err; #else return statusNotImpl; #endif } int DMW_HAL_GetFDCLockStatus() { #if SUPPORT_FDC_TUNER return GetFDCLockStatus(); #else return 0; #endif } int DMW_HAL_GetFDCSignalStrength() { #if SUPPORT_FDC_TUNER return GetFDCSignalStrength(); #else return 0; #endif } float DMW_HAL_GetFDCSNR() { #if SUPPORT_FDC_TUNER return (float) GetFDCSNR(); #else return 0; #endif } #if 0 ________________() #endif #if DMW_REGISTER_DEBUG_SYMBOL static DHL_SymbolTable ChannelHalSymbols[] = { //---- functions DHL_FNC_SYM_ENTRY(DMW_HAL_SetChannelStandard), DHL_FNC_SYM_ENTRY(DMW_HAL_TunerSetChannel), DHL_FNC_SYM_ENTRY(DMW_HAL_GetSignalStrength), DHL_FNC_SYM_ENTRY(DMW_HAL_GetModulationMode), //---- variables //DHL_VAR_SYM_ENTRY(g_Trace_ChannelHAL), }; #endif // DMW_REGISTER_DEBUG_SYMBOL void DMW_HAL_RegisterChannelHalSymbols() { #if DMW_REGISTER_DEBUG_SYMBOL DHL_DBG_RegisterSymbols(ChannelHalSymbols, DHL_NUMSYMBOLS(ChannelHalSymbols)); #endif } #if 0 ________________() #endif #if 0 int gSignalLockTimeoutInTick = 60; void TestSetFreq(UINT32 freq) { int err, ret; UINT32 tickStart; dmw_tuner_lock_sema4(TRUE); // DMW_HAL_ChangeFrequencyStandard(0); // FREQ_AIR // DMW_HAL_ChangeFrequencyStandard(1); // FREQ_STD // shell 에서 테스트 하려면 위와 같이 먼저 설정을 한 다음에 실행..... OS_DbgPrintf("Set Frequency: %d KHz\n", freq); OS_DbgPrintf("** try 8VSB..\n"); err = TunerSetFrequency(gTuner, freq, DEMOD_8VSB); tickStart = DHL_OS_GetMsCount(); while (DHL_OS_GetMsCount() - tickStart < gSignalLockTimeoutInTick) { ret = GetLockStatus(); if (ret) goto labe_done; DHL_OS_Delay(1000/20); } OS_DbgPrintf("** try 64QAM..\n"); err = TunerSetFrequency(gTuner, freq, DEMOD_64QAM); tickStart = DHL_OS_GetMsCount(); while (DHL_OS_GetMsCount() - tickStart < gSignalLockTimeoutInTick) { ret = GetLockStatus(); if (ret) goto labe_done; DHL_OS_Delay(1000/20); } OS_DbgPrintf("** try 256QAM..\n"); err = TunerSetFrequency(gTuner, freq, DEMOD_256QAM); tickStart = DHL_OS_GetMsCount(); while (DHL_OS_GetMsCount() - tickStart < gSignalLockTimeoutInTick) { ret = GetLockStatus(); if (ret) goto labe_done; DHL_OS_Delay(1000/20); } OS_DbgPrintf("!! signal not locked\n"); dmw_tuner_lock_sema4(FALSE); return; labe_done: dmw_tuner_lock_sema4(FALSE); OS_DbgPrintf("signal locked.\n"); if (1) { int str = DMW_HAL_GetSignalStrength(); float snr = DMW_HAL_GetSNR(); OS_DbgPrintf("signal strength: %d, SNR: %.3f\n", str, snr); } } #endif //0 /******************************************************************** $Log: DMW_ChannelTune.c,v $ 1.30 2005/3/28 DMW_HAL_AfcSearchMultiple에 timeout param 추가 1.29 2005/3/25 DMW_HAL_AfcSearchMultiple API를 AFC 없이도 사용가능하도록 수정 1.28 2005/1/26 ScanSetChannel 에서 무조건 STDCable로 설정하는 예전 방식 수정 Mocha를 제외한 다른 platform 더이상 지원하지 않음. ScanSetChannel/SetChannel prototype 변경 (함수 인자 변경) ScanSetChannel 함수로 통합. 아날로그 carrier search를 위한 DMW_HAL_AfcSearchMultiple 추가 잠정적으로 USE_DETAIL_TUNE_API 사용. 나중에는 이 플래그로 고정할 것임 디버그 메시지 출력에 debug level 지원 FDC쪽 사용하지 않는 코드들 모두 제거 전체 구조 및 거의 모든 내용 수정.. 1.27 2004/12/09 DMW_HAL_TunerSetChannel: dprint bugfix 1.26 2004/12/06 DMW_HAL_TunerSetFrequency 추가 1.25 2004/11/22 DMW_HAL_GetModulationMode 의 임시 코드 수정. 1.24 2004/11/10 FDC API 추가 1.23 2004/11/4 TunerSetChannelEx 드라이버 함수 사용 HAL api prototype 수정 1.22 2004/9/20 DMW_Config 도입, config 사항 이동 1.21 2004/9/3 g_Trace_TunerSema4 position moved 1.2 2004/8/30 ChannelType, FreqStd imported from ChannelAPI TuneChannelByUid is moved to UCM module 1.1 2004/7/26 auto fine tune *offset reset bug fix SUPPORT_NTSC_FINE_TUNE and related var added 1.0 2003/0/0 Initial coding from ___, based on M/W API document ********************************************************************/