0x1D4B · wirelessDeviceStatus

一个纯事件功能：当设备的无线链路发生变化时（通常是在重连时），设备会发出状态广播，并可请求主机软件重新加载其配置。

OpenLogi 监听该事件，使 GUI 能在设备唤醒或重新配对时刷新，而无需手动重新扫描。

规格： Logitech HID++ 2.0 —— x1d4b wirelessDeviceStatus（v0）。

Function reference

WirelessDeviceStatusFeature (0x1D4B) is event-only — it has no request functions; the host subscribes and reacts to broadcasts.

Methods

listen is synchronous and returns an async_channel::Receiver<WirelessDeviceStatusEvent> directly (via the EmittingFeature trait).

Events

WirelessDeviceStatusEvent

WirelessDeviceStatusBroadcast

WirelessDeviceStatus

WirelessDeviceStatusRequest

WirelessDeviceStatusReason

Wire format

This feature is event-only — the device sends unsolicited broadcasts; the host never sends a request payload. All broadcasts use sub-function index 0x00.

StatusBroadcast (event, sub-fn 0)

The device pushes a short HID++ message whose payload starts at the standard feature-event offset. The listener fires only when the sub-function nibble is 0.

Event payload (byte → field):

Bytes beyond index 2 are not read by the crate.

Usage (Rust)

use hidpp::{
    device::Device,
    feature::{EmittingFeature, wireless_device_status::{WirelessDeviceStatusEvent, WirelessDeviceStatusFeature}},
};

// let mut device = Device::new(Arc::clone(&channel), device_index).await?;
device.enumerate_features().await?;
if let Some(feat) = device.get_feature::<WirelessDeviceStatusFeature>() {
    let rx = feat.listen();
    while let Ok(event) = rx.recv().await {
        if let WirelessDeviceStatusEvent::StatusBroadcast(broadcast) = event {
            println!("status={:?} request={:?} reason={:?}",
                broadcast.status, broadcast.request, broadcast.reason);
        }
    }
}