beenull/linux-surface
1
0
Fork 0
Code Issues Pull requests Packages Projects Releases Wiki Activity
linux-surface/firmware/intel/ipts
History
Dorian Stoll cd9cced2fd
Add some documentation about the IPTS driver firmware 
Signed-off-by: Dorian Stoll <dorian.stoll@tmsp.io>
2019-10-01 12:05:00 +02:00
..
MSHW0076 Seperate firmware and configs 2019-09-28 03:26:32 +02:00
MSHW0078 Seperate firmware and configs 2019-09-28 03:26:32 +02:00
MSHW0079 Replace the HID descriptor for MSHW0079 with MSHW0137 2019-10-01 12:04:40 +02:00
MSHW0101 Seperate firmware and configs 2019-09-28 03:26:32 +02:00
MSHW0102 Seperate firmware and configs 2019-09-28 03:26:32 +02:00
MSHW0103 Seperate firmware and configs 2019-09-28 03:26:32 +02:00
MSHW0137 Seperate firmware and configs 2019-09-28 03:26:32 +02:00
README.md Add some documentation about the IPTS driver firmware 2019-10-01 12:05:00 +02:00

README.md

IPTS driver firmware

This is the driver firmware required for the intel_ipts module. It was extracted from the SurfaceBook2_Win10_18362_1904009_0 firmware bundle for Windows.

Filenames

  • SurfaceTouchServicingKernel*.bin -> vendor_kernel.bin
  • SurfaceTouchServicingSFTConfig*.bin -> config.bin
  • SurfaceTouchServicingDescriptor*.bin -> vendor_desc.bin
  • iaPreciseTouchDescriptor.bin -> intel_desc.bin (the same for all models)
  • ipts_fw_config.bin (custom, the same for all models; 63a8944729)

HID descriptor

The HID descriptor for IPTS devices consists of intel_desc.bin and vendor_desc.bin concatinated together by the driver. The result can be decompiled by various tools found on the internet:

$ cat intel_desc.bin vendor_desc.bin > hid_desc.bin

Quirks

At the moment, MSHW0079 is using the HID descriptor from MSHW0137. It's own HID descriptor is bugged and needs kernel mitigations to have the kernel properly register touch input events. See: https://github.com/jakeday/linux-surface/issues/574