Solaar与系统电源事件：休眠/唤醒时的设备状态处理

Solaar与系统电源事件：休眠/唤醒时的设备状态处理

【免费下载链接】Solaar Linux device manager for Logitech devices 项目地址: https://gitcode.com/gh_mirrors/so/Solaar

问题场景：休眠唤醒后的设备异常

你是否遇到过这样的情况：Linux系统从休眠状态唤醒后，Logitech鼠标指针卡顿、键盘快捷键失效，或者Solaar显示设备离线但实际已连接？这些问题往往源于设备与系统电源事件的交互异常。Solaar作为Linux下的Logitech设备管理器，在处理系统休眠/唤醒周期时需要解决三大核心挑战：设备连接状态同步、设置参数恢复、以及低功耗模式切换。

技术原理：Solaar的电源事件处理机制

Solaar通过三级架构实现电源事件响应：

1. 系统级事件监听

# [lib/solaar/listener.py#L300-L322]
def ping_all(resuming=False):
    logger.info("ping all devices%s", " when resuming" if resuming else "")
    for listener_thread in _all_listeners.values():
        if listener_thread.receiver.isDevice:
            if resuming:
                listener_thread.receiver._active = None  # 强制重新初始化
            if listener_thread.receiver.ping():
                listener_thread.receiver.changed(active=True, push=True)
        else:
            # 遍历所有接收器下的设备并执行ping
            for dev in listener_thread.receiver:
                if resuming:
                    dev._active = None  # 清除缓存状态
                if dev.ping():
                    dev.changed(active=True, push=True)

当系统唤醒时，ping_all(resuming=True)会遍历所有设备，通过_active = None清除缓存状态，强制重新建立通信。这个设计确保设备状态不会因休眠而残留脏数据。

2. 设备连接状态管理

Solaar采用"幽灵设备"（Ghost Device）模式处理临时离线状态：

# [lib/solaar/listener.py#L57-L65]
_GHOST_DEVICE = namedtuple("_GHOST_DEVICE", ("receiver", "number", "name", "kind", "online", "path"))
_GHOST_DEVICE.__bool__ = lambda self: False

def _ghost(device):
    return _GHOST_DEVICE(
        receiver=device.receiver, number=device.number, name=device.name, 
        kind=device.kind, online=False, path=None
    )

当设备在休眠期间断开连接，Solaar会创建幽灵设备对象保留UI上下文，唤醒后通过device.ping()验证实际连接状态，实现平滑过渡。

3. 参数自动恢复机制

设备唤醒后，Solaar会自动重新应用保存的配置：

# [lib/logitech_receiver/device.py#L452]
if active:
    # 推送设备设置
    if logger.isEnabledFor(logging.INFO):
        logger.info("%s pushing device settings %s", self, self.settings)
    settings.apply_all_settings(self)
    # 重新启用通知
    if self.protocol < 2.0:
        self.notification_flags = self.enable_connection_notifications()
    else:
        self.set_configuration(0x11)  # 发送配置完成信号
    self.read_battery()  # 刷新电池状态

常见问题与解决方案

1. 唤醒后设备无响应

现象：系统从休眠恢复后，鼠标/键盘无响应，但Solaar显示已连接。
原因：设备通信超时或状态缓存未清除。
解决：执行以下命令强制刷新设备状态：

solaar config -s <device-name> active True

或在Solaar UI中点击设备图标，选择"重置连接"。

2. 休眠后设置丢失

现象：自定义DPI、按键映射等设置在休眠后恢复默认值。
检查：确认~/.config/solaar/config.yaml文件权限正确，Solaar需要写入权限保存设置。
修复：

chmod 600 ~/.config/solaar/config.yaml

Solaar会在设备唤醒时自动读取该文件恢复配置。

3. 电池状态显示异常

现象：唤醒后电池电量显示错误或不更新。
技术背景：蓝牙设备在低功耗模式下可能暂停电池状态广播，如[lib/logitech_receiver/device.py#L418-L425]所示：

def set_battery_info(self, info):
    if info.level is None and self.battery_info:  # 使用上次已知电量
        info.level = self.battery_info.level
    changed = self.battery_info != info
    self.battery_info, old_info = info, self.battery_info
    if changed:
        self.changed(reason=info.to_str())  # 触发UI更新

解决：在Solaar设置中启用"唤醒时刷新电池状态"选项。

高级配置：电源事件优化

1. 自动休眠脚本

创建/etc/pm/sleep.d/99-solaar脚本，在系统休眠前清理设备状态：

#!/bin/sh
case "$1" in
    suspend|hibernate)
        solaar stop
        ;;
    resume|thaw)
        solaar start &
        ;;
esac

赋予执行权限：sudo chmod +x /etc/pm/sleep.d/99-solaar

2. 设备超时设置

修改设备轮询间隔，平衡响应速度与功耗：

# [lib/logitech_receiver/listener.py#L107]
_EVENT_READ_TIMEOUT = 1.0  # 默认1秒轮询一次

对于电池敏感设备，可将值调整为2-3秒。

总结与最佳实践

1. 保持Solaar后台运行：通过系统托盘启动Solaar，确保电源事件监听线程持续运行。
2. 定期更新规则文件：规则文件[rules.d/42-logitech-unify-permissions.rules]提供设备访问权限，更新可解决多数连接问题。
3. 监控日志排查问题：使用solaar -dd获取详细日志，重点关注"ping failed"和"timeout"关键字。
4. 设备兼容性参考：支持电源事件优化的设备列表可在[docs/devices.md]中查询，其中MX Master系列和G系列游戏设备支持最完善。

通过以上机制，Solaar实现了对系统电源事件的精细化管理，确保Logitech设备在休眠/唤醒周期中保持稳定工作。遇到复杂问题时，可参考Solaar官方文档或提交issue至GitHub仓库获取支持。

【免费下载链接】Solaar Linux device manager for Logitech devices 项目地址: https://gitcode.com/gh_mirrors/so/Solaar