chore: update VERSION, CHANGELOG and install/restore scripts

Author: th3cavalry

VERSION

@@ -1 +1 @@
-4.0.2
+4.0.3

docs/CHANGELOG.md

@@ -5,6 +5,22 @@ All notable changes to the GZ302 Linux Setup project will be documented in this
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [4.0.3] - 2026-01-31
+
+### Fixed
+
+- **RGB Memory/Restore on Resume**: Fixed keyboard RGB not restoring after sleep/suspend
+  - Increased USB device reinitialization delay from 0.5s to 1s for reliable hidraw access
+  - Changed RGB restore from background to synchronous execution in sleep hook
+  - Added logging to system journal for debugging (`journalctl -t gz302-reset`)
+  - RGB restore script now provides verbose output for both keyboard and lightbar
+  - Fixed silent failures by removing blanket stderr suppression in restore script
+
+### Changed
+
+- Updated `gz302-reset.sh` sleep hook to v2.1 with improved timing and logging
+- RGB restore script now logs success/failure status for troubleshooting
+
 ## [4.0.2] - 2025-01-08
 
 ### Fixed

gz302-main.sh

@@ -2,7 +2,7 @@
 
 # ==============================================================================
 # Author: th3cavalry using Copilot
-# Version: 4.0.2
+# Version: 4.0.3
 #
 # Supported Models:
 # - GZ302EA-XS99 (128GB RAM)

scripts/gz302-rgb-install.sh

@@ -360,10 +360,12 @@ install_suspend_hook() {
 #!/bin/bash
 # GZ302 Resume Reset Hook (Optimized)
 # Resets keyboard and lightbar USB devices on resume to fix touchpad and RGB
-# v2.0 - Single loop, faster sleeps to minimize resume delay
+# v2.1 - Improved RGB restore timing and logging
 
 case "$1" in
     post)
+        logger -t gz302-reset "Resume detected, resetting USB devices..."
+        
         # Single pass through USB devices - reset both keyboard and lightbar
         # Product IDs: 1a30 = Keyboard/Touchpad, 18c6 = Lightbar
         for dev in /sys/bus/usb/devices/*; do
@@ -377,24 +379,30 @@ case "$1" in
             case "$pid" in
                 1a30)
                     # Keyboard/Touchpad - fixes touchpad not working after sleep
+                    logger -t gz302-reset "Resetting keyboard/touchpad at $dev"
                     echo 0 > "$dev/authorized"
                     sleep 0.1
                     echo 1 > "$dev/authorized"
                     ;;
                 18c6)
                     # Lightbar - ensures RGB commands work
+                    logger -t gz302-reset "Resetting lightbar at $dev"
                     echo 0 > "$dev/authorized"
                     sleep 0.1
                     echo 1 > "$dev/authorized"
                     ;;
             esac
         done
         
-        # Restore RGB settings in background (non-blocking)
-        {
-            sleep 0.5
-            systemctl restart gz302-rgb-restore.service 2>/dev/null
-        } &
+        # Wait for USB devices to fully reinitialize, then restore RGB
+        # Run synchronously to ensure it completes before user interaction
+        sleep 1
+        logger -t gz302-reset "Restoring RGB settings..."
+        if /usr/local/bin/gz302-rgb-restore 2>&1 | logger -t gz302-rgb-restore; then
+            logger -t gz302-reset "RGB restore completed"
+        else
+            logger -t gz302-reset "RGB restore failed"
+        fi
         ;;
 esac
 exit 0

scripts/gz302-rgb-restore.sh

@@ -90,7 +90,12 @@ if [[ -f "$KEYBOARD_CONFIG" ]]; then
         # KEYBOARD_COMMAND contains the full command string (e.g. "static ff0000")
         # Split into array to avoid eval
         read -r -a CMD_ARGS <<< "$KEYBOARD_COMMAND"
-        "$RGB_BIN" "${CMD_ARGS[@]}" 2>/dev/null || true
+        echo "Restoring keyboard RGB: ${CMD_ARGS[*]}"
+        if "$RGB_BIN" "${CMD_ARGS[@]}" 2>&1; then
+            echo "Keyboard RGB restored successfully"
+        else
+            echo "Warning: Keyboard RGB restore failed" >&2
+        fi
 
     # Handle legacy format (COMMAND + ARG1, ARG2, etc.)
     elif [[ -n "${COMMAND:-}" && -n "${ARGC:-}" ]] && [[ -x "$RGB_BIN" ]]; then
@@ -102,8 +107,15 @@ if [[ -f "$KEYBOARD_CONFIG" ]]; then
                 args+=("$val")
             fi
         done
-        "$RGB_BIN" "${args[@]}" 2>/dev/null || true
+        echo "Restoring keyboard RGB (legacy): ${args[*]}"
+        if "$RGB_BIN" "${args[@]}" 2>&1; then
+            echo "Keyboard RGB restored successfully"
+        else
+            echo "Warning: Keyboard RGB restore failed" >&2
+        fi
     fi
+else
+    echo "No keyboard RGB config found at $KEYBOARD_CONFIG"
 fi
 
 # Restore rear window/lightbar RGB settings
@@ -112,16 +124,20 @@ if [[ -f "$WINDOW_CONFIG" ]]; then
     WINDOW_COLOR=$(get_config_var "$WINDOW_CONFIG" "WINDOW_COLOR")
 
     if [[ -n "${WINDOW_BRIGHTNESS:-}" ]] && [[ -x "$WINDOW_BIN" ]]; then
-        "$WINDOW_BIN" --lightbar "$WINDOW_BRIGHTNESS" 2>/dev/null || true
+        echo "Restoring lightbar brightness: $WINDOW_BRIGHTNESS"
+        "$WINDOW_BIN" --lightbar "$WINDOW_BRIGHTNESS" 2>&1 || echo "Warning: Lightbar brightness restore failed" >&2
     fi
 
     # Restore color if present (format: R,G,B)
     if [[ -n "${WINDOW_COLOR:-}" ]] && [[ -x "$WINDOW_BIN" ]]; then
         IFS=',' read -r R G B <<< "$WINDOW_COLOR"
         if [[ -n "${R:-}" && -n "${G:-}" && -n "${B:-}" ]]; then
-            "$WINDOW_BIN" --color "$R" "$G" "$B" 2>/dev/null || true
+            echo "Restoring lightbar color: R=$R G=$G B=$B"
+            "$WINDOW_BIN" --color "$R" "$G" "$B" 2>&1 || echo "Warning: Lightbar color restore failed" >&2
         fi
     fi
+else
+    echo "No lightbar RGB config found at $WINDOW_CONFIG"
 fi
 
 exit 0