| /* |
| * ci13xxx_udc.h - structures, registers, and macros MIPS USB IP core |
| * |
| * Copyright (C) 2008 Chipidea - MIPS Technologies, Inc. All rights reserved. |
| * |
| * Author: David Lopo |
| * |
| * This program is free software; you can redistribute it and/or modify |
| * it under the terms of the GNU General Public License version 2 as |
| * published by the Free Software Foundation. |
| * |
| * Description: MIPS USB IP core family device controller |
| * Structures, registers and logging macros |
| */ |
| |
| #ifndef _CI13XXX_h_ |
| #define _CI13XXX_h_ |
| |
| /****************************************************************************** |
| * DEFINE |
| *****************************************************************************/ |
| #define CI13XXX_PAGE_SIZE 4096ul /* page size for TD's */ |
| #define ENDPT_MAX (32) |
| #define CTRL_PAYLOAD_MAX (64) |
| #define RX (0) /* similar to USB_DIR_OUT but can be used as an index */ |
| #define TX (1) /* similar to USB_DIR_IN but can be used as an index */ |
| |
| /* UDC private data: |
| * 16MSb - Vendor ID | 16 LSb Vendor private data |
| */ |
| #define CI13XX_REQ_VENDOR_ID(id) (id & 0xFFFF0000UL) |
| |
| #define MSM_ETD_TYPE BIT(1) |
| #define MSM_EP_PIPE_ID_RESET_VAL 0x1F001F |
| |
| /****************************************************************************** |
| * STRUCTURES |
| *****************************************************************************/ |
| /* DMA layout of transfer descriptors */ |
| struct ci13xxx_td { |
| /* 0 */ |
| u32 next; |
| #define TD_TERMINATE BIT(0) |
| #define TD_ADDR_MASK (0xFFFFFFEUL << 5) |
| /* 1 */ |
| u32 token; |
| #define TD_STATUS (0x00FFUL << 0) |
| #define TD_STATUS_TR_ERR BIT(3) |
| #define TD_STATUS_DT_ERR BIT(5) |
| #define TD_STATUS_HALTED BIT(6) |
| #define TD_STATUS_ACTIVE BIT(7) |
| #define TD_MULTO (0x0003UL << 10) |
| #define TD_IOC BIT(15) |
| #define TD_TOTAL_BYTES (0x7FFFUL << 16) |
| /* 2 */ |
| u32 page[5]; |
| #define TD_CURR_OFFSET (0x0FFFUL << 0) |
| #define TD_FRAME_NUM (0x07FFUL << 0) |
| #define TD_RESERVED_MASK (0x0FFFUL << 0) |
| } __attribute__ ((packed)); |
| |
| /* DMA layout of queue heads */ |
| struct ci13xxx_qh { |
| /* 0 */ |
| u32 cap; |
| #define QH_IOS BIT(15) |
| #define QH_MAX_PKT (0x07FFUL << 16) |
| #define QH_ZLT BIT(29) |
| #define QH_MULT (0x0003UL << 30) |
| #define QH_MULT_SHIFT 11 |
| /* 1 */ |
| u32 curr; |
| /* 2 - 8 */ |
| struct ci13xxx_td td; |
| /* 9 */ |
| u32 RESERVED; |
| struct usb_ctrlrequest setup; |
| } __attribute__ ((packed)); |
| |
| /* cache of larger request's original attributes */ |
| struct ci13xxx_multi_req { |
| unsigned len; |
| unsigned actual; |
| void *buf; |
| }; |
| |
| /* Extension of usb_request */ |
| struct ci13xxx_req { |
| struct usb_request req; |
| unsigned map; |
| struct list_head queue; |
| struct ci13xxx_td *ptr; |
| dma_addr_t dma; |
| struct ci13xxx_td *zptr; |
| dma_addr_t zdma; |
| struct ci13xxx_multi_req multi; |
| }; |
| |
| /* Extension of usb_ep */ |
| struct ci13xxx_ep { |
| struct usb_ep ep; |
| const struct usb_endpoint_descriptor *desc; |
| u8 dir; |
| u8 num; |
| u8 type; |
| char name[16]; |
| struct { |
| struct list_head queue; |
| struct ci13xxx_qh *ptr; |
| dma_addr_t dma; |
| } qh; |
| int wedge; |
| |
| /* global resources */ |
| spinlock_t *lock; |
| struct device *device; |
| struct dma_pool *td_pool; |
| struct ci13xxx_td *last_zptr; |
| dma_addr_t last_zdma; |
| unsigned long dTD_update_fail_count; |
| unsigned long prime_fail_count; |
| int prime_timer_count; |
| struct timer_list prime_timer; |
| |
| bool multi_req; |
| }; |
| |
| struct ci13xxx; |
| struct ci13xxx_udc_driver { |
| const char *name; |
| unsigned long flags; |
| unsigned int nz_itc; |
| #define CI13XXX_REGS_SHARED BIT(0) |
| #define CI13XXX_REQUIRE_TRANSCEIVER BIT(1) |
| #define CI13XXX_PULLUP_ON_VBUS BIT(2) |
| #define CI13XXX_DISABLE_STREAMING BIT(3) |
| #define CI13XXX_ZERO_ITC BIT(4) |
| #define CI13XXX_IS_OTG BIT(5) |
| |
| #define CI13XXX_CONTROLLER_RESET_EVENT 0 |
| #define CI13XXX_CONTROLLER_CONNECT_EVENT 1 |
| #define CI13XXX_CONTROLLER_SUSPEND_EVENT 2 |
| #define CI13XXX_CONTROLLER_REMOTE_WAKEUP_EVENT 3 |
| #define CI13XXX_CONTROLLER_RESUME_EVENT 4 |
| #define CI13XXX_CONTROLLER_DISCONNECT_EVENT 5 |
| #define CI13XXX_CONTROLLER_UDC_STARTED_EVENT 6 |
| |
| void (*notify_event) (struct ci13xxx *udc, unsigned event); |
| }; |
| |
| /* CI13XXX UDC descriptor & global resources */ |
| struct ci13xxx { |
| spinlock_t *lock; /* ctrl register bank access */ |
| void __iomem *regs; /* registers address space */ |
| |
| struct dma_pool *qh_pool; /* DMA pool for queue heads */ |
| struct dma_pool *td_pool; /* DMA pool for transfer descs */ |
| struct usb_request *status; /* ep0 status request */ |
| void *status_buf;/* GET_STATUS buffer */ |
| |
| struct usb_gadget gadget; /* USB slave device */ |
| struct ci13xxx_ep ci13xxx_ep[ENDPT_MAX]; /* extended endpts */ |
| u32 ep0_dir; /* ep0 direction */ |
| #define ep0out ci13xxx_ep[0] |
| #define ep0in ci13xxx_ep[hw_ep_max / 2] |
| u8 remote_wakeup; /* Is remote wakeup feature |
| enabled by the host? */ |
| u8 suspended; /* suspended by the host */ |
| u8 configured; /* is device configured */ |
| u8 test_mode; /* the selected test mode */ |
| |
| struct delayed_work rw_work; /* remote wakeup delayed work */ |
| struct usb_gadget_driver *driver; /* 3rd party gadget driver */ |
| struct ci13xxx_udc_driver *udc_driver; /* device controller driver */ |
| int vbus_active; /* is VBUS active */ |
| int softconnect; /* is pull-up enable allowed */ |
| unsigned long dTD_update_fail_count; |
| struct usb_phy *transceiver; /* Transceiver struct */ |
| bool skip_flush; /* skip flushing remaining EP |
| upon flush timeout for the |
| first EP. */ |
| }; |
| |
| struct ci13xxx_platform_data { |
| u8 usb_core_id; |
| void *prv_data; |
| }; |
| |
| /****************************************************************************** |
| * REGISTERS |
| *****************************************************************************/ |
| /* register size */ |
| #define REG_BITS (32) |
| |
| /* HCCPARAMS */ |
| #define HCCPARAMS_LEN BIT(17) |
| |
| /* DCCPARAMS */ |
| #define DCCPARAMS_DEN (0x1F << 0) |
| #define DCCPARAMS_DC BIT(7) |
| |
| /* TESTMODE */ |
| #define TESTMODE_FORCE BIT(0) |
| |
| /* USBCMD */ |
| #define USBCMD_RS BIT(0) |
| #define USBCMD_RST BIT(1) |
| #define USBCMD_SUTW BIT(13) |
| #define USBCMD_ATDTW BIT(14) |
| |
| /* USBSTS & USBINTR */ |
| #define USBi_UI BIT(0) |
| #define USBi_UEI BIT(1) |
| #define USBi_PCI BIT(2) |
| #define USBi_URI BIT(6) |
| #define USBi_SLI BIT(8) |
| |
| /* DEVICEADDR */ |
| #define DEVICEADDR_USBADRA BIT(24) |
| #define DEVICEADDR_USBADR (0x7FUL << 25) |
| |
| /* PORTSC */ |
| #define PORTSC_FPR BIT(6) |
| #define PORTSC_SUSP BIT(7) |
| #define PORTSC_HSP BIT(9) |
| #define PORTSC_PTC (0x0FUL << 16) |
| |
| /* DEVLC */ |
| #define DEVLC_PSPD (0x03UL << 25) |
| #define DEVLC_PSPD_HS (0x02UL << 25) |
| |
| /* USBMODE */ |
| #define USBMODE_CM (0x03UL << 0) |
| #define USBMODE_CM_IDLE (0x00UL << 0) |
| #define USBMODE_CM_DEVICE (0x02UL << 0) |
| #define USBMODE_CM_HOST (0x03UL << 0) |
| #define USBMODE_SLOM BIT(3) |
| #define USBMODE_SDIS BIT(4) |
| #define USBCMD_ITC(n) (n << 16) /* n = 0, 1, 2, 4, 8, 16, 32, 64 */ |
| #define USBCMD_ITC_MASK (0xFF << 16) |
| |
| /* ENDPTCTRL */ |
| #define ENDPTCTRL_RXS BIT(0) |
| #define ENDPTCTRL_RXT (0x03UL << 2) |
| #define ENDPTCTRL_RXR BIT(6) /* reserved for port 0 */ |
| #define ENDPTCTRL_RXE BIT(7) |
| #define ENDPTCTRL_TXS BIT(16) |
| #define ENDPTCTRL_TXT (0x03UL << 18) |
| #define ENDPTCTRL_TXR BIT(22) /* reserved for port 0 */ |
| #define ENDPTCTRL_TXE BIT(23) |
| |
| /****************************************************************************** |
| * LOGGING |
| *****************************************************************************/ |
| #define ci13xxx_printk(level, format, args...) \ |
| do { \ |
| if (_udc == NULL) \ |
| printk(level "[%s] " format "\n", __func__, ## args); \ |
| else \ |
| dev_printk(level, _udc->gadget.dev.parent, \ |
| "[%s] " format "\n", __func__, ## args); \ |
| } while (0) |
| |
| #ifndef err |
| #define err(format, args...) ci13xxx_printk(KERN_ERR, format, ## args) |
| #endif |
| |
| #define warn(format, args...) ci13xxx_printk(KERN_WARNING, format, ## args) |
| #define info(format, args...) ci13xxx_printk(KERN_INFO, format, ## args) |
| |
| #ifdef TRACE |
| #define trace(format, args...) ci13xxx_printk(KERN_DEBUG, format, ## args) |
| #define dbg_trace(format, args...) dev_dbg(dev, format, ##args) |
| #else |
| #define trace(format, args...) do {} while (0) |
| #define dbg_trace(format, args...) do {} while (0) |
| #endif |
| |
| #endif /* _CI13XXX_h_ */ |