Documentation/laptops/lg-laptop.rst

   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.