libinput/quirks
Thomas Profitt ad50a94789 quirks: Adjust MacBookPro11,2 touchpad PalmSize
The touchpad is 104mmx75mm, but an AttrPalmSizeThreshold of 800 is too
  aggressive, and even relatively-small fingers and thumbs register as
  palms sporadically, stopping the mouse until you lift your hand and try again.

1600 was chosen because it's the point at which my fingers and thumbs,
  held at a very low angle, stop registering as palms, so it should
  acommodate bigger fingers.

I don't know if the [Apple Touchpads USB] default of 800 needs to be
  updated too, or if it's a quirk of this particular touchpad.
2018-11-27 16:14:07 -06:00
..
10-generic-keyboard.quirks quirks: explicitly mark bluetooth keyboards as external 2018-08-27 09:19:46 +10:00
10-generic-lid.quirks Rename data/ to quirks/ 2018-07-13 13:30:54 +10:00
10-generic-trackball.quirks Rename data/ to quirks/ 2018-07-13 13:30:54 +10:00
30-vendor-aiptek.quirks quirks: switch a few model quirks over to use the new evcode disabling 2018-10-29 04:16:38 +00:00
30-vendor-alps.quirks Rename data/ to quirks/ 2018-07-13 13:30:54 +10:00
30-vendor-cyapa.quirks Rename data/ to quirks/ 2018-07-13 13:30:54 +10:00
30-vendor-elantech.quirks quirks: extend/restore the Elan Touchpads quirks 2018-09-18 07:18:34 +10:00
30-vendor-huion.quirks Rename data/ to quirks/ 2018-07-13 13:30:54 +10:00
30-vendor-ibm.quirks Rename data/ to quirks/ 2018-07-13 13:30:54 +10:00
30-vendor-kensington.quirks quirks: switch a few model quirks over to use the new evcode disabling 2018-10-29 04:16:38 +00:00
30-vendor-logitech.quirks quirks: switch a few model quirks over to use the new evcode disabling 2018-10-29 04:16:38 +00:00
30-vendor-microsoft.quirks quirks: fix the product ID for the MS Nano Transceiver 2018-09-18 06:37:24 +10:00
30-vendor-razer.quirks Rename data/ to quirks/ 2018-07-13 13:30:54 +10:00
30-vendor-synaptics.quirks Rename data/ to quirks/ 2018-07-13 13:30:54 +10:00
30-vendor-vmware.quirks quirks: disable debouncing on the VMware Virtual mice 2018-10-19 00:16:15 +00:00
30-vendor-wacom.quirks quirks: fix palm size threshold for the Wacom PTH660 2018-10-10 16:36:50 +10:00
50-system-acer.quirks quirks: Add quirks for Acer Switch Alpha 12 2018-08-21 13:10:01 +02:00
50-system-apple.quirks quirks: Adjust MacBookPro11,2 touchpad PalmSize 2018-11-27 16:14:07 -06:00
50-system-asus.quirks quirks: switch a few model quirks over to use the new evcode disabling 2018-10-29 04:16:38 +00:00
50-system-chicony.quirks Lenovo MIIX 720 quirk: MatchBus should be usb. 2018-08-21 03:35:00 +02:00
50-system-cyborg.quirks quirks: switch a few model quirks over to use the new evcode disabling 2018-10-29 04:16:38 +00:00
50-system-dell.quirks quirks: fix the trackpoint multiplier for the Dell E7470 2018-10-02 04:06:16 +00:00
50-system-google.quirks Rename data/ to quirks/ 2018-07-13 13:30:54 +10:00
50-system-hp.quirks Added quirk for HP Spectre x360 Convertable 15-bl1xx touchpad. 2018-11-23 15:10:15 -06:00
50-system-lenovo.quirks Don't disable keyboard for Lenovo X230 Tablet in tablet mode 2018-11-01 17:42:45 +00:00
50-system-system76.quirks Rename data/ to quirks/ 2018-07-13 13:30:54 +10:00
README.md Rename data/ to quirks/ 2018-07-13 13:30:54 +10:00

= libinput data file format =

This directory contains hardware quirks used by libinput to work around bugs in the hardware, device behavior and to supply information not obtained through the kernel device.

THIS IS NOT STABLE API

The data format may change at any time. If your data file is not part of the libinput git tree, do not expect it to work after an update. Absolutely no guarantees are made for backwards-compatibility.

THIS IS NOT A CONFIGURATION API

Use the libinput_device_config_foo() functions for device configuration. The quirks are hardware quirks only.

== Data file naming ==

Data files are read in versionsort order, read order determines how values override each other. A values read later override previously values. The current structure is 10-generic-foo.quirks for generic settings, 30-vendor-foo.quirks for vendor-specific settings and 50-system-foo.quirks for system vendors. This is not a fixed naming scheme and may change at any time. It's an approximation only because some vendors are also system vendors, e.g. Microsoft makes devices and laptops.

Laptop-specific quirks should always go into the laptop vendor's file.

== Sections, matches and values ==

A data file must contain at least one section, each section must have at least one Match tag and at least one of either Attr or Model. Section names are free-form and may contain spaces.

# This is a comment
[Some touchpad]
MatchBus=usb
# No quotes around strings
MatchName=*Synaptics Touchpad*
AttrSizeHint=50x50
ModelSynapticsTouchpad=1

[Apple touchpad]
MatchVendor=0x5AC
MatchProduct=0x123
ModelAppleTouchpad=1

Comments are lines starting with #.

All Model tags take a value of either 1 or 0.

All Attr tag values are specific to that attribute.

== Parser errors ==

The following will cause parser errors and are considered invalid data files:

  • Whitespace at the beginning of the line
  • Sections without at least one Match* entry
  • Sections with the same Match* entry repeated
  • Sections without at least one of Model* or Attr entries
  • A Model tag with a value other than 1 or 0
  • A string property with enclosing quotes

== Debugging ==

When modifying a data file, use the libinput list-quirks tool to verify the changes. The tool can be pointed at the data directory to analyse, use --verbose to get more info. For example:

libinput list-quirks --data-dir /path/to/git/repo/data/ --verbose /dev/input/event0