0x2202 · extendedAdjustableDpi

0x2201 adjustableDpi 的现代继任者，新增了独立的 X/Y DPI、离地距离（LOD）控制、DPI 状态 LED 管理，以及固件/软件双模式的校准流程。支持的 DPI 不再以平铺列表描述，而是混合使用 DpiRange::Fixed（固定值）与 DpiRange::Stepped（带 from、to、step 的步进区间）。get_sensor_capabilities 通过 SensorCapabilities 标志位报告各传感器支持哪些可选子功能。

get_sensor_dpi_parameters / set_sensor_dpi_parameters 在一次调用中同时读写双轴 DPI 和 LOD。show_sensor_dpi_status 控制设备的 DPI 指示 LED。校准子流程（get_dpi_calibration_info → start_dpi_calibration → set_dpi_calibration）可在固件或主机侧执行。设备会主动推送两类事件：用户按下 DPI 按键时触发 ParametersChanged，校准结束或超时时触发 CalibrationCompleted。

• SensorCapabilities —— DPI_Y（独立 Y 轴 DPI）、LOD（离地控制）、CALIBRATION、PROFILE（按配置文件的 DPI 列表）。
• Lod —— NotSupported、Low、Medium、High。
• LedHoldType —— TimerBased、EventBased、SwControlOn、SwControlOff。
• CalibrationType —— Hardware（传感器端）或 Software（主机计算）。
• DpiCalibrationCorrection —— Adjust(i16) 按 (1024 + value) / 1024 缩放分辨率；RevertToOob / RevertToProfile 恢复默认值。

规格： Logitech HID++ 2.0 —— x2202 extendedAdjustableDpi。用于： DPI 预设。

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);
    }
}