JOYHANDLE(9)

💖 JOYHANDLE(9) 💖

okay so bestie, welcome to joyhandle — it's a HAL Component (yes, section 9, we're deep in kernel-y territory, iykyk) and it basically makes your joypad feel good. non-linear movements, deadbands, scales, the whole thing. let's get into it 🎀

---

✨ NAME ✨

joyhandle — sets nonlinear joypad movements, deadbands and scales 🕹️✨

---

🌸 SYNOPSIS 🌸

loadrt joyhandle [count=N|names=name1[,name2...]]

---

🦋 DESCRIPTION 🦋

so the component joyhandle uses this formula for non linear joypad movements, and it's literally the whole vibe:

y = (scale * (a*x^power + b*x)) + offset

the parameters a and b are adjusted in such a way, that the function starts at (deadband,offset) and ends at (1,scale+offset). cute, right? it just slots itself in exactly where it needs to be 💅

negative values will be treated point symmetrically to origin. and values -deadband < x < +deadband will be set to zero (this is the deadband doing its deadband thing, no cap).

values x > 1 and x < -1 will be skipped to ±(scale+offset). and invert transforms the function to a progressive movement.

with power one can adjust the nonlinearity (default = 2). default for deadband is 0.

valid values are, and I need you to pay attention bestie:

• power >= 1.0 — reasonable values are 1.x .. 4‐5, take higher power‐values for higher deadbands (>0.5), if you want to start with a nearly horizontal slope
• 0 <= deadband < 0.99 — reasonable 0.1

an additional offset component can be set in special cases (default = 0).

all values can be adjusted for each instance separately 👑

---

🌈 FUNCTIONS 🌈

• joyhandle.N — requires a floating-point thread ⭐

---

💜 PINS 💜

• joyhandle.N.in — float in
• joyhandle.N.out — float out

---

🎀 PARAMETERS 🎀

• joyhandle.N.power — float rw (default: 2.0)
• joyhandle.N.deadband — float rw (default: 0.)
• joyhandle.N.scale — float rw (default: 1.)
• joyhandle.N.offset — float rw (default: 0.)
• joyhandle.N.inverse — bit rw (default: 0)

---

👑 AUTHOR 👑

Paul Willutzki — shoutout to the icon, fr fr 🫶

---

📜 LICENSE 📜

GPL — go wild, bestie, but like... respectfully 💖

---

and that's the whole page!! 40 options? no. five parameters and one function, and honestly? it ate. periodt. 🍓

okay bye ily, this has been the joyhandle page from the LinuxCNC Documentation, dated 2026-03-17 (JOYHANDLE(9), if you're keeping track). go make your joystick feel iconic 🌸✨💅