0x8090 · modeStatus
Read and selectively update a device’s performance-mode status and its hardware or software switching capabilities.
The modeStatus feature reads two mode-status bytes and selectively updates their bits. In v1, bit 0 of status0 selects performance mode; an unset bit selects endurance mode. OpenLogi v0.8.15 provides a typed protocol wrapper, but no device-layer path uses it.
Spec: Logitech HID++ 2.0 — modeStatus (v1). Cross-checked: G HUB (static analysis). Used by: Not used by OpenLogi.
Function reference
ModeStatusFeature is available when feature enumeration finds 0x8090 at version 1 or later.
Methods
| Function | HID++ fn | Signature | Returns |
|---|---|---|---|
get_mode_status | 0 | () | ModeStatus |
set_mode_status | 1 | (change: ModeStatusChange) | () |
set_performance_mode | 1 | (enabled: bool) | () |
get_device_config | 2 | () | ModeStatusCapabilities |
All methods are async and return Result<…, Hidpp20Error>.
Types
ModeStatus
| Field | Type | Description |
|---|---|---|
status0 | ModeStatus0 | Primary status bits. Unknown bits are retained. |
status1 | u8 | Secondary status byte. v1 reserves this byte, and OpenLogi preserves it on reads. |
ModeStatusChange
| Field | Type | Description |
|---|---|---|
status0 | ModeStatus0 | Requested primary status bits. |
status1 | u8 | Requested secondary status byte. |
changed_mask0 | ModeStatus0 | Primary bits to update. |
changed_mask1 | u8 | Secondary bits to update. |
ModeStatus0
| Variant | Value | Description |
|---|---|---|
PERFORMANCE | bit 0 | Performance mode. An unset bit selects endurance mode. |
ModeStatusCapabilities
| Variant | Value | Description |
|---|---|---|
HARDWARE_SWITCH | bit 0 | A hardware switch can change the mode bit. |
SOFTWARE_SWITCH | bit 1 | Software can change the mode bit. |
Events
ModeStatusFeature has no event listener or event decoder in OpenLogi v0.8.15.
Wire format
Short requests contain 3 zero bytes. OpenLogi expands short responses to its 16-byte payload buffer before decoding them.
get_mode_status (fn 0)
Request: [0x00, 0x00, 0x00].
| Byte | Field | Notes |
|---|---|---|
| 0 | status0 | ModeStatus0; bit 0 is PERFORMANCE. Unknown bits are retained. |
| 1 | status1 | Secondary status byte. |
| 2–15 | — | OpenLogi does not read these bytes. |
set_mode_status (fn 1)
OpenLogi sends a 16-byte long request and checks only the result status.
| Byte | Field | Notes |
|---|---|---|
| 0 | status0 | Requested primary status bits. |
| 1 | status1 | Requested secondary status byte. |
| 2 | changed_mask0 | Primary bits to update. |
| 3 | changed_mask1 | Secondary bits to update. |
| 4–15 | — | OpenLogi writes zero. |
set_performance_mode (fn 1)
This convenience method uses the fn 1 layout. It writes PERFORMANCE or an empty status0, sets changed_mask0 to PERFORMANCE, and writes zero to both secondary fields.
get_device_config (fn 2)
Request: [0x00, 0x00, 0x00].
| Byte | Field | Notes |
|---|---|---|
| 0–1 | capabilities | u16 BE. Bits 0 and 1 map to HARDWARE_SWITCH and SOFTWARE_SWITCH. Unknown bits are retained. |
| 2–15 | — | OpenLogi does not read these bytes. |
Status event (event 0)
| Byte | Field | Notes |
|---|---|---|
| 0–3 | Status payload | G HUB passes four bytes to its upper layer without byte-order conversion. The field mapping is not recovered. G HUB |
OpenLogi v0.8.15 does not subscribe to or decode this event.
How OpenLogi uses it
OpenLogi creates ModeStatusFeature during feature enumeration when a device reports 0x8090 version 1 or later. No device-layer writer, session, inventory path, CLI command, or user-facing page calls the wrapper in v0.8.15. OpenLogi therefore performs no read-modify-write sequence, read-back check, state restoration, or capability gate beyond the wrapper’s version gate.
Open questions
G HUB static analysis identifies a four-byte status event, but it does not recover the meanings of its bytes. The event payload and device behavior need hardware verification before OpenLogi adds an event decoder or a device-layer policy.
Usage (Rust)
use hidpp::{
device::Device,
feature::mode_status::{
ModeStatus0, ModeStatusCapabilities, ModeStatusFeature,
},
protocol::v20::Hidpp20Error,
};
async fn enable_performance_mode(device: &mut Device) -> Result<(), Hidpp20Error> {
device.enumerate_features().await?;
let Some(feature) = device.get_feature::<ModeStatusFeature>() else {
return Ok(());
};
let status = feature.get_mode_status().await?;
println!("performance mode: {}", status.status0.contains(ModeStatus0::PERFORMANCE));
let capabilities = feature.get_device_config().await?;
if capabilities.contains(ModeStatusCapabilities::SOFTWARE_SWITCH) {
feature.set_performance_mode(true).await?;
}
Ok(())
}