Lines Matching +full:video +full:- +full:interface
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
54 - Setting keyboard language
55 - WWAN Antenna type
56 - Auxmac
59 site, http://ibm-acpi.sf.net/. I appreciate any success or failure
63 - ThinkPad model name
64 - a copy of your ACPI tables, using the "acpidump" utility
65 - a copy of the output of dmidecode, with serial numbers
67 - which driver features work and which don't
68 - the observed behavior of non-working features
74 ------------
78 It is located on the menu path: "Device Drivers" -> "X86 Platform
79 Specific Device Drivers" -> "ThinkPad ACPI Laptop Extras".
83 --------
86 used to access the features it provides. One is a legacy procfs-based
87 interface, which will be removed at some time in the future. The other
88 is a new sysfs-based interface which is not complete yet.
90 The procfs interface creates the /proc/acpi/ibm directory. There is a
92 interface is mostly frozen, and will change very little if at all: it
94 all new functionality will be implemented on the sysfs interface.
96 The sysfs interface tries to blend in the generic Linux sysfs subsystems
98 yet ready or stabilized, it is expected that this interface will change,
102 Notes about the sysfs interface
105 Unlike what was done with the procfs interface, correctness when talking
107 thinkpad-acpi's implementation of sysfs interfaces.
109 Also, any bugs in the thinkpad-acpi sysfs driver code or in the
110 thinkpad-acpi's implementation of the sysfs interfaces will be fixed for
111 maximum correctness, even if that means changing an interface in
112 non-compatible ways. As these interfaces mature both in the kernel and
113 in thinkpad-acpi, such changes should become quite rare.
115 Applications interfacing to the thinkpad-acpi sysfs interfaces must
117 interface makes extensive use of errors). File descriptors and open /
120 The version of thinkpad-acpi's sysfs interface is exported by the driver
138 --------------
147 Sysfs interface version
148 -----------------------
152 Version of the thinkpad-acpi sysfs interface, as an unsigned long
156 - major revision
158 - minor revision
160 - bugfix revision
162 The sysfs interface version changelog for the driver can be found at the
163 end of this document. Changes to the sysfs interface done by the kernel
167 Changes to the thinkpad-acpi sysfs interface are only considered
168 non-experimental when they are submitted to Linux mainline, at which
169 point the changes in this interface are documented and interface_version
170 may be updated. If you are using any thinkpad-acpi features not yet
175 Changes that are backwards-compatible by nature (e.g. the addition of
184 --------
192 system. Enabling the hotkey functionality of thinkpad-acpi signals the
213 thinkpad-acpi would prefer to handle it, if the firmware would be so
240 echo 0xffffffff > /proc/acpi/ibm/hotkey -- enable all hot keys
241 echo 0 > /proc/acpi/ibm/hotkey -- disable all possible hot keys
242 ... any other 8-hex-digit mask ...
243 echo reset > /proc/acpi/ibm/hotkey -- restore the recommended mask
248 echo enable > /proc/acpi/ibm/hotkey -- does nothing
249 echo disable > /proc/acpi/ibm/hotkey -- returns an error
251 The procfs interface does not support NVRAM polling control. So as to
252 maintain maximum bug-to-bug compatibility, it does not report any masks,
267 Returns the hot keys mask when thinkpad-acpi was loaded.
276 0: returns -EPERM
302 poll the NVRAM for. This is auto-detected by the driver
315 interface. When in ACPI event mode, volume up/down/mute
318 version -- not just with firmware models -- as well as
354 undock. Set to zero for normal wake-ups or wake-ups
392 backwards-compatible way. The MSB shall always be 0x41 for this input
396 been changed in a non-backwards compatible way.
399 backwards-compatible change for this input device.
401 Thinkpad-acpi Hot Key event map (version 0x4101):
407 0x1001 0x00 FN+F1 -
417 off the ThinkLight as side-effect
421 semantics, i.e. sleep-to-RAM).
433 and W-WAN card if left in control
437 radios (Bluetooth+W-WAN+WLAN),
440 0x1006 0x05 FN+F6 -
442 0x1007 0x06 FN+F7 Video output cycle.
453 0x1009 0x08 FN+F9 -
457 0x100B 0x0A FN+F11 -
469 0x100D 0x0C FN+BACKSPACE -
470 0x100E 0x0D FN+INSERT -
471 0x100F 0x0E FN+DELETE -
489 0x1013 0x12 FN+PGDOWN -
534 In addition to the EV_KEY events, thinkpad-acpi may also issue EV_SW
543 ------------------------------
574 0x4010 Docked into hotplug port replicator (non-ACPI dock)
575 0x4011 Undocked from hotplug port replicator (non-ACPI dock)
621 ---------
633 so it is kept across reboots and power-off.
647 disabled through the "bluetooth_enable" thinkpad-acpi device
652 - 0: disables Bluetooth / Bluetooth is disabled
653 - 1: enables Bluetooth / Bluetooth is enabled.
655 Note: this interface has been superseded by the generic rfkill
660 Documentation/driver-api/rfkill.rst for details.
663 Video output control -- /proc/acpi/ibm/video
664 --------------------------------------------
666 This feature allows control over the devices used for video output -
669 echo lcd_enable > /proc/acpi/ibm/video
670 echo lcd_disable > /proc/acpi/ibm/video
671 echo crt_enable > /proc/acpi/ibm/video
672 echo crt_disable > /proc/acpi/ibm/video
673 echo dvi_enable > /proc/acpi/ibm/video
674 echo dvi_disable > /proc/acpi/ibm/video
675 echo auto_enable > /proc/acpi/ibm/video
676 echo auto_disable > /proc/acpi/ibm/video
677 echo expand_toggle > /proc/acpi/ibm/video
678 echo video_switch > /proc/acpi/ibm/video
685 Each video output device can be enabled or disabled individually.
686 Reading /proc/acpi/ibm/video shows the status of each device.
688 Automatic video switching can be enabled or disabled. When automatic
689 video switching is enabled, certain events (e.g. opening the lid,
690 docking or undocking) cause the video output device to change
692 and, on the X40, video corruption. By disabling automatic switching,
693 the flickering or video corruption can be avoided.
695 The video_switch command cycles through the available video outputs
696 (it simulates the behavior of Fn-F7).
698 Video expansion can be toggled through this feature. This controls
701 video expansion status cannot be determined through this feature.
704 chips) the X driver configures the video card in a way which prevents
705 Fn-F7 from working. This also disables the video output switching
707 Fn-F7. Video switching on the console should still work.
713 ------------------
722 The ThinkLight status can be read and set through the procfs interface. A
732 The ThinkLight sysfs interface is documented by the LED class
733 documentation, in Documentation/leds/leds-class.rst. The ThinkLight LED name
737 cannot be read or if it is unknown, thinkpad-acpi will report it as "off".
742 -----------------
762 - 0 - Related to "Volume down" key press
763 - 1 - Related to "Volume up" key press
764 - 2 - Related to "Mute on" key press
765 - 3 - Related to "Access IBM" key press
766 - 4 - Related to "LCD brightness up" key press
767 - 5 - Related to "LCD brightness down" key press
768 - 11 - Related to "toggle screen expansion" key press/function
769 - 12 - Related to "ThinkLight on"
770 - 13 - Related to "ThinkLight off"
771 - 14 - Related to "ThinkLight" key press (toggle ThinkLight)
773 The cmos command interface is prone to firmware split-brain problems, as
779 -----------
795 Unrestricted access to all LEDs requires that thinkpad-acpi be
801 visible to userspace. They are used by the snd-hda-intel audio driver.
816 - 0 - power
817 - 1 - battery (orange)
818 - 2 - battery (green)
819 - 3 - UltraBase/dock
820 - 4 - UltraBay
821 - 5 - UltraBase battery slot
822 - 6 - (unknown)
823 - 7 - standby
824 - 8 - dock status 1
825 - 9 - dock status 2
826 - 10, 11 - (unknown)
827 - 12 - thinkvantage
828 - 13, 14, 15 - (unknown)
835 The ThinkPad LED sysfs interface is described in detail by the LED class
836 documentation, in Documentation/leds/leds-class.rst.
846 indicators cannot be read due to an error, thinkpad-acpi will report it as
859 made available through the sysfs interface. If you have a dock and you
862 a report to ibm-acpi-devel@lists.sourceforge.net is appreciated.
865 ACPI sounds -- /proc/acpi/ibm/beep
866 ----------------------------------
872 The commands are non-negative integer numbers::
880 - 0 - stop a sound in progress (but use 17 to stop 16)
881 - 2 - two beeps, pause, third beep ("low battery")
882 - 3 - single beep
883 - 4 - high, followed by low-pitched beep ("unable")
884 - 5 - single beep
885 - 6 - very high, followed by high-pitched beep ("AC/DC")
886 - 7 - high-pitched beep
887 - 9 - three short beeps
888 - 10 - very long beep
889 - 12 - low-pitched beep
890 - 15 - three high-pitched beeps repeating constantly, stop with 0
891 - 16 - one medium-pitched beep repeating constantly, stop with 17
892 - 17 - stop 16
896 -------------------
910 42 42 45 41 36 -128 33 -128
915 48 48 36 52 38 -128 31 -128 48 52 48 -128 -128 -128 -128 -128
918 system-board model (and thus, on ThinkPad model).
925 - 1: CPU
926 - 2: (depends on model)
927 - 3: (depends on model)
928 - 4: GPU
929 - 5: Main battery: main sensor
930 - 6: Bay battery: main sensor
931 - 7: Main battery: secondary sensor
932 - 8: Bay battery: secondary sensor
933 - 9-15: (depends on model)
937 - 2: Mini-PCI
938 - 3: Internal HDD
943 - 2: System board, left side (near PCMCIA slot), reported as HDAPS temp
944 - 3: PCMCIA slot
945 - 9: MCH (northbridge) to DRAM Bus
946 - 10: Clock-generator, mini-pci card and ICH (southbridge), under Mini-PCI
948 - 11: Power regulator, underside of system board, below F2 key
953 - 1: CPU
954 - 2: Main Battery: main sensor
955 - 3: Power Converter
956 - 4: Bay Battery: main sensor
957 - 5: MCH (northbridge)
958 - 6: PCMCIA/ambient
959 - 7: Main Battery: secondary sensor
960 - 8: Bay Battery: secondary sensor
966 Readings from sensors that are not available return -128.
976 thinkpad-acpi thermal sensors are reported through the hwmon
981 -----------------------------------------------
991 - make sure the battery is fully charged
992 - make sure the fan is running
993 - use above mentioned tool to read out the EC
1000 embedded controller registers - e.g. make sure nothing else changes
1008 ----------------------
1018 on or off by this interface, it just controls the backlight brightness
1034 The driver tries to select which interface to use from a table of
1041 standard ACPI interface, it is best to use it instead of this direct
1042 ThinkPad-specific interface. The driver will disable its native
1043 backlight brightness control interface if it detects that the standard
1044 ACPI interface is available in the ThinkPad.
1046 If you want to use the thinkpad-acpi backlight brightness control
1047 instead of the generic ACPI video backlight brightness control for some
1054 interface is also available.
1068 The interface is implemented through the backlight sysfs class, which is
1091 because thinkpad-acpi cannot really turn the backlight
1099 Whatever you do, do NOT ever call thinkpad-acpi backlight-level change
1100 interface and the ACPI-based backlight level change interface
1101 (available on newer BIOSes, and driven by the Linux ACPI video driver)
1108 --------------------------------------
1114 NOTE: by default, the volume control interface operates in read-only
1115 mode, as it is supposed to be used for on-screen-display purposes.
1122 the desktop environment to just provide on-screen-display feedback.
1130 ThinkPads have a built-in amplifier and muting circuit that drives the
1147 This is a very superior design when compared to the cheap software-only
1148 mute-toggle solution found on normal consumer laptops: you can be
1152 The IBM ThinkPads, and the earlier Lenovo ThinkPads have variable-gain
1163 normal key presses to the operating system (thinkpad-acpi is not
1167 The ThinkPad-ACPI volume control
1171 ALSA interface.
1173 The legacy procfs interface allows one to read the current state,
1188 whether your thinkpad has volume control or mute-only control:
1193 please report this to ibm-acpi-devel@lists.sourceforge.net, so that we
1203 ibm-acpi-devel@lists.sourceforge.net.
1210 ---------------------------------------------------------
1221 must be given to thinkpad-acpi.
1235 Most ThinkPad fans work in "levels" at the firmware interface. Level 0
1243 There is also a "full-speed" level, also known as "disengaged" level.
1244 In this level, the EC disables the speed-locked closed-loop fan control,
1250 commands. The full-speed level may take up to two minutes to ramp up to
1252 while the EC is transitioning to the full-speed level.
1272 through thinkpad-acpi.
1274 The thinkpad-acpi kernel driver can be programmed to revert the fan
1286 commands, or the hwmon fan control sysfs interface.
1304 "full-speed" (without the quotes). Not all ThinkPads support the "auto"
1305 and "full-speed" levels. The driver accepts "disengaged" as an alias for
1306 "full-speed", and reports it as "disengaged" for backwards
1319 is incomplete, and not available through the sysfs interface.
1330 The sysfs interface follows the hwmon subsystem guidelines for the most
1335 is out-of-bounds, and EPERM if it is forbidden. They may also return
1342 - 0: PWM offline (fan is set to full-speed mode)
1343 - 1: Manual PWM control (use pwm1 to set fan level)
1344 - 2: Hardware PWM control (EC "auto" mode)
1345 - 3: reserved (Software PWM control, not implemented yet)
1349 mode is unsupported, it will return -EINVAL.
1352 Fan level, scaled from the firmware values of 0-7 to the hwmon
1353 scale of 0-255. 0 means fan stopped, 255 means highest normal
1382 ---
1390 This feature shows the presence and current state of the built-in
1394 so it is kept across reboots and power-off.
1402 If the W-WAN card is installed, the following commands can be used::
1410 If the W-WAN card is installed, it can be enabled /
1411 disabled through the "wwan_enable" thinkpad-acpi device
1415 - 0: disables WWAN card / WWAN card is disabled
1416 - 1: enables WWAN card / WWAN card is enabled.
1418 Note: this interface has been superseded by the generic rfkill
1423 Documentation/driver-api/rfkill.rst for details.
1427 ------------------
1449 -------------------
1459 The property is read-only. If the platform doesn't have support the sysfs
1463 -----------------
1479 Documentation/driver-api/rfkill.rst for details.
1483 -------------------------
1487 This feature is used to set keyboard language to ECFW using ASL interface.
1500 fr(French), fr-ch(French(Switzerland)), hu(Hungarian), it(Italy), jp (Japan),
1505 -----------------
1510 type. This interface will be used by userspace to get the antenna type
1518 - type a
1519 - type b
1521 The property is read-only. If the platform doesn't have support the sysfs
1525 ------
1529 Some newer Thinkpads have a feature called MAC Address Pass-through. This
1532 network. This property enables user-space to easily determine the MAC address
1541 This property is read-only.
1544 -----------------
1552 - 0 = Home mode
1553 - 1 = Web-browser mode
1554 - 2 = Web-conference mode
1555 - 3 = Function mode
1556 - 4 = Layflat mode
1563 ----------------------
1577 Documentation/ABI/testing/sysfs-class-power.
1580 ------------------------------------
1586 echo lcd_disable,crt_enable > /proc/acpi/ibm/video
1588 Commands can also be specified when loading the thinkpad-acpi module,
1591 modprobe thinkpad_acpi hotkey=enable,0xffff video=auto_disable
1595 -------------------------
1614 0x0008 HKEY event interface, hotkeys
1629 -----------------------
1631 If thinkpad-acpi refuses to detect your ThinkPad, you can try to specify
1633 not, please contact ibm-acpi-devel@lists.sourceforge.net with a report.
1636 Sysfs interface changelog
1651 and the hwmon class for libsensors4 (lm-sensors 3)
1655 0x020100: Marker for thinkpad-acpi with hot key NVRAM polling
1660 0x020101: Marker for thinkpad-acpi with hot key NVRAM polling
1684 0x020700: Support for mute-only mixers.
1685 Volume control in read-only mode by default.