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
69 static d_open_t evdev_open;
70 static d_read_t evdev_read;
71 static d_write_t evdev_write;
72 static d_ioctl_t evdev_ioctl;
73 static d_kqfilter_t evdev_kqfilter;
75 static int evdev_kqread(struct knote *kn, long hint);
76 static void evdev_kqdetach(struct knote *kn);
77 static void evdev_dtor(void *);
78 static int evdev_ioctl_eviocgbit(struct evdev_dev *, int, int, caddr_t);
79 static void evdev_client_filter_queue(struct evdev_client *, uint16_t);
81 static struct dev_ops evdev_cdevsw = {
85 .d_write = evdev_write,
86 .d_ioctl = evdev_ioctl,
87 .d_kqfilter = evdev_kqfilter,
90 static struct filterops evdev_cdev_filterops = {
91 .f_flags = FILTEROP_ISFD,
93 .f_detach = evdev_kqdetach,
94 .f_event = evdev_kqread,
98 evdev_open(struct dev_open_args *ap)
100 cdev_t dev = ap->a_head.a_dev;
101 struct evdev_dev *evdev = dev->si_drv1;
102 struct evdev_client *client;
109 /* Initialize client structure */
110 buffer_size = evdev->ev_report_size * DEF_RING_REPORTS;
111 client = kmalloc(offsetof(struct evdev_client, ec_buffer) +
112 sizeof(struct input_event) * buffer_size,
113 M_EVDEV, M_WAITOK | M_ZERO);
115 /* Initialize ring buffer */
116 client->ec_buffer_size = buffer_size;
117 client->ec_buffer_head = 0;
118 client->ec_buffer_tail = 0;
119 client->ec_buffer_ready = 0;
121 client->ec_evdev = evdev;
122 lockinit(&client->ec_buffer_mtx, "evclient", 0, LK_CANRECURSE);
124 /* Avoid race with evdev_unregister */
126 if (dev->si_drv1 == NULL)
129 ret = evdev_register_client(evdev, client);
132 evdev_revoke_client(client);
134 * Unlock evdev here because non-sleepable lock held
135 * while calling devfs_set_cdevpriv upsets WITNESS
140 ret = devfs_set_cdevpriv(ap->a_fp, client, &evdev_dtor);
143 debugf(client, "cannot register evdev client");
150 evdev_dtor(void *data)
152 struct evdev_client *client = (struct evdev_client *)data;
154 EVDEV_LOCK(client->ec_evdev);
155 if (!client->ec_revoked)
156 evdev_dispose_client(client->ec_evdev, client);
157 EVDEV_UNLOCK(client->ec_evdev);
159 funsetown(&client->ec_sigio);
160 lockuninit(&client->ec_buffer_mtx);
161 kfree(client, M_EVDEV);
165 evdev_read(struct dev_read_args *ap)
167 struct uio *uio = ap->a_uio;
168 int ioflag = ap->a_ioflag;
169 struct evdev_client *client;
170 struct input_event event;
174 ret = devfs_get_cdevpriv(ap->a_fp, (void **)&client);
178 debugf(client, "read %zd bytes by thread %d", uio->uio_resid, 0);
180 if (client->ec_revoked)
183 /* Zero-sized reads are allowed for error checking */
184 if (uio->uio_resid != 0 && uio->uio_resid < sizeof(struct input_event))
187 remaining = uio->uio_resid / sizeof(struct input_event);
189 EVDEV_CLIENT_LOCKQ(client);
191 if (EVDEV_CLIENT_EMPTYQ(client)) {
192 if (ioflag & IO_NDELAY) {
195 if (remaining != 0) {
196 client->ec_blocked = true;
197 ret = lksleep(client, &client->ec_buffer_mtx,
198 PCATCH, "evread", 0);
203 while (ret == 0 && !EVDEV_CLIENT_EMPTYQ(client) && remaining > 0) {
204 memcpy(&event, &client->ec_buffer[client->ec_buffer_head],
205 sizeof(struct input_event));
206 client->ec_buffer_head =
207 (client->ec_buffer_head + 1) % client->ec_buffer_size;
210 EVDEV_CLIENT_UNLOCKQ(client);
211 ret = uiomove((void *)&event, sizeof(struct input_event), uio);
212 EVDEV_CLIENT_LOCKQ(client);
215 EVDEV_CLIENT_UNLOCKQ(client);
221 evdev_write(struct dev_write_args *ap)
223 cdev_t dev = ap->a_head.a_dev;
224 struct uio *uio = ap->a_uio;
225 struct evdev_dev *evdev = dev->si_drv1;
226 struct evdev_client *client;
227 struct input_event event;
230 ret = devfs_get_cdevpriv(ap->a_fp, (void **)&client);
234 debugf(client, "write %zd bytes by thread %d", uio->uio_resid, 0);
236 if (client->ec_revoked || evdev == NULL)
239 if (uio->uio_resid % sizeof(struct input_event) != 0) {
240 debugf(client, "write size not multiple of input_event size");
244 while (uio->uio_resid > 0 && ret == 0) {
245 ret = uiomove((void *)&event, sizeof(struct input_event), uio);
247 ret = evdev_inject_event(evdev, event.type, event.code,
255 evdev_kqfilter(struct dev_kqfilter_args *ap)
257 struct knote *kn = ap->a_kn;
259 struct evdev_client *client;
262 ret = devfs_get_cdevpriv(ap->a_fp, (void **)&client);
266 if (client->ec_revoked)
269 switch(kn->kn_filter) {
271 kn->kn_fop = &evdev_cdev_filterops;
276 kn->kn_hook = (caddr_t)client;
278 klist = &client->kqinfo.ki_note;
279 knote_insert(klist, kn);
284 evdev_kqread(struct knote *kn, long hint)
286 struct evdev_client *client;
290 client = (struct evdev_client *)kn->kn_hook;
292 /* NOTE on DragonFly v FreeBSD.
293 * FreeBSD locks the klist when calling f_event, i.e. evdev_kqread().
294 * That's why the plain assertion EVDEV_CLIENT_LOCKQ_ASSERT(client)
295 * fails on DragonFly: DragonFly does not ensure the lock associated
296 * with the klist is locked.
297 * To mimic FreeBSD's behavior, we will lock ec_buffer_mtx if
298 * it was not locked, and unlock when leaving.
300 locked = lockowned(&(client)->ec_buffer_mtx);
302 EVDEV_CLIENT_LOCKQ(client);
304 EVDEV_CLIENT_LOCKQ_ASSERT(client);
306 if (client->ec_revoked) {
307 kn->kn_flags |= EV_EOF;
310 kn->kn_data = EVDEV_CLIENT_SIZEQ(client) *
311 sizeof(struct input_event);
312 ret = !EVDEV_CLIENT_EMPTYQ(client);
315 /* Unlock if ec_buffer_mtx was not locked. */
317 EVDEV_CLIENT_UNLOCKQ(client);
324 evdev_kqdetach(struct knote *kn)
326 struct evdev_client *client;
328 client = (struct evdev_client *)kn->kn_hook;
329 knote_remove(&client->kqinfo.ki_note, kn);
333 evdev_ioctl(struct dev_ioctl_args *ap)
335 cdev_t dev = ap->a_head.a_dev;
336 u_long cmd = ap->a_cmd;
337 caddr_t data = ap->a_data;
338 struct evdev_dev *evdev = dev->si_drv1;
339 struct evdev_client *client;
340 struct input_keymap_entry *ke;
341 int ret, len, limit, type_num;
345 ret = devfs_get_cdevpriv(ap->a_fp, (void **)&client);
349 if (client->ec_revoked || evdev == NULL)
352 /* file I/O ioctl handling */
355 return (fsetown(*(int *)data, &client->ec_sigio));
358 *(int *)data = fgetown(&client->ec_sigio);
366 client->ec_async = true;
368 client->ec_async = false;
373 EVDEV_CLIENT_LOCKQ(client);
375 EVDEV_CLIENT_SIZEQ(client) * sizeof(struct input_event);
376 EVDEV_CLIENT_UNLOCKQ(client);
380 len = IOCPARM_LEN(cmd);
381 debugf(client, "ioctl called: cmd=0x%08lx, data=%p", cmd, data);
383 /* evdev fixed-length ioctls handling */
386 *(int *)data = EV_VERSION;
390 debugf(client, "EVIOCGID: bus=%d vendor=0x%04x product=0x%04x",
391 evdev->ev_id.bustype, evdev->ev_id.vendor,
392 evdev->ev_id.product);
393 memcpy(data, &evdev->ev_id, sizeof(struct input_id));
397 if (!evdev_event_supported(evdev, EV_REP))
400 memcpy(data, evdev->ev_rep, sizeof(evdev->ev_rep));
404 if (!evdev_event_supported(evdev, EV_REP))
407 evdev_inject_event(evdev, EV_REP, REP_DELAY, ((int *)data)[0]);
408 evdev_inject_event(evdev, EV_REP, REP_PERIOD,
413 /* Fake unsupported ioctl */
416 case EVIOCGKEYCODE_V2:
417 if (evdev->ev_methods == NULL ||
418 evdev->ev_methods->ev_get_keycode == NULL)
421 ke = (struct input_keymap_entry *)data;
422 evdev->ev_methods->ev_get_keycode(evdev, evdev->ev_softc, ke);
426 /* Fake unsupported ioctl */
429 case EVIOCSKEYCODE_V2:
430 if (evdev->ev_methods == NULL ||
431 evdev->ev_methods->ev_set_keycode == NULL)
434 ke = (struct input_keymap_entry *)data;
435 evdev->ev_methods->ev_set_keycode(evdev, evdev->ev_softc, ke);
438 case EVIOCGABS(0) ... EVIOCGABS(ABS_MAX):
439 if (evdev->ev_absinfo == NULL)
442 memcpy(data, &evdev->ev_absinfo[cmd - EVIOCGABS(0)],
443 sizeof(struct input_absinfo));
446 case EVIOCSABS(0) ... EVIOCSABS(ABS_MAX):
447 if (evdev->ev_absinfo == NULL)
450 code = cmd - EVIOCSABS(0);
451 /* mt-slot number can not be changed */
452 if (code == ABS_MT_SLOT)
456 evdev_set_absinfo(evdev, code, (struct input_absinfo *)data);
463 /* Fake unsupported ioctls */
469 ret = evdev_grab_client(evdev, client);
471 ret = evdev_release_client(evdev, client);
476 if (*(int *)data != 0)
480 if (dev->si_drv1 != NULL && !client->ec_revoked) {
481 evdev_dispose_client(evdev, client);
482 evdev_revoke_client(client);
488 switch (*(int *)data) {
490 client->ec_clock_id = EV_CLOCK_REALTIME;
492 case CLOCK_MONOTONIC:
493 client->ec_clock_id = EV_CLOCK_MONOTONIC;
500 /* evdev variable-length ioctls handling */
501 switch (IOCBASECMD(cmd)) {
503 strlcpy(data, evdev->ev_name, len);
507 if (evdev->ev_shortname[0] == 0)
510 strlcpy(data, evdev->ev_shortname, len);
514 if (evdev->ev_serial[0] == 0)
517 strlcpy(data, evdev->ev_serial, len);
521 limit = MIN(len, bitstr_size(INPUT_PROP_CNT));
522 memcpy(data, evdev->ev_prop_flags, limit);
525 case EVIOCGMTSLOTS(0):
526 if (evdev->ev_mt == NULL)
528 if (len < sizeof(uint32_t))
530 code = *(uint32_t *)data;
531 if (!ABS_IS_MT(code))
535 MIN(len / sizeof(int32_t) - 1, MAXIMAL_MT_SLOT(evdev) + 1);
536 for (int i = 0; i < nvalues; i++)
537 ((int32_t *)data)[i + 1] =
538 evdev_get_mt_value(evdev, i, code);
542 limit = MIN(len, bitstr_size(KEY_CNT));
544 evdev_client_filter_queue(client, EV_KEY);
545 memcpy(data, evdev->ev_key_states, limit);
550 limit = MIN(len, bitstr_size(LED_CNT));
552 evdev_client_filter_queue(client, EV_LED);
553 memcpy(data, evdev->ev_led_states, limit);
558 limit = MIN(len, bitstr_size(SND_CNT));
560 evdev_client_filter_queue(client, EV_SND);
561 memcpy(data, evdev->ev_snd_states, limit);
566 limit = MIN(len, bitstr_size(SW_CNT));
568 evdev_client_filter_queue(client, EV_SW);
569 memcpy(data, evdev->ev_sw_states, limit);
573 case EVIOCGBIT(0, 0) ... EVIOCGBIT(EV_MAX, 0):
574 type_num = IOCBASECMD(cmd) - EVIOCGBIT(0, 0);
575 debugf(client, "EVIOCGBIT(%d): data=%p, len=%d", type_num,
577 return (evdev_ioctl_eviocgbit(evdev, type_num, len, data));
584 evdev_ioctl_eviocgbit(struct evdev_dev *evdev, int type, int len, caddr_t data)
587 * We will use freebsd-bitstring.h locally. This ensures bitmap
588 * is of type (unsigned long *). DragonFly's original bitmap
589 * is (unsigned char *).
591 unsigned long *bitmap;
596 bitmap = evdev->ev_type_flags;
600 bitmap = evdev->ev_key_flags;
604 bitmap = evdev->ev_rel_flags;
608 bitmap = evdev->ev_abs_flags;
612 bitmap = evdev->ev_msc_flags;
616 bitmap = evdev->ev_led_flags;
620 bitmap = evdev->ev_snd_flags;
624 bitmap = evdev->ev_sw_flags;
629 * We don't support EV_FF now, so let's
630 * just fake it returning only zeros.
639 * Clear ioctl data buffer in case it's bigger than
644 limit = bitstr_size(limit);
645 len = MIN(limit, len);
646 memcpy(data, bitmap, len);
651 evdev_revoke_client(struct evdev_client *client)
654 EVDEV_LOCK_ASSERT(client->ec_evdev);
656 client->ec_revoked = true;
660 evdev_notify_event(struct evdev_client *client)
663 EVDEV_CLIENT_LOCKQ_ASSERT(client);
665 if (client->ec_blocked) {
666 client->ec_blocked = false;
669 if (client->ec_selected) {
670 client->ec_selected = false;
671 wakeup(&client->kqinfo);
674 KNOTE(&client->kqinfo.ki_note, 0);
676 if (client->ec_async && client->ec_sigio != NULL)
677 pgsigio(client->ec_sigio, SIGIO, 0);
681 evdev_cdev_create(struct evdev_dev *evdev)
687 * Iterate over devices input/eventX until we find a non-existing
688 * one and record its number in unit.
691 while (devfs_find_device_by_name("input/event%d", unit) != NULL) {
696 * Put unit as minor. Minor and major will determine st_rdev of
697 * eventX. Ensuring that all eventX have different major and minor
698 * will make st_rdev unique. This is needed by libinput, which
699 * determines eventX from st_rdev.
701 dev = make_dev(&evdev_cdevsw, unit, UID_ROOT, GID_WHEEL, 0600,
702 "input/event%d", unit);
705 dev->si_drv1 = evdev;
706 evdev->ev_cdev = dev;
707 evdev->ev_unit = unit;
714 reference_dev(evdev->ev_cdev);
721 evdev_cdev_destroy(struct evdev_dev *evdev)
724 if (evdev->ev_cdev) {
725 dev_ops_remove_minor(&evdev_cdevsw, evdev->ev_unit);
732 evdev_client_gettime(struct evdev_client *client, struct timeval *tv)
735 switch (client->ec_clock_id) {
736 case EV_CLOCK_BOOTTIME:
738 * XXX: FreeBSD does not support true POSIX monotonic clock.
739 * So aliase EV_CLOCK_BOOTTIME to EV_CLOCK_MONOTONIC.
741 case EV_CLOCK_MONOTONIC:
745 case EV_CLOCK_REALTIME:
753 evdev_client_push(struct evdev_client *client, uint16_t type, uint16_t code,
757 size_t count, head, tail, ready;
759 EVDEV_CLIENT_LOCKQ_ASSERT(client);
760 head = client->ec_buffer_head;
761 tail = client->ec_buffer_tail;
762 ready = client->ec_buffer_ready;
763 count = client->ec_buffer_size;
765 /* If queue is full drop its content and place SYN_DROPPED event */
766 if ((tail + 1) % count == head) {
767 debugf(client, "client %p: buffer overflow", client);
769 head = (tail + count - 1) % count;
770 client->ec_buffer[head] = (struct input_event) {
776 * XXX: Here is a small race window from now till the end of
777 * report. The queue is empty but client has been already
778 * notified of data readyness. Can be fixed in two ways:
779 * 1. Implement bulk insert so queue lock would not be dropped
780 * till the SYN_REPORT event.
781 * 2. Insert SYN_REPORT just now and skip remaining events
783 client->ec_buffer_head = head;
784 client->ec_buffer_ready = head;
787 client->ec_buffer[tail].type = type;
788 client->ec_buffer[tail].code = code;
789 client->ec_buffer[tail].value = value;
790 client->ec_buffer_tail = (tail + 1) % count;
792 /* Allow users to read events only after report has been completed */
793 if (type == EV_SYN && code == SYN_REPORT) {
794 evdev_client_gettime(client, &time);
795 for (; ready != client->ec_buffer_tail;
796 ready = (ready + 1) % count)
797 client->ec_buffer[ready].time = time;
798 client->ec_buffer_ready = client->ec_buffer_tail;
803 evdev_client_dumpqueue(struct evdev_client *client)
805 struct input_event *event;
806 size_t i, head, tail, ready, size;
808 head = client->ec_buffer_head;
809 tail = client->ec_buffer_tail;
810 ready = client->ec_buffer_ready;
811 size = client->ec_buffer_size;
813 kprintf("evdev client: %p\n", client);
814 kprintf("event queue: head=%zu ready=%zu tail=%zu size=%zu\n",
815 head, ready, tail, size);
817 kprintf("queue contents:\n");
819 for (i = 0; i < size; i++) {
820 event = &client->ec_buffer[i];
823 if (i < head || i > tail)
826 kprintf("type=%d code=%d value=%d ", event->type,
827 event->code, event->value);
830 kprintf("<- head\n");
832 kprintf("<- tail\n");
834 kprintf("<- ready\n");
841 evdev_client_filter_queue(struct evdev_client *client, uint16_t type)
843 struct input_event *event;
844 size_t head, tail, count, i;
845 bool last_was_syn = false;
847 EVDEV_CLIENT_LOCKQ(client);
849 i = head = client->ec_buffer_head;
850 tail = client->ec_buffer_tail;
851 count = client->ec_buffer_size;
852 client->ec_buffer_ready = client->ec_buffer_tail;
854 while (i != client->ec_buffer_tail) {
855 event = &client->ec_buffer[i];
858 /* Skip event of given type */
859 if (event->type == type)
862 /* Remove empty SYN_REPORT events */
863 if (event->type == EV_SYN && event->code == SYN_REPORT) {
867 client->ec_buffer_ready = (tail + 1) % count;
871 memcpy(&client->ec_buffer[tail], event,
872 sizeof(struct input_event));
874 last_was_syn = (event->type == EV_SYN &&
875 event->code == SYN_REPORT);
877 tail = (tail + 1) % count;
880 client->ec_buffer_head = i;
881 client->ec_buffer_tail = tail;
883 EVDEV_CLIENT_UNLOCKQ(client);