WSP(4)

WSP(4) 💖✨

ok so bestie. welcome to the Kernel Interfaces Manual, we're talking about wsp(4) today and honestly?? it's giving ✨trackpad whisperer✨. let's get into it 🎀

---

🌸 NAME 🌸

wsp — the Wellspring touchpad driver, aka the thing that makes your Apple trackpad actually do stuff 💅

---

🦋 SYNOPSIS 🦋

so like, you wanna bake this driver into the kernel? okay periodt, drop these lines into your kernel configuration file:

device wsp
device usb

orrrrr, if you'd rather be a module girlie and load it at boot time instead, put this lil line in loader.conf(5):

wsp_load="YES"

both are valid. both are iconic. pick your fighter 🫶

---

✨ DESCRIPTION ✨

The wsp driver provides support for the Apple Internal Trackpad device found in many Apple laptops. no cap, that's the whole gig 💻

The driver simulates a three-button mouse using multi-finger tap detection. and the mapping is honestly so clean:

• A single-finger press generates a left button click 👈
• A two-finger tap maps to the right button 👉
• whereas a three-finger tap gets treated as a middle button click 👆

three buttons, zero physical buttons. we love a multitasking moment 🔥

wsp supports dynamic reconfiguration using sysctl(8) through nodes under hw.usb.wsp. so you can tweak the vibes live, no reboot required 😌

• Pointer sensitivity can be controlled using the sysctl tunable hw.usb.wsp.scale_factor 🎚️
• Tap to left-click can be controlled using the sysctl tunable hw.usb.wsp.enable_single_tap_clicks — set it to 0 to disable single tap clicks, or 1 to enable them (that's the default btw, so it's already on unless you say otherwise) ⭐

---

🎀 FILES 🎀

wsp creates a blocking pseudo-device file, /dev/wsp0, which presents the mouse as a sysmouse or mousesystems type device — and if you wanna know what those mouse types even mean, go peek at moused(8) for an explanation of these mouse types. iykyk 🐭

---

🌈 SEE ALSO 🌈

• sysmouse(4)
• usb(4)
• loader.conf(5)
• xorg.conf(5) (ports/x11/xorg)
• moused(8)
• sysctl(8)

go read them. for me. 💜

---

👑 AUTHORS 👑

The wsp driver was written by Huang Wen Hui <huanghwh@gmail.com>. thank you for your service king 🫡💖

---

okay that's the whole page bestie, go forth and tap responsibly 💅

this cutie came from the <strong>Debian</strong> distro, dated <strong>January 15, 2018</strong> — vintage but still slaying ✨