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