thinkpad-acpi: improve Kconfig help text
[linux-2.6/linux-acpi-2.6/ibm-acpi-2.6.git] / drivers / platform / x86 / Kconfig
blobdd7d286832a4c28b8b2564bd1ebe8aa47b845411
2 # X86 Platform Specific Drivers
5 menuconfig X86_PLATFORM_DEVICES
6         bool "X86 Platform Specific Device Drivers"
7         default y
8         ---help---
9           Say Y here to get to see options for device drivers for various
10           x86 platforms, including vendor-specific laptop extension drivers.
11           This option alone does not add any kernel code.
13           If you say N, all options in this submenu will be skipped and disabled.
15 if X86_PLATFORM_DEVICES
17 config ACER_WMI
18         tristate "Acer WMI Laptop Extras"
19         depends on ACPI
20         depends on LEDS_CLASS
21         depends on NEW_LEDS
22         depends on BACKLIGHT_CLASS_DEVICE
23         depends on SERIO_I8042
24         depends on RFKILL || RFKILL = n
25         select ACPI_WMI
26         ---help---
27           This is a driver for newer Acer (and Wistron) laptops. It adds
28           wireless radio and bluetooth control, and on some laptops,
29           exposes the mail LED and LCD backlight.
31           For more information about this driver see
32           <file:Documentation/laptops/acer-wmi.txt>
34           If you have an ACPI-WMI compatible Acer/ Wistron laptop, say Y or M
35           here.
37 config ACERHDF
38         tristate "Acer Aspire One temperature and fan driver"
39         depends on THERMAL && THERMAL_HWMON && ACPI
40         ---help---
41           This is a driver for Acer Aspire One netbooks. It allows to access
42           the temperature sensor and to control the fan.
44           After loading this driver the BIOS is still in control of the fan.
45           To let the kernel handle the fan, do:
46           echo -n enabled > /sys/class/thermal/thermal_zone0/mode
48           For more information about this driver see
49           <http://piie.net/files/acerhdf_README.txt>
51           If you have an Acer Aspire One netbook, say Y or M
52           here.
54 config ASUS_LAPTOP
55         tristate "Asus Laptop Extras"
56         depends on ACPI
57         depends on !ACPI_ASUS
58         select LEDS_CLASS
59         select NEW_LEDS
60         select BACKLIGHT_CLASS_DEVICE
61         depends on INPUT
62         ---help---
63           This is the new Linux driver for Asus laptops. It may also support some
64           MEDION, JVC or VICTOR laptops. It makes all the extra buttons generate
65           standard ACPI events and input events. It also adds
66           support for video output switching, LCD backlight control, Bluetooth and
67           Wlan control, and most importantly, allows you to blink those fancy LEDs.
69           For more information and a userspace daemon for handling the extra
70           buttons see <http://acpi4asus.sf.net>.
72           If you have an ACPI-compatible ASUS laptop, say Y or M here.
74 config DELL_LAPTOP
75         tristate "Dell Laptop Extras (EXPERIMENTAL)"
76         depends on X86
77         depends on DCDBAS
78         depends on EXPERIMENTAL
79         depends on BACKLIGHT_CLASS_DEVICE
80         depends on RFKILL || RFKILL = n
81         depends on POWER_SUPPLY
82         default n
83         ---help---
84         This driver adds support for rfkill and backlight control to Dell
85         laptops.
87 config DELL_WMI
88         tristate "Dell WMI extras"
89         depends on ACPI_WMI
90         depends on INPUT
91         ---help---
92           Say Y here if you want to support WMI-based hotkeys on Dell laptops.
94           To compile this driver as a module, choose M here: the module will
95           be called dell-wmi.
97 config FUJITSU_LAPTOP
98         tristate "Fujitsu Laptop Extras"
99         depends on ACPI
100         depends on INPUT
101         depends on BACKLIGHT_CLASS_DEVICE
102         depends on LEDS_CLASS || LEDS_CLASS=n
103         ---help---
104           This is a driver for laptops built by Fujitsu:
106             * P2xxx/P5xxx/S6xxx/S7xxx series Lifebooks
107             * Possibly other Fujitsu laptop models
108             * Tested with S6410 and S7020
110           It adds support for LCD brightness control and some hotkeys.
112           If you have a Fujitsu laptop, say Y or M here.
114 config FUJITSU_LAPTOP_DEBUG
115         bool "Verbose debug mode for Fujitsu Laptop Extras"
116         depends on FUJITSU_LAPTOP
117         default n
118         ---help---
119           Enables extra debug output from the fujitsu extras driver, at the
120           expense of a slight increase in driver size.
122           If you are not sure, say N here.
124 config TC1100_WMI
125         tristate "HP Compaq TC1100 Tablet WMI Extras (EXPERIMENTAL)"
126         depends on !X86_64
127         depends on EXPERIMENTAL
128         depends on ACPI
129         select ACPI_WMI
130         ---help---
131           This is a driver for the WMI extensions (wireless and bluetooth power
132           control) of the HP Compaq TC1100 tablet.
134 config HP_WMI
135         tristate "HP WMI extras"
136         depends on ACPI_WMI
137         depends on INPUT
138         depends on RFKILL || RFKILL = n
139         help
140          Say Y here if you want to support WMI-based hotkeys on HP laptops and
141          to read data from WMI such as docking or ambient light sensor state.
143          To compile this driver as a module, choose M here: the module will
144          be called hp-wmi.
146 config MSI_LAPTOP
147         tristate "MSI Laptop Extras"
148         depends on ACPI
149         depends on BACKLIGHT_CLASS_DEVICE
150         ---help---
151           This is a driver for laptops built by MSI (MICRO-STAR
152           INTERNATIONAL):
154           MSI MegaBook S270 (MS-1013)
155           Cytron/TCM/Medion/Tchibo MD96100/SAM2000
157           It adds support for Bluetooth, WLAN and LCD brightness control.
159           More information about this driver is available at
160           <http://0pointer.de/lennart/tchibo.html>.
162           If you have an MSI S270 laptop, say Y or M here.
164 config PANASONIC_LAPTOP
165         tristate "Panasonic Laptop Extras"
166         depends on INPUT && ACPI
167         depends on BACKLIGHT_CLASS_DEVICE
168         ---help---
169           This driver adds support for access to backlight control and hotkeys
170           on Panasonic Let's Note laptops.
172           If you have a Panasonic Let's note laptop (such as the R1(N variant),
173           R2, R3, R5, T2, W2 and Y2 series), say Y.
175 config COMPAL_LAPTOP
176         tristate "Compal Laptop Extras"
177         depends on ACPI
178         depends on BACKLIGHT_CLASS_DEVICE
179         ---help---
180           This is a driver for laptops built by Compal:
182           Compal FL90/IFL90
183           Compal FL91/IFL91
184           Compal FL92/JFL92
185           Compal FT00/IFT00
187           It adds support for Bluetooth, WLAN and LCD brightness control.
189           If you have an Compal FL9x/IFL9x/FT00 laptop, say Y or M here.
191 config SONY_LAPTOP
192         tristate "Sony Laptop Extras"
193         depends on ACPI
194         select BACKLIGHT_CLASS_DEVICE
195         depends on INPUT
196         depends on RFKILL
197           ---help---
198           This mini-driver drives the SNC and SPIC devices present in the ACPI
199           BIOS of the Sony Vaio laptops.
201           It gives access to some extra laptop functionalities like Bluetooth,
202           screen brightness control, Fn keys and allows powering on/off some
203           devices.
205           Read <file:Documentation/laptops/sony-laptop.txt> for more information.
207 config SONYPI_COMPAT
208         bool "Sonypi compatibility"
209         depends on SONY_LAPTOP
210           ---help---
211           Build the sonypi driver compatibility code into the sony-laptop driver.
213 config THINKPAD_ACPI
214         tristate "ThinkPad ACPI Laptop Extras"
215         depends on ACPI
216         depends on INPUT
217         depends on RFKILL || RFKILL = n
218         select BACKLIGHT_LCD_SUPPORT
219         select BACKLIGHT_CLASS_DEVICE
220         select HWMON
221         select NVRAM
222         select NEW_LEDS
223         select LEDS_CLASS
224         ---help---
225           This is a driver for the IBM and Lenovo ThinkPad laptops. It adds
226           support for Fn-Fx key combinations, Bluetooth control, video
227           output switching, ThinkLight control, UltraBay eject and more.
228           For more information about this driver see
229           <file:Documentation/laptops/thinkpad-acpi.txt> and
230           <http://ibm-acpi.sf.net/> .
232           This driver was formerly known as ibm-acpi.
234           Extra functionality will be available if the rfkill (CONFIG_RFKILL)
235           and/or ALSA (CONFIG_SND) subsystems are available in the kernel.
236           Note that if you want ThinkPad-ACPI to be built-in instead of
237           modular, ALSA and rfkill will also have to be built-in.
239           If you have an IBM or Lenovo ThinkPad laptop, say Y or M here.
241 config THINKPAD_ACPI_ALSA_SUPPORT
242         bool "Console audio control ALSA interface"
243         depends on THINKPAD_ACPI
244         depends on SND
245         depends on SND = y || THINKPAD_ACPI = SND
246         default y
247         ---help---
248           Enables monitoring of the built-in console audio output control
249           (headphone and speakers), which is operated by the mute and (in
250           some ThinkPad models) volume hotkeys.
252           If this option is enabled, ThinkPad-ACPI will export an ALSA card
253           with a single read-only mixer control, which should be used for
254           on-screen-display feedback purposes by the Desktop Environment.
256           Optionally, the driver will also allow software control (the
257           ALSA mixer will be made read-write).  Please refer to the driver
258           documentation for details.
260           All IBM models have both volume and mute control.  Newer Lenovo
261           models only have mute control (the volume hotkeys are just normal
262           keys and volume control is done through the main HDA mixer).
264 config THINKPAD_ACPI_DEBUGFACILITIES
265         bool "Maintainer debug facilities"
266         depends on THINKPAD_ACPI
267         default n
268         ---help---
269           Enables extra stuff in the thinkpad-acpi which is completely useless
270           for normal use.  Read the driver source to find out what it does.
272           Say N here, unless you were told by a kernel maintainer to do
273           otherwise.
275 config THINKPAD_ACPI_DEBUG
276         bool "Verbose debug mode"
277         depends on THINKPAD_ACPI
278         default n
279         ---help---
280           Enables extra debugging information, at the expense of a slightly
281           increase in driver size.
283           If you are not sure, say N here.
285 config THINKPAD_ACPI_UNSAFE_LEDS
286         bool "Allow control of important LEDs (unsafe)"
287         depends on THINKPAD_ACPI
288         default n
289         ---help---
290           Overriding LED state on ThinkPads can mask important
291           firmware alerts (like critical battery condition), or misled
292           the user into damaging the hardware (undocking or ejecting
293           the bay while buses are still active), etc.
295           LED control on the ThinkPad is write-only (with very few
296           exceptions on very ancient models), which makes it
297           impossible to know beforehand if important information will
298           be lost when one changes LED state.
300           Users that know what they are doing can enable this option
301           and the driver will allow control of every LED, including
302           the ones on the dock stations.
304           Never enable this option on a distribution kernel.
306           Say N here, unless you are building a kernel for your own
307           use, and need to control the important firmware LEDs.
309 config THINKPAD_ACPI_VIDEO
310         bool "Video output control support"
311         depends on THINKPAD_ACPI
312         default y
313         ---help---
314           Allows the thinkpad_acpi driver to provide an interface to control
315           the various video output ports.
317           This feature often won't work well, depending on ThinkPad model,
318           display state, video output devices in use, whether there is a X
319           server running, phase of the moon, and the current mood of
320           Schroedinger's cat.  If you can use X.org's RandR to control
321           your ThinkPad's video output ports instead of this feature,
322           don't think twice: do it and say N here to save memory and avoid
323           bad interactions with X.org.
325           NOTE: access to this feature is limited to processes with the
326           CAP_SYS_ADMIN capability, to avoid local DoS issues in platforms
327           where it interacts badly with X.org.
329           If you are not sure, say Y here but do try to check if you could
330           be using X.org RandR instead.
332 config THINKPAD_ACPI_HOTKEY_POLL
333         bool "Support NVRAM polling for hot keys"
334         depends on THINKPAD_ACPI
335         default y
336         ---help---
337           Some thinkpad models benefit from NVRAM polling to detect a few of
338           the hot key press events.  If you know your ThinkPad model does not
339           need to do NVRAM polling to support any of the hot keys you use,
340           unselecting this option will save about 1kB of memory.
342           ThinkPads T40 and newer, R52 and newer, and X31 and newer are
343           unlikely to need NVRAM polling in their latest BIOS versions.
345           NVRAM polling can detect at most the following keys: ThinkPad/Access
346           IBM, Zoom, Switch Display (fn+F7), ThinkLight, Volume up/down/mute,
347           Brightness up/down, Display Expand (fn+F8), Hibernate (fn+F12).
349           If you are not sure, say Y here.  The driver enables polling only if
350           it is strictly necessary to do so.
352 config INTEL_MENLOW
353         tristate "Thermal Management driver for Intel menlow platform"
354         depends on ACPI_THERMAL
355         select THERMAL
356         ---help---
357           ACPI thermal management enhancement driver on
358           Intel Menlow platform.
360           If unsure, say N.
362 config EEEPC_LAPTOP
363         tristate "Eee PC Hotkey Driver (EXPERIMENTAL)"
364         depends on ACPI
365         depends on INPUT
366         depends on EXPERIMENTAL
367         depends on RFKILL || RFKILL = n
368         depends on HOTPLUG_PCI
369         select BACKLIGHT_CLASS_DEVICE
370         select HWMON
371         ---help---
372           This driver supports the Fn-Fx keys on Eee PC laptops.
374           It  also gives access to some extra laptop functionalities like
375           Bluetooth, backlight and allows powering on/off some other
376           devices.
378           If you have an Eee PC laptop, say Y or M here.
381 config ACPI_WMI
382         tristate "WMI"
383         depends on ACPI
384         help
385           This driver adds support for the ACPI-WMI (Windows Management
386           Instrumentation) mapper device (PNP0C14) found on some systems.
388           ACPI-WMI is a proprietary extension to ACPI to expose parts of the
389           ACPI firmware to userspace - this is done through various vendor
390           defined methods and data blocks in a PNP0C14 device, which are then
391           made available for userspace to call.
393           The implementation of this in Linux currently only exposes this to
394           other kernel space drivers.
396           This driver is a required dependency to build the firmware specific
397           drivers needed on many machines, including Acer and HP laptops.
399           It is safe to enable this driver even if your DSDT doesn't define
400           any ACPI-WMI devices.
402 config ACPI_ASUS
403         tristate "ASUS/Medion Laptop Extras (DEPRECATED)"
404         depends on ACPI
405         select BACKLIGHT_CLASS_DEVICE
406         ---help---
407           This driver provides support for extra features of ACPI-compatible
408           ASUS laptops. As some of Medion laptops are made by ASUS, it may also
409           support some Medion laptops (such as 9675 for example).  It makes all
410           the extra buttons generate standard ACPI events that go through
411           /proc/acpi/events, and (on some models) adds support for changing the
412           display brightness and output, switching the LCD backlight on and off,
413           and most importantly, allows you to blink those fancy LEDs intended
414           for reporting mail and wireless status.
416           Note: display switching code is currently considered EXPERIMENTAL,
417           toying with these values may even lock your machine.
419           All settings are changed via /proc/acpi/asus directory entries. Owner
420           and group for these entries can be set with asus_uid and asus_gid
421           parameters.
423           More information and a userspace daemon for handling the extra buttons
424           at <http://acpi4asus.sf.net>.
426           If you have an ACPI-compatible ASUS laptop, say Y or M here. This
427           driver is still under development, so if your laptop is unsupported or
428           something works not quite as expected, please use the mailing list
429           available on the above page (acpi4asus-user@lists.sourceforge.net).
431           NOTE: This driver is deprecated and will probably be removed soon,
432           use asus-laptop instead.
434 config TOPSTAR_LAPTOP
435         tristate "Topstar Laptop Extras"
436         depends on ACPI
437         depends on INPUT
438         ---help---
439           This driver adds support for hotkeys found on Topstar laptops.
441           If you have a Topstar laptop, say Y or M here.
443 config ACPI_TOSHIBA
444         tristate "Toshiba Laptop Extras"
445         depends on ACPI
446         depends on INPUT
447         depends on RFKILL || RFKILL = n
448         select INPUT_POLLDEV
449         select BACKLIGHT_CLASS_DEVICE
450         ---help---
451           This driver adds support for access to certain system settings
452           on "legacy free" Toshiba laptops.  These laptops can be recognized by
453           their lack of a BIOS setup menu and APM support.
455           On these machines, all system configuration is handled through the
456           ACPI.  This driver is required for access to controls not covered
457           by the general ACPI drivers, such as LCD brightness, video output,
458           etc.
460           This driver differs from the non-ACPI Toshiba laptop driver (located
461           under "Processor type and features") in several aspects.
462           Configuration is accessed by reading and writing text files in the
463           /proc tree instead of by program interface to /dev.  Furthermore, no
464           power management functions are exposed, as those are handled by the
465           general ACPI drivers.
467           More information about this driver is available at
468           <http://memebeam.org/toys/ToshibaAcpiDriver>.
470           If you have a legacy free Toshiba laptop (such as the Libretto L1
471           series), say Y.
472 endif # X86_PLATFORM_DEVICES