tlg1100api.h

泰景的模拟电视全部驱动及MTK平台界面代码

 *
 * @sa TLG_SetExtVSync, TLG_GetExtVSync
 */
TLGDLL_API int TLG_GetVSyncPolarity(uint32 base_addr, uint16 *polarity);

/** Set the VSync Active polarity.
 *
 * This procedure sets the polarity of "active region"
 * on the external Vertical Sync (VSYNC) pin. Valid values are: 
 * TLG_ACTIVE_HIGH, TLG_ACTIVE_LOW.  The "active region" is the region defined
 * by the assert1_start/assert1_end, assert2_start/assert2_end, and
 * assert3_start/assert3_end fields set by TLG_SetExtVSync().
 *
 * @param base_addr     I2c address for TLG1100 chip.
 * @param polarity      The polarity of the "active" region. Values are:
 *                      - TLG_ACTIVE_HIGH
 *                      - TLG_ACTIVE_LOW
 * 
 * @retval TLG_ERR_SUCCESS  Call succeeded.
 * @retval TLG_ERR_PARAM    Bad parameter value passed.
 * @retval TLG_ERR_FAIL     Error during call.
 *
 * @sa TLG_SetExtVSync, TLG_GetExtVSync
 */
TLGDLL_API int TLG_SetVSyncPolarity(uint32 base_addr, uint16 polarity);

/** Get the current Horizontal Decimation setting.
 *
 * This procedure retrieves the current horizontal decimation setting from the
 * TLG1100.
 * 
 * @param base_addr     I2c address for TLG1100 chip.
 * @param decimate      Value to set the decimator to. Valid values are:
 *                      TLG_OFF : decimate by 1
 *                      TLG_ON  : decimate by 2
 * 
 * @retval TLG_ERR_SUCCESS  Call succeeded.
 * @retval TLG_ERR_PARAM    Bad parameter value passed.
 * @retval TLG_ERR_FAIL     Error during call.
 */
TLGDLL_API int TLG_GetHDecimate(uint32 base_addr, uint16 *decimate);

/** Enable/Disable Horizontal Decimation.
 *
 * This procedure controls the horizontal decimation engine in the TLG1100.
 * Currently only decimation by 1 (default) and decimation by 2 are supported.
 *
 * @param base_addr     I2c address for TLG1100 chip.
 * @param decimate      Value to set the decimator to. Valid values are:
 *                      TLG_OFF : decimate by 1
 *                      TLG_ON  : decimate by 2
 * 
 * @retval TLG_ERR_SUCCESS  Call succeeded.
 * @retval TLG_ERR_PARAM    Bad parameter value passed.
 * @retval TLG_ERR_FAIL     Error during call.
 */
TLGDLL_API int TLG_SetHDecimate(uint32 base_addr, uint16 decimate);

/** Get the configured video output type.
 *
 * This procedure retrieves the configured video output type on the TLG1100.
 * The video output type controls certain timing algorithms of the video output.
 * 
 * @param base_addr     I2c address for TLG1100 chip.
 * @param vidOutType    returns the configured video output type.
 *                      Supported values are: 
 *                      - TLG_VID_DENC: output destined for digital encoder.
 *                      - TLG_VID_LCD:  output destined for digital device.
 * 
 * @retval TLG_ERR_SUCCESS  Call succeeded.
 * @retval TLG_ERR_PARAM    Bad parameter value passed.
 * @retval TLG_ERR_FAIL     Error during call.
 */
TLGDLL_API int TLG_GetVidOutType(uint32 base_addr, uint16 *vidOutType);

/** Set the configured video output type.
 *
 * This procedure sets the configured video output type on the TLG1100.
 * The video output type controls certain timing algorithms of the video output.
 * 
 * @param base_addr     I2c address for TLG1100 chip.
 * @param vidOutType    returns the configured video output type.
 *                      Supported values are: 
 *                      - TLG_VID_DENC: output destined for digital encoder.
 *                      - TLG_VID_LCD:  output destined for digital device.
 * 
 * @retval TLG_ERR_SUCCESS  Call succeeded.
 * @retval TLG_ERR_PARAM    Bad parameter value passed.
 * @retval TLG_ERR_FAIL     Error during call.
 */
TLGDLL_API int TLG_SetVidOutType(uint32 base_addr, uint16 vidOutType);

/** Example of how to set the TLG1100 into standard 640x480 601 NTSC mode.
 *
 * This procedure is an example of how to use the TLG API to set the TLG1100
 * to display on a standard 601 NTSC device. It sets up the following:
 *
 * visible Horizontal region (assert HSYNC): pixels 137 - 858
 *
 * horizontal blanking regions             : none
 *
 * vertical blanking regions (assert VSYNC): 1-25, 264-287
 *
 * 
 *
 * @param base_addr     I2c address for TLG1100 chip.
 * 
 * @retval TLG_ERR_SUCCESS  Call succeeded.
 * @retval TLG_ERR_PARAM    Bad parameter value passed.
 * @retval TLG_ERR_FAIL     Error during call.
 */
