xref: /linux/drivers/usb/chipidea/udc.h (revision ca55b2fef3a9373fcfc30f82fd26bc7fccbda732)
1 /*
2  * udc.h - ChipIdea UDC structures
3  *
4  * Copyright (C) 2008 Chipidea - MIPS Technologies, Inc. All rights reserved.
5  *
6  * Author: David Lopo
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 version 2 as
10  * published by the Free Software Foundation.
11  */
12 
13 #ifndef __DRIVERS_USB_CHIPIDEA_UDC_H
14 #define __DRIVERS_USB_CHIPIDEA_UDC_H
15 
16 #include <linux/list.h>
17 
18 #define CTRL_PAYLOAD_MAX   64
19 #define RX        0  /* similar to USB_DIR_OUT but can be used as an index */
20 #define TX        1  /* similar to USB_DIR_IN  but can be used as an index */
21 
22 /* DMA layout of transfer descriptors */
23 struct ci_hw_td {
24 	/* 0 */
25 	u32 next;
26 #define TD_TERMINATE          BIT(0)
27 #define TD_ADDR_MASK          (0xFFFFFFEUL << 5)
28 	/* 1 */
29 	u32 token;
30 #define TD_STATUS             (0x00FFUL <<  0)
31 #define TD_STATUS_TR_ERR      BIT(3)
32 #define TD_STATUS_DT_ERR      BIT(5)
33 #define TD_STATUS_HALTED      BIT(6)
34 #define TD_STATUS_ACTIVE      BIT(7)
35 #define TD_MULTO              (0x0003UL << 10)
36 #define TD_IOC                BIT(15)
37 #define TD_TOTAL_BYTES        (0x7FFFUL << 16)
38 	/* 2 */
39 	u32 page[5];
40 #define TD_CURR_OFFSET        (0x0FFFUL <<  0)
41 #define TD_FRAME_NUM          (0x07FFUL <<  0)
42 #define TD_RESERVED_MASK      (0x0FFFUL <<  0)
43 } __attribute__ ((packed, aligned(4)));
44 
45 /* DMA layout of queue heads */
46 struct ci_hw_qh {
47 	/* 0 */
48 	u32 cap;
49 #define QH_IOS                BIT(15)
50 #define QH_MAX_PKT            (0x07FFUL << 16)
51 #define QH_ZLT                BIT(29)
52 #define QH_MULT               (0x0003UL << 30)
53 #define QH_ISO_MULT(x)		((x >> 11) & 0x03)
54 	/* 1 */
55 	u32 curr;
56 	/* 2 - 8 */
57 	struct ci_hw_td		td;
58 	/* 9 */
59 	u32 RESERVED;
60 	struct usb_ctrlrequest   setup;
61 } __attribute__ ((packed, aligned(4)));
62 
63 struct td_node {
64 	struct list_head	td;
65 	dma_addr_t		dma;
66 	struct ci_hw_td		*ptr;
67 };
68 
69 /**
70  * struct ci_hw_req - usb request representation
71  * @req: request structure for gadget drivers
72  * @queue: link to QH list
73  * @ptr: transfer descriptor for this request
74  * @dma: dma address for the transfer descriptor
75  * @zptr: transfer descriptor for the zero packet
76  * @zdma: dma address of the zero packet's transfer descriptor
77  */
78 struct ci_hw_req {
79 	struct usb_request	req;
80 	struct list_head	queue;
81 	struct list_head	tds;
82 };
83 
84 #ifdef CONFIG_USB_CHIPIDEA_UDC
85 
86 int ci_hdrc_gadget_init(struct ci_hdrc *ci);
87 void ci_hdrc_gadget_destroy(struct ci_hdrc *ci);
88 
89 #else
90 
91 static inline int ci_hdrc_gadget_init(struct ci_hdrc *ci)
92 {
93 	return -ENXIO;
94 }
95 
96 static inline void ci_hdrc_gadget_destroy(struct ci_hdrc *ci)
97 {
98 
99 }
100 
101 #endif
102 
103 #endif /* __DRIVERS_USB_CHIPIDEA_UDC_H */
104