huawei_cdc_ncm.c 6.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227
  1. // SPDX-License-Identifier: GPL-2.0-only
  2. /* huawei_cdc_ncm.c - handles Huawei devices using the CDC NCM protocol as
  3. * transport layer.
  4. * Copyright (C) 2013 Enrico Mioso <[email protected]>
  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 <[email protected]>
  14. */
  15. #include <linux/module.h>
  16. #include <linux/netdevice.h>
  17. #include <linux/ethtool.h>
  18. #include <linux/if_vlan.h>
  19. #include <linux/ip.h>
  20. #include <linux/mii.h>
  21. #include <linux/usb.h>
  22. #include <linux/usb/cdc.h>
  23. #include <linux/usb/usbnet.h>
  24. #include <linux/usb/cdc-wdm.h>
  25. #include <linux/usb/cdc_ncm.h>
  26. /* Driver data */
  27. struct huawei_cdc_ncm_state {
  28. struct cdc_ncm_ctx *ctx;
  29. atomic_t pmcount;
  30. struct usb_driver *subdriver;
  31. struct usb_interface *control;
  32. struct usb_interface *data;
  33. };
  34. static int huawei_cdc_ncm_manage_power(struct usbnet *usbnet_dev, int on)
  35. {
  36. struct huawei_cdc_ncm_state *drvstate = (void *)&usbnet_dev->data;
  37. int rv;
  38. if ((on && atomic_add_return(1, &drvstate->pmcount) == 1) ||
  39. (!on && atomic_dec_and_test(&drvstate->pmcount))) {
  40. rv = usb_autopm_get_interface(usbnet_dev->intf);
  41. usbnet_dev->intf->needs_remote_wakeup = on;
  42. if (!rv)
  43. usb_autopm_put_interface(usbnet_dev->intf);
  44. }
  45. return 0;
  46. }
  47. static int huawei_cdc_ncm_wdm_manage_power(struct usb_interface *intf,
  48. int status)
  49. {
  50. struct usbnet *usbnet_dev = usb_get_intfdata(intf);
  51. /* can be called while disconnecting */
  52. if (!usbnet_dev)
  53. return 0;
  54. return huawei_cdc_ncm_manage_power(usbnet_dev, status);
  55. }
  56. static int huawei_cdc_ncm_bind(struct usbnet *usbnet_dev,
  57. struct usb_interface *intf)
  58. {
  59. struct cdc_ncm_ctx *ctx;
  60. struct usb_driver *subdriver = ERR_PTR(-ENODEV);
  61. int ret;
  62. struct huawei_cdc_ncm_state *drvstate = (void *)&usbnet_dev->data;
  63. int drvflags = 0;
  64. /* altsetting should always be 1 for NCM devices - so we hard-coded
  65. * it here. Some huawei devices will need the NDP part of the NCM package to
  66. * be at the end of the frame.
  67. */
  68. drvflags |= CDC_NCM_FLAG_NDP_TO_END;
  69. /* For many Huawei devices the NTB32 mode is the default and the best mode
  70. * they work with. Huawei E5785 and E5885 devices refuse to work in NTB16 mode at all.
  71. */
  72. drvflags |= CDC_NCM_FLAG_PREFER_NTB32;
  73. ret = cdc_ncm_bind_common(usbnet_dev, intf, 1, drvflags);
  74. if (ret)
  75. goto err;
  76. ctx = drvstate->ctx;
  77. if (usbnet_dev->status)
  78. /* The wMaxCommand buffer must be big enough to hold
  79. * any message from the modem. Experience has shown
  80. * that some replies are more than 256 bytes long
  81. */
  82. subdriver = usb_cdc_wdm_register(ctx->control,
  83. &usbnet_dev->status->desc,
  84. 1024, /* wMaxCommand */
  85. WWAN_PORT_AT,
  86. huawei_cdc_ncm_wdm_manage_power);
  87. if (IS_ERR(subdriver)) {
  88. ret = PTR_ERR(subdriver);
  89. cdc_ncm_unbind(usbnet_dev, intf);
  90. goto err;
  91. }
  92. /* Prevent usbnet from using the status descriptor */
  93. usbnet_dev->status = NULL;
  94. drvstate->subdriver = subdriver;
  95. err:
  96. return ret;
  97. }
  98. static void huawei_cdc_ncm_unbind(struct usbnet *usbnet_dev,
  99. struct usb_interface *intf)
  100. {
  101. struct huawei_cdc_ncm_state *drvstate = (void *)&usbnet_dev->data;
  102. struct cdc_ncm_ctx *ctx = drvstate->ctx;
  103. if (drvstate->subdriver && drvstate->subdriver->disconnect)
  104. drvstate->subdriver->disconnect(ctx->control);
  105. drvstate->subdriver = NULL;
  106. cdc_ncm_unbind(usbnet_dev, intf);
  107. }
  108. static int huawei_cdc_ncm_suspend(struct usb_interface *intf,
  109. pm_message_t message)
  110. {
  111. int ret = 0;
  112. struct usbnet *usbnet_dev = usb_get_intfdata(intf);
  113. struct huawei_cdc_ncm_state *drvstate = (void *)&usbnet_dev->data;
  114. struct cdc_ncm_ctx *ctx = drvstate->ctx;
  115. if (ctx == NULL) {
  116. ret = -ENODEV;
  117. goto error;
  118. }
  119. ret = usbnet_suspend(intf, message);
  120. if (ret < 0)
  121. goto error;
  122. if (intf == ctx->control &&
  123. drvstate->subdriver &&
  124. drvstate->subdriver->suspend)
  125. ret = drvstate->subdriver->suspend(intf, message);
  126. if (ret < 0)
  127. usbnet_resume(intf);
  128. error:
  129. return ret;
  130. }
  131. static int huawei_cdc_ncm_resume(struct usb_interface *intf)
  132. {
  133. int ret = 0;
  134. struct usbnet *usbnet_dev = usb_get_intfdata(intf);
  135. struct huawei_cdc_ncm_state *drvstate = (void *)&usbnet_dev->data;
  136. bool callsub;
  137. struct cdc_ncm_ctx *ctx = drvstate->ctx;
  138. /* should we call subdriver's resume function? */
  139. callsub =
  140. (intf == ctx->control &&
  141. drvstate->subdriver &&
  142. drvstate->subdriver->resume);
  143. if (callsub)
  144. ret = drvstate->subdriver->resume(intf);
  145. if (ret < 0)
  146. goto err;
  147. ret = usbnet_resume(intf);
  148. if (ret < 0 && callsub)
  149. drvstate->subdriver->suspend(intf, PMSG_SUSPEND);
  150. err:
  151. return ret;
  152. }
  153. static const struct driver_info huawei_cdc_ncm_info = {
  154. .description = "Huawei CDC NCM device",
  155. .flags = FLAG_NO_SETINT | FLAG_MULTI_PACKET | FLAG_WWAN,
  156. .bind = huawei_cdc_ncm_bind,
  157. .unbind = huawei_cdc_ncm_unbind,
  158. .manage_power = huawei_cdc_ncm_manage_power,
  159. .rx_fixup = cdc_ncm_rx_fixup,
  160. .tx_fixup = cdc_ncm_tx_fixup,
  161. };
  162. static const struct usb_device_id huawei_cdc_ncm_devs[] = {
  163. /* Huawei NCM devices disguised as vendor specific */
  164. { USB_VENDOR_AND_INTERFACE_INFO(0x12d1, 0xff, 0x02, 0x16),
  165. .driver_info = (unsigned long)&huawei_cdc_ncm_info,
  166. },
  167. { USB_VENDOR_AND_INTERFACE_INFO(0x12d1, 0xff, 0x02, 0x46),
  168. .driver_info = (unsigned long)&huawei_cdc_ncm_info,
  169. },
  170. { USB_VENDOR_AND_INTERFACE_INFO(0x12d1, 0xff, 0x02, 0x76),
  171. .driver_info = (unsigned long)&huawei_cdc_ncm_info,
  172. },
  173. { USB_VENDOR_AND_INTERFACE_INFO(0x12d1, 0xff, 0x03, 0x16),
  174. .driver_info = (unsigned long)&huawei_cdc_ncm_info,
  175. },
  176. /* Terminating entry */
  177. {
  178. },
  179. };
  180. MODULE_DEVICE_TABLE(usb, huawei_cdc_ncm_devs);
  181. static struct usb_driver huawei_cdc_ncm_driver = {
  182. .name = "huawei_cdc_ncm",
  183. .id_table = huawei_cdc_ncm_devs,
  184. .probe = usbnet_probe,
  185. .disconnect = usbnet_disconnect,
  186. .suspend = huawei_cdc_ncm_suspend,
  187. .resume = huawei_cdc_ncm_resume,
  188. .reset_resume = huawei_cdc_ncm_resume,
  189. .supports_autosuspend = 1,
  190. .disable_hub_initiated_lpm = 1,
  191. };
  192. module_usb_driver(huawei_cdc_ncm_driver);
  193. MODULE_AUTHOR("Enrico Mioso <[email protected]>");
  194. MODULE_DESCRIPTION("USB CDC NCM host driver with encapsulated protocol support");
  195. MODULE_LICENSE("GPL");