Welcome to the LaptopControlPanel documentation!

Note

The official Home Page of LaptopControlPanel is located at http://fabricesalvaire.github.io/LaptopControlPanel

If you are at http://readthedocs.org then you are reading the so called latest documentation.

The latest documentation LaptopControlPanel@readthedocs-badge is automatically built from the git repository after each commit.

As opposite the LaptopControlPanel Home Page is built manually and is thus less prone to errors.

Introduction

LaptopControlPanel is a Python module that provides a Graphical Control Panel for Lenovo Thinkpad Laptop and a console tool to monitor and manage the battery. Such functions are not provided by standard control panels like those of the KDE desktop.

The source code is licensed under GPL V3.

Warning

This Python module uses ACPI calls and low level hardware functions. A miss use of these tools can crash the computer.

The control panel features:

  • switch on/off network interfaces (wifi and bluetooth)
  • switch on/off Nvidia GPU using /proc/acpi/bbswitch
  • fan control using thinkpad-acpi module and /proc/acpi/ibm/fan
  • battery control through ACPI calls

The battery management tool permits:

  • to set the start and stop capacity threshold to charge the battery,
  • to switch on battery when AC power is plugged,
  • to setup a “peak shift” procedure.

Some usages of these functions are:

  • to switch off the Nvidia GPU to save battery
  • to speed-up the fan to cool the hard drive located under the left hand

The source of the ACPI calls for the battery management is unknown and comes from the repository tpacpi-bat. For reference, this discussion Laptop shock detection and harddisk protection on LKML illustrates the legal concern for such information.

The battery is managed by ACPI calls through the Low Pin Count bus and the Embedded Controller (ASL base is \_SB.PCI0.LPC.EC.HKEY). ACPI is an abstraction layer to set and get registers on the computer busses. The (acpi_call) module, which is not included in the kernel, is required to perform these calls. This module must be used carefully.

Installation

The procedure to install LaptopControlPanel is described in the Installation Manual.

Testing

See the testing section.

Table Of Contents

Next topic

1. Installation

This Page