source: svn/newcon3bcm2_21bu/dst/app/src/Function/App_Fnc_ChTune.h

/****************************************************************************
* NAME: App_Fnc_ChTune.h
*----------------------------------------------------------------------------
* Copyright (c) DIGITAL STREAM Technology Inc.
*----------------------------------------------------------------------------
* CREATED_BY: Chan Hun Jeon 
* CREATION_DATE: 2009/09/02
* $Author: chjeon $
* $Revision: 1.1 $
* $Date: 2009/07/08 15:08:26 $
*----------------------------------------------------------------------------
* PURPOSE:
* - Channel tuning API (Chup, Chdown, Major-Minor tune, RF-tune)
*****************************************************************************/

#ifndef __APP_FNC_CHTUNE_H__
#define __APP_FNC_CHTUNE_H__

/*_____ I N C L U D E __________________________________________*/






#if COMMENT
____Overview____(){}
#endif

/* 
        Channel Tuning Module
        - UID tune
        - Channel Up/Down 
        - Major-minor tune (RF tune Æ÷ÇÔ) 
        - Stop TV 
        - Prev Channel 
        - Recovery last channel

        Dependencies 
        - Channel MW
        - CC MW 
        - App_Fnc_EA 
        - App_Fnc_SignalMonitor
        - App_Fnc_Security
        - App_Fnc_DigitKeyProc
        - App_Fnc_Rating
        - App_Fnc_NvRam
        - App_Fnc_EPG
*/





/*_____ D E F I N I T I O N ____________________________________*/

#if COMMENT
____Config____(){}
#endif

#define DST_CHANNELBANNER_ERASE_DELAY 4000
        //
        //  Channel Banner Ç¥½Ã À¯Áö ±â°£..

#define DELETE_CHBANNER_AFTER_TUNNING           0
        //      iskang 070830.
        // channel banner¸¦ Áö¿ï ¶§ ¹«Á¶°Ç 5Ãʸ¦ ÁÖÁö ¾Ê°í 
        // tunningÀÌ ¼º°ø¸¦ Çϸé tunnig 2ÃÊ ÈÄ¿¡, ½ÇÆи¦ ÇÏ¸é ¹Ù·Î Áö¿î´Ù.
        // ³ªÁß¿¡ Áö¿ì´Â ½Ã°£ÀÌ ³Ê¹« ª´Ù°í »ý°¢ÀÌ µÇ¸é api¸¦ Ãß°¡ÇÏÀÚ..

#define APP_CHTUNE_AIR_RF_MIN 2
#define APP_CHTUNE_AIR_RF_MAX 51 //69
#define APP_CHTUNE_AIR_RF_DEFAULT 2

#define APP_CHTUNE_CABLE_RF_MIN 1
#define APP_CHTUNE_CABLE_RF_MAX 135
#define APP_CHTUNE_CABLE_RF_DEFAULT 1

#define IS_VALID_RF(type, rf) ( \
        ((type) == ChannelType_Air && (rf) >= APP_CHTUNE_AIR_RF_MIN && (rf) <= APP_CHTUNE_AIR_RF_MAX) || \
        ((type) == ChannelType_Cable && (rf) >= APP_CHTUNE_CABLE_RF_MIN && (rf) <= APP_CHTUNE_CABLE_RF_MAX))

#define APP_QUICKSCAN_TYPE_STR(t) ( \
                (t) == APP_QUICKSCAN_DRF ? "DRF" : \
                (t) == APP_QUICKSCAN_SIGMON ? "SIGMON" : "?")

#define APP_UID_TUNE_FLAG_STR(f) ( \
                (f) == APP_UID_TUNE_DONT_STOP_PREV ? "DontStopPrev" : \
                (f) == APP_UID_TUNE_SKIP_BANNER ? "SkipBanner" : \
                (f) == APP_UID_TUNE_INCLUDE_HIDDEN ? "IncludeHdn" : \
                (f) == APP_UID_TUNE_FROM_SIGMON ? "FromSigMon" : \
                (f) == APP_UID_TUNE_DONT_SAVE_PREV ? "DontSavePrev" : \
                "?")





#if COMMENT
____Types____(){}
#endif

// cafrii 060608 add tuning method
// TuneCallback¿¡ userParamÀ¸·Î Àü´ÞµÊ. Áï Tuning ÇÔ¼ö¿¡ ÀÌ Ç÷¡±× Áß Çϳª¸¦ ÁöÁ¤ÇØ¾ß ÇÔ.
//   ÇÏÀ§ 16 bit´Â ¾Æ·¡ METHOD »ó¼ö,
//   »óÀ§ 16 bit´Â °¢ Method º°·Î parameterÀÌ´Ù.
//
typedef enum
{
        APP_TUNE_UID,  // uid¿¡ ÀÇÇØ Æ©´×µÈ °æ¿ì. »óÀ§ 16bit¸¦ »ç¿ëµÈ UID°ªÀ¸·Î °°ÀÌ ³Ñ±ä´Ù.
        APP_TUNE_DRF,
        APP_TUNE_DRF_PN,
        
        APP_TUNE_SIGMON, // tune by Signal Monitor
        APP_TUNE_EA,  // tune by EA force tune

} APP_TUNE_METHOD;

// cafrii 060804 add   quick scan Á¾·ù.
typedef enum
{
        APP_QUICKSCAN_DRF = 0,
        APP_QUICKSCAN_SIGMON = 1,

} APP_QUICKSCAN_TYPE;


