test/litest.h

   1 /*
   2  * Copyright © 2013 Red Hat, Inc.
   3  *
   4  * Permission to use, copy, modify, distribute, and sell this software and its
   5  * documentation for any purpose is hereby granted without fee, provided that
   6  * the above copyright notice appear in all copies and that both that copyright
   7  * notice and this permission notice appear in supporting documentation, and
   8  * that the name of the copyright holders not be used in advertising or
   9  * publicity pertaining to distribution of the software without specific,
  10  * written prior permission.  The copyright holders make no representations
  11  * about the suitability of this software for any purpose.  It is provided "as
  12  * is" without express or implied warranty.
  13  *
  14  * THE COPYRIGHT HOLDERS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
  15  * INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
  16  * EVENT SHALL THE COPYRIGHT HOLDERS BE LIABLE FOR ANY SPECIAL, INDIRECT OR
  17  * CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
  18  * DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
  19  * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
  20  * OF THIS SOFTWARE.
  21  */
  22
  23 #if HAVE_CONFIG_H
  24 #include "config.h"
  25 #endif
  26
  27 #ifndef LITEST_H
  28 #define LITEST_H
  29
  30 #include <stdbool.h>
  31 #include <check.h>
  32 #include <libevdev/libevdev.h>
  33 #include <libevdev/libevdev-uinput.h>
  34 #include <libinput.h>
  35
  36 enum litest_device_type {
  37         LITEST_NO_DEVICE = -1,
  38         LITEST_SYNAPTICS_CLICKPAD = -2,
  39         LITEST_SYNAPTICS_TOUCHPAD = -3,
  40         LITEST_SYNAPTICS_TOPBUTTONPAD = -4,
  41         LITEST_BCM5974 = -5,
  42         LITEST_KEYBOARD = -6,
  43         LITEST_TRACKPOINT = -7,
  44         LITEST_MOUSE = -8,
  45         LITEST_WACOM_TOUCH = -9,
  46         LITEST_ALPS_SEMI_MT = -10,
  47         LITEST_GENERIC_SINGLETOUCH = -11,
  48 };
  49
  50 enum litest_device_feature {
  51         LITEST_DISABLE_DEVICE = -1,
  52         LITEST_ANY = 0,
  53         LITEST_TOUCHPAD = 1 << 0,
  54         LITEST_CLICKPAD = 1 << 1,
  55         LITEST_BUTTON = 1 << 2,
  56         LITEST_KEYS = 1 << 3,
  57         LITEST_POINTER = 1 << 4,
  58         LITEST_WHEEL = 1 << 5,
  59         LITEST_TOUCH = 1 << 6,
  60         LITEST_SINGLE_TOUCH = 1 << 7,
  61         LITEST_APPLE_CLICKPAD = 1 << 8,
  62         LITEST_TOPBUTTONPAD = 1 << 9,
  63         LITEST_SEMI_MT = 1 << 10,
  64 };
  65
  66 struct litest_device {
  67         struct libevdev *evdev;
  68         struct libevdev_uinput *uinput;
  69         struct libinput *libinput;
  70         bool owns_context;
  71         struct libinput_device *libinput_device;
  72         struct litest_device_interface *interface;
  73
  74         int ntouches_down;
  75         void *private; /* device-specific data */
  76 };
  77
  78 struct libinput *litest_create_context(void);
  79
  80 void litest_add(const char *name, void *func,
  81                 enum litest_device_feature required_feature,
  82                 enum litest_device_feature excluded_feature);
  83 void
  84 litest_add_for_device(const char *name,
  85                       void *func,
  86                       enum litest_device_type type);
  87 void litest_add_no_device(const char *name, void *func);
  88
  89 int litest_run(int argc, char **argv);
  90 struct litest_device * litest_create_device(enum litest_device_type which);
  91 struct libevdev_uinput *
  92 litest_create_uinput_device_from_description(const char *name,
  93                                              const struct input_id *id,
  94                                              const struct input_absinfo *abs,
  95                                              const int *events);
  96 struct litest_device *
  97 litest_create_device_with_overrides(enum litest_device_type which,
  98                                     const char *name_override,
  99                                     struct input_id *id_override,
 100                                     const struct input_absinfo *abs_override,
 101                                     const int *events_override);
 102 struct litest_device *
 103 litest_add_device_with_overrides(struct libinput *libinput,
 104                                  enum litest_device_type which,
 105                                  const char *name_override,
 106                                  struct input_id *id_override,
 107                                  const struct input_absinfo *abs_override,
 108                                  const int *events_override);
 109
 110 struct litest_device *litest_current_device(void);
 111 void litest_delete_device(struct litest_device *d);
 112 int litest_handle_events(struct litest_device *d);
 113
 114 void litest_event(struct litest_device *t,
 115                   unsigned int type,
 116                   unsigned int code,
 117                   int value);
 118 int litest_auto_assign_value(struct litest_device *d,
 119                              const struct input_event *ev,
 120                              int slot, double x, double y);
 121 void litest_touch_up(struct litest_device *d, unsigned int slot);
 122 void litest_touch_move(struct litest_device *d,
 123                        unsigned int slot,
 124                        double x,
 125                        double y);
 126 void litest_touch_down(struct litest_device *d,
 127                        unsigned int slot,
 128                        double x,
 129                        double y);
 130 void litest_touch_move_to(struct litest_device *d,
 131                           unsigned int slot,
 132                           double x_from, double y_from,
 133                           double x_to, double y_to,
 134                           int steps);
 135 void litest_button_click(struct litest_device *d,
 136                          unsigned int button,
 137                          bool is_press);
 138 void litest_keyboard_key(struct litest_device *d,
 139                          unsigned int key,
 140                          bool is_press);
 141 void litest_wait_for_event(struct libinput *li);
 142 void litest_wait_for_event_of_type(struct libinput *li, ...);
 143 void litest_drain_events(struct libinput *li);
 144 void litest_assert_empty_queue(struct libinput *li);
 145
 146 struct libevdev_uinput * litest_create_uinput_device(const char *name,
 147                                                      struct input_id *id,
 148                                                      ...);
 149 struct libevdev_uinput * litest_create_uinput_abs_device(const char *name,
 150                                                          struct input_id *id,
 151                                                          const struct input_absinfo *abs,
 152                                                          ...);
 153
 154 #ifndef ck_assert_notnull
 155 #define ck_assert_notnull(ptr) ck_assert_ptr_ne(ptr, NULL)
 156 #endif
 157
 158 #endif /* LITEST_H */