2 * Copyright (c) 2014 Jakub Wojciech Klama <jceel@FreeBSD.org>
3 * Copyright (c) 2015-2016 Vladimir Kondratyev <wulf@FreeBSD.org>
6 * Redistribution and use in source and binary forms, with or without
7 * modification, are permitted provided that the following conditions
9 * 1. Redistributions of source code must retain the above copyright
10 * notice, this list of conditions and the following disclaimer.
11 * 2. Redistributions in binary form must reproduce the above copyright
12 * notice, this list of conditions and the following disclaimer in the
13 * documentation and/or other materials provided with the distribution.
15 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
16 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
17 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
18 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
19 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
20 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
21 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
22 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
23 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
24 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
30 #include "opt_evdev.h"
32 #include <sys/types.h>
33 #include <sys/module.h>
34 #include <sys/devfs.h>
36 #include <sys/param.h>
38 #include <sys/filio.h>
39 #include <sys/fcntl.h>
40 #include <sys/kernel.h>
41 #include <sys/malloc.h>
44 #include <sys/systm.h>
46 #include <sys/vnode.h> /* IO_NDELAY in read() */
49 #include <sys/errno.h>
51 #include <sys/device.h>
54 /* Use FreeBSD bitstring locally. */
55 #include "freebsd-bitstring.h"
57 #include <dev/misc/evdev/evdev.h>
58 #include <dev/misc/evdev/evdev_private.h>
59 #include <dev/misc/evdev/input.h>
62 #define debugf(client, fmt, args...) kprintf("evdev cdev: "fmt"\n", ##args)
64 #define debugf(client, fmt, args...)
67 #define DEF_RING_REPORTS 8
68 #define GID_INPUT 107 /* input group */
70 static d_open_t evdev_open;
71 static d_read_t evdev_read;
72 static d_write_t evdev_write;
73 static d_ioctl_t evdev_ioctl;
74 static d_kqfilter_t evdev_kqfilter;
76 static int evdev_kqread(struct knote *kn, long hint);
77 static void evdev_kqdetach(struct knote *kn);
78 static void evdev_dtor(void *);
79 static int evdev_ioctl_eviocgbit(struct evdev_dev *, int, int, caddr_t);
80 static void evdev_client_filter_queue(struct evdev_client *, uint16_t);
82 static struct dev_ops evdev_cdevsw = {
86 .d_write = evdev_write,
87 .d_ioctl = evdev_ioctl,
88 .d_kqfilter = evdev_kqfilter,
91 static struct filterops evdev_cdev_filterops = {
92 .f_flags = FILTEROP_ISFD,
94 .f_detach = evdev_kqdetach,
95 .f_event = evdev_kqread,
99 evdev_open(struct dev_open_args *ap)
101 cdev_t dev = ap->a_head.a_dev;
102 struct evdev_dev *evdev = dev->si_drv1;
103 struct evdev_client *client;
110 /* Initialize client structure */
111 buffer_size = evdev->ev_report_size * DEF_RING_REPORTS;
112 client = kmalloc(offsetof(struct evdev_client, ec_buffer) +
113 sizeof(struct input_event) * buffer_size,
114 M_EVDEV, M_WAITOK | M_ZERO);
116 /* Initialize ring buffer */
117 client->ec_buffer_size = buffer_size;
118 client->ec_buffer_head = 0;
119 client->ec_buffer_tail = 0;
120 client->ec_buffer_ready = 0;
122 client->ec_evdev = evdev;
123 lockinit(&client->ec_buffer_mtx, "evclient", 0, LK_CANRECURSE);
125 /* Avoid race with evdev_unregister */
127 if (dev->si_drv1 == NULL)
130 ret = evdev_register_client(evdev, client);
133 evdev_revoke_client(client);
135 * Unlock evdev here because non-sleepable lock held
136 * while calling devfs_set_cdevpriv upsets WITNESS
141 ret = devfs_set_cdevpriv(ap->a_fp, client, &evdev_dtor);
144 debugf(client, "cannot register evdev client");
151 evdev_dtor(void *data)
153 struct evdev_client *client = (struct evdev_client *)data;
155 EVDEV_LOCK(client->ec_evdev);
156 if (!client->ec_revoked)
157 evdev_dispose_client(client->ec_evdev, client);
158 EVDEV_UNLOCK(client->ec_evdev);
160 funsetown(&client->ec_sigio);
161 lockuninit(&client->ec_buffer_mtx);
162 kfree(client, M_EVDEV);
166 evdev_read(struct dev_read_args *ap)
168 struct uio *uio = ap->a_uio;
169 int ioflag = ap->a_ioflag;
170 struct evdev_client *client;
171 struct input_event event;
175 ret = devfs_get_cdevpriv(ap->a_fp, (void **)&client);
179 debugf(client, "read %zd bytes by thread %d", uio->uio_resid, 0);
181 if (client->ec_revoked)
184 /* Zero-sized reads are allowed for error checking */
185 if (uio->uio_resid != 0 && uio->uio_resid < sizeof(struct input_event))
188 remaining = uio->uio_resid / sizeof(struct input_event);
190 EVDEV_CLIENT_LOCKQ(client);
192 if (EVDEV_CLIENT_EMPTYQ(client)) {
193 if (ioflag & IO_NDELAY) {
196 if (remaining != 0) {
197 client->ec_blocked = true;
198 ret = lksleep(client, &client->ec_buffer_mtx,
199 PCATCH, "evread", 0);
204 while (ret == 0 && !EVDEV_CLIENT_EMPTYQ(client) && remaining > 0) {
205 memcpy(&event, &client->ec_buffer[client->ec_buffer_head],
206 sizeof(struct input_event));
207 client->ec_buffer_head =
208 (client->ec_buffer_head + 1) % client->ec_buffer_size;
211 EVDEV_CLIENT_UNLOCKQ(client);
212 ret = uiomove((void *)&event, sizeof(struct input_event), uio);
213 EVDEV_CLIENT_LOCKQ(client);
216 EVDEV_CLIENT_UNLOCKQ(client);
222 evdev_write(struct dev_write_args *ap)
224 cdev_t dev = ap->a_head.a_dev;
225 struct uio *uio = ap->a_uio;
226 struct evdev_dev *evdev = dev->si_drv1;
227 struct evdev_client *client;
228 struct input_event event;
231 ret = devfs_get_cdevpriv(ap->a_fp, (void **)&client);
235 debugf(client, "write %zd bytes by thread %d", uio->uio_resid, 0);
237 if (client->ec_revoked || evdev == NULL)
240 if (uio->uio_resid % sizeof(struct input_event) != 0) {
241 debugf(client, "write size not multiple of input_event size");
245 while (uio->uio_resid > 0 && ret == 0) {
246 ret = uiomove((void *)&event, sizeof(struct input_event), uio);
248 ret = evdev_inject_event(evdev, event.type, event.code,
256 evdev_kqfilter(struct dev_kqfilter_args *ap)
258 struct knote *kn = ap->a_kn;
260 struct evdev_client *client;
263 ret = devfs_get_cdevpriv(ap->a_fp, (void **)&client);
267 if (client->ec_revoked)
270 switch(kn->kn_filter) {
272 kn->kn_fop = &evdev_cdev_filterops;
277 kn->kn_hook = (caddr_t)client;
279 klist = &client->kqinfo.ki_note;
280 knote_insert(klist, kn);
285 evdev_kqread(struct knote *kn, long hint)
287 struct evdev_client *client;
291 client = (struct evdev_client *)kn->kn_hook;
293 /* NOTE on DragonFly v FreeBSD.
294 * FreeBSD locks the klist when calling f_event, i.e. evdev_kqread().
295 * That's why the plain assertion EVDEV_CLIENT_LOCKQ_ASSERT(client)
296 * fails on DragonFly: DragonFly does not ensure the lock associated
297 * with the klist is locked.
298 * To mimic FreeBSD's behavior, we will lock ec_buffer_mtx if
299 * it was not locked, and unlock when leaving.
301 locked = lockowned(&(client)->ec_buffer_mtx);
303 EVDEV_CLIENT_LOCKQ(client);
305 EVDEV_CLIENT_LOCKQ_ASSERT(client);
307 if (client->ec_revoked) {
308 kn->kn_flags |= EV_EOF;
311 kn->kn_data = EVDEV_CLIENT_SIZEQ(client) *
312 sizeof(struct input_event);
313 ret = !EVDEV_CLIENT_EMPTYQ(client);
316 /* Unlock if ec_buffer_mtx was not locked. */
318 EVDEV_CLIENT_UNLOCKQ(client);
325 evdev_kqdetach(struct knote *kn)
327 struct evdev_client *client;
329 client = (struct evdev_client *)kn->kn_hook;
330 knote_remove(&client->kqinfo.ki_note, kn);
334 evdev_ioctl(struct dev_ioctl_args *ap)
336 cdev_t dev = ap->a_head.a_dev;
337 u_long cmd = ap->a_cmd;
338 caddr_t data = ap->a_data;
339 struct evdev_dev *evdev = dev->si_drv1;
340 struct evdev_client *client;
341 struct input_keymap_entry *ke;
342 int ret, len, limit, type_num;
346 ret = devfs_get_cdevpriv(ap->a_fp, (void **)&client);
350 if (client->ec_revoked || evdev == NULL)
353 /* file I/O ioctl handling */
356 return (fsetown(*(int *)data, &client->ec_sigio));
359 *(int *)data = fgetown(&client->ec_sigio);
367 client->ec_async = true;
369 client->ec_async = false;
374 EVDEV_CLIENT_LOCKQ(client);
376 EVDEV_CLIENT_SIZEQ(client) * sizeof(struct input_event);
377 EVDEV_CLIENT_UNLOCKQ(client);
381 len = IOCPARM_LEN(cmd);
382 debugf(client, "ioctl called: cmd=0x%08lx, data=%p", cmd, data);
384 /* evdev fixed-length ioctls handling */
387 *(int *)data = EV_VERSION;
391 debugf(client, "EVIOCGID: bus=%d vendor=0x%04x product=0x%04x",
392 evdev->ev_id.bustype, evdev->ev_id.vendor,
393 evdev->ev_id.product);
394 memcpy(data, &evdev->ev_id, sizeof(struct input_id));
398 if (!evdev_event_supported(evdev, EV_REP))
401 memcpy(data, evdev->ev_rep, sizeof(evdev->ev_rep));
405 if (!evdev_event_supported(evdev, EV_REP))
408 evdev_inject_event(evdev, EV_REP, REP_DELAY, ((int *)data)[0]);
409 evdev_inject_event(evdev, EV_REP, REP_PERIOD,
414 /* Fake unsupported ioctl */
417 case EVIOCGKEYCODE_V2:
418 if (evdev->ev_methods == NULL ||
419 evdev->ev_methods->ev_get_keycode == NULL)
422 ke = (struct input_keymap_entry *)data;
423 evdev->ev_methods->ev_get_keycode(evdev, evdev->ev_softc, ke);
427 /* Fake unsupported ioctl */
430 case EVIOCSKEYCODE_V2:
431 if (evdev->ev_methods == NULL ||
432 evdev->ev_methods->ev_set_keycode == NULL)
435 ke = (struct input_keymap_entry *)data;
436 evdev->ev_methods->ev_set_keycode(evdev, evdev->ev_softc, ke);
439 case EVIOCGABS(0) ... EVIOCGABS(ABS_MAX):
440 if (evdev->ev_absinfo == NULL)
443 memcpy(data, &evdev->ev_absinfo[cmd - EVIOCGABS(0)],
444 sizeof(struct input_absinfo));
447 case EVIOCSABS(0) ... EVIOCSABS(ABS_MAX):
448 if (evdev->ev_absinfo == NULL)
451 code = cmd - EVIOCSABS(0);
452 /* mt-slot number can not be changed */
453 if (code == ABS_MT_SLOT)
457 evdev_set_absinfo(evdev, code, (struct input_absinfo *)data);
464 /* Fake unsupported ioctls */
470 ret = evdev_grab_client(evdev, client);
472 ret = evdev_release_client(evdev, client);
477 if (*(int *)data != 0)
481 if (dev->si_drv1 != NULL && !client->ec_revoked) {
482 evdev_dispose_client(evdev, client);
483 evdev_revoke_client(client);
489 switch (*(int *)data) {
491 client->ec_clock_id = EV_CLOCK_REALTIME;
493 case CLOCK_MONOTONIC:
494 client->ec_clock_id = EV_CLOCK_MONOTONIC;
501 /* evdev variable-length ioctls handling */
502 switch (IOCBASECMD(cmd)) {
504 strlcpy(data, evdev->ev_name, len);
508 if (evdev->ev_shortname[0] == 0)
511 strlcpy(data, evdev->ev_shortname, len);
515 if (evdev->ev_serial[0] == 0)
518 strlcpy(data, evdev->ev_serial, len);
522 limit = MIN(len, bitstr_size(INPUT_PROP_CNT));
523 memcpy(data, evdev->ev_prop_flags, limit);
526 case EVIOCGMTSLOTS(0):
527 if (evdev->ev_mt == NULL)
529 if (len < sizeof(uint32_t))
531 code = *(uint32_t *)data;
532 if (!ABS_IS_MT(code))
536 MIN(len / sizeof(int32_t) - 1, MAXIMAL_MT_SLOT(evdev) + 1);
537 for (int i = 0; i < nvalues; i++)
538 ((int32_t *)data)[i + 1] =
539 evdev_get_mt_value(evdev, i, code);
543 limit = MIN(len, bitstr_size(KEY_CNT));
545 evdev_client_filter_queue(client, EV_KEY);
546 memcpy(data, evdev->ev_key_states, limit);
551 limit = MIN(len, bitstr_size(LED_CNT));
553 evdev_client_filter_queue(client, EV_LED);
554 memcpy(data, evdev->ev_led_states, limit);
559 limit = MIN(len, bitstr_size(SND_CNT));
561 evdev_client_filter_queue(client, EV_SND);
562 memcpy(data, evdev->ev_snd_states, limit);
567 limit = MIN(len, bitstr_size(SW_CNT));
569 evdev_client_filter_queue(client, EV_SW);
570 memcpy(data, evdev->ev_sw_states, limit);
574 case EVIOCGBIT(0, 0) ... EVIOCGBIT(EV_MAX, 0):
575 type_num = IOCBASECMD(cmd) - EVIOCGBIT(0, 0);
576 debugf(client, "EVIOCGBIT(%d): data=%p, len=%d", type_num,
578 return (evdev_ioctl_eviocgbit(evdev, type_num, len, data));
585 evdev_ioctl_eviocgbit(struct evdev_dev *evdev, int type, int len, caddr_t data)
588 * We will use freebsd-bitstring.h locally. This ensures bitmap
589 * is of type (unsigned long *). DragonFly's original bitmap
590 * is (unsigned char *).
592 unsigned long *bitmap;
597 bitmap = evdev->ev_type_flags;
601 bitmap = evdev->ev_key_flags;
605 bitmap = evdev->ev_rel_flags;
609 bitmap = evdev->ev_abs_flags;
613 bitmap = evdev->ev_msc_flags;
617 bitmap = evdev->ev_led_flags;
621 bitmap = evdev->ev_snd_flags;
625 bitmap = evdev->ev_sw_flags;
630 * We don't support EV_FF now, so let's
631 * just fake it returning only zeros.
640 * Clear ioctl data buffer in case it's bigger than
645 limit = bitstr_size(limit);
646 len = MIN(limit, len);
647 memcpy(data, bitmap, len);
652 evdev_revoke_client(struct evdev_client *client)
655 EVDEV_LOCK_ASSERT(client->ec_evdev);
657 client->ec_revoked = true;
661 evdev_notify_event(struct evdev_client *client)
664 EVDEV_CLIENT_LOCKQ_ASSERT(client);
666 if (client->ec_blocked) {
667 client->ec_blocked = false;
670 if (client->ec_selected) {
671 client->ec_selected = false;
672 wakeup(&client->kqinfo);
675 KNOTE(&client->kqinfo.ki_note, 0);
677 if (client->ec_async && client->ec_sigio != NULL)
678 pgsigio(client->ec_sigio, SIGIO, 0);
682 evdev_cdev_create(struct evdev_dev *evdev)
688 * Iterate over devices input/eventX until we find a non-existing
689 * one and record its number in unit.
692 while (devfs_find_device_by_name("input/event%d", unit) != NULL) {
697 * Put unit as minor. Minor and major will determine st_rdev of
698 * eventX. Ensuring that all eventX have different major and minor
699 * will make st_rdev unique. This is needed by libinput, which
700 * determines eventX from st_rdev.
702 dev = make_dev(&evdev_cdevsw, unit, UID_ROOT, GID_INPUT,
703 0660, "input/event%d", unit);
706 dev->si_drv1 = evdev;
707 evdev->ev_cdev = dev;
708 evdev->ev_unit = unit;
715 reference_dev(evdev->ev_cdev);
722 evdev_cdev_destroy(struct evdev_dev *evdev)
725 if (evdev->ev_cdev) {
726 dev_ops_remove_minor(&evdev_cdevsw, evdev->ev_unit);
733 evdev_client_gettime(struct evdev_client *client, struct timeval *tv)
736 switch (client->ec_clock_id) {
737 case EV_CLOCK_BOOTTIME:
739 * XXX: FreeBSD does not support true POSIX monotonic clock.
740 * So aliase EV_CLOCK_BOOTTIME to EV_CLOCK_MONOTONIC.
742 case EV_CLOCK_MONOTONIC:
746 case EV_CLOCK_REALTIME:
754 evdev_client_push(struct evdev_client *client, uint16_t type, uint16_t code,
758 size_t count, head, tail, ready;
760 EVDEV_CLIENT_LOCKQ_ASSERT(client);
761 head = client->ec_buffer_head;
762 tail = client->ec_buffer_tail;
763 ready = client->ec_buffer_ready;
764 count = client->ec_buffer_size;
766 /* If queue is full drop its content and place SYN_DROPPED event */
767 if ((tail + 1) % count == head) {
768 debugf(client, "client %p: buffer overflow", client);
770 head = (tail + count - 1) % count;
771 client->ec_buffer[head] = (struct input_event) {
777 * XXX: Here is a small race window from now till the end of
778 * report. The queue is empty but client has been already
779 * notified of data readyness. Can be fixed in two ways:
780 * 1. Implement bulk insert so queue lock would not be dropped
781 * till the SYN_REPORT event.
782 * 2. Insert SYN_REPORT just now and skip remaining events
784 client->ec_buffer_head = head;
785 client->ec_buffer_ready = head;
788 client->ec_buffer[tail].type = type;
789 client->ec_buffer[tail].code = code;
790 client->ec_buffer[tail].value = value;
791 client->ec_buffer_tail = (tail + 1) % count;
793 /* Allow users to read events only after report has been completed */
794 if (type == EV_SYN && code == SYN_REPORT) {
795 evdev_client_gettime(client, &time);
796 for (; ready != client->ec_buffer_tail;
797 ready = (ready + 1) % count)
798 client->ec_buffer[ready].time = time;
799 client->ec_buffer_ready = client->ec_buffer_tail;
804 evdev_client_dumpqueue(struct evdev_client *client)
806 struct input_event *event;
807 size_t i, head, tail, ready, size;
809 head = client->ec_buffer_head;
810 tail = client->ec_buffer_tail;
811 ready = client->ec_buffer_ready;
812 size = client->ec_buffer_size;
814 kprintf("evdev client: %p\n", client);
815 kprintf("event queue: head=%zu ready=%zu tail=%zu size=%zu\n",
816 head, ready, tail, size);
818 kprintf("queue contents:\n");
820 for (i = 0; i < size; i++) {
821 event = &client->ec_buffer[i];
824 if (i < head || i > tail)
827 kprintf("type=%d code=%d value=%d ", event->type,
828 event->code, event->value);
831 kprintf("<- head\n");
833 kprintf("<- tail\n");
835 kprintf("<- ready\n");
842 evdev_client_filter_queue(struct evdev_client *client, uint16_t type)
844 struct input_event *event;
845 size_t head, tail, count, i;
846 bool last_was_syn = false;
848 EVDEV_CLIENT_LOCKQ(client);
850 i = head = client->ec_buffer_head;
851 tail = client->ec_buffer_tail;
852 count = client->ec_buffer_size;
853 client->ec_buffer_ready = client->ec_buffer_tail;
855 while (i != client->ec_buffer_tail) {
856 event = &client->ec_buffer[i];
859 /* Skip event of given type */
860 if (event->type == type)
863 /* Remove empty SYN_REPORT events */
864 if (event->type == EV_SYN && event->code == SYN_REPORT) {
868 client->ec_buffer_ready = (tail + 1) % count;
872 memcpy(&client->ec_buffer[tail], event,
873 sizeof(struct input_event));
875 last_was_syn = (event->type == EV_SYN &&
876 event->code == SYN_REPORT);
878 tail = (tail + 1) % count;
881 client->ec_buffer_head = i;
882 client->ec_buffer_tail = tail;
884 EVDEV_CLIENT_UNLOCKQ(client);