Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
SIS(4)			   Kernel Interfaces Manual			SIS(4)

NAME
       sis - SiS video driver

SYNOPSIS
       Section "Device"
	 Identifier "devname"
	 Driver	"sis"
	 ...
       EndSection

DESCRIPTION
       sis  is	an  XFree86  driver for	SiS (Silicon Integrated	Systems) video
       chips. The driver is accelerated, and provides support for  colordepths
       of 8, 16	and 24 bpp.  XVideo, Render and	other extensions are supported
       as well.

SUPPORTED HARDWARE
       The sis driver supports PCI and AGP video cards based on	the  following
       chipsets:

       SiS5597/5598  SiS530/620	 SiS6326/AGP/DVD  SiS300/305 SiS540 SiS630/730
       SiS315/H/PRO						SiS550/551/552
       SiS650/651/M650/661FX/M661FX/M661MX/740/741/741GX SiS330	(Xabre)	SiS760

       In the following	text, the following terms are used:

       old series for SiS5597/5598, 530/620 and	6326/AGP/DVD

       300 series for SiS300/305, 540 and 630/730

       315/330 series for SiS315, 55x and (M)65x/(M)661xX/74x(GX), 330,	760

CONFIGURATION DETAILS
       Please  refer to	XF86Config(5) for general configuration	details.  This
       section only covers configuration details specific to this driver.

       Detailed	information on	all  supported	options	 can  be  obtained  at
       http://www.winischhofer.net/linuxsisvga.shtml

       This manpage only covers	a subset of the	supported options.

       1. For all supported chipsets

       The following driver Options are	supported on all chipsets:

       Option "NoAccel"	"boolean"
	      Disable  or enable 2D acceleration. Default: acceleration	is en-
	      abled.

       Option "HWCursor" "boolean"
	      Enable or	disable	the HW cursor. Default:	HWCursor is on.

       Option "SWCursor" "boolean"
	      The opposite of HWCursor.	Default: SWCursor is off.

       Option "Rotate" "CW"
	      Rotate the display clockwise. This mode  is  unaccelerated,  and
	      uses  the	 Shadow	Frame Buffer layer. Using this option disables
	      the Resize and Rotate extension (RandR).	Default: no rotation.

       Option "Rotate" "CCW"
	      Rotate the display counterclockwise. This	mode is	unaccelerated,
	      and  uses	 the Shadow Frame Buffer layer.	Using this option dis-
	      ables the	Resize and Rotate extension (RandR).  Default: no  ro-
	      tation.

       Option "ShadowFB" "boolean"
	      Enable or	disable	use of the shadow framebuffer layer.  Default:
	      Shadow framebuffer is off.

       Option "CRT1Gamma" "boolean"
	      Enable or	disable	gamma correction.  Default:  Gamma  correction
	      is on.

       2. Old series specific information

       The  driver will	auto-detect the	amount of video	memory present for all
       these chips, but	in the case of the 6326, it will limit the memory size
       to  4MB.	This is	because	the 6326's 2D engine can only address 4MB. The
       remaining memory	seems to be intended for 3D texture data,  since  only
       the 3D engine can address RAM above 4MB.	However, you can override this
       limitation using	the "VideoRAM" option in the Device  section  if  your
       board  has  more	than 4MB and you need to use it. However, 2D accelera-
       tion, Xvideo and	the HWCursor will be disabled in this case.

       The driver will also auto-detect	the maximum dotclock  and  DAC	speed.
       If you have problems getting high resolutions because of	dot clock lim-
       itations, try using the "DacSpeed" option, also in the Device  section.
       However,	 this  is  not	recommended  for  the 6326. For	this chip, the
       driver has two built-in modes for high resolutions which	you should use
       instead.	 These	are  named "SIS1280x1024-75" and "SIS1600x1200-60" and
       they will be added to the list of default modes.	To  use	 these	modes,
       just place them in your Screen section. Example:

       Modes "SIS1600x1200-60" "SIS1280x1024x75" "1024x768" ...

       Of  these  modes,  1280x1024  is	 only  available  at  8, 15 and	16bpp.
       1600x1200 is available at 8bpp only.

       TV support for the 6326

       TV output is supported for the 6326. The	driver will auto detect	 a  TV
       connected  and  in this case add	the following modes to the list	of de-
       fault modes: "PAL800x600", "PAL800x600U",  "PAL720x540",	 "PAL640x480",
       "NTSC640x480",  "NTSC640x480U" and "NTSC640x400".  Use these modes like
       the hi-res modes	described above.

       The following driver Options are	supported on the old series:

       Option "TurboQueue" "boolean"
	      Enable or	disable	TurboQueue mode.  Default: off for SIS530/620,
	      on for the others

       Option "FastVram" "boolean"
	      Enable  or  disable FastVram mode.  Enabling this	sets the video
	      RAM timing to one	cycle per read operation instead  of  two  cy-
	      cles.  Disabling this will set two cycles	for read and write op-
	      erations.	Leaving	this option out	uses the default, which	varies
	      depending	on the chipset.

       Option "NoHostBus" "boolean"
	      (SiS5597/5598  only).  Disable CPU-to-VGA	host bus support. This
	      speeds up	CPU to video RAM transfers. Default: Host bus  is  en-
	      abled.

       Option "NoXVideo" "boolean"
	      Disable XV (XVideo) extension support. Default: XVideo is	on.

       Option "NoYV12" "boolean"
	      Disable  YV12 Xv support.	This might me required due to hardware
	      bugs in some chipsets. Disabling YV12  support  forces  Xv-aware
	      applications  to	use  YUV2  or XShm for video output.  Default:
	      YV12 support is on.

       Option "TVStandard" "string"
	      (6326 only) Valid	parameters are PAL or NTSC.   The  default  is
	      set by a jumper on the card.

       Option "TVXPosOffset" "integer"
	      (6326 only) This option allows tuning the	horizontal position of
	      the image	for TV output. The range is from -16 to	16. Default: 0

       Option "TVYPosOffset" "integer"
	      (6326 only) This option allows tuning the	vertical  position  of
	      the image	for TV output. The range is from -16 to	16. Default: 0

       Option "SIS6326TVEnableYFilter" "boolean"
	      (6326 only) This option allows enabling/disabling	the Y (chroma)
	      filter for TV output.

       Option "SIS6326TVAntiFlicker" "string"
	      (6326  only)  This  option  allow	 enabling/disabling  the  anti
	      flicker  facility	 for  TV  output. Possible parameters are OFF,
	      LOW, MED,	HIGH or	ADAPTIVE.  By experience, ADAPTIVE yields  the
	      best results, hence it is	the default.

       2. 300 and 315/330 series specific information

       The  300	 and 315/330 series feature two	CRT controllers	and very often
       come with a video bridge	for  controlling  LCD  and  TV	output.	 Here-
       inafter,	 the  term CRT1	refers to the VGA output of the	chip, and CRT2
       refers to either	LCD, TV	or secondary VGA. Due to timing	reasons,  only
       one  CRT2  output  can  be active at the	same time. But this limitation
       does not	apply to using CRT1 and	CRT2 at	the same time which  makes  it
       possible	to run the driver in dual head mode.

       The driver supports the following video bridges:

       SiS301 SiS301B(-DH) SiS301C SiS301LV SiS302(E)LV

       Instead	of  a  video  bridge, some machines have a LVDS	transmitter to
       control LCD panels, and a Chrontel 7005 or  7019	 for  TV  output.  All
       these are supported as well.

       About TV	output

       On the SiS301 and the Chrontel 7005, only resolutions up	to 800x600 are
       supported. On all others, resolutions up	 to  1024x768  are  supported.
       However,	 due to	a hardware bug,	Xvideo might be	distorted on SiS video
       bridges if running NTSC or PAL-M	at 1024x768.

       About XVideo support

       XVideo is supported on all chipsets of both  families.  However,	 there
       are some	differences in hardware	features which cause limitations.  The
       300 series as well as the SiS55x, M650, 651,  661FX,  M661FX,  and  741
       support	two  video overlays. The SiS315/H/PRO, 650/740 and 330 support
       only one	such overlay. On chips with two	overlays, one overlay is  used
       for  CRT1, the other for	CRT2. On the other chipsets, the option	"XvOn-
       CRT2" can be used to select the desired output channel.

       About Merged Framebuffer	support

       This  mode  is  strongly	 recommended   over   Xinerama.	  Please   see
       http://www.winischhofer.net/linuxsisvga.shtml for detailed information.

       About dual-head support

       Dual  head mode has some	limitations as regards color depth and resolu-
       tion. Due to memory bandwidth limits, CRT1 might	have a reduced maximum
       refresh rate if running on higher resolutions than 1280x1024.

       Colordepth 8 is not supported when running in dual head mode.

       The  following  driver Options are supported on the 300 and 315/330 se-
       ries:

       Option "NoXVideo" "boolean"
	      Disable XV (XVideo) extension support.  Default: XVideo is on.

       Option "XvOnCRT2" "boolean"
	      On chipsets with only one	video overlay, this option can used to
	      bind  the	overlay	to CRT1	( if a monitor is detected and if this
	      option is	either unset or	set to false ) or CRT2 ( if a CRT2 de-
	      vice is detected or forced, and if this option is	set to true ).
	      If either	only CRT1 or CRT2 is detected, the driver decides  au-
	      tomatically. In Merged Framebuffer mode, this option is ignored.
	      Default: overlay is used on CRT1

       Option "ForceCRT1" "boolean"
	      Force CRT1 to be on of off. If a monitor is connected,  it  will
	      be  detected during server start.	However, some old monitors are
	      not detected correctly. In such cases, you may set  this	option
	      to  on  in  order	to make	the driver initialize CRT1 anyway.  If
	      this option is set to off	, the driver  will  switch  off	 CRT1.
	      Default: auto-detect

       Option "ForceCRT2Type" "string"
	      Force  display  type to one of: NONE , TV	, SVIDEO , COMPOSITE ,
	      SVIDEO+COMPOSITE , SCART , LCD , VGA ; NONE will	disable	 CRT2.
	      The SVIDEO, COMPOSITE, SVIDEO+COMPOSITE and SCART	parameters are
	      for SiS video bridges only and can be used to force  the	driver
	      to  use  a  specific TV output connector (if present).  Default:
	      auto detect.

       Option "CRT2Gamma" "boolean"
	      Enable or	disable	gamma correction for CRT2. Only	supported  for
	      SiS video	bridges. Default: Gamma	correction for CRT2 is on.

       Option "TVStandard" "string"
	      Force  the  TV standard to either	PAL or NTSC.  On some machines
	      with 630,	730 and	the 315/330 series, PALM , PALN	and NTSCJ  are
	      supported	as well. Default: BIOS setting.

       Option "TVXPosOffset" "integer"
	      This  option  allows tuning the horizontal position of the image
	      for TV output. The range is from -32 to 32. Not supported	on the
	      Chrontel 7019. Default: 0

       Option "TVYPosOffset" "integer"
	      This option allows tuning	the vertical position of the image for
	      TV output. The range is from -32 to 32.  Not  supported  on  the
	      Chrontel 7019. Default: 0

       Option "SISTVXScale" "integer"
	      This  option selects the horizontal zooming level	for TV output.
	      The range	is from	 -16  to  16.  Only  supported	on  SiS	 video
	      bridges. Default:	0

       Option "SISTVYScale" "integer"
	      This  option selects the vertical	zooming	level for TV output in
	      the following modes: 640x480, 800x600. On	 the  315/330  series,
	      also  720x480,  720x576  and 768x576. The	range is from -4 to 3.
	      Only supported on	SiS video bridges. Default: 0

       Option "CHTVOverscan" "boolean"
	      On machines with a Chrontel TV encoder,  this  can  be  used  to
	      force  the TV mode to overscan or	underscan.  on means overscan,
	      off means	underscan.  Default: BIOS setting.

       Option "CHTVSuperOverscan" "boolean"
	      On machines with a Chrontel 7005 TV encoder, this	option enables
	      a	super-overscan mode. This is only supported if the TV standard
	      is PAL. Super overscan will produce an image on the TV which  is
	      larger than the viewable area.

       The  driver  supports  many  more options. Please see http://www.winis-
       chhofer.net/linuxsisvga.shtml for more information.

       3. 300 series specific information

       DRI is supported	on the 300 series only.	On  Linux,  DRI	 requires  the
       kernel's	 SiS framebuffer driver	( sisfb	) and some other modules which
       come with either	the kernel or the X server.

       Sisfb takes care	of memory management for texture  data.	 In  order  to
       prevent	the  X	Server	and  sisfb from	overwriting each other's data,
       sisfb reserves an amount	of video memory	for the	X driver. This	amount
       can  either  be	selected using sisfb's mem parameter, or auto-selected
       depending on the	amount of total	video RAM available.

       Sisfb can be used for memory management only, or	as a  complete	frame-
       buffer  driver.	If  you	 start	sisfb with a valid mode	(ie you	gain a
       graphical console), the X driver	can communicate	with sisfb and doesn't
       require any manual configuration	for finding out	about the video	memory
       it is allowed to	use.  However, if you are running a 2.4	 series	 Linux
       kernel  and  use	sisfb for video	memory management only,	ie you started
       sisfb with mode=none and	still have a text mode console,	 there	is  no
       communication between sisfb and the X driver. For this purpose, the

       Option "MaxXFBMem" "integer"

       exists.	This  option  must  be set to the same value as	given to sisfb
       through its "mem" parameter, ie the amount of memory to use  for	 X  in
       kilobytes.

       If you started sisfb without the	mem argument, sisfb will reserve

       12288KB if more than 16MB of total video	RAM is available,

       8192KB if between 12 and	16MB of	video RAM is available,

       4096KB in all other cases.

       If you intend to	use DRI, I recommend setting the total video memory in
       the BIOS	to 64MB	in order to at least overcome the lack of memory  swap
       functions.

       Option "DRI" "boolean"
	      This option allows enabling or disabling DRI. By default,	DRI is
	      on.

       Option "AGPSize"	"integer"
	      This option allows selecting the amount of AGP memory to be used
	      for DRI.	The amount is to be specified in megabyte, the default
	      is 8.

KNOWN BUGS
       none.

SEE ALSO
       XFree86(1), XF86Config(5), xf86config(1), Xserver(1), X(7)

       http://www.winischhofer.net/linuxsisvga.shtml for more information  and
       updates

AUTHORS
       Authors	include:  Alan Hourihane, Mike Chapman,	Juanjo Santamarta, Mi-
       tani Hiroshi, David Thomas, Sung-Ching Lin, Ademar Reis,	Thomas	Winis-
       chhofer

XFree86				 Version 4.7.0				SIS(4)

NAME | SYNOPSIS | DESCRIPTION | SUPPORTED HARDWARE | CONFIGURATION DETAILS | KNOWN BUGS | SEE ALSO | AUTHORS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=sis&sektion=4&manpath=XFree86+4.7.0>

home | help