Lines Matching +full:video +full:- +full:firmware
9 - Borislav Deianov <borislav@users.sf.net>
10 - Henrique de Moraes Holschuh <hmh@hmh.eng.br>
12 http://ibm-acpi.sf.net/
19 This driver used to be named ibm-acpi until kernel 2.6.21 and release
20 0.13-20070314. It used to be in the drivers/acpi tree, but it was
21 moved to the drivers/misc tree and renamed to thinkpad-acpi for kernel
25 The driver is named "thinkpad-acpi". In some places, like module
29 "tpacpi" is used as a shorthand where "thinkpad-acpi" would be too
33 ------
38 - Fn key combinations
39 - Bluetooth enable and disable
40 - video output switching, expansion control
41 - ThinkLight on and off
42 - CMOS/UCMS control
43 - LED control
44 - ACPI sounds
45 - temperature sensors
46 - Experimental: embedded controller register dump
47 - LCD brightness control
48 - Volume control
49 - Fan control and monitoring: fan speed, fan enable/disable
50 - WAN enable and disable
51 - UWB enable and disable
52 - LCD Shadow (PrivacyGuard) enable and disable
53 - Lap mode sensor
56 site, http://ibm-acpi.sf.net/. I appreciate any success or failure
60 - ThinkPad model name
61 - a copy of your ACPI tables, using the "acpidump" utility
62 - a copy of the output of dmidecode, with serial numbers
64 - which driver features work and which don't
65 - the observed behavior of non-working features
71 ------------
75 It is located on the menu path: "Device Drivers" -> "X86 Platform
76 Specific Device Drivers" -> "ThinkPad ACPI Laptop Extras".
80 --------
83 used to access the features it provides. One is a legacy procfs-based
85 is a new sysfs-based interface which is not complete yet.
104 thinkpad-acpi's implementation of sysfs interfaces.
106 Also, any bugs in the thinkpad-acpi sysfs driver code or in the
107 thinkpad-acpi's implementation of the sysfs interfaces will be fixed for
109 non-compatible ways. As these interfaces mature both in the kernel and
110 in thinkpad-acpi, such changes should become quite rare.
112 Applications interfacing to the thinkpad-acpi sysfs interfaces must
117 The version of thinkpad-acpi's sysfs interface is exported by the driver
135 --------------
145 -----------------------
149 Version of the thinkpad-acpi sysfs interface, as an unsigned long
153 - major revision
155 - minor revision
157 - bugfix revision
164 Changes to the thinkpad-acpi sysfs interface are only considered
165 non-experimental when they are submitted to Linux mainline, at which
167 may be updated. If you are using any thinkpad-acpi features not yet
172 Changes that are backwards-compatible by nature (e.g. the addition of
181 --------
189 system. Enabling the hotkey functionality of thinkpad-acpi signals the
190 firmware that such a driver is present, and modifies how the ThinkPad
191 firmware will behave in many situations.
208 events. If a key is "masked" (bit set to 0 in the mask), the firmware
209 will handle it. If it is "unmasked", it signals the firmware that
210 thinkpad-acpi would prefer to handle it, if the firmware would be so
218 The driver will filter out any unmasked hotkeys, so even if the firmware
224 Bluetooth by itself in firmware.
227 depending on the ThinkPad model and firmware version. On those
237 echo 0xffffffff > /proc/acpi/ibm/hotkey -- enable all hot keys
238 echo 0 > /proc/acpi/ibm/hotkey -- disable all possible hot keys
239 ... any other 8-hex-digit mask ...
240 echo reset > /proc/acpi/ibm/hotkey -- restore the recommended mask
245 echo enable > /proc/acpi/ibm/hotkey -- does nothing
246 echo disable > /proc/acpi/ibm/hotkey -- returns an error
249 maintain maximum bug-to-bug compatibility, it does not report any masks,
250 nor does it allow one to manipulate the hot key mask when the firmware
264 Returns the hot keys mask when thinkpad-acpi was loaded.
267 the hotkeys that were supported by ancient firmware
273 0: returns -EPERM
278 the firmware, ACPI event generation) for each hot key
286 passively (because the firmware *will* handle them
293 handled by the firmware anyway. Echo it to
299 poll the NVRAM for. This is auto-detected by the driver
300 based on the capabilities reported by the ACPI firmware,
313 events are reported by the firmware and can behave
314 differently (and that behaviour changes with firmware
315 version -- not just with firmware models -- as well as
351 undock. Set to zero for normal wake-ups or wake-ups
389 backwards-compatible way. The MSB shall always be 0x41 for this input
393 been changed in a non-backwards compatible way.
396 backwards-compatible change for this input device.
398 Thinkpad-acpi Hot Key event map (version 0x4101):
404 0x1001 0x00 FN+F1 -
414 off the ThinkLight as side-effect
418 semantics, i.e. sleep-to-RAM).
422 event. The firmware may
430 and W-WAN card if left in control
431 of the firmware. Does not affect
434 radios (Bluetooth+W-WAN+WLAN),
437 0x1006 0x05 FN+F6 -
439 0x1007 0x06 FN+F7 Video output cycle.
446 0x1009 0x08 FN+F9 -
450 0x100B 0x0A FN+F11 -
456 The firmware may refuse to
462 0x100D 0x0C FN+BACKSPACE -
463 0x100E 0x0D FN+INSERT -
464 0x100F 0x0E FN+DELETE -
467 always handled by the firmware
479 always handled by the firmware,
482 0x1013 0x12 FN+PGDOWN -
488 firmware, even when unmasked.
493 firmware, even when unmasked.
498 firmware, even when unmasked.
509 The ThinkPad firmware does not allow one to differentiate when most hot
513 unknown by the driver if the ThinkPad firmware triggered these events on
514 hot key press or release, but the firmware will do it for either one, not
522 In addition to the EV_KEY events, thinkpad-acpi may also issue EV_SW
531 ------------------------------
562 0x4010 Docked into hotplug port replicator (non-ACPI dock)
563 0x4011 Undocked from hotplug port replicator (non-ACPI dock)
580 wake up caused by the firmware will have negated most safety nets...
609 ---------
621 so it is kept across reboots and power-off.
635 disabled through the "bluetooth_enable" thinkpad-acpi device
640 - 0: disables Bluetooth / Bluetooth is disabled
641 - 1: enables Bluetooth / Bluetooth is enabled.
648 Documentation/driver-api/rfkill.rst for details.
651 Video output control -- /proc/acpi/ibm/video
652 --------------------------------------------
654 This feature allows control over the devices used for video output -
657 echo lcd_enable > /proc/acpi/ibm/video
658 echo lcd_disable > /proc/acpi/ibm/video
659 echo crt_enable > /proc/acpi/ibm/video
660 echo crt_disable > /proc/acpi/ibm/video
661 echo dvi_enable > /proc/acpi/ibm/video
662 echo dvi_disable > /proc/acpi/ibm/video
663 echo auto_enable > /proc/acpi/ibm/video
664 echo auto_disable > /proc/acpi/ibm/video
665 echo expand_toggle > /proc/acpi/ibm/video
666 echo video_switch > /proc/acpi/ibm/video
673 Each video output device can be enabled or disabled individually.
674 Reading /proc/acpi/ibm/video shows the status of each device.
676 Automatic video switching can be enabled or disabled. When automatic
677 video switching is enabled, certain events (e.g. opening the lid,
678 docking or undocking) cause the video output device to change
680 and, on the X40, video corruption. By disabling automatic switching,
681 the flickering or video corruption can be avoided.
683 The video_switch command cycles through the available video outputs
684 (it simulates the behavior of Fn-F7).
686 Video expansion can be toggled through this feature. This controls
689 video expansion status cannot be determined through this feature.
692 chips) the X driver configures the video card in a way which prevents
693 Fn-F7 from working. This also disables the video output switching
695 Fn-F7. Video switching on the console should still work.
701 ------------------
721 documentation, in Documentation/leds/leds-class.rst. The ThinkLight LED name
725 cannot be read or if it is unknown, thinkpad-acpi will report it as "off".
730 -----------------
736 This feature is mostly used internally by the ACPI firmware to keep the legacy
750 - 0 - Related to "Volume down" key press
751 - 1 - Related to "Volume up" key press
752 - 2 - Related to "Mute on" key press
753 - 3 - Related to "Access IBM" key press
754 - 4 - Related to "LCD brightness up" key press
755 - 5 - Related to "LCD brightness down" key press
756 - 11 - Related to "toggle screen expansion" key press/function
757 - 12 - Related to "ThinkLight on"
758 - 13 - Related to "ThinkLight off"
759 - 14 - Related to "ThinkLight" key press (toggle ThinkLight)
761 The cmos command interface is prone to firmware split-brain problems, as
767 -----------
783 Unrestricted access to all LEDs requires that thinkpad-acpi be
789 visible to userspace. They are used by the snd-hda-intel audio driver.
804 - 0 - power
805 - 1 - battery (orange)
806 - 2 - battery (green)
807 - 3 - UltraBase/dock
808 - 4 - UltraBay
809 - 5 - UltraBase battery slot
810 - 6 - (unknown)
811 - 7 - standby
812 - 8 - dock status 1
813 - 9 - dock status 2
814 - 10, 11 - (unknown)
815 - 12 - thinkvantage
816 - 13, 14, 15 - (unknown)
824 documentation, in Documentation/leds/leds-class.rst.
834 indicators cannot be read due to an error, thinkpad-acpi will report it as
837 If the thinkpad firmware doesn't support reading the current status,
850 a report to ibm-acpi-devel@lists.sourceforge.net is appreciated.
853 ACPI sounds -- /proc/acpi/ibm/beep
854 ----------------------------------
856 The BEEP method is used internally by the ACPI firmware to provide
860 The commands are non-negative integer numbers::
868 - 0 - stop a sound in progress (but use 17 to stop 16)
869 - 2 - two beeps, pause, third beep ("low battery")
870 - 3 - single beep
871 - 4 - high, followed by low-pitched beep ("unable")
872 - 5 - single beep
873 - 6 - very high, followed by high-pitched beep ("AC/DC")
874 - 7 - high-pitched beep
875 - 9 - three short beeps
876 - 10 - very long beep
877 - 12 - low-pitched beep
878 - 15 - three high-pitched beeps repeating constantly, stop with 0
879 - 16 - one medium-pitched beep repeating constantly, stop with 17
880 - 17 - stop 16
884 -------------------
898 42 42 45 41 36 -128 33 -128
903 48 48 36 52 38 -128 31 -128 48 52 48 -128 -128 -128 -128 -128
906 system-board model (and thus, on ThinkPad model).
913 - 1: CPU
914 - 2: (depends on model)
915 - 3: (depends on model)
916 - 4: GPU
917 - 5: Main battery: main sensor
918 - 6: Bay battery: main sensor
919 - 7: Main battery: secondary sensor
920 - 8: Bay battery: secondary sensor
921 - 9-15: (depends on model)
925 - 2: Mini-PCI
926 - 3: Internal HDD
931 - 2: System board, left side (near PCMCIA slot), reported as HDAPS temp
932 - 3: PCMCIA slot
933 - 9: MCH (northbridge) to DRAM Bus
934 - 10: Clock-generator, mini-pci card and ICH (southbridge), under Mini-PCI
936 - 11: Power regulator, underside of system board, below F2 key
941 - 1: CPU
942 - 2: Main Battery: main sensor
943 - 3: Power Converter
944 - 4: Bay Battery: main sensor
945 - 5: MCH (northbridge)
946 - 6: PCMCIA/ambient
947 - 7: Main Battery: secondary sensor
948 - 8: Bay Battery: secondary sensor
954 Readings from sensors that are not available return -128.
964 thinkpad-acpi thermal sensors are reported through the hwmon
969 -----------------------------------------------
979 - make sure the battery is fully charged
980 - make sure the fan is running
981 - use above mentioned tool to read out the EC
988 embedded controller registers - e.g. make sure nothing else changes
996 ----------------------
1015 For IBM ThinkPads, there are two interfaces to the firmware for direct
1030 ThinkPad-specific interface. The driver will disable its native
1034 If you want to use the thinkpad-acpi backlight brightness control
1035 instead of the generic ACPI video backlight brightness control for some
1079 because thinkpad-acpi cannot really turn the backlight
1087 Whatever you do, do NOT ever call thinkpad-acpi backlight-level change
1088 interface and the ACPI-based backlight level change interface
1089 (available on newer BIOSes, and driven by the Linux ACPI video driver)
1096 --------------------------------------
1102 NOTE: by default, the volume control interface operates in read-only
1103 mode, as it is supposed to be used for on-screen-display purposes.
1110 the desktop environment to just provide on-screen-display feedback.
1118 ThinkPads have a built-in amplifier and muting circuit that drives the
1121 firmware.
1135 This is a very superior design when compared to the cheap software-only
1136 mute-toggle solution found on normal consumer laptops: you can be
1140 The IBM ThinkPads, and the earlier Lenovo ThinkPads have variable-gain
1141 amplifiers driving the speakers and headphone output, and the firmware
1147 The newer Lenovo models only have firmware mute control, and depend on
1150 key press (there are some firmware bugs in this area) and delivered as
1151 normal key presses to the operating system (thinkpad-acpi is not
1155 The ThinkPad-ACPI volume control
1176 whether your thinkpad has volume control or mute-only control:
1181 please report this to ibm-acpi-devel@lists.sourceforge.net, so that we
1191 ibm-acpi-devel@lists.sourceforge.net.
1198 ---------------------------------------------------------
1209 must be given to thinkpad-acpi.
1223 Most ThinkPad fans work in "levels" at the firmware interface. Level 0
1231 There is also a "full-speed" level, also known as "disengaged" level.
1232 In this level, the EC disables the speed-locked closed-loop fan control,
1238 commands. The full-speed level may take up to two minutes to ramp up to
1240 while the EC is transitioning to the full-speed level.
1260 through thinkpad-acpi.
1262 The thinkpad-acpi kernel driver can be programmed to revert the fan
1292 "full-speed" (without the quotes). Not all ThinkPads support the "auto"
1293 and "full-speed" levels. The driver accepts "disengaged" as an alias for
1294 "full-speed", and reports it as "disengaged" for backwards
1323 is out-of-bounds, and EPERM if it is forbidden. They may also return
1325 to the firmware).
1330 - 0: PWM offline (fan is set to full-speed mode)
1331 - 1: Manual PWM control (use pwm1 to set fan level)
1332 - 2: Hardware PWM control (EC "auto" mode)
1333 - 3: reserved (Software PWM control, not implemented yet)
1337 mode is unsupported, it will return -EINVAL.
1340 Fan level, scaled from the firmware values of 0-7 to the hwmon
1341 scale of 0-255. 0 means fan stopped, 255 means highest normal
1370 ---
1378 This feature shows the presence and current state of the built-in
1382 so it is kept across reboots and power-off.
1390 If the W-WAN card is installed, the following commands can be used::
1398 If the W-WAN card is installed, it can be enabled /
1399 disabled through the "wwan_enable" thinkpad-acpi device
1403 - 0: disables WWAN card / WWAN card is disabled
1404 - 1: enables WWAN card / WWAN card is enabled.
1411 Documentation/driver-api/rfkill.rst for details.
1415 ------------------
1437 -------------------
1447 The property is read-only. If the platform doesn't have support the sysfs
1451 -----------------
1467 Documentation/driver-api/rfkill.rst for details.
1470 -----------------
1478 - 1 = Home mode
1479 - 2 = Web-browser mode
1480 - 3 = Web-conference mode
1481 - 4 = Function mode
1482 - 5 = Layflat mode
1489 ----------------------
1503 Documentation/ABI/testing/sysfs-class-power.
1506 ------------------------------------
1512 echo lcd_disable,crt_enable > /proc/acpi/ibm/video
1514 Commands can also be specified when loading the thinkpad-acpi module,
1517 modprobe thinkpad_acpi hotkey=enable,0xffff video=auto_disable
1521 -------------------------
1555 -----------------------
1557 If thinkpad-acpi refuses to detect your ThinkPad, you can try to specify
1559 not, please contact ibm-acpi-devel@lists.sourceforge.net with a report.
1573 the firmware.
1577 and the hwmon class for libsensors4 (lm-sensors 3)
1581 0x020100: Marker for thinkpad-acpi with hot key NVRAM polling
1586 0x020101: Marker for thinkpad-acpi with hot key NVRAM polling
1610 0x020700: Support for mute-only mixers.
1611 Volume control in read-only mode by default.