huawei_cdc_ncm.c 6.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230
  1. /* huawei_cdc_ncm.c - handles Huawei devices using the CDC NCM protocol as
  2. * transport layer.
  3. * Copyright (C) 2013 Enrico Mioso <mrkiko.rs@gmail.com>
  4. *
  5. *
  6. * ABSTRACT:
  7. * This driver handles devices resembling the CDC NCM standard, but
  8. * encapsulating another protocol inside it. An example are some Huawei 3G
  9. * devices, exposing an embedded AT channel where you can set up the NCM
  10. * connection.
  11. * This code has been heavily inspired by the cdc_mbim.c driver, which is
  12. * Copyright (c) 2012 Smith Micro Software, Inc.
  13. * Copyright (c) 2012 Bjørn Mork <bjorn@mork.no>
  14. *
  15. * This program is free software; you can redistribute it and/or
  16. * modify it under the terms of the GNU General Public License
  17. * version 2 as published by the Free Software Foundation.
  18. */
  19. #include <linux/module.h>
  20. #include <linux/netdevice.h>
  21. #include <linux/ethtool.h>
  22. #include <linux/if_vlan.h>
  23. #include <linux/ip.h>
  24. #include <linux/mii.h>
  25. #include <linux/usb.h>
  26. #include <linux/usb/cdc.h>
  27. #include <linux/usb/usbnet.h>
  28. #include <linux/usb/cdc-wdm.h>
  29. #include <linux/usb/cdc_ncm.h>
  30. /* Driver data */
  31. struct huawei_cdc_ncm_state {
  32. struct cdc_ncm_ctx *ctx;
  33. atomic_t pmcount;
  34. struct usb_driver *subdriver;
  35. struct usb_interface *control;
  36. struct usb_interface *data;
  37. };
  38. static int huawei_cdc_ncm_manage_power(struct usbnet *usbnet_dev, int on)
  39. {
  40. struct huawei_cdc_ncm_state *drvstate = (void *)&usbnet_dev->data;
  41. int rv;
  42. if ((on && atomic_add_return(1, &drvstate->pmcount) == 1) ||
  43. (!on && atomic_dec_and_test(&drvstate->pmcount))) {
  44. rv = usb_autopm_get_interface(usbnet_dev->intf);
  45. usbnet_dev->intf->needs_remote_wakeup = on;
  46. if (!rv)
  47. usb_autopm_put_interface(usbnet_dev->intf);
  48. }
  49. return 0;
  50. }
  51. static int huawei_cdc_ncm_wdm_manage_power(struct usb_interface *intf,
  52. int status)
  53. {
  54. struct usbnet *usbnet_dev = usb_get_intfdata(intf);
  55. /* can be called while disconnecting */
  56. if (!usbnet_dev)
  57. return 0;
  58. return huawei_cdc_ncm_manage_power(usbnet_dev, status);
  59. }
  60. static int huawei_cdc_ncm_bind(struct usbnet *usbnet_dev,
  61. struct usb_interface *intf)
  62. {
  63. struct cdc_ncm_ctx *ctx;
  64. struct usb_driver *subdriver = ERR_PTR(-ENODEV);
  65. int ret = -ENODEV;
  66. struct huawei_cdc_ncm_state *drvstate = (void *)&usbnet_dev->data;
  67. /* altsetting should always be 1 for NCM devices - so we hard-coded
  68. * it here
  69. */
  70. ret = cdc_ncm_bind_common(usbnet_dev, intf, 1);
  71. if (ret)
  72. goto err;
  73. ctx = drvstate->ctx;
  74. if (usbnet_dev->status)
  75. /* CDC-WMC r1.1 requires wMaxCommand to be "at least 256
  76. * decimal (0x100)"
  77. */
  78. subdriver = usb_cdc_wdm_register(ctx->control,
  79. &usbnet_dev->status->desc,
  80. 256, /* wMaxCommand */
  81. huawei_cdc_ncm_wdm_manage_power);
  82. if (IS_ERR(subdriver)) {
  83. ret = PTR_ERR(subdriver);
  84. cdc_ncm_unbind(usbnet_dev, intf);
  85. goto err;
  86. }
  87. /* Prevent usbnet from using the status descriptor */
  88. usbnet_dev->status = NULL;
  89. drvstate->subdriver = subdriver;
  90. err:
  91. return ret;
  92. }
  93. static void huawei_cdc_ncm_unbind(struct usbnet *usbnet_dev,
  94. struct usb_interface *intf)
  95. {
  96. struct huawei_cdc_ncm_state *drvstate = (void *)&usbnet_dev->data;
  97. struct cdc_ncm_ctx *ctx = drvstate->ctx;
  98. if (drvstate->subdriver && drvstate->subdriver->disconnect)
  99. drvstate->subdriver->disconnect(ctx->control);
  100. drvstate->subdriver = NULL;
  101. cdc_ncm_unbind(usbnet_dev, intf);
  102. }
  103. static int huawei_cdc_ncm_suspend(struct usb_interface *intf,
  104. pm_message_t message)
  105. {
  106. int ret = 0;
  107. struct usbnet *usbnet_dev = usb_get_intfdata(intf);
  108. struct huawei_cdc_ncm_state *drvstate = (void *)&usbnet_dev->data;
  109. struct cdc_ncm_ctx *ctx = drvstate->ctx;
  110. if (ctx == NULL) {
  111. ret = -ENODEV;
  112. goto error;
  113. }
  114. ret = usbnet_suspend(intf, message);
  115. if (ret < 0)
  116. goto error;
  117. if (intf == ctx->control &&
  118. drvstate->subdriver &&
  119. drvstate->subdriver->suspend)
  120. ret = drvstate->subdriver->suspend(intf, message);
  121. if (ret < 0)
  122. usbnet_resume(intf);
  123. error:
  124. return ret;
  125. }
  126. static int huawei_cdc_ncm_resume(struct usb_interface *intf)
  127. {
  128. int ret = 0;
  129. struct usbnet *usbnet_dev = usb_get_intfdata(intf);
  130. struct huawei_cdc_ncm_state *drvstate = (void *)&usbnet_dev->data;
  131. bool callsub;
  132. struct cdc_ncm_ctx *ctx = drvstate->ctx;
  133. /* should we call subdriver's resume function? */
  134. callsub =
  135. (intf == ctx->control &&
  136. drvstate->subdriver &&
  137. drvstate->subdriver->resume);
  138. if (callsub)
  139. ret = drvstate->subdriver->resume(intf);
  140. if (ret < 0)
  141. goto err;
  142. ret = usbnet_resume(intf);
  143. if (ret < 0 && callsub)
  144. drvstate->subdriver->suspend(intf, PMSG_SUSPEND);
  145. err:
  146. return ret;
  147. }
  148. static int huawei_cdc_ncm_check_connect(struct usbnet *usbnet_dev)
  149. {
  150. struct cdc_ncm_ctx *ctx;
  151. ctx = (struct cdc_ncm_ctx *)usbnet_dev->data[0];
  152. if (ctx == NULL)
  153. return 1; /* disconnected */
  154. return !ctx->connected;
  155. }
  156. static const struct driver_info huawei_cdc_ncm_info = {
  157. .description = "Huawei CDC NCM device",
  158. .flags = FLAG_NO_SETINT | FLAG_MULTI_PACKET | FLAG_WWAN,
  159. .bind = huawei_cdc_ncm_bind,
  160. .unbind = huawei_cdc_ncm_unbind,
  161. .check_connect = huawei_cdc_ncm_check_connect,
  162. .manage_power = huawei_cdc_ncm_manage_power,
  163. .rx_fixup = cdc_ncm_rx_fixup,
  164. .tx_fixup = cdc_ncm_tx_fixup,
  165. };
  166. static const struct usb_device_id huawei_cdc_ncm_devs[] = {
  167. /* Huawei NCM devices disguised as vendor specific */
  168. { USB_VENDOR_AND_INTERFACE_INFO(0x12d1, 0xff, 0x02, 0x16),
  169. .driver_info = (unsigned long)&huawei_cdc_ncm_info,
  170. },
  171. { USB_VENDOR_AND_INTERFACE_INFO(0x12d1, 0xff, 0x02, 0x46),
  172. .driver_info = (unsigned long)&huawei_cdc_ncm_info,
  173. },
  174. { USB_VENDOR_AND_INTERFACE_INFO(0x12d1, 0xff, 0x02, 0x76),
  175. .driver_info = (unsigned long)&huawei_cdc_ncm_info,
  176. },
  177. /* Terminating entry */
  178. {
  179. },
  180. };
  181. MODULE_DEVICE_TABLE(usb, huawei_cdc_ncm_devs);
  182. static struct usb_driver huawei_cdc_ncm_driver = {
  183. .name = "huawei_cdc_ncm",
  184. .id_table = huawei_cdc_ncm_devs,
  185. .probe = usbnet_probe,
  186. .disconnect = usbnet_disconnect,
  187. .suspend = huawei_cdc_ncm_suspend,
  188. .resume = huawei_cdc_ncm_resume,
  189. .reset_resume = huawei_cdc_ncm_resume,
  190. .supports_autosuspend = 1,
  191. .disable_hub_initiated_lpm = 1,
  192. };
  193. module_usb_driver(huawei_cdc_ncm_driver);
  194. MODULE_AUTHOR("Enrico Mioso <mrkiko.rs@gmail.com>");
  195. MODULE_DESCRIPTION("USB CDC NCM host driver with encapsulated protocol support");
  196. MODULE_LICENSE("GPL");