树莓派GPIO重复占用问题：OLED HAT应用启动报错求助

1. 验证单例模式的有效性 #

确保disp.py的单例实现没有漏洞，尤其是在多线程/模块重复加载场景下。以下是可靠的单例实现示例：

# disp.py
import lgpio

class DisplaySingleton:
    _instance = None
    _gpio_handle = None

    def __new__(cls):
        if cls._instance is None:
            cls._instance = super().__new__(cls)
            # 仅首次创建实例时初始化GPIO
            cls._gpio_handle = lgpio.gpiochip_open(0)
            # 根据Waveshare OLED HAT手册配置引脚
            lgpio.gpio_claim_output(cls._gpio_handle, 24)  # 示例引脚，按需替换
        return cls._instance

    def get_gpio_handle(self):
        return self._gpio_handle

    def __del__(self):
        if self._gpio_handle is not None:
            lgpio.gpiochip_close(self._gpio_handle)

注意：如果应用通过子进程启动，单例会失效（子进程会重新加载模块创建新实例），此时需改用线程启动应用，或通过进程间通信共享GPIO句柄。

2. 强制应用复用主程序的GPIO实例 #

所有应用代码必须通过主程序传递的disp实例操作GPIO，禁止在应用内部重新初始化lgpio或OLED驱动。示例如下：

# Apps/clock/clock.py 应用代码示例
def run(disp_instance):
    gpio_handle = disp_instance.get_gpio_handle()
    # 仅使用传入的句柄操作GPIO，不做任何初始化逻辑
    # 你的应用业务代码...

主程序启动应用时必须显式传递实例：

# 主程序
from disp import DisplaySingleton
import importlib.util

disp = DisplaySingleton()

def launch_app(app_name):
    # 动态导入应用模块
    spec = importlib.util.spec_from_file_location(f"{app_name}_app", f"Apps/{app_name}/{app_name}.py")
    app_module = importlib.util.module_from_spec(spec)
    spec.loader.exec_module(app_module)
    app_module.run(disp)  # 传递全局disp实例

3. 完善GPIO释放逻辑 #

检查Waveshare OLED驱动的退出逻辑，确保主程序和应用退出时正确释放资源。可在单例类中添加关闭方法：

class DisplaySingleton:
    # ... 已有代码 ...
    def close_display(self):
        # 调用OLED驱动的清理方法（根据实际驱动调整）
        self.oled.clear()
        self.oled.close()
        # 释放GPIO引脚
        lgpio.gpio_free(self._gpio_handle, 24)

在主程序捕获退出信号时调用该方法：

# 主程序末尾
try:
    # 主循环逻辑
    while True:
        pass
except KeyboardInterrupt:
    disp.close_display()

4. 禁止用子进程启动应用 #

如果主程序通过subprocess启动应用，子进程会独立占用GPIO导致冲突。改用线程启动，或通过模块导入的方式运行应用代码（如上述launch_app示例）。

5. 临时调试：强制释放GPIO #

若以上方法无效，可在主程序初始化前强制释放目标引脚（仅用于调试，不建议长期使用）：

# disp.py初始化前执行
try:
    temp_handle = lgpio.gpiochip_open(0)
    lgpio.gpio_free(temp_handle, 24)  # 替换为你的OLED引脚
    lgpio.gpiochip_close(temp_handle)
except lgpio.error:
    pass  # 引脚未被占用时忽略错误

排查定位步骤 #

若问题仍存在，执行以下操作定位根源：

• 用lgpio -c命令行工具查看GPIO占用情况，确认哪个进程占用了目标引脚
• 在主程序和应用中添加日志，打印gpio_handle的内存地址，验证是否为同一实例
• 检查应用代码中是否存在直接调用lgpio.gpiochip_open的逻辑

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