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

/****************************************************************************
* NAME: App_Fnc_SignalMonitor.h
*----------------------------------------------------------------------------
* Copyright (c) 2006-2009 DIGITAL STREAM Technology Inc.
*----------------------------------------------------------------------------
* CREATED_BY: Chan Hun Jeon 
* CREATION_DATE: 2009/08/27
* $Author: chjeon $
* $Revision: 1.1 $
* $Date: 2009/07/08 15:08:26 $
*----------------------------------------------------------------------------
* PURPOSE:
*       - Implement signal monitor module
*****************************************************************************/

#ifndef __APP_FNC_SIGNAL_MONITOR_H__
#define __APP_FNC_SIGNAL_MONITOR_H__

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





#if COMMENT
____Overview____(){}
#endif

/*
        Signal Monior module 
        - signal monitoring 
        - check low signal, no program, audio only etc.
        - channel tuing (recovery)

        Dependencies
        - DHL_AVCAP
        - DHL_FE        
*/





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

#if COMMENT
____Config____(){}
#endif

#define APP_SIGMON_PARAM_STR(f) ( \
                (f) == APP_SM_PARAM_NUM_SAMPLES ? "NumSamples" : \
                (f) == APP_SM_PARAM_CHECK_PERIOD_LO ? "ChkPeriodLo" : \
                (f) == APP_SM_PARAM_CHECK_PERIOD_HI ? "ChkPeriodHi" : \
                (f) == APP_SM_PARAM_BANNER_SHOW_PERIOD ? "BnrShowPeriod" : \
                (f) == APP_SM_PARAM_RETRY_TUNE_PERIOD ? "RetryTunePeriod" : \
                (f) == APP_SM_PARAM_KEEP_PERIOD_NOPGM ? "KeepPeriodNoProgram" : \
                (f) == APP_SM_PARAM_KEEP_PERIOD_AUDIO ? "KeepPeriodAudioOnly" : \
                (f) == APP_SM_PARAM_INITIAL_DELAY_MS ? "InitialDelayMs" : \
                (f) == APP_SM_PARAM_SIGNAL_LO_LIMIT ? "SignalLoLimit" : \
                (f) == APP_SM_PARAM_SIGNAL_HI_LIMIT ? "SignalHiLimit" : \
                (f) == APP_SM_PARAM_SKIP_LOW_SIG_MODE ? "SkipLowSigMode" : \
                (f) == APP_SM_PARAM_CHECK_COUNT_THRESHOLD_H2L ? "ChkCountThrsdH2L" : \
                (f) == APP_SM_PARAM_CHECK_COUNT_THRESHOLD_L2H ? "ChkCountThrsdL2H" : \
                "?")

/*
        // multi-line comments may be dangerous. use c-style comments.
                //(f) == APP_SM_PARAM_DISABLE_BANNER ? "DisableBanner" : \
                //(f) == APP_SM_PARAM_NOISE_VIDEO_IN_NO_SIGNAL ? "NoiseVideoNoSig" : \
*/





#if COMMENT
____Types____(){}
#endif

// Signal Monitor State machineÀÇ ³»ºÎ »óÅÂ.
typedef enum
{
        APP_SM_STAT_DISABLED,
        APP_SM_STAT_STOP,
        APP_SM_STAT_HIGH,  // good digital signal
        APP_SM_STAT_LOW,   // bad digital signal
        APP_SM_STAT_AUDIO, // audio only digital
        APP_SM_STAT_NOPGM, // no program digital
        
        APP_SM_STAT_HIGH_ANALOG,
        APP_SM_STAT_LOW_ANALOG,

        APP_SM_STAT_TEST,  // test mode, just check signal data
        
} APP_SIGMON_STAT;


// cafrii 060821 add
typedef enum
{
        APP_SM_PARAM_NUM_SAMPLES,

        APP_SM_PARAM_CHECK_PERIOD_LO,
        APP_SM_PARAM_CHECK_PERIOD_HI,

        APP_SM_PARAM_BANNER_SHOW_PERIOD,

        APP_SM_PARAM_RETRY_TUNE_PERIOD,

        APP_SM_PARAM_KEEP_PERIOD_NOPGM,
        APP_SM_PARAM_KEEP_PERIOD_AUDIO,

        APP_SM_PARAM_INITIAL_DELAY_MS,

        APP_SM_PARAM_SIGNAL_LO_LIMIT,
        APP_SM_PARAM_SIGNAL_HI_LIMIT,

        APP_SM_PARAM_SKIP_LOW_SIG_MODE, // cafrii 070613 add

        APP_SM_PARAM_CHECK_COUNT_THRESHOLD_H2L, // cafrii 070912 add
        APP_SM_PARAM_CHECK_COUNT_THRESHOLD_L2H,
        
        //APP_SM_PARAM_DISABLE_BANNER,

        //APP_SM_PARAM_NOISE_VIDEO_IN_NO_SIGNAL,

} APP_SIGMON_PARAM;


typedef struct 
{
        APP_SIGMON_STAT status;
        UINT32 status_period_ms;
} APP_SIGMON_INFO;





#if COMMENT
____Variables____(){}
#endif





#if COMMENT
____NvParam____(){}
#endif





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

#if COMMENT
____Function____(){}
#endif

// Fnc_SignalMonitor
void App_Resume_SMTask(void);
void App_Pause_SMTask(void);
void App_Restart_SMTask(BOOL bAnalog, BOOL bTuneSuccess); // cafrii 060721 add
void App_ForceDisableSMTask(BOOL bDisable);
void App_NotifySigMonBannerToken(BOOL bAvail);
        // cafrii 060714 add for OSD mgr

// cafrii 060821 add
UINT32 App_GetSigMonParam(APP_SIGMON_PARAM param);
void App_ChangeSigMonParam(APP_SIGMON_PARAM param, int value);

void App_GetSigMonInfo(APP_SIGMON_INFO *pinfo);

// internal API only for Service Menu
void SigMon_SetDbgLevel(int debug_level);
int SigMon_GetDbgLevel(void);
int SigMon_GetStrength(void);

// module init
void App_SMInit(void);





#endif /* __APP_FNC_SIGNAL_MONITOR_H__ */