Version 1.3 vorgesehen für die Packetierung.

kbdLED

@@ -1,39 +1,65 @@
 #!/usr/bin/env python3
 # -*- coding: utf-8 -*-
+from enum import Enum, StrEnum
 
 # reads and writes RGB and brightness data for led background color of Clevo NL51 Laptops
 # ensure to compile drivers before ! read: https://wiki.siningsoft.de/doku.php?id=terra:1500p
 # Kernelmodul: tuxedo_keyboard
 
-# ToDo: add argument and function for switching color on commandline
-# ToDo: add argument and functions for switching brightness on commandline
-
 # 2026-02-02 - devnull - initial
 # 2026-02-03 - devnull - added Brightness restore
 # 2026-02-04 - devnull - JSON statefile
 # 2026-02-11 - devnull - created class
 # 2026-02-18 - devnull - added logging
+# 2026-02-19 - devnull - added commandline arguments for changing
+# 2026-02-21 - devnull - color and brightness switching on commandline
+# 2026-02-21 - devnull - enable/disable LED via Commandline
 
-ver="1.1"
+ver="1.4"
 
 import sys
 import argparse
 import json
 import logging
 
+# start with a logger object
+log = logging.getLogger(__name__)
+
+class kbdLED_class():
+
+    # 2026-02-11 - devnull  - added class definition
+    # 2026-02-19 - devnull  - bugfixed write procedure
+    #                       - added hard coded colors
 
-class kbdLED_class:
+    class colors(StrEnum):
+        GREEN = "0 255 0"
+        WHITE = "255 255 255"
+        RED = "255 0 0"
+        BLUE = "0 0 255"
+        YELLOW = "255 255 0"
+        PURPLE = "255 0 255"
+        LIGHTBLUE = "0 0 255"
 
-    # 2026-02-11 - devnull - Einführung einer Klassendefinition
+        # d_GREEN = {"R":0,"G": 255,"B": 0}
+        # d_WHITE = {"R":255,"G": 255,"B": 255}
+        # d_RED = {"R":255,"G": 0,"B": 0}
+        # d_BLUE = {"R":0,"G": 0,"B": 255}
+        # d_YELLOW = {"R":255,"G": 255,"B": 0}
+        # d_PURPLE = {"R":255,"G": 0,"B": 255}
+        # d_LIGHTBLUE = {"R":0,"G": 255,"B": 255}
 
     # diese Versionsnummer wird getrennt vom Programmcode geführt, da es sich getrennt entwickeln wird
     __version__ = 1.1
     config = dict()
 
     # Objekt erzeugen
