tmbsl7104.h

PNX1500上7104芯片设置源代码！标准的C代码。

#ifndef TMBSL_SAA7104_H
#define TMBSL_SAA7104_H


/*  Copyright (C) 2004 Koninklijke Philips Electronics N.V.
    All Rights Reserved. 
    This source code and any compilation or derivative thereof is the 
    proprietary information of Koninklijke Philips Electronics N.V. and is
    confidential in nature. 
    Under no circumstances is this software to be exposed to or placed under an
    Open Source License of any type without the expressed written permission of
    Koninklijke Philips Electronics N.V.
*//*
--------------------------------------------------------------------------------
    %name:         tmbsl7104.h %
    %version:      SL#10.3.2 %
    %date_created: Tue Jun  6 16:25:16 2006 %
--------------------------------------------------------------------------------
*/
/**
    @file   tmbsl7104.h
    @brief  SAA7104 video encoder API definition.

@b  Component:  tmbsl7104

	This header file describes global definitions, types, and 
    functions exported by the Board Support Library (BSL)  
	implementation for saa7104. 

	The SAA7104 BSL implementation contains functions for the 
	Advanced Video Output (AVO) as well as Audio Output (AO).
*/


/******************************************************************************
* STANDARD INCLUDE FILES                                                      *
*******************************************************************************/

/******************************************************************************
* PROJECT INCLUDE FILES                                                       *
*******************************************************************************/

#include "tmNxTypes.h"
#include "tmbslVencAna.h"
#include "tmbslVencAnaExt.h"
#include "tmbslVencAnaVbiExt.h"

/******************************************************************************
* PROJECT INCLUDE FILES                                                       *
*******************************************************************************/