// cafrii 060804 add
//  Uid tune¿¡¼­ »ç¿ë °¡´ÉÇÑ flag.
//  bit flagÀ̹ǷΠÁ¶ÇÕÇؼ­ »ç¿ë °¡´ÉÇÏ´Ù.
typedef enum 
{
        APP_UID_TUNE_NORMAL = 0,
        APP_UID_TUNE_DONT_STOP_PREV = 1, // ÇöÀç ¹Ì»ç¿ë.
        APP_UID_TUNE_SKIP_BANNER = 2,
        APP_UID_TUNE_INCLUDE_HIDDEN = 4,

        APP_UID_TUNE_FROM_SIGMON = 8,

        APP_UID_TUNE_DONT_SAVE_PREV = 0x10, // ÀÌÀü ä³Î ÀúÀåÇÏÁö ¾Ê´Â ¿É¼Ç.

} APP_UID_TUNE_FLAG;


/* Comment : DST_CURCHANNEL Àº App_UCMÀ¸·Î À̵¿ÇÔ
        App Fnc °£ÀÇ °èÃþÈ­¸¦ À§Çؼ­ÀÓ
*/


typedef enum
{
        APP_CH_SORT_CH_NUM=0,
        APP_CH_SORT_GROUP=1,
        APP_CH_SORT_NUMBER
} tAppChSortMode;
/* channel sort mode..APP_CH_SORT_GROUP means 1) HD 2) SD 3) Audio Only 
*/





#if COMMENT
____Variables____(){}
#endif

extern STATUS g_App_LastTuneResult;
        // °¡Àå ¸¶Áö¸· Æ©´× »óÅÂ.





#if COMMENT
____NvParam____(){}
#endif

typedef struct
{
        UINT8 nChannelType;   // 0: Air, 1: CableSTD

        // Air RF & Pn
        UINT8 Air_RF;
        UINT32 Air_Pn;
        
        // Cable RF & Pn
        UINT8 Cable_RF;
        UINT32 Cable_Pn;

        // Card OOB »óÅ¿¡¼­ÀÇ ¸¶Áö¸· ½Ãû ä³Î 
        UINT8 Oob_RF;
        UINT32 Oob_Pn;
        
} nvparam_chtune;





/*_____ F U N C T I O N ________________________________________*/

#if COMMENT
____Function____(){}
#endif

//int App_FindChannelToShow(int nUid, int *uidBuf, int nMajor, int nMinor);

int App_TuneChannelByUid(int nUID);
int App_TuneChannelByUidEx(int nUID, APP_UID_TUNE_FLAG flag);


//int App_ChannelTuneByDRF(int rf, int program_number);
void App_ChTuneByDigitKey(int nMajor, int nMinor);

void App_ChTuneStopTV(void); // cafrii 060724 add
void App_ChTuneStopTVEx(BOOL bFromSigMon);

// cafrii ÀÌÀü ä³Î Æ©´×
STATUS App_ChTunePrevChannel(void);
// cafrii ¸¶Áö¸· ä³Î º¹±¸
STATUS App_ChTuneRecoverLastChannel(void);


STATUS App_ChangeChannelType(ChannelType nType);


int App_ChTuneMinorUp(void);
int App_ChTuneMinorDown(void);

int App_ChTuneSortUp(void);
int App_ChTuneSortDown(void);

int App_ChTuneSurfUp(void);
int App_ChTuneSurfDown(void);

int App_ChTuneSortSurfUp(void);

int App_ChTuneSortNumberUp(void);
int App_ChTuneSortNumberDown(void);
int App_ChTuneSortNumberSurfUp(void);


void App_ChTuneAddDelSurfCurChannel(BOOL bAddOrDel);

int App_SearchMostCloseChannel(int major, int minor); // cafrii 060814 add


// cafrii CH_ADD Å° ó¸®
STATUS App_ChTuneAddDelChannel(BOOL bAdd, BOOL bScanOtherChannel);

STATUS App_ChTuneQuickScanAndTune(int rf, int program_number, APP_QUICKSCAN_TYPE type);
        // cafrii 060804 add


// cafrii ÀÌÀü ä³Î Æ©´× (Prev-channel tune)À» À§ÇÑ Á¤º¸ ó¸®
void App_ResetPrevChannelInfo(void);
void App_SetPrevChannelInfo(void);

// cafrii ä³Î º¹±¸ ±â´É (boot, air/cable Àüȯ)À» À§ÇÑ Á¤º¸ ó¸®
void App_SaveLastChannelInfo(int rf, int program_number, int uid);

void App_UpdateUidChannelParam(int uid);
void App_UpdateDRFChannelParam(int rf, int program_number);

void App_RegisterChannelNotifyCallback(void); // cafrii 060609 add

void App_GetChannelSkippedInfo(int *pAdd);// iskang 071113 add

// Access APP_CUR_CH 

// dynamic channel update
void App_CheckDynamicChUpdate(void);
void App_CancelDynamicChUpdate(void);


void App_ChTuneInit(void);
void App_ChTuneParamInit(void);

void App_ForceEnableAirCable(BOOL is_enable); /* user debug¿ë */
BOOL App_IsForceEnableAirCable(void);
void App_SetEnableCableQam(BOOL setting);
BOOL App_GetEnableCableQam(void);


void App_SetChSortMode(tAppChSortMode mode);
        // set channel sort mode

tAppChSortMode App_GetChSortMode(void);
        // get channel sort mode

int App_GetChUid(int idx);

#endif /* __APP_FNC_CHTUNE_H__ */