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
| Function | HID++ fn | Signature | Returns |
|---|---|---|---|
get_roller_info | 0 | () | Result<RollerInfo, Hidpp20Error> |
Types
RollerInfo
| Field | Type | Description |
|---|---|---|
roller_type | RollerType | Mechanical roller type. |
ratchets_per_turn | u8 | Physical ratchets in one full wheel turn. |
scroll_lines | ScrollLines | Preferred scroll amount. |
RollerType
| Variant | Value | Description |
|---|---|---|
Standard | 0x01 | Standard one- or two-dimensional roller. |
ThreeG | 0x03 | 3G roller. |
MicroRatchet | 0x04 | Micro-ratchet roller. |
Touchpad | 0x05 | Touchpad scrolling. |
TouchpadNaturalDefault | 0x06 | Touchpad with natural scrolling enabled by default. |
ScrollLines
| Variant | Value | Description |
|---|---|---|
SystemDefault | 0x00 | Keep the host system setting. |
Lines(u8) | 0x01–0xFE | Scroll this many lines per movement. |
Page | 0xFF | Scroll 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:
| Byte | Field | Notes |
|---|---|---|
| 0 | roller_type | RollerType value. OpenLogi rejects an unknown value with Hidpp20Error::UnsupportedResponse. |
| 1 | ratchets_per_turn | Raw u8 count. |
| 2 | scroll_lines | 0x00 is SystemDefault; 0xFF is Page; every other value is Lines(value). |
| 3–15 | Reserved | OpenLogi 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(())
}