====================================================================
Copyright (C) VIA Technologies, Inc. and S3G Technologies,Inc. 2006
VIA/S3G Unichrome/Deltachrome Graphic Driver Installation Notes for Linux XFree86/Xorg
====================================================================
Installation:
=============
1.How to Install Linux Driver and utility
1.1 Configure your hardware device when intalling Linux
1.1.1 Video Configureation
Please choose another video card, for example "S3 Savgae4 (generic)"
because VIA UniChrome/DeltaChrome graphic chip is not on the support list. We will modify
this configuration in step 3 for VIA UniChrome graphic chip after the
installation. If you choose to "Skip X Configuration", you could
configure X after the installation following step 1.2.
1.1.2 Monitor Configuration
The installation program will attempt to detect your monitor to
determine your machine's best display setting. You may also enter
the horizontal and vertical synchonization ranges for your monitor.
These value can be found in the documentation for your display.
1.1.3 Custom X Configuration
Please choose your login type as "text" because we need post
configuration after the installation.
1.2 Configure your hardware device after intalling Linux
If you choose to "Skip X Configuration" when install Linux. Please do
following step..
1.2.1 Login as root
1.2.2 Check is there a link point to /usr/X11R6/bin/XFree86
# cd /etc/X11
# ls -l X
If there is no link named "X", then do following..
# ln -s /usr/X11R6/bin/XFree86 X
Note:
If you skip the step of X setup when install Linux, there
will be no link named "X" in /etc/X11.
1.2.3 Run "xf86config" to configure your keyboard, mouse and monitor
# xf86config
The configuration program will create the file "XF86Conifg" in the
/etc/X11 directory. If there is the file named "XF86Config-4",
please remove or rename it.
1.3 Install driver and utility
Please refer /src/ReleaseNote.txt to compile the VIA UniChrome/DeltaChrome display driver.
Configuration:
==============
2.How to Configure XFree86/Xorg
# login as root
# Edit /etc/X11/XF86Confit-4 or XF86Config or xorg.conf
2.1 Set driver
In the Section "Device", make sure the driver is "via".
Driver "via"
for example, if you choose "S3 Savge4 (generic)", please rename
Driver "savage" to Driver "via"
2.2 Add user define resolution
If necessary, you can add extra resolution which non-define by XFree86 default.
In the Section "Monitor", add following setting before "EndSection"
#Refresh Rate 60Hz
ModeLine "720x480" 26.7 720 736 808 896 480 481 484 497
ModeLine "720x576" 32.7 720 744 816 912 576 577 580 597
ModeLine "848x480" 31.5 848 864 952 1056 480 481 484 497
ModeLine "856x480" 31.7 856 872 960 1064 480 481 484 497
ModeLine "1024x512" 41.3 1024 1056 1160 1296 512 513 516 531
ModeLine "1280x720" 74.6 1280 1341 1474 1688 720 721 724 746
ModeLine "1280x768" 80.1 1280 1344 1480 1680 768 769 772 795
ModeLine "1440x1050" 126.2 1440 1536 1688 1936 1050 1051 1054 1087
ModeLine "1920x1080" 172.9 1920 2043 2249 2578 1080 1081 1084 1118
#Refresh Rate 75Hz
ModeLine "720x480" 34.9 720 752 824 928 480 481 484 502
ModeLine "720x576" 42.6 720 760 832 944 576 577 580 602
ModeLine "848x480" 41.0 848 880 968 1088 480 481 484 502
ModeLine "856x480" 41.3 856 888 976 1096 480 481 484 502
ModeLine "1024x512" 53.3 1024 1072 1176 1328 512 513 516 535
ModeLine "1280x768" 103.0 1280 1360 1496 1712 768 769 772 802
ModeLine "1440x1050" 160.0 1440 1536 1696 1952 1050 1051 1054 1096
#Refresh Rate 85Hz
ModeLine "1280x768" 118.5 1280 1368 1504 1728 768 769 772 807
ModeLine "1440x1050" 184.5 1440 1544 1704 1968 1050 1051 1054 1103
ModeLine "848x480" 47.4 848 888 976 1104 480 481 484 505
2.3 Change the Resolution & BPP
2.3.1 Change BPP
In the Section "Screen",
DefaultDepth xx
Note: xx can be 8, 16, 24, 32
2.3.2. Change Resolution
In the Subsection "Display" Section "Screen",
For example, change to the resolution 800x600 of 32bpp
Subsection "Display"
Depth 24
Modes "800x600"
EndSubSection
The supported resolution:
"640x480" "720x480" "720x576" "800x600" "848x480" "856x480"
"1024x512" "1024x768" "1152x864" "1280x768" "1280x960" "1280x1024"
"1400x1050" "1600x1200"
2.4 Device Selection
2.4.1 Support Device
UniChrome Family support 4 kinds of device: CRT, TV, LCD, DFP
2.4.2 Active Device
a. Active by default
If there is no manually setting the VIA UniChorme driver will accord with
console mode active status (nomorlly, it will be CMOS setting) to
active device in XWindow.
b. Active manually
The driver will auto detect the device connected or not. If the devices
are connected. you can active device through Option in Section "Device"
Option "ActiveDevice" "device1[,device2]"
For example, the CRT and TV are connected and you would like to turn on
them simultaneous.the option will be
Option "ActiveDevice" "CRT,TV"
2.4.3 Limitation
For the timing issue. there is no simultaneous in TV + LCD/DVI case, but
SAMM is ok.
2.5 LCD Simultaneous
2.5.1 LCD simultaneous "Center" mode
Please add following setting in the Section "Device"
Option "Center"
2.5.2 LCD simultaneous "Expand" mode
Please add following setting in the Section "Device"
#Option "Center"
2.5.3 Supported Panel Size & Mode
a. Panel Size - 640x480
mode:
640x480 -
support LCD simultaneous "Expand" and "Center" mode
800x600 -
support LCD simultaneous
720x480, 720x576, 800x600, 848x480, 856x480, 1024x768,
1152x864, 1280x768, 1280x960, 1280x1024, 1400x1050,
1600x1200 -
support LCD simultaneous virtual desktop mode
a. Panel Size - 800x600
mode:
640x480 -
support LCD simultaneous "Expand" and "Center" mode
800x600 -
support LCD simultaneous
1024x768, 1152x864, 1280x768, 1280x960, 1280x1024, 1400x1050,
1600x1200 -
support LCD simultaneous virtual desktop mode
b. Panel Size - 1024x768
mode:
640x480, 800x600 -
support LCD simultaneous "Expand" and "Center" mode
1024x768 -
support LCD simultaneous
1152x864, 1280x768, 1280x960, 1280x1024, 1400x1050, 1600x1200 -
support LCD simultaneous virtual desktop mode
c. Panel Size - 1280x1024
mode:
1280x768, 1280x960 -
not support LCD simultaneous
640x480, 800x600, 1024x768, 1152x864, 1280x768, 1280x960 -
support LCD simultaneous "Expand" and "Center" mode
1280x1024 -
support LCD simultaneous
1400x1050, 1600x1200 -
support LCD simultaneous virtual desktop mode
2.6 TV Simultaneous
2.6.1 Select TV Type
You can use following setting in the Section "Device" to select "NTSC"
or "PAL"
Option "TVType" "NTSC" (or "PAL")
If you don't set this option in the Section "Device", the driver will
use the BIOS setting of TV_type of "Advanced Chipset Features"
2.6.2 Select TV Output Signal
The driver will auto detect the TV output signal is "Composit" or
"S-Video". You can also use following setting in the Section "Device"
to select "Composite", or "S-Video"
Option "TVOutput" "Composite" (or "S-Video")
If you would like to use "RGB" or "YCbCr" as your TV output signal,
Please use following setting in the Section "Device" to select
"RGB", or "YCbCr". These output signals are only VT1622.
Option "TVOutput" "RGB" (or "YCbCr")
2.6.3 Vertical Scan
a. For TV Encoder - VT1621
The driver support two kinds of TV vertical scan - under & over.
You can use following setting in the Section "Device" to select.
Option "TVVScan" "under" (or "over")
If you don't set this option, the default value is "under".
b. For TV Encoder - VT1622(A)/VT1623/VT1625
The driver support three kinds of TV vertical scan - under, over.
You can use following setting in the Section "Device" to select.
Option "TVVScan" "under" (or "fit" or "over")
If you don't set this option, the default value is "under".
2.6.4 Enable DotCrawl
You can use following setting in the Section "Device" to enable
"DotCrawl".
Option "TVDotCrawl"
2.6.5 Supported TV Encoder & Mode
a. TV Encoder - VT1621
mode:
640x480, 800x600 -
support TV simultaneous
others -
support TV simultaneous virtual desktop mode
b. TV Encoder - VT1622(A)/VT1623
mode:
640x480, 800x600, 848x480, 1024x768 ,720x480(NTSC Only),
720x576(PAL Only)-
support TV simultaneous
others -
support TV simultaneous virtual desktop mode
c. TV Encoder - VT1625
640x480, 800x600, 848x480, 1024x768 ,720x480(NTSC Only),
720x576(PAL Only), 1280x720(720P), 1920x1080(1080I) -
support TV simultaneous
others -
support TV simultaneous virtual desktop mode
2.7 Others device related options
2.7.1 Using non-DDC CRT
Normally CRT has support DDC protocal provides CRT's infomation to driver.
If your CRT hasn't support DDC or driver don't care CRT limitation. You
can add following option.
Option "NoDDCValue"
2.7.2 Using 24-Bit Bus Width Digital Interface
If using 24-Bit LVDS or 24-Bit TMDS.
Option "BusWidth" "24Bit"
If you don't set the option, driver will set 12-Bit Digital Interface
by default.
2.7.3 Using Dual Edge Panel.
If using Dual Edge Panel.
Option "LCDDualEdge"
If you don't set the option, driver will set single edge panel by default.
2.8 HQV related options
2.8.1 Select HQV assignment method
You can use the following setting to change HQV feature manual switch
by application.
Option "HQVManualSwitch"
If you don't set the option, the HQV feature will be assigned dynamically.
This is for CLE266 only.
2.8.2 HQV horizontal & vertical filter mode
You can use the following settings to select different HQV horizontal & vertical filter mode
for video H/W overlay. PMN880/PMN800/CN400 only has HQV vertical filter.
Option "HQVFilterManualSelect" # use to indicate driver to set the HQV filter
from config file.
If you don't set the option, the HQV filter is enabled default in driver.
After set HQV filter manual select, there are 4 related options :
Option "MpegHQVVFilterMode" "1"
Option "MpegHQVHFilterMode" "1" # For CLE266 only
"MpegHQVVFilterMode" is setting HQV vertical filter mode for HW mpeg accelerated AP;
"MpegHQVHFilterMode" is setting HQV horizontal filter mode for HW mpeg accelerated AP;
For CLE266, there are 5 filter modes for both horizontal & vertical:
0 : disable HQV filter,
1 : (1,1)/2
2 : (1,2,1)/4
3 : (-1,9,9,-1)/16
4 : (-1,4,10,4,-1)/16
5 : (-1,8,18,8,-1)/16
For PMN880/CN400, HQV only has vertical filter there are 2 filter modes :
0 : disable HQV filter,
1 : (4,8,4)/16
2 : (2,12,2)/16
Defalut is (4,8,4)/16 filter mode if "HQVFilterManualSelect" option not set.
Usage of Linux utility:
=======================
3. How to run the Linux utility?
a. You must run X window first.
b. Open the terminal console.
c. Run utility binary file:
# s3utility
Note:
=====
4. The priority setting to login X-windows.
S3Utility setting(.VIARC, .VIRTVRC ...) > XFree86Config setting