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

FreeBSD Manual Pages


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

       modesetting - video driver for framebuffer device

       Section "Device"
	 Identifier "devname"
	 Driver	"modesetting"
	 BusID	"pci:bus:dev:func"

       modesetting  is	an  Xorg driver	for KMS	devices.  This driver supports
       TrueColor visuals at framebuffer	depths of 15, 16, 24,  and  30.	 RandR
       1.2  is supported for multi-head	configurations.	Acceleration is	avail-
       able through glamor for devices supporting at least OpenGL  ES  2.0  or
       OpenGL  2.1.  If	glamor is not enabled, a shadow	framebuffer is config-
       ured based on the KMS drivers' preference (unless the framebuffer is 24
       bits per	pixel, in which	case the shadow	framebuffer is always used).

       The  modesetting	 driver	 supports  all	hardware where a KMS driver is
       available.  modesetting uses the	Linux DRM KMS ioctls and  dumb	object

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

       For this	driver it is not required to specify modes in the screen  sec-
       tion  of	 the config file.  The modesetting driver can pick up the cur-
       rently used video mode from the kernel driver and will use it if	 there
       are no video modes configured.

       For  PCI	 boards	 you might have	to add a BusID line to the Device sec-
       tion.  See above	for a sample line.

       The following driver Options are	supported:

       Option "SWcursor" "boolean"
	      Selects software cursor.	The default is off.

       Option "kmsdev" "string"
	      The framebuffer device to	use. Default: /dev/dri/card0.

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

       Option "DoubleShadow" "boolean"
	      Double-buffer shadow updates. When enabled, the driver will keep
	      two copies of the	shadow framebuffer.  When  the	shadow	frame-
	      buffer  is  flushed,  the	old and	new versions of	the shadow are
	      compared,	and only tiles that have actually changed are uploaded
	      to  the  device.	This  is an optimization for server-class GPUs
	      with a remote display function (typically	VNC), where remote up-
	      dates  are triggered by any framebuffer write, so	minimizing the
	      amount of	data uploaded is crucial.  This	 defaults  to  enabled
	      for ASPEED and Matrox G200 devices, and disabled otherwise.

       Option "AccelMethod" "string"
	      One of "glamor" or "none".  Default: glamor.

       Option "PageFlip" "boolean"
	      Enable DRI3 page flipping.  The default is on.

       Option "ZaphodHeads" "string"
	      Specify  the  RandR output(s) to use with	zaphod mode for	a par-
	      ticular driver instance.	If you use this	option	you  must  use
	      this option for all instances of the driver.
	      For  example:  Option  "ZaphodHeads"  "LVDS,VGA-0"  will	assign
	      xrandr outputs LVDS and VGA-0 to this instance of	the driver.

       SEE ALSO
	      Xorg(1), xorg.conf(5), Xserver(1), X(7)

       Authors include:	Dave Airlie

X Version 11		      xorg-server 1.20.14		MODESETTING(4)


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

home | help