Peter Maydell | e16f4c8 | 2016-01-29 17:49:51 +0000 | [diff] [blame] | 1 | #include "qemu/osdep.h" |
Gerd Hoffmann | c8b405b | 2013-11-27 10:35:26 +0100 | [diff] [blame] | 2 | #include "sysemu/sysemu.h" |
Markus Armbruster | e688df6 | 2018-02-01 12:18:31 +0100 | [diff] [blame] | 3 | #include "qapi/error.h" |
Markus Armbruster | 9af2398 | 2018-02-11 10:36:01 +0100 | [diff] [blame] | 4 | #include "qapi/qapi-commands-ui.h" |
Markus Armbruster | 452fcdb | 2018-02-01 12:18:39 +0100 | [diff] [blame] | 5 | #include "qapi/qmp/qdict.h" |
Markus Armbruster | d49b683 | 2015-03-17 18:29:20 +0100 | [diff] [blame] | 6 | #include "qemu/error-report.h" |
Gerd Hoffmann | c43ce55 | 2013-12-04 15:20:05 +0100 | [diff] [blame] | 7 | #include "trace.h" |
Gerd Hoffmann | c8b405b | 2013-11-27 10:35:26 +0100 | [diff] [blame] | 8 | #include "ui/input.h" |
Gerd Hoffmann | c43ce55 | 2013-12-04 15:20:05 +0100 | [diff] [blame] | 9 | #include "ui/console.h" |
Pavel Dovgalyuk | ee31299 | 2015-09-17 19:25:24 +0300 | [diff] [blame] | 10 | #include "sysemu/replay.h" |
Gerd Hoffmann | c8b405b | 2013-11-27 10:35:26 +0100 | [diff] [blame] | 11 | |
| 12 | struct QemuInputHandlerState { |
| 13 | DeviceState *dev; |
| 14 | QemuInputHandler *handler; |
| 15 | int id; |
| 16 | int events; |
Gerd Hoffmann | 6f5943c | 2014-05-19 15:18:37 +0200 | [diff] [blame] | 17 | QemuConsole *con; |
Gerd Hoffmann | c8b405b | 2013-11-27 10:35:26 +0100 | [diff] [blame] | 18 | QTAILQ_ENTRY(QemuInputHandlerState) node; |
| 19 | }; |
Gerd Hoffmann | be1a717 | 2014-05-28 13:02:40 +0200 | [diff] [blame] | 20 | |
| 21 | typedef struct QemuInputEventQueue QemuInputEventQueue; |
Paolo Bonzini | f481ee2 | 2018-12-06 11:56:15 +0100 | [diff] [blame] | 22 | typedef QTAILQ_HEAD(QemuInputEventQueueHead, QemuInputEventQueue) |
| 23 | QemuInputEventQueueHead; |
| 24 | |
Gerd Hoffmann | be1a717 | 2014-05-28 13:02:40 +0200 | [diff] [blame] | 25 | struct QemuInputEventQueue { |
| 26 | enum { |
| 27 | QEMU_INPUT_QUEUE_DELAY = 1, |
| 28 | QEMU_INPUT_QUEUE_EVENT, |
| 29 | QEMU_INPUT_QUEUE_SYNC, |
| 30 | } type; |
| 31 | QEMUTimer *timer; |
| 32 | uint32_t delay_ms; |
| 33 | QemuConsole *src; |
| 34 | InputEvent *evt; |
| 35 | QTAILQ_ENTRY(QemuInputEventQueue) node; |
| 36 | }; |
| 37 | |
Gerd Hoffmann | c8b405b | 2013-11-27 10:35:26 +0100 | [diff] [blame] | 38 | static QTAILQ_HEAD(, QemuInputHandlerState) handlers = |
| 39 | QTAILQ_HEAD_INITIALIZER(handlers); |
Gerd Hoffmann | 4a33f45 | 2013-12-05 11:23:42 +0100 | [diff] [blame] | 40 | static NotifierList mouse_mode_notifiers = |
| 41 | NOTIFIER_LIST_INITIALIZER(mouse_mode_notifiers); |
Gerd Hoffmann | c8b405b | 2013-11-27 10:35:26 +0100 | [diff] [blame] | 42 | |
Paolo Bonzini | f481ee2 | 2018-12-06 11:56:15 +0100 | [diff] [blame] | 43 | static QemuInputEventQueueHead kbd_queue = QTAILQ_HEAD_INITIALIZER(kbd_queue); |
Gerd Hoffmann | be1a717 | 2014-05-28 13:02:40 +0200 | [diff] [blame] | 44 | static QEMUTimer *kbd_timer; |
| 45 | static uint32_t kbd_default_delay_ms = 10; |
Gerd Hoffmann | fa18f36 | 2017-04-28 10:42:37 +0200 | [diff] [blame] | 46 | static uint32_t queue_count; |
| 47 | static uint32_t queue_limit = 1024; |
Gerd Hoffmann | be1a717 | 2014-05-28 13:02:40 +0200 | [diff] [blame] | 48 | |
Gerd Hoffmann | c8b405b | 2013-11-27 10:35:26 +0100 | [diff] [blame] | 49 | QemuInputHandlerState *qemu_input_handler_register(DeviceState *dev, |
| 50 | QemuInputHandler *handler) |
| 51 | { |
| 52 | QemuInputHandlerState *s = g_new0(QemuInputHandlerState, 1); |
| 53 | static int id = 1; |
| 54 | |
| 55 | s->dev = dev; |
| 56 | s->handler = handler; |
| 57 | s->id = id++; |
| 58 | QTAILQ_INSERT_TAIL(&handlers, s, node); |
Gerd Hoffmann | 4a33f45 | 2013-12-05 11:23:42 +0100 | [diff] [blame] | 59 | |
| 60 | qemu_input_check_mode_change(); |
Gerd Hoffmann | c8b405b | 2013-11-27 10:35:26 +0100 | [diff] [blame] | 61 | return s; |
| 62 | } |
| 63 | |
| 64 | void qemu_input_handler_activate(QemuInputHandlerState *s) |
| 65 | { |
| 66 | QTAILQ_REMOVE(&handlers, s, node); |
| 67 | QTAILQ_INSERT_HEAD(&handlers, s, node); |
Gerd Hoffmann | 4a33f45 | 2013-12-05 11:23:42 +0100 | [diff] [blame] | 68 | qemu_input_check_mode_change(); |
Gerd Hoffmann | c8b405b | 2013-11-27 10:35:26 +0100 | [diff] [blame] | 69 | } |
| 70 | |
Gerd Hoffmann | 528728f | 2014-03-16 00:38:45 +0100 | [diff] [blame] | 71 | void qemu_input_handler_deactivate(QemuInputHandlerState *s) |
| 72 | { |
| 73 | QTAILQ_REMOVE(&handlers, s, node); |
| 74 | QTAILQ_INSERT_TAIL(&handlers, s, node); |
| 75 | qemu_input_check_mode_change(); |
| 76 | } |
| 77 | |
Gerd Hoffmann | c8b405b | 2013-11-27 10:35:26 +0100 | [diff] [blame] | 78 | void qemu_input_handler_unregister(QemuInputHandlerState *s) |
| 79 | { |
| 80 | QTAILQ_REMOVE(&handlers, s, node); |
| 81 | g_free(s); |
Gerd Hoffmann | 4a33f45 | 2013-12-05 11:23:42 +0100 | [diff] [blame] | 82 | qemu_input_check_mode_change(); |
Gerd Hoffmann | c8b405b | 2013-11-27 10:35:26 +0100 | [diff] [blame] | 83 | } |
| 84 | |
Gerd Hoffmann | 6f5943c | 2014-05-19 15:18:37 +0200 | [diff] [blame] | 85 | void qemu_input_handler_bind(QemuInputHandlerState *s, |
| 86 | const char *device_id, int head, |
| 87 | Error **errp) |
| 88 | { |
Gerd Hoffmann | 6f5943c | 2014-05-19 15:18:37 +0200 | [diff] [blame] | 89 | QemuConsole *con; |
Gerd Hoffmann | f2c1d54 | 2016-01-12 11:45:43 +0100 | [diff] [blame] | 90 | Error *err = NULL; |
Gerd Hoffmann | 6f5943c | 2014-05-19 15:18:37 +0200 | [diff] [blame] | 91 | |
Gerd Hoffmann | f2c1d54 | 2016-01-12 11:45:43 +0100 | [diff] [blame] | 92 | con = qemu_console_lookup_by_device_name(device_id, head, &err); |
| 93 | if (err) { |
| 94 | error_propagate(errp, err); |
Gerd Hoffmann | 6f5943c | 2014-05-19 15:18:37 +0200 | [diff] [blame] | 95 | return; |
| 96 | } |
| 97 | |
| 98 | s->con = con; |
| 99 | } |
| 100 | |
Gerd Hoffmann | c8b405b | 2013-11-27 10:35:26 +0100 | [diff] [blame] | 101 | static QemuInputHandlerState* |
Gerd Hoffmann | 6f5943c | 2014-05-19 15:18:37 +0200 | [diff] [blame] | 102 | qemu_input_find_handler(uint32_t mask, QemuConsole *con) |
Gerd Hoffmann | c8b405b | 2013-11-27 10:35:26 +0100 | [diff] [blame] | 103 | { |
| 104 | QemuInputHandlerState *s; |
| 105 | |
| 106 | QTAILQ_FOREACH(s, &handlers, node) { |
Gerd Hoffmann | 6f5943c | 2014-05-19 15:18:37 +0200 | [diff] [blame] | 107 | if (s->con == NULL || s->con != con) { |
| 108 | continue; |
| 109 | } |
| 110 | if (mask & s->handler->mask) { |
| 111 | return s; |
| 112 | } |
| 113 | } |
| 114 | |
| 115 | QTAILQ_FOREACH(s, &handlers, node) { |
| 116 | if (s->con != NULL) { |
| 117 | continue; |
| 118 | } |
Gerd Hoffmann | c8b405b | 2013-11-27 10:35:26 +0100 | [diff] [blame] | 119 | if (mask & s->handler->mask) { |
| 120 | return s; |
| 121 | } |
| 122 | } |
| 123 | return NULL; |
| 124 | } |
| 125 | |
Gerd Hoffmann | 6575ccd | 2016-01-12 12:39:33 +0100 | [diff] [blame] | 126 | void qmp_input_send_event(bool has_device, const char *device, |
| 127 | bool has_head, int64_t head, |
| 128 | InputEventList *events, Error **errp) |
Marcelo Tosatti | 50c6617 | 2014-09-30 18:10:17 -0300 | [diff] [blame] | 129 | { |
| 130 | InputEventList *e; |
| 131 | QemuConsole *con; |
Gerd Hoffmann | b98d26e | 2016-01-12 12:11:14 +0100 | [diff] [blame] | 132 | Error *err = NULL; |
Marcelo Tosatti | 50c6617 | 2014-09-30 18:10:17 -0300 | [diff] [blame] | 133 | |
Amos Kong | 51fc447 | 2014-11-07 12:41:25 +0800 | [diff] [blame] | 134 | con = NULL; |
Gerd Hoffmann | b98d26e | 2016-01-12 12:11:14 +0100 | [diff] [blame] | 135 | if (has_device) { |
| 136 | if (!has_head) { |
| 137 | head = 0; |
| 138 | } |
| 139 | con = qemu_console_lookup_by_device_name(device, head, &err); |
| 140 | if (err) { |
| 141 | error_propagate(errp, err); |
Amos Kong | 51fc447 | 2014-11-07 12:41:25 +0800 | [diff] [blame] | 142 | return; |
| 143 | } |
Marcelo Tosatti | 50c6617 | 2014-09-30 18:10:17 -0300 | [diff] [blame] | 144 | } |
| 145 | |
| 146 | if (!runstate_is_running() && !runstate_check(RUN_STATE_SUSPENDED)) { |
| 147 | error_setg(errp, "VM not running"); |
| 148 | return; |
| 149 | } |
| 150 | |
| 151 | for (e = events; e != NULL; e = e->next) { |
| 152 | InputEvent *event = e->value; |
| 153 | |
Eric Blake | 568c73a | 2015-10-26 16:34:58 -0600 | [diff] [blame] | 154 | if (!qemu_input_find_handler(1 << event->type, con)) { |
Marcelo Tosatti | 50c6617 | 2014-09-30 18:10:17 -0300 | [diff] [blame] | 155 | error_setg(errp, "Input handler not found for " |
| 156 | "event type %s", |
Markus Armbruster | 977c736 | 2017-08-24 10:46:08 +0200 | [diff] [blame] | 157 | InputEventKind_str(event->type)); |
Marcelo Tosatti | 50c6617 | 2014-09-30 18:10:17 -0300 | [diff] [blame] | 158 | return; |
| 159 | } |
| 160 | } |
| 161 | |
| 162 | for (e = events; e != NULL; e = e->next) { |
Daniel P. Berrange | af07e5f | 2017-09-29 11:12:00 +0100 | [diff] [blame] | 163 | InputEvent *evt = e->value; |
Marcelo Tosatti | 50c6617 | 2014-09-30 18:10:17 -0300 | [diff] [blame] | 164 | |
Daniel P. Berrange | af07e5f | 2017-09-29 11:12:00 +0100 | [diff] [blame] | 165 | if (evt->type == INPUT_EVENT_KIND_KEY && |
| 166 | evt->u.key.data->key->type == KEY_VALUE_KIND_NUMBER) { |
| 167 | KeyValue *key = evt->u.key.data->key; |
Daniel P. Berrange | 237925b | 2017-10-19 15:28:42 +0100 | [diff] [blame] | 168 | QKeyCode code = qemu_input_key_number_to_qcode(key->u.number.data); |
Daniel P. Berrange | af07e5f | 2017-09-29 11:12:00 +0100 | [diff] [blame] | 169 | qemu_input_event_send_key_qcode(con, code, evt->u.key.data->down); |
| 170 | } else { |
| 171 | qemu_input_event_send(con, evt); |
| 172 | } |
Marcelo Tosatti | 50c6617 | 2014-09-30 18:10:17 -0300 | [diff] [blame] | 173 | } |
| 174 | |
| 175 | qemu_input_event_sync(); |
| 176 | } |
| 177 | |
Philippe Voinov | 9cfa7ab | 2017-05-05 15:39:52 +0200 | [diff] [blame] | 178 | static int qemu_input_transform_invert_abs_value(int value) |
| 179 | { |
| 180 | return (int64_t)INPUT_EVENT_ABS_MAX - value + INPUT_EVENT_ABS_MIN; |
| 181 | } |
| 182 | |
Gerd Hoffmann | d353543 | 2013-11-28 11:29:33 +0100 | [diff] [blame] | 183 | static void qemu_input_transform_abs_rotate(InputEvent *evt) |
| 184 | { |
Eric Blake | 32bafa8 | 2016-03-17 16:48:37 -0600 | [diff] [blame] | 185 | InputMoveEvent *move = evt->u.abs.data; |
Gerd Hoffmann | d353543 | 2013-11-28 11:29:33 +0100 | [diff] [blame] | 186 | switch (graphic_rotate) { |
| 187 | case 90: |
Eric Blake | b5a1b44 | 2016-03-03 09:16:49 -0700 | [diff] [blame] | 188 | if (move->axis == INPUT_AXIS_X) { |
| 189 | move->axis = INPUT_AXIS_Y; |
| 190 | } else if (move->axis == INPUT_AXIS_Y) { |
| 191 | move->axis = INPUT_AXIS_X; |
Philippe Voinov | 9cfa7ab | 2017-05-05 15:39:52 +0200 | [diff] [blame] | 192 | move->value = qemu_input_transform_invert_abs_value(move->value); |
Gerd Hoffmann | d353543 | 2013-11-28 11:29:33 +0100 | [diff] [blame] | 193 | } |
| 194 | break; |
| 195 | case 180: |
Philippe Voinov | 9cfa7ab | 2017-05-05 15:39:52 +0200 | [diff] [blame] | 196 | move->value = qemu_input_transform_invert_abs_value(move->value); |
Gerd Hoffmann | d353543 | 2013-11-28 11:29:33 +0100 | [diff] [blame] | 197 | break; |
| 198 | case 270: |
Eric Blake | b5a1b44 | 2016-03-03 09:16:49 -0700 | [diff] [blame] | 199 | if (move->axis == INPUT_AXIS_X) { |
| 200 | move->axis = INPUT_AXIS_Y; |
Philippe Voinov | 9cfa7ab | 2017-05-05 15:39:52 +0200 | [diff] [blame] | 201 | move->value = qemu_input_transform_invert_abs_value(move->value); |
Eric Blake | b5a1b44 | 2016-03-03 09:16:49 -0700 | [diff] [blame] | 202 | } else if (move->axis == INPUT_AXIS_Y) { |
| 203 | move->axis = INPUT_AXIS_X; |
Gerd Hoffmann | d353543 | 2013-11-28 11:29:33 +0100 | [diff] [blame] | 204 | } |
| 205 | break; |
| 206 | } |
| 207 | } |
| 208 | |
Gerd Hoffmann | c43ce55 | 2013-12-04 15:20:05 +0100 | [diff] [blame] | 209 | static void qemu_input_event_trace(QemuConsole *src, InputEvent *evt) |
| 210 | { |
| 211 | const char *name; |
Gerd Hoffmann | 2386a90 | 2014-05-21 13:49:59 +0200 | [diff] [blame] | 212 | int qcode, idx = -1; |
Eric Blake | b5a1b44 | 2016-03-03 09:16:49 -0700 | [diff] [blame] | 213 | InputKeyEvent *key; |
| 214 | InputBtnEvent *btn; |
| 215 | InputMoveEvent *move; |
Gerd Hoffmann | c43ce55 | 2013-12-04 15:20:05 +0100 | [diff] [blame] | 216 | |
| 217 | if (src) { |
| 218 | idx = qemu_console_get_index(src); |
| 219 | } |
Eric Blake | 568c73a | 2015-10-26 16:34:58 -0600 | [diff] [blame] | 220 | switch (evt->type) { |
Gerd Hoffmann | c43ce55 | 2013-12-04 15:20:05 +0100 | [diff] [blame] | 221 | case INPUT_EVENT_KIND_KEY: |
Eric Blake | 32bafa8 | 2016-03-17 16:48:37 -0600 | [diff] [blame] | 222 | key = evt->u.key.data; |
Eric Blake | b5a1b44 | 2016-03-03 09:16:49 -0700 | [diff] [blame] | 223 | switch (key->key->type) { |
Gerd Hoffmann | c43ce55 | 2013-12-04 15:20:05 +0100 | [diff] [blame] | 224 | case KEY_VALUE_KIND_NUMBER: |
Eric Blake | 32bafa8 | 2016-03-17 16:48:37 -0600 | [diff] [blame] | 225 | qcode = qemu_input_key_number_to_qcode(key->key->u.number.data); |
Markus Armbruster | 977c736 | 2017-08-24 10:46:08 +0200 | [diff] [blame] | 226 | name = QKeyCode_str(qcode); |
Eric Blake | 32bafa8 | 2016-03-17 16:48:37 -0600 | [diff] [blame] | 227 | trace_input_event_key_number(idx, key->key->u.number.data, |
Eric Blake | b5a1b44 | 2016-03-03 09:16:49 -0700 | [diff] [blame] | 228 | name, key->down); |
Gerd Hoffmann | c43ce55 | 2013-12-04 15:20:05 +0100 | [diff] [blame] | 229 | break; |
| 230 | case KEY_VALUE_KIND_QCODE: |
Markus Armbruster | 977c736 | 2017-08-24 10:46:08 +0200 | [diff] [blame] | 231 | name = QKeyCode_str(key->key->u.qcode.data); |
Eric Blake | b5a1b44 | 2016-03-03 09:16:49 -0700 | [diff] [blame] | 232 | trace_input_event_key_qcode(idx, name, key->down); |
Gerd Hoffmann | c43ce55 | 2013-12-04 15:20:05 +0100 | [diff] [blame] | 233 | break; |
Eric Blake | 7fb1cf1 | 2015-11-18 01:52:57 -0700 | [diff] [blame] | 234 | case KEY_VALUE_KIND__MAX: |
Gerd Hoffmann | c43ce55 | 2013-12-04 15:20:05 +0100 | [diff] [blame] | 235 | /* keep gcc happy */ |
| 236 | break; |
| 237 | } |
| 238 | break; |
| 239 | case INPUT_EVENT_KIND_BTN: |
Eric Blake | 32bafa8 | 2016-03-17 16:48:37 -0600 | [diff] [blame] | 240 | btn = evt->u.btn.data; |
Markus Armbruster | 977c736 | 2017-08-24 10:46:08 +0200 | [diff] [blame] | 241 | name = InputButton_str(btn->button); |
Eric Blake | b5a1b44 | 2016-03-03 09:16:49 -0700 | [diff] [blame] | 242 | trace_input_event_btn(idx, name, btn->down); |
Gerd Hoffmann | c43ce55 | 2013-12-04 15:20:05 +0100 | [diff] [blame] | 243 | break; |
| 244 | case INPUT_EVENT_KIND_REL: |
Eric Blake | 32bafa8 | 2016-03-17 16:48:37 -0600 | [diff] [blame] | 245 | move = evt->u.rel.data; |
Markus Armbruster | 977c736 | 2017-08-24 10:46:08 +0200 | [diff] [blame] | 246 | name = InputAxis_str(move->axis); |
Eric Blake | b5a1b44 | 2016-03-03 09:16:49 -0700 | [diff] [blame] | 247 | trace_input_event_rel(idx, name, move->value); |
Gerd Hoffmann | c43ce55 | 2013-12-04 15:20:05 +0100 | [diff] [blame] | 248 | break; |
| 249 | case INPUT_EVENT_KIND_ABS: |
Eric Blake | 32bafa8 | 2016-03-17 16:48:37 -0600 | [diff] [blame] | 250 | move = evt->u.abs.data; |
Markus Armbruster | 977c736 | 2017-08-24 10:46:08 +0200 | [diff] [blame] | 251 | name = InputAxis_str(move->axis); |
Eric Blake | b5a1b44 | 2016-03-03 09:16:49 -0700 | [diff] [blame] | 252 | trace_input_event_abs(idx, name, move->value); |
Gerd Hoffmann | c43ce55 | 2013-12-04 15:20:05 +0100 | [diff] [blame] | 253 | break; |
Eric Blake | 7fb1cf1 | 2015-11-18 01:52:57 -0700 | [diff] [blame] | 254 | case INPUT_EVENT_KIND__MAX: |
Gerd Hoffmann | c43ce55 | 2013-12-04 15:20:05 +0100 | [diff] [blame] | 255 | /* keep gcc happy */ |
| 256 | break; |
| 257 | } |
| 258 | } |
| 259 | |
Gerd Hoffmann | be1a717 | 2014-05-28 13:02:40 +0200 | [diff] [blame] | 260 | static void qemu_input_queue_process(void *opaque) |
| 261 | { |
Paolo Bonzini | f481ee2 | 2018-12-06 11:56:15 +0100 | [diff] [blame] | 262 | QemuInputEventQueueHead *queue = opaque; |
Gerd Hoffmann | be1a717 | 2014-05-28 13:02:40 +0200 | [diff] [blame] | 263 | QemuInputEventQueue *item; |
| 264 | |
| 265 | g_assert(!QTAILQ_EMPTY(queue)); |
| 266 | item = QTAILQ_FIRST(queue); |
| 267 | g_assert(item->type == QEMU_INPUT_QUEUE_DELAY); |
| 268 | QTAILQ_REMOVE(queue, item, node); |
Alexander Graf | 77b0359 | 2017-06-22 09:41:58 +0200 | [diff] [blame] | 269 | queue_count--; |
Gerd Hoffmann | be1a717 | 2014-05-28 13:02:40 +0200 | [diff] [blame] | 270 | g_free(item); |
| 271 | |
| 272 | while (!QTAILQ_EMPTY(queue)) { |
| 273 | item = QTAILQ_FIRST(queue); |
| 274 | switch (item->type) { |
| 275 | case QEMU_INPUT_QUEUE_DELAY: |
Artem Pisarenko | 05ff8dc | 2018-10-17 14:24:18 +0600 | [diff] [blame] | 276 | timer_mod(item->timer, qemu_clock_get_ms(QEMU_CLOCK_VIRTUAL) |
Gerd Hoffmann | be1a717 | 2014-05-28 13:02:40 +0200 | [diff] [blame] | 277 | + item->delay_ms); |
| 278 | return; |
| 279 | case QEMU_INPUT_QUEUE_EVENT: |
| 280 | qemu_input_event_send(item->src, item->evt); |
| 281 | qapi_free_InputEvent(item->evt); |
| 282 | break; |
| 283 | case QEMU_INPUT_QUEUE_SYNC: |
| 284 | qemu_input_event_sync(); |
| 285 | break; |
| 286 | } |
| 287 | QTAILQ_REMOVE(queue, item, node); |
Gerd Hoffmann | fa18f36 | 2017-04-28 10:42:37 +0200 | [diff] [blame] | 288 | queue_count--; |
Gerd Hoffmann | be1a717 | 2014-05-28 13:02:40 +0200 | [diff] [blame] | 289 | g_free(item); |
| 290 | } |
| 291 | } |
| 292 | |
Paolo Bonzini | f481ee2 | 2018-12-06 11:56:15 +0100 | [diff] [blame] | 293 | static void qemu_input_queue_delay(QemuInputEventQueueHead *queue, |
Gerd Hoffmann | be1a717 | 2014-05-28 13:02:40 +0200 | [diff] [blame] | 294 | QEMUTimer *timer, uint32_t delay_ms) |
| 295 | { |
| 296 | QemuInputEventQueue *item = g_new0(QemuInputEventQueue, 1); |
| 297 | bool start_timer = QTAILQ_EMPTY(queue); |
| 298 | |
| 299 | item->type = QEMU_INPUT_QUEUE_DELAY; |
| 300 | item->delay_ms = delay_ms; |
| 301 | item->timer = timer; |
| 302 | QTAILQ_INSERT_TAIL(queue, item, node); |
Gerd Hoffmann | fa18f36 | 2017-04-28 10:42:37 +0200 | [diff] [blame] | 303 | queue_count++; |
Gerd Hoffmann | be1a717 | 2014-05-28 13:02:40 +0200 | [diff] [blame] | 304 | |
| 305 | if (start_timer) { |
Artem Pisarenko | 05ff8dc | 2018-10-17 14:24:18 +0600 | [diff] [blame] | 306 | timer_mod(item->timer, qemu_clock_get_ms(QEMU_CLOCK_VIRTUAL) |
Gerd Hoffmann | be1a717 | 2014-05-28 13:02:40 +0200 | [diff] [blame] | 307 | + item->delay_ms); |
| 308 | } |
| 309 | } |
| 310 | |
Paolo Bonzini | f481ee2 | 2018-12-06 11:56:15 +0100 | [diff] [blame] | 311 | static void qemu_input_queue_event(QemuInputEventQueueHead *queue, |
Gerd Hoffmann | be1a717 | 2014-05-28 13:02:40 +0200 | [diff] [blame] | 312 | QemuConsole *src, InputEvent *evt) |
| 313 | { |
| 314 | QemuInputEventQueue *item = g_new0(QemuInputEventQueue, 1); |
| 315 | |
| 316 | item->type = QEMU_INPUT_QUEUE_EVENT; |
| 317 | item->src = src; |
| 318 | item->evt = evt; |
| 319 | QTAILQ_INSERT_TAIL(queue, item, node); |
Gerd Hoffmann | fa18f36 | 2017-04-28 10:42:37 +0200 | [diff] [blame] | 320 | queue_count++; |
Gerd Hoffmann | be1a717 | 2014-05-28 13:02:40 +0200 | [diff] [blame] | 321 | } |
| 322 | |
Paolo Bonzini | f481ee2 | 2018-12-06 11:56:15 +0100 | [diff] [blame] | 323 | static void qemu_input_queue_sync(QemuInputEventQueueHead *queue) |
Gerd Hoffmann | be1a717 | 2014-05-28 13:02:40 +0200 | [diff] [blame] | 324 | { |
| 325 | QemuInputEventQueue *item = g_new0(QemuInputEventQueue, 1); |
| 326 | |
| 327 | item->type = QEMU_INPUT_QUEUE_SYNC; |
| 328 | QTAILQ_INSERT_TAIL(queue, item, node); |
Gerd Hoffmann | fa18f36 | 2017-04-28 10:42:37 +0200 | [diff] [blame] | 329 | queue_count++; |
Gerd Hoffmann | be1a717 | 2014-05-28 13:02:40 +0200 | [diff] [blame] | 330 | } |
| 331 | |
Pavel Dovgalyuk | ee31299 | 2015-09-17 19:25:24 +0300 | [diff] [blame] | 332 | void qemu_input_event_send_impl(QemuConsole *src, InputEvent *evt) |
Gerd Hoffmann | c8b405b | 2013-11-27 10:35:26 +0100 | [diff] [blame] | 333 | { |
| 334 | QemuInputHandlerState *s; |
| 335 | |
Gerd Hoffmann | c43ce55 | 2013-12-04 15:20:05 +0100 | [diff] [blame] | 336 | qemu_input_event_trace(src, evt); |
| 337 | |
Gerd Hoffmann | d353543 | 2013-11-28 11:29:33 +0100 | [diff] [blame] | 338 | /* pre processing */ |
Eric Blake | 568c73a | 2015-10-26 16:34:58 -0600 | [diff] [blame] | 339 | if (graphic_rotate && (evt->type == INPUT_EVENT_KIND_ABS)) { |
Gerd Hoffmann | d353543 | 2013-11-28 11:29:33 +0100 | [diff] [blame] | 340 | qemu_input_transform_abs_rotate(evt); |
| 341 | } |
| 342 | |
| 343 | /* send event */ |
Eric Blake | 568c73a | 2015-10-26 16:34:58 -0600 | [diff] [blame] | 344 | s = qemu_input_find_handler(1 << evt->type, src); |
Gerd Hoffmann | bdcc3a2 | 2014-03-31 16:07:30 +0200 | [diff] [blame] | 345 | if (!s) { |
| 346 | return; |
| 347 | } |
Gerd Hoffmann | c8b405b | 2013-11-27 10:35:26 +0100 | [diff] [blame] | 348 | s->handler->event(s->dev, src, evt); |
| 349 | s->events++; |
| 350 | } |
| 351 | |
Pavel Dovgalyuk | ee31299 | 2015-09-17 19:25:24 +0300 | [diff] [blame] | 352 | void qemu_input_event_send(QemuConsole *src, InputEvent *evt) |
Gerd Hoffmann | c8b405b | 2013-11-27 10:35:26 +0100 | [diff] [blame] | 353 | { |
Daniel P. Berrange | af07e5f | 2017-09-29 11:12:00 +0100 | [diff] [blame] | 354 | /* Expect all parts of QEMU to send events with QCodes exclusively. |
| 355 | * Key numbers are only supported as end-user input via QMP */ |
| 356 | assert(!(evt->type == INPUT_EVENT_KIND_KEY && |
| 357 | evt->u.key.data->key->type == KEY_VALUE_KIND_NUMBER)); |
| 358 | |
Daniel P. Berrange | 80b857f | 2017-10-19 15:28:47 +0100 | [diff] [blame] | 359 | |
| 360 | /* |
| 361 | * 'sysrq' was mistakenly added to hack around the fact that |
| 362 | * the ps2 driver was not generating correct scancodes sequences |
| 363 | * when 'alt+print' was pressed. This flaw is now fixed and the |
| 364 | * 'sysrq' key serves no further purpose. We normalize it to |
| 365 | * 'print', so that downstream receivers of the event don't |
| 366 | * neeed to deal with this mistake |
| 367 | */ |
| 368 | if (evt->type == INPUT_EVENT_KIND_KEY && |
| 369 | evt->u.key.data->key->u.qcode.data == Q_KEY_CODE_SYSRQ) { |
| 370 | evt->u.key.data->key->u.qcode.data = Q_KEY_CODE_PRINT; |
| 371 | } |
| 372 | |
Gerd Hoffmann | c8b405b | 2013-11-27 10:35:26 +0100 | [diff] [blame] | 373 | if (!runstate_is_running() && !runstate_check(RUN_STATE_SUSPENDED)) { |
| 374 | return; |
| 375 | } |
| 376 | |
Pavel Dovgalyuk | ee31299 | 2015-09-17 19:25:24 +0300 | [diff] [blame] | 377 | replay_input_event(src, evt); |
| 378 | } |
| 379 | |
| 380 | void qemu_input_event_sync_impl(void) |
| 381 | { |
| 382 | QemuInputHandlerState *s; |
| 383 | |
Gerd Hoffmann | c43ce55 | 2013-12-04 15:20:05 +0100 | [diff] [blame] | 384 | trace_input_event_sync(); |
| 385 | |
Gerd Hoffmann | c8b405b | 2013-11-27 10:35:26 +0100 | [diff] [blame] | 386 | QTAILQ_FOREACH(s, &handlers, node) { |
| 387 | if (!s->events) { |
| 388 | continue; |
| 389 | } |
| 390 | if (s->handler->sync) { |
| 391 | s->handler->sync(s->dev); |
| 392 | } |
| 393 | s->events = 0; |
| 394 | } |
| 395 | } |
Gerd Hoffmann | 6567147 | 2013-11-27 11:38:47 +0100 | [diff] [blame] | 396 | |
Pavel Dovgalyuk | ee31299 | 2015-09-17 19:25:24 +0300 | [diff] [blame] | 397 | void qemu_input_event_sync(void) |
| 398 | { |
| 399 | if (!runstate_is_running() && !runstate_check(RUN_STATE_SUSPENDED)) { |
| 400 | return; |
| 401 | } |
| 402 | |
| 403 | replay_input_sync_event(); |
| 404 | } |
| 405 | |
Daniel P. Berrange | 3ad35e7 | 2017-09-29 11:12:01 +0100 | [diff] [blame] | 406 | static InputEvent *qemu_input_event_new_key(KeyValue *key, bool down) |
Gerd Hoffmann | 6567147 | 2013-11-27 11:38:47 +0100 | [diff] [blame] | 407 | { |
| 408 | InputEvent *evt = g_new0(InputEvent, 1); |
Eric Blake | 32bafa8 | 2016-03-17 16:48:37 -0600 | [diff] [blame] | 409 | evt->u.key.data = g_new0(InputKeyEvent, 1); |
Eric Blake | 568c73a | 2015-10-26 16:34:58 -0600 | [diff] [blame] | 410 | evt->type = INPUT_EVENT_KIND_KEY; |
Eric Blake | 32bafa8 | 2016-03-17 16:48:37 -0600 | [diff] [blame] | 411 | evt->u.key.data->key = key; |
| 412 | evt->u.key.data->down = down; |
Gerd Hoffmann | 6567147 | 2013-11-27 11:38:47 +0100 | [diff] [blame] | 413 | return evt; |
| 414 | } |
| 415 | |
| 416 | void qemu_input_event_send_key(QemuConsole *src, KeyValue *key, bool down) |
| 417 | { |
| 418 | InputEvent *evt; |
| 419 | evt = qemu_input_event_new_key(key, down); |
Gerd Hoffmann | be1a717 | 2014-05-28 13:02:40 +0200 | [diff] [blame] | 420 | if (QTAILQ_EMPTY(&kbd_queue)) { |
| 421 | qemu_input_event_send(src, evt); |
| 422 | qemu_input_event_sync(); |
| 423 | qapi_free_InputEvent(evt); |
Gerd Hoffmann | fa18f36 | 2017-04-28 10:42:37 +0200 | [diff] [blame] | 424 | } else if (queue_count < queue_limit) { |
Gerd Hoffmann | be1a717 | 2014-05-28 13:02:40 +0200 | [diff] [blame] | 425 | qemu_input_queue_event(&kbd_queue, src, evt); |
| 426 | qemu_input_queue_sync(&kbd_queue); |
linzhecheng | fca4774 | 2017-12-25 10:37:30 +0800 | [diff] [blame] | 427 | } else { |
| 428 | qapi_free_InputEvent(evt); |
Gerd Hoffmann | be1a717 | 2014-05-28 13:02:40 +0200 | [diff] [blame] | 429 | } |
Gerd Hoffmann | 6567147 | 2013-11-27 11:38:47 +0100 | [diff] [blame] | 430 | } |
| 431 | |
| 432 | void qemu_input_event_send_key_number(QemuConsole *src, int num, bool down) |
| 433 | { |
Daniel P. Berrange | af07e5f | 2017-09-29 11:12:00 +0100 | [diff] [blame] | 434 | QKeyCode code = qemu_input_key_number_to_qcode(num); |
| 435 | qemu_input_event_send_key_qcode(src, code, down); |
Gerd Hoffmann | 6567147 | 2013-11-27 11:38:47 +0100 | [diff] [blame] | 436 | } |
| 437 | |
| 438 | void qemu_input_event_send_key_qcode(QemuConsole *src, QKeyCode q, bool down) |
| 439 | { |
| 440 | KeyValue *key = g_new0(KeyValue, 1); |
Eric Blake | 568c73a | 2015-10-26 16:34:58 -0600 | [diff] [blame] | 441 | key->type = KEY_VALUE_KIND_QCODE; |
Eric Blake | 32bafa8 | 2016-03-17 16:48:37 -0600 | [diff] [blame] | 442 | key->u.qcode.data = q; |
Gerd Hoffmann | 6567147 | 2013-11-27 11:38:47 +0100 | [diff] [blame] | 443 | qemu_input_event_send_key(src, key, down); |
| 444 | } |
Gerd Hoffmann | 4357940 | 2013-11-27 18:24:29 +0100 | [diff] [blame] | 445 | |
Gerd Hoffmann | be1a717 | 2014-05-28 13:02:40 +0200 | [diff] [blame] | 446 | void qemu_input_event_send_key_delay(uint32_t delay_ms) |
| 447 | { |
Marc-André Lureau | 05c6638 | 2017-04-25 17:05:20 +0400 | [diff] [blame] | 448 | if (!runstate_is_running() && !runstate_check(RUN_STATE_SUSPENDED)) { |
| 449 | return; |
| 450 | } |
| 451 | |
Gerd Hoffmann | be1a717 | 2014-05-28 13:02:40 +0200 | [diff] [blame] | 452 | if (!kbd_timer) { |
Artem Pisarenko | e81f867 | 2018-10-17 14:24:20 +0600 | [diff] [blame] | 453 | kbd_timer = timer_new_full(NULL, QEMU_CLOCK_VIRTUAL, |
| 454 | SCALE_MS, QEMU_TIMER_ATTR_EXTERNAL, |
| 455 | qemu_input_queue_process, &kbd_queue); |
Gerd Hoffmann | be1a717 | 2014-05-28 13:02:40 +0200 | [diff] [blame] | 456 | } |
Gerd Hoffmann | fa18f36 | 2017-04-28 10:42:37 +0200 | [diff] [blame] | 457 | if (queue_count < queue_limit) { |
| 458 | qemu_input_queue_delay(&kbd_queue, kbd_timer, |
| 459 | delay_ms ? delay_ms : kbd_default_delay_ms); |
| 460 | } |
Gerd Hoffmann | be1a717 | 2014-05-28 13:02:40 +0200 | [diff] [blame] | 461 | } |
| 462 | |
Gerd Hoffmann | 4357940 | 2013-11-27 18:24:29 +0100 | [diff] [blame] | 463 | void qemu_input_queue_btn(QemuConsole *src, InputButton btn, bool down) |
| 464 | { |
Gerd Hoffmann | 7a1b46e | 2018-12-10 15:08:08 +0100 | [diff] [blame] | 465 | InputBtnEvent bevt = { |
| 466 | .button = btn, |
| 467 | .down = down, |
| 468 | }; |
| 469 | InputEvent evt = { |
| 470 | .type = INPUT_EVENT_KIND_BTN, |
| 471 | .u.btn.data = &bevt, |
| 472 | }; |
| 473 | |
| 474 | qemu_input_event_send(src, &evt); |
Gerd Hoffmann | 4357940 | 2013-11-27 18:24:29 +0100 | [diff] [blame] | 475 | } |
| 476 | |
| 477 | void qemu_input_update_buttons(QemuConsole *src, uint32_t *button_map, |
| 478 | uint32_t button_old, uint32_t button_new) |
| 479 | { |
| 480 | InputButton btn; |
| 481 | uint32_t mask; |
| 482 | |
Eric Blake | 7fb1cf1 | 2015-11-18 01:52:57 -0700 | [diff] [blame] | 483 | for (btn = 0; btn < INPUT_BUTTON__MAX; btn++) { |
Gerd Hoffmann | 4357940 | 2013-11-27 18:24:29 +0100 | [diff] [blame] | 484 | mask = button_map[btn]; |
| 485 | if ((button_old & mask) == (button_new & mask)) { |
| 486 | continue; |
| 487 | } |
| 488 | qemu_input_queue_btn(src, btn, button_new & mask); |
| 489 | } |
| 490 | } |
| 491 | |
Gerd Hoffmann | 502c8db | 2013-11-28 11:31:09 +0100 | [diff] [blame] | 492 | bool qemu_input_is_absolute(void) |
| 493 | { |
| 494 | QemuInputHandlerState *s; |
| 495 | |
Gerd Hoffmann | 6f5943c | 2014-05-19 15:18:37 +0200 | [diff] [blame] | 496 | s = qemu_input_find_handler(INPUT_EVENT_MASK_REL | INPUT_EVENT_MASK_ABS, |
| 497 | NULL); |
Gerd Hoffmann | 502c8db | 2013-11-28 11:31:09 +0100 | [diff] [blame] | 498 | return (s != NULL) && (s->handler->mask & INPUT_EVENT_MASK_ABS); |
| 499 | } |
| 500 | |
Philippe Voinov | 9cfa7ab | 2017-05-05 15:39:52 +0200 | [diff] [blame] | 501 | int qemu_input_scale_axis(int value, |
| 502 | int min_in, int max_in, |
| 503 | int min_out, int max_out) |
Gerd Hoffmann | 4357940 | 2013-11-27 18:24:29 +0100 | [diff] [blame] | 504 | { |
Philippe Voinov | 9cfa7ab | 2017-05-05 15:39:52 +0200 | [diff] [blame] | 505 | int64_t range_in = (int64_t)max_in - min_in; |
| 506 | int64_t range_out = (int64_t)max_out - min_out; |
| 507 | |
| 508 | if (range_in < 1) { |
| 509 | return min_out + range_out / 2; |
Gerd Hoffmann | 4357940 | 2013-11-27 18:24:29 +0100 | [diff] [blame] | 510 | } |
Philippe Voinov | 9cfa7ab | 2017-05-05 15:39:52 +0200 | [diff] [blame] | 511 | return ((int64_t)value - min_in) * range_out / range_in + min_out; |
Gerd Hoffmann | 4357940 | 2013-11-27 18:24:29 +0100 | [diff] [blame] | 512 | } |
| 513 | |
Gerd Hoffmann | 4357940 | 2013-11-27 18:24:29 +0100 | [diff] [blame] | 514 | void qemu_input_queue_rel(QemuConsole *src, InputAxis axis, int value) |
| 515 | { |
Gerd Hoffmann | 7a1b46e | 2018-12-10 15:08:08 +0100 | [diff] [blame] | 516 | InputMoveEvent move = { |
| 517 | .axis = axis, |
| 518 | .value = value, |
| 519 | }; |
| 520 | InputEvent evt = { |
| 521 | .type = INPUT_EVENT_KIND_REL, |
| 522 | .u.rel.data = &move, |
| 523 | }; |
| 524 | |
| 525 | qemu_input_event_send(src, &evt); |
Gerd Hoffmann | 4357940 | 2013-11-27 18:24:29 +0100 | [diff] [blame] | 526 | } |
| 527 | |
Philippe Voinov | 9cfa7ab | 2017-05-05 15:39:52 +0200 | [diff] [blame] | 528 | void qemu_input_queue_abs(QemuConsole *src, InputAxis axis, int value, |
| 529 | int min_in, int max_in) |
Gerd Hoffmann | 4357940 | 2013-11-27 18:24:29 +0100 | [diff] [blame] | 530 | { |
Gerd Hoffmann | 7a1b46e | 2018-12-10 15:08:08 +0100 | [diff] [blame] | 531 | InputMoveEvent move = { |
| 532 | .axis = axis, |
| 533 | .value = qemu_input_scale_axis(value, min_in, max_in, |
Philippe Voinov | 9cfa7ab | 2017-05-05 15:39:52 +0200 | [diff] [blame] | 534 | INPUT_EVENT_ABS_MIN, |
Gerd Hoffmann | 7a1b46e | 2018-12-10 15:08:08 +0100 | [diff] [blame] | 535 | INPUT_EVENT_ABS_MAX), |
| 536 | }; |
| 537 | InputEvent evt = { |
| 538 | .type = INPUT_EVENT_KIND_ABS, |
| 539 | .u.abs.data = &move, |
| 540 | }; |
| 541 | |
| 542 | qemu_input_event_send(src, &evt); |
Gerd Hoffmann | 4357940 | 2013-11-27 18:24:29 +0100 | [diff] [blame] | 543 | } |
Gerd Hoffmann | 4a33f45 | 2013-12-05 11:23:42 +0100 | [diff] [blame] | 544 | |
| 545 | void qemu_input_check_mode_change(void) |
| 546 | { |
| 547 | static int current_is_absolute; |
| 548 | int is_absolute; |
| 549 | |
| 550 | is_absolute = qemu_input_is_absolute(); |
| 551 | |
| 552 | if (is_absolute != current_is_absolute) { |
Gerd Hoffmann | a8dfb1c | 2013-12-05 11:24:14 +0100 | [diff] [blame] | 553 | trace_input_mouse_mode(is_absolute); |
Gerd Hoffmann | 4a33f45 | 2013-12-05 11:23:42 +0100 | [diff] [blame] | 554 | notifier_list_notify(&mouse_mode_notifiers, NULL); |
| 555 | } |
| 556 | |
| 557 | current_is_absolute = is_absolute; |
| 558 | } |
| 559 | |
| 560 | void qemu_add_mouse_mode_change_notifier(Notifier *notify) |
| 561 | { |
| 562 | notifier_list_add(&mouse_mode_notifiers, notify); |
| 563 | } |
| 564 | |
| 565 | void qemu_remove_mouse_mode_change_notifier(Notifier *notify) |
| 566 | { |
| 567 | notifier_remove(notify); |
| 568 | } |
Gerd Hoffmann | e842c68 | 2013-12-10 17:09:36 +0100 | [diff] [blame] | 569 | |
| 570 | MouseInfoList *qmp_query_mice(Error **errp) |
| 571 | { |
| 572 | MouseInfoList *mice_list = NULL; |
| 573 | MouseInfoList *info; |
| 574 | QemuInputHandlerState *s; |
| 575 | bool current = true; |
| 576 | |
| 577 | QTAILQ_FOREACH(s, &handlers, node) { |
| 578 | if (!(s->handler->mask & |
| 579 | (INPUT_EVENT_MASK_REL | INPUT_EVENT_MASK_ABS))) { |
| 580 | continue; |
| 581 | } |
| 582 | |
| 583 | info = g_new0(MouseInfoList, 1); |
| 584 | info->value = g_new0(MouseInfo, 1); |
| 585 | info->value->index = s->id; |
| 586 | info->value->name = g_strdup(s->handler->name); |
| 587 | info->value->absolute = s->handler->mask & INPUT_EVENT_MASK_ABS; |
| 588 | info->value->current = current; |
| 589 | |
| 590 | current = false; |
| 591 | info->next = mice_list; |
| 592 | mice_list = info; |
| 593 | } |
| 594 | |
| 595 | return mice_list; |
| 596 | } |
Gerd Hoffmann | 70b52f6 | 2013-12-10 17:16:03 +0100 | [diff] [blame] | 597 | |
Markus Armbruster | 3e5a50d | 2015-02-06 13:55:43 +0100 | [diff] [blame] | 598 | void hmp_mouse_set(Monitor *mon, const QDict *qdict) |
Gerd Hoffmann | 70b52f6 | 2013-12-10 17:16:03 +0100 | [diff] [blame] | 599 | { |
| 600 | QemuInputHandlerState *s; |
| 601 | int index = qdict_get_int(qdict, "index"); |
| 602 | int found = 0; |
| 603 | |
| 604 | QTAILQ_FOREACH(s, &handlers, node) { |
Hani Benhabiles | 0419f78 | 2014-03-31 23:09:06 +0100 | [diff] [blame] | 605 | if (s->id != index) { |
| 606 | continue; |
Gerd Hoffmann | 70b52f6 | 2013-12-10 17:16:03 +0100 | [diff] [blame] | 607 | } |
Hani Benhabiles | 0419f78 | 2014-03-31 23:09:06 +0100 | [diff] [blame] | 608 | if (!(s->handler->mask & (INPUT_EVENT_MASK_REL | |
| 609 | INPUT_EVENT_MASK_ABS))) { |
| 610 | error_report("Input device '%s' is not a mouse", s->handler->name); |
| 611 | return; |
| 612 | } |
| 613 | found = 1; |
| 614 | qemu_input_handler_activate(s); |
| 615 | break; |
Gerd Hoffmann | 70b52f6 | 2013-12-10 17:16:03 +0100 | [diff] [blame] | 616 | } |
| 617 | |
| 618 | if (!found) { |
Hani Benhabiles | 0419f78 | 2014-03-31 23:09:06 +0100 | [diff] [blame] | 619 | error_report("Mouse at index '%d' not found", index); |
Gerd Hoffmann | 70b52f6 | 2013-12-10 17:16:03 +0100 | [diff] [blame] | 620 | } |
| 621 | |
| 622 | qemu_input_check_mode_change(); |
| 623 | } |