0x6100 · touchpadRawXY
Query an integrated touchpad and receive raw multi-touch frames after enabling raw reporting.
0x6100 exposes raw multi-touch frames from an integrated touchpad. It reports touchpad geometry, sensor properties, and the active raw-report flags. A frame contains two touch points, so a frame with more contacts spans multiple reports with one timestamp.
Spec: Logitech HID++ 2.0 — touchpadRawXY (v0). Used by: Not used by OpenLogi outside the typed
openlogi-hidppwrapper.
Function reference
TouchpadRawXyFeature implements feature version 0.
Methods
| Function | HID++ fn | Signature | Returns |
|---|---|---|---|
get_touchpad_info | 0 | () | TouchpadInfo |
get_raw_report_state | 1 | () | RawReportFlags |
set_raw_report_state | 2 | (flags: RawReportFlags) | () |
listen | event | () | async_channel::Receiver<TouchpadRawEvent> |
The first three methods are async and return Result<…, Hidpp20Error>. listen is synchronous.
Types
TouchpadInfo
| Field | Type | Description |
|---|---|---|
x_size | u16 | Pad width in native coordinate units. |
y_size | u16 | Pad height in native coordinate units. |
z_data_range | u8 | Z-data range. 0x00 means none and 0x0f means 16-bit. |
area_data_range | u8 | Area-data range. 0x0f means 16-bit. |
timestamp_units | u8 | Timestamp increment in 0.1 ms units. |
max_finger_count | u8 | Maximum tracked contacts. |
origin | Origin | Coordinate origin. |
pen_support | bool | Pen input support. |
raw_report_mapping_version | u8 | Raw-report mapping version. |
dpi | u16 | Native sensor DPI. |
RawReportFlags
| Field | Value | Description |
|---|---|---|
RAW | 1 << 0 | Enable raw reporting. |
FORCE_ADD | 1 << 1 | Add force data to 16-bit reporting. Deprecated. |
ENHANCED | 1 << 2 | Enable enhanced reporting. |
WIDTH_HEIGHT | 1 << 3 | Report width and height instead of area. |
NATIVE_GESTURE | 1 << 4 | Report native gestures. |
MAJOR_MINOR | 1 << 5 | Report major, minor, and orientation data. |
WIDTH_HEIGHT_8BIT | 1 << 6 | Report 8-bit width and height bytes instead of area. |
Some combinations are mutually exclusive. Common valid bitmaps are 0x00, 0x05, 0x09, 0x21, and 0x41. The wrapper retains an unknown bit in a read value. It writes every bit in a caller-supplied RawReportFlags value unchanged.
Origin
| Variant | Value | Description |
|---|---|---|
LowerLeft | 1 | Lower-left corner. |
LowerRight | 2 | Lower-right corner. |
UpperLeft | 3 | Upper-left corner. |
UpperRight | 4 | Upper-right corner. |
DualXyData and TouchPoint
| Field | Type | Description |
|---|---|---|
timestamp | u16 | Running frame timestamp. |
touch1 | TouchPoint | First point in the report. |
touch2 | TouchPoint | Second point in the report. |
button | bool | Physical surface switch state. |
end_of_frame | bool | This report completes the frame. |
finger_count | u8 | Total contacts in the frame. |
contact_type | u8 | Two-bit type. 0 is a finger; other values are reserved. |
contact_status | u8 | Two-bit status. 0 is hover; 1 is touch; other values are reserved. |
x | u16 | 14-bit X coordinate. |
y | u16 | 14-bit Y coordinate. |
finger_id | u8 | Four-bit contact ID. |
z | u8 | Z distance or force MSB, depending on flags. |
area | u8 | Area, force LSB, or other flag-selected data. |
Events
TouchpadRawXyFeature implements EmittingFeature<TouchpadRawEvent>. It accepts only event sub-ID 0.
| Variant | Description |
|---|---|
DualXy(DualXyData) | A raw report with two touch-point slots. |
Wire format
All three functions send three-byte requests. OpenLogi reads extended response payloads and ignores response bytes not listed below.
get_touchpad_info (fn 0)
| Bytes | Field | Notes |
|---|---|---|
| 0–1 | x_size | u16, BE. |
| 2–3 | y_size | u16, BE. |
| 4 | z_data_range | Raw u8. |
| 5 | area_data_range | Raw u8. |
| 6 | timestamp_units | Raw u8, in 0.1 ms units. |
| 7 | max_finger_count | Raw u8. |
| 8 | origin | Values 1–4 map to Origin. Other values return Hidpp20Error::UnsupportedResponse. |
| 9 | pen_support | Nonzero is true. |
| 10–11 | — | OpenLogi ignores these bytes. |
| 12 | raw_report_mapping_version | Raw u8. |
| 13–14 | dpi | u16, BE. |
| 15 | — | OpenLogi ignores this byte. |
get_raw_report_state (fn 1)
| Bytes | Field | Notes |
|---|---|---|
| 0 | RawReportFlags | All bits, including unknown bits, are retained. |
| 1–15 | — | OpenLogi ignores these bytes. |
set_raw_report_state (fn 2)
| Byte | Field | Notes |
|---|---|---|
| 0 | flags | Exact RawReportFlags::bits() value. |
| 1–2 | — | OpenLogi writes 0x00. |
OpenLogi accepts a successful transport reply and does not decode its payload.
DualXy event (fn 0)
The event payload is 16 bytes. coord14(high, low) is (high & 0x3f) << 8 | low.
| Bytes | Field | Notes |
|---|---|---|
| 0–1 | timestamp | u16, BE. |
2 bits[7:6], 3 | touch1.contact_type, touch1.x | Type and 14-bit X coordinate. |
4 bits[7:6], 5 | touch1.contact_status, touch1.y | Status and 14-bit Y coordinate. |
| 6, 7 | touch1.z, touch1.area | Raw, flag-dependent bytes. |
8 bits[7:4] | touch1.finger_id | Four-bit ID. |
8 bit[2] | button | Physical switch state. |
8 bit[0] | end_of_frame | Frame completion state. |
8 bits[3,1] | — | OpenLogi ignores these bits. |
9 bits[7:6], 10 | touch2.contact_type, touch2.x | Type and 14-bit X coordinate. |
11 bits[7:6], 12 | touch2.contact_status, touch2.y | Status and 14-bit Y coordinate. |
| 13, 14 | touch2.z, touch2.area | Raw, flag-dependent bytes. |
15 bits[7:4] | touch2.finger_id | Four-bit ID. |
15 bits[3:0] | finger_count | Four-bit contact count. |
How OpenLogi uses it
No device-layer or agent path uses TouchpadRawXyFeature in v0.8.15. The typed wrapper does not change report flags, read them back, or restore them for OpenLogi users.
Usage (Rust)
use hidpp::{
device::Device,
feature::{
EmittingFeature,
touchpad_raw_xy::{RawReportFlags, TouchpadRawXyFeature},
},
};
// device: &mut Device, already created via Device::new(channel, index)
device.enumerate_features().await?;
if let Some(feature) = device.get_feature::<TouchpadRawXyFeature>() {
println!("{:?}", feature.get_touchpad_info().await?);
feature.set_raw_report_state(RawReportFlags::RAW).await?;
let receiver = feature.listen();
while let Ok(event) = receiver.recv().await {
println!("{event:?}");
}
}