1I810(4)                    Kernel Interfaces Manual                    I810(4)
2
3
4

NAME

6       i810 - Intel 8xx integrated graphics chipsets
7

SYNOPSIS

9       Section "Device"
10         Identifier "devname"
11         Driver "i810"
12         ...
13       EndSection
14

DESCRIPTION

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

SUPPORTED HARDWARE

26       i810 supports the i810, i810-DC100, i810e, i815,  i830M,  845G,  852GM,
27       855GM, 865G, 915G, 915GM, 945G, 945GM, 965G, 965Q and 946GZ chipsets.
28
29

CONFIGURATION DETAILS

31       Please  refer to xorg.conf(5x) for general configuration details.  This
32       section only covers configuration details specific to this driver.
33
34       The Intel 8xx and 9xx families of integrated graphics  chipsets  has  a
35       unified  memory architecture and uses system memory for video ram.  For
36       the i810 and i815 family of chipset, operating system support for allo‐
37       cating  system  memory  for  video use is required in order to use this
38       driver.  For the 830M and later, this is  required  in  order  for  the
39       driver  to  use more video ram than has been pre-allocated at boot time
40       by the BIOS.  This is usually achieved with an "agpgart" or "agp"  ker‐
41       nel  driver.  Linux, and recent versions of FreeBSD, OpenBSD and NetBSD
42       have such kernel drivers available.
43
44       By default 8 Megabytes of system memory are used for graphics.  For the
45       830M  and later, the default is 8 Megabytes when DRI is not enabled and
46       32 Megabytes with DRI is enabled.  This amount may be changed with  the
47       VideoRam entry in the config file Device section.  It may be set to any
48       reasonable value up to 64MB for  older  chipsets  or  128MB  for  newer
49       chipets.   It  is  advisable to check the Xorg log file to check if any
50       features have been disabled because of insufficient video  memory.   In
51       particular,  DRI  support  or tiling mode may be disabled with insuffi‐
52       cient video memory.  Either of these being disabled will reduce perfor‐
53       mance  for  3D  applications.  Note however, that increasing this value
54       too much will reduce the amount of system memory  available  for  other
55       applications.
56
57       The  driver  makes use of the video BIOS to program video modes for the
58       830M and later.  This limits the video modes that can be used to  those
59       provided  by the video BIOS, and to those that will fit into the amount
60       of video memory that the video BIOS is aware of.
61
62       The following driver Options are supported
63
64       Option "NoAccel" "boolean"
65              Disable  or  enable  acceleration.   Default:  acceleration   is
66              enabled.
67
68       Option "SWCursor" "boolean"
69              Disable  or enable software cursor.  Default: software cursor is
70              disable and a hardware cursor is used for  configurations  where
71              the hardware cursor is available.
72
73       Option "ColorKey" "integer"
74              This sets the default pixel value for the YUV video overlay key.
75              Default: undefined.
76
77       Option "CacheLines" "integer"
78              This allows the user to change the  amount  of  graphics  memory
79              used  for  2D  acceleration  and  video.  Decreasing this amount
80              leaves more for 3D textures.  Increasing it can improve 2D  per‐
81              formance  at the expense of 3D performance.  Default: depends on
82              the resolution, depth, and available video memory.   The  driver
83              attempts  to  allocate at least enough to hold two DVD-sized YUV
84              buffers by default.  The default used for a specific  configura‐
85              tion can be found by examining the Xorg log file.
86
87       Option "DRI" "boolean"
88              Disable or enable DRI support.  Default: DRI is enabled for con‐
89              figurations where it is supported.
90
91
92       The following driver Options  are  supported  for  the  i810  and  i815
93       chipsets:
94
95       Option "DDC" "boolean"
96              Disable or enable DDC support.  Default: enabled.
97
98       Option "Dac6Bit" "boolean"
99              Enable  or  disable  6-bits  per  RGB for 8-bit modes.  Default:
100              8-bits per RGB for 8-bit modes.
101
102       Option "XvMCSurfaces" "integer"
103              This option enables XvMC.  The integer parameter  specifies  the
104              number  of surfaces to use.  Valid values are 6 and 7.  Default:
105              XvMC is disabled.
106
107
108       The following driver Options are  supported  for  the  830M  and  later
109       chipsets:
110
111       Option "VBERestore" "boolean"
112              Enable  or  disable  the  use of VBE save/restore for saving and
113              restoring the initial text mode.  This is  disabled  by  default
114              because it causes lockups on some platforms.  However, there are
115              some cases where it must enabled for the correct restoration  of
116              the  initial video mode.  If you are having a problem with that,
117              try enabling this option.  Default: Disabled.
118
119       Option "VideoKey" "integer"
120              This is the same as the "ColorKey" option described  above.   It
121              is provided for compatibility with most other drivers.
122
123       Option "XVideo" "boolean"
124              Disable  or  enable  XVideo support.  Default: XVideo is enabled
125              for configurations where it is supported.
126
127       Option "MonitorLayout" "anystr"
128              Allow different monitor configurations. e.g. "CRT,LFP" will con‐
129              figure  a  CRT on Pipe A and an LFP on Pipe B. Regardless of the
130              primary   heads'   pipe   it    is    always    configured    as
131              "<PIPEA>,<PIPEB>".   Additionally you can add different configu‐
132              rations such as "CRT+DFP,LFP" which would  put  a  digital  flat
133              panel  and  a  CRT  on pipe A, and a local flat panel on pipe B.
134              For single pipe configurations you can just specify the monitors
135              types on Pipe A, such as "CRT+DFP" which will enable the CRT and
136              DFP on Pipe A.  Valid monitors are  CRT,  LFP,  DFP,  TV,  CRT2,
137              LFP2,  DFP2, TV2 and NONE.  NOTE: Some configurations of monitor
138              types may fail, this depends on the Video BIOS and  system  con‐
139              figuration.   Default:  Not configured, and will use the current
140              head's pipe and monitor.
141
142       Option "Clone" "boolean"
143              Enable Clone mode on pipe B. This will setup the second head  as
144              a  complete  mirror  of  the  monitor attached to pipe A.  NOTE:
145              Video overlay functions will not work on the second head in this
146              mode.  If you require this, then use the MonitorLayout above and
147              do (as an example) "CRT+DFP,NONE" to configure both  a  CRT  and
148              DFP  on Pipe A to achieve local mirroring and disable the use of
149              this option.  Default: Clone mode on pipe B is disabled.
150
151       Option "CloneRefresh" "integer"
152              When the Clone option is specified we can drive the second moni‐
153              tor  at  a  different  refresh  rate than the primary.  Default:
154              60Hz.
155
156       Option "CheckLid" "boolean"
157              On mobile platforms it's desirable to monitor the lid status and
158              switch the outputs accordingly when the lid is opened or closed.
159              By default this option is on, but may incur a very minor perfor‐
160              mance penalty as we need to poll a register on the card to check
161              for this activity. It can be turned off using this option.  This
162              only  works  with  the  830M, 852GM and 855GM systems.  Default:
163              enabled.
164
165       Option "FlipPrimary" "boolean"
166              When using a dual pipe system, it may be  preferable  to  switch
167              the primary screen to the alternate pipe to display on the other
168              monitor connection.  NOTE: Using this option may cause text mode
169              to  be  restored  incorrectly, and thus should be used with cau‐
170              tion.  Default: disabled.
171
172       Option "DisplayInfo" "boolean"
173              It has been found that  a  certain  BIOS  call  can  lockup  the
174              Xserver  because  of  a  problem in the Video BIOS. The log file
175              will identify if you are suffering from this  problem  and  tell
176              you to turn this option off.  Default: enabled
177
178       Option "DevicePresence" "boolean"
179              Tell  the  driver  to  perform an active detect of the currently
180              connected monitors. This option is useful if the monitor was not
181              connected  when  the  machine  has  booted, but unfortunately it
182              doesn't always work and is extremely dependent  upon  the  Video
183              BIOS.  Default: disabled
184
185       Option "Rotate" "90"
186              Rotate  the  desktop  90  degrees  counterclockwise. Other valid
187              options are 0, 90, 180 and 270 degrees. The RandR  extension  is
188              used  for  rotation  functionality.  So  this  option allows the
189              Xserver to start with a rotated mode of operation.   Default:  0
190              degrees.
191
192       Option "LinearAlloc" "integer"
193              Allows  more  memory  for  the offscreen allocator. This usually
194              helps in situations where HDTV movies are required to  play  but
195              not  enough  offscreen  memory is usually available. Set this to
196              6144 for upto 1920x1080 HDTV support.  Default 0KB (off).
197
198

SEE ALSO

200       Xorg(1x), xorg.conf(5x), xorgconfig(1x), Xserver(1x), X(7)
201

AUTHORS

203       Authors include: Keith Whitwell, and also Jonathan Bian, Matthew J Sot‐
204       tek, Jeff Hartmann, Mark Vojkovich, Alan Hourihane, H. J. Lu.  830M and
205       845G support  reworked  for  XFree86  4.3  by  David  Dawes  and  Keith
206       Whitwell.   852GM,  855GM,  and  865G  support added by David Dawes and
207       Keith Whitwell.  915G, 915GM, 945G, 945GM, 965G, 965Q and 946GZ support
208       added  by  Alan Hourihane and Keith Whitwell.  Dual Head, Clone and lid
209       status support added by Alan Hourihane. Textured video support for 915G
210       and later chips added by Keith Packard and Eric Anholt.
211
212
213
214X Version 11                 xf86-video-i810 1.6.5                     I810(4)
Impressum