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
| Function | HID++ fn | Signature | Returns |
|---|---|---|---|
get_device_capabilities | 0 | (connection_type: ConnectionType) | ExtendedReportRateList |
get_actual_report_rate_list | 1 | () | ExtendedReportRateList |
get_report_rate | 2 | (connection_type: ConnectionType) | ExtendedReportRate |
set_report_rate | 3 | (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.
| Flag | Bit or value | Description |
|---|---|---|
HZ_125 | 1 << 0 | 125 Hz, or an 8 ms interval. |
HZ_250 | 1 << 1 | 250 Hz, or a 4 ms interval. |
HZ_500 | 1 << 2 | 500 Hz, or a 2 ms interval. |
HZ_1000 | 1 << 3 | 1000 Hz, or a 1 ms interval. |
HZ_2000 | 1 << 4 | 2000 Hz, or a 500 µs interval. |
HZ_4000 | 1 << 5 | 4000 Hz, or a 250 µs interval. |
HZ_8000 | 1 << 6 | 8000 Hz, or a 125 µs interval. |
ConnectionType
This non-exhaustive enum selects the connection for functions 0 and 2.
| Variant | Value | Description |
|---|---|---|
Wired | 0 | Wired USB. |
GamingWireless | 1 | Logitech gaming wireless. |
ExtendedReportRate
This non-exhaustive enum is used by the setter and returned by function 2.
| Variant | Value | Description |
|---|---|---|
Hz125 | 0 | 125 Hz, or 8 ms. |
Hz250 | 1 | 250 Hz, or 4 ms. |
Hz500 | 2 | 500 Hz, or 2 ms. |
Hz1000 | 3 | 1000 Hz, or 1 ms. |
Hz2000 | 4 | 2000 Hz, or 500 µs. |
Hz4000 | 5 | 4000 Hz, or 250 µs. |
Hz8000 | 6 | 8000 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 byte | Field | Notes |
|---|---|---|
| 0 | connection_type | 0 for Wired; 1 for GamingWireless. |
| 1–2 | Padding | OpenLogi writes 0x00. |
| Response byte or bits | Field | Notes |
|---|---|---|
| 0 | Unconfirmed non-rate byte | Logi Options+ 2.8 does not include it in the rate mask. OpenLogi ignores it. |
| 1, bits 0–6 | ExtendedReportRateList | Bit 0 is 125 Hz through bit 6 for 8000 Hz. |
| 1, bit 7 | Unassigned | OpenLogi retains this bit in the raw bitflags value. The device layer ignores it when it forms choices. |
| 2–15 | Reserved | OpenLogi ignores these bytes. |
get_actual_report_rate_list (fn 1)
Request: [0x00, 0x00, 0x00]. All three bytes are padding.
| Response byte or bits | Field | Notes |
|---|---|---|
| 0 | Unconfirmed non-rate byte | Logi Options+ 2.8 does not include it in the rate mask. OpenLogi ignores it. |
| 1, bits 0–6 | ExtendedReportRateList | Same one-byte mask as function 0. It names rates for the current connection. |
| 1, bit 7 | Unassigned | OpenLogi retains this bit in the raw bitflags value. The device layer ignores it when it forms choices. |
| 2–15 | Reserved | OpenLogi ignores these bytes. |
get_report_rate (fn 2)
| Request byte | Field | Notes |
|---|---|---|
| 0 | connection_type | 0 for Wired; 1 for GamingWireless. |
| 1–2 | Padding | OpenLogi writes 0x00. |
| Response byte | Field | Notes |
|---|---|---|
| 0 | ExtendedReportRate discriminant | 0 is Hz125 through 6 for Hz8000. Another value returns Hidpp20Error::UnsupportedResponse. |
| 1–15 | Reserved | OpenLogi ignores these bytes. |
set_report_rate (fn 3)
| Request byte | Field | Notes |
|---|---|---|
| 0 | ExtendedReportRate discriminant | 0 is Hz125 through 6 for Hz8000. |
| 1–2 | Padding | OpenLogi writes 0x00. |
Response: HID++ acknowledgement. OpenLogi ignores all response payload bytes.
Report-rate change broadcast (fn 0)
| Payload bytes | Field | Notes |
|---|---|---|
| 0–1 | Unconfirmed event data | Options+ 2.8 requires at least two bytes before it emits an event. OpenLogi does not decode or preserve these bytes. |
| Remaining bytes | Unconfirmed | No 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(())
}