接收器

接收器（receiver） 是无线 Logitech 设备配对所用的 USB 适配器。OpenLogi 在其 USB/HID 通道上检测接收器，再枚举与之配对的设备。

与设备功能（走 HID++ 2.0）不同，接收器通过 HID++ 1.0 寄存器驱动，并且始终以 设备索引 0xFF（RECEIVER_DEVICE_INDEX）寻址。识别只看 USB 厂商/产品 ID —— openlogi-hidpp 的 receiver::detect() 将通道的 VID/PID 与已知集合匹配，返回一个 Receiver。

检测

receiver::detect(chan) 对已知适配器返回 Some(Receiver)，否则返回 None。

G 系列设备附带的 Lightspeed 适配器应答与 Unifying 相同的 HID++ 1.0 寄存器， 因此检测、枚举、路由、配对都走 Unifying 代码路径 —— 只有面向用户的名称不同 （Lightspeed Receiver）。C53F 是 G305 等无线鼠标的 nano 接收器，已用 G305 实测（配对设备 wpid 0x4074）；C547 随 G915 键盘、G502 X LIGHTSPEED 等较新设备 出货，已用 G915 实测（wpid 0x407c）。C539 是 Lightspeed 游戏接收器，因按 Unifying 路由而与 Unifying 的 PID 列在一起。C537 是 G602 附带的 Nano 接收器， 应答相同的枚举与配对信息寄存器，同样按 Unifying 路由。

通用 API

Receiver 枚举包装具体的接收器类型，暴露共享接口：

错误以 ReceiverError 呈现 —— UnknownReceiver，或包装后的 HID++ 1.0 Protocol 错误。

Logi Bolt

现款 Logitech 接收器。Bolt 基于 BLE，最多配对 6 台设备，配对前用 passkey 认证新设备。bolt::Receiver 提供：

配对流程

1. discover_devices(Some(secs)) —— 接收器为附近每台设备发出 Event::DeviceDiscoveryDeviceDetails（携带设备 address、kind、wpid、 authentication）与 Event::DeviceDiscoveryDeviceName。
2. pair_device(slot, address, authentication, entropy) —— entropy 设定 passkey 复杂度（对鼠标而言，是用户需要输入的左/右键点击次数）。
3. 接收器完成配对，发出 Event::DeviceConnection。

事件（bolt::Event）

DeviceKind 覆盖 Keyboard、Mouse、Numpad、Presenter、Remote、 Trackball、Touchpad、Tablet、Gamepad、Joystick、Headset（外加 Unknown）。

Unifying

上一代接收器。Unifying 通过私有的 Unifying / DJ 协议最多配对 6 台设备；已配对 设备一旦按槽位索引寻址，就说 HID++ 2.0。unifying::Receiver 提供：

0x41 连接通知

两种接收器都通过同一条主动上报的 HID++ 1.0 通知（sub-id 0x41）报告设备状态。 已配对设备连接或断开时它会触发；trigger_device_arrival() 则让接收器为每个 已配对槽位重播一条 —— 设备已关机或超出范围的槽位同样会收到，只是标记为离线。 通知的设备索引就是设备的配对槽位，payload 为：

device-info 字节打包了设备类型与四个状态标志位：

bit 5 和 bit 4 长得像，说的却是两个世界。bit 5 是 2.4 GHz 链路自身的属性：设备与 接收器之间的流量是否加密，在配对时就已决定。它关乎安全 —— 未加密的链路可以被空中 嗅探和注入（2016 年的 MouseJack 攻击打的正是这类链路），所以 Solaar 在配对结束后 发现该位为 0 会向用户告警。Bolt 的链路设计上恒为加密。bit 4 与无线电毫无关系：它 回显的是主机写入寄存器 0x00 的一个标志，声明"有软件在接管设备的部分行为"， 设备固件据此决定（比如）手势键是发出转移报告（diverted report）还是退回固件内置 行为。

一段真实抓包，短消息 payload 04 62 69 40：协议 0x04（eQUAD），device-info 0x62 = 0110 0010 —— bit 6 置位（离线）、bit 5 置位（配对时已建立链路加密）、 bit 4 为 0、类型 0x2（鼠标）—— wpid 0x4069，即 MX Master 2S。这就是离线槽位 重播的样子：身份完好，链路断开。

枚举已配对设备（Rust）

use std::sync::Arc;

use hidpp::{
    channel::HidppChannel,
    receiver::{self, Receiver},
};

// chan: 绑定到接收器 HID 接口的 Arc<HidppChannel>。
let Some(rx) = receiver::detect(Arc::clone(&chan)) else {
    return; // 不是已知的 Logitech 接收器
};
println!("{} — {}", rx.name(), rx.get_unique_id().await?);

match rx {
    Receiver::Bolt(bolt) => {
        for dev in bolt.collect_paired_devices().await? {
            // dev: bolt::DeviceConnection —— 一台已配对设备
            let _ = dev;
        }
    }
    Receiver::Unifying(uni) => {
        let events = uni.listen();
        uni.trigger_device_arrival().await?; // 重发 DeviceConnection 事件
        while let Ok(event) = events.recv().await {
            // 处理 unifying::Event::DeviceConnection { .. }
            let _ = event;
            break;
        }
    }
    _ => {}
}

无接收器

蓝牙直连与有线设备作为各自独立的清单枚举，不涉及接收器。参见 连接设备。