common.c 6.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248
  1. /*
  2. * Provides code common for host and device side USB.
  3. *
  4. * This program is free software; you can redistribute it and/or
  5. * modify it under the terms of the GNU General Public License as
  6. * published by the Free Software Foundation, version 2.
  7. *
  8. * If either host side (ie. CONFIG_USB=y) or device side USB stack
  9. * (ie. CONFIG_USB_GADGET=y) is compiled in the kernel, this module is
  10. * compiled-in as well. Otherwise, if either of the two stacks is
  11. * compiled as module, this file is compiled as module as well.
  12. */
  13. #include <linux/kernel.h>
  14. #include <linux/module.h>
  15. #include <linux/of.h>
  16. #include <linux/usb/ch9.h>
  17. #include <linux/usb/of.h>
  18. #include <linux/usb/otg.h>
  19. #include <linux/of_platform.h>
  20. const char *usb_otg_state_string(enum usb_otg_state state)
  21. {
  22. static const char *const names[] = {
  23. [OTG_STATE_A_IDLE] = "a_idle",
  24. [OTG_STATE_A_WAIT_VRISE] = "a_wait_vrise",
  25. [OTG_STATE_A_WAIT_BCON] = "a_wait_bcon",
  26. [OTG_STATE_A_HOST] = "a_host",
  27. [OTG_STATE_A_SUSPEND] = "a_suspend",
  28. [OTG_STATE_A_PERIPHERAL] = "a_peripheral",
  29. [OTG_STATE_A_WAIT_VFALL] = "a_wait_vfall",
  30. [OTG_STATE_A_VBUS_ERR] = "a_vbus_err",
  31. [OTG_STATE_B_IDLE] = "b_idle",
  32. [OTG_STATE_B_SRP_INIT] = "b_srp_init",
  33. [OTG_STATE_B_PERIPHERAL] = "b_peripheral",
  34. [OTG_STATE_B_WAIT_ACON] = "b_wait_acon",
  35. [OTG_STATE_B_HOST] = "b_host",
  36. };
  37. if (state < 0 || state >= ARRAY_SIZE(names))
  38. return "UNDEFINED";
  39. return names[state];
  40. }
  41. EXPORT_SYMBOL_GPL(usb_otg_state_string);
  42. static const char *const speed_names[] = {
  43. [USB_SPEED_UNKNOWN] = "UNKNOWN",
  44. [USB_SPEED_LOW] = "low-speed",
  45. [USB_SPEED_FULL] = "full-speed",
  46. [USB_SPEED_HIGH] = "high-speed",
  47. [USB_SPEED_WIRELESS] = "wireless",
  48. [USB_SPEED_SUPER] = "super-speed",
  49. };
  50. const char *usb_speed_string(enum usb_device_speed speed)
  51. {
  52. if (speed < 0 || speed >= ARRAY_SIZE(speed_names))
  53. speed = USB_SPEED_UNKNOWN;
  54. return speed_names[speed];
  55. }
  56. EXPORT_SYMBOL_GPL(usb_speed_string);
  57. enum usb_device_speed usb_get_maximum_speed(struct device *dev)
  58. {
  59. const char *maximum_speed;
  60. int err;
  61. int i;
  62. err = device_property_read_string(dev, "maximum-speed", &maximum_speed);
  63. if (err < 0)
  64. return USB_SPEED_UNKNOWN;
  65. for (i = 0; i < ARRAY_SIZE(speed_names); i++)
  66. if (strcmp(maximum_speed, speed_names[i]) == 0)
  67. return i;
  68. return USB_SPEED_UNKNOWN;
  69. }
  70. EXPORT_SYMBOL_GPL(usb_get_maximum_speed);
  71. const char *usb_state_string(enum usb_device_state state)
  72. {
  73. static const char *const names[] = {
  74. [USB_STATE_NOTATTACHED] = "not attached",
  75. [USB_STATE_ATTACHED] = "attached",
  76. [USB_STATE_POWERED] = "powered",
  77. [USB_STATE_RECONNECTING] = "reconnecting",
  78. [USB_STATE_UNAUTHENTICATED] = "unauthenticated",
  79. [USB_STATE_DEFAULT] = "default",
  80. [USB_STATE_ADDRESS] = "addressed",
  81. [USB_STATE_CONFIGURED] = "configured",
  82. [USB_STATE_SUSPENDED] = "suspended",
  83. };
  84. if (state < 0 || state >= ARRAY_SIZE(names))
  85. return "UNKNOWN";
  86. return names[state];
  87. }
  88. EXPORT_SYMBOL_GPL(usb_state_string);
  89. static const char *const usb_dr_modes[] = {
  90. [USB_DR_MODE_UNKNOWN] = "",
  91. [USB_DR_MODE_HOST] = "host",
  92. [USB_DR_MODE_PERIPHERAL] = "peripheral",
  93. [USB_DR_MODE_OTG] = "otg",
  94. };
  95. static enum usb_dr_mode usb_get_dr_mode_from_string(const char *str)
  96. {
  97. int i;
  98. for (i = 0; i < ARRAY_SIZE(usb_dr_modes); i++)
  99. if (!strcmp(usb_dr_modes[i], str))
  100. return i;
  101. return USB_DR_MODE_UNKNOWN;
  102. }
  103. enum usb_dr_mode usb_get_dr_mode(struct device *dev)
  104. {
  105. const char *dr_mode;
  106. int err;
  107. err = device_property_read_string(dev, "dr_mode", &dr_mode);
  108. if (err < 0)
  109. return USB_DR_MODE_UNKNOWN;
  110. return usb_get_dr_mode_from_string(dr_mode);
  111. }
  112. EXPORT_SYMBOL_GPL(usb_get_dr_mode);
  113. #ifdef CONFIG_OF
  114. /**
  115. * of_usb_get_dr_mode_by_phy - Get dual role mode for the controller device
  116. * which is associated with the given phy device_node
  117. * @np: Pointer to the given phy device_node
  118. *
  119. * In dts a usb controller associates with phy devices. The function gets
  120. * the string from property 'dr_mode' of the controller associated with the
  121. * given phy device node, and returns the correspondig enum usb_dr_mode.
  122. */
  123. enum usb_dr_mode of_usb_get_dr_mode_by_phy(struct device_node *phy_np)
  124. {
  125. struct device_node *controller = NULL;
  126. struct device_node *phy;
  127. const char *dr_mode;
  128. int index;
  129. int err;
  130. do {
  131. controller = of_find_node_with_property(controller, "phys");
  132. index = 0;
  133. do {
  134. phy = of_parse_phandle(controller, "phys", index);
  135. of_node_put(phy);
  136. if (phy == phy_np)
  137. goto finish;
  138. index++;
  139. } while (phy);
  140. } while (controller);
  141. finish:
  142. err = of_property_read_string(controller, "dr_mode", &dr_mode);
  143. of_node_put(controller);
  144. if (err < 0)
  145. return USB_DR_MODE_UNKNOWN;
  146. return usb_get_dr_mode_from_string(dr_mode);
  147. }
  148. EXPORT_SYMBOL_GPL(of_usb_get_dr_mode_by_phy);
  149. /**
  150. * of_usb_host_tpl_support - to get if Targeted Peripheral List is supported
  151. * for given targeted hosts (non-PC hosts)
  152. * @np: Pointer to the given device_node
  153. *
  154. * The function gets if the targeted hosts support TPL or not
  155. */
  156. bool of_usb_host_tpl_support(struct device_node *np)
  157. {
  158. if (of_find_property(np, "tpl-support", NULL))
  159. return true;
  160. return false;
  161. }
  162. EXPORT_SYMBOL_GPL(of_usb_host_tpl_support);
  163. /**
  164. * of_usb_update_otg_caps - to update usb otg capabilities according to
  165. * the passed properties in DT.
  166. * @np: Pointer to the given device_node
  167. * @otg_caps: Pointer to the target usb_otg_caps to be set
  168. *
  169. * The function updates the otg capabilities
  170. */
  171. int of_usb_update_otg_caps(struct device_node *np,
  172. struct usb_otg_caps *otg_caps)
  173. {
  174. u32 otg_rev;
  175. if (!otg_caps)
  176. return -EINVAL;
  177. if (!of_property_read_u32(np, "otg-rev", &otg_rev)) {
  178. switch (otg_rev) {
  179. case 0x0100:
  180. case 0x0120:
  181. case 0x0130:
  182. case 0x0200:
  183. /* Choose the lesser one if it's already been set */
  184. if (otg_caps->otg_rev)
  185. otg_caps->otg_rev = min_t(u16, otg_rev,
  186. otg_caps->otg_rev);
  187. else
  188. otg_caps->otg_rev = otg_rev;
  189. break;
  190. default:
  191. pr_err("%s: unsupported otg-rev: 0x%x\n",
  192. np->full_name, otg_rev);
  193. return -EINVAL;
  194. }
  195. } else {
  196. /*
  197. * otg-rev is mandatory for otg properties, if not passed
  198. * we set it to be 0 and assume it's a legacy otg device.
  199. * Non-dt platform can set it afterwards.
  200. */
  201. otg_caps->otg_rev = 0;
  202. }
  203. if (of_find_property(np, "hnp-disable", NULL))
  204. otg_caps->hnp_support = false;
  205. if (of_find_property(np, "srp-disable", NULL))
  206. otg_caps->srp_support = false;
  207. if (of_find_property(np, "adp-disable", NULL) ||
  208. (otg_caps->otg_rev < 0x0200))
  209. otg_caps->adp_support = false;
  210. return 0;
  211. }
  212. EXPORT_SYMBOL_GPL(of_usb_update_otg_caps);
  213. #endif
  214. MODULE_LICENSE("GPL");