xref: /dflybsd-src/share/man/man4/i915.4 (revision b4d3a504cd6dc4fb5ff2bd6aa9c5695ef6722ab1)
1*b4d3a504SSascha Wildner.\"
2*b4d3a504SSascha Wildner.\" Copyright (c) 2015 The DragonFly Project.  All rights reserved.
3*b4d3a504SSascha Wildner.\"
4*b4d3a504SSascha Wildner.\" Redistribution and use in source and binary forms, with or without
5*b4d3a504SSascha Wildner.\" modification, are permitted provided that the following conditions
6*b4d3a504SSascha Wildner.\" are met:
7*b4d3a504SSascha Wildner.\"
8*b4d3a504SSascha Wildner.\" 1. Redistributions of source code must retain the above copyright
9*b4d3a504SSascha Wildner.\"    notice, this list of conditions and the following disclaimer.
10*b4d3a504SSascha Wildner.\" 2. Redistributions in binary form must reproduce the above copyright
11*b4d3a504SSascha Wildner.\"    notice, this list of conditions and the following disclaimer in
12*b4d3a504SSascha Wildner.\"    the documentation and/or other materials provided with the
13*b4d3a504SSascha Wildner.\"    distribution.
14*b4d3a504SSascha Wildner.\" 3. Neither the name of The DragonFly Project nor the names of its
15*b4d3a504SSascha Wildner.\"    contributors may be used to endorse or promote products derived
16*b4d3a504SSascha Wildner.\"    from this software without specific, prior written permission.
17*b4d3a504SSascha Wildner.\"
18*b4d3a504SSascha Wildner.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
19*b4d3a504SSascha Wildner.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
20*b4d3a504SSascha Wildner.\" LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
21*b4d3a504SSascha Wildner.\" FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE
22*b4d3a504SSascha Wildner.\" COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
23*b4d3a504SSascha Wildner.\" INCIDENTAL, SPECIAL, EXEMPLARY OR CONSEQUENTIAL DAMAGES (INCLUDING,
24*b4d3a504SSascha Wildner.\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
25*b4d3a504SSascha Wildner.\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
26*b4d3a504SSascha Wildner.\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
27*b4d3a504SSascha Wildner.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
28*b4d3a504SSascha Wildner.\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
29*b4d3a504SSascha Wildner.\" SUCH DAMAGE.
30*b4d3a504SSascha Wildner.\"
31*b4d3a504SSascha Wildner.Dd October 9, 2019
32*b4d3a504SSascha Wildner.Dt I915 4
33*b4d3a504SSascha Wildner.Os
34*b4d3a504SSascha Wildner.Sh NAME
35*b4d3a504SSascha Wildner.Nm i915
36*b4d3a504SSascha Wildner.Nd Driver for Intel i915 family integrated graphics chipsets
37*b4d3a504SSascha Wildner.Sh DESCRIPTION
38*b4d3a504SSascha WildnerThe
39*b4d3a504SSascha Wildner.Nm
40*b4d3a504SSascha Wildnerdriver provides support for integrated graphics chips by Intel.
41*b4d3a504SSascha WildnerPlease refer the
42*b4d3a504SSascha Wildner.Sx Loader Tunables
43*b4d3a504SSascha Wildnersection in
44*b4d3a504SSascha Wildner.Xr syscons 4
45*b4d3a504SSascha Wildnerfor more information about how to make the console work with
46*b4d3a504SSascha Wildner.Nm .
47*b4d3a504SSascha Wildner.Sh LOADER TUNABLES
48*b4d3a504SSascha WildnerTunables can be set at the
49*b4d3a504SSascha Wildner.Xr loader 8
50*b4d3a504SSascha Wildnerprompt before booting the kernel or stored in
51*b4d3a504SSascha Wildner.Xr loader.conf 5 .
52*b4d3a504SSascha Wildner.Bl -tag -width "xxxxxx"
53*b4d3a504SSascha Wildner.It Va drm.i915.disable_aux_irq
54*b4d3a504SSascha WildnerWhen non-zero, disable interrupt usage for DisplayPort AUX channel.
55*b4d3a504SSascha WildnerThis option doesn't affect GPU models older than Generation 5 (Ironlake).
56*b4d3a504SSascha WildnerCan be used as a workaround in cases where DisplayPort panel
57*b4d3a504SSascha Wildnerinitialization is unreliable, which often leaves a blank screen after the
58*b4d3a504SSascha Wildner.Nm
59*b4d3a504SSascha Wildnermodule was loaded.
60*b4d3a504SSascha Wildner.br
61*b4d3a504SSascha Wildner1 = don't use AUX IRQ, 0 = auto (default).
62*b4d3a504SSascha Wildner.It Va drm.i915.enable_psr
63*b4d3a504SSascha WildnerEnable PSR (panel self refresh), only relevant for Haswell and Broadwell
64*b4d3a504SSascha WildnerCPUs.
65*b4d3a504SSascha Wildner1 = enable, 0 = disable (default).
66*b4d3a504SSascha WildnerTo maximize PSR usage, it can be beneficial to set
67*b4d3a504SSascha Wildner.Va hw.dri.vblank_offdelay
68*b4d3a504SSascha Wildner(see
69*b4d3a504SSascha Wildner.Xr drm 4 )
70*b4d3a504SSascha Wildnerto a sufficiently low value (or
71*b4d3a504SSascha Wildner.Li -1 ) ,
72*b4d3a504SSascha Wildnerto minimize vblank interrupt activity.
73*b4d3a504SSascha Wildner.It Va drm.i915.enable_execlists
74*b4d3a504SSascha WildnerOverride execlists usage on Broadwell IGPs (no effect on other IGP models).
75*b4d3a504SSascha WildnerDisabling execlists reverts to legacy ringbuffer mode.
76*b4d3a504SSascha Wildner-1 = auto (default), 0 = disable, 1 = enable
77*b4d3a504SSascha Wildner.El
78*b4d3a504SSascha Wildner.Sh SYSCTL VARIABLES
79*b4d3a504SSascha WildnerIf display backlight level can be controlled by the GPU (which is often
80*b4d3a504SSascha Wildnerthe case in notebooks), the sysctl
81*b4d3a504SSascha Wildner.Va hw.backlight_level
82*b4d3a504SSascha Wildnercan be used to adjust the backlight level.
83*b4d3a504SSascha WildnerPermitted values are from 0 to the value of
84*b4d3a504SSascha Wildner.Va hw.backlight_max .
85*b4d3a504SSascha Wildner.Sh SEE ALSO
86*b4d3a504SSascha Wildner.Xr drm 4 ,
87*b4d3a504SSascha Wildner.Xr syscons 4
88*b4d3a504SSascha Wildner.Sh HISTORY
89*b4d3a504SSascha WildnerThe
90*b4d3a504SSascha Wildner.Nm
91*b4d3a504SSascha Wildnerdriver was first available for Linux.
92