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
121struct sl811 {
122 spinlock_t lock;
123 void __iomem *addr_reg;
124 void __iomem *data_reg;
125 struct sl811_platform_data *board;
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
158static inline struct sl811 *hcd_to_sl811(struct usb_hcd *hcd)
159{
160 return (struct sl811 *) (hcd->hcd_priv);
161}
162
163static inline struct usb_hcd *sl811_to_hcd(struct sl811 *sl811)
164{
165 return container_of((void *) sl811, struct usb_hcd, hcd_priv);
166}
167
168struct 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
197static inline u8 sl811_read(struct sl811 *sl811, int reg)
198{
199 writeb(val: reg, addr: sl811->addr_reg);
200 return readb(addr: sl811->data_reg);
201}
202
203static inline void sl811_write(struct sl811 *sl811, int reg, u8 val)
204{
205 writeb(val: reg, addr: sl811->addr_reg);
206 writeb(val, addr: sl811->data_reg);
207}
208
209static inline void
210sl811_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(val: addr, addr: sl811->addr_reg);
218
219 data = buf;
220 data_reg = sl811->data_reg;
221 do {
222 writeb(val: *data++, addr: data_reg);
223 } while (--count);
224}
225
226static inline void
227sl811_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(val: addr, addr: sl811->addr_reg);
235
236 data = buf;
237 data_reg = sl811->data_reg;
238 do {
239 *data++ = readb(addr: data_reg);
240 } while (--count);
241}
242
243/*-------------------------------------------------------------------------*/
244
245#ifdef PACKET_TRACE
246# define PACKET pr_debug("sl811: "stuff)
247#else
248# define PACKET(stuff...) do{}while(0)
249#endif
250

source code of linux/drivers/usb/host/sl811.h