xref: /freebsd/share/man/man4/acpi_video.4 (revision fa9896e082a1046ff4fbc75fcba4d18d1f2efc19)
1e2a643eeSNate Lawson.\"
2e2a643eeSNate Lawson.\" Copyright (c) 2004 Mark Santcroos <marks@ripe.net>
3e2a643eeSNate Lawson.\" All rights reserved.
4e2a643eeSNate Lawson.\"
5e2a643eeSNate Lawson.\" Redistribution and use in source and binary forms, with or without
6e2a643eeSNate Lawson.\" modification, are permitted provided that the following conditions
7e2a643eeSNate Lawson.\" are met:
8e2a643eeSNate Lawson.\" 1. Redistributions of source code must retain the above copyright
9e2a643eeSNate Lawson.\"    notice, this list of conditions and the following disclaimer.
10e2a643eeSNate Lawson.\" 2. Redistributions in binary form must reproduce the above copyright
11e2a643eeSNate Lawson.\"    notice, this list of conditions and the following disclaimer in the
12e2a643eeSNate Lawson.\"    documentation and/or other materials provided with the distribution.
13e2a643eeSNate Lawson.\"
14e2a643eeSNate Lawson.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15e2a643eeSNate Lawson.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16e2a643eeSNate Lawson.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17e2a643eeSNate Lawson.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18e2a643eeSNate Lawson.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19e2a643eeSNate Lawson.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20e2a643eeSNate Lawson.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21e2a643eeSNate Lawson.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22e2a643eeSNate Lawson.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23e2a643eeSNate Lawson.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
24e2a643eeSNate Lawson.\" SUCH DAMAGE.
25e2a643eeSNate Lawson.\"
2675478544SNate Lawson.Dd November 8, 2004
27e2a643eeSNate Lawson.Dt ACPI_VIDEO 4
28e2a643eeSNate Lawson.Os
29e2a643eeSNate Lawson.Sh NAME
30e2a643eeSNate Lawson.Nm acpi_video
31e2a643eeSNate Lawson.Nd ACPI Video Extensions driver
32e2a643eeSNate Lawson.Sh SYNOPSIS
33e2a643eeSNate Lawson.Cd "device acpi_video"
34e2a643eeSNate Lawson.Sh DESCRIPTION
35e2a643eeSNate LawsonThis driver uses the ACPI Video Extensions to control display switching and
36e2a643eeSNate Lawsonbacklight brightness.
37e2a643eeSNate LawsonThe availability of the
38e2a643eeSNate Lawson.Xr sysctl 8
3901ddd31fSRuslan Ermilovvariables depends on the functions offered by the host's ACPI implementation.
4044cb3ab0SHiroki Sato.Sh SYSCTL VARIABLES
41e2a643eeSNate LawsonThe following sysctls are currently implemented,
4201ddd31fSRuslan Ermilovwhere
4301ddd31fSRuslan Ermilov.Aq Ar device
4401ddd31fSRuslan Ermilovis
4501ddd31fSRuslan Ermilov.Va crt , lcd ,
4601ddd31fSRuslan Ermilovor
4701ddd31fSRuslan Ermilov.Va tv :
48e2a643eeSNate Lawson.Bl -tag -width indent
4901ddd31fSRuslan Ermilov.It Va hw.acpi.video. Ns Ao Ar device Ac Ns Va .active
5075478544SNate LawsonCurrent state of the output device.
5101ddd31fSRuslan Ermilov.It Va hw.acpi.video. Ns Ao Ar device Ac Ns Va .levels
52e2a643eeSNate LawsonList of supported brightness levels.
5301ddd31fSRuslan Ermilov.It Va hw.acpi.video. Ns Ao Ar device Ac Ns Va .brightness
54e2a643eeSNate LawsonCurrent brightness level of the device.
5501ddd31fSRuslan Ermilov.It Va hw.acpi.video. Ns Ao Ar device Ac Ns Va .fullpower
56e2a643eeSNate LawsonPreset brightness level to be used in full power mode.
5701ddd31fSRuslan Ermilov.It Va hw.acpi.video. Ns Ao Ar device Ac Ns Va .economy
58e2a643eeSNate LawsonPreset brightness level to be used in economy mode.
59e2a643eeSNate Lawson.El
60e2a643eeSNate Lawson.Pp
61e2a643eeSNate LawsonDefaults for these variables can be set in
62e2a643eeSNate Lawson.Xr sysctl.conf 5 ,
63e2a643eeSNate Lawsonwhich is parsed at boot-time.
64*4c18532bSEmmanuel Vadot.Sh COMPATIBILITY
65*4c18532bSEmmanuel VadotIn order for
66*4c18532bSEmmanuel Vadot.Nm
67*4c18532bSEmmanuel Vadotto attach correctly,
68*4c18532bSEmmanuel Vadot.Nm
69*4c18532bSEmmanuel Vadotshould be loaded after any of the DRM kernel modules.
70*4c18532bSEmmanuel VadotThis can be achieved by setting the correct order in
71*4c18532bSEmmanuel Vadot.Xr rc.conf 5
72*4c18532bSEmmanuel Vadotusing the kld_list directive.
73e2a643eeSNate Lawson.Sh SEE ALSO
74e2a643eeSNate Lawson.Xr acpi 4 ,
75e2a643eeSNate Lawson.Xr loader.conf 5 ,
76e2a643eeSNate Lawson.Xr sysctl.conf 5 ,
77e2a643eeSNate Lawson.Xr sysctl 8
78e2a643eeSNate Lawson.Sh HISTORY
79e2a643eeSNate LawsonThe
80e2a643eeSNate Lawson.Nm
81e2a643eeSNate Lawsondriver first appeared in
82e2a643eeSNate Lawson.Fx 5.3 .
83e2a643eeSNate Lawson.Sh AUTHORS
84e2a643eeSNate Lawson.An -nosplit
85e2a643eeSNate LawsonThe
86e2a643eeSNate Lawson.Nm
87e2a643eeSNate Lawsondriver was written by
886c899950SBaptiste Daroussin.An Taku YAMAMOTO Aq Mt taku@cent.saitama-u.ac.jp .
89e2a643eeSNate LawsonThis manual page was written by
906c899950SBaptiste Daroussin.An Mark Santcroos Aq Mt marks@ripe.net .
9175478544SNate Lawson.Sh BUGS
9275478544SNate LawsonSome systems only perform output switching via SMM even though they export
9375478544SNate Lawsonthe proper information via ACPI.
9475478544SNate LawsonOn such systems, the proper hotkeys or OEM driver (for example,
9575478544SNate Lawson.Xr acpi_toshiba 4 )
9675478544SNate Lawsonmust be used instead.
97