0x2202 · extendedAdjustableDpi

The modern successor to 0x2201 adjustableDpi, adding independent X/Y DPI, lift-off distance (LOD) control, DPI-status LED management, and a firmware/software calibration flow. Rather than a flat DPI list, supported DPI is described as a mix of DpiRange::Fixed values and DpiRange::Stepped ranges (each with from, to, and step). get_sensor_capabilities reports which optional sub-features a sensor supports via the SensorCapabilities flags.

get_sensor_dpi_parameters / set_sensor_dpi_parameters read and write the active DPI for both axes and the LOD in a single call. show_sensor_dpi_status drives the device's DPI indicator LED. The calibration sub-flow (get_dpi_calibration_info → start_dpi_calibration → set_dpi_calibration) can run on firmware or host. Two unsolicited events are emitted: ParametersChanged fires when the user presses a DPI button, and CalibrationCompleted fires when a calibration finishes or times out.

• SensorCapabilities — DPI_Y (independent Y-axis DPI), LOD (lift-off control), CALIBRATION, PROFILE (per-profile DPI lists).
• Lod — NotSupported, Low, Medium, High.
• LedHoldType — TimerBased, EventBased, SwControlOn, SwControlOff.
• CalibrationType — Hardware (on-sensor) or Software (host-computed).
• DpiCalibrationCorrection — Adjust(i16) scales resolution by (1024 + value) / 1024; RevertToOob / RevertToProfile reset to defaults.

Spec: Logitech HID++ 2.0 — x2202 extendedAdjustableDpi. Used by: DPI presets.

Function reference

The ExtendedDpiFeature wrapper (0x2202) exposes:

Methods

All async methods return Result<…, Hidpp20Error>; listen is synchronous and returns an async_channel::Receiver<ExtendedDpiEvent> directly.

Types

DpiDirection

The axis a DPI value or calibration applies to.

Lod

A sensor's lift-off distance setting: the height above the surface at which the sensor stops tracking motion.

LedHoldType

How the device holds the DPI status LED after a show_sensor_dpi_status request.

CalibrationType

Where a DPI calibration is computed.

SensorCapabilities

Per-sensor capability flags reported by get_sensor_capabilities.

SensorCapabilitiesInfo

A sensor's capabilities and DPI-level count, returned by get_sensor_capabilities.

DpiRange

One entry of a sensor's supported-DPI description, returned by get_sensor_dpi_ranges. Fixed values and stepped ranges may be mixed; adjacent ranges may share an endpoint.

DpiParameters

Current and default DPI parameters of a sensor, returned by get_sensor_dpi_parameters. dpi_y and default_dpi_y are 0 when the sensor does not support an independent Y axis.

SetDpiParameters

DPI parameters to apply with set_sensor_dpi_parameters.

ShowDpiStatus

Parameters for show_sensor_dpi_status.

DpiCalibrationInfo

Calibration reference information returned by get_dpi_calibration_info.

StartDpiCalibration

Parameters for start_dpi_calibration.

DpiCalibrationCorrection

A DPI calibration correction to apply with set_dpi_calibration.

Events

ExtendedDpiFeature implements EmittingFeature<ExtendedDpiEvent>; call listen() to receive a channel of ExtendedDpiEvent values. The enum has two variants:

DpiParametersChanged

Payload of ExtendedDpiEvent::ParametersChanged. Fired when the sensor's DPI parameters change on the device (e.g. via a DPI button).

DpiCalibrationCompleted

Payload of ExtendedDpiEvent::CalibrationCompleted. Fired when a DPI calibration finishes or times out.

Wire format

Most getter requests carry a 3-byte short payload; setter/calibration requests use a 16-byte long payload via call_long. Responses are always read from the 16-byte extended payload returned by extend_payload().

get_sensor_count (fn 0)

Request: [0x00, 0x00, 0x00] (no parameters)

Response (byte → field):

get_sensor_capabilities (fn 1)

Request: [sensor_index, 0x00, 0x00]

Response (byte → field):

get_sensor_dpi_ranges (fn 2)

Fetches pages until a 0x0000 end-of-list terminator is encountered (up to 16 pages).

Request: [sensor_index, direction, page] where direction: 0 = X, 1 = Y; page starts at 0.

Response (byte → field):

get_sensor_dpi_list (fn 3)

Request: [sensor_index, direction, 0x00]

Response (byte → field):

get_sensor_lod_list (fn 4)

Request: [sensor_index, 0x00, 0x00]

Response (byte → field):

get_sensor_dpi_parameters (fn 5)

Request: [sensor_index, 0x00, 0x00]

Response (byte → field):

set_sensor_dpi_parameters (fn 6)

Uses a 16-byte long request payload (call_long).

Request bytes 0–5 (remainder zero-padded):

Response: not read (acknowledged by the device's echo).

show_sensor_dpi_status (fn 7)

Uses a 16-byte long request payload (call_long).

Request bytes 0–3 (remainder zero-padded):

Response: not read.

get_dpi_calibration_info (fn 8)

Request: [sensor_index, 0x00, 0x00]

Response (byte → field):

start_dpi_calibration (fn 9)

Uses a 16-byte long request payload (call_long).

Request bytes 0–7 (remainder zero-padded):

Response: not read (result delivered via CalibrationCompleted event).

set_dpi_calibration (fn 10)

Uses a 16-byte long request payload (call_long).

Request bytes 0–3 (remainder zero-padded):

Response: not read.

Events

ParametersChanged (sub-id 0)

CalibrationCompleted (sub-id 1)

Usage (Rust)

use hidpp::{
    device::Device,
    feature::{
        extended_dpi::{
            DpiDirection, ExtendedDpiFeature, Lod, SetDpiParameters, StartDpiCalibration,
            CalibrationType,
        },
        EmittingFeature,
    },
};

// device: &mut Device, already created via Device::new(channel, index).await?
device.enumerate_features().await?;
if let Some(feat) = device.get_feature::<ExtendedDpiFeature>() {
    // Query how many sensors the device has.
    let sensor_count = feat.get_sensor_count().await?;

    // Read the current DPI and lift-off distance for sensor 0.
    let params = feat.get_sensor_dpi_parameters(0).await?;
    println!("DPI X={} Y={} LOD={:?}", params.dpi_x, params.dpi_y, params.lod);

    // Set a new DPI (e.g. 1600 dpi on X, linked Y, medium lift-off).
    feat.set_sensor_dpi_parameters(0, SetDpiParameters {
        dpi_x: 1600,
        dpi_y: 0, // linked to X when sensor has no independent Y axis
        lod: Lod::Medium,
    }).await?;

    // Listen for unsolicited DPI-change events.
    let rx = feat.listen();
    while let Ok(event) = rx.recv().await {
        println!("DPI event: {:?}", event);
    }
}