readme.txt

wince 下ＬＹＮＸ３ＤＭ的 3d 图形显示驱动 在wince ５．０ 下的驱动代码．

						Readme.txt for Windows CE release
						---------------------------------

Configuration:
=============

The platform directory needs to be updated in order to compile our driver and
set the various options. Here is a complete list:

* SMI source code: The SMI source code should reside in the
  %_TARGETPLATROOT%\Drivers\Display directory in a subdirectory called SMI. The
  DIRS file in the %_TARGETPLATROOT%\Drivers\Display directory should include
  this new directory in the DIRS list.

* The %_TGTPLAT%.BAT file in the %_TARGETPLATROOT% directory should have the
  following extra options:

	SET BSP_DISPLAY_SMI=1
	SET SMI_WCEFA=1	;if you are compiling for an Automotive platform (WCEfA)

  For Windows CE 4.0, SMI4.cec may need to be imported into the Catalog by
  using File\Manage Catalog Feature\Import function (Please first remove older 
  instances of SMI based cec, if any). Then add one of SMI Display options to 
  the platform features (Remove any other instances of Display options ie. VGA
  Linear (Flat) Framebuffer, etc).  

* Change the PLATFORM.BIB in the %_TARGETPLATROOT%\Files directory like this:

    IF BSP_DISPLAY_SMI !
      ; all other instances of the ddi.dll file
    ENDIF
    IF BSP_DISPLAY_SMI
      ddi.dll $(_FLATRELEASEDIR)\ddi_smi.dll NK SH
    ENDIF

    If you are using a SVPMI file, copy it into the %_TARGETPLATROOT%\Files
    directory and add the following lines at the end of the PLATFORM.BIB file
    (this sample assumes a SVPMI file with the name sm710.pmi):

    FILES
    IF BSP_DISPLAY_SMI
      sm710.pmi $(_FLATRELEASEDIR)\sm710.pmi NK SH
    ENDIF

* Change the PLATFORM.REG in the %_TARGETPLATROOT%\Files directory to include
  any options you want.

* Resolutions and colors: The mode resolutions are determined by registry setting or 
  MD line 10 and 11 (DIP switch bit 3 and 4 on the SMI demo board).  The driver
  searches registry first, and ignores DIP switch settings if the parameters
  specified in the registry are found and matched in the driver.  Otherwise, 
  the DIP switch is used.  The driver supports 8, 16, and 24 bit colors, 
  specified by the registry only. The registry and DIP switch are defined 
  in the following tables:
  
				 Registry Table 
	_______________________________________________________________________

   	CxScreen, CyScreen: Screen width and height, respectively.  

 	Bpp: Number of colors.  
 	     The default setting is 8-bpp if the registry is not specified.

	DisplayMode: Change the start-up Display mode. Do NOT use this option, 
	             UNLESS specified by SMI.
	             List of values: 0x0 for no display mode, 
	                             0x1 for LCD mode, 
	                             0x2 for CRT mode.
                 The Default value is 0x3 for Simul mode.

 	SaveSurface: Enable saving/restoring surface video memory 
  		     to system memory during Suspend/Resume mode.

	LVDSPanel: For special LVDS-type panel. 
		It will enable the special LVDS Panel bit for Lynx3DM only.

	PanelSettings: To set Panel Type Select FPR30 without using MD Lines
		Set the value according to the definition of FPR30 in the SMI databook.

 	AutoPC: For special Toshiba 400x234 panel. 
 		It will switch to 400x234 in 8-bpp mode or 16-bpp mode 
 		depending on Bpp setting.

 	TruckPC: For special EL 320x80 STN Panel. 
 		 It will switch to 320x80 in 8-bpp mode.

 	VirtualResX & VirtualResY: To specify a virtual (panning) resolution 
 				   larger than the panel. 

 	PMI: Use this parameter to specifiy the location and name of the SVPMI 
 	     file. For example, "\\WINDOWS\\SM710.PMI". Be sure to put the 
 	     "\\WINDOWS\\" in front of the name; this is where the flies are 
 	     loaded inside the image.

 	DualApp: For DualApp mode support, which extends the desktop size to two
 		 different monitors.

	P350: For special SHARP 640x350 panel(LQ058T5DRQ1).  
	       It will switch to 640x350 in 16-bpp mode.

	P480234: For special Toshiba 480x234 panel. 
  		 It will switch to 480x234 in 16-bpp mode.

 	PTosh400234NT: For special Toshiba 400x234 panel(TFD58W03-MM) NexTech. 
  		       It will switch to 400x234 16-bpp mode.

 	PSharp320x240: For special Sharp 320x240 panel(LQ039Q2DS02). 
		       It will switch to 320x240 in 16-bpp mode.

	SONYPanel: For special Sony 320x240 panel(ACX704AKM-7). 
		   It will switch to 320x240 in 16-bpp mode.

	PHitachi800x480: For special Hitachi 800x480 panel(TX18D11VM1CAA).
			It will switch to 800x480 16-bpp mode.

	TOSHIBA640x960: For special TOSHIBA 480x960 panel(LTM07C388). 
			It will switch to 640x350 in 16-bpp mode.

	Rotation: Set this parameter to 5A(90), B4 (180) or 10E(270) to select
		  the rotation angle. Used in conjunction with Command Line 
		  options.

	SwCursor:	Select software cursor as default cursor.
	_______________________________________________________________________
        Please see below Registry options for the syntax

 


	  	DIP Switch Table 
	___________________________________

	  DIP	3	4	Resolutions
  		On	On	640x480
		Off	On	800x600
		On	Off	1024x768
		Off	Off	Reserved 	
	___________________________________

