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