Repository navigation
WellspringPTP 1.2026.0803.1021
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
- Extract the archive.
- Run TestMode.bat, enter 1, and press Enter to enable Test Mode.
- Restart your computer. (Really)
- Run InstallSert.bat to install the certificate.
- Right-click AmtPtpDeviceUsbKm.inf and select "Install".