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