OpenLogi

0x1D4B · wirelessDeviceStatus

Receive a device reconnection broadcast and let OpenLogi reconfigure captured controls and volatile settings.

wirelessDeviceStatus is an event-only feature for wireless devices. OpenLogi uses its accepted broadcast as a reconnection signal, then re-arms capture sessions and schedules a configuration reapply.

Spec: No public Logitech specification. Layout reverse-engineered from Logi Options+ 2.8 (static analysis). Cross-checked: G HUB (static analysis), Solaar. Used by: OpenLogi inventory and capture sessions.

Function reference

WirelessDeviceStatusFeature implements feature version 0. It sends no HID++ requests. Its event source attaches to one device and feature-table index, and listen creates a receiver for decoded broadcasts.

Methods

| Function | HID++ fn | Signature | Returns | | --- | --- | --- | | listen | event | (&self) | async_channel::Receiver<WirelessDeviceStatusEvent> | | WirelessDeviceStatusEvent::decode | event | (function_id: u8, payload: &[u8; 16]) | Option<WirelessDeviceStatusEvent> |

listen comes from EmittingFeature. decode returns None unless function_id is 0.

Types

WirelessDeviceStatusBroadcast

FieldTypeDescription
statusWirelessDeviceStatusThe status reported by the device.
requestWirelessDeviceStatusRequestThe host action requested by the device.
reasonWirelessDeviceStatusReasonThe reason for the broadcast.

WirelessDeviceStatus

VariantValueDescription
Unknown0x00Unknown wireless-device status.
Reconnection0x01The device is reconnecting.
Other(u8)other valuesAn unmodelled raw value.

WirelessDeviceStatusRequest

VariantValueDescription
NoRequest0x00No host action is requested.
SoftwareReconfigurationNeeded0x01The host must reconfigure the device.
Other(u8)other valuesAn unmodelled raw value.

WirelessDeviceStatusReason

VariantValueDescription
Unknown0x00Unknown broadcast reason.
PowerSwitchActivated0x01A power-switch action caused the broadcast.
Other(u8)other valuesAn unmodelled raw value.

Events

VariantPayloadDescription
WirelessDeviceStatusEvent::StatusBroadcastWirelessDeviceStatusBroadcastA decoded function-0 status broadcast.

Wire format

The device sends an unsolicited status broadcast. OpenLogi sends no request for this feature. Its decoder receives a 16-byte extended payload, reads bytes 0 through 2, and ignores the remaining bytes.

StatusBroadcast (event, fn 0)

ByteFieldTypeValuesNotes
0statusWirelessDeviceStatus0x00 = Unknown; 0x01 = ReconnectionOther values become Other(u8).
1requestWirelessDeviceStatusRequest0x00 = NoRequest; 0x01 = SoftwareReconfigurationNeededOther values become Other(u8).
2reasonWirelessDeviceStatusReason0x00 = Unknown; 0x01 = PowerSwitchActivatedOther values become Other(u8).
3–15unmodelled tail—No established meaningOpenLogi ignores these bytes.

How OpenLogi uses it

Inventory records the feature-table index when it enumerates 0x1d4b. It accepts an inventory event only when the software ID is 0, the feature index matches, and WirelessDeviceStatusEvent::decode accepts function 0. On acceptance, inventory drops cached lock-key state and requests reconciliation.

The agent treats the resulting device-wake event as a reconfiguration signal. It schedules a reapply on the next inventory snapshot, even if that snapshot never observed the device offline.

Capture sessions query the feature during setup. When present, they retain a listener. Every decoded broadcast resets captured input state, waits for the re-arm settle delay, and re-arms if I/O remains allowed. The session does not branch on status, request, or reason.

The feature owns no writable state. It has no read-modify-write operation, read-back check, or state restore. Dropping the feature removes its guarded channel listener.

Open questions

OpenLogi and Solaar accept only function 0. Options+ and the Linux HID++ driver treat any report at the 0x1d4b feature index as a reconnection signal. No capture or field report establishes a non-zero-function layout, so OpenLogi keeps the function-0 gate.

The available evidence does not assign meanings to payload bytes 3 through 15. OpenLogi ignores them.

Usage (Rust)

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

// `device` is `&mut Device`, created with `Device::new`.
device.enumerate_features().await?;
if let Some(feature) = device.get_feature::<WirelessDeviceStatusFeature>() {
    let events = feature.listen();
    while let Ok(WirelessDeviceStatusEvent::StatusBroadcast(status)) = events.recv().await {
        println!("{status:?}");
    }
}

On this page