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-hidppwrapper.
Function reference
TouchMouseRawFeature implements feature version 0.
Methods
| Function | HID++ fn | Signature | Returns |
|---|---|---|---|
get_touchpad_info | 0 | () | TouchMouseInfo |
get_raw_mode | 1 | () | RawMode |
set_raw_mode | 2 | (mode: RawMode) | () |
listen | event | () | async_channel::Receiver<TouchMouseRawEvent> |
The first three methods are async and return Result<…, Hidpp20Error>. listen is synchronous.
Types
TouchMouseInfo
| Field | Type | Description |
|---|---|---|
x_max_count | u16 | Maximum X count in dots. |
y_max_count | u16 | Maximum Y count in dots. |
resolution_dpi | u16 | Sensor DPI. The wrapper assumes equal X and Y resolution. |
origin | Origin | Coordinate origin. |
max_finger_count | u8 | Maximum reported contacts. |
width_height_data_range | u8 | Maximum width or height data value. |
RawMode
| Variant | Value | Description |
|---|---|---|
NativeGestures | 0 | Native gestures only. |
RawFiltered | 1 | Filtered raw data. |
RawUnfilteredAndGestures | 2 | Unfiltered raw data and native gestures. |
RawUnfilteredAlways | 3 | Unfiltered data, including while lifted or with a button active. |
RawUnfilteredWithZ | 4 | Mode 2 with Z data in place of width. |
Origin
| Variant | Value | Description |
|---|---|---|
LowerLeft | 1 | Lower-left corner. |
LowerRight | 2 | Lower-right corner. |
UpperLeft | 3 | Upper-left corner. |
UpperRight | 4 | Upper-right corner. |
TouchMousePoint and TouchMouseStatus
| Field | Type | Description |
|---|---|---|
x | u16 | 12-bit X coordinate. |
y | u16 | 12-bit Y coordinate. |
width_x | u8 | Four-bit X width, or Z in RawUnfilteredWithZ. |
width_y | u8 | Four-bit Y width. |
MOUSE_LIFTED | 1 << 0 | The mouse is lifted. |
BUTTON_DOWN | 1 << 1 | A mouse button is down. |
TouchMouseStatus retains unknown flag bits from an event.
Constants
| Field | Value | Description |
|---|---|---|
TOUCH_POINT_COUNT | 4 | Number of raw touch-point slots in one event. |
Events
TouchMouseRawFeature implements EmittingFeature<TouchMouseRawEvent>. It accepts event sub-IDs 0 and 1.
| Variant | Description |
|---|---|
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)
| Bytes | Field | Notes |
|---|---|---|
| 0–1 | x_max_count | u16, BE. |
| 2–3 | y_max_count | u16, BE. |
| 4–5 | resolution_dpi | u16, BE. |
| 6 | origin | Values 1–4 map to Origin. Other values return Hidpp20Error::UnsupportedResponse. |
| 7 | max_finger_count | Raw u8. |
| 8 | width_height_data_range | Raw u8. |
| 9–15 | — | OpenLogi ignores these bytes. |
get_raw_mode (fn 1)
| Bytes | Field | Notes |
|---|---|---|
| 0 | RawMode | Values 0–4 map to named variants. Other values return Hidpp20Error::UnsupportedResponse. |
| 1–15 | — | OpenLogi ignores these bytes. |
set_raw_mode (fn 2)
| Byte | Field | Notes |
|---|---|---|
| 0 | mode | The 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.
| Offset | Field | Notes |
|---|---|---|
| 0 | x_high | X bits 11:4, unless 0xff marks a lifted contact. |
| 1 | y_high | Y bits 11:4. |
2 bits[3:0] | X low nibble | Combined with x_high. |
2 bits[7:4] | Y low nibble | Combined with y_high. |
3 bits[3:0] | width_x | Four-bit width or Z. |
3 bits[7:4] | width_y | Four-bit width. |
Coordinates are x = (x_high << 4) | low_nibble and y = (y_high << 4) | high_nibble.
StatusChanged event (fn 1)
| Bytes | Field | Notes |
|---|---|---|
0 bit[0] | MOUSE_LIFTED | Mouse lifted state. |
0 bit[1] | BUTTON_DOWN | Button-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:?}");
}
}