TLGDLL_API int TLG_SetVGA_601_NTSC(uint32 base_addr);

/** Example of how to set the TLG1100 into standard 601 PAL mode.
 *
 * This procedure is an example of how to use the TLG API to set the TLG1100
 * to display on a standard 601 PAL device. It sets up the following:
 *
 * @param base_addr     I2c address for TLG1100 chip.
 * 
 * @retval TLG_ERR_SUCCESS  Call succeeded.
 * @retval TLG_ERR_PARAM    Bad parameter value passed.
 * @retval TLG_ERR_FAIL     Error during call.
 */
TLGDLL_API int TLG_SetVGA_601_PAL(uint32 base_addr);

/** Example of how to set the TLG100 into 240x240 NTSC for LCD display.
 *
 * This procedure is an example of how to use the TLG API to set the TLG1100
 * to display a NTSC signal on a 240x240 LCD display running at 30 fields per
 * second. It sets the following:
 *
 * visible Horizontal region (assert HSYNC): pixels 195 - 674
 *
 * horizontal blanking regions             : pixels 1-15, 262-525
 *
 * vertical blanking regions (assert VSYNC): 1-19
 *
 * use default video configuration except:
 * - turn on horizontal decimation x2
 * - set 601 clock to TLG_NORMAL
 *
 * Notice this configuration does the following 
 * for horizontal:
 * - decimates by 2
 * - crops output to 240 visible lines
 *
 * for vertical:
 * - vertical blanking only for first field. This effectively decimates the
 *   verticle output by 2
 *
 * @param base_addr     I2c address for TLG1100 chip.
 * 
 * @retval TLG_ERR_SUCCESS  Call succeeded.
 * @retval TLG_ERR_PARAM    Bad parameter value passed.
 * @retval TLG_ERR_FAIL     Error during call.
 */
TLGDLL_API int TLG_Set240x240_LCD_NTSC(uint32 base_addr);

/** Example of how to set the TLG100 into 240x240 PAL for LCD display.
 *
 * This procedure is an example of how to use the TLG API to set the TLG1100
 * to display a PAL-G signal on a 240x240 LCD display running at 30 fields per
 * second. It sets the following:
 *
 * visible Horizontal region (assert HSYNC): pixels 197 - 676
 *
 * horizontal blanking regions             : pixels 1-46, 287-625
 *
 * vertical blanking regions (assert VSYNC): 1-19
 *
 * use default video configuration except:
 * - turn on horizontal decimation x2
 * - set 601 clock to TLG_NORMAL
 *
 * Notice this configuration does the following 
 * for horizontal:
 * - decimates by 2
 * - crops output to 240 visible lines
 *
 * for vertical:
 * - vertical blanking only for first field. This effectively decimates the
 *   verticle output by 2
 *
 * @param base_addr     I2c address for TLG1100 chip.
 * 
 * @retval TLG_ERR_SUCCESS  Call succeeded.
 * @retval TLG_ERR_PARAM    Bad parameter value passed.
 * @retval TLG_ERR_FAIL     Error during call.
 */
TLGDLL_API int TLG_Set240x240_LCD_PAL(uint32 base_addr);

/** Example of how to set the TLG1100 into standard QVGA NTSC mode.
 *
 * This procedure is an example of how to use the TLG API to set the TLG1100
 * to display on a QVGA NTSC device. It sets up the following:
 *
 * @todo TLG_SetQVGA_NTSC not implemented.
 *
 * @param base_addr     I2c address for TLG1100 chip.
 * 
 * @retval TLG_ERR_SUCCESS  Call succeeded.
 * @retval TLG_ERR_PARAM    Bad parameter value passed.
 * @retval TLG_ERR_FAIL     Error during call.
 */
TLGDLL_API int TLG_SetQVGA_NTSC(uint32 base_addr);


/** Example of how to set the TLG1100 into standard QVGA PAL mode.
 *
 * This procedure is an example of how to use the TLG API to set the TLG1100
 * to display on a QVGA PAL device. It sets up the following:
 *
 * @todo TLG_SetQVGA_PAL not implemented.
 *
 * @param base_addr     I2c address for TLG1100 chip.
 * 
 * @retval TLG_ERR_SUCCESS  Call succeeded.
 * @retval TLG_ERR_PARAM    Bad parameter value passed.
 * @retval TLG_ERR_FAIL     Error during call.
 */
TLGDLL_API int TLG_SetQVGA_PAL(uint32 base_addr);
                
