xref: /utopia/UTPA2-700.0.x/mxlib/include/drvXC_HDMI_if_EX.h (revision 53ee8cc121a030b8d368113ac3e966b4705770ef)

//<MStar Software>
//******************************************************************************
// MStar Software
// Copyright (c) 2010 - 2012 MStar Semiconductor, Inc. All rights reserved.
// All software, firmware and related documentation herein ("MStar Software") are
// intellectual property of MStar Semiconductor, Inc. ("MStar") and protected by
// law, including, but not limited to, copyright law and international treaties.
// Any use, modification, reproduction, retransmission, or republication of all
// or part of MStar Software is expressly prohibited, unless prior written
// permission has been granted by MStar.
//
// By accessing, browsing and/or using MStar Software, you acknowledge that you
// have read, understood, and agree, to be bound by below terms ("Terms") and to
// comply with all applicable laws and regulations:
//
// 1. MStar shall retain any and all right, ownership and interest to MStar
//    Software and any modification/derivatives thereof.
//    No right, ownership, or interest to MStar Software and any
//    modification/derivatives thereof is transferred to you under Terms.
//
// 2. You understand that MStar Software might include, incorporate or be
//    supplied together with third party`s software and the use of MStar
//    Software may require additional licenses from third parties.
//    Therefore, you hereby agree it is your sole responsibility to separately
//    obtain any and all third party right and license necessary for your use of
//    such third party`s software.
//
// 3. MStar Software and any modification/derivatives thereof shall be deemed as
//    MStar`s confidential information and you agree to keep MStar`s
//    confidential information in strictest confidence and not disclose to any
//    third party.
//
// 4. MStar Software is provided on an "AS IS" basis without warranties of any
//    kind. Any warranties are hereby expressly disclaimed by MStar, including
//    without limitation, any warranties of merchantability, non-infringement of
//    intellectual property rights, fitness for a particular purpose, error free
//    and in conformity with any international standard.  You agree to waive any
//    claim against MStar for any loss, damage, cost or expense that you may
//    incur related to your use of MStar Software.
//    In no event shall MStar be liable for any direct, indirect, incidental or
//    consequential damages, including without limitation, lost of profit or
//    revenues, lost or damage of data, and unauthorized system use.
//    You agree that this Section 4 shall still apply without being affected
//    even if MStar Software has been modified by MStar in accordance with your
//    request or instruction for your use, except otherwise agreed by both
//    parties in writing.
//
// 5. If requested, MStar may from time to time provide technical supports or
//    services in relation with MStar Software to you for your use of
//    MStar Software in conjunction with your or your customer`s product
//    ("Services").
//    You understand and agree that, except otherwise agreed by both parties in
//    writing, Services are provided on an "AS IS" basis and the warranty
//    disclaimer set forth in Section 4 above shall apply.
//
// 6. Nothing contained herein shall be construed as by implication, estoppels
//    or otherwise:
//    (a) conferring any license or right to use MStar name, trademark, service
//        mark, symbol or any other identification;
//    (b) obligating MStar or any of its affiliates to furnish any person,
//        including without limitation, you and your customers, any assistance
//        of any kind whatsoever, or any information; or
//    (c) conferring any license or right under any intellectual property right.
//
// 7. These terms shall be governed by and construed in accordance with the laws
//    of Taiwan, R.O.C., excluding its conflict of law rules.
//    Any and all dispute arising out hereof or related hereto shall be finally
//    settled by arbitration referred to the Chinese Arbitration Association,
//    Taipei in accordance with the ROC Arbitration Law and the Arbitration
//    Rules of the Association by three (3) arbitrators appointed in accordance
//    with the said Rules.
//    The place of arbitration shall be in Taipei, Taiwan and the language shall
//    be English.
//    The arbitration award shall be final and binding to both parties.
//
//******************************************************************************
//<MStar Software>
////////////////////////////////////////////////////////////////////////////////
//
// Copyright (c) 2008-2009 MStar Semiconductor, Inc.
// All rights reserved.
//
// Unless otherwise stipulated in writing, any and all information contained
// herein regardless in any format shall remain the sole proprietary of
// MStar Semiconductor Inc. and be kept in strict confidence
// (!��MStar Confidential Information!�L) by the recipient.
// Any unauthorized act including without limitation unauthorized disclosure,
// copying, use, reproduction, sale, distribution, modification, disassembling,
// reverse engineering and compiling of the contents of MStar Confidential
// Information is unlawful and strictly prohibited. MStar hereby reserves the
// rights to any and all damages, losses, costs and expenses resulting therefrom.
//
////////////////////////////////////////////////////////////////////////////////

///////////////////////////////////////////////////////////////////////////////////////////////////
///
/// @file   drvXC_HDMI_if_EX.h
/// @brief  HDMI Interface
/// @author MStar Semiconductor Inc.
///////////////////////////////////////////////////////////////////////////////////////////////////

#ifndef DRVXC_HDMI_IF_EX_H
#define DRVXC_HDMI_IF_EX_H

#include "MsCommon.h"

// Driver
#include "drvXC_IOPort_EX.h"

// Api
#include "apiXC_EX.h"

