Merge tag 'sound-fix-5.1-rc1' of git://git.kernel.org/pub/scm/linux/kernel/git/tiwai...
[sfrench/cifs-2.6.git] / Documentation / laptops / lg-laptop.rst
1 .. SPDX-License-Identifier: GPL-2.0+
2
3 LG Gram laptop extra features
4 =============================
5
6 By Matan Ziv-Av <matan@svgalib.org>
7
8
9 Hotkeys
10 -------
11
12 The following FN keys are ignored by the kernel without this driver:
13
14 - FN-F1 (LG control panel)   - Generates F15
15 - FN-F5 (Touchpad toggle)    - Generates F13
16 - FN-F6 (Airplane mode)      - Generates RFKILL
17 - FN-F8 (Keyboard backlight) - Generates F16.
18   This key also changes keyboard backlight mode.
19 - FN-F9 (Reader mode)        - Generates F14
20
21 The rest of the FN keys work without a need for a special driver.
22
23
24 Reader mode
25 -----------
26
27 Writing 0/1 to /sys/devices/platform/lg-laptop/reader_mode disables/enables
28 reader mode. In this mode the screen colors change (blue color reduced),
29 and the reader mode indicator LED (on F9 key) turns on.
30
31
32 FN Lock
33 -------
34
35 Writing 0/1 to /sys/devices/platform/lg-laptop/fn_lock disables/enables
36 FN lock.
37
38
39 Battery care limit
40 ------------------
41
42 Writing 80/100 to /sys/devices/platform/lg-laptop/battery_care_limit
43 sets the maximum capacity to charge the battery. Limiting the charge
44 reduces battery capacity loss over time.
45
46 This value is reset to 100 when the kernel boots.
47
48
49 Fan mode
50 --------
51
52 Writing 1/0 to /sys/devices/platform/lg-laptop/fan_mode disables/enables
53 the fan silent mode.
54
55
56 USB charge
57 ----------
58
59 Writing 0/1 to /sys/devices/platform/lg-laptop/usb_charge disables/enables
60 charging another device from the USB port while the device is turned off.
61
62 This value is reset to 0 when the kernel boots.
63
64
65 LEDs
66 ~~~~
67
68 The are two LED devices supported by the driver:
69
70 Keyboard backlight
71 ------------------
72
73 A led device named kbd_led controls the keyboard backlight. There are three
74 lighting level: off (0), low (127) and high (255).
75
76 The keyboard backlight is also controlled by the key combination FN-F8
77 which cycles through those levels.
78
79
80 Touchpad indicator LED
81 ----------------------
82
83 On the F5 key. Controlled by led device names tpad_led.