| 1 | /* | 
|---|
| 2 | * Copyright (c) 2011 Vojtech Horky | 
|---|
| 3 | * All rights reserved. | 
|---|
| 4 | * | 
|---|
| 5 | * Redistribution and use in source and binary forms, with or without | 
|---|
| 6 | * modification, are permitted provided that the following conditions | 
|---|
| 7 | * are met: | 
|---|
| 8 | * | 
|---|
| 9 | * - Redistributions of source code must retain the above copyright | 
|---|
| 10 | *   notice, this list of conditions and the following disclaimer. | 
|---|
| 11 | * - 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. | 
|---|
| 14 | * - The name of the author may not be used to endorse or promote products | 
|---|
| 15 | *   derived from this software without specific prior written permission. | 
|---|
| 16 | * | 
|---|
| 17 | * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR | 
|---|
| 18 | * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES | 
|---|
| 19 | * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. | 
|---|
| 20 | * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, | 
|---|
| 21 | * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT | 
|---|
| 22 | * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, | 
|---|
| 23 | * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY | 
|---|
| 24 | * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT | 
|---|
| 25 | * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF | 
|---|
| 26 | * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | 
|---|
| 27 | */ | 
|---|
| 28 |  | 
|---|
| 29 | /** @addtogroup usbvirthid | 
|---|
| 30 | * @{ | 
|---|
| 31 | */ | 
|---|
| 32 | /** | 
|---|
| 33 | * @file | 
|---|
| 34 | * Virtual USB HID device. | 
|---|
| 35 | */ | 
|---|
| 36 |  | 
|---|
| 37 | #include <stdio.h> | 
|---|
| 38 | #include <stdlib.h> | 
|---|
| 39 | #include <errno.h> | 
|---|
| 40 | #include <str_error.h> | 
|---|
| 41 | #include <getopt.h> | 
|---|
| 42 |  | 
|---|
| 43 | #include <usb/usb.h> | 
|---|
| 44 | #include <usb/descriptor.h> | 
|---|
| 45 | #include <usb/debug.h> | 
|---|
| 46 | #include <usb/classes/classes.h> | 
|---|
| 47 | #include <usb/hid/hid.h> | 
|---|
| 48 | #include <usbvirt/device.h> | 
|---|
| 49 |  | 
|---|
| 50 | #include "virthid.h" | 
|---|
| 51 | #include "ifaces.h" | 
|---|
| 52 | #include "stdreq.h" | 
|---|
| 53 |  | 
|---|
| 54 | #define DEFAULT_CONTROLLER   "/virt/usbhc/virtual" | 
|---|
| 55 |  | 
|---|
| 56 | static usbvirt_control_request_handler_t endpoint_zero_handlers[] = { | 
|---|
| 57 | { | 
|---|
| 58 | STD_REQ_IN(USB_REQUEST_RECIPIENT_INTERFACE, USB_DEVREQ_GET_DESCRIPTOR), | 
|---|
| 59 | .name = "Get_Descriptor", | 
|---|
| 60 | .callback = req_get_descriptor | 
|---|
| 61 | }, | 
|---|
| 62 | { | 
|---|
| 63 | CLASS_REQ_OUT(USB_REQUEST_RECIPIENT_INTERFACE, USB_HIDREQ_SET_PROTOCOL), | 
|---|
| 64 | .name = "Set_Protocol", | 
|---|
| 65 | .callback = req_set_protocol | 
|---|
| 66 | }, | 
|---|
| 67 | { | 
|---|
| 68 | CLASS_REQ_OUT(USB_REQUEST_RECIPIENT_INTERFACE, USB_HIDREQ_SET_REPORT), | 
|---|
| 69 | .name = "Set_Report", | 
|---|
| 70 | .callback = req_set_report | 
|---|
| 71 | }, | 
|---|
| 72 | { | 
|---|
| 73 | .callback = NULL | 
|---|
| 74 | } | 
|---|
| 75 | }; | 
|---|
| 76 |  | 
|---|
| 77 | /** Keyboard callbacks. | 
|---|
| 78 | * We abuse the fact that static variables are zero-filled. | 
|---|
| 79 | */ | 
|---|
| 80 | static usbvirt_device_ops_t hid_ops = { | 
|---|
| 81 | .control = endpoint_zero_handlers, | 
|---|
| 82 | }; | 
|---|
| 83 |  | 
|---|
| 84 | /** Standard configuration descriptor. */ | 
|---|
| 85 | static usb_standard_configuration_descriptor_t std_configuration_descriptor = { | 
|---|
| 86 | .length = sizeof(usb_standard_configuration_descriptor_t), | 
|---|
| 87 | .descriptor_type = USB_DESCTYPE_CONFIGURATION, | 
|---|
| 88 | /* Will be patched at runtime. */ | 
|---|
| 89 | .total_length = sizeof(usb_standard_configuration_descriptor_t), | 
|---|
| 90 | .interface_count = 0, | 
|---|
| 91 | .configuration_number = 1, | 
|---|
| 92 | .str_configuration = 0, | 
|---|
| 93 | .attributes = 128, /* denotes bus-powered device */ | 
|---|
| 94 | .max_power = 50 | 
|---|
| 95 | }; | 
|---|
| 96 |  | 
|---|
| 97 | /** Standard device descriptor. */ | 
|---|
| 98 | static usb_standard_device_descriptor_t std_device_descriptor = { | 
|---|
| 99 | .length = sizeof(usb_standard_device_descriptor_t), | 
|---|
| 100 | .descriptor_type = USB_DESCTYPE_DEVICE, | 
|---|
| 101 | .usb_spec_version = 0x110, | 
|---|
| 102 | .device_class = USB_CLASS_USE_INTERFACE, | 
|---|
| 103 | .device_subclass = 0, | 
|---|
| 104 | .device_protocol = 0, | 
|---|
| 105 | .max_packet_size = 64, | 
|---|
| 106 | .configuration_count = 1 | 
|---|
| 107 | }; | 
|---|
| 108 |  | 
|---|
| 109 | /** HID configuration. */ | 
|---|
| 110 | usbvirt_device_configuration_t configuration = { | 
|---|
| 111 | .descriptor = &std_configuration_descriptor, | 
|---|
| 112 | .extra = NULL, | 
|---|
| 113 | .extra_count = 0 | 
|---|
| 114 | }; | 
|---|
| 115 |  | 
|---|
| 116 | /** HID standard descriptors. */ | 
|---|
| 117 | usbvirt_descriptors_t descriptors = { | 
|---|
| 118 | .device = &std_device_descriptor, | 
|---|
| 119 | .configuration = &configuration, | 
|---|
| 120 | .configuration_count = 1, | 
|---|
| 121 | }; | 
|---|
| 122 |  | 
|---|
| 123 | static vuhid_data_t vuhid_data = { | 
|---|
| 124 | .in_endpoints_mapping = { NULL }, | 
|---|
| 125 | .in_endpoint_first_free = 1, | 
|---|
| 126 | .out_endpoints_mapping = { NULL }, | 
|---|
| 127 | .out_endpoint_first_free = 1, | 
|---|
| 128 |  | 
|---|
| 129 | .iface_count = 0, | 
|---|
| 130 | .iface_died_count = 0 | 
|---|
| 131 | // mutex and CV must be initialized elsewhere | 
|---|
| 132 | }; | 
|---|
| 133 |  | 
|---|
| 134 |  | 
|---|
| 135 | /** Keyboard device. | 
|---|
| 136 | * Rest of the items will be initialized later. | 
|---|
| 137 | */ | 
|---|
| 138 | static usbvirt_device_t hid_dev = { | 
|---|
| 139 | .ops = &hid_ops, | 
|---|
| 140 | .descriptors = &descriptors, | 
|---|
| 141 | .name = "HID", | 
|---|
| 142 | .device_data = &vuhid_data | 
|---|
| 143 | }; | 
|---|
| 144 |  | 
|---|
| 145 |  | 
|---|
| 146 | static struct option long_options[] = { | 
|---|
| 147 | { "help", optional_argument, NULL, 'h' }, | 
|---|
| 148 | { "controller", required_argument, NULL, 'c' }, | 
|---|
| 149 | { "list", no_argument, NULL, 'l' }, | 
|---|
| 150 | { 0, 0, NULL, 0 } | 
|---|
| 151 | }; | 
|---|
| 152 | static const char *short_options = "hc:l"; | 
|---|
| 153 |  | 
|---|
| 154 | static void print_help(const char *name, const char *module) | 
|---|
| 155 | { | 
|---|
| 156 | if (module == NULL) { | 
|---|
| 157 | /* Default help */ | 
|---|
| 158 | printf("Usage: %s [options] device.\n", name); | 
|---|
| 159 | printf("\t-h, --help [device]\n"); | 
|---|
| 160 | printf("\t\to With no argument print this help and exit.\n"); | 
|---|
| 161 | printf("\t\to With argument print device specific help and exit.\n"); | 
|---|
| 162 | printf("\t-l, --list \n\t\tPrint list of available devices.\n"); | 
|---|
| 163 | printf("\t-c, --controller \n\t\t" | 
|---|
| 164 | "Use provided virtual hc instead of default (%s)\n", | 
|---|
| 165 | DEFAULT_CONTROLLER); | 
|---|
| 166 | return; | 
|---|
| 167 | } | 
|---|
| 168 | printf("HELP for module %s\n", module); | 
|---|
| 169 | } | 
|---|
| 170 |  | 
|---|
| 171 | static void print_list(void) | 
|---|
| 172 | { | 
|---|
| 173 | printf("Available devices:\n"); | 
|---|
| 174 | for (vuhid_interface_t **i = available_hid_interfaces; *i != NULL; ++i) { | 
|---|
| 175 | printf("\t`%s'\t%s\n", (*i)->id, (*i)->name); | 
|---|
| 176 | } | 
|---|
| 177 |  | 
|---|
| 178 | } | 
|---|
| 179 |  | 
|---|
| 180 | static const char *controller = DEFAULT_CONTROLLER; | 
|---|
| 181 |  | 
|---|
| 182 | int main(int argc, char *argv[]) | 
|---|
| 183 | { | 
|---|
| 184 |  | 
|---|
| 185 | if (argc == 1) { | 
|---|
| 186 | print_help(*argv, NULL); | 
|---|
| 187 | return 0; | 
|---|
| 188 | } | 
|---|
| 189 |  | 
|---|
| 190 | int opt = 0; | 
|---|
| 191 | while ((opt = getopt_long(argc, argv, short_options, long_options, NULL)) > 0) { | 
|---|
| 192 | switch (opt) { | 
|---|
| 193 | case 'h': | 
|---|
| 194 | print_help(*argv, optarg); | 
|---|
| 195 | return 0; | 
|---|
| 196 | case 'c': | 
|---|
| 197 | controller = optarg; | 
|---|
| 198 | break; | 
|---|
| 199 | case 'l': | 
|---|
| 200 | print_list(); | 
|---|
| 201 | return 0; | 
|---|
| 202 | case -1: | 
|---|
| 203 | default: | 
|---|
| 204 | break; | 
|---|
| 205 | } | 
|---|
| 206 | } | 
|---|
| 207 |  | 
|---|
| 208 |  | 
|---|
| 209 | log_init("vuhid"); | 
|---|
| 210 |  | 
|---|
| 211 | fibril_mutex_initialize(&vuhid_data.iface_count_mutex); | 
|---|
| 212 | fibril_condvar_initialize(&vuhid_data.iface_count_cv); | 
|---|
| 213 |  | 
|---|
| 214 | /* Determine which interfaces to initialize. */ | 
|---|
| 215 | for (int i = optind; i < argc; i++) { | 
|---|
| 216 | errno_t rc = add_interface_by_id(available_hid_interfaces, argv[i], | 
|---|
| 217 | &hid_dev); | 
|---|
| 218 | if (rc != EOK) { | 
|---|
| 219 | fprintf(stderr, "Failed to add device `%s': %s.\n", | 
|---|
| 220 | argv[i], str_error(rc)); | 
|---|
| 221 | } else { | 
|---|
| 222 | printf("Added device `%s'.\n", argv[i]); | 
|---|
| 223 | } | 
|---|
| 224 | } | 
|---|
| 225 |  | 
|---|
| 226 | for (int i = 0; i < (int) hid_dev.descriptors->configuration->extra_count; i++) { | 
|---|
| 227 | usb_log_debug("Found extra descriptor: %s.", | 
|---|
| 228 | usb_debug_str_buffer( | 
|---|
| 229 | hid_dev.descriptors->configuration->extra[i].data, | 
|---|
| 230 | hid_dev.descriptors->configuration->extra[i].length, | 
|---|
| 231 | 0)); | 
|---|
| 232 | } | 
|---|
| 233 |  | 
|---|
| 234 | const errno_t rc = usbvirt_device_plug(&hid_dev, controller); | 
|---|
| 235 | if (rc != EOK) { | 
|---|
| 236 | printf("Unable to start communication with VHCD `%s': %s.\n", | 
|---|
| 237 | controller, str_error(rc)); | 
|---|
| 238 | return rc; | 
|---|
| 239 | } | 
|---|
| 240 |  | 
|---|
| 241 | printf("Connected to VHCD `%s'...\n", controller); | 
|---|
| 242 |  | 
|---|
| 243 | wait_for_interfaces_death(&hid_dev); | 
|---|
| 244 |  | 
|---|
| 245 | printf("Terminating...\n"); | 
|---|
| 246 |  | 
|---|
| 247 | usbvirt_device_unplug(&hid_dev); | 
|---|
| 248 |  | 
|---|
| 249 | return 0; | 
|---|
| 250 | } | 
|---|
| 251 |  | 
|---|
| 252 |  | 
|---|
| 253 | /** @} | 
|---|
| 254 | */ | 
|---|