Merge branch 'fix/usb-audio' into for-linus
[linux-2.6] / drivers / usb / host / sl811.h
1 /*
2  * SL811HS register declarations and HCD data structures
3  *
4  * Copyright (C) 2004 Psion Teklogix
5  * Copyright (C) 2004 David Brownell
6  * Copyright (C) 2001 Cypress Semiconductor Inc. 
7  */
8
9 /*
10  * SL811HS has transfer registers, and control registers.  In host/master
11  * mode one set of registers is used; in peripheral/slave mode, another.
12  *  - SL11H only has some "A" transfer registers from 0x00-0x04
13  *  - SL811HS also has "B" registers from 0x08-0x0c
14  *  - SL811S (or HS in slave mode) has four A+B sets, at 00, 10, 20, 30
15  */
16
17 #define SL811_EP_A(base)        ((base) + 0)
18 #define SL811_EP_B(base)        ((base) + 8)
19
20 #define SL811_HOST_BUF          0x00
21 #define SL811_PERIPH_EP0        0x00
22 #define SL811_PERIPH_EP1        0x10
23 #define SL811_PERIPH_EP2        0x20
24 #define SL811_PERIPH_EP3        0x30
25
26
27 /* TRANSFER REGISTERS:  host and peripheral sides are similar
28  * except for the control models (master vs slave).
29  */
30 #define SL11H_HOSTCTLREG        0
31 #       define SL11H_HCTLMASK_ARM       0x01
32 #       define SL11H_HCTLMASK_ENABLE    0x02
33 #       define SL11H_HCTLMASK_IN        0x00
34 #       define SL11H_HCTLMASK_OUT       0x04
35 #       define SL11H_HCTLMASK_ISOCH     0x10
36 #       define SL11H_HCTLMASK_AFTERSOF  0x20
37 #       define SL11H_HCTLMASK_TOGGLE    0x40
38 #       define SL11H_HCTLMASK_PREAMBLE  0x80
39 #define SL11H_BUFADDRREG        1
40 #define SL11H_BUFLNTHREG        2
41 #define SL11H_PKTSTATREG        3       /* read */
42 #       define SL11H_STATMASK_ACK       0x01
43 #       define SL11H_STATMASK_ERROR     0x02
44 #       define SL11H_STATMASK_TMOUT     0x04
45 #       define SL11H_STATMASK_SEQ       0x08
46 #       define SL11H_STATMASK_SETUP     0x10
47 #       define SL11H_STATMASK_OVF       0x20
48 #       define SL11H_STATMASK_NAK       0x40
49 #       define SL11H_STATMASK_STALL     0x80
50 #define SL11H_PIDEPREG          3       /* write */
51 #       define  SL_SETUP        0xd0
52 #       define  SL_IN           0x90
53 #       define  SL_OUT          0x10
54 #       define  SL_SOF          0x50
55 #       define  SL_PREAMBLE     0xc0
56 #       define  SL_NAK          0xa0
57 #       define  SL_STALL        0xe0
58 #       define  SL_DATA0        0x30
59 #       define  SL_DATA1        0xb0
60 #define SL11H_XFERCNTREG        4       /* read */
61 #define SL11H_DEVADDRREG        4       /* write */
62
63
64 /* CONTROL REGISTERS:  host and peripheral are very different.
65  */
66 #define SL11H_CTLREG1           5
67 #       define SL11H_CTL1MASK_SOF_ENA   0x01
68 #       define SL11H_CTL1MASK_FORCE     0x18
69 #               define SL11H_CTL1MASK_NORMAL    0x00
70 #               define SL11H_CTL1MASK_SE0       0x08    /* reset */
71 #               define SL11H_CTL1MASK_J         0x10
72 #               define SL11H_CTL1MASK_K         0x18    /* resume */
73 #       define SL11H_CTL1MASK_LSPD      0x20
74 #       define SL11H_CTL1MASK_SUSPEND   0x40
75 #define SL11H_IRQ_ENABLE        6
76 #       define SL11H_INTMASK_DONE_A     0x01
77 #       define SL11H_INTMASK_DONE_B     0x02
78 #       define SL11H_INTMASK_SOFINTR    0x10
79 #       define SL11H_INTMASK_INSRMV     0x20    /* to/from SE0 */
80 #       define SL11H_INTMASK_RD         0x40
81 #       define SL11H_INTMASK_DP         0x80    /* only in INTSTATREG */
82 #define SL11S_ADDRESS           7
83
84 /* 0x08-0x0c are for the B buffer (not in SL11) */
85
86 #define SL11H_IRQ_STATUS        0x0D    /* write to ack */
87 #define SL11H_HWREVREG          0x0E    /* read */
88 #       define SL11H_HWRMASK_HWREV      0xF0
89 #define SL11H_SOFLOWREG         0x0E    /* write */
90 #define SL11H_SOFTMRREG         0x0F    /* read */
91
92 /* a write to this register enables SL811HS features.
93  * HOST flag presumably overrides the chip input signal?
94  */
95 #define SL811HS_CTLREG2         0x0F
96 #       define SL811HS_CTL2MASK_SOF_MASK        0x3F
97 #       define SL811HS_CTL2MASK_DSWAP           0x40
98 #       define SL811HS_CTL2MASK_HOST            0x80
99
100 #define SL811HS_CTL2_INIT       (SL811HS_CTL2MASK_HOST | 0x2e)
101
102
103 /* DATA BUFFERS: registers from 0x10..0xff are for data buffers;
104  * that's 240 bytes, which we'll split evenly between A and B sides.
105  * Only ISO can use more than 64 bytes per packet.
106  * (The SL11S has 0x40..0xff for buffers.)
107  */
108 #define H_MAXPACKET     120             /* bytes in A or B fifos */
109
110 #define SL11H_DATA_START        0x10
111 #define SL811HS_PACKET_BUF(is_a)        ((is_a) \
112                 ? SL11H_DATA_START \
113                 : (SL11H_DATA_START + H_MAXPACKET))
114
115 /*-------------------------------------------------------------------------*/
116
117 #define LOG2_PERIODIC_SIZE      5       /* arbitrary; this matches OHCI */
118 #define PERIODIC_SIZE           (1 << LOG2_PERIODIC_SIZE)
119
120 struct sl811 {
121         spinlock_t              lock;
122         void __iomem            *addr_reg;
123         void __iomem            *data_reg;
124         struct sl811_platform_data      *board;
125         struct proc_dir_entry   *pde;
126
127         unsigned long           stat_insrmv;
128         unsigned long           stat_wake;
129         unsigned long           stat_sof;
130         unsigned long           stat_a;
131         unsigned long           stat_b;
132         unsigned long           stat_lost;
133         unsigned long           stat_overrun;
134
135         /* sw model */
136         struct timer_list       timer;
137         struct sl811h_ep        *next_periodic;
138         struct sl811h_ep        *next_async;
139
140         struct sl811h_ep        *active_a;
141         unsigned long           jiffies_a;
142         struct sl811h_ep        *active_b;
143         unsigned long           jiffies_b;
144
145         u32                     port1;
146         u8                      ctrl1, ctrl2, irq_enable;
147         u16                     frame;
148
149         /* async schedule: control, bulk */
150         struct list_head        async;
151
152         /* periodic schedule: interrupt, iso */
153         u16                     load[PERIODIC_SIZE];
154         struct sl811h_ep        *periodic[PERIODIC_SIZE];
155         unsigned                periodic_count;
156 };
157
158 static inline struct sl811 *hcd_to_sl811(struct usb_hcd *hcd)
159 {
160         return (struct sl811 *) (hcd->hcd_priv);
161 }
162
163 static inline struct usb_hcd *sl811_to_hcd(struct sl811 *sl811)
164 {
165         return container_of((void *) sl811, struct usb_hcd, hcd_priv);
166 }
167
168 struct sl811h_ep {
169         struct usb_host_endpoint *hep;
170         struct usb_device       *udev;
171
172         u8                      defctrl;
173         u8                      maxpacket;
174         u8                      epnum;
175         u8                      nextpid;
176
177         u16                     error_count;
178         u16                     nak_count;
179         u16                     length;         /* of current packet */
180
181         /* periodic schedule */
182         u16                     period;
183         u16                     branch;
184         u16                     load;
185         struct sl811h_ep        *next;
186
187         /* async schedule */
188         struct list_head        schedule;
189 };
190
191 /*-------------------------------------------------------------------------*/
192
193 /* These register utilities should work for the SL811S register API too
194  * NOTE:  caller must hold sl811->lock.
195  */
196
197 static inline u8 sl811_read(struct sl811 *sl811, int reg)
198 {
199         writeb(reg, sl811->addr_reg);
200         return readb(sl811->data_reg);
201 }
202
203 static inline void sl811_write(struct sl811 *sl811, int reg, u8 val)
204 {
205         writeb(reg, sl811->addr_reg);
206         writeb(val, sl811->data_reg);
207 }
208
209 static inline void
210 sl811_write_buf(struct sl811 *sl811, int addr, const void *buf, size_t count)
211 {
212         const u8        *data;
213         void __iomem    *data_reg;
214
215         if (!count)
216                 return;
217         writeb(addr, sl811->addr_reg);
218
219         data = buf;
220         data_reg = sl811->data_reg;
221         do {
222                 writeb(*data++, data_reg);
223         } while (--count);
224 }
225
226 static inline void
227 sl811_read_buf(struct sl811 *sl811, int addr, void *buf, size_t count)
228 {
229         u8              *data;
230         void __iomem    *data_reg;
231
232         if (!count)
233                 return;
234         writeb(addr, sl811->addr_reg);
235
236         data = buf;
237         data_reg = sl811->data_reg;
238         do {
239                 *data++ = readb(data_reg);
240         } while (--count);
241 }
242
243 /*-------------------------------------------------------------------------*/
244
245 #ifdef DEBUG
246 #define DBG(stuff...)           printk(KERN_DEBUG "sl811: " stuff)
247 #else
248 #define DBG(stuff...)           do{}while(0)
249 #endif
250
251 #ifdef VERBOSE
252 #    define VDBG                DBG
253 #else
254 #    define VDBG(stuff...)      do{}while(0)
255 #endif
256
257 #ifdef PACKET_TRACE
258 #    define PACKET              VDBG
259 #else
260 #    define PACKET(stuff...)    do{}while(0)
261 #endif
262
263 #define ERR(stuff...)           printk(KERN_ERR "sl811: " stuff)
264 #define WARNING(stuff...)       printk(KERN_WARNING "sl811: " stuff)
265 #define INFO(stuff...)          printk(KERN_INFO "sl811: " stuff)
266