0x2202 · extendedAdjustableDpi

0x2202 按传感器控制 DPI 参数。它在 0x2201 adjustableDpi 的基础上，增加可选的 X/Y DPI、离地距离（LOD）、DPI 状态 LED 控制、配置文件和校准。

**规格：**Logitech HID++ 2.0 —— x2202 extendedAdjustableDpi。**交叉核对：**Logi Options+ 2.8（静态分析）、Solaar。用于：DPI。

函数参考

ExtendedDpiFeature 是 OpenLogi 对 0x2202 的封装。异步方法返回 Result<T, Hidpp20Error>。listen 是同步方法，并返回 async_channel::Receiver<ExtendedDpiEvent>。

方法

类型

DpiDirection

Lod

LOD 是传感器停止追踪移动时，相对表面的高度。

LedHoldType

CalibrationType

SensorCapabilities

get_sensor_capabilities 会保留未知能力位。SetDpiParameters::for_sensor 只使用 DPI_Y 和 LOD 来准备写入。

SensorCapabilitiesInfo

DpiRange

相邻的步进范围可以共享一个端点。

DpiParameters

SetDpiParameters

SetDpiParameters::for_sensor(capabilities, dpi_x, dpi_y, lod) 仅在存在 DPI_Y 时发送 Y 值，并仅在存在 LOD 时发送 LOD。原始 setter 不检查能力或 DPI 范围。

ShowDpiStatus

DpiCalibrationInfo

StartDpiCalibration

DpiCalibrationCorrection

Adjust(0) 与 RevertToOob 使用相同的线值。超出范围的调整会返回 Hidpp20Error::Feature(ErrorType::InvalidArgument)。

事件

ExtendedDpiFeature 实现了 EmittingFeature<ExtendedDpiEvent>。设备发送主动报告前，调用 listen()。

DpiParametersChanged

ExtendedDpiEvent::ParametersChanged 报告由设备发起的 DPI 参数变更。

DpiCalibrationCompleted

ExtendedDpiEvent::CalibrationCompleted 报告校准完成或超时。

使用 DpiCalibrationCompleted::failed() 检查 i16::MIN 失败哨兵。

线格式

函数 0～5 和 8 使用 3 字节短请求。函数 6、7、9 和 10 使用 16 字节长请求。OpenLogi 会将长请求中未指定的字节写为零。下面所有多字节字段均采用 BE 字节序。

get_sensor_count（fn 0）

请求：[0x00, 0x00, 0x00]。

get_sensor_capabilities（fn 1）

请求：[sensor_index, 0x00, 0x00]。

get_sensor_dpi_ranges（fn 2）

请求：[sensor_index, direction, page]。direction 的 X 为 0，Y 为 1。page 从 0 开始。

字面值的最高 3 位不是 0b111。最高 3 位为 0b111 的字携带相邻字面端点之间的正步长。0x0000 终止完整数据流。OpenLogi 最多读取 16 页，忽略首个终止符之后的字节，并拒绝格式错误或未终止的范围。

get_sensor_dpi_list（fn 3）

请求：[sensor_index, direction, 0x00]。

此函数仅在具有 SensorCapabilities::PROFILE 时有意义。完整列表可以没有终止符。OpenLogi 会保留列出的顺序和重复值。

get_sensor_lod_list（fn 4）

请求：[sensor_index, 0x00, 0x00]。

调用者提供 dpi_level_count，通常来自 fn 1。列表没有终止符。OpenLogi 只读取该数量的条目，并拒绝未知 LOD 或不可能的长度。它会忽略剩余载荷字节。

get_sensor_dpi_parameters（fn 5）

请求：[sensor_index, 0x00, 0x00]。

OpenLogi 要求此函数使用长回复。短回复会返回 Hidpp20Error::UnsupportedResponse。

set_sensor_dpi_parameters（fn 6）

OpenLogi 要求回复的字节 0 回显 sensor_index。SetDpiParameters::for_sensor 会为不支持的 Y 和 LOD 字段生成必需的零值。

show_sensor_dpi_status（fn 7）

此函数只在主机模式下有效。OpenLogi 要求回复的字节 0 回显 sensor_index。

get_dpi_calibration_info（fn 8）

请求：[sensor_index, 0x00, 0x00]。

OpenLogi 要求此函数使用长回复。短回复会返回 Hidpp20Error::UnsupportedResponse。

start_dpi_calibration（fn 9）

此函数需要 SensorCapabilities::CALIBRATION。设备通过 CalibrationCompleted 事件报告结果。软件校准随后使用 fn 10 应用校正值。OpenLogi 要求回复的字节 0 回显 sensor_index。

set_dpi_calibration（fn 10）

OpenLogi 会在发送前验证 Adjust 的范围。它要求回复的字节 0 回显 sensor_index。

事件

主动报告使用子 ID 0 或 1。OpenLogi 解码前 6 个载荷字节，并忽略字节 6～15。

ParametersChanged（sub-id 0）

CalibrationCompleted（sub-id 1）

未知事件子 ID 不会生成 ExtendedDpiEvent。

OpenLogi 的用法

设备未公开 0x2201 时，设备层才使用 0x2202。它只操作传感器 0。它通过 fn 5 读取 X DPI，并通过 fn 2 读取 X 轴范围。它不使用配置文件列表、LOD 列表、LED 或校准函数。

写入 DPI 前，OpenLogi 会展平设备报告的 X 轴范围。请求值不在该列表中时，它返回 WriteError::DpiUnsupported。它读取传感器能力和当前参数。SetDpiParameters::for_sensor 仅在具有 DPI_Y 时写入等于 X 的 Y 值。它仅在具有 LOD 时保留当前 LOD；否则写入零。fn 6 的确认回复必须回显传感器。

每次确认写入后，OpenLogi 都读取 X DPI，并重试一次。第二次读到不同值时，它返回 WriteError::DpiNotApplied。读取失败不会撤销已确认的写入。桌面端会在异步写入前保存请求，因此被拒绝或未应用的写入可能会保留在桌面端状态中，直到后续实时读取。

从 v0.8.14 起，库存监听器会识别主动 fn 0 DPI 参数广播。它增加设备设置修订号，因此客户端会重新读取权威设置。监听器不会解码事件载荷，也不会持久化设备发起的变更。它会忽略 fn 1 校准完成广播。

传感器设置是易失性的，因此代理会在重连后重新应用保存的 DPI。OpenLogi 退出时不会执行此功能的专用重置。面向用户的控制见 DPI 页面。

Rust 用法

use hidpp::{
    device::Device,
    feature::{
        EmittingFeature,
        extended_dpi::{DpiDirection, ExtendedDpiFeature, SetDpiParameters},
    },
    protocol::v20::Hidpp20Error,
};

async fn inspect_extended_dpi(device: &mut Device) -> Result<(), Hidpp20Error> {
    device.enumerate_features().await?;
    if let Some(feature) = device.get_feature::<ExtendedDpiFeature>() {
        let capabilities = feature.get_sensor_capabilities(0).await?;
        let ranges = feature.get_sensor_dpi_ranges(0, DpiDirection::X).await?;
        let current = feature.get_sensor_dpi_parameters(0).await?;

        println!("X ranges: {ranges:?}");
        let write = SetDpiParameters::for_sensor(
            capabilities.capabilities,
            1600,
            1600,
            current.lod,
        );
        feature.set_sensor_dpi_parameters(0, write).await?;

        let events = feature.listen();
        if let Ok(event) = events.recv().await {
            println!("DPI event: {event:?}");
        }
    }

    Ok(())
}