树莓派400重启后GPIO音量控制Python脚本无法执行求助

核心需求：通过两个GPIO按钮控制树莓派音量，终端运行脚本正常，但开机自启时音量控制失效，同时同目录的GPIO关机/重启脚本自启正常。

现有代码 #

音量控制脚本（volume.py） #

import RPi.GPIO as GPIO
from subprocess import call, run
import time
import os

up = 11
down = 13

GPIO.setmode(GPIO.BOARD)
GPIO.setup(up,GPIO.IN, pull_up_down=GPIO.PUD_UP)
GPIO.setup(down,GPIO.IN, pull_up_down=GPIO.PUD_UP)

def buttonStateChanged(pin):
    mute = False
    while True:
        if not GPIO.input(up) | GPIO.input(down):
            if mute == False:
                call(["xdotool", "key", "XF86AudioMute"], shell=False)
                time.sleep(0.2)
                mute = True
                
            if mute == True:
                call(["xdotool", "key", "XF86AudioMute"], shell=False)
                time.sleep(0.2)
                mute = True
                
        if not GPIO.input(up):
            call(["xdotool", "key", "XF86AudioRaiseVolume"], shell=False)
            time.sleep(0.2)
        if not GPIO.input(down):
            call(["xdotool", "key", "XF86AudioLowerVolume"], shell=False)
            time.sleep(0.2)
        
GPIO.add_event_detect(11, GPIO.BOTH, callback=buttonStateChanged)
GPIO.add_event_detect(13, GPIO.BOTH, callback=buttonStateChanged)

while True:
    time.sleep(5)    

关机/重启脚本（reboot.py） #

import RPi.GPIO as GPIO
from subprocess import call, run
from datetime import datetime
import time

# pushbutton connected to this GPIO pin, using pin 5 also has the benefit of
# waking / powering up Raspberry Pi when button is pressed

# if button pressed for at least this long then shut down. if less then reboot.
shutdownMinSeconds = 3

# button debounce time in seconds
debounceSeconds = 0.01

GPIO.setmode(GPIO.BOARD)
GPIO.setup(5,GPIO.IN, pull_up_down=GPIO.PUD_UP)

buttonPressedTime = None

def buttonStateChanged(pin):
    global buttonPressedTime

    if not (GPIO.input(pin)):
        # button is down
        if buttonPressedTime is None:
            buttonPressedTime = datetime.now()
    else:
        # button is up
        if buttonPressedTime is not None:
            elapsed = (datetime.now() - buttonPressedTime).total_seconds()
            buttonPressedTime = None
            if elapsed >= shutdownMinSeconds:
                # button pressed for more than specified time, shutdown
                call(['shutdown', '-h', 'now'], shell=False)
            elif elapsed >= debounceSeconds:
                # button pressed for a shorter time, reboot
#                 run('vcgencmd display_power 0 2', shell = True)
#                 time.sleep(1)
#                 run('vcgencmd display_power 1 2', shell = True)
                call(['shutdown', '-r', 'now'], shell=False)
                
GPIO.add_event_detect(5, GPIO.BOTH, callback=buttonStateChanged)

while True:
    time.sleep(5)

尝试的自启方式 #

1. crontab：为关机/重启脚本设置@reboot python /Desktop/reboot.py，可正常工作；但同样方式设置音量脚本时失效。
2. /etc/rc.local：添加

   sudo python /Desktop/volume.py &
   sudo python /Desktop/hold.py &
   

   关机/重启功能正常，音量控制失效。

问题分析 #

1. 脚本逻辑bug：音量控制脚本的buttonStateChanged回调函数中包含while True无限循环，一旦GPIO事件触发回调，该函数会一直阻塞，导致后续的GPIO事件无法被处理。这是核心逻辑错误，即使终端运行时看似正常，也存在潜在的阻塞问题。
2. X环境变量缺失：xdotool需要操作X窗口会话，而rc.local或crontab默认以root身份运行，且没有加载当前用户的DISPLAY和XAUTHORITY环境变量，导致无法找到X窗口，无法发送音量按键事件。
3. 权限问题：root用户没有权限访问普通用户（如pi）的X会话，即使设置了环境变量，也可能因权限不足导致xdotool执行失败。

