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