Skip to content

WellspringPTP 1.2026.0803.1021

Choose a tag to compare

@Osaul4ik Osaul4ik released this 03 Aug 10:54
· 416 commits to master since this release

WellspringPTP Driver

The USB KM driver has been extensively rewritten.

WellspringPTP targets the USB KM implementation exclusively.

🚀 Architecture

Reworked the contact processing pipeline with clear separation between ActiveContact, Match, and PTPCore.
Replaced the legacy slot-based identity model with a pool-based contact lifetime model.
Implemented a new contact matcher featuring:
branch-and-bound candidate pruning,
dead-reckoning position prediction,
normalized contact shape distance,
per-axis velocity estimation.

🛠 Fixes

Fixed incorrect KeQueryPerformanceCounter() usage that affected all timing-dependent logic.
Fixed an SMP race condition on DEVICE_CONTEXT by introducing proper spinlock synchronization.
Fixed multiple stability issues including:
NULL pointer dereference,
memory leak,
interrupt race condition.
Fixed TipDropApplied being incorrectly used as a confidence flag, resolving cascading tap failures.
Fixed Y-axis inversion inside the bottom dead zone.
Fixed phantom UP events generated for palm contacts.
Fixed force-touch drag lockout matching semantics.
Added mitigation for T2 / BCM5974 firmware slot reassignment noise (origin == 0 glitch).
Improved gradual palm detection through birth-size tracking.

⚡ Performance & Stability

Removed EMA smoothing during gesture frames, eliminating scroll damping and inertia hitching.
Fixed scroll velocity scaling carry bug.
Reduced interrupt handler lock hold time to improve responsiveness.

✨ New Features

Force Touch — press and release with one finger to open the context menu (right-click).

🧹 Removed

Other drivers.
Unused haptics code.
Obsolete gesture-related source files.

📦 Installation

  1. Extract the archive.
  2. Run TestMode.bat, enter 1, and press Enter to enable Test Mode.
  3. Restart your computer. (Really)
  4. Run InstallSert.bat to install the certificate.
  5. Right-click AmtPtpDeviceUsbKm.inf and select "Install".