/** Get the current center frequency bandwidth setting on the TLG1100.
 *
 * This procedure returns the currently set bandwidth value on the TLG1100.
 *
 * @param base_addr     I2c address for TLG1100 chip.
 * @param bw            Returns the current bandwidth setting. Values are:
 *                      - TLG_BW_5
 *                      - TLG_BW_6
 *                      - TLG_BW_7
 *                      - TLG_BW_8
 * 
 * @retval TLG_ERR_SUCCESS  Call succeeded.
 * @retval TLG_ERR_PARAM    Bad parameter value passed.
 * @retval TLG_ERR_FAIL     Error during call.
 */ 
TLGDLL_API int TLG_GetChnBandwidth(uint32 base_addr,  uint16 *bw);

/** Set the video bandwidth on the TLG1100.
 *
 * This procedure sets the center frequency bandwidth value on the TLG1100.
 * This value will remain stable between frequency changes and only needs to
 * be called again when a new bandwidth setting is needed.
 *
 * @param base_addr     I2c address for TLG1100 chip.
 * @param bw            The new bandwidth setting. Values are:
 *                      - TLG_BW_5
 *                      - TLG_BW_6
 *                      - TLG_BW_7
 *                      - TLG_BW_8
 * 
 * @retval TLG_ERR_SUCCESS  Call succeeded.
 * @retval TLG_ERR_PARAM    Bad parameter value passed.
 * @retval TLG_ERR_FAIL     Error during call.
 */
TLGDLL_API int TLG_SetChnBandwidth(uint32 base_addr, uint16 bw);

/** Set the play mode for the TLG1100.
 *
 * This procedure configures the TLG1100 to play video or FM Audio. This setting
 * will remain stable between frequency changes and only needs to be called
 * when a new mode setting is needed.
 *
 * @param base_addr     I2c address for TLG1100 chip.
 * @param mode          The desired mode. Valid values are:
 *                      - TLG_MODE_ANALOG_TV
 *                      - TLG_MODE_FM_RADIO
 * 
 * @retval TLG_ERR_SUCCESS  Call succeeded.
 * @retval TLG_ERR_PARAM    Bad parameter value passed.
 * @retval TLG_ERR_FAIL     Error during call.
 */
TLGDLL_API int TLG_SetChnMode(uint32 base_addr, uint16 mode);

/** Get the currently configured video standard.
 *
 * This procedure gets the currently set video standard on the TLG1100.
 *
 * @param base_addr     I2c address for TLG1100 chip.
 * @param std           The desired video standard. Valid values are:
 *                      - TLG_VSTD_NTSC_M
 *                      - TLG_VSTD_PAL_M 
 *                      - TLG_VSTD_PAL_B
 *                      - TLG_VSTD_PAL_B1
 *                      - TLG_VSTD_PAL_D
 *                      - TLG_VSTD_PAL_D1
 *                      - TLG_VSTD_PAL_G
 *                      - TLG_VSTD_PAL_H
 *                      - TLG_VSTD_PAL_K
 *                      - TLG_VSTD_PAL_N
 *                      - TLG_VSTD_PAL_I
 *                      - TLG_VSTD_PAL_NC
 * 
 * @retval TLG_ERR_SUCCESS  Call succeeded.
 * @retval TLG_ERR_PARAM    Bad parameter value passed.
 * @retval TLG_ERR_FAIL     Error during call.
 */
TLGDLL_API int TLG_GetChnStandard(uint32 base_addr, uint16 *std);

/** Set the video standard to be received by the TLG1100.
 *
 * This procedure sets the video standard for the TLG1100. This value remains
 * stable between frequency changes and only needs to be called when a new
 * video standard is needed. If mode has been set to TLG_MODE_FM_RADIO, then
 * the video standard needs to be set to TLG_VSTD_NTSC.
 *
 * @param base_addr     I2c address for TLG1100 chip.
 * @param std           The desired video standard. Valid values are:
 *                      - TLG_VSTD_NTSC_M
 *                      - TLG_VSTD_PAL_M 
 *                      - TLG_VSTD_PAL_B
 *                      - TLG_VSTD_PAL_B1
 *                      - TLG_VSTD_PAL_D
 *                      - TLG_VSTD_PAL_D1
 *                      - TLG_VSTD_PAL_G
 *                      - TLG_VSTD_PAL_H
 *                      - TLG_VSTD_PAL_K
 *                      - TLG_VSTD_PAL_N
 *                      - TLG_VSTD_PAL_I
 *                      - TLG_VSTD_PAL_NC
 * 
 * @retval TLG_ERR_SUCCESS  Call succeeded.
 * @retval TLG_ERR_PARAM    Bad parameter value passed.
 * @retval