#ifdef __cplusplus
extern "C"
{
#endif
	
/******************************************************************************
* EXPORTED FUNCTION PROTOTYPES serving ItmbslVencAna                 		  *
*******************************************************************************/

/******************************************************************************/
/** Initialization function

    @pre    None.

    @retval TM_OK           					On success.
    @retval TMBSL_ERR_VENCANA_OUT_OF_MEMORY    	Memory allocation failed.

    @note   The encoders output format is contoled defined by the following table:
	<TABLE>
		<TR> 
			<TD></TD><TD></TD><TD></TD><TD><B>adapterType</B></TD>
		</TR>
		<TR>
			<TD><B>videoSubtype</B></TD>
			<TD>vaaCVBS</TD> <TD>vaaSvideo</TD> <TD>vaaSCART</TD> 
			<TD>vaaVGA</TD> <TD>vaaEXT1</TD>
		</TR>
		<TR>
			<TD>vof8bitYUV422</TD> 
			<TD>YUV/CSYNC</TD> <TD>YUV/CSYNC</TD> <TD>YUV/HV</TD> 
			<TD>N.A.</TD> <TD>N.A.</TD>
		</TR>
		<TR>
			<TD>vof24bit444</TD>
			<TD>N.A.</TD> <TD>N.A.</TD> <TD>YPbPr/HV</TD> 
			<TD>RGB/HV</TD> <TD>YPbPr/ESYNC</TD>
		</TR>
	</TABLE>
    
	vaaEXT1 is used for HIRES YPbPr output. 
	It is only supported with QVCP RGB 444 output so far.
	
    @see    tmbslVencAnaConfig_t
*/
extern tmErrorCode_t tmbsl7104Open(
    ptmbslVencAna_t 		*ppInstance,    /**< @b IN   ptr to video encoder. */
    tmUnitSelect_t 			unitSelect,     /**< @b IN   VencAna Unit number. */
    ptmbslVencAnaDesc_t     pEnc  			/**< @b IN   Encoder I2c Settings. */
);

/******************************************************************************/
/** Termination function

    @pre    tmbsl7104Open().

    @retval TM_OK           					On success.

    @note   Optional notes.
    
    @see    tmbslVencAnaConfig_t
*/
extern tmErrorCode_t tmbsl7104Close( 
	ptmbslVencAna_t pInstance				/**< @b IN   instance of interface.	*/
);

/******************************************************************************/
/** Apply settings done via ext interface

    @pre    tmbsl7104Open().

    @retval TM_OK           					On success.

    @note   Optional notes.
    
    @see    tmbslVencAnaConfig_t
*/
extern tmErrorCode_t tmbsl7104ApplyExtInterfaceSettings( 
	ptmbslVencAna_t pInstance				/**< @b IN   instance of interface.	*/
);

/******************************************************************************/
/** Set Adapter

    @pre    tmbsl7104Open().

    @retval TM_OK           					On success.

    @note   Optional notes.
    
    @see    tmbslVencAnaConfig_t
*/
extern tmErrorCode_t tmbsl7104SetEncodingType( 
	ptmbslVencAna_t 			pInstance,	/**< @b IN   instance of interface.	*/
    tmbslVencAna_EncodingType_t adapter		/**< @b IN   adapter id.	*/
);

/******************************************************************************/
/** Get Adapter

    @pre    tmbsl7104Open().

    @retval TM_OK           					On success.

    @note   Optional notes.
    
    @see    tmbslVencAnaConfig_t
*/
extern tmErrorCode_t tmbsl7104GetEncodingType( 
	ptmbslVencAna_t 			pInstance,	/**< @b IN   instance of interface.	*/
    tmbslVencAna_EncodingType_t *pAdapter	/**< @b OUT  adapter id. */
);

/******************************************************************************/
/** Set default Video Standard

    @pre    tmbsl7104Open().

    @retval TM_OK           					On success.
	@retval	TMBSL_ERR_VENCANA_BAD_PARAMETER		Invalid color system.

    @note   Optional notes.
    
    @see    tmbslVencAnaConfig_t
*/
extern tmErrorCode_t tmbsl7104SetColorSystem( 
	ptmbslVencAna_t 			pInstance,	/**< @b IN   instance of interface.	*/
    tmbslVencAna_ColorSystem_t 	standard	/**< @b IN   video standard. */
);

/******************************************************************************/
/** Get current Video Standard

    @pre    tmbsl7104Open().

    @retval TM_OK           					On success.

    @note   Optional notes.
    
    @see    tmbslVencAnaConfig_t
*/
extern tmErrorCode_t tmbsl7104GetColorSystem( 
	ptmbslVencAna_t 			pInstance,		/**< @b IN   instance of interface.	*/
    tmbslVencAna_ColorSystem_t 	*pDecVideoStd	/**< @b OUT  Decoder analogue video std. */
);

/******************************************************************************/
/** Get supported encoding types

    @pre    tmbsl7104Open().

    @retval TM_OK           					On success.

    @note   Optional notes.
    
    @see    tmbslVencAnaConfig_t
*/
extern tmErrorCode_t tmbsl7104GetSuppEncodingType( 
	ptmbslVencAna_t 				pInstance,	/**< @b IN   instance of interface.	*/
    tmbslVencAna_EncodingTypeSet_t  *pAdapter	/**< @b OUT  set of adapter id's. */
);


/******************************************************************************/
/** Get supported color systems

    @pre    tmbsl7104Open().

    @retval TM_OK           					On success.

    @note   Optional notes.
    
    @see    tmbslVencAnaConfig_t
*/
extern tmErrorCode_t tmbsl7104GetSuppColorSystems( 
	ptmbslVencAna_t 				pInstance,	/**< @b IN   instance of interface.	*/
    tmbslVencAna_ColorSystemSet_t  	*pAdapter	/**< @b OUT  set of color system id's. */
);


/******************************************************************************
* EXPORTED FUNCTION PROTOTYPES serving ItmbslVencAnaExt               		  *
*******************************************************************************/

/******************************************************************************/
/** Set video standard

    @pre    tmbsl7104Open().

    @retval TM_OK           					On success.

    @note   Optional notes.
    
    @see    tmbslVencAnaExtConfig_t
*/
extern tmErrorCode_t tmbsl7104ExtSetStandard( 
	ptmbslVencAnaExt_t 	pInstance,		/**< @b IN  instance of interface. */
    char				*standard		/**< @b IN	video standard. */ 
); 

/******************************************************************************/
/** Set video standard

    @pre    tmbsl7104Open().

    @retval TM_OK           					On success.

    @note   Optional notes.
    
    @see    tmbslVencAnaExtConfig_t
*/
extern tmErrorCode_t tmbsl7104ExtSetDataFormat( 
	ptmbslVencAnaExt_t	pInstance,		/**< @b IN  instance of interface. */