-    def __init__(self, cmd, log, kbd_state_fp='/var/lib/kbdLED.state.json',
-                            sysfs_color_fp='/sys/devices/platform/tuxedo_keyboard/leds/rgb:kbd_backlight/multi_intensity',
-                            sysfs_bri_fp='/sys/devices/platform/tuxedo_keyboard/leds/rgb:kbd_backlight/brightness'):
+    def __init__(self, cmd,
+                        log,
+                        INcolor=colors.WHITE,
+                        INbrightness=255,
+                        kbd_state_fp='/var/lib/kbdLED.state.json',
+                        sysfs_color_fp='/sys/devices/platform/tuxedo_keyboard/leds/rgb:kbd_backlight/multi_intensity',
+                        sysfs_bri_fp='/sys/devices/platform/tuxedo_keyboard/leds/rgb:kbd_backlight/brightness'):
 
         self.log = log
         self.config = {"sysfs" :
@@ -45,18 +71,31 @@ class kbdLED_class:
 
         self.log.debug(str(self.config))
 
+        # startup and restore states
         if cmd=="start":
             self.readStateFile(self.config['state'])
             self.log.debug(str(self.config))
             self.writeColor()
             self.writeBrightness()
 
+        # shutdown system and save last states
         elif cmd=="stop":
             self.readColor()
             self.readBrightness()
             self.writeStateFile(self.config['state'])
 
+        # set the color from commandline
+        elif cmd=="color":
+            self.log.debug("INcolor=" + str(INcolor))
+            self.color2dict2config(INcolor)
 
+            self.log.debug("__init__(cmd=color).config['color']=" + str(self.config['color']))
+            self.writeColor()
+
+        # set the brightness from commandline
+        elif cmd=="brightness":
+            self.config['Brightness']= int(INbrightness)
+            self.writeBrightness()
 
     def readStateFile(self,kbd_state_fp):
 
@@ -85,21 +124,23 @@ class kbdLED_class:
             self.log.error("Verzeichnis oder Datei nicht gefunden")
 
     # color String nach Config Dict
-    def color2dict(self,color_string):
+    def color2dict2config(self, color_string):
         ca=color_string.split(" ")
+        self.log.debug("color_string=" + color_string)
+        self.log.debug("after splitting=" + str(ca))
         self.config['color'] = {"R": int(ca[0]),
                        "G": int(ca[1]),
                        "B": int(ca[2])}
 
     # color Confi Dict nach String
-    def dict2color(self):
+    def config2dict2color(self):
         return str(self.config['color']['R']) + " " + str(self.config['color']['G']) + " " + str(self.config['color']['B'])
 
     # reads the color Values from sysfs
     def readColor(self):
         try:
             with open(self.config['sysfs']['color']) as fh:
-                self.color2dict(fh.read())
+                self.color2dict2config(fh.read())
 
         except FileNotFoundError:
             self.log.error("fehler beim Öffnen der Sysfs Datei " + self.config['sysfs']['color'])
@@ -115,7 +156,7 @@ class kbdLED_class:
             #with open(self.config['sysfs']['color']) as fh:
             #    fh.write(self.dict2color())
             fh = open(self.config['sysfs']['color'], 'w')
-            fh.write(self.dict2color())
+            fh.write(self.config2dict2color())
             fh.close()
 
         except FileNotFoundError:
@@ -161,30 +202,38 @@ class kbdLED_class:
 if __name__ == '__main__':
 
     #https: // argparse.readthedocs.io
+    # internal note: um mehrere sich ausschließende Argumente zuzulassen, muss add_mutually_exclusive_groups verwenden
     parser = argparse.ArgumentParser(
                     prog='T1500_KeyboardLED',
                     description='saves and restore LED Colors',
                     epilog='GPL')
-    output = parser.add_mutually_exclusive_group(required=False)
+
+    group_common = parser.add_argument_group("common")
+    output = group_common.add_mutually_exclusive_group(required=False)
     output.add_argument('--verbose', action='store_true', help='extended logging', required=False)
     output.add_argument('--debug', action='store_true', help='debug output', required=False)
 
-    startstop = parser.add_mutually_exclusive_group()
+    group_function = parser.add_argument_group("function")
+    startstop = group_function.add_mutually_exclusive_group()
+    startstop.add_argument('--on', action='store_true', help='generally turn LED Backlight on')
+    startstop.add_argument('--off', action='store_true', help='generally turn LED Backlight off')
     startstop.add_argument('--start', action='store_true', help='will be used for system starts')
     startstop.add_argument('--stop', action='store_true', help='will be used for system shutdowns')
+    startstop.add_argument('-c', '--color', choices=['white','blue','lightblue','green','red','purple','yellow'], help='keyboard color out of fixed feature set', required=False)
+    startstop.add_argument('-b', '--brightness', type=int, help='keybpoard brightness between 0..255', required=False)
     startstop.add_argument('--version', action='version', version='%(prog)s ' + ver, default='d')
 
     args = parser.parse_args()
 
     if args.verbose:
-        logging.basicConfig(level=logging.INFO)
+        log.setLevel(logging.INFO)
+
     elif args.debug:
-        logging.basicConfig(level=logging.DEBUG)
+        log.setLevel(logging.DEBUG)
     else:
-        logging.basicConfig(level=logging.ERROR)
+        log.setLevel(logging.ERROR)
 
     logging.basicConfig(format='%(asctime)s %(message)s')
-    log = logging.getLogger(__name__)
 
     if args.start:
         print("Keyboard: read and set Color and Brightness")
@@ -196,6 +245,32 @@ if __name__ == '__main__':
         log.debug("System stop")
         kL = kbdLED_class("stop", log)
 
+    elif args.color:
+        print("Keyboard: set color " + args.color)
+        log.debug("resolveed Color=" + getattr(kbdLED_class.colors,args.color.upper()))
+
+        try:
+            log.debug("setup keyboard color " + args.color)
+            kL = kbdLED_class("color", log, INcolor=getattr(kbdLED_class.colors, args.color.upper()))
+        except AttributeError:
+            log.error("color does not exists " + args.color)
+            parser.print_help()
+            sys.exit((1))
+
+    elif args.brightness:
+        print("Keyboard: set brightness " + str(args.brightness))
+
+        log.debug("setup keyboard brightness " + str(args.brightness))
+        kL = kbdLED_class("brightness",log, INbrightness=args.brightness)
+
+    elif args.on:
+        print("Keyboard: enable Backlight LED")
+        kL = kbdLED_class("brightness",log, INbrightness=255)
+
+    elif args.off:
+        print("Keyboard: disable Backlight LED")
+        kL = kbdLED_class("brightness", log, INbrightness=0)
+
     else:
         parser.print_help()
         sys.exit((10))

systemd/kbdLED.service

@@ -3,10 +3,10 @@ Description=Terra 1500 / Clevo NL51NU Keyboard Color and Brightness restore
 
 [Service]
 Type=oneshot
-ExecStart=/opt/kbdLED/kbdLED --start
+ExecStart=/usr/bin/kbdLED/kbdLED --start
 RemainAfterExit=true
-ExecStop=/opt/kbdLED/kbdLED --stop
+ExecStop=/usr/bin/kbdLED/kbdLED --stop
 StandardOutput=journal
 
 [Install]
-WantedBy=multi-user.target
+WantedBy=multi-user.target