* Configuration for Anti-Alias line
  1. Copy the drvstrok.cpp file from
     %_TARGETPLATROOT%\Drivers\Display\SMI\GPE to
     %_TARGETPLATROOT%\Drivers\Display\GPE
  2. Copy the gpe.h file from
     %_TARGETPLATROOT%\Drivers\Display\SMI\GPE to
     %_TARGETPLATROOT%\INC



Features:
========

* DirectDraw based Display Driver: The driver is based on DDGPE model to 
  support various DirectDraw features in WinCE 3.00 and WCEfA 3.00 such as 
  Overlays, Flip, etc.

* DualApp Mode: The desktop size can be extended to two different monitors. 
  This mode is specified in the registry.

* Virtual Mode: The desktop size can be larger than the panel size. For example,
  you can have a panning 1024x768 mode on a 800x600 panel. This is specified in
  the registry.

* AutoPC and TruckPC modes: Special modes are availahle for AutoPC using Toshiba
  panel and TruckPC using Planar panel. These modes are specified in the
  registry.

* SVPMI files: The modes are hard coded into the driver, but with the use of
  industry standard SVPMI (Super VGA Protected Mode Interface) files you can
  override the registry settings. Silicon Motion Inc. can provide an utility to
  create a SVPMI file which can be included into the Windows CE image to
  override any mode settings.




Command Line options:
=====================

The command line option is set before the compiling the source files using
following syntax:
   Command Prompt> Set <Option>=1

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

* SMI_WCEFA: When this option is set to 1, the compiler will enable the usage 
  of the special WCEfA (Windows CE for Automotive) API extension

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

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

* SMI_NOPCIBURST: When this option is set to 1, the compiler will enable the
  code that break the PCI IO Burst(Certain platform cannot handle it)

* SMI_NSW: When this option is set to 1, the compiler will enable the
  support for NSW SA1100 platform and include BCEDDK.lib instead of CEDDK.lib.

* SMI_ITE: When this option is set to 1, the compiler will enable the
  support for ITE SA1100 platform.

* SMI_NMI: When this option is set to 1, the compiler will enable the
  support for NMI uSH4 platform.

* SMI_S1: When this option is set to 1, the compiler will enable the
  support for Hitachi S1 platform. In WinCE 4.0 .Net environment, it also works
  for Hitachi S2 platform.

* SMI_S2: When this option is set to 1, the compiler will enable the
  support for Hitachi S2 platform. In WinCE 4.0 .Net environment, it can't work.

* SMI_ANTIALIAS_LINE: When this option is set to 1, the compiler will enable the
  2D anti-alias line function.

Registry options:
=================
The registry options can be defined in the PLATFORM.REG file located in the 
%_TARGETPLATROOT%\Files directory: 

For Resolutions and BPP:
[HKEY_LOCAL_MACHINE\Drivers\Display\SMI] 
	"CxScreen"	=	dword:{any value in hex}
	"CyScreen"	=	dword:{any value in hex}
	"Bpp"	  	=	dword:{8,10,18}	

For SMI special modes:
[HKEY_LOCAL_MACHINE\Drivers\Display\SMI]
    "DisplayMode" 	= dword:3
	"SaveSurface"	=	dword:1
	"LVDSPanel" 	=	dword:1
	"PanelSettings" =	dword:{0..0xFF}
	"AutoPC"  		=	dword:1
	"TruckPC" 		=	dword:1
	"VirtualResX"	=	dword:{any value in hex}
	"VirtualResY"	=	dword:{any value in hex}
	"PMI"	  		=	"{location of PMI file}"
	"DualApp"       = 	dword:1
	"P350"       	= 	dword:1
	"P480234"      	= 	dword:1
	"PToyo400234"	= 	dword:1
	"PTosh400234NT"	= 	dword:1
	"PSharp320x240" =   dword:1
	"SONYPanel"    	= 	dword:1
	"PHitachi800x480" =	dword:1
    "NoCursor"      =   dword:1						;No hardware cursor shown on screen.
Rotation support (WinCE 4.0 Only):
[HKEY_LOCAL_MACHINE\System\GDI\ROTATION]
	"Angle"=dword:5a ;0, 5A, B4, 10E



Troubleshooting:
================

* Problem: Windows CE image shows black background and some icons.
Solution: Loadcepc /L option are not supported by Lynx driver. Please do not set any resolution
  option while using Loadcepc. VESA Set Mode corrupts the default Lynx video registers, resulting
  in black background.