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
| Field | Type | Description |
|---|---|---|
status | WirelessDeviceStatus | The status reported by the device. |
request | WirelessDeviceStatusRequest | The host action requested by the device. |
reason | WirelessDeviceStatusReason | The reason for the broadcast. |
WirelessDeviceStatus
| Variant | Value | Description |
|---|---|---|
Unknown | 0x00 | Unknown wireless-device status. |
Reconnection | 0x01 | The device is reconnecting. |
Other(u8) | other values | An unmodelled raw value. |
WirelessDeviceStatusRequest
| Variant | Value | Description |
|---|---|---|
NoRequest | 0x00 | No host action is requested. |
SoftwareReconfigurationNeeded | 0x01 | The host must reconfigure the device. |
Other(u8) | other values | An unmodelled raw value. |
WirelessDeviceStatusReason
| Variant | Value | Description |
|---|---|---|
Unknown | 0x00 | Unknown broadcast reason. |
PowerSwitchActivated | 0x01 | A power-switch action caused the broadcast. |
Other(u8) | other values | An unmodelled raw value. |
Events
| Variant | Payload | Description |
|---|---|---|
WirelessDeviceStatusEvent::StatusBroadcast | WirelessDeviceStatusBroadcast | A 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)
| Byte | Field | Type | Values | Notes |
|---|---|---|---|---|
| 0 | status | WirelessDeviceStatus | 0x00 = Unknown; 0x01 = Reconnection | Other values become Other(u8). |
| 1 | request | WirelessDeviceStatusRequest | 0x00 = NoRequest; 0x01 = SoftwareReconfigurationNeeded | Other values become Other(u8). |
| 2 | reason | WirelessDeviceStatusReason | 0x00 = Unknown; 0x01 = PowerSwitchActivated | Other values become Other(u8). |
| 3–15 | unmodelled tail | — | No established meaning | OpenLogi 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:?}");
}
}