WSMOUSE(9) | Kernel Developer's Manual | WSMOUSE(9) |
wsmouse
, wsmouse_input
,
wsmousedevprint
—
#include <dev/wscons/wsconsio.h>
#include
<dev/wscons/wsmousevar.h>
void
wsmouse_input
(struct
device *msdev, u_int
btns, int x,
int y,
int z,
int w,
u_int flags);
int
wsmousedevprint
(void
*aux, const char
*pnp);
wsmouse
module is a component of the
wscons(9) framework to provide
machine-independent mouse support. Most of the support is provided by the
wsmouse(4) device driver, which
must be a child of the hardware device driver.
int (*enable)(void *); int (*ioctl)(void *v, u_long cmd, void *data, int flag, struct lwp *l); void (*disable)(void *);
The enable member defines the function to be called to enable monitoring pointer movements and passing these events to wscons. The disable member defines the function to disable movement events. The ioctl member defines the function to be called to perform mouse-specific ioctl calls.
There is a void * cookie provided by the mouse driver associated with these functions, which is passed to them when they are invoked.
const struct wsmouse_accessops *accessops; void *accesscookie;
wsmouse_input
(msdev,
btns, x,
y, z, w,
flags)config_found
() on attaching the child
wsmouse(4) to specify
the mouse device.WSCONS_EVENT_MOUSE_DOWN
event on wsmouse(4)
device) should be set, and bits for released buttons (which will cause
the WSCONS_EVENT_MOUSE_UP
event) should be
zero. The left most button state should be in LSB, i.e. for typical
three button mouse, the left button is 0x01, the middle button is
0x02, and the right button is 0x04.wsmouse_precision_scroll
(msdev,
x, y)This is used when higher precision scrolling events are
required than what can be provided by a typical scroll wheel. This
function generates WSCONS_EVENT_HSCROLL
(for
scrolling on the X axis) and
WSCONS_EVENT_VSCROLL
(for scrolling on the X
axis) events.
The coordinates are adjusted for speed according to the
formula: x * 4096 / scroll_unit
The scroll_unit
is configured through
the wsmouse(4) ioctl
interface, specifically the WSMOUSEIO_SETPARAMS
keys WSMOUSECFG_HORIZSCROLLDIST
and
WSMOUSECFG_VERTSCROLLDIST
.
wsmousedevprint
(aux,
pnp)config_found
(). (see
autoconf(9)).config_found
() to
perform the attach (see
autoconf(9)).
wsmouse_input
().
The wscons framework calls back into the hardware driver by
invoking the functions that are specified in the accessops
structure. The enable
() and
disable
() functions are relatively simple and
self-explanatory. The ioctl
() function is called by
the wscons interface to perform mouse-specific ioctl operations (see
ioctl(2)). The argument
cmd to the ioctl
() function
specifies the specific command to perform using the data
data. Valid commands are listed in
sys/dev/wscons/wsconsio.h.
wsmouse
module itself is implemented within the file
sys/dev/wscons/wsmouse.c.
ioctl(2) operations are listed in
sys/dev/wscons/wsconsio.h.
October 11, 2021 | NetBSD 10.0 |