如何为 pigpio 远程连接 Raspberry Pi 设置超时机制-Python教程-PHP中文网

如何为 pigpio 远程连接 Raspberry Pi 设置超时机制

pigpio 库本身不提供直接的连接超时参数，但可通过检查 pi.connected 属性快速判断连接状态，结合 socket 层手动设置超时，可有效避免默认长达 30 秒的阻塞等待。

pigpio 库本身不提供直接的连接超时参数，但可通过检查 `pi.connected` 属性快速判断连接状态，结合 socket 层手动设置超时，可有效避免默认长达 30 秒的阻塞等待。

在使用 pigpio.pi(host, port) 远程连接 Raspberry Pi 时，底层 TCP 连接由系统默认 socket 行为控制——若目标主机不可达或 pigpiod 未运行，pigpio.pi() 构造函数不会抛出异常，而是立即返回一个 pigpio.pi 实例（即使连接失败），仅在后续首次调用 GPIO 方法时触发延迟报错。其默认连接超时不可配置，首试约 30 秒，重试约 3 秒，严重影响程序响应性。

幸运的是，pigpio 提供了可靠的连接状态检查机制：pi.connected 是一个只读布尔属性，在实例创建后即可立即访问，无需任何 I/O 操作。它准确反映底层 socket 是否已成功建立并完成 pigpio 协议握手：

import pigpio

pi = pigpio.pi('192.168.108.1', 8888)
if not pi.connected:
    print("❌ 连接失败：无法访问 pigpiod 服务")
    # 可在此处清理资源或退出
    exit(1)

print("✅ 连接成功，可安全执行 GPIO 操作")

⚠️ 注意：pi.connected 的值在构造后即确定，不会因后续网络中断而自动更新；它仅表示初始连接是否成功。若需持续保活，应配合 socket.SO_KEEPALIVE（如原代码所示）及应用层心跳检测。

剪映

一款AI视频创作工具，主要用于一款全能易用的桌面端剪辑软件，适合需要提升相关任务效率的用户。

下载

若需更精细的超时控制（例如 5 秒内强制放弃），推荐在创建 pigpio.pi 前，预检 TCP 端口连通性：

import socket
import pigpio

def connect_with_timeout(host, port, timeout=5):
    # 预检：尝试建立 TCP 连接（非 pigpio 协议）
    try:
        sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
        sock.settimeout(timeout)
        sock.connect((host, port))
        sock.close()
    except (socket.timeout, ConnectionRefusedError, OSError) as e:
        print(f"? TCP 连接预检失败（{timeout}s 超时）: {e}")
        return None

    # 此时再初始化 pigpio（大概率成功）
    pi = pigpio.pi(host, port)
    if not pi.connected:
        print("⚠️ pigpio 协议握手失败（可能 daemon 版本不兼容或认证问题）")
        return None
    return pi

# 使用示例
pi = connect_with_timeout('192.168.108.1', 8888, timeout=3)
if pi is None:
    raise RuntimeError("Raspberry Pi 连接超时，终止初始化")

✅ 总结：