MULTICLICK(9)

💅 MULTICLICK — the HAL component, lovingly presented (manual page MULTICLICK(9), section 9) 🎀

okay bestie, sit down, hydrate, because we're about to talk about the single most extra click detector in LinuxCNC: multiclick. she counts your clicks. single, double, triple, quadruple. she's giving wrist-tracking, she's giving "did you just tap me four times". iconic. ✨

---

✨ NAME ✨

multiclick — a Single-, double-, triple-, and quadruple-click detector 🖱️💥

---

🦋 SYNOPSIS 🦋

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

that's it. that's the whole summoning ritual. 🕯️

---

🌸 DESCRIPTION 🌸

so, what even is a click, fr fr? a click is defined as a rising edge on the in pin, followed by the in pin being True for at most max-hold-ns nanoseconds, followed by a falling edge. ⏱️ like... press, hold (briefly, don't make it weird), release.

a double-click? that's defined as two clicks, separated by at most max-space-ns nanoseconds with the in pin in the False state. two clicks, cozy together, not too far apart. 🫶

and honestly? I bet you can guess the definition of triple- and quadruple-click. go on. guess. I'll wait. 💅

💀 real talk warning: you probably want to run the input signal through a debounce component before feeding it to the multiclick detector, if the input is at all noisy. noisy input + click detector = chaos. protect her peace.

the *-click pins go high as soon as the input detects the correct number of clicks. instant. immediate. main character energy. 🔥

the *-click-only pins go high a short while after the click — after the click separator space timeout has expired — to show that no further click is coming. basically she's like "okay nobody else is showing up, this party's over" 🎉. this is useful for triggering halui MDI commands. noted. write that down. 📝

---

👑 FUNCTIONS 👑

• multiclick.N — Detect single-, double-, triple-, and quadruple-clicks. the whole job. she does the whole job. 👑

---

🎀 PINS 🎀

• multiclick.N.in bit in — The input line, this is where we look for clicks. 👀 this is the one and only thing you're feeding her.
• multiclick.N.single-click bit out — Goes high briefly when a single-click is detected on the in pin. 🖱️
• multiclick.N.single-click-only bit out — Goes high briefly when a single-click is detected on the in pin and no second click followed it. 🖱️✋
• multiclick.N.double-click bit out — Goes high briefly when a double-click is detected on the in pin. 🖱️🖱️
• multiclick.N.double-click-only bit out — Goes high briefly when a double-click is detected on the in pin and no third click followed it. 🖱️🖱️✋
• multiclick.N.triple-click bit out — Goes high briefly when a triple-click is detected on the in pin. 🖱️🖱️🖱️
• multiclick.N.triple-click-only bit out — Goes high briefly when a triple-click is detected on the in pin and no fourth click followed it. 🖱️🖱️🖱️✋
• multiclick.N.quadruple-click bit out — Goes high briefly when a quadruple-click is detected on the in pin. 🖱️🖱️🖱️🖱️ (yes bestie, four. the limit does exist.)
• multiclick.N.quadruple-click-only bit out — Goes high briefly when a quadruple-click is detected on the in pin and no fifth click followed it. 🖱️🖱️🖱️🖱️✋ (there is no fifth click. this is the end of the road.)
• multiclick.N.state s32 out — (no further description in the original, she's mysterious like that 🤫)

---

💖 PARAMETERS 💖

• multiclick.N.invert-input bit rw (default: FALSE) — If FALSE (the default), clicks start with rising edges. If TRUE, clicks start with falling edges. flip the vibe. 🔄
• multiclick.N.max-hold-ns u32 rw (default: 250000000) — If the input is held down longer than this, it's not part of a multi-click. (Default 250,000,000 ns, 250 ms.) so like, hold it too long and she's like "okay that's just a hold, not a click, go sit down" 💀
• multiclick.N.max-space-ns u32 rw (default: 250000000) — If the input is released longer than this, it's not part of a multi-click. (Default 250,000,000 ns, 250 ms.) too much time apart and the clicks stop being a group. they're just... strangers. 😭
• multiclick.N.output-hold-ns u32 rw (default: 100000000) — Positive pulses on the output pins last this long. (Default 100,000,000 ns, 100 ms.) short little pop of high, then she's back down. a blip. a moment. ⭐

---

🌈 AUTHOR 🌈

Sebastian Kuzminsky — the legend who built her. 👑

---

📜 LICENSE 📜

GPL — free as in freedom, bestie. 🕊️

---

and that's the whole page, no crumbs left. this was LinuxCNC Documentation, dated 2026-03-17, and you just read MULTICLICK(9) in full. go forth and count those clicks. slay. 💅✨🎀