OpenLogi

0x6110 · touchMouseRawTouchPoints

Query a touch mouse and select a raw mode to receive four raw touch-point slots per event.

0x6110 exposes raw touch points from a touch mouse surface. It reports surface geometry, resolution, origin, and touch-point limits. A selected raw mode enables raw data, while status events remain a separate event type.

Spec: Logitech HID++ 2.0 — touchMouseRawTouchPoints (v0). Used by: Not used by OpenLogi outside the typed openlogi-hidpp wrapper.

Function reference

TouchMouseRawFeature implements feature version 0.

Methods

FunctionHID++ fnSignatureReturns
get_touchpad_info0()TouchMouseInfo
get_raw_mode1()RawMode
set_raw_mode2(mode: RawMode)()
listenevent()async_channel::Receiver<TouchMouseRawEvent>

The first three methods are async and return Result<…, Hidpp20Error>. listen is synchronous.

Types

TouchMouseInfo

FieldTypeDescription
x_max_countu16Maximum X count in dots.
y_max_countu16Maximum Y count in dots.
resolution_dpiu16Sensor DPI. The wrapper assumes equal X and Y resolution.
originOriginCoordinate origin.
max_finger_countu8Maximum reported contacts.
width_height_data_rangeu8Maximum width or height data value.

RawMode

VariantValueDescription
NativeGestures0Native gestures only.
RawFiltered1Filtered raw data.
RawUnfilteredAndGestures2Unfiltered raw data and native gestures.
RawUnfilteredAlways3Unfiltered data, including while lifted or with a button active.
RawUnfilteredWithZ4Mode 2 with Z data in place of width.

Origin

VariantValueDescription
LowerLeft1Lower-left corner.
LowerRight2Lower-right corner.
UpperLeft3Upper-left corner.
UpperRight4Upper-right corner.

TouchMousePoint and TouchMouseStatus

FieldTypeDescription
xu1612-bit X coordinate.
yu1612-bit Y coordinate.
width_xu8Four-bit X width, or Z in RawUnfilteredWithZ.
width_yu8Four-bit Y width.
MOUSE_LIFTED1 << 0The mouse is lifted.
BUTTON_DOWN1 << 1A mouse button is down.

TouchMouseStatus retains unknown flag bits from an event.

Constants

FieldValueDescription
TOUCH_POINT_COUNT4Number of raw touch-point slots in one event.

Events

TouchMouseRawFeature implements EmittingFeature<TouchMouseRawEvent>. It accepts event sub-IDs 0 and 1.

VariantDescription
RawData { touches }Four Option<TouchMousePoint> slots indexed by finger ID 0–3.
StatusChanged(TouchMouseStatus)A raw mouse-status flag update.

Wire format

Getters send three zero bytes. The setter sends its mode then two zero bytes. OpenLogi reads extended response payloads and ignores bytes not listed below.

get_touchpad_info (fn 0)

BytesFieldNotes
0–1x_max_countu16, BE.
2–3y_max_countu16, BE.
4–5resolution_dpiu16, BE.
6originValues 1–4 map to Origin. Other values return Hidpp20Error::UnsupportedResponse.
7max_finger_countRaw u8.
8width_height_data_rangeRaw u8.
9–15—OpenLogi ignores these bytes.

get_raw_mode (fn 1)

BytesFieldNotes
0RawModeValues 0–4 map to named variants. Other values return Hidpp20Error::UnsupportedResponse.
1–15—OpenLogi ignores these bytes.

set_raw_mode (fn 2)

ByteFieldNotes
0modeThe RawMode value.
1–2—OpenLogi writes 0x00.

OpenLogi accepts a successful transport reply and does not decode its payload.

RawData event (fn 0)

The event has four contiguous four-byte slots. For slot i, the bytes start at i * 4. An x_high value of 0xff produces None for that slot.

OffsetFieldNotes
0x_highX bits 11:4, unless 0xff marks a lifted contact.
1y_highY bits 11:4.
2 bits[3:0]X low nibbleCombined with x_high.
2 bits[7:4]Y low nibbleCombined with y_high.
3 bits[3:0]width_xFour-bit width or Z.
3 bits[7:4]width_yFour-bit width.

Coordinates are x = (x_high << 4) | low_nibble and y = (y_high << 4) | high_nibble.

StatusChanged event (fn 1)

BytesFieldNotes
0 bit[0]MOUSE_LIFTEDMouse lifted state.
0 bit[1]BUTTON_DOWNButton-down state.
0 bits[7:2]—Retained by TouchMouseStatus without named semantics.
1–15—OpenLogi ignores these bytes.

How OpenLogi uses it

No device-layer or agent path uses TouchMouseRawFeature in v0.8.15. The typed wrapper does not select a raw mode, read it back, or restore it for OpenLogi users.

Usage (Rust)

use hidpp::{
    device::Device,
    feature::{
        EmittingFeature,
        touch_mouse_raw::{RawMode, TouchMouseRawFeature},
    },
};

// device: &mut Device, already created via Device::new(channel, index)
device.enumerate_features().await?;
if let Some(feature) = device.get_feature::<TouchMouseRawFeature>() {
    println!("{:?}", feature.get_touchpad_info().await?);
    feature.set_raw_mode(RawMode::RawFiltered).await?;

    let receiver = feature.listen();
    while let Ok(event) = receiver.recv().await {
        println!("{event:?}");
    }
}

On this page