From 8f07583e57222c2c458ee2ce7925d311726b13fd Mon Sep 17 00:00:00 2001 From: Mattias Andrée Date: Tue, 11 Mar 2014 05:34:13 +0100 Subject: add backlight support through sysfs MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Mattias Andrée --- src/backlight.py | 97 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 97 insertions(+) create mode 100644 src/backlight.py (limited to 'src/backlight.py') diff --git a/src/backlight.py b/src/backlight.py new file mode 100644 index 0000000..54090ae --- /dev/null +++ b/src/backlight.py @@ -0,0 +1,97 @@ +#!/usr/bin/env python3 + +# Copyright © 2014 Mattias Andrée (maandree@member.fsf.org) +# +# This program is free software: you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation, either version 3 of the License, or +# (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU Affero General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program. If not, see . + +import os +import sys +from subprocess import Popen + + +def list_backlights(): + ''' + List backlight controllers + + @return list List of all backlight controllers on the system + ''' + return os.listdir('/sys/class/backlight') + + +class Backlight: + ''' + Backlight controller + + @variable maxmimum:int The maximum value, after minimum value modification + ''' + + def __init__(self, controller, adjbacklight = True, minimum = 0): + ''' + Constructor + + @param controller:str The name or path of the backlight controller + @param adjbacklight:bool Whether to the `adjbacklight` commmand when adjusting + @param minimum:int Artificially raise the minimum from zero to avoid the + backlight from getting stuck at zero when reached, + as happens on some controllers + ''' + self.__controller = controller + if '/' not in controller: + self.__controller = '/sys/class/backlight/%s' % controller + + with open('%s/max_brightness' % self.__controller, 'rb') as file: + self.maximum = int(file.read().decode('utf-8', 'replace')[:-1]) - minimum + + self.__minimum = minimum + self.__adjbacklight = adjbacklight + + + @property + def actual(self): + ''' + Get the actual brightness + + @return :int The brightness, can be below zero if the minimum value was modified at contruction + ''' + with open('%s/actual_brightness' % self.__controller, 'rb') as file: + return int(file.read().decode('utf-8', 'replace')[:-1]) - self.__minimum + + + @property + def brightness(self): + ''' + Get the brightness + + @return :int The brightness, can be below zero if the minimum value was modified at contruction + ''' + with open('%s/brightness' % self.__controller, 'rb') as file: + return int(file.read().decode('utf-8', 'replace')[:-1]) - self.__minimum + + + @brightness.setter + def brightness(self, value): + ''' + Set the brightness + + @param value:int The brightness, inside the range [0, `self.maxmimum`], can be below zero, + but should not be below zero, if the minimum value was modified at contruction + ''' + if not self.__adjbacklight: + with open('%s/brightness' % self.__controller, 'wb') as file: + file.write((str(value + self.__minimum) + '\n').encode('utf-8')) + file.flush() + else: + cmd = ['adjbacklight', self.__controller, '--set', str(value + self.__minimum)] + Popen(cmd, stdout = sys.stdout, stderr = sys.stderr).wait() + -- cgit v1.2.3-70-g09d2