OpenLogi

0x2100 · verticalScrolling

Read the roller type, ratchets per turn, and preferred scroll amount reported by a device's vertical wheel.

verticalScrolling reports physical and preferred scrolling properties for a vertical wheel. OpenLogi v0.8.15 provides a typed, read-only wrapper, but no device-layer or user-facing feature consumes this information.

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

Function reference

VerticalScrollingFeature (0x2100) supports feature version 0 and exposes one asynchronous read method.

Methods

FunctionHID++ fnSignatureReturns
get_roller_info0()Result<RollerInfo, Hidpp20Error>

Types

RollerInfo

FieldTypeDescription
roller_typeRollerTypeMechanical roller type.
ratchets_per_turnu8Physical ratchets in one full wheel turn.
scroll_linesScrollLinesPreferred scroll amount.

RollerType

VariantValueDescription
Standard0x01Standard one- or two-dimensional roller.
ThreeG0x033G roller.
MicroRatchet0x04Micro-ratchet roller.
Touchpad0x05Touchpad scrolling.
TouchpadNaturalDefault0x06Touchpad with natural scrolling enabled by default.

ScrollLines

VariantValueDescription
SystemDefault0x00Keep the host system setting.
Lines(u8)0x01–0xFEScroll this many lines per movement.
Page0xFFScroll one full page or screen per movement.

Events

This feature defines no events.

Wire format

OpenLogi sends a three-byte zero request and expands the reply to a 16-byte buffer before decoding it. The defined fields occupy bytes 0–2.

get_roller_info (fn 0)

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

Response:

ByteFieldNotes
0roller_typeRollerType value. OpenLogi rejects an unknown value with Hidpp20Error::UnsupportedResponse.
1ratchets_per_turnRaw u8 count.
2scroll_lines0x00 is SystemDefault; 0xFF is Page; every other value is Lines(value).
3–15ReservedOpenLogi ignores these bytes.

How OpenLogi uses it

The feature registry instantiates VerticalScrollingFeature for feature 0x2100 at version 0 or later. The v0.8.15 device, inventory, session, agent, and desktop layers have no consumer for RollerInfo. OpenLogi therefore performs no write, read-back, capability gate, state restore, or user-facing action for this feature.

Usage (Rust)

use std::sync::Arc;

use hidpp::{
    channel::HidppChannel,
    device::Device,
    feature::vertical_scrolling::VerticalScrollingFeature,
};

async fn read_roller_info(
    channel: Arc<HidppChannel>,
    device_index: u8,
) -> Result<(), Box<dyn std::error::Error>> {
    let mut device = Device::new(channel, device_index).await?;
    device.enumerate_features().await?;

    let Some(feature) = device.get_feature::<VerticalScrollingFeature>() else {
        return Ok(());
    };
    let info = feature.get_roller_info().await?;
    println!("{info:?}");
    Ok(())
}

On this page