#!/bin/env python3
# SPDX-License-Identifier: GPL-2.0
# -*- coding: utf-8 -*-
#
# Copyright (c) 2017 Benjamin Tissoires <[email protected]>
# Copyright (c) 2017 Red Hat, Inc.
# Copyright (c) 2020 Wacom Technology Corp.
#
# Authors:
# Jason Gerecke <[email protected]>
"""
Tests for the Wacom driver generic codepath.
This module tests the function of the Wacom driver's generic codepath.
The generic codepath is used by devices which are not explicitly listed
in the driver's device table. It uses the device's HID descriptor to
decode reports sent by the device.
"""
from .descriptors_wacom import (
wacom_pth660_v145,
wacom_pth660_v150,
wacom_pth860_v145,
wacom_pth860_v150,
wacom_pth460_v105,
)
import attr
from collections import namedtuple
from enum import Enum
from hidtools.hut import HUT
from hidtools.hid import HidUnit
from . import base
from . import test_multitouch
import libevdev
import pytest
import logging
logger = logging.getLogger("hidtools.test.wacom")
KERNEL_MODULE = ("wacom", "wacom")
class ProximityState(Enum):
"""
Enumeration of allowed proximity states.
"""
# Tool is not able to be sensed by the device
OUT = 0
# Tool is close enough to be sensed, but some data may be invalid
# or inaccurate
IN_PROXIMITY = 1
# Tool is close enough to be sensed with high accuracy. All data
# valid.
IN_RANGE = 2
def fill(self, reportdata):
"""Fill a report with approrpiate HID properties/values."""
reportdata.inrange = self in [ProximityState.IN_RANGE]
reportdata.wacomsense = self in [
ProximityState.IN_PROXIMITY,
ProximityState.IN_RANGE,
]
class ReportData:
"""
Placeholder for HID report values.
"""
pass
@attr.s
class Buttons:
"""
Stylus button state.
Describes the state of each of the buttons / "side switches" that
may be present on a stylus. Buttons set to 'None' indicate the
state is "unchanged" since the previous event.
"""
primary = attr.ib(default=None)
secondary = attr.ib(default=None)
tertiary = attr.ib(default=None)
@staticmethod
def clear():
"""Button object with all states cleared."""
return Buttons(False, False, False)
def fill(self, reportdata):
"""Fill a report with approrpiate HID properties/values."""
reportdata.barrelswitch = int(self.primary or 0)
reportdata.secondarybarrelswitch = int(self.secondary or 0)
reportdata.b3 = int(self.tertiary or 0)
@attr.s
class ToolID:
"""
Stylus tool identifiers.
Contains values used to identify a specific stylus, e.g. its serial
number and tool-type identifier. Values of ``0`` may sometimes be
used for the out-of-range condition.
"""
serial = attr.ib()
tooltype = attr.ib()
@staticmethod
def clear():
"""ToolID object with all fields cleared."""
return ToolID(0, 0)
def fill(self, reportdata):
"""Fill a report with approrpiate HID properties/values."""
reportdata.transducerserialnumber = self.serial & 0xFFFFFFFF
reportdata.serialhi = (self.serial >> 32) & 0xFFFFFFFF
reportdata.tooltype = self.tooltype
@attr.s
class PhysRange:
"""
Range of HID physical values, with units.
"""
unit = attr.ib()
min_size = attr.ib()
max_size = attr.ib()
CENTIMETER = HidUnit.from_string("SILinear: cm")
DEGREE = HidUnit.from_string("EnglishRotation: deg")
def contains(self, field):
"""
Check if the physical size of the provided field is in range.
Compare the physical size described by the provided HID field
against the range of sizes described by this object. This is
an exclusive range comparison (e.g. 0 cm is not within the
range 0 cm - 5 cm) and exact unit comparison (e.g. 1 inch is
not within the range 0 cm - 5 cm).
"""
phys_size = (field.physical_max - field.physical_min) * 10 ** (field.unit_exp)
return (
field.unit == self.unit.value
and phys_size > self.min_size
and phys_size < self.max_size
)
class BaseTablet(base.UHIDTestDevice):
"""
Skeleton object for all kinds of tablet devices.
"""
def __init__(self, rdesc, name=None, info=None):
assert rdesc is not None
super().__init__(name, "Pen", input_info=info, rdesc=rdesc)
self.buttons = Buttons.clear()
self.toolid = ToolID.clear()
self.proximity = ProximityState.OUT
self.offset = 0
self.ring = -1
self.ek0 = False
def match_evdev_rule(self, application, evdev):
"""
Filter out evdev nodes based on the requested application.
The Wacom driver may create several device nodes for each USB
interface device. It is crucial that we run tests with the
expected device node or things will obviously go off the rails.
Use the Wacom driver's usual naming conventions to apply a
sensible default filter.
"""
if application in ["Pen", "Pad"]:
return evdev.name.endswith(application)
else:
return True
def create_report(
self, x, y, pressure, buttons=None, toolid=None, proximity=None, reportID=None
):
"""
Return an input report for this device.
:param x: absolute x
:param y: absolute y
:param pressure: pressure
:param buttons: stylus button state. Use ``None`` for unchanged.
:param toolid: tool identifiers. Use ``None`` for unchanged.
:param proximity: a ProximityState indicating the sensor's ability
to detect and report attributes of this tool. Use ``None``
for unchanged.
:param reportID: the numeric report ID for this report, if needed
"""
if buttons is not None:
self.buttons = buttons
buttons = self.buttons
if toolid is not None:
self.toolid = toolid
toolid = self.toolid
if proximity is not None:
self.proximity = proximity
proximity = self.proximity
reportID = reportID or self.default_reportID
report = ReportData()
report.x = x
report.y = y
report.tippressure = pressure
report.tipswitch = pressure > 0
buttons.fill(report)
proximity.fill(report)
toolid.fill(report)
return super().create_report(report, reportID=reportID)
def create_report_heartbeat(self, reportID):
"""
Return a heartbeat input report for this device.
Heartbeat reports generally contain battery status information,
among other things.
"""
report = ReportData()
report.wacombatterycharging = 1
return super().create_report(report, reportID=reportID)
def create_report_pad(self, reportID, ring, ek0):
report = ReportData()
if ring is not None:
self.ring = ring
ring = self.ring
if ek0 is not None:
self.ek0 = ek0
ek0 = self.ek0
if ring >= 0:
report.wacomtouchring = ring
report.wacomtouchringstatus = 1
else:
report.wacomtouchring = 0x7F
report.wacomtouchringstatus = 0
report.wacomexpresskey00 = ek0
return super().create_report(report, reportID=reportID)
def event(self, x, y, pressure, buttons=None, toolid=None, proximity=None):
"""
Send an input event on the default report ID.
:param x: absolute x
:param y: absolute y
:param buttons: stylus button state. Use ``None`` for unchanged.
:param toolid: tool identifiers. Use ``None`` for unchanged.
:param proximity: a ProximityState indicating the sensor's ability
to detect and report attributes of this tool. Use ``None``
for unchanged.
"""
r = self.create_report(x, y, pressure, buttons, toolid, proximity)
self.call_input_event(r)
return [r]
def event_heartbeat(self, reportID):
"""
Send a heartbeat event on the requested report ID.
"""
r = self.create_report_heartbeat(reportID)
self.call_input_event(r)
return [r]
def event_pad(self, reportID, ring=None, ek0=None):
"""
Send a pad event on the requested report ID.
"""
r = self.create_report_pad(reportID, ring, ek0)
self.call_input_event(r)
return [r]
def get_report(self, req, rnum, rtype):
if rtype != self.UHID_FEATURE_REPORT:
return (1, [])
rdesc = None
for v in self.parsed_rdesc.feature_reports.values():
if v.report_ID == rnum:
rdesc = v
if rdesc is None:
return (1, [])
result = (1, [])
result = self.create_report_offset(rdesc) or result
return result
def create_report_offset(self, rdesc):
require = [
"Wacom Offset Left",
"Wacom Offset Top",
"Wacom Offset Right",
"Wacom Offset Bottom",
]
if not set(require).issubset(set([f.usage_name for f in rdesc])):
return None
report = ReportData()
report.wacomoffsetleft = self.offset
report.wacomoffsettop = self.offset
report.wacomoffsetright = self.offset
report.wacomoffsetbottom = self.offset
r = rdesc.create_report([report], None)
return (0, r)
class OpaqueTablet(BaseTablet):
"""
Bare-bones opaque tablet with a minimum of features.
A tablet stripped down to its absolute core. It is capable of
reporting X/Y position and if the pen is in contact. No pressure,
no barrel switches, no eraser. Notably it *does* report an "In
Range" flag, but this is only because the Wacom driver expects
one to function properly. The device uses only standard HID usages,
not any of Wacom's vendor-defined pages.
"""
# fmt: off
report_descriptor = [
0x05, 0x0D, # . Usage Page (Digitizer),
0x09, 0x01, # . Usage (Digitizer),
0xA1, 0x01, # . Collection (Application),
0x85, 0x01, # . Report ID (1),
0x09, 0x20, # . Usage (Stylus),
0xA1, 0x00, # . Collection (Physical),
0x09, 0x42, # . Usage (Tip Switch),
0x09, 0x32, # . Usage (In Range),
0x15, 0x00, # . Logical Minimum (0),
0x25, 0x01, # . Logical Maximum (1),
0x75, 0x01, # . Report Size (1),
0x95, 0x02, # . Report Count (2),
0x81, 0x02, # . Input (Variable),
0x95, 0x06, # . Report Count (6),
0x81, 0x03, # . Input (Constant, Variable),
0x05, 0x01, # . Usage Page (Desktop),
0x09, 0x30, # . Usage (X),
0x27, 0x80, 0x3E, 0x00, 0x00, # . Logical Maximum (16000),
0x47, 0x80, 0x3E, 0x00, 0x00, # . Physical Maximum (16000),
0x65, 0x11, # . Unit (Centimeter),
0x55, 0x0D, # . Unit Exponent (13),
0x75, 0x10, # . Report Size (16),
0x95, 0x01, # . Report Count (1),
0x81, 0x02, # . Input (Variable),
0x09, 0x31, # . Usage (Y),
0x27, 0x28, 0x23, 0x00, 0x00, # . Logical Maximum (9000),
0x47, 0x28, 0x23, 0x00, 0x00, # . Physical Maximum (9000),
0x81, 0x02, # . Input (Variable),
0xC0, # . End Collection,
0xC0, # . End Collection,
]
# fmt: on
def __init__(self, rdesc=report_descriptor, name=None, info=(0x3, 0x056A, 0x9999)):
super().__init__(rdesc, name, info)
self.default_reportID = 1
class OpaqueCTLTablet(BaseTablet):
"""
Opaque tablet similar to something in the CTL product line.
A pen-only tablet with most basic features you would expect from
an actual device. Position, eraser, pressure, barrel buttons.
Uses the Wacom vendor-defined usage page.
"""
# fmt: off
report_descriptor = [
0x06, 0x0D, 0xFF, # . Usage Page (Vnd Wacom Emr),
0x09, 0x01, # . Usage (Digitizer),
0xA1, 0x01, # . Collection (Application),
0x85, 0x10, # . Report ID (16),
0x09, 0x20, # . Usage (Stylus),
0x35, 0x00, # . Physical Minimum (0),
0x45, 0x00, # . Physical Maximum (0),
0x15, 0x00, # . Logical Minimum (0),
0x25, 0x01, # . Logical Maximum (1),
0xA1, 0x00, # . Collection (Physical),
0x09, 0x42, # . Usage (Tip Switch),
0x09, 0x44, # . Usage (Barrel Switch),
0x09, 0x5A, # . Usage (Secondary Barrel Switch),
0x09, 0x45, # . Usage (Eraser),
0x09, 0x3C, # . Usage (Invert),
0x09, 0x32, # . Usage (In Range),
0x09, 0x36, # . Usage (In Proximity),
0x25, 0x01, # . Logical Maximum (1),
0x75, 0x01, # . Report Size (1),
0x95, 0x07, # . Report Count (7),
0x81, 0x02, # . Input (Variable),
0x95, 0x01, # . Report Count (1),
0x81, 0x03, # . Input (Constant, Variable),
0x0A, 0x30, 0x01, # . Usage (X),
0x65, 0x11, # . Unit (Centimeter),
0x55, 0x0D, # . Unit Exponent (13),
0x47, 0x80, 0x3E, 0x00, 0x00, # . Physical Maximum (16000),
0x27, 0x80, 0x3E, 0x00, 0x00, # . Logical Maximum (16000),
0x75, 0x18, # . Report Size (24),
0x95, 0x01, # . Report Count (1),
0x81, 0x02, # . Input (Variable),
0x0A, 0x31, 0x01, # . Usage (Y),
0x47, 0x28, 0x23, 0x00, 0x00, # . Physical Maximum (9000),
0x27, 0x28, 0x23, 0x00, 0x00, # . Logical Maximum (9000),
0x81, 0x02, # . Input (Variable),
0x09, 0x30, # . Usage (Tip Pressure),
0x55, 0x00, # . Unit Exponent (0),
0x65, 0x00, # . Unit,
0x47, 0x00, 0x00, 0x00, 0x00, # . Physical Maximum (0),
0x26, 0xFF, 0x0F, # . Logical Maximum (4095),
0x75, 0x10, # . Report Size (16),
0x81, 0x02, # . Input (Variable),
0x75, 0x08, # . Report Size (8),
0x95, 0x06, # . Report Count (6),
0x81, 0x03, # . Input (Constant, Variable),
0x0A, 0x32, 0x01, # . Usage (Z),
0x25, 0x3F, # . Logical Maximum (63),
0x75, 0x08, # . Report Size (8),
0x95, 0x01, # . Report Count (1),
0x81, 0x02, # . Input (Variable),
0x09, 0x5B, # . Usage (Transducer Serial Number),
0x09, 0x5C, # . Usage (Transducer Serial Number Hi),
0x17, 0x00, 0x00, 0x00, 0x80, # . Logical Minimum (-2147483648),
0x27, 0xFF, 0xFF, 0xFF, 0x7F, # . Logical Maximum (2147483647),
0x75, 0x20, # . Report Size (32),
0x95, 0x02, # . Report Count (2),
0x81, 0x02, # . Input (Variable),
0x09, 0x77, # . Usage (Tool Type),
0x15, 0x00, # . Logical Minimum (0),
0x26, 0xFF, 0x0F, # . Logical Maximum (4095),
0x75, 0x10, # . Report Size (16),
0x95, 0x01, # . Report Count (1),
0x81, 0x02, # . Input (Variable),
0xC0, # . End Collection,
0xC0 # . End Collection
]
# fmt: on
def __init__(self, rdesc=report_descriptor, name=None, info=(0x3, 0x056A, 0x9999)):
super().__init__(rdesc, name, info)
self.default_reportID = 16
class PTHX60_Pen(BaseTablet):
"""
Pen interface of a PTH-660 / PTH-860 / PTH-460 tablet.
This generation of devices are nearly identical to each other, though
the PTH-460 uses a slightly different descriptor construction (splits
the pad among several physical collections)
"""
def __init__(self, rdesc=None, name=None, info=None):
super().__init__(rdesc, name, info)
self.default_reportID = 16
class BaseTest:
class TestTablet(base.BaseTestCase.TestUhid):
kernel_modules = [KERNEL_MODULE]
def sync_and_assert_events(
self, report, expected_events, auto_syn=True, strict=False
):
"""
Assert we see the expected events in response to a report.
"""
uhdev = self.uhdev
syn_event = self.syn_event
if auto_syn:
expected_events.append(syn_event)
actual_events = uhdev.next_sync_events()
self.debug_reports(report, uhdev, actual_events)
if strict:
self.assertInputEvents(expected_events, actual_events)
else:
self.assertInputEventsIn(expected_events, actual_events)
def get_usages(self, uhdev):
def get_report_usages(report):
application = report.application
for field in report.fields:
if field.usages is not None:
for usage in field.usages:
yield (field, usage, application)
else:
yield (field, field.usage, application)
desc = uhdev.parsed_rdesc
reports = [
*desc.input_reports.values(),
*desc.feature_reports.values(),
*desc.output_reports.values(),
]
for report in reports:
for usage in get_report_usages(report):
yield usage
def assertName(self, uhdev, type):
"""
Assert that the name is as we expect.
The Wacom driver applies a number of decorations to the name
provided by the hardware. We cannot rely on the definition of
this assertion from the base class to work properly.
"""
evdev = uhdev.get_evdev()
expected_name = uhdev.name + type
if "wacom" not in expected_name.lower():
expected_name = "Wacom " + expected_name
assert evdev.name == expected_name
def test_descriptor_physicals(self):
"""
Verify that all HID usages which should have a physical range
actually do, and those which shouldn't don't. Also verify that
the associated unit is correct and within a sensible range.
"""
def usage_id(page_name, usage_name):
page = HUT.usage_page_from_name(page_name)
return (page.page_id << 16) | page[usage_name].usage
required = {
usage_id("Generic Desktop", "X"): PhysRange(
PhysRange.CENTIMETER, 5, 150
),
usage_id("Generic Desktop", "Y"): PhysRange(
PhysRange.CENTIMETER, 5, 150
),
usage_id("Digitizers", "Width"): PhysRange(
PhysRange.CENTIMETER, 5, 150
),
usage_id("Digitizers", "Height"): PhysRange(
PhysRange.CENTIMETER, 5, 150
),
usage_id("Digitizers", "X Tilt"): PhysRange(PhysRange.DEGREE, 90, 180),
usage_id("Digitizers", "Y Tilt"): PhysRange(PhysRange.DEGREE, 90, 180),
usage_id("Digitizers", "Twist"): PhysRange(PhysRange.DEGREE, 358, 360),
usage_id("Wacom", "X Tilt"): PhysRange(PhysRange.DEGREE, 90, 180),
usage_id("Wacom", "Y Tilt"): PhysRange(PhysRange.DEGREE, 90, 180),
usage_id("Wacom", "Twist"): PhysRange(PhysRange.DEGREE, 358, 360),
usage_id("Wacom", "X"): PhysRange(PhysRange.CENTIMETER, 5, 150),
usage_id("Wacom", "Y"): PhysRange(PhysRange.CENTIMETER, 5, 150),
usage_id("Wacom", "Wacom TouchRing"): PhysRange(
PhysRange.DEGREE, 358, 360
),
usage_id("Wacom", "Wacom Offset Left"): PhysRange(
PhysRange.CENTIMETER, 0, 0.5
),
usage_id("Wacom", "Wacom Offset Top"): PhysRange(
PhysRange.CENTIMETER, 0, 0.5
),
usage_id("Wacom", "Wacom Offset Right"): PhysRange(
PhysRange.CENTIMETER, 0, 0.5
),
usage_id("Wacom", "Wacom Offset Bottom"): PhysRange(
PhysRange.CENTIMETER, 0, 0.5
),
}
for field, usage, application in self.get_usages(self.uhdev):
if application == usage_id("Generic Desktop", "Mouse"):
# Ignore the vestigial Mouse collection which exists
# on Wacom tablets only for backwards compatibility.
continue
expect_physical = usage in required
phys_set = field.physical_min != 0 or field.physical_max != 0
assert phys_set == expect_physical
unit_set = field.unit != 0
assert unit_set == expect_physical
if unit_set:
assert required[usage].contains(field)
def test_prop_direct(self):
"""
Todo: Verify that INPUT_PROP_DIRECT is set on display devices.
"""
pass
def test_prop_pointer(self):
"""
Todo: Verify that INPUT_PROP_POINTER is set on opaque devices.
"""
pass
class PenTabletTest(BaseTest.TestTablet):
def assertName(self, uhdev):
super().assertName(uhdev, " Pen")
class TouchTabletTest(BaseTest.TestTablet):
def assertName(self, uhdev):
super().assertName(uhdev, " Finger")
class TestOpaqueTablet(PenTabletTest):
def create_device(self):
return OpaqueTablet()
def test_sanity(self):
"""
Bring a pen into contact with the tablet, then remove it.
Ensure that we get the basic tool/touch/motion events that should
be sent by the driver.
"""
uhdev = self.uhdev
self.sync_and_assert_events(
uhdev.event(
100,
200,
pressure=300,
buttons=Buttons.clear(),
toolid=ToolID(serial=1, tooltype=1),
proximity=ProximityState.IN_RANGE,
),
[
libevdev.InputEvent(libevdev.EV_KEY.BTN_TOOL_PEN, 1),
libevdev.InputEvent(libevdev.EV_ABS.ABS_X, 100),
libevdev.InputEvent(libevdev.EV_ABS.ABS_Y, 200),
libevdev.InputEvent(libevdev.EV_KEY.BTN_TOUCH, 1),
],
)
self.sync_and_assert_events(
uhdev.event(110, 220, pressure=0),
[
libevdev.InputEvent(libevdev.EV_ABS.ABS_X, 110),
libevdev.InputEvent(libevdev.EV_ABS.ABS_Y, 220),
libevdev.InputEvent(libevdev.EV_KEY.BTN_TOUCH, 0),
],
)
self.sync_and_assert_events(
uhdev.event(
120,
230,
pressure=0,
toolid=ToolID.clear(),
proximity=ProximityState.OUT,
),
[
libevdev.InputEvent(libevdev.EV_KEY.BTN_TOOL_PEN, 0),
],
)
self.sync_and_assert_events(
uhdev.event(130, 240, pressure=0), [], auto_syn=False, strict=True
)
class TestOpaqueCTLTablet(TestOpaqueTablet):
def create_device(self):
return OpaqueCTLTablet()
def test_buttons(self):
"""
Test that the barrel buttons (side switches) work as expected.
Press and release each button individually to verify that we get
the expected events.
"""
uhdev = self.uhdev
self.sync_and_assert_events(
uhdev.event(
100,
200,
pressure=0,
buttons=Buttons.clear(),
toolid=ToolID(serial=1, tooltype=1),
proximity=ProximityState.IN_RANGE,
),
[
libevdev.InputEvent(libevdev.EV_KEY.BTN_TOOL_PEN, 1),
libevdev.InputEvent(libevdev.EV_ABS.ABS_X, 100),
libevdev.InputEvent(libevdev.EV_ABS.ABS_Y, 200),
libevdev.InputEvent(libevdev.EV_MSC.MSC_SERIAL, 1),
],
)
self.sync_and_assert_events(
uhdev.event(100, 200, pressure=0, buttons=Buttons(primary=True)),
[
libevdev.InputEvent(libevdev.EV_KEY.BTN_STYLUS, 1),
libevdev.InputEvent(libevdev.EV_MSC.MSC_SERIAL, 1),
],
)
self.sync_and_assert_events(
uhdev.event(100, 200, pressure=0, buttons=Buttons(primary=False)),
[
libevdev.InputEvent(libevdev.EV_KEY.BTN_STYLUS, 0),
libevdev.InputEvent(libevdev.EV_MSC.MSC_SERIAL, 1),
],
)
self.sync_and_assert_events(
uhdev.event(100, 200, pressure=0, buttons=Buttons(secondary=True)),
[
libevdev.InputEvent(libevdev.EV_KEY.BTN_STYLUS2, 1),
libevdev.InputEvent(libevdev.EV_MSC.MSC_SERIAL, 1),
],
)
self.sync_and_assert_events(
uhdev.event(100, 200, pressure=0, buttons=Buttons(secondary=False)),
[
libevdev.InputEvent(libevdev.EV_KEY.BTN_STYLUS2, 0),
libevdev.InputEvent(libevdev.EV_MSC.MSC_SERIAL, 1),
],
)
PTHX60_Devices = [
{"rdesc": wacom_pth660_v145, "info": (0x3, 0x056A, 0x0357)},
{"rdesc": wacom_pth660_v150, "info": (0x3, 0x056A, 0x0357)},
{"rdesc": wacom_pth860_v145, "info": (0x3, 0x056A, 0x0358)},
{"rdesc": wacom_pth860_v150, "info": (0x3, 0x056A, 0x0358)},
{"rdesc": wacom_pth460_v105, "info": (0x3, 0x056A, 0x0392)},
]
PTHX60_Names = [
"PTH-660/v145",
"PTH-660/v150",
"PTH-860/v145",
"PTH-860/v150",
"PTH-460/v105",
]
class TestPTHX60_Pen(TestOpaqueCTLTablet):
@pytest.fixture(
autouse=True, scope="class", params=PTHX60_Devices, ids=PTHX60_Names
)
def set_device_params(self, request):
request.cls.device_params = request.param
def create_device(self):
return PTHX60_Pen(**self.device_params)
@pytest.mark.xfail
def test_descriptor_physicals(self):
# XFAIL: Various documented errata
super().test_descriptor_physicals()
def test_heartbeat_spurious(self):
"""
Test that the heartbeat report does not send spurious events.
"""
uhdev = self.uhdev
self.sync_and_assert_events(
uhdev.event(
100,
200,
pressure=300,
buttons=Buttons.clear(),
toolid=ToolID(serial=1, tooltype=0x822),
proximity=ProximityState.IN_RANGE,
),
[
libevdev.InputEvent(libevdev.EV_KEY.BTN_TOOL_PEN, 1),
libevdev.InputEvent(libevdev.EV_ABS.ABS_X, 100),
libevdev.InputEvent(libevdev.EV_ABS.ABS_Y, 200),
libevdev.InputEvent(libevdev.EV_KEY.BTN_TOUCH, 1),
],
)
# Exactly zero events: not even a SYN
self.sync_and_assert_events(
uhdev.event_heartbeat(19), [], auto_syn=False, strict=True
)
self.sync_and_assert_events(
uhdev.event(110, 200, pressure=300),
[
libevdev.InputEvent(libevdev.EV_ABS.ABS_X, 110),
],
)
def test_empty_pad_sync(self):
self.empty_pad_sync(num=3, denom=16, reverse=True)
def empty_pad_sync(self, num, denom, reverse):
"""
Test that multiple pad collections do not trigger empty syncs.
"""
def offset_rotation(value):
"""
Offset touchring rotation values by the same factor as the
Linux kernel. Tablets historically don't use the same origin
as HID, and it sometimes changes from tablet to tablet...
"""
evdev = self.uhdev.get_evdev()
info = evdev.absinfo[libevdev.EV_ABS.ABS_WHEEL]
delta = info.maximum - info.minimum + 1
if reverse:
value = info.maximum - value
value += num * delta // denom
if value > info.maximum:
value -= delta
elif value < info.minimum:
value += delta
return value
uhdev = self.uhdev
uhdev.application = "Pad"
evdev = uhdev.get_evdev()
print(evdev.name)
self.sync_and_assert_events(
uhdev.event_pad(reportID=17, ring=0, ek0=1),
[
libevdev.InputEvent(libevdev.EV_KEY.BTN_0, 1),
libevdev.InputEvent(libevdev.EV_ABS.ABS_WHEEL, offset_rotation(0)),
libevdev.InputEvent(libevdev.EV_ABS.ABS_MISC, 15),
],
)
self.sync_and_assert_events(
uhdev.event_pad(reportID=17, ring=1, ek0=1),
[libevdev.InputEvent(libevdev.EV_ABS.ABS_WHEEL, offset_rotation(1))],
)
self.sync_and_assert_events(
uhdev.event_pad(reportID=17, ring=2, ek0=0),
[
libevdev.InputEvent(libevdev.EV_ABS.ABS_WHEEL, offset_rotation(2)),
libevdev.InputEvent(libevdev.EV_KEY.BTN_0, 0),
],
)
class TestDTH2452Tablet(test_multitouch.BaseTest.TestMultitouch, TouchTabletTest):
ContactIds = namedtuple("ContactIds", "contact_id, tracking_id, slot_num")
def create_device(self):
return test_multitouch.Digitizer(
"DTH 2452",
rdesc="05 0d 09 04 a1 01 85 0c 95 01 75 08 15 00 26 ff 00 81 03 09 54 81 02 09 22 a1 02 05 0d 95 01 75 01 25 01 09 42 81 02 81 03 09 47 81 02 95 05 81 03 09 51 26 ff 00 75 10 95 01 81 02 35 00 65 11 55 0e 05 01 09 30 26 a0 44 46 96 14 81 42 09 31 26 9a 26 46 95 0b 81 42 05 0d 75 08 95 01 15 00 09 48 26 5f 00 46 7c 14 81 02 09 49 25 35 46 7d 0b 81 02 45 00 65 00 55 00 c0 05 0d 09 22 a1 02 05 0d 95 01 75 01 25 01 09 42 81 02 81 03 09 47 81 02 95 05 81 03 09 51 26 ff 00 75 10 95 01 81 02 35 00 65 11 55 0e 05 01 09 30 26 a0 44 46 96 14 81 42 09 31 26 9a 26 46 95 0b 81 42 05 0d 75 08 95 01 15 00 09 48 26 5f 00 46 7c 14 81 02 09 49 25 35 46 7d 0b 81 02 45 00 65 00 55 00 c0 05 0d 09 22 a1 02 05 0d 95 01 75 01 25 01 09 42 81 02 81 03 09 47 81 02 95 05 81 03 09 51 26 ff 00 75 10 95 01 81 02 35 00 65 11 55 0e 05 01 09 30 26 a0 44 46 96 14 81 42 09 31 26 9a 26 46 95 0b 81 42 05 0d 75 08 95 01 15 00 09 48 26 5f 00 46 7c 14 81 02 09 49 25 35 46 7d 0b 81 02 45 00 65 00 55 00 c0 05 0d 09 22 a1 02 05 0d 95 01 75 01 25 01 09 42 81 02 81 03 09 47 81 02 95 05 81 03 09 51 26 ff 00 75 10 95 01 81 02 35 00 65 11 55 0e 05 01 09 30 26 a0 44 46 96 14 81 42 09 31 26 9a 26 46 95 0b 81 42 05 0d 75 08 95 01 15 00 09 48 26 5f 00 46 7c 14 81 02 09 49 25 35 46 7d 0b 81 02 45 00 65 00 55 00 c0 05 0d 09 22 a1 02 05 0d 95 01 75 01 25 01 09 42 81 02 81 03 09 47 81 02 95 05 81 03 09 51 26 ff 00 75 10 95 01 81 02 35 00 65 11 55 0e 05 01 09 30 26 a0 44 46 96 14 81 42 09 31 26 9a 26 46 95 0b 81 42 05 0d 75 08 95 01 15 00 09 48 26 5f 00 46 7c 14 81 02 09 49 25 35 46 7d 0b 81 02 45 00 65 00 55 00 c0 05 0d 27 ff ff 00 00 75 10 95 01 09 56 81 02 75 08 95 0e 81 03 09 55 26 ff 00 75 08 b1 02 85 0a 06 00 ff 09 c5 96 00 01 b1 02 c0 06 00 ff 09 01 a1 01 09 01 85 13 15 00 26 ff 00 75 08 95 3f 81 02 06 00 ff 09 01 15 00 26 ff 00 75 08 95 3f 91 02 c0",
input_info=(0x3, 0x056A, 0x0383),
)
def make_contact(self, contact_id=0, t=0):
"""
Make a single touch contact that can move over time.
Creates a touch object that has a well-known position in space that
does not overlap with other contacts. The value of `t` may be
incremented over time to move the point along a linear path.
"""
x = 50 + 10 * contact_id + t * 11
y = 100 + 100 * contact_id + t * 11
return test_multitouch.Touch(contact_id, x, y)
def make_contacts(self, n, t=0):
"""
Make multiple touch contacts that can move over time.
Returns a list of `n` touch objects that are positioned at well-known
locations. The value of `t` may be incremented over time to move the
points along a linear path.
"""
return [ self.make_contact(id, t) for id in range(0, n) ]
def assert_contact(self, uhdev, evdev, contact_ids, t=0):
"""
Assert properties of a contact generated by make_contact.
"""
contact_id = contact_ids.contact_id
tracking_id = contact_ids.tracking_id
slot_num = contact_ids.slot_num
x = 50 + 10 * contact_id + t * 11
y = 100 + 100 * contact_id + t * 11
# If the data isn't supposed to be stored in any slots, there is
# nothing we can check for in the evdev stream.
if slot_num is None:
assert tracking_id == -1
return
assert evdev.slots[slot_num][libevdev.EV_ABS.ABS_MT_TRACKING_ID] == tracking_id
if tracking_id != -1:
assert evdev.slots[slot_num][libevdev.EV_ABS.ABS_MT_POSITION_X] == x
assert evdev.slots[slot_num][libevdev.EV_ABS.ABS_MT_POSITION_Y] == y
def assert_contacts(self, uhdev, evdev, data, t=0):
"""
Assert properties of a list of contacts generated by make_contacts.
"""
for contact_ids in data:
self.assert_contact(uhdev, evdev, contact_ids, t)
def test_contact_id_0(self):
"""
Bring a finger in contact with the tablet, then hold it down and remove it.
Ensure that even with contact ID = 0 which is usually given as an invalid
touch event by most tablets with the exception of a few, that given the
confidence bit is set to 1 it should process it as a valid touch to cover
the few tablets using contact ID = 0 as a valid touch value.
"""
uhdev = self.uhdev
evdev = uhdev.get_evdev()
t0 = test_multitouch.Touch(0, 50, 100)
r = uhdev.event([t0])
events = uhdev.next_sync_events()
self.debug_reports(r, uhdev, events)
slot = self.get_slot(uhdev, t0, 0)
assert libevdev.InputEvent(libevdev.EV_KEY.BTN_TOUCH, 1) in events
assert evdev.slots[slot][libevdev.EV_ABS.ABS_MT_TRACKING_ID] == 0
assert evdev.slots[slot][libevdev.EV_ABS.ABS_MT_POSITION_X] == 50
assert evdev.slots[slot][libevdev.EV_ABS.ABS_MT_POSITION_Y] == 100
t0.tipswitch = False
if uhdev.quirks is None or "VALID_IS_INRANGE" not in uhdev.quirks:
t0.inrange = False
r = uhdev.event([t0])
events = uhdev.next_sync_events()
self.debug_reports(r, uhdev, events)
assert libevdev.InputEvent(libevdev.EV_KEY.BTN_TOUCH, 0) in events
assert evdev.slots[slot][libevdev.EV_ABS.ABS_MT_TRACKING_ID] == -1
def test_confidence_false(self):
"""
Bring a finger in contact with the tablet with confidence set to false.
Ensure that the confidence bit being set to false should not result in a touch event.
"""
uhdev = self.uhdev
_evdev = uhdev.get_evdev()
t0 = test_multitouch.Touch(1, 50, 100)
t0.confidence = False
r = uhdev.event([t0])
events = uhdev.next_sync_events()
self.debug_reports(r, uhdev, events)
_slot = self.get_slot(uhdev, t0, 0)
assert not events
def test_confidence_multitouch(self):
"""
Bring multiple fingers in contact with the tablet, some with the
confidence bit set, and some without.
Ensure that all confident touches are reported and that all non-
confident touches are ignored.
"""
uhdev = self.uhdev
evdev = uhdev.get_evdev()
touches = self.make_contacts(5)
touches[0].confidence = False
touches[2].confidence = False
touches[4].confidence = False
r = uhdev.event(touches)
events = uhdev.next_sync_events()
self.debug_reports(r, uhdev, events)
assert libevdev.InputEvent(libevdev.EV_KEY.BTN_TOUCH, 1) in events
self.assert_contacts(uhdev, evdev,
[ self.ContactIds(contact_id = 0, tracking_id = -1, slot_num = None),
self.ContactIds(contact_id = 1, tracking_id = 0, slot_num = 0),
self.ContactIds(contact_id = 2, tracking_id = -1, slot_num = None),
self.ContactIds(contact_id = 3, tracking_id = 1, slot_num = 1),
self.ContactIds(contact_id = 4, tracking_id = -1, slot_num = None) ])
def confidence_change_assert_playback(self, uhdev, evdev, timeline):
"""
Assert proper behavior of contacts that move and change tipswitch /
confidence status over time.
Given a `timeline` list of touch states to iterate over, verify
that the contacts move and are reported as up/down as expected
by the state of the tipswitch and confidence bits.
"""
t = 0
for state in timeline:
touches = self.make_contacts(len(state), t)
for item in zip(touches, state):
item[0].tipswitch = item[1][1]
item[0].confidence = item[1][2]
r = uhdev.event(touches)
events = uhdev.next_sync_events()
self.debug_reports(r, uhdev, events)
ids = [ x[0] for x in state ]
self.assert_contacts(uhdev, evdev, ids, t)
t += 1
def test_confidence_loss_a(self):
"""
Transition a confident contact to a non-confident contact by
first clearing the tipswitch.
Ensure that the driver reports the transitioned contact as
being removed and that other contacts continue to report
normally. This mode of confidence loss is used by the
DTH-2452.
"""
uhdev = self.uhdev
evdev = uhdev.get_evdev()
self.confidence_change_assert_playback(uhdev, evdev, [
# t=0: Contact 0 == Down + confident; Contact 1 == Down + confident
# Both fingers confidently in contact
[(self.ContactIds(contact_id = 0, tracking_id = 0, slot_num = 0), True, True),
(self.ContactIds(contact_id = 1, tracking_id = 1, slot_num = 1), True, True)],
# t=1: Contact 0 == !Down + confident; Contact 1 == Down + confident
# First finger looses confidence and clears only the tipswitch flag
[(self.ContactIds(contact_id = 0, tracking_id = -1, slot_num = 0), False, True),
(self.ContactIds(contact_id = 1, tracking_id = 1, slot_num = 1), True, True)],
# t=2: Contact 0 == !Down + !confident; Contact 1 == Down + confident
# First finger has lost confidence and has both flags cleared
[(self.ContactIds(contact_id = 0, tracking_id = -1, slot_num = 0), False, False),
(self.ContactIds(contact_id = 1, tracking_id = 1, slot_num = 1), True, True)],
# t=3: Contact 0 == !Down + !confident; Contact 1 == Down + confident
# First finger has lost confidence and has both flags cleared
[(self.ContactIds(contact_id = 0, tracking_id = -1, slot_num = 0), False, False),
(self.ContactIds(contact_id = 1, tracking_id = 1, slot_num = 1), True, True)]
])
def test_confidence_loss_b(self):
"""
Transition a confident contact to a non-confident contact by
cleraing both tipswitch and confidence bits simultaneously.
Ensure that the driver reports the transitioned contact as
being removed and that other contacts continue to report
normally. This mode of confidence loss is used by some
AES devices.
"""
uhdev = self.uhdev
evdev = uhdev.get_evdev()
self.confidence_change_assert_playback(uhdev, evdev, [
# t=0: Contact 0 == Down + confident; Contact 1 == Down + confident
# Both fingers confidently in contact
[(self.ContactIds(contact_id = 0, tracking_id = 0, slot_num = 0), True, True),
(self.ContactIds(contact_id = 1, tracking_id = 1, slot_num = 1), True, True)],
# t=1: Contact 0 == !Down + !confident; Contact 1 == Down + confident
# First finger looses confidence and has both flags cleared simultaneously
[(self.ContactIds(contact_id = 0, tracking_id = -1, slot_num = 0), False, False),
(self.ContactIds(contact_id = 1, tracking_id = 1, slot_num = 1), True, True)],
# t=2: Contact 0 == !Down + !confident; Contact 1 == Down + confident
# First finger has lost confidence and has both flags cleared
[(self.ContactIds(contact_id = 0, tracking_id = -1, slot_num = 0), False, False),
(self.ContactIds(contact_id = 1, tracking_id = 1, slot_num = 1), True, True)],
# t=3: Contact 0 == !Down + !confident; Contact 1 == Down + confident
# First finger has lost confidence and has both flags cleared
[(self.ContactIds(contact_id = 0, tracking_id = -1, slot_num = 0), False, False),
(self.ContactIds(contact_id = 1, tracking_id = 1, slot_num = 1), True, True)]
])
def test_confidence_loss_c(self):
"""
Transition a confident contact to a non-confident contact by
clearing only the confidence bit.
Ensure that the driver reports the transitioned contact as
being removed and that other contacts continue to report
normally.
"""
uhdev = self.uhdev
evdev = uhdev.get_evdev()
self.confidence_change_assert_playback(uhdev, evdev, [
# t=0: Contact 0 == Down + confident; Contact 1 == Down + confident
# Both fingers confidently in contact
[(self.ContactIds(contact_id = 0, tracking_id = 0, slot_num = 0), True, True),
(self.ContactIds(contact_id = 1, tracking_id = 1, slot_num = 1), True, True)],
# t=1: Contact 0 == Down + !confident; Contact 1 == Down + confident
# First finger looses confidence and clears only the confidence flag
[(self.ContactIds(contact_id = 0, tracking_id = -1, slot_num = 0), True, False),
(self.ContactIds(contact_id = 1, tracking_id = 1, slot_num = 1), True, True)],
# t=2: Contact 0 == !Down + !confident; Contact 1 == Down + confident
# First finger has lost confidence and has both flags cleared
[(self.ContactIds(contact_id = 0, tracking_id = -1, slot_num = 0), False, False),
(self.ContactIds(contact_id = 1, tracking_id = 1, slot_num = 1), True, True)],
# t=3: Contact 0 == !Down + !confident; Contact 1 == Down + confident
# First finger has lost confidence and has both flags cleared
[(self.ContactIds(contact_id = 0, tracking_id = -1, slot_num = 0), False, False),
(self.ContactIds(contact_id = 1, tracking_id = 1, slot_num = 1), True, True)]
])
def test_confidence_gain_a(self):
"""
Transition a contact that was always non-confident to confident.
Ensure that the confident contact is reported normally.
"""
uhdev = self.uhdev
evdev = uhdev.get_evdev()
self.confidence_change_assert_playback(uhdev, evdev, [
# t=0: Contact 0 == Down + !confident; Contact 1 == Down + confident
# Only second finger is confidently in contact
[(self.ContactIds(contact_id = 0, tracking_id = -1, slot_num = None), True, False),
(self.ContactIds(contact_id = 1, tracking_id = 0, slot_num = 0), True, True)],
# t=1: Contact 0 == Down + !confident; Contact 1 == Down + confident
# First finger gains confidence
[(self.ContactIds(contact_id = 0, tracking_id = -1, slot_num = None), True, False),
(self.ContactIds(contact_id = 1, tracking_id = 0, slot_num = 0), True, True)],
# t=2: Contact 0 == Down + confident; Contact 1 == Down + confident
# First finger remains confident
[(self.ContactIds(contact_id = 0, tracking_id = 1, slot_num = 1), True, True),
(self.ContactIds(contact_id = 1, tracking_id = 0, slot_num = 0), True, True)],
# t=3: Contact 0 == Down + confident; Contact 1 == Down + confident
# First finger remains confident
[(self.ContactIds(contact_id = 0, tracking_id = 1, slot_num = 1), True, True),
(self.ContactIds(contact_id = 1, tracking_id = 0, slot_num = 0), True, True)]
])
def test_confidence_gain_b(self):
"""
Transition a contact from non-confident to confident.
Ensure that the confident contact is reported normally.
"""
uhdev = self.uhdev
evdev = uhdev.get_evdev()
self.confidence_change_assert_playback(uhdev, evdev, [
# t=0: Contact 0 == Down + confident; Contact 1 == Down + confident
# First and second finger confidently in contact
[(self.ContactIds(contact_id = 0, tracking_id = 0, slot_num = 0), True, True),
(self.ContactIds(contact_id = 1, tracking_id = 1, slot_num = 1), True, True)],
# t=1: Contact 0 == Down + !confident; Contact 1 == Down + confident
# Firtst finger looses confidence
[(self.ContactIds(contact_id = 0, tracking_id = -1, slot_num = 0), True, False),
(self.ContactIds(contact_id = 1, tracking_id = 1, slot_num = 1), True, True)],
# t=2: Contact 0 == Down + confident; Contact 1 == Down + confident
# First finger gains confidence
[(self.ContactIds(contact_id = 0, tracking_id = 2, slot_num = 0), True, True),
(self.ContactIds(contact_id = 1, tracking_id = 1, slot_num = 1), True, True)],
# t=3: Contact 0 == !Down + confident; Contact 1 == Down + confident
# First finger goes up
[(self.ContactIds(contact_id = 0, tracking_id = -1, slot_num = 0), False, True),
(self.ContactIds(contact_id = 1, tracking_id = 1, slot_num = 1), True, True)]
])