dvb_fp.h

DVB软件,基于CT216软件的开发源程序.

/******************************************************************************

        (C)Copyright Cheertek Inc. 2002-2005,
           K000, all right reserved.

        Product : STB Firmware

******************************************************************************/
/*! 
\file
Front Panel and IR API.
*/

#ifndef __DVB_FP_H
#define __DVB_FP_H

#include "dvb_type.h"

#define 	NUM_OF_7SEG		5

void DVB_FP_Init(void);
/*! \fn void DVB_FP_Init(void)
\brief Initial the 7-Segment and keypad.
*/

void DVB_7Seg_Strengthen(bool8 b8Enable);
/*! \fn void DVB_7Seg_Strengthen(bool8 b8Enable)
\brief Turn no/off the 7-segment strengthen control mode.
*/

void DVB_7SegOff(void);
/*! \fn void DVB_7SegOff(void)
\brief Turn off the 7-segment LED.
*/

void DVB_7SegShow (u16 u16Number);
/*! \fn void DVB_7SegShow (u16 u16Number)
\brief Display a number to 7-segment LED.
\param u16Number (Input) the 7-segment LED number
*/

void DVB_7SegShowNumByIdx(u8 u8Idx, u8 u8Number);
/*! \fn void DVB_7SegShowNumByIdx (u8 u8Idx, u8 u8Number)
\brief Display a number to 7-segment LED.
\param u8Idx (Input) The 7-segment LED index number.
\param u8Number (Input) the 7-segment LED number
*/

void DVB_7SegShowDetial(u8 u8Idx, u8 u8Data);
/*! \fn void DVB_7SegShowDetial(u8 u8Idx, u8 u8Data)
\brief Display a special pattern to 7-segment LED.
\param u8Idx (Input) The 7-segment LED index number.
\param u8Data (Input) This is a 7-segment LED data.  The data
mapping as following:
\verbatim

              bit7
          +==========+
          |          |
    bit2  |          |  bit6
          |   bit1   |
          +==========+
          |          |
    bit3  |          |  bit5
          |          |
          +==========+ * bit0
              bit4

\endverbatim
*/

void DVB_7SegShowText(u8 *pu8Text);
/*! \fn void DVB_7SegShowText (u8 *pu8Text)
\brief Display a word to 7-segment LED.
\param pu8Text (Input) the 7-segment LED word
*/

u16 DVB_GetIR_CustomerCode(void);
/*! \fn u16 DVB_GetIR_CustomerCode(void)
\brief Get remote control customer code
\return customer code
*/

void DVB_EnableKey(bool8 b8Enable);
/*! \fn void DVB_EnableKey(bool8 b8Enable)
\brief Enable or disable remote control key and front panel key.
\param b8Enable (Input) TRUE: enable key, FALSE: disable key
*/

bool8 DVB_DetectKey (void);
/*! \fn bool8 DVB_DetectKey (void)
\brief Check the key detected or not.
This function will return to application layer immediately.
\return TRUE - The key is in key buffer.
\return FALSE - No any key is in key buffer.
*/

bool8 DVB_DetectKeyTimeout (u16 u16Timeout);
/*! \fn bool8 DVB_DetectKey (void)
\brief Check the key detected or not.
This function will return to application layer immediately.
\return TRUE - The key is in key buffer.
\return FALSE - No any key is in key buffer.
*/

u8 DVB_CheckKey (void);
/*! \fn u8 DVB_CheckKey (void)
\brief Check the key detected or not.  The key isn't removed from key buffer.
This function will be blocked in system layer until key input.
\return the key of remote controller or front panel
*/

u8 DVB_GetKey (void);
/*! \fn u8 DVB_GetKey (void)
\brief Get a key from system.  This function will be blocked in system until a new key input.
This key is a raw key from remote control. This function will translate the raw key to application key.  
The key mapping table is defined in EN_DVB_KEY of ap_defs.h.
The key will be removed from key buffer.
\return the application key of remote controller or front panel
*/

void DVB_CleanKey(void);
/*! \fn void DVB_CleanKey(void)
\brief Clean all of the keys in key buffer.
*/

void DVB_SendKey(u8 u8Key);
/*! \fn void DVB_SendKey(u8 u8Key)
\brief Send an application key to key buffer.
\param u8Key (Input) The key you want to send.
*/

void DVB_EnableIRKey(bool8 b8Enable);
/*! \fn void DVB_EnableIRKey(bool8 b8Enable)
\brief Enable or Disable key from IR sensor.
\param b8Enable (Input) TRUE: enable key, FALSE: disable key
*/

void DVB_FP_Standby (void);
void DVB_FP_PowerOn (void);

void DVB_SendKeyInFrontOfQueue(u8 u8Key, bool8 b8CleanKeyInQueue);
/*! \fn void DVB_SendKeyInFrontOfQueue(u8 u8Key, bool8 b8CleanKeyInQueue)
\brief This Key priority is higher then Keys in queue, and may clean the queue.
This Key will be checked at DVB_DetectKey, DVB_CheckKey, DVB_GetKey
\param u8Key (Input) Key will be process at first
\param b8CleanKeyInQueue (Input) Clean the keys in queue or not
*/

#endif