#ifdef __cplusplus
extern "C"
{
#endif

//-------------------------------------------------------------------------------------------------
//  Driver Capability
//-------------------------------------------------------------------------------------------------

#ifdef MDRV_HDMI_EX_C
#define INTERFACE
#else
#define INTERFACE extern
#endif

//-------------------------------------------------------------------------------------------------
//  Macro and Define
//-------------------------------------------------------------------------------------------------
#define _HDMI_EX_BYTE_0  0x00
#define _HDMI_EX_BYTE_1  0x01
#define _HDMI_EX_BYTE_2  0x02
#define _HDMI_EX_BYTE_3  0x03
#define _HDMI_EX_BYTE_4  0x04
#define _HDMI_EX_BYTE_5  0x05
#define _HDMI_EX_BYTE_6  0x06
#define _HDMI_EX_BYTE_7  0x07
#define _HDMI_EX_BYTE_8  0x08
#define _HDMI_EX_BYTE_9  0x09
#define _HDMI_EX_BYTE_10  0x0A
#define _HDMI_EX_BYTE_11  0x0B
#define _HDMI_EX_BYTE_12  0x0C
#define _HDMI_EX_BYTE_13  0x0D
// library information
#define MSIF_HDMI_EX_LIB_CODE               {'H','D','M','I'}
#define MSIF_HDMI_EX_LIBVER                 {'0','1'}
#define MSIF_HDMI_EX_BUILDNUM               {'0','7'}
#define MSIF_HDMI_EX_CHANGELIST             {'0','0','3','5','1','6','6','3'}
#define HDMI_EX_DRV_VERSION                  /* Character String for DRV/API version             */  \
    MSIF_TAG,                           /* 'MSIF'                                           */  \
    MSIF_CLASS,                         /* '00'                                             */  \
    MSIF_CUS,                           /* 0x0000                                           */  \
    MSIF_MOD,                           /* 0x0000                                           */  \
    MSIF_CHIP,                                                                                  \
    MSIF_CPU,                                                                                   \
    MSIF_HDMI_EX_LIB_CODE  ,                  /* IP__                                             */  \
    MSIF_HDMI_EX_LIBVER    ,                          /* 0.0 ~ Z.Z                                        */  \
    MSIF_HDMI_EX_BUILDNUM  ,                          /* 00 ~ 99                                          */  \
    MSIF_HDMI_EX_CHANGELIST,  /* CL#                                              */  \
    MSIF_OS

//-------------------------------------------------------------------------------------------------
//  Type and Structure
//-------------------------------------------------------------------------------------------------

/// HDMI reset type
typedef enum
{
    E_HDMI_EX_REST_AVMUTE = _XC_EX_BIT(8),    ///<HDMI Reset bit[8]
    E_HDMI_EX_REST_Y_COLOR = _XC_EX_BIT(9),    ///<HDMI Reset bit[9]
    E_HDMI_EX_REST_PIXEL_REPETITION  = _XC_EX_BIT(10),    ///<HDMI Reset bit[10]
    E_HDMI_EX_REST_FRAME_REPETITION  = _XC_EX_BIT(11),    ///<HDMI Reset bit[11]
    E_HDMI_EX_REST_GCP_PKT  = _XC_EX_BIT(12),    ///<HDMI Reset bit[12]
    E_HDMI_EX_REST_DEEP_COLOR_FIFO  = _XC_EX_BIT(13),    ///<HDMI Reset bit[13]
    E_HDMI_EX_REST_RESERVE = _XC_EX_BIT(14),    ///<HDMI Reset bit[14]
    E_HDMI_EX_REST_HDMI_STATUS = _XC_EX_BIT(15),    ///<HDMI Reset bit[15]
} HDMI_EX_REST;

/*!
    HDMI Aspect Ratio TYPE
*/
typedef enum
{
    // Active Format Aspect Ratio - AFAR
//    HDMI_EX_AF_AR_Not_Present   = -1,    ///< IF0[11..8] AFD not present, or AFD not yet found
    E_HDMI_EX_AF_AR_Reserve_0  = 0x00,    ///< IF0[11..8] 0000, Reserved
    E_HDMI_EX_AF_AR_Reserve_1  = 0x01,    ///< IF0[11..8] 0001, Reserved
    E_HDMI_EX_AF_AR_16x9_Top = 0x02,    ///< IF0[11..8] 0010, box 16:9 (top).
    E_HDMI_EX_AF_AR_14x9_Top = 0x03,    ///< IF0[11..8] 0011, box 14:9 (top).
    E_HDMI_EX_AF_AR_GT_16x9 = 0x04,    ///< IF0[11..8] 0100, box >16:9 (centre)
    E_HDMI_EX_AF_AR_Reserve_5  = 0x05,    ///< IF0[11..8] 0101, Reserved
    E_HDMI_EX_AF_AR_Reserve_6  = 0x06,    ///< IF0[11..8] 0110, Reserved
    E_HDMI_EX_AF_AR_Reserve_7  = 0x07,    ///< IF0[11..8] 0111, Reserved
    E_HDMI_EX_AF_AR_SAME   = 0x08,    ///< IF0[11..8] 1000, same as picture
    E_HDMI_EX_AF_AR_4x3_C  = 0x09,    ///< IF0[11..8] 1001, 4:3 Center
    E_HDMI_EX_AF_AR_16x9_C = 0x0A,    ///< IF0[11..8] 1010, 16:9 Center
    E_HDMI_EX_AF_AR_14x9_C = 0x0B,    ///< IF0[11..8] 1011, 14:9 Center
    E_HDMI_EX_AF_AR_Reserve_12   = 0x0C,    ///< IF0[11..8] 1100, Reserved.
    E_HDMI_EX_AF_AR_4x3_with_14x9_C  = 0x0D,    ///< IF0[11..8] 1101, 4:3 with shoot and protect 14:9 centre.
    E_HDMI_EX_AF_AR_16x9_with_14x9_C = 0x0E,    ///< IF0[11..8] 1110, 16:9 with shoot and protect 14:9 centre.
    E_HDMI_EX_AF_AR_16x9_with_4x3_C = 0x0F,    ///< IF0[11..8] 1111, 16:9 with shoot and protect 4:3 centre.

    // Picture Aspect Ratio - PAR
    E_HDMI_EX_Pic_AR_NODATA = 0x00,     ///< IF0[13..12] 00
    E_HDMI_EX_Pic_AR_4x3    = 0x10,     ///< IF0[13..12] 01, 4:3
    E_HDMI_EX_Pic_AR_16x9   = 0x20,     ///< IF0[13..12] 10, 16:9
    E_HDMI_EX_Pic_AR_RSV    = 0x30,     ///< IF0[13..12] 11, reserved
} HDMI_EX_AR_TYPE;

//-------------------------------------------------------------------------------------------------
/// AVI infomation frame version
//-------------------------------------------------------------------------------------------------
typedef enum
{
    E_HDMI_EX_AVI_INFOFRAME_VERSION_NON,    //invalid version
    E_HDMI_EX_AVI_INFOFRAME_VERSION1,       //AVI infomation frame version 1
    E_HDMI_EX_AVI_INFOFRAME_VERSION2        //AVI infomation frame version 2
} HDMI_EX_AVI_INFOFRAME_VERSION;

#define HDMI_EX_AR_INIT_VALUE          (E_HDMI_EX_Pic_AR_RSV)
#define HDMI_EX_AR_REG_MASK            (0x3F)
#define HDMI_EX_AFAR_MASK              (0x0F)      // mask to get the AFAR
#define HDMI_EX_AR_MASK                (0x30)      // mask to get the PAR

/// HDMI GControl package type.
typedef enum
{
    E_HDMI_EX_GCTRL_AVMUTE = 0,    ///< bit[0]: AVMUTE
    E_HDMI_EX_GCTRL_DEFAULT_PHASE,    ///< bit[1]: Default_Phase
    E_HDMI_EX_GCTRL_LAST_PP,    ///< bit[4:2]: LAST_PP[2:0]
    E_HDMI_EX_GCTRL_PRE_LPP,    ///< bit[7:5]: PRE_LPP[2:0]
    E_HDMI_EX_GCTRL_CD_VAL,    ///< bit[11:8]: CD_VAL[3:0]
    E_HDMI_EX_GCTRL_PP_VAL,    ///< bit[15:12]: PP_VAL[3:0]
    E_HDMI_EX_GCTRL_ALL
} HDMI_EX_GControl_INFO;

/// HDMI PLL control type
typedef enum
{
    E_HDMI_EX_PLL_CTRL_L=0,    ///< HDMI_PLL_CTRL1_L  7:0
    E_HDMI_EX_PLL_CTRL_MANUAL_DIV,    ///< MANUAL_PLL_DIV    7
    E_HDMI_EX_PLL_CTRL_PORST,    ///< PLL_PORST 6
    E_HDMI_EX_PLL_CTRL_RESET_TP,    ///< RESET_TP 5
    E_HDMI_EX_PLL_CTRL_RESET_TF,    ///< RESET_TF 4
    E_HDMI_EX_PLL_CTRL_RESET_TI,    ///< RESET_TI 3
    E_HDMI_EX_PLL_CTRL_VCO_OFFSET,    ///< VCO_OFFSET    2
    E_HDMI_EX_PLL_CTRL_RESET,    ///< PLL_RESET 1
    E_HDMI_EX_PLL_CTRL_PWRDOWN,    ///< PWRDOWN  0

    E_HDMI_EX_PLL_CTRL_H,    ///< HDMI_PLL_CTRL1_H 7:0
    E_HDMI_EX_PLL_CTRL_KN,    ///< KN[1:0]    7:6
    E_HDMI_EX_PLL_CTRL_RCTRL,    ///< RCTRL 5:3
    E_HDMI_EX_PLL_CTRL_ICTRL,    ///< ICTRL 2:0
} HDMI_EX_PLL_CTRL;

/// HDMI PLL control type
typedef enum
{
    E_HDMI_EX_PLL_CTRL2_L,    ///< HDMI_PLL_CTRL2_L 7:0
    E_HDMI_EX_PLL_CTRL2_KP,    ///< KP[3:0]   7:4
    E_HDMI_EX_PLL_CTRL2_KM,    ///< KM[3:0]   3:0

    E_HDMI_EX_PLL_CTRL2_H,    ///< HDMI_PLL_CTRL2_H  7:0
    E_HDMI_EX_PLL_CTRL2_DDIV,    ///< DDIV[3:0] 7:4
    E_HDMI_EX_PLL_CTRL2_FBDIV,    ///< FBDIV[3:0]    3:0
} HDMI_EX_PLL_CTRL2;

#ifndef DRVXC_HDMI_IF_H
////===========================>>HDMI
typedef struct
{
    MS_BOOL bIsHDMIMode;
    MS_BOOL bMuteHDMIVideo;

    MS_BOOL bMuteHDMIAudio;
    MS_BOOL bEnableNonPCM;
    MS_U8      u8AudioStbCnt;      // If stable more than HDMI_AUDIO_STABLE_CNT, enable audio
    // In 199M case, audio on->off->on->off->on, so, we wait 4 * HDMI_AUDIO_STABLE_CNT, if unstable,
    // enable audio still to prevent mute audio always because of un-stable
    MS_U8      u8AudioForceEnableCnt;

    MS_U8      u8ColorFormat;
    MS_U8      u8LostHDMICounter;
    MS_BOOL bColorFMTChange;
    MS_U8      u8PreClolrFormat;
    MS_U8      u8AspectRatio;
} HDMI_POLLING_STATUS_t;
#endif

typedef enum
{
    E_HDMI_EX_DVI_CHANNEL_R,
    E_HDMI_EX_DVI_CHANNEL_G,
    E_HDMI_EX_DVI_CHANNEL_B,
} HDMI_EX_DVI_CHANNEL_TYPE;

/// HDMI COLOR FORMAT
typedef enum
{
    E_HDMI_EX_COLOR_RGB,    ///< HDMI RGB 444 Color Format
    E_HDMI_EX_COLOR_YUV_422,    ///< HDMI YUV 422 Color Format
    E_HDMI_EX_COLOR_YUV_444,    ///< HDMI YUV 444 Color Format
    E_HDMI_EX_COLOR_RESERVED,    ///< Reserve
    E_HDMI_EX_COLOR_DEFAULT = E_HDMI_EX_COLOR_RGB,    ///< Default setting
    E_HDMI_EX_COLOR_UNKNOWN = 7,    ///< Unknow Color Format
} HDMI_EX_COLOR_FORMAT;

///HDMI COLOR RANGE
typedef enum
{
    E_HDMI_EX_COLOR_RANGE_DEFAULT, //
    E_HDMI_EX_COLOR_RANGE_LIMIT,   //HDMI RGB Limited Range (16-235)
    E_HDMI_EX_COLOR_RANGE_FULL,    //HDMI Full Range (0-255)
    E_HDMI_EX_COLOR_RANGE_RESERVED
} HDMI_EX_COLOR_RANGE;

/// HDMI Content Type
typedef enum
{
    E_HDMI_EX_CONTENT_NoData = 0,    // No Data.
    E_HDMI_EX_CONTENT_Graphics,  // Graphics(text).
    E_HDMI_EX_CONTENT_Photo,     // Photo type.
    E_HDMI_EX_CONTENT_Cinema,    // Cinema type.
    E_HDMI_EX_CONTENT_Game,      // Game type.
} HDMI_EX_CONTENT_TYPE;

/// HDMI Extended COLORIMETRY
typedef enum
{
    E_HDMI_EX_EXT_COLOR_XVYCC601,    ///< xvycc 601
    E_HDMI_EX_EXT_COLOR_XVYCC709,    ///< xvycc 709
    E_HDMI_EX_EXT_COLOR_SYCC601,    ///< sYCC 601
    E_HDMI_EX_EXT_COLOR_ADOBEYCC601,    ///< Adobe YCC 601
    E_HDMI_EX_EXT_COLOR_ADOBERGB,    ///< Adobe RGB
    E_HDMI_EX_EXT_COLOR_DEFAULT = E_HDMI_EX_EXT_COLOR_XVYCC601,    ///< Default setting
    E_HDMI_EX_EXT_COLOR_UNKNOWN = 7,    ///< Unknow
} HDMI_EX_EXT_COLORIMETRY_FORMAT;

/// HDMI Equalize Level
typedef enum
{
    E_HDMI_EX_EQ_2M,    ///< HDMI EQ 2M
    E_HDMI_EX_EQ_10M,    ///< HDMI EQ 10M
    E_HDMI_EX_EQ_15M,    ///< HDMI EQ 15M
    E_HDMI_EX_EQ_MAX,    ///< HDMI EQ MAX
    E_HDMI_EX_EQ_USER_DEFINE,    ///< HDMI EQ User define
} HDMI_EX_EQ;

/// HDMI Packet nauber
typedef enum
{
    E_HDMI_EX_PKT_MPEG  = _XC_EX_BIT(0),    ///< Pactet[0]
    E_HDMI_EX_PKT_AUI  = _XC_EX_BIT(1),    ///< Pactet[1]
    E_HDMI_EX_PKT_SPD  = _XC_EX_BIT(2),    ///< Pactet[2]
    E_HDMI_EX_PKT_AVI  = _XC_EX_BIT(3),    ///< Pactet[3]
    E_HDMI_EX_PKT_GC  = _XC_EX_BIT(4),    ///< Pactet[4]
    E_HDMI_EX_PKT_ASAMPLE  = _XC_EX_BIT(5),    ///< Pactet[5]
    E_HDMI_EX_PKT_ACR  = _XC_EX_BIT(6),    ///< Pactet[6]
    E_HDMI_EX_PKT_VS  = _XC_EX_BIT(7),    ///< Pactet[7]
    E_HDMI_EX_PKT_NULL  = _XC_EX_BIT(8),    ///< Pactet[8]
    E_HDMI_EX_PKT_ISRC2  = _XC_EX_BIT(9),    ///< Pactet[9]
    E_HDMI_EX_PKT_ISRC1  = _XC_EX_BIT(10),    ///< Pactet[10]
    E_HDMI_EX_PKT_ACP  = _XC_EX_BIT(11),    ///< Pactet[11]
    E_HDMI_EX_PKT_ONEBIT_AUD  = _XC_EX_BIT(12),    ///< Pactet[12]
} HDMI_EX_PACKET_STATE;

typedef enum
{
    E_HDMI_EX_CAPS_DVI_ADJ_70M = _XC_EX_BIT(0),
    E_HDMI_EX_CAPS_VSYNC_END_EN = _XC_EX_BIT(1),
} HDMI_EX_FUNC_CAPS;

/// HDMI PACKET VALUE structure
typedef struct
{
    MS_U16 PKT_MPEG_VALUE;    ///< MPEG packet content
    MS_U16 PKT_AUI_VALUE;    ///< AUI packet content
    MS_U16 PKT_SPD_VALUE;    ///< SPD packet content
    MS_U16 PKT_AVI_VALUE;    ///< AVI packet content
    MS_U16 PKT_GC_VALUE;    ///< GC packet content
    MS_U16 PKT_ASAMPLE_VALUE;    ///< ASAMPLE packet content
    MS_U16 PKT_ACR_VALUE;    ///< ACR packet content
    MS_U16 PKT_VS_VALUE;    ///< VS packet content
    MS_U16 PKT_NULL_VALUE;    ///< NULL packet content
    MS_U16 PKT_ISRC2_VALUE;    ///< ISRC2 packet content
    MS_U16 PKT_ISRC1_VALUE;    ///< ISRC1 packet content
    MS_U16 PKT_ACP_VALUE;    ///< ACP packet content
    MS_U16 PKT_ONEBIT_AUD_VALUE;    ///< ONE bit AUD packet content
} HDMI_EX_PACKET_VALUE;

typedef struct
{
    MS_U8 AVMuteStatus;
    MS_U8 AudioNotPCM;
    MS_U8 PreAudiostatus;
    MS_U8 ChecksumErrOrBCHParityErr;
    MS_U8 PacketColorFormat;
    MS_U8 AspectRatio;
    MS_U8 AudioPacketErr;
    MS_U8 ACPType;
} HDMI_EX_PACKET_STATUS;


typedef struct
{
    HDMI_EX_PACKET_VALUE enPKT_Value;
    HDMI_EX_PACKET_STATUS enPKT_Status;
} HDMI_EX_PACKET_INFO, *P_HDMI_EX_PACKET_INFO;

/// HDCP STATUS INFO structure
typedef struct
{
    MS_BOOL b_St_HDMI_Mode;     ///> HDCP_STATUS[0] & BIT0
    MS_BOOL b_St_Reserve_1;     ///> (HDCP_STATUS[0] & BIT1)>>1
    MS_BOOL b_St_HDCP_Ver;      ///> (HDCP_STATUS[0] & BIT2)>>2
    MS_BOOL b_St_AVMute;        ///> (HDCP_STATUS[0] & BIT3)>>3
    MS_BOOL b_St_ENC_En;        ///> (HDCP_STATUS[0] & BIT4)>>4
    MS_BOOL b_St_AKsv_Rcv;      ///> (HDCP_STATUS[0] & BIT5)>>5
    MS_BOOL b_St_ENC_Dis;       ///> (HDCP_STATUS[0] & BIT6)>>6
    MS_BOOL b_St_Reserve_7;     ///> (HDCP_STATUS[0] & BIT7)>>7
} HDCP_EX_STATUS_INFO;

/// HDMI Black Level
typedef enum
{
    E_HDMI_EX_BLACK_LEVEL_LOW = 0,    ///> HDMI black level low
    E_HDMI_EX_BLACK_LEVEL_HIGH,    ///> HDMI black level high
} HDMI_EX_BLACK_LEVEL;

/// VGA/DVI/HDMI EDID
typedef enum
{
    E_XC_EX_PROG_DVI0_EDID = 0x00,
    E_XC_EX_PROG_DVI1_EDID = 0x01,
    E_XC_EX_PROG_DVI2_EDID = 0x02,
    E_XC_EX_PROG_DVI3_EDID = 0x03,
    E_XC_EX_PROG_VGA_EDID  = 0x10,
} XC_EX_DDCRAM_PROG_TYPE;

typedef struct
{
    MS_U8 *EDID;                            ///< customer EDID
    MS_U16 u16EDIDSize;                       ///< 128 for VGA/DVI , 256 for HDMI
    XC_EX_DDCRAM_PROG_TYPE eDDCProgType;     ///< what kind of DDCRam to program

    MS_U16 u16CECPhyAddr;                   ///< if only 1 Digital DDCRam (get this information from MApi_XC_GetInfo()), you need to specify CEC physical address here
    MS_U8  u8CECPhyAddrIdxL;                ///< start point of CEC physical address (low byte) in EDID
    MS_U8  u8CECPhyAddrIdxH;                ///< start point of CEC physical address (high byte) in EDID
} XC_EX_DDCRAM_PROG_INFO;

////===========================>>HDCP

#ifndef DRVXC_HDMI_IF_H
///HDCP polling status
typedef struct
{
    MS_BOOL bHPD_OK;    ///< HPD OK
    MS_U16     u16HPD_Counter;    ///< HPD times counter
    MS_U16     u16HDCP_KeyCounter;    /// > HDCP key number
    MS_U16     u16HDCP_KeyChkSum;    ///> HDCP key check sum
    MS_BOOL bIsPullHighHPD;    ///> HPD is high or not
    MS_U8      u8BKSV[5];    ///> BKSV

} HDCP_POLLING_STATUS_t;
#endif

/**
 *  The return value for HDMI fuction.
 */
typedef enum
{
    /// fail
    E_HDMI_EX_RET_FAIL = 0,
    /// success
    E_HDMI_EX_RET_OK,
} HDMI_EX_RET_VALUE;


// HDMI v1.4 new feature - T8 and T9
typedef enum
{
    E_HDMI_EX_NO_ADDITIONAL_FORMAT, // 000
    E_HDMI_EX_4Kx2K_FORMAT,                 // 001
    E_HDMI_EX_3D_FORMAT,                      // 010
    E_HDMI_EX_RESERVED,                         // 011 ~ 111
    E_HDMI_EX_NA                                     // Not available
} HDMI_EX_ADDITIONAL_VIDEO_FORMAT;

typedef enum
{
    E_HDMI_EX_VIC_4Kx2K_30Hz = 0x01, // 1920(x2)x1080(x2) @ 29.97/30Hz
    E_HDMI_EX_VIC_4Kx2K_25Hz = 0x02, // 1920(x2)x1080(x2) @ 25Hz
    E_HDMI_EX_VIC_4Kx2K_24Hz = 0x03, // 1920(x2)x1080(x2) @ 23.976/24Hz
    E_HDMI_EX_VIC_4Kx2K_24Hz_SMPTE = 0x04, // 2048(x2)x1080(x2) @ 24Hz
    E_HDMI_EX_VIC_RESERVED,                // 0x00, 0x05 ~ 0xFF
    E_HDMI_EX_VIC_NA                             // Not available
} HDMI_EX_VIC_4Kx2K_CODE;

typedef enum
{
    E_HDMI_EX_3D_EXT_DATA_HOR_SUB_SAMPL_0,      //0000
    E_HDMI_EX_3D_EXT_DATA_HOR_SUB_SAMPL_1,      //0001
    E_HDMI_EX_3D_EXT_DATA_HOR_SUB_SAMPL_2,      //0010
    E_HDMI_EX_3D_EXT_DATA_HOR_SUB_SAMPL_3,      //0011
    E_HDMI_EX_3D_EXT_DATA_QUINCUNX_MATRIX_0,    //0100
    E_HDMI_EX_3D_EXT_DATA_QUINCUNX_MATRIX_1,    //0101
    E_HDMI_EX_3D_EXT_DATA_QUINCUNX_MATRIX_2,    //0110
    E_HDMI_EX_3D_EXT_DATA_QUINCUNX_MATRIX_3,    //0111
    E_HDMI_EX_3D_EXT_DATA_RESERVE,              //1000 ~ 1111
    E_HDMI_EX_3D_EXT_DATA_MODE_MAX,
} HDMI_EX_3D_EXT_DATA;

typedef enum
{
    E_HDMI_EX_3D_META_DATA_PARALLAX_ISO23002_3,      //0000
    E_HDMI_EX_3D_META_DATA_RESERVE,              //001 ~ 1111
    E_HDMI_EX_3D_META_DATA_MAX,
} HDMI_EX_3D_META_DATA_TYPE;

typedef struct
{
    MS_BOOL b3D_Meta_Present;
    HDMI_EX_3D_META_DATA_TYPE t3D_Metadata_Type;
    MS_U8 u83D_Metadata_Length;
    MS_U8 u83D_Metadata[23]; // Maximum length of VS is 31 - 8 = 23
} HDMI_EX_3D_META_FIELD;

// Debug
/**
*   HDMI Info
*/
typedef struct
{
    MS_U8 u8SupportPorts;
} HDMI_EX_INFO;

/**
*   HDMI Status
*/
typedef struct
{
    MS_BOOL bIsInitialized;
    MS_BOOL bIsRunning;
} HDMI_EX_Status;


//-------------------------------------------------------------------------------------------------
//  Function and Variable
//-------------------------------------------------------------------------------------------------

//HDMI/DVI
DLL_PUBLIC extern HDMI_POLLING_STATUS_t    g_HdmiPollingStatus;

//HDCP
DLL_PUBLIC extern HDCP_POLLING_STATUS_t    g_HdcpPollingStatus;

DLL_PUBLIC extern MS_U16 g_AVMUTEMissingCounter;
DLL_PUBLIC extern MS_U16 g_AVIMissingCounter;
DLL_PUBLIC extern MS_U16 g_ACPMissingCounter;

#ifdef DVI_NEW_Patch
    // 20081226 - DVI+HDCP snow noise patch - start ...
DLL_PUBLIC extern MS_U16 g_DVI70MhzPollingCounter;
DLL_PUBLIC extern MS_U8 g_DVI70MhzUnstableCounter;
DLL_PUBLIC extern MS_BOOL g_bDVILess70MHz;
    // 20081226 - DVI+HDCP snow noise patch - end ...
#endif


//HDMI
DLL_PUBLIC INTERFACE HDMI_EX_RET_VALUE  MDrv_HDMI_EX_GetLibVer(const MSIF_Version **ppVersion);      ///< Get version (without Mutex protect)
DLL_PUBLIC INTERFACE HDMI_EX_RET_VALUE  MDrv_HDMI_EX_GetInfo(HDMI_EX_INFO *pInfo);
DLL_PUBLIC INTERFACE HDMI_EX_RET_VALUE  MDrv_HDMI_EX_GetStatus(HDMI_EX_Status *pStatus);
DLL_PUBLIC INTERFACE MS_BOOL MDrv_HDMI_EX_Get_AVIInfoActiveInfoPresent(void);

DLL_PUBLIC INTERFACE MS_U16 MDrv_HDMI_EX_Func_Caps(void);
DLL_PUBLIC INTERFACE void MDrv_HDMI_EX_init( XC_DEVICE_ID *pDeviceId );
DLL_PUBLIC INTERFACE void MDrv_HDMI_EX_Exit( XC_DEVICE_ID *pDeviceId );
DLL_PUBLIC INTERFACE void MDrv_HDMI_EX_pkt_reset( XC_DEVICE_ID *pDeviceId, HDMI_EX_REST breset );
DLL_PUBLIC INTERFACE void MDrv_HDMI_EX_pullhpd( MS_BOOL bHighLow, E_MUX_INPUTPORT enInputPortType, MS_BOOL bInverse);
DLL_PUBLIC INTERFACE MS_U16 MDrv_HDMI_EX_GC_Info(HDMI_EX_GControl_INFO gcontrol);
DLL_PUBLIC INTERFACE HDMI_EX_PACKET_VALUE MDrv_HDMI_EX_Packet_Received(MS_BOOL bEnable);
DLL_PUBLIC INTERFACE HDMI_EX_COLOR_FORMAT MDrv_HDMI_EX_Get_ColorFormat(void);
DLL_PUBLIC INTERFACE HDMI_EX_COLOR_RANGE MDrv_HDMI_EX_Get_ColorRange(void);
DLL_PUBLIC INTERFACE HDMI_EX_CONTENT_TYPE MDrv_HDMI_EX_Get_Content_Type(void);
DLL_PUBLIC INTERFACE HDMI_EX_EXT_COLORIMETRY_FORMAT MDrv_HDMI_EX_Get_ExtColorimetry(void);


DLL_PUBLIC INTERFACE void MDrv_HDMI_EX_Set_EQ(XC_DEVICE_ID *pDeviceId, HDMI_EX_EQ enEq, MS_U8 u8EQValue);
DLL_PUBLIC INTERFACE MS_BOOL MDrv_HDMI_EX_Set_EQ_To_Port(XC_DEVICE_ID *pDeviceId, HDMI_EX_EQ enEq, MS_U8 u8EQValue, E_MUX_INPUTPORT enInputPortType);
DLL_PUBLIC INTERFACE void MDrv_HDMI_EX_Audio_MUTE_Enable(MS_U16 u16MuteEvent, MS_U16 u16MuteMask);
DLL_PUBLIC INTERFACE void MDrv_HDMI_EX_Audio_Status_Clear(void);

DLL_PUBLIC INTERFACE HDMI_EX_AR_TYPE MDrv_HDMI_EX_Get_AspectRatio(MS_BOOL bEn_PAR, MS_BOOL bEn_AFAR);
DLL_PUBLIC INTERFACE HDMI_EX_AR_TYPE MDrv_HDMI_EX_Get_ActiveFormat_AspectRatio(MS_BOOL bEn_AFAR);
DLL_PUBLIC INTERFACE HDMI_EX_AVI_INFOFRAME_VERSION MDrv_HDMI_EX_Get_AVIInfoFrameVer(void);

DLL_PUBLIC INTERFACE MS_U8 MDrv_HDMI_EX_err_status_update(MS_U8 u8value, MS_BOOL bread);
DLL_PUBLIC INTERFACE void MDrv_HDMI_EX_Get_PollingStatus(HDMI_POLLING_STATUS_t **pStatus);
DLL_PUBLIC INTERFACE MS_BOOL MDrv_HDMI_EX_IsHDMI_Mode(void);

DLL_PUBLIC INTERFACE void MDrv_HDMI_EX_Get_MID_info(MS_U8 * pu8ManufactorData);
DLL_PUBLIC INTERFACE MS_BOOL MDrv_HDMI_EX_get_packet_value(HDMI_EX_PACKET_STATE u8state, MS_U8 u8byte_idx, MS_U8 *pValue);

//DVI
DLL_PUBLIC INTERFACE MS_U16 MDrv_DVI_EX_ChannelPhaseStatus( HDMI_EX_DVI_CHANNEL_TYPE u8Channel);
DLL_PUBLIC INTERFACE void MDrv_DVI_EX_SoftwareReset( MS_U16 u16Reset );
DLL_PUBLIC INTERFACE void mdrv_dvi_ex_reset(XC_DEVICE_ID *pDeviceId);
DLL_PUBLIC INTERFACE void MDrv_DVI_EX_ClkPullLow(MS_BOOL bPullLow, E_MUX_INPUTPORT enInputPortType);
DLL_PUBLIC INTERFACE void MDrv_DVI_EX_SwitchSrc(E_MUX_INPUTPORT enInputPortType);
DLL_PUBLIC INTERFACE MS_BOOL MDrv_HDMI_EX_SetForClockLessThan70Mhz( E_MUX_INPUTPORT InputSourceType  );
DLL_PUBLIC INTERFACE void MDrv_HDMI_EX_dvi_adjust( MS_BOOL bClockLessThan70MHz);
DLL_PUBLIC INTERFACE void MDrv_HDMI_EX_SetUpdatePhaseLineCount(XC_DEVICE_ID *pDeviceId, XC_EX_INPUT_SOURCE_TYPE enInputSourceType);
//DLL_PUBLIC INTERFACE MS_U16 MDrv_HDMI_GetTMDSFreq(void);

//HDCP
DLL_PUBLIC INTERFACE void MDrv_HDCP_EX_Enable(XC_DEVICE_ID *pDeviceId, MS_BOOL bEnable);
DLL_PUBLIC INTERFACE MS_BOOL MDrv_HDMI_EX_SetHdcpEnable(E_MUX_INPUTPORT enInputPortType,MS_BOOL bEnable);
DLL_PUBLIC INTERFACE void MDrv_HDCP_EX_ClearStatus( XC_DEVICE_ID *pDeviceId );
DLL_PUBLIC INTERFACE void MDrv_HDCP_EX_initproductionkey( MS_U8 * pu8HdcpKeyData );
DLL_PUBLIC INTERFACE HDCP_EX_STATUS_INFO* MDrv_HDCP_EX_GetStatus(XC_DEVICE_ID *pDeviceId);
DLL_PUBLIC INTERFACE void MDrv_HDCP_EX_Vsync_end_en(MS_BOOL bStable);

//Audio
DLL_PUBLIC INTERFACE void MDrv_HDMI_EX_audio_output( MS_BOOL bEnable );
DLL_PUBLIC INTERFACE MS_U8 MDrv_HDMI_EX_audio_cp_hdr_info(void);
DLL_PUBLIC INTERFACE MS_U8 MDrv_HDMI_EX_audio_channel_status(MS_U8 u8byte);

// DDC Ram
DLL_PUBLIC INTERFACE void MDrv_HDMI_EX_READ_DDCRAM(XC_EX_DDCRAM_PROG_INFO *pstDDCRam_Info, MS_U32 u32SizeOfInfo);
DLL_PUBLIC INTERFACE void MDrv_HDMI_EX_PROG_DDCRAM(XC_EX_DDCRAM_PROG_INFO *pstDDCRam_Info, MS_U32 u32SizeOfInfo);
DLL_PUBLIC INTERFACE MS_U8 MDrv_HDMI_EX_Get_Pixel_Repetition(void);

//#if defined(CHIP_T8) || defined(CHIP_J2) // HDMI 1.4 new feature
DLL_PUBLIC INTERFACE void MDrv_HDMI_EX_3D_4Kx2K_Process(void);
DLL_PUBLIC INTERFACE void MDrv_HDMI_EX_AVG_ScaleringDown(MS_BOOL btrue);
DLL_PUBLIC INTERFACE MS_BOOL MDrv_HDMI_EX_Check4K2K(void);
DLL_PUBLIC INTERFACE HDMI_EX_ADDITIONAL_VIDEO_FORMAT MDrv_HDMI_EX_Check_Additional_Format(void);
DLL_PUBLIC INTERFACE XC_EX_3D_INPUT_MODE MDrv_HDMI_EX_Get_3D_Structure(void);
DLL_PUBLIC INTERFACE HDMI_EX_3D_EXT_DATA MDrv_HDMI_EX_Get_3D_Ext_Data(void);
DLL_PUBLIC INTERFACE void MDrv_HDMI_EX_Get_3D_Meta_Field(HDMI_EX_3D_META_FIELD *pdata);
DLL_PUBLIC INTERFACE MS_U8 MDrv_HDMI_EX_Get_VIC_Code(void);
DLL_PUBLIC INTERFACE HDMI_EX_VIC_4Kx2K_CODE MDrv_HDMI_EX_Get_4Kx2K_VIC_Code(void);
// HDMI ARC pin control
DLL_PUBLIC INTERFACE void MDrv_HDMI_EX_ARC_PINControl(E_MUX_INPUTPORT enInputPortType, MS_BOOL bEnable, MS_BOOL bDrivingHigh);
//#endif


#if 0
INTERFACE MS_U8 u8PSDVIStableCount[4];
void MDrv_HDMI_ImmeswitchPS_Handler(void);
void MDrv_DVI_ForceAllPortsEnterPS(void);
#endif
#undef INTERFACE


#ifdef __cplusplus
}
#endif

#endif /* DRVXC_HDMI_IF_EX_H */