解决方案 #

步骤1：修复音量控制脚本的逻辑错误 #

移除回调函数中的无限循环，改为单次事件处理并添加防抖逻辑，优化静音逻辑：

import RPi.GPIO as GPIO
from subprocess import call
import time

up = 11
down = 13
last_press_time = 0
debounce_delay = 0.2  # 防抖时间，避免误触发
mute_active = False

GPIO.setmode(GPIO.BOARD)
GPIO.setup(up, GPIO.IN, pull_up_down=GPIO.PUD_UP)
GPIO.setup(down, GPIO.IN, pull_up_down=GPIO.PUD_UP)

def handle_volume(pin):
    global last_press_time, mute_active
    current_time = time.time()
    
    # 防抖：两次按键间隔小于阈值则忽略
    if current_time - last_press_time < debounce_delay:
        return
    last_press_time = current_time

    # 同时按下两个按键：切换静音
    if not GPIO.input(up) and not GPIO.input(down):
        call(["xdotool", "key", "XF86AudioMute"], shell=False)
        mute_active = not mute_active
        time.sleep(0.2)
        return
    
    # 音量+
    if not GPIO.input(up):
        call(["xdotool", "key", "XF86AudioRaiseVolume"], shell=False)
        time.sleep(0.2)
    # 音量-
    elif not GPIO.input(down):
        call(["xdotool", "key", "XF86AudioLowerVolume"], shell=False)
        time.sleep(0.2)

# 为按键添加FALLING边缘检测，搭配防抖时间
GPIO.add_event_detect(up, GPIO.FALLING, callback=handle_volume, bouncetime=int(debounce_delay*1000))
GPIO.add_event_detect(down, GPIO.FALLING, callback=handle_volume, bouncetime=int(debounce_delay*1000))

try:
    while True:
        time.sleep(1)
except KeyboardInterrupt:
    GPIO.cleanup()

步骤2：解决开机自启的X环境问题 #

推荐使用用户级自启方式，确保脚本以当前用户身份运行并加载X环境变量：

方法1：用户级crontab

1. 打开当前用户的crontab编辑：

   crontab -e
   

2. 添加以下内容（替换pi为你的用户名，/home/pi/Desktop/为脚本绝对路径）：

   @reboot sleep 10 && DISPLAY=:0 XAUTHORITY=/home/pi/.Xauthority python /home/pi/Desktop/volume.py &
   @reboot sleep 10 && python /home/pi/Desktop/reboot.py &
   

   • sleep 10：等待系统完成启动，确保X会话加载完成
   • DISPLAY=:0：指定树莓派默认X显示器编号
   • XAUTHORITY：指定X权限文件路径，确保脚本能访问用户的X会话

方法2：桌面自启项（适用于带桌面的树莓派）

1. 创建音量控制自启项：

   nano ~/.config/autostart/volume-control.desktop
   

   写入内容：

   [Desktop Entry]
   Type=Application
   Name=Volume Control GPIO
   Exec=python /home/pi/Desktop/volume.py
   Hidden=false
   NoDisplay=false
   X-GNOME-Autostart-enabled=true
   

2. 创建关机/重启自启项：

   nano ~/.config/autostart/reboot-control.desktop
   

   写入内容：

   [Desktop Entry]
   Type=Application
   Name=Reboot/Shutdown GPIO
   Exec=python /home/pi/Desktop/reboot.py
   Hidden=false
   NoDisplay=false
   X-GNOME-Autostart-enabled=true
   

步骤3：设置脚本权限 #

确保脚本具备可执行权限：

chmod +x /home/pi/Desktop/volume.py
chmod +x /home/pi/Desktop/reboot.py

测试 #

重启树莓派后测试按键功能，若仍有问题可查看日志排查：

• crontab日志：grep CRON /var/log/syslog
• 桌面自启日志：查看~/.xsession-errors文件

内容的提问来源于stack exchange，提问作者Colevakun