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 88 static inline int ci_hdrc_gadget_init(struct ci_hdrc *ci) 89 { 90 return -ENXIO; 91 } 92 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