Windows CE .NET VoyagerGX driver information
==============================================

Introduction
------------
Silicon Motion, Inc. VoyagerGX Driver is architected from the beginning
to support variety of features and extension of Windows CE .NET, such as 
DirectDraw feature, Dynamic Rotation feature, Multimon feature, SMI Multimon
Emulation feature (using single VoyagerGX chip to drive two independent
displays), WCEfA (Windows CE for Automotive) feature, and more. 


Setup
-----
+ VoyagerGX display driver setup information for Windows CE 6.0
* copy  the source files to "$(_WINCEROOT)\3rdparty\Silicon_motion\SMIVGX\"
* copy  the smivgx6.pbcxml to "$(_WINCEROOT)\PUBLIC\COMMON\CATALOG".
  Then Silicon Motion VoyagerGX driver option will be in the Platform Builder 
  Catalog Items View.
* Select the VoyagerGX display driver to the current platform.
* Change the VoyagerGX Windows CE registry settings
  - The registry is used to specify the special modes and panels
  - Edit smivgx.reg (or any .reg files, as preferred)
  - Add the following lines, and specify the registry options (See Registry Settings 
    section):
    IF BSP_DISPLAY_SMIVGX
    [HKEY_LOCAL_MACHINE\System\GDI\Drivers]
       "Display"="ddi_vgx.dll"
    [HKEY_LOCAL_MACHINE\Drivers\Display\SMIVGX]
	; Specify VoyagerGX registry options below here
    ENDIF
*Add ddi_vgx.dll module info to smivgx.BIB files, as shown below:
   IF BSP_DISPLAY_SMIVGX
	   ddi_vgx.dll          $(_FLATRELEASEDIR)\ddi_vgx.dll              NK  SHK
   ENDIF BSP_DISPLAY_SMIVGX
    
    
* Multiple Adapter Feature support process,ignore it if not include the feature
  - Open catalog\Core OS\Windows CE device\Graphics and  Multimedia Technologies\Graphic
        Add "Multiple Monitor Support" to OS Design
  - Add the following to smivgx.reg (or any .reg files, as preferred)
         [HKEY_LOCAL_MACHINE\System\GDI\Monitors]
         "Total Monitors"=dword:{number}
  -If open Dual Head,as  use two adapter to get four monitor,add the enviroment setting 
       "SMI_MMEMU"=1  in Platform Property setting.


* Build the VoyagerGX driver
  - To build the whole platform, click Build\Build solution or Build\Rebuild solution
  - To rebuild the driver separately, right click on VoyagerGX and 
     select "Build" or "Rebuild" and then click Build\Make run_time image


* How to load Voyager dirver binary file DDI_VGX.DLL directly
    - Copy file DDI_VGX.DLL to  directory $(_FLATRELEASEDIR)\
    - Add ddi_vgx.dll module info to COMMON.BIB files, as shown below:
         IF BSP_DISPLAY_SMIVGX
	    ddi_vgx.dll          $(_FLATRELEASEDIR)\ddi_vgx.dll              NK  SHK
         ENDIF BSP_DISPLAY_SMIVGX
    - Change the VoyagerGX Windows CE registry settings by edit common.reg (or any .reg files),   
         (See Registry Settings section):
        IF BSP_DISPLAY_SMIVGX
        [HKEY_LOCAL_MACHINE\System\GDI\Drivers]
       "Display"="ddi_vgx.dll"
        [HKEY_LOCAL_MACHINE\Drivers\Display\SMIVGX]
	; Specify VoyagerGX registry options below here
       ENDIF
    - Click Build\Build solution or Build\Rebuild solution,to build the whole platform






+ VoyagerGX display driver setup information for Windows CE .NET 5.XX
* Run the provided SMIVGX.msi installation executables to copy
  the source files to "$(_WINCEROOT)\3rdparty\Silicon_motion\SMIVGX\"
  and set up Silicon Motion VoyagerGX driver option in the Platform Builder 
  Catalog Features.

* Add the VoyagerGX display driver to the current platform.

* Change the VoyagerGX Windows CE registry settings
  - The registry is used to specify the special modes and panels
  - Click on "Parameters" tab, edit common.reg (or any .reg files, as preferred)
  - Add the following lines, and specify the registry options (See Registry Settings 
    section):
    IF BSP_DISPLAY_SMIVGX
    [HKEY_LOCAL_MACHINE\System\GDI\Drivers]
       "Display"="ddi_vgx.dll"
    [HKEY_LOCAL_MACHINE\Drivers\Display\SMIVGX]
	; Specify VoyagerGX registry options below here
    ENDIF


* Add ddi_vgx.dll module info to .BIB files, as shown below:
	IF BSP_DISPLAY_SMIVGX
	   ddi_vgx.dll          $(_FLATRELEASEDIR)\ddi_vgx.dll              NK  SH
	ENDIF BSP_DISPLAY_SMIVGX

