DOKK / manpages / debian 12 / linuxcnc-uspace / multiclick.9.en
MULTICLICK(9) HAL Component MULTICLICK(9)

multiclick - Single-, double-, triple-, and quadruple-click detector

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

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.

A double-click is defined as two clicks, separated by at most 'max-space-ns' nanoseconds with the 'in' pin in the False state.

I bet you can guess the definition of triple- and quadruple-click.

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.

The '*-click' pins go high as soon as the input detects the correct number of clicks.

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. This is useful for triggering halui MDI commands.

Detect single-, double-, triple-, and quadruple-clicks

The input line, this is where we look for clicks.
Goes high briefly when a single-click is detected on the 'in' pin.
Goes high briefly when a single-click is detected on the 'in' pin and no second click followed it.
Goes high briefly when a double-click is detected on the 'in' pin.
Goes high briefly when a double-click is detected on the 'in' pin and no third click followed it.
Goes high briefly when a triple-click is detected on the 'in' pin.
Goes high briefly when a triple-click is detected on the 'in' pin and no fourth click followed it.
Goes high briefly when a quadruple-click is detected on the 'in' pin.
Goes high briefly when a quadruple-click is detected on the 'in' pin and no fifth click followed it.

If FALSE (the default), clicks start with rising edges. If TRUE, clicks start with falling edges.
If the input is held down longer than this, it's not part of a multi-click. (Default 250,000,000 ns, 250 ms.)
If the input is released longer than this, it's not part of a multi-click. (Default 250,000,000 ns, 250 ms.)
Positive pulses on the output pins last this long. (Default 100,000,000 ns, 100 ms.)

Sebastian Kuzminsky

GPL

2023-02-10 LinuxCNC Documentation