//**********************************************************************
//                                                                      
// Filename: VideoSetup.h
//                                                                      
// Description: Header file for the Video Setup routines.
//
// THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF
// ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO
// THE IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A
// PARTICULAR PURPOSE.
//
// Use of this source code is subject to the terms of the Cirrus end-user
// license agreement (EULA) under which you licensed this SOFTWARE PRODUCT.
// If you did not accept the terms of the EULA, you are not authorized to 
// use this source code. For a copy of the EULA, please see the 
// LICENSE.RTF on your install media.
//
// Copyright(c) Cirrus Logic Corporation 2002, All Rights Reserved                       
//                                                                      
//**********************************************************************
#ifndef _H_VIDEOSETUP
#define _H_VIDEOSETUP

struct StartStop
{
    ULONG   ulHActiveStart;
    ULONG   ulHActiveStop;    
    ULONG   ulVActiveStart;
    ULONG   ulVActiveStop;    
};

struct Ep931xRegistrySettings 
{
    ULONG   ulScreenWidth;
    ULONG   ulScreenHeight;
    ULONG   ulFrequency;
    ULONG   ulColorDepth;
    ULONG   ulSetDirectly;
    ULONG   ulVLinesTotal;
    ULONG   ulVSyncStartStop;
    ULONG   ulVActiveStartStop;
    ULONG   ulVBlankStartStop;
    ULONG   ulVClockStartStop;
    ULONG   ulHClocksTotal;
    ULONG   ulHSyncStartStop;
    ULONG   ulHActiveStartStop;
    ULONG   ulHBlankStartStop;
    ULONG   ulHClockStartStop;
    BOOL    fInvertPixelClock;
    BOOL    fSleepSignalActive;
    BOOL    fUseCX25871;
    BOOL    fExtVideoClock;
};


//
// Registry value names
//
#define DRIVER_REGISTRY_STRING  (L"Drivers\\Display\\EP931x")

#define REG_VALUE_SCREENWIDTH           TEXT("Width")
#define REG_VALUE_SCREENHEIGHT          TEXT("Height")
#define REG_VALUE_FREQUENCY             TEXT("Frequency")
#define REG_VALUE_COLORDEPTH            TEXT("ColorDepth")
#define REG_VALUE_SETDIRECTLY           TEXT("SetDirectly")
#define REG_VALUE_VLINESTOTAL           TEXT("VLinesTotal")
#define REG_VALUE_VSYNCSTARTSTOP        TEXT("VSyncStartStop")
#define REG_VALUE_VACTIVESTARTSTOP      TEXT("VActiveStartStop")
#define REG_VALUE_VBLANKSTARTSTOP       TEXT("VBlankStartStop")
#define REG_VALUE_VCLOCKSTARTSTOP       TEXT("VClockStartStop")
#define REG_VALUE_HCLOCKSTOTAL          TEXT("HClocksTotal")
#define REG_VALUE_HSYNCSTARTSTOP        TEXT("HSyncStartStop")
#define REG_VALUE_HACTIVESTARTSTOP      TEXT("HActiveStartStop")
#define REG_VALUE_HBLANKSTARTSTOP       TEXT("HBlankStartStop")
#define REG_VALUE_HCLOCKSTARTSTOP       TEXT("HClockStartStop")
#define REG_VALUE_INVERTPIXELCLOCK      TEXT("InvertPixelClock")
#define REG_VALUE_SLEEPSIGNALACTIVE     TEXT("SleepSignalActive")
#define REG_VALUE_USECX25871            TEXT("UseCX25871")
#define REG_VALUE_EXT_VIDEO_CLOCK       TEXT("ExternalVideoClock")

void GetDisplayRegistrySettings
(
    Ep931xRegistrySettings *pRegSetting
);

void CRTVideoSetup
(
    ULONG           ulWidth, 
    ULONG           ulHeight, 
    ULONG           ulColorDepth, 
    ULONG           ulFrequency, 
    ULONG           ulPhysicalFramePointer,
    StartStop *     pStartStop
);


void GenericDisplaySetup
(
    Ep931xRegistrySettings  *pRegSetting,
    ULONG                   ulPhysicalFramePointer,
    StartStop               *pStartStop
);


void InitializeCX25871For640x480NTSC(void);


#endif // _H_VIDEOSETUP