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