0x6110 · touchMouseRawTouchPoints

Exposes the raw touch-point data produced by a touch mouse's pad surface. get_touchpad_info returns the pad characteristics: X/Y extent in dots, sensor resolution in DPI, coordinate Origin, maximum finger count, and the width/height data range. get_raw_mode / set_raw_mode control whether the firmware delivers native gestures, filtered raw data, or one of three unfiltered modes (including a Z-axis variant).

Once a raw mode is active, the feature emits up to four simultaneous touch points per RawData event, each carrying 12-bit X/Y coordinates and 4-bit contact-width fields; a lifted finger is None. StatusChanged reports MOUSE_LIFTED and BUTTON_DOWN flag transitions independently of raw-data reporting.

• RawMode — NativeGestures · RawFiltered · RawUnfilteredAndGestures · RawUnfilteredAlways · RawUnfilteredWithZ.
• TouchMousePoint — 12-bit x / y, 4-bit width_x / width_y (replaced by Z in RawUnfilteredWithZ mode).
• TouchMouseStatus — bitflags: MOUSE_LIFTED, BUTTON_DOWN.
• Origin — corner of the pad that holds the coordinate origin.

Spec: Logitech HID++ 2.0 — touchMouseRawTouchPoints. Used by: Typed wrapper in openlogi-hidpp.

Function reference

The TouchMouseRawFeature wrapper (0x6110) exposes:

Methods

All async methods return Result<…, Hidpp20Error>. listen is synchronous and returns a channel receiver.

Types

TouchMouseInfo

Touch-mouse characteristics returned by get_touchpad_info.

RawMode

The raw-reporting mode of a touch mouse.

Origin

The position of the touch surface's coordinate origin, viewed from above.

Events

TouchMouseRawFeature implements EmittingFeature<TouchMouseRawEvent>. Call listen() to receive a channel of TouchMouseRawEvent values.

TouchMouseRawEvent

TouchMousePoint

A single touch point in a RawData event. The finger ID is the point's index (0..4) in the touches array.

TouchMouseStatus

Mouse status flags carried by StatusChanged.

Wire format

Getter requests carry a 3-byte zero payload; set_raw_mode encodes the mode in the first byte. All responses use the 16-byte long payload. Events are pushed by the device unsolicited; no request is sent.

get_touchpad_info (fn 0)

Request: [0x00, 0x00, 0x00]

Response (byte → field):

get_raw_mode (fn 1)

Request: [0x00, 0x00, 0x00]

Response (byte → field):

set_raw_mode (fn 2)

Request: [mode, 0x00, 0x00] — mode is the u8 representation of RawMode.

Response: acknowledged (no payload fields used).

Event — RawData (event fn 0)

The 16-byte payload carries four touch points packed consecutively (4 bytes each, indices 0..3).

Per touch point (bytes i*4 … i*4+3):

Assembled: x = (x_high << 4) \| (low_nibbles & 0x0f) (12-bit); y = (y_high << 4) \| (low_nibbles >> 4) (12-bit).

Event — StatusChanged (event fn 1)

Bytes 1–15 are unused.

Usage (Rust)

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

// device: &mut Device, already created via Device::new(channel, index)
device.enumerate_features().await?;
if let Some(feat) = device.get_feature::<TouchMouseRawFeature>() {
    // Read pad geometry and capabilities.
    let info = feat.get_touchpad_info().await?;
    println!("pad {}x{} dots @ {} DPI", info.x_max_count, info.y_max_count, info.resolution_dpi);

    // Enable filtered raw-data reporting.
    feat.set_raw_mode(RawMode::RawFiltered).await?;

    // Receive raw touch events.
    let rx = feat.listen();
    while let Ok(event) = rx.recv().await {
        match event {
            TouchMouseRawEvent::RawData { touches } => {
                for (id, point) in touches.iter().enumerate() {
                    if let Some(p) = point {
                        println!("finger {} at ({}, {})", id, p.x, p.y);
                    }
                }
            }
            TouchMouseRawEvent::StatusChanged(status) => {
                println!("status: {:?}", status);
            }
        }
    }
}