cmdlist.txt

VoyagerGX display driver for Windows CE .NET 5.XX Silicon Motion, Inc. VoyagerGX Driver is architec

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


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 non-cmdlist driver will be built

Where options are:
* SMI_CMDLIST: When this option is set to 1, the compiler will enable the
  Command List driver.

* SMI_CMDLIST_CEPC When this option is set to 1, the compiler will enable the
  Command List driver for CEPC.

* SMI_CMDLIST_SYS: When this option is not set, the compiler will enable the 
  video memory Command List driver. The physical base address of Command List
  buffer is decided by driver. When this option is set to 1, the compiler will 
  enable the system memory Command List driver. See registry settings below to set
  the physical base address of Command List buffer. Config.bib file is also required
  to change accordingly. Hostcfg.bib is a reference config.bib for host interface
  system. Pcicfg.bib is a reference config.bib for PCI bus system. 


Registry Settings
-----------------
Registry Settings determine the mode sets by the driver when it first loads up
(See Setup section on how to specify them). 

* The default registry format is as follows:

[HKEY_LOCAL_MACHINE\Drivers\Display\SMIVGX]
; For Screen Size, Panel Size, and Bpp
  "CxPanel"		=	dword:{any value in hex, as supported by driver}
  "CyPanel"		=	dword:{any value in hex, as supported by driver}
  "CxScreen"	=	dword:{any value in hex, as supported by driver}
  "CyScreen"	=	dword:{any value in hex, as supported by driver}
  "CxZoom"		=	dword:{any value in hex, as supported by driver}
  "CyZoom"		=	dword:{any value in hex, as supported by driver}
  "CursorZoom"	=	dword:{0, 1}
  "Bpp"	  		=	dword:{8, 10, 20}
  "RefreshRate"	=	dword:{any value in hex, as supported by driver}
  "TestClock"	=	dword:{any value in hex, as installed on the VGX board}

; For Host-based driver
  "FB_BASE" 	= dword:{base physical address in hex}
  "FG_BASE" 	= dword:{register physical address in hex}

;Hitachi PFM_DS8P
  "FB_BASE"		= dword:10000000
  "FG_BASE"		= dword:13E00000

;ACCELENT IDP_PXA250_NET
  "FB_BASE"		= dword:08000000
  "FG_BASE"		= dword:0BE00000

;STELLCOM Peacock
  "FB_BASE"		= dword:10000000
  "FG_BASE"		= dword:13E00000

; For Command List driver if the Command List buffer in system memory
    "CMDLISTBUF_ADDR"  = dword:{Command List buffer physical address in system memory}
    "CMDLISTBUF_SIZE"  = dword:{Command List buffer size in bytes in system memory}
    "SDRAM_BASE"       = dword:{Voyager SDRAM base}

; For CEPC PCI system
    "CMDLISTBUF_ADDR"  = dword:80400000 
    "CMDLISTBUF_SIZE"  = dword:200000
    "SDRAM_BASE"       = dword:80000000

; For STELLCOM Peacock
    "CMDLISTBUF_ADDR"  = dword:84040000 
    "CMDLISTBUF_SIZE"  = dword:E0000
    "SDRAM_BASE"       = dword:84000000

; For SMI Special Modes

; For Rotation Feature
  "Angle"		=	dword:{0,5A,B4,10E}

; For Multimon support
[HKEY_LOCAL_MACHINE\SYSTEM\GDI\MONITORS]
  "TOTAL MONITORS" = dword:{number of monitors} 

; NOTE: Bpp option has to be the same across all monitors (WinCE limitation)
[HKEY_LOCAL_MACHINE\Drivers\Display\SMIVGX\MONITOR0]
; Specify Panel settings and refresh rate for first monitor, as necessary

[HKEY_LOCAL_MACHINE\Drivers\Display\SMIVGX\MONITOR1]
; Specify Panel settings and refresh rate for second monitor, as necessary

[HKEY_LOCAL_MACHINE\Drivers\Display\SMIVGX\MONITOR2]
; Specify Panel settings and refresh rate for third monitor, as necessary

[HKEY_LOCAL_MACHINE\Drivers\Display\SMIVGX\MONITOR3]
; Specify Panel settings and refresh rate for fourth monitor, as necessary



* The definitions are:
  - CxPanel, CyPanel: Panel width and height.
  		If not specified, CxPanel and CyPanel will be defaulted to 800x600 

  - CxScreen, CyScreen: Screen width and height (Display mode resolution).
		If not specified, CxScreen and CyScreen will be the same as on 
		CxPanel and CyPanel.
	NOTE1: The difference between Panel and Screen is that CxPanel and CyPanel
	    determine the physical dimension of the panel while CxScreen and 
		CyScreen determine the dimension of the screen desktop.
	NOTE2: CxScreen & CyScreen less than CxPanel & CyPanel is not supported.
	NOTE3: Panning is NOT supported for the second monitor in the DualMon feature.

  - CxZoom, CyZoom: Zoom width and height.
  		If not specified, CxZoom and CyZoom will be disabled. 
  
  - CursorZoom: Enable or Disable Cursor Zooming in Zoom-In/Zoom-Out mode.
		If not specified, CursorZooom will be disabled.

  - Bpp: Number of bits of colors for one pixel.  
 	    If not specified, Bpp is defaulted to 16-bpp mode.

  - RefreshRate: Refresh rate / vertical frequency of monitors/panels.
 	    If not specified, RefreshRate is defaulted to 60 Hz.

  - TestClock: The frequency of the test clock installed and used on the board.
		Do NOT set this setting if internal clock is used!
		This registry ONLY for SPECIAL cases only!
		If not specified, TestClock is defaulted to 133Mhz for rev. A chips.

  - FB_BASE:  For Host-based driver only!
        Specify the physical address of the VGX frame buffer.

  - FG_BASE:  For Host-based driver only!
        Specify the physical address of the VGX register MMIO.

  - Angle: Angle of rotation 0(0), 90(0x5A), 180(0xB4), and 270(0x10E),
  		only if Rotation feature is enabled.
		If not specified, Angle is defaulted to 0.


Limitations
-----------
Due to Voyager/GX RevAA hardware limitations, Command List buffer can not be in system memory on PCI bus systems (include CEPC).