0x1D4B · wirelessDeviceStatus

An event-only feature: the device emits a status broadcast when its wireless link changes — typically on reconnection — and can ask the host software to reload its configuration.

OpenLogi listens for this so the GUI can refresh a device that wakes or re-pairs without a manual rescan.

Spec: 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);
        }
    }
}