rpi-backlight 1.7.1

A Python module for controlling power and brightness of the official Raspberry Pi 7" touch display.

A Python module for controlling power and brightness of the official Raspberry Pi 7” touch display.

Features

• Change the display brightness smoothly or abrupt

• Set the display power on or off

• Get the current brightness

• Get the maximum brightness

• Get the display power state (on/off)

• Command line interface

• Graphical user interface

Requirements

• A Raspberry Pi including a correctly assembled 7” touch display v1.1 or higher running a Linux-based OS

• Python 2 or 3

• Optional: pygobject for the GUI, is likely to be already installed on a recent Raspbian

Installation

• Install from PyPI using:

  pip install rpi_backlight

• or clone this repository and install by:

  git clone https://github.com/linusg/rpi-backlight.git
  cd rpi-backlight
  sudo python3 setup.py install

Note: You may need to edit the backlight rules file in order to run the code:

sudo nano /etc/udev/rules.d/backlight-permissions.rules

Insert the line:

SUBSYSTEM=="backlight",RUN+="/bin/chmod 666 /sys/class/backlight/%k/brightness /sys/class/backlight/%k/bl_power"

Usage

API

Example in a Python shell:

>>> import rpi_backlight as bl
>>> bl.set_brightness(255)
>>> bl.set_brightness(20, smooth=True, duration=3)
>>> bl.get_max_brightness()
255
>>> bl.get_actual_brightness()
20
>>> bl.get_power()
True
>>> bl.set_power(False)

NOTE: Code using set_ functions of this library has to be run as root, e.g. sudo python file.py , if the permissions for changing the backlight were not changed as described in the installation section!

CLI

Open a terminal and run rpi-backlight as root:

$ rpi-backlight -b 255
$ rpi-backlight -b 20 -s -d 3
$ rpi-backlight --max-brightness
255
$ rpi-backlight --actual-brightness
20
$ rpi-backlight --power
True
$ rpi-backlight --off

GUI

Open a terminal and run rpi-backlight-gui as root.

Todo

Yay, this list is currently empty! Feel free to add ideas here.

External Links

• Travis CI: Build tests

• Landscape.io: Code health tests

• readthedocs.org: Documentation

License

The source code and all other files in this repository are licensed under the MIT license, so you can easily use it in your own projects.