OpenLogi

0x8061 · extendedAdjustableReportRate

Query report-rate capabilities up to 8000 Hz by connection type, then read or set the active extended rate.

extendedAdjustableReportRate controls high-frequency polling from 125 Hz to 8000 Hz. It distinguishes wired USB from Logitech gaming wireless for capability and active-rate reads. The setter applies a rate to the connection currently used by the host.

Spec: Logitech HID++ 2.0 — extendedAdjustableReportRate. Cross-checked: Logi Options+ 2.8 (static analysis), Solaar. Used by: Report rate.

Function reference

The ExtendedReportRateFeature wrapper (0x8061, version 0+) exposes four operations.

Methods

FunctionHID++ fnSignatureReturns
get_device_capabilities0(connection_type: ConnectionType)ExtendedReportRateList
get_actual_report_rate_list1()ExtendedReportRateList
get_report_rate2(connection_type: ConnectionType)ExtendedReportRate
set_report_rate3(report_rate: ExtendedReportRate)()

All methods are async and return Result<…, Hidpp20Error>.

Types

ExtendedReportRateList

This u16 bitflag set represents the rates in the response's second byte.

FlagBit or valueDescription
HZ_1251 << 0125 Hz, or an 8 ms interval.
HZ_2501 << 1250 Hz, or a 4 ms interval.
HZ_5001 << 2500 Hz, or a 2 ms interval.
HZ_10001 << 31000 Hz, or a 1 ms interval.
HZ_20001 << 42000 Hz, or a 500 µs interval.
HZ_40001 << 54000 Hz, or a 250 µs interval.
HZ_80001 << 68000 Hz, or a 125 µs interval.

ConnectionType

This non-exhaustive enum selects the connection for functions 0 and 2.

VariantValueDescription
Wired0Wired USB.
GamingWireless1Logitech gaming wireless.

ExtendedReportRate

This non-exhaustive enum is used by the setter and returned by function 2.

VariantValueDescription
Hz1250125 Hz, or 8 ms.
Hz2501250 Hz, or 4 ms.
Hz5002500 Hz, or 2 ms.
Hz100031000 Hz, or 1 ms.
Hz200042000 Hz, or 500 µs.
Hz400054000 Hz, or 250 µs.
Hz800068000 Hz, or 125 µs.

Events

The wrapper exposes no Rust event type. An unsolicited function-0 report is a report-rate change broadcast when its feature index matches 0x8061 and its software ID is 0. OpenLogi then advances the device settings revision and requests reconciliation.

Wire format

All four functions send 3-byte short requests. OpenLogi reads functions 0–2 as 16-byte extended replies. Function 3 checks only the HID++ acknowledgement.

get_device_capabilities (fn 0)

Request byteFieldNotes
0connection_type0 for Wired; 1 for GamingWireless.
1–2PaddingOpenLogi writes 0x00.
Response byte or bitsFieldNotes
0Unconfirmed non-rate byteLogi Options+ 2.8 does not include it in the rate mask. OpenLogi ignores it.
1, bits 0–6ExtendedReportRateListBit 0 is 125 Hz through bit 6 for 8000 Hz.
1, bit 7UnassignedOpenLogi retains this bit in the raw bitflags value. The device layer ignores it when it forms choices.
2–15ReservedOpenLogi ignores these bytes.

get_actual_report_rate_list (fn 1)

Request: [0x00, 0x00, 0x00]. All three bytes are padding.

Response byte or bitsFieldNotes
0Unconfirmed non-rate byteLogi Options+ 2.8 does not include it in the rate mask. OpenLogi ignores it.
1, bits 0–6ExtendedReportRateListSame one-byte mask as function 0. It names rates for the current connection.
1, bit 7UnassignedOpenLogi retains this bit in the raw bitflags value. The device layer ignores it when it forms choices.
2–15ReservedOpenLogi ignores these bytes.

get_report_rate (fn 2)

Request byteFieldNotes
0connection_type0 for Wired; 1 for GamingWireless.
1–2PaddingOpenLogi writes 0x00.
Response byteFieldNotes
0ExtendedReportRate discriminant0 is Hz125 through 6 for Hz8000. Another value returns Hidpp20Error::UnsupportedResponse.
1–15ReservedOpenLogi ignores these bytes.

set_report_rate (fn 3)

Request byteFieldNotes
0ExtendedReportRate discriminant0 is Hz125 through 6 for Hz8000.
1–2PaddingOpenLogi writes 0x00.

Response: HID++ acknowledgement. OpenLogi ignores all response payload bytes.

Report-rate change broadcast (fn 0)

Payload bytesFieldNotes
0–1Unconfirmed event dataOptions+ 2.8 requires at least two bytes before it emits an event. OpenLogi does not decode or preserve these bytes.
Remaining bytesUnconfirmedNo field layout is established. OpenLogi does not decode them.

How OpenLogi uses it

Since v0.8.14, PR #1779 reads the rate mask from response byte 1 alone. Byte 0 cannot create a false rate capability. Since v0.8.14, PR #1808 connects the feature to the device layer, agent IPC, desktop Pointer tab, CLI, and inventory event listener.

The device layer prefers 0x8061 over 0x8060. It derives Wired for a direct device route and GamingWireless for a receiver route. It reads function 1 for the current connection's choices and function 2 for its active rate.

Before writing, OpenLogi refuses a rate outside the current list and skips a rate already active. It then reads function 2 independently. A different value returns WriteError::ReportRateNotApplied; a post-write read failure retains the acknowledged requested rate as a provisional result.

The inventory listener recognizes an unmatched, software-ID-0 function-0 broadcast for the registered 0x8061 index. It advances settings_revision, queues reconciliation, and lets clients re-read the rate. The broadcast does not trigger a saved-rate replay.

The agent re-applies a saved report_rate only on reconnect, only for report-rate-capable devices, and only when the active connection advertises it. OpenLogi does not reset the report rate on exit. See Report rate for the GUI, configuration, and CLI behavior.

Open questions

Logi Options+ 2.8 reads response byte 1 alone for functions 0 and 1. The purpose of response byte 0 remains unconfirmed. OpenLogi ignores byte 0 instead of assigning it a rate meaning.

Logi Options+ 2.8 accepts a function-0 notification only with at least two payload bytes. The payload fields are not recovered. OpenLogi uses the report only as a prompt to re-read the device state; a hardware capture is required to name the fields.

Usage (Rust)

use hidpp::{
    device::Device,
    feature::extended_report_rate::{
        ConnectionType, ExtendedReportRate, ExtendedReportRateFeature,
    },
    protocol::v20::Hidpp20Error,
};

async fn set_wired_rate(device: &mut Device) -> Result<(), Hidpp20Error> {
    device.enumerate_features().await?;

    if let Some(feature) = device.get_feature::<ExtendedReportRateFeature>() {
        let supported = feature
            .get_device_capabilities(ConnectionType::Wired)
            .await?;
        if supported.bits() & (1_u16 << u8::from(ExtendedReportRate::Hz1000)) != 0 {
            feature.set_report_rate(ExtendedReportRate::Hz1000).await?;
        }
    }

    Ok(())
}

On this page