OpenLogi

0x2200 · mousePointer

Read a mouse sensor's typical resolution and its pointer-tuning hints.

mousePointer reports a mouse's optical-sensor properties and pointer-tuning hints. Devices that expose 0x2200 return a typical resolution and three host-advisory values. This feature does not change pointer speed.

Spec: Logitech HID++ 2.0 — mousePointer. Cross-checked: Solaar. Used by: Not used by OpenLogi.

Function reference

The MousePointerFeature wrapper (0x2200, version 0+) exposes one read operation.

Methods

FunctionHID++ fnSignatureReturns
get_mouse_pointer_info0()MousePointerInfo

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

Types

MousePointerInfo

get_mouse_pointer_info returns this sensor and advisory record.

FieldTypeDescription
sensor_resolutionu16Typical resolution on a standard surface, in 1-DPI steps. Surface variation can be up to ±20%.
pointer_accelerationPointerAccelerationThe device's acceleration-curve hint.
suggest_os_ballisticsbooltrue asks the host to keep OS-native ballistics.
suggest_vertical_tuningbooltrue suggests that the host offer X/Y orientation tuning.

PointerAcceleration

This enum is the device's acceleration-curve hint.

VariantValueDescription
None0No acceleration is suggested.
Low1A low acceleration curve is suggested.
Medium2A medium acceleration curve is suggested.
High3A high acceleration curve is suggested.

Events

MousePointerFeature exposes no event type.

Wire format

getMousePointerInfo sends a 3-byte short request. OpenLogi reads its reply as a 16-byte extended payload.

get_mouse_pointer_info (fn 0)

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

Byte or bitsFieldNotes
0–1sensor_resolutionUnsigned u16 in BE order.
2, bits 1–0pointer_acceleration0=None, 1=Low, 2=Medium, 3=High.
2, bit 2suggest_os_ballisticsSet when the device suggests OS-native ballistics.
2, bit 3suggest_vertical_tuningSet when the device suggests vertical-orientation tuning.
2, bits 7–4ReservedOpenLogi ignores these bits.
3–15ReservedOpenLogi ignores these bytes.

How OpenLogi uses it

OpenLogi registers MousePointerFeature during feature enumeration. It decodes the three modeled response bytes in the typed wrapper. No device-layer, host, inventory, agent, CLI, or UI path calls the wrapper in v0.8.15.

OpenLogi has no user-facing setting for 0x2200. The feature has no version-specific method gate beyond its version-0 wrapper registration.

Usage (Rust)

use hidpp::{
    device::Device,
    feature::mouse_pointer::MousePointerFeature,
    protocol::v20::Hidpp20Error,
};

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

    if let Some(feature) = device.get_feature::<MousePointerFeature>() {
        let info = feature.get_mouse_pointer_info().await?;
        println!("Sensor resolution: {} DPI", info.sensor_resolution);
        println!("Acceleration hint: {:?}", info.pointer_acceleration);
        println!("Use OS ballistics: {}", info.suggest_os_ballistics);
    }

    Ok(())
}

On this page