drivers/usb/gadget/hid.c

   1 /*
   2  * hid.c -- HID Composite driver
   3  *
   4  * Based on multi.c
   5  *
   6  * Copyright (C) 2010 Fabien Chouteau <fabien.chouteau@barco.com>
   7  *
   8  * This program is free software; you can redistribute it and/or modify
   9  * it under the terms of the GNU General Public License as published by
  10  * the Free Software Foundation; either version 2 of the License, or
  11  * (at your option) any later version.
  12  */
  13
  14
  15 #include <linux/kernel.h>
  16 #include <linux/platform_device.h>
  17 #include <linux/list.h>
  18 #include <linux/module.h>
  19 #include <linux/usb/composite.h>
  20
  21 #include "gadget_chips.h"
  22 #define DRIVER_DESC             "HID Gadget"
  23 #define DRIVER_VERSION          "2010/03/16"
  24
  25 /*-------------------------------------------------------------------------*/
  26
  27 #define HIDG_VENDOR_NUM         0x0525  /* XXX NetChip */
  28 #define HIDG_PRODUCT_NUM        0xa4ac  /* Linux-USB HID gadget */
  29
  30 /*-------------------------------------------------------------------------*/
  31
  32 /*
  33  * kbuild is not very cooperative with respect to linking separately
  34  * compiled library objects into one module.  So for now we won't use
  35  * separate compilation ... ensuring init/exit sections work to shrink
  36  * the runtime footprint, and giving us at least some parts of what
  37  * a "gcc --combine ... part1.c part2.c part3.c ... " build would.
  38  */
  39 #include "f_hid.c"
  40
  41
  42 struct hidg_func_node {
  43         struct list_head node;
  44         struct hidg_func_descriptor *func;
  45 };
  46
  47 static LIST_HEAD(hidg_func_list);
  48
  49 /*-------------------------------------------------------------------------*/
  50 USB_GADGET_COMPOSITE_OPTIONS();
  51
  52 static struct usb_device_descriptor device_desc = {
  53         .bLength =              sizeof device_desc,
  54         .bDescriptorType =      USB_DT_DEVICE,
  55
  56         .bcdUSB =               cpu_to_le16(0x0200),
  57
  58         /* .bDeviceClass =              USB_CLASS_COMM, */
  59         /* .bDeviceSubClass =   0, */
  60         /* .bDeviceProtocol =   0, */
  61         .bDeviceClass =         USB_CLASS_PER_INTERFACE,
  62         .bDeviceSubClass =      0,
  63         .bDeviceProtocol =      0,
  64         /* .bMaxPacketSize0 = f(hardware) */
  65
  66         /* Vendor and product id can be overridden by module parameters.  */
  67         .idVendor =             cpu_to_le16(HIDG_VENDOR_NUM),
  68         .idProduct =            cpu_to_le16(HIDG_PRODUCT_NUM),
  69         /* .bcdDevice = f(hardware) */
  70         /* .iManufacturer = DYNAMIC */
  71         /* .iProduct = DYNAMIC */
  72         /* NO SERIAL NUMBER */
  73         .bNumConfigurations =   1,
  74 };
  75
  76 static struct usb_otg_descriptor otg_descriptor = {
  77         .bLength =              sizeof otg_descriptor,
  78         .bDescriptorType =      USB_DT_OTG,
  79
  80         /* REVISIT SRP-only hardware is possible, although
  81          * it would not be called "OTG" ...
  82          */
  83         .bmAttributes =         USB_OTG_SRP | USB_OTG_HNP,
  84 };
  85
  86 static const struct usb_descriptor_header *otg_desc[] = {
  87         (struct usb_descriptor_header *) &otg_descriptor,
  88         NULL,
  89 };
  90
  91
  92 /* string IDs are assigned dynamically */
  93 static struct usb_string strings_dev[] = {
  94         [USB_GADGET_MANUFACTURER_IDX].s = "",
  95         [USB_GADGET_PRODUCT_IDX].s = DRIVER_DESC,
  96         [USB_GADGET_SERIAL_IDX].s = "",
  97         {  } /* end of list */
  98 };
  99
 100 static struct usb_gadget_strings stringtab_dev = {
 101         .language       = 0x0409,       /* en-us */
 102         .strings        = strings_dev,
 103 };
 104
 105 static struct usb_gadget_strings *dev_strings[] = {
 106         &stringtab_dev,
 107         NULL,
 108 };
 109
 110
 111
 112 /****************************** Configurations ******************************/
 113
 114 static int __init do_config(struct usb_configuration *c)
 115 {
 116         struct hidg_func_node *e;
 117         int func = 0, status = 0;
 118
 119         if (gadget_is_otg(c->cdev->gadget)) {
 120                 c->descriptors = otg_desc;
 121                 c->bmAttributes |= USB_CONFIG_ATT_WAKEUP;
 122         }
 123
 124         list_for_each_entry(e, &hidg_func_list, node) {
 125                 status = hidg_bind_config(c, e->func, func++);
 126                 if (status)
 127                         break;
 128         }
 129
 130         return status;
 131 }
 132
 133 static struct usb_configuration config_driver = {
 134         .label                  = "HID Gadget",
 135         .bConfigurationValue    = 1,
 136         /* .iConfiguration = DYNAMIC */
 137         .bmAttributes           = USB_CONFIG_ATT_SELFPOWER,
 138 };
 139
 140 /****************************** Gadget Bind ******************************/
 141
 142 static int __init hid_bind(struct usb_composite_dev *cdev)
 143 {
 144         struct usb_gadget *gadget = cdev->gadget;
 145         struct list_head *tmp;
 146         int status, gcnum, funcs = 0;
 147
 148         list_for_each(tmp, &hidg_func_list)
 149                 funcs++;
 150
 151         if (!funcs)
 152                 return -ENODEV;
 153
 154         /* set up HID */
 155         status = ghid_setup(cdev->gadget, funcs);
 156         if (status < 0)
 157                 return status;
 158
 159         gcnum = usb_gadget_controller_number(gadget);
 160         if (gcnum >= 0)
 161                 device_desc.bcdDevice = cpu_to_le16(0x0300 | gcnum);
 162         else
 163                 device_desc.bcdDevice = cpu_to_le16(0x0300 | 0x0099);
 164
 165         /* Allocate string descriptor numbers ... note that string
 166          * contents can be overridden by the composite_dev glue.
 167          */
 168
 169         status = usb_string_ids_tab(cdev, strings_dev);
 170         if (status < 0)
 171                 return status;
 172         device_desc.iManufacturer = strings_dev[USB_GADGET_MANUFACTURER_IDX].id;
 173         device_desc.iProduct = strings_dev[USB_GADGET_PRODUCT_IDX].id;
 174
 175         /* register our configuration */
 176         status = usb_add_config(cdev, &config_driver, do_config);
 177         if (status < 0)
 178                 return status;
 179
 180         usb_composite_overwrite_options(cdev, &coverwrite);
 181         dev_info(&gadget->dev, DRIVER_DESC ", version: " DRIVER_VERSION "\n");
 182
 183         return 0;
 184 }
 185
 186 static int __exit hid_unbind(struct usb_composite_dev *cdev)
 187 {
 188         ghid_cleanup();
 189         return 0;
 190 }
 191
 192 static int __init hidg_plat_driver_probe(struct platform_device *pdev)
 193 {
 194         struct hidg_func_descriptor *func = pdev->dev.platform_data;
 195         struct hidg_func_node *entry;
 196
 197         if (!func) {
 198                 dev_err(&pdev->dev, "Platform data missing\n");
 199                 return -ENODEV;
 200         }
 201
 202         entry = kzalloc(sizeof(*entry), GFP_KERNEL);
 203         if (!entry)
 204                 return -ENOMEM;
 205
 206         entry->func = func;
 207         list_add_tail(&entry->node, &hidg_func_list);
 208
 209         return 0;
 210 }
 211
 212 static int __devexit hidg_plat_driver_remove(struct platform_device *pdev)
 213 {
 214         struct hidg_func_node *e, *n;
 215
 216         list_for_each_entry_safe(e, n, &hidg_func_list, node) {
 217                 list_del(&e->node);
 218                 kfree(e);
 219         }
 220
 221         return 0;
 222 }
 223
 224
 225 /****************************** Some noise ******************************/
 226
 227
 228 static __refdata struct usb_composite_driver hidg_driver = {
 229         .name           = "g_hid",
 230         .dev            = &device_desc,
 231         .strings        = dev_strings,
 232         .max_speed      = USB_SPEED_HIGH,
 233         .bind           = hid_bind,
 234         .unbind         = __exit_p(hid_unbind),
 235 };
 236
 237 static struct platform_driver hidg_plat_driver = {
 238         .remove         = __devexit_p(hidg_plat_driver_remove),
 239         .driver         = {
 240                 .owner  = THIS_MODULE,
 241                 .name   = "hidg",
 242         },
 243 };
 244
 245
 246 MODULE_DESCRIPTION(DRIVER_DESC);
 247 MODULE_AUTHOR("Fabien Chouteau, Peter Korsgaard");
 248 MODULE_LICENSE("GPL");
 249
 250 static int __init hidg_init(void)
 251 {
 252         int status;
 253
 254         status = platform_driver_probe(&hidg_plat_driver,
 255                                 hidg_plat_driver_probe);
 256         if (status < 0)
 257                 return status;
 258
 259         status = usb_composite_probe(&hidg_driver);
 260         if (status < 0)
 261                 platform_driver_unregister(&hidg_plat_driver);
 262
 263         return status;
 264 }
 265 module_init(hidg_init);
 266
 267 static void __exit hidg_cleanup(void)
 268 {
 269         platform_driver_unregister(&hidg_plat_driver);
 270         usb_composite_unregister(&hidg_driver);
 271 }
 272 module_exit(hidg_cleanup);