* Multiple Adapter Feature support process,ignore it if not include the feature
  - Open catalog\Core OS\Windows CE device\Graphics and  Multimedia Technologies\Graphic
        Add "Multiple Monitor Support" to OS Design
  - Add the following to common.reg 
         [HKEY_LOCAL_MACHINE\System\GDI\Monitors]
         "Total Monitors"=dword:4
  -If open Dual Head,as  use two adapter to get four monitor,add the enviroment setting 
       "SMI_MMEMU"=1 in Platform Property setting.


* Build the VoyagerGX driver
  - To build the whole platform, click Build\Build Platform or Build\Rebuild Platform
  - To rebuild the driver separately, right click on VoyagerGX and 
     select "Build Selected Features" and then click Build\MakeImg





+ VoyagerGX driver initial setup information for Windows CE .NET 4.XX
* Copy source codes or binary dll file to 
  "$(_WINCEROOT)\public\common\oak\DRIVERS\DISPLAY\SMIVGX\"
  Where $(_WINCEROOT) is the installation location of the Windows CE .NET,
  usually defaulted to C:\WINCE400

* Import VoyagerGX driver feature to Catalog, as follows:
  - Click on File\Manage Catalog Features. 
  - Remove any older smivgx.cec file from the list, if any.
  - Click Import and get the smivgx.cec from the directory above.
  - Click Refresh, if necessary.

* Include VoyagerGX driver to the platform, as follows:
  - Find any Display driver instances on the FeatureView of Platform builder
    (including older VoyagerGX and NULL instances) and remove them all.
  - Drag ONLY one of the Catalog\Device Driver\SMI VoyagerGX Family features 
    (source code or binary dll only) to the FeatureView

* Change the build settings of VoyagerGX driver, ie. Rotation driver, 
  Non Direct Draw driver, etc., as follows:
  - Right click on VoyagerGX driver, and select Settings
  - Select "Custom Build" tab, in Build Step "Feature Build", 
    Change any necessary environment settings (See Environment Settings section 
    for more info).

* Change the VoyagerGX Windows CE registry settings
  - The registry is used to specify the special modes and panels
  - Click on "Parameters" tab, edit common.reg (or any .reg files, as preferred)
  - Add the following lines, and specify the registry options (See Registry Settings 
    section):
    IF BSP_DISPLAY_SMIVGX
    [HKEY_LOCAL_MACHINE\System\GDI\Drivers]
       "Display"="ddi_vgx.dll"
    [HKEY_LOCAL_MACHINE\Drivers\Display\SMIVGX]
	; Specify VoyagerGX registry options below here
    ENDIF


* Multiple Adapter Feature support process,ignore it if not include the feature
  - Open catalog\Core OS\Display based device\Multimedia Technologies\Multimedia Components
        Add "Multiple Monitor Support" to OS Design
  - Add the following to common.reg 
         [HKEY_LOCAL_MACHINE\System\GDI\Monitors]
         "Total Monitors"=dword:4
  -If open Dual Head,as  use two adapter to get four monitor,add the enviroment setting 
       "SMI_MMEMU"=1 in Platform Property setting.



* No need to add ddi_vgx.dll module info to .BIB files, it is already included by
  smivgx.cec

* Build the VoyagerGX driver
  - To build the whole platform, click Build\Build Platform or Build\Rebuild Platform
  - To rebuild the driver separately, right click on VoyagerGX and 
     select "Build Selected Features" and then click Build\MakeImg
  




Enviroment Settings
-------------------
The enviroment settings should be set before building the driver (See Setup section on
how to specify them), thus the binary-dll driver is not affected by this settings.

If no enviroment settings are set, the DirectDraw-based driver will be built

Where options are:
* SMI_NOLIB: Turn this flag to 1, if you get "gpe_lib.lib not found" error
  messages.

* SMI_HOST: Turn this flag to 1, the compiler will enable the Host interface
  mode. See registry settings below to set the base and register physical 
  address for different platforms.

* SMI_ACCELENT: Turn this flag to 1, together with SMI_HOST to enable Accelent
  host platform compiling.

* SMI_NODD: When this option is set to 1, the compiler will disable the
  DirectDraw feature.

* SMI_WCEFA: When this option is set to 1, the compiler will enable the 
  WCEfA (Windows CE for Automotive) API feature.

* SMI_ROTATION: When this option is set to 1, the compiler will enable the
  special Dynamic Rotation feature. This option automatically set SMI_NODD to 1.

* SMI_MMEMU: When this option is set to 1, the compiler will enable the
  special SMI MultiMon Emulation using single chip to power two different screens
  in any resolutions specified in the registry.

* SMI_DISPPERF: When this option is set to 1, the compiler will enable the
  profiling information for the driver. 

* SMI_UMA: When this option is set to 1, the compiler will enable the UMA support
  for Vytek platform only.

* SMI_DISABLE_INT_MGR: When this option is set to 1, the compiler will disable the 
  interrupt management support.

* SMI_DISABLE_AUTO_PWRMGR: When this option is set to 1, the compiler will disable the 
  auto power management support.

* SMI_NOBOOTARG: When this option is set to 1, the compiler will disable the