Add screen idle timeout and power button screen toggle

New Python screen monitor uses Allwinner /dev/disp ioctls to turn off
the display after 15s of no input and toggle it with a short power
button press. Launched by the wrapper alongside sdlamp2.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

tools/rg35xx-screen-monitor.py

@@ -0,0 +1,138 @@
+#!/usr/bin/env python3
+"""
+Screen idle timeout and power button toggle for RG35XX Plus.
+
+Monitors /dev/input/event{0,1,2} for activity. Turns off the screen
+(via Allwinner /dev/disp SET_BRIGHTNESS ioctl) after 15s of no input.
+Any button press wakes the screen. A short power button press (<2s)
+toggles the screen on/off.
+
+Launched by rg35xx-wrapper.sh alongside sdlamp2. Killed on cleanup.
+"""
+import fcntl
+import os
+import signal
+import struct
+import sys
+import time
+
+IDLE_TIMEOUT = 15  # seconds
+POWER_HOLD_THRESHOLD = 2.0  # seconds — short press if released before this
+
+# Allwinner /dev/disp ioctl commands
+DISP_GET_BRIGHTNESS = 0x103
+DISP_SET_BRIGHTNESS = 0x102
+
+# Input event constants
+EV_KEY = 1
+KEY_POWER = 116
+
+# struct input_event on aarch64: struct timeval (2x long=8 bytes each) + __u16 type + __u16 code + __s32 value
+INPUT_EVENT_FORMAT = "@llHHi"
+INPUT_EVENT_SIZE = struct.calcsize(INPUT_EVENT_FORMAT)
+
+EVENT_DEVICES = ["/dev/input/event0", "/dev/input/event1", "/dev/input/event2"]
+
+
+def disp_ioctl(fd, cmd, screen=0, value=0):
+    # Allwinner disp ioctls take an array of 4 unsigned longs as arg
+    args = struct.pack("@4L", screen, value, 0, 0)
+    result = fcntl.ioctl(fd, cmd, args)
+    return struct.unpack("@4L", result)[0]
+
+
+def get_brightness(disp_fd):
+    return disp_ioctl(disp_fd, DISP_GET_BRIGHTNESS)
+
+
+def set_brightness(disp_fd, value):
+    disp_ioctl(disp_fd, DISP_SET_BRIGHTNESS, value=value)
+
+
+def main():
+    disp_fd = os.open("/dev/disp", os.O_RDWR)
+    original_brightness = get_brightness(disp_fd)
+    if original_brightness == 0:
+        original_brightness = 50  # sensible default if already off
+
+    screen_on = True
+    power_press_time = None
+
+    # Restore brightness on exit so goodbye.png is visible during shutdown
+    def restore_and_exit(signum, frame):
+        if not screen_on:
+            set_brightness(disp_fd, original_brightness)
+        os.close(disp_fd)
+        sys.exit(0)
+
+    signal.signal(signal.SIGTERM, restore_and_exit)
+    signal.signal(signal.SIGINT, restore_and_exit)
+
+    # Open input devices (non-blocking)
+    event_fds = []
+    for path in EVENT_DEVICES:
+        try:
+            fd = os.open(path, os.O_RDONLY | os.O_NONBLOCK)
+            event_fds.append(fd)
+        except OSError as e:
+            print(f"screen-monitor: cannot open {path}: {e}", file=sys.stderr)
+
+    if not event_fds:
+        print("screen-monitor: no input devices available, exiting", file=sys.stderr)
+        os.close(disp_fd)
+        sys.exit(1)
+
+    import select
+
+    while True:
+        readable, _, _ = select.select(event_fds, [], [], IDLE_TIMEOUT)
+
+        if not readable:
+            # Timeout — no input for IDLE_TIMEOUT seconds
+            if screen_on:
+                set_brightness(disp_fd, 0)
+                screen_on = False
+            continue
+
+        # Process input events from all readable fds
+        for fd in readable:
+            while True:
+                try:
+                    data = os.read(fd, INPUT_EVENT_SIZE)
+                except BlockingIOError:
+                    break
+                if len(data) < INPUT_EVENT_SIZE:
+                    break
+
+                _sec, _usec, ev_type, ev_code, ev_value = struct.unpack(
+                    INPUT_EVENT_FORMAT, data
+                )
+
+                if ev_type != EV_KEY:
+                    continue
+
+                # Power button handling
+                if ev_code == KEY_POWER:
+                    if ev_value == 1:  # press
+                        power_press_time = time.monotonic()
+                    elif ev_value == 0 and power_press_time is not None:  # release
+                        hold_duration = time.monotonic() - power_press_time
+                        power_press_time = None
+                        if hold_duration < POWER_HOLD_THRESHOLD:
+                            # Short press — toggle screen
+                            if screen_on:
+                                set_brightness(disp_fd, 0)
+                                screen_on = False
+                            else:
+                                set_brightness(disp_fd, original_brightness)
+                                screen_on = True
+                    continue
+
+                # Any other key press — wake screen if off
+                if ev_value == 1 and not screen_on:
+                    set_brightness(disp_fd, original_brightness)
+                    screen_on = True
+
+
+if __name__ == "__main__":
+    main()

tools/rg35xx-wrapper.sh

@@ -6,13 +6,15 @@
 # concerns that don't belong in the player binary:
 #   1. Monitor power button and trigger clean shutdown
 #   2. Display the stock firmware's shutdown screen (goodbye.png → /dev/fb0)
-#   3. Launch sdlamp2 as the main process
+#   3. Screen idle timeout (off after 15s) and power button screen toggle
+#   4. Launch sdlamp2 as the main process
 #
 # Install: copy to /mnt/vendor/bin/rg35xx-wrapper.sh
 # Config:  set CMD in dmenu_ln to point here instead of sdlamp2 directly
 
 SDLAMP2="/mnt/vendor/bin/sdlamp2"
 AUDIO_DIR="/mnt/sdcard/Music"
+SCREEN_MONITOR="/mnt/vendor/bin/rg35xx-screen-monitor.py"
 
 # --- WiFi hotspot ---
 # Deprioritized: connecting the device as a WiFi client to a shared network
@@ -45,6 +47,10 @@ monitor_power_button() {
   done
 }
 
+# --- Screen idle timeout + power button screen toggle ---
+python3 "$SCREEN_MONITOR" &
+SCREEN_MONITOR_PID=$!
+
 # --- Launch sdlamp2 ---
 # Run in background so we can capture PID for the power button monitor.
 "$SDLAMP2" "$AUDIO_DIR" &
@@ -58,7 +64,9 @@ wait "$SDLAMP2_PID"
 SDLAMP2_EXIT=$?
 
 # --- Cleanup ---
-# Kill the power button monitor if it's still running
+# Kill the screen monitor (SIGTERM restores brightness) and power button monitor.
+kill "$SCREEN_MONITOR_PID" 2>/dev/null
+wait "$SCREEN_MONITOR_PID" 2>/dev/null
 kill "$MONITOR_PID" 2>/dev/null
 
 # If this was a shutdown, call poweroff and block so the loadapp.sh restart