musb_gadget.h 3.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130
  1. /*
  2. * MUSB OTG driver peripheral defines
  3. *
  4. * Copyright 2005 Mentor Graphics Corporation
  5. * Copyright (C) 2005-2006 by Texas Instruments
  6. * Copyright (C) 2006-2007 Nokia Corporation
  7. *
  8. * This program is free software; you can redistribute it and/or
  9. * modify it under the terms of the GNU General Public License
  10. * version 2 as published by the Free Software Foundation.
  11. *
  12. * This program is distributed in the hope that it will be useful, but
  13. * WITHOUT ANY WARRANTY; without even the implied warranty of
  14. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  15. * General Public License for more details.
  16. *
  17. * You should have received a copy of the GNU General Public License
  18. * along with this program; if not, write to the Free Software
  19. * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
  20. * 02110-1301 USA
  21. *
  22. * THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESS OR IMPLIED
  23. * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
  24. * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN
  25. * NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY DIRECT, INDIRECT,
  26. * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  27. * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
  28. * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
  29. * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  30. * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  31. * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  32. *
  33. */
  34. #ifndef __MUSB_GADGET_H
  35. #define __MUSB_GADGET_H
  36. #include <linux/list.h>
  37. #ifdef __UBOOT__
  38. #include <asm/byteorder.h>
  39. #include <asm/errno.h>
  40. #include <linux/usb/ch9.h>
  41. #include <linux/usb/gadget.h>
  42. #endif
  43. enum buffer_map_state {
  44. UN_MAPPED = 0,
  45. PRE_MAPPED,
  46. MUSB_MAPPED
  47. };
  48. struct musb_request {
  49. struct usb_request request;
  50. struct list_head list;
  51. struct musb_ep *ep;
  52. struct musb *musb;
  53. u8 tx; /* endpoint direction */
  54. u8 epnum;
  55. enum buffer_map_state map_state;
  56. };
  57. static inline struct musb_request *to_musb_request(struct usb_request *req)
  58. {
  59. return req ? container_of(req, struct musb_request, request) : NULL;
  60. }
  61. extern struct usb_request *
  62. musb_alloc_request(struct usb_ep *ep, gfp_t gfp_flags);
  63. extern void musb_free_request(struct usb_ep *ep, struct usb_request *req);
  64. /*
  65. * struct musb_ep - peripheral side view of endpoint rx or tx side
  66. */
  67. struct musb_ep {
  68. /* stuff towards the head is basically write-once. */
  69. struct usb_ep end_point;
  70. char name[12];
  71. struct musb_hw_ep *hw_ep;
  72. struct musb *musb;
  73. u8 current_epnum;
  74. /* ... when enabled/disabled ... */
  75. u8 type;
  76. u8 is_in;
  77. u16 packet_sz;
  78. const struct usb_endpoint_descriptor *desc;
  79. struct dma_channel *dma;
  80. /* later things are modified based on usage */
  81. struct list_head req_list;
  82. u8 wedged;
  83. /* true if lock must be dropped but req_list may not be advanced */
  84. u8 busy;
  85. u8 hb_mult;
  86. };
  87. static inline struct musb_ep *to_musb_ep(struct usb_ep *ep)
  88. {
  89. return ep ? container_of(ep, struct musb_ep, end_point) : NULL;
  90. }
  91. static inline struct musb_request *next_request(struct musb_ep *ep)
  92. {
  93. struct list_head *queue = &ep->req_list;
  94. if (list_empty(queue))
  95. return NULL;
  96. return container_of(queue->next, struct musb_request, list);
  97. }
  98. extern void musb_g_tx(struct musb *musb, u8 epnum);
  99. extern void musb_g_rx(struct musb *musb, u8 epnum);
  100. extern const struct usb_ep_ops musb_g_ep0_ops;
  101. extern int musb_gadget_setup(struct musb *);
  102. extern void musb_gadget_cleanup(struct musb *);
  103. extern void musb_g_giveback(struct musb_ep *, struct usb_request *, int);
  104. extern void musb_ep_restart(struct musb *, struct musb_request *);
  105. #ifdef __UBOOT__
  106. int musb_gadget_start(struct usb_gadget *g, struct usb_gadget_driver *driver);
  107. #endif
  108. #endif /* __MUSB_GADGET_H */