1 // SPDX-License-Identifier: GPL-2.0+ 2 /* 3 * c67x00-hcd.h: Cypress C67X00 USB HCD 4 * 5 * Copyright (C) 2006-2008 Barco N.V. 6 * Derived from the Cypress cy7c67200/300 ezusb linux driver and 7 * based on multiple host controller drivers inside the linux kernel. 8 */ 9 10 #ifndef _USB_C67X00_HCD_H 11 #define _USB_C67X00_HCD_H 12 13 #include <linux/kernel.h> 14 #include <linux/spinlock.h> 15 #include <linux/list.h> 16 #include <linux/usb.h> 17 #include <linux/usb/hcd.h> 18 #include "c67x00.h" 19 20 /* 21 * The following parameters depend on the CPU speed, bus speed, ... 22 * These can be tuned for specific use cases, e.g. if isochronous transfers 23 * are very important, bandwidth can be sacrificed to guarantee that the 24 * 1ms deadline will be met. 25 * If bulk transfers are important, the MAX_FRAME_BW can be increased, 26 * but some (or many) isochronous deadlines might not be met. 27 * 28 * The values are specified in bittime. 29 */ 30 31 /* 32 * The current implementation switches between _STD (default) and _ISO (when 33 * isochronous transfers are scheduled), in order to optimize the throughput 34 * in normal circumstances, but also provide good isochronous behaviour. 35 * 36 * Bandwidth is described in bit time so with a 12MHz USB clock and 1ms 37 * frames; there are 12000 bit times per frame. 38 */ 39 40 #define TOTAL_FRAME_BW 12000 41 #define DEFAULT_EOT 2250 42 43 #define MAX_FRAME_BW_STD (TOTAL_FRAME_BW - DEFAULT_EOT) 44 #define MAX_FRAME_BW_ISO 2400 45 46 /* 47 * Periodic transfers may only use 90% of the full frame, but as 48 * we currently don't even use 90% of the full frame, we may 49 * use the full usable time for periodic transfers. 50 */ 51 #define MAX_PERIODIC_BW(full_bw) full_bw 52 53 /* -------------------------------------------------------------------------- */ 54 55 struct c67x00_hcd { 56 spinlock_t lock; 57 struct c67x00_sie *sie; 58 unsigned int low_speed_ports; /* bitmask of low speed ports */ 59 unsigned int urb_count; 60 unsigned int urb_iso_count; 61 62 struct list_head list[4]; /* iso, int, ctrl, bulk */ 63 #if PIPE_BULK != 3 64 #error "Sanity check failed, this code presumes PIPE_... to range from 0 to 3" 65 #endif 66 67 /* USB bandwidth allocated to td_list */ 68 int bandwidth_allocated; 69 /* USB bandwidth allocated for isoc/int transfer */ 70 int periodic_bw_allocated; 71 struct list_head td_list; 72 int max_frame_bw; 73 74 u16 td_base_addr; 75 u16 buf_base_addr; 76 u16 next_td_addr; 77 u16 next_buf_addr; 78 79 struct tasklet_struct tasklet; 80 81 struct completion endpoint_disable; 82 83 u16 current_frame; 84 u16 last_frame; 85 }; 86 87 static inline struct c67x00_hcd *hcd_to_c67x00_hcd(struct usb_hcd *hcd) 88 { 89 return (struct c67x00_hcd *)(hcd->hcd_priv); 90 } 91 92 static inline struct usb_hcd *c67x00_hcd_to_hcd(struct c67x00_hcd *c67x00) 93 { 94 return container_of((void *)c67x00, struct usb_hcd, hcd_priv); 95 } 96 97 /* --------------------------------------------------------------------- 98 * Functions used by c67x00-drv 99 */ 100 101 int c67x00_hcd_probe(struct c67x00_sie *sie); 102 void c67x00_hcd_remove(struct c67x00_sie *sie); 103 104 /* --------------------------------------------------------------------- 105 * Transfer Descriptor scheduling functions 106 */ 107 int c67x00_urb_enqueue(struct usb_hcd *hcd, struct urb *urb, gfp_t mem_flags); 108 int c67x00_urb_dequeue(struct usb_hcd *hcd, struct urb *urb, int status); 109 void c67x00_endpoint_disable(struct usb_hcd *hcd, 110 struct usb_host_endpoint *ep); 111 112 void c67x00_hcd_msg_received(struct c67x00_sie *sie, u16 msg); 113 void c67x00_sched_kick(struct c67x00_hcd *c67x00); 114 int c67x00_sched_start_scheduler(struct c67x00_hcd *c67x00); 115 void c67x00_sched_stop_scheduler(struct c67x00_hcd *c67x00); 116 117 #define c67x00_hcd_dev(x) (c67x00_hcd_to_hcd(x)->self.controller) 118 119 #endif /* _USB_C67X00_HCD_H */ 120