hc
2023-11-20 3c9370f7b6bffd697c9907a7139e9df5b0d4b9df
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
/******************************************************************
 * Copyright 2008 Mentor Graphics Corporation
 * Copyright (C) 2008 by Texas Instruments
 *
 * This file is part of the Inventra Controller Driver for Linux.
 *
 * SPDX-License-Identifier:    GPL-2.0
 ******************************************************************/
 
#ifndef __MUSB_HDRC_DEFS_H__
#define __MUSB_HDRC_DEFS_H__
 
#include <usb_defs.h>
#include <asm/io.h>
 
#define MUSB_EP0_FIFOSIZE    64    /* This is non-configurable */
 
/* EP0 */
struct musb_ep0_regs {
   u16    reserved4;
   u16    csr0;
   u16    reserved5;
   u16    reserved6;
   u16    count0;
   u8    host_type0;
   u8    host_naklimit0;
   u8    reserved7;
   u8    reserved8;
   u8    reserved9;
   u8    configdata;
};
 
/* EP 1-15 */
struct musb_epN_regs {
   u16    txmaxp;
   u16    txcsr;
   u16    rxmaxp;
   u16    rxcsr;
   u16    rxcount;
   u8    txtype;
   u8    txinterval;
   u8    rxtype;
   u8    rxinterval;
   u8    reserved0;
   u8    fifosize;
};
 
/* Mentor USB core register overlay structure */
#ifndef musb_regs
struct musb_regs {
   /* common registers */
   u8    faddr;
   u8    power;
   u16    intrtx;
   u16    intrrx;
   u16    intrtxe;
   u16    intrrxe;
   u8    intrusb;
   u8    intrusbe;
   u16    frame;
   u8    index;
   u8    testmode;
   /* indexed registers */
   u16    txmaxp;
   u16    txcsr;
   u16    rxmaxp;
   u16    rxcsr;
   u16    rxcount;
   u8    txtype;
   u8    txinterval;
   u8    rxtype;
   u8    rxinterval;
   u8    reserved0;
   u8    fifosize;
   /* fifo */
   u32    fifox[16];
   /* OTG, dynamic FIFO, version & vendor registers */
   u8    devctl;
   u8    reserved1;
   u8    txfifosz;
   u8    rxfifosz;
   u16    txfifoadd;
   u16    rxfifoadd;
   u32    vcontrol;
   u16    hwvers;
   u16    reserved2a[1];
   u8    ulpi_busctl;
   u8    reserved2b[1];
   u16    reserved2[3];
   u8    epinfo;
   u8    raminfo;
   u8    linkinfo;
   u8    vplen;
   u8    hseof1;
   u8    fseof1;
   u8    lseof1;
   u8    reserved3;
   /* target address registers */
   struct musb_tar_regs {
       u8    txfuncaddr;
       u8    reserved0;
       u8    txhubaddr;
       u8    txhubport;
       u8    rxfuncaddr;
       u8    reserved1;
       u8    rxhubaddr;
       u8    rxhubport;
   } tar[16];
   /*
    * endpoint registers
    * ep0 elements are valid when array index is 0
    * otherwise epN is valid
    */
   union musb_ep_regs {
       struct musb_ep0_regs ep0;
       struct musb_epN_regs epN;
   } ep[16];
 
} __attribute__((packed));
#endif
 
/*
 * MUSB Register bits
 */
 
/* POWER */
#define MUSB_POWER_ISOUPDATE    0x80
#define MUSB_POWER_SOFTCONN    0x40
#define MUSB_POWER_HSENAB    0x20
#define MUSB_POWER_HSMODE    0x10
#define MUSB_POWER_RESET    0x08
#define MUSB_POWER_RESUME    0x04
#define MUSB_POWER_SUSPENDM    0x02
#define MUSB_POWER_ENSUSPEND    0x01
#define MUSB_POWER_HSMODE_SHIFT    4
 
/* INTRUSB */
#define MUSB_INTR_SUSPEND    0x01
#define MUSB_INTR_RESUME    0x02
#define MUSB_INTR_RESET        0x04
#define MUSB_INTR_BABBLE    0x04
#define MUSB_INTR_SOF        0x08
#define MUSB_INTR_CONNECT    0x10
#define MUSB_INTR_DISCONNECT    0x20
#define MUSB_INTR_SESSREQ    0x40
#define MUSB_INTR_VBUSERROR    0x80    /* For SESSION end */
 
/* DEVCTL */
#define MUSB_DEVCTL_BDEVICE    0x80
#define MUSB_DEVCTL_FSDEV    0x40
#define MUSB_DEVCTL_LSDEV    0x20
#define MUSB_DEVCTL_VBUS    0x18
#define MUSB_DEVCTL_VBUS_SHIFT    3
#define MUSB_DEVCTL_HM        0x04
#define MUSB_DEVCTL_HR        0x02
#define MUSB_DEVCTL_SESSION    0x01
 
/* ULPI VBUSCONTROL */
#define ULPI_USE_EXTVBUS    0x01
#define ULPI_USE_EXTVBUSIND    0x02
 
