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

FreeBSD Manual Pages


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

       i810 - Intel 8xx	integrated graphics chipsets

       Section "Device"
	 Identifier "devname"
	 Driver	"i810"

       i810  is	an XFree86 driver for Intel integrated graphics	chipsets.  The
       driver supports depths 8, 15, 16	and 24.	 All  visual  types  are  sup-
       ported  in  depth  8.  For the i810/i815	other depths support the True-
       Color and DirectColor visuals.  For the 830M and	later, only the	 True-
       Color  visual  is supported for depths greater than 8.  The driver sup-
       ports hardware accelerated 3D via the Direct  Rendering	Infrastructure
       (DRI),  but only	in depth 16 for	the i810/i815 and depths 16 and	24 for
       the 830M	and later.

       i810 supports the i810, i810-DC100, i810e,  i815,  830M,	 845G,	852GM,
       855GM, 865G, 915G and 915GM chipsets.

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

       The Intel 8xx family of integrated graphics chipsets has	a unified mem-
       ory  architecture  and  uses system memory for video ram.  For the i810
       and i815	familiy	of chipset, operating system  support  for  allocating
       system  memory  for  video use is required in order to use this driver.
       For the 830M and	later, this is required	in order for the driver	to use
       more  video  ram	 than has been pre-allocated at	boot time by the BIOS.
       This is usually achieved	with an	 "agpgart"  or	"agp"  kernel  driver.
       Linux,  and  recent  versions  of FreeBSD, OpenBSD and NetBSD have such
       kernel drivers available.

       By default 8 Megabytes of system	memory are used	for graphics.  For the
       830M  and later,	the default is 8 Megabytes when	DRI is not enabled and
       32 Megabytes with DRI is	enabled.  This amount may be changed with  the
       VideoRam	entry in the config file Device	section.  It may be set	to any
       reasonable value	up to 64MB for	older  chipsets	 or  128MB  for	 newer
       chipets.	 It is advisable to check the XFree86 log file to check	if any
       features	have been disabled because of insufficient video  memory.   In
       particular,  DRI	 support  or tiling mode may be	disabled with insuffi-
       cient video memory.  Either of these being disabled will	reduce perfor-
       mance  for  3D  applications.  Note however, that increasing this value
       too much	will reduce the	amount of system memory	 available  for	 other

       The  driver  makes use of the video BIOS	to program video modes for the
       830M and	later.	This limits the	video modes that can be	used to	 those
       provided	 by the	video BIOS, and	to those that will fit into the	amount
       of video	memory that the	video BIOS is aware of.

       The following driver Options are	supported:

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

       Option "SWCursor" "boolean"
	      Disable  or enable software cursor.  Default: software cursor is
	      disable and a hardware cursor is used for	 configurations	 where
	      the hardware cursor is available.

       Option "ColorKey" "integer"
	      This sets	the default pixel value	for the	YUV video overlay key.
	      Default: undefined.

       Option "CacheLines" "integer"
	      This allows the user to change the  amount  of  graphics	memory
	      used  for	 2D  acceleration  and	video.	Decreasing this	amount
	      leaves more for 3D textures.  Increasing it can improve 2D  per-
	      formance	at the expense of 3D performance.  Default: depends on
	      the resolution, depth, and available video memory.   The	driver
	      attempts	to  allocate at	least enough to	hold two DVD-sized YUV
	      buffers by default.  The default used for	a specific  configura-
	      tion can be found	by examining the XFree86 log file.

       Option "DRI" "boolean"
	      Disable or enable	DRI support.  Default: DRI is enabled for con-
	      figurations where	it is supported.

       The following driver Options  are  supported  for  the  i810  and  i815

       Option "DDC" "boolean"
	      Disable or enable	DDC support.  Default: enabled.

       Option "Dac6Bit"	"boolean"
	      Enable  or  disable  6-bits  per	RGB for	8-bit modes.  Default:
	      8-bits per RGB for 8-bit modes.

       Option "XvMCSurfaces" "integer"
	      This option enables XvMC.	 The integer parameter	specifies  the
	      number  of surfaces to use.  Valid values	are 6 and 7.  Default:
	      XvMC is disabled.

       The following driver Options are	 supported  for	 the  830M  and	 later

       Option "VBERestore" "boolean"
	      Enable  or  disable  the	use of VBE save/restore	for saving and
	      restoring	the initial text mode.	This is	 disabled  by  default
	      because it causes	lockups	on some	platforms.  However, there are
	      some cases where it must enabled for the correct restoration  of
	      the  initial video mode.	If you are having a problem with that,
	      try enabling this	option.	 Default: Disabled.

       Option "VideoKey" "integer"
	      This is the same as the "ColorKey" option	described  above.   It
	      is provided for compatibility with most other drivers.

       Option "XVideo" "boolean"
	      Disable  or  enable  XVideo support.  Default: XVideo is enabled
	      for configurations where it is supported.

       Option "MonitorLayout" "anystr"
	      Allow different monitor configurations. e.g. "CRT,LFP" will con-
	      figure  a	 CRT on	Pipe A and an LFP on Pipe B. Regardless	of the
	      primary  heads'  pipe  it	 is   always   configured   as	 "<PI-
	      PEA>,<PIPEB>".   Additionally  you  can add different configura-
	      tions such as "CRT+DFP,LFP" which	would put a digital flat panel
	      and a CRT	on pipe	A, and a local flat panel on pipe B.  For sin-
	      gle pipe configurations you can just specify the monitors	 types
	      on  Pipe	A, such	as "CRT+DFP" which will	enable the CRT and DFP
	      on Pipe A.  Valid	monitors are CRT, LFP, DFP,  TV,  CRT2,	 LFP2,
	      DFP2,  TV2 and NONE.  NOTE: Some configurations of monitor types
	      may fail,	this depends on	the Video BIOS and  system  configura-
	      tion.   Default: Not configured, and will	use the	current	head's
	      pipe and monitor.

       Option "Clone" "boolean"
	      Enable Clone mode	on pipe	B. This	will setup the second head  as
	      a	 complete  mirror  of  the  monitor attached to	pipe A.	 NOTE:
	      Video overlay functions will not work on the second head in this
	      mode.  If	you require this, then use the MonitorLayout above and
	      do (as an	example) "CRT+DFP,NONE"	to configure both  a  CRT  and
	      DFP  on Pipe A to	achieve	local mirroring	and disable the	use of
	      this option.  Default: Clone mode	on pipe	B is disabled.

       Option "CloneRefresh" "integer"
	      When the Clone option is specified we can	drive the second moni-
	      tor  at  a  different  refresh  rate than	the primary.  Default:

       Option "CheckDevices" "boolean"
	      On mobile	platforms it's desirable to monitor the	device	status
	      and switch the outputs accordingly. For example, when the	lid is
	      opened or	closed,	or when	using hotkeys without ACPI support. By
	      default this option is on	for mobile platforms and is not	avail-
	      able on desktop systems.	Default: enabled.

       Option "FixedPipe" "anystr"
	      When using a dual	pipe system, it	may be preferable to  fix  the
	      primary  pipe such that if you boot up on	an external screen you
	      may want the internal flat panel to be the primary.  Using  this
	      option  will allow this.	Options	are A or B.  Default: disabled
	      (uses current pipe as primary).

       Option "DisplayInfo" "boolean"
	      It has been found	that  a	 certain  BIOS	call  can  lockup  the
	      Xserver  because	of  a  problem in the Video BIOS. The log file
	      will identify if you are suffering from this  problem  and  tell
	      you to turn this option off.  Default: enabled

       Option "DevicePresence" "boolean"
	      Tell  the	 driver	 to  perform an	active detect of the currently
	      connected	monitors. This option is useful	if the monitor was not
	      connected	 when  the  machine  has  booted, but unfortunately it
	      doesn't always work and is extremely dependent  upon  the	 Video
	      BIOS.  Default: disabled

       Option "Rotate" "CW"

       Option "Rotate" "CCW"
	      Rotate  the  desktop  90	degrees	clockwise or counterclockwise.
	      This option forces the ShadowFB option on, and disables acceler-
	      ation.  Default: no rotation.

       Option "ShadowFB" "boolean"
	      Enable or	disable	use of the shadow framebuffer layer.  This op-
	      tion disables acceleration.  Default: off.

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

       Authors include:	Keith Whitwell,	and also Jonathan Bian,	Matthew	J Sot-
       tek, Jeff Hartmann, Mark	Vojkovich, Alan	Hourihane, H. J. Lu.  830M and
       845G support  reworked  for  XFree86  4.3  by  David  Dawes  and	 Keith
       Whitwell.   852GM,  855GM,  and	865G  support added by David Dawes and
       Keith Whitwell.	915G and 915GM support added  by  Alan	Hourihane  and
       Keith  Whitwell.	 Dual Head, Clone and lid status support added by Alan

XFree86				 Version 4.7.0			       I810(4)


Want to link to this manual page? Use this URL:

home | help