/*****************************************************************************
$Workfile: readme.txt $
$Revision: 16 $
$Date: 6/23/00 12:07p $
$Modtime: 6/23/00 12:07p $
$Author: Sarma $
Copyright (c) 2000 National Semiconductor Corporation.
All Rights Reserved.
This software is the confidential and proprietary information of National
Semiconductor Corporation. ("Confidential Information").
You shall not disclose such Confidential Information and shall use it only
in accordance with the terms of the license agreement you entered into
with National Semiconductor Corporation.
This code is supplied as is.
$Log: /CE/Platform/Nsc/Drivers/Video/gxvideo/doc/readme.txt $
*
* 16 6/23/00 12:07p Sarma
* Added compression enable from registry settings.
* 16BPP env. variable not required and 8/16 can be triggered from
* registry.
*
* 15 6/20/00 3:52p Sarma
* added documentation to use Enable DDC and FrameBufferDepth setting in
* Registry.
*
* 14 6/02/00 8:34a Sarma
* Durango can support 1280x1024x85Hz.
*
* 13 5/02/00 10:55a Sarma
* Modified comments. Need only one mode table for 8/16 in case of
* non-pyramid the 1280x1024x16 defaults to 640x480x16.
*
* 12 5/01/00 9:07a Sarma
* Added Env. Variable to control Durango interface plugin. This was added
* to support Yan for scorpious support as Durnago dosen't seem to work on
* Scorpious.
*
* 11 3/29/00 11:35a Sarma
* Added the docuentation for the Env variable settings. These variables
* control the behaviour of the driver and for what its being built.
*
* 10 10/20/99 9:50a Sarma
* Added compilation flag FB16BPP to control the depth of the framebuffer.
* This can be added in "CDEFINES" sources file by adding "-DFB16BPP".
* Also need to enable CEPC_GX16BPP=1 so that the 1280x1024 is knocked off
* from the resoultions list.
* set CEPC_GX16BPP=1
*
* 9 8/11/99 4:17p Sarma
* Added support for 85Hx resoulution for 640x480, 800x600, 1024x768.
* 1280x1024 dosen't support 85Hz as it is not sable.
*
* 8 11/13/98 11:33a Sarma
* 85 Hz needs to be removed as its not being supported.
*
* 7 11/12/98 4:36p Sarma
* Modified the Installation procedure and the mode setting to modify
* platform.reg. This is much better approach than supplying platform.reg.
*
* 6 11/12/98 4:20p Sarma
* The way to change the display mode when platform.reg is supplied.
*
* 5 11/12/98 4:01p Sarma
* Deleted lines which were left out as a result of Cut-Paste.
*
* 4 11/12/98 3:59p Sarma
* Added Confidential copyright to files with VSS keywords for
* log/history.
* Updated the way the display mode needs to be changed.
$History: readme.txt $
*
* ***************** Version 16 *****************
* User: Sarma Date: 6/23/00 Time: 12:07p
* Updated in $/CE/Platform/Nsc/Drivers/Video/gxvideo/doc
* Added compression enable from registry settings.
* 16BPP env. variable not required and 8/16 can be triggered from
* registry.
*
* ***************** Version 15 *****************
* User: Sarma Date: 6/20/00 Time: 3:52p
* Updated in $/CE/Platform/Nsc/Drivers/Video/gxvideo/doc
* added documentation to use Enable DDC and FrameBufferDepth setting in
* Registry.
*
* ***************** Version 14 *****************
* User: Sarma Date: 6/02/00 Time: 8:34a
* Updated in $/CE/Platform/Nsc/Drivers/Video/gxvideo/doc
* Durango can support 1280x1024x85Hz.
*
* ***************** Version 13 *****************
* User: Sarma Date: 5/02/00 Time: 10:55a
* Updated in $/CE/Platform/Nsc/Drivers/Video/gxvideo/doc
* Modified comments. Need only one mode table for 8/16 in case of
* non-pyramid the 1280x1024x16 defaults to 640x480x16.
*
* ***************** Version 12 *****************
* User: Sarma Date: 5/01/00 Time: 9:07a
* Updated in $/CE/Platform/Nsc/Drivers/Video/gxvideo/doc
* Added Env. Variable to control Durango interface plugin. This was added
* to support Yan for scorpious support as Durnago dosen't seem to work on
* Scorpious.
*
* ***************** Version 11 *****************
* User: Sarma Date: 3/29/00 Time: 11:35a
* Updated in $/CE/Platform/Nsc/Drivers/Video/gxvideo/doc
* Added the docuentation for the Env variable settings. These variables
* control the behaviour of the driver and for what its being built.
*
* ***************** Version 10 *****************
* User: Sarma Date: 10/20/99 Time: 9:50a
* Updated in $/wince/v2.1/gxvideo/doc
* Added compilation flag FB16BPP to control the depth of the framebuffer.
* This can be added in "CDEFINES" sources file by adding "-DFB16BPP".
* Also need to enable CEPC_GX16BPP=1 so that the 1280x1024 is knocked off
* from the resoultions list.
* set CEPC_GX16BPP=1
*
* ***************** Version 9 *****************
* User: Sarma Date: 8/11/99 Time: 4:17p
* Updated in $/wince/v2.1/gxvideo/doc
* Added support for 85Hx resoulution for 640x480, 800x600, 1024x768.
* 1280x1024 dosen't support 85Hz as it is not sable.
*
* ***************** Version 8 *****************
* User: Sarma Date: 11/13/98 Time: 11:33a
* Updated in $/wince/v2.1/gxvideo/doc
* 85 Hz needs to be removed as its not being supported.
*
* ***************** Version 7 *****************
* User: Sarma Date: 11/12/98 Time: 4:36p
* Updated in $/wince/v2.1/gxvideo/doc
* Modified the Installation procedure and the mode setting to modify
* platform.reg. This is much better approach than supplying platform.reg.
*
* ***************** Version 6 *****************
* User: Sarma Date: 11/12/98 Time: 4:20p
* Updated in $/wince/v2.1/gxvideo/doc
* The way to change the display mode when platform.reg is supplied.
*
* ***************** Version 5 *****************
* User: Sarma Date: 11/12/98 Time: 4:01p
* Updated in $/wince/v2.1/gxvideo/doc
* Deleted lines which were left out as a result of Cut-Paste.
*
* ***************** Version 4 *****************
* User: Sarma Date: 11/12/98 Time: 3:59p
* Updated in $/wince/v2.1/gxvideo/doc
* Added Confidential copyright to files with VSS keywords for
* log/history.
* Updated the way the display mode needs to be changed.
*****************************************************************************/
Installation :
==============
Follow the below steps for adding GxVideo Display Driver to Windows CE
developent platform.
1. Copy the supplied GxVideo Source Directory to the following
directory
$(_WINCEROOT)\Platform\<Platform Name>\Drivers\Display
2. Edit the
$(_WINCEROOT)\Platform\<Platform Name>\Drivers\Display\Dirs
file to add the driver directory
Typicaly the file looks like this in $(_WINCEROOT)\Platform\CEPC
DIRS= \
S3trio64 \
S3ViRGE \
vga8bpp \
ct6555x \
OPTIONAL_DIRS= \
Modify it as follows
DIRS= \
GxVideo \
OPTIONAL_DIRS= \
3. Edit the file
$(_WINCEROOT)\Platform\<Platform Name>\Files\platform.bib
to add the GxVideo driver dll.
IF CEPC_DDI_GX
ddi.dll $(_FLATRELEASEDIR)\ddi_gx.dll NK SH
ENDIF
Typicaly the $(_WINCEROOT)\Platform\CEPC\Files\platform.bib
file has the following lines
;
; MGDI Display driver
; The default display driver is the S3Trio64 display
; To use the 8BPP generic VGA set the environment variable
; CEPC_DDI_VGA8BPP to 1. To use the CT driver, set
; CEPC_DDI_CT655X to 1. To use the accelerated S3ViRGE driver
; set CEPC_DDI_S3VIRGE to 1.
IF ODO_NODISPLAY !
IF CEPC_DDI_VGA8BPP
ddi.dll $(_FLATRELEASEDIR)\ddi_vga8.dll NK SH
ENDIF
IF CEPC_DDI_CT655X
ddi.dll $(_FLATRELEASEDIR)\ddi_ct.dll NK SH
ENDIF
IF CEPC_DDI_S3VIRGE
ddi.dll $(_FLATRELEASEDIR)\ddi_s3v.dll NK SH
ENDIF
IF CEPC_DDI_GX
ddi.dll $(_FLATRELEASEDIR)\ddi_gx.dll NK SH
ENDIF
IF CEPC_DDI_S3VIRGE !
IF CEPC_DDI_CT655X !
IF CEPC_DDI_VGA8BPP !
ddi.dll $(_FLATRELEASEDIR)\ddi_s364.dll NK SH
ENDIF
ENDIF
ENDIF
ENDIF
4. Edit the file
$(_WINCEROOT)\Platform\<Platform Name>\Files\platform.reg
By default the following lines are not present in this file
when shipped my Microsoft. The following lines need to be
added in which case. Preferably add to the end of the file.
Make sure if using 16bit depth frame buffer add "-DFB16BPP"
to the CDEFINES variable in Sources file.
IF CEPC_DDI_GX
;1280x1024x8 is supoorted by all CPU's.
;Only Pyramid can support 1280x1024x16.
;On Non-Pyramid when specified 1280x1024x16 driver defaults to 640x480x16.
[HKEY_LOCAL_MACHINE\Hardware\Microsoft\WBT]
"Resolutions"=multi_sz:"640 480 60",
"640 480 72",
"640 480 75",
"640 480 85",
"800 600 60",
"800 600 72",
"800 600 75",
"800 600 85",
"1024 768 60",
"1024 768 70",
"1024 768 75",
"1024 768 85",
"1280 1024 60",
"1280 1024 75",
"1280 1024 85"
[HKEY_LOCAL_MACHINE\Software\Microsoft\WBT]
"Resolution"="640 480 60"
; "EnableDDC"=dword:0
"EnableDDC"=dword:1
; "FrameBufferDepth"=dword:8
"FrameBufferDepth"=dword:10
; "EnableCompression"=dword:0
"EnableCompression"=dword:1
ENDIF
Now you are ready for building a Windows CE OS for GX Based
Display Adapter.
Display Driver Requirements:
============================
The Display Driver assumes that the Scratchpad has been initialized
in the bootloader. The code which does the initialization in
bootloader is given below.
Normally GXM_BASE is 0x40000000, but may alter for your implementation.
; **********************************************************
; initialize the scratch pad for use by video
mov eax, GXM_BASE
mov TR4, eax
;
; fill set 0 cache lines
;
mov eax, ( 00000800h ) or ( 00000001h ) ; 2K of scratch pad
fillCache:
mov TR5, eax
add eax, 10h
cmp eax, 1001h ; scratchpad addresses grow up
jb fillCache
=================================================================================
Registry settings
=================
Change Display Mode:
====================
The current display driver is set for 640x480 8-Bit depth and 60Hz.
To Select the required mode search for the following lines in
platform.reg, which have been added during installation of step "4"
described above.
[HKEY_LOCAL_MACHINE\Hardware\Microsoft\WBT]
"Resolutions"=multi_sz:"640 480 60",
"640 480 72",
"640 480 75",
"640 480 85",
"800 600 60",
"800 600 72",
"800 600 75",
"800 600 85",
"1024 768 60",
"1024 768 70",
"1024 768 75",
"1024 768 85",
"1280 1024 60",
"1280 1024 75",
"1280 1024 85"
[HKEY_LOCAL_MACHINE\Software\Microsoft\WBT]
"Resolution"="640 480 60"
Replace the "Resolution"="640 480 60" with one in the supported list above.
Depending upon the bit depth selected.
To Enable CE to Look for the best supporting resolution from the monitor
Note: If Resolution and Enable DDC set Resolution takes precedence.
To Enable DDC Remove "Resolution" entry.
"EnableDDC"=dword:1
Like to disable DDC (if "EnableDDC" not set in registry system defaults to no DDC support).
"EnableDDC"=dword:0
To Enable CE to use 16Bpp depth
"FrameBufferDepth"=dword:10
To default to 8 BPP (if "FrameBufferDepth" not set in registry system defaults to 8Bpp).
"FrameBufferDepth"=dword:8
To Enable Compression
"EnableCompression"=dword:1
To Disable Compression (default when not set)
"EnableCompression"=dword:0
============================================================================
Environments variables required to control the gxvideo behaviour
REM Enbles the base GXvideo
SET CEPC_DDI_GX=1
REM Adds Durango interface
SET CEPC_DDI_GX_DURANGO=1
REM Adds the directdraw capabilities to the gxvideo
SET CEPC_DDI_GX_DDRAW=1
REM If any of the above Env. variable is not needed DONOT SET.
==============================================================================
MSTV errata: The current release with MSTVBeta 2 launches the browser but
gives an invaild handle message. The current release with MSTVBeta 3 cannot
be tested due to connection not being established to the MSTV Webserver.
This stops the browser from being launched.
Download Driver Pack
After your driver has been downloaded, follow these simple steps to install it.
Expand the archive file (if the download file is in zip or rar format).
If the expanded file has an .exe extension, double click it and follow the installation instructions.
Otherwise, open Device Manager by right-clicking the Start menu and selecting Device Manager.
Find the device and model you want to update in the device list.
Double-click on it to open the Properties dialog box.
From the Properties dialog box, select the Driver tab.
Click the Update Driver button, then follow the instructions.
Very important: You must reboot your system to ensure that any driver updates have taken effect.
For more help, visit our Driver Support section for step-by-step videos on how to install drivers for every file type.