/* TESTMODE */
#define MUSB_TEST_FORCE_HOST    0x80
#define MUSB_TEST_FIFO_ACCESS    0x40
#define MUSB_TEST_FORCE_FS    0x20
#define MUSB_TEST_FORCE_HS    0x10
#define MUSB_TEST_PACKET    0x08
#define MUSB_TEST_K        0x04
#define MUSB_TEST_J        0x02
#define MUSB_TEST_SE0_NAK    0x01
 
/* Allocate for double-packet buffering (effectively doubles assigned _SIZE) */
#define MUSB_FIFOSZ_DPB        0x10
/* Allocation size (8, 16, 32, ... 4096) */
#define MUSB_FIFOSZ_SIZE    0x0f
 
/* CSR0 */
#define MUSB_CSR0_FLUSHFIFO    0x0100
#define MUSB_CSR0_TXPKTRDY    0x0002
#define MUSB_CSR0_RXPKTRDY    0x0001
 
/* CSR0 in Peripheral mode */
#define MUSB_CSR0_P_SVDSETUPEND    0x0080
#define MUSB_CSR0_P_SVDRXPKTRDY    0x0040
#define MUSB_CSR0_P_SENDSTALL    0x0020
#define MUSB_CSR0_P_SETUPEND    0x0010
#define MUSB_CSR0_P_DATAEND    0x0008
#define MUSB_CSR0_P_SENTSTALL    0x0004
 
/* CSR0 in Host mode */
#define MUSB_CSR0_H_DIS_PING        0x0800
#define MUSB_CSR0_H_WR_DATATOGGLE    0x0400    /* Set to allow setting: */
#define MUSB_CSR0_H_DATATOGGLE        0x0200    /* Data toggle control */
#define MUSB_CSR0_H_NAKTIMEOUT        0x0080
#define MUSB_CSR0_H_STATUSPKT        0x0040
#define MUSB_CSR0_H_REQPKT        0x0020
#define MUSB_CSR0_H_ERROR        0x0010
#define MUSB_CSR0_H_SETUPPKT        0x0008
#define MUSB_CSR0_H_RXSTALL        0x0004
 
/* CSR0 bits to avoid zeroing (write zero clears, write 1 ignored) */
#define MUSB_CSR0_P_WZC_BITS    \
   (MUSB_CSR0_P_SENTSTALL)
#define MUSB_CSR0_H_WZC_BITS    \
   (MUSB_CSR0_H_NAKTIMEOUT | MUSB_CSR0_H_RXSTALL \
   | MUSB_CSR0_RXPKTRDY)
 
/* TxType/RxType */
#define MUSB_TYPE_SPEED        0xc0
#define MUSB_TYPE_SPEED_SHIFT    6
#define MUSB_TYPE_SPEED_HIGH     1
#define MUSB_TYPE_SPEED_FULL     2
#define MUSB_TYPE_SPEED_LOW    3
#define MUSB_TYPE_PROTO        0x30    /* Implicitly zero for ep0 */
#define MUSB_TYPE_PROTO_SHIFT    4
#define MUSB_TYPE_REMOTE_END    0xf    /* Implicitly zero for ep0 */
#define MUSB_TYPE_PROTO_BULK     2
#define MUSB_TYPE_PROTO_INTR     3
 
/* CONFIGDATA */
#define MUSB_CONFIGDATA_MPRXE        0x80    /* Auto bulk pkt combining */
#define MUSB_CONFIGDATA_MPTXE        0x40    /* Auto bulk pkt splitting */
#define MUSB_CONFIGDATA_BIGENDIAN    0x20
#define MUSB_CONFIGDATA_HBRXE        0x10    /* HB-ISO for RX */
#define MUSB_CONFIGDATA_HBTXE        0x08    /* HB-ISO for TX */
#define MUSB_CONFIGDATA_DYNFIFO        0x04    /* Dynamic FIFO sizing */
#define MUSB_CONFIGDATA_SOFTCONE    0x02    /* SoftConnect */
#define MUSB_CONFIGDATA_UTMIDW        0x01    /* Data width 0/1 => 8/16bits */
 
/* TXCSR in Peripheral and Host mode */
#define MUSB_TXCSR_AUTOSET        0x8000
#define MUSB_TXCSR_MODE            0x2000
#define MUSB_TXCSR_DMAENAB        0x1000
#define MUSB_TXCSR_FRCDATATOG        0x0800
#define MUSB_TXCSR_DMAMODE        0x0400
#define MUSB_TXCSR_CLRDATATOG        0x0040
#define MUSB_TXCSR_FLUSHFIFO        0x0008
#define MUSB_TXCSR_FIFONOTEMPTY        0x0002
#define MUSB_TXCSR_TXPKTRDY        0x0001
 
/* TXCSR in Peripheral mode */
#define MUSB_TXCSR_P_ISO        0x4000
#define MUSB_TXCSR_P_INCOMPTX        0x0080
#define MUSB_TXCSR_P_SENTSTALL        0x0020
#define MUSB_TXCSR_P_SENDSTALL        0x0010
#define MUSB_TXCSR_P_UNDERRUN        0x0004
 
/* TXCSR in Host mode */
#define MUSB_TXCSR_H_WR_DATATOGGLE    0x0200
#define MUSB_TXCSR_H_DATATOGGLE        0x0100
#define MUSB_TXCSR_H_NAKTIMEOUT        0x0080
#define MUSB_TXCSR_H_RXSTALL        0x0020
#define MUSB_TXCSR_H_ERROR        0x0004
#define MUSB_TXCSR_H_DATATOGGLE_SHIFT    8
 
/* TXCSR bits to avoid zeroing (write zero clears, write 1 ignored) */
#define MUSB_TXCSR_P_WZC_BITS    \
   (MUSB_TXCSR_P_INCOMPTX | MUSB_TXCSR_P_SENTSTALL \
   | MUSB_TXCSR_P_UNDERRUN | MUSB_TXCSR_FIFONOTEMPTY)
#define MUSB_TXCSR_H_WZC_BITS    \
   (MUSB_TXCSR_H_NAKTIMEOUT | MUSB_TXCSR_H_RXSTALL \
   | MUSB_TXCSR_H_ERROR | MUSB_TXCSR_FIFONOTEMPTY)
 
/* RXCSR in Peripheral and Host mode */
#define MUSB_RXCSR_AUTOCLEAR        0x8000
#define MUSB_RXCSR_DMAENAB        0x2000
#define MUSB_RXCSR_DISNYET        0x1000
#define MUSB_RXCSR_PID_ERR        0x1000
#define MUSB_RXCSR_DMAMODE        0x0800
#define MUSB_RXCSR_INCOMPRX        0x0100
#define MUSB_RXCSR_CLRDATATOG        0x0080
#define MUSB_RXCSR_FLUSHFIFO        0x0010
#define MUSB_RXCSR_DATAERROR        0x0008
#define MUSB_RXCSR_FIFOFULL        0x0002
#define MUSB_RXCSR_RXPKTRDY        0x0001
 
/* RXCSR in Peripheral mode */
#define MUSB_RXCSR_P_ISO        0x4000
#define MUSB_RXCSR_P_SENTSTALL        0x0040
#define MUSB_RXCSR_P_SENDSTALL        0x0020
#define MUSB_RXCSR_P_OVERRUN        0x0004
 
/* RXCSR in Host mode */
#define MUSB_RXCSR_H_AUTOREQ        0x4000
#define MUSB_RXCSR_H_WR_DATATOGGLE    0x0400
#define MUSB_RXCSR_H_DATATOGGLE        0x0200
#define MUSB_RXCSR_H_RXSTALL        0x0040
#define MUSB_RXCSR_H_REQPKT        0x0020
#define MUSB_RXCSR_H_ERROR        0x0004
#define MUSB_S_RXCSR_H_DATATOGGLE    9
 
/* RXCSR bits to avoid zeroing (write zero clears, write 1 ignored) */
#define MUSB_RXCSR_P_WZC_BITS    \
   (MUSB_RXCSR_P_SENTSTALL | MUSB_RXCSR_P_OVERRUN \
   | MUSB_RXCSR_RXPKTRDY)
#define MUSB_RXCSR_H_WZC_BITS    \
   (MUSB_RXCSR_H_RXSTALL | MUSB_RXCSR_H_ERROR \
   | MUSB_RXCSR_DATAERROR | MUSB_RXCSR_RXPKTRDY)
 
/* HUBADDR */
#define MUSB_HUBADDR_MULTI_TT        0x80
 
/* Endpoint configuration information. Note: The value of endpoint fifo size
 * element should be either 8,16,32,64,128,256,512,1024,2048 or 4096. Other
 * values are not supported
 */
struct musb_epinfo {
   u8    epnum;    /* endpoint number     */
   u8    epdir;    /* endpoint direction    */
   u16    epsize;    /* endpoint FIFO size    */
};
 
/*
 * Platform specific MUSB configuration. Any platform using the musb
 * functionality should create one instance of this structure in the
 * platform specific file.
 */
struct musb_config {
   struct    musb_regs    *regs;
   u32            timeout;
   u8            musb_speed;
   u8            extvbus;
};
 
/* externally defined data */
extern struct musb_config    musb_cfg;
extern struct musb_regs        *musbr;
 
/* exported functions */
extern void musb_start(void);
extern void musb_configure_ep(const struct musb_epinfo *epinfo, u8 cnt);
extern void write_fifo(u8 ep, u32 length, void *fifo_data);
extern void read_fifo(u8 ep, u32 length, void *fifo_data);
 
static inline u8 musb_read_ulpi_buscontrol(struct musb_regs *musbr)
{
   return readb(&musbr->ulpi_busctl);
}
static inline void musb_write_ulpi_buscontrol(struct musb_regs *musbr, u8 val)
{
   writeb(val, &musbr->ulpi_busctl);
}
 
#endif    /* __MUSB_HDRC_DEFS_H__ */