Linux Audio

Check our new training course

Embedded Linux training

Mar 10-20, 2025, special US time zones
Register
Loading...
v3.1
 
  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
120struct 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
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(reg, sl811->addr_reg);
200	return readb(sl811->data_reg);
201}
202
203static 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
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(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
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(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
v6.2
  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(reg, sl811->addr_reg);
200	return readb(sl811->data_reg);
201}
202
203static 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
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(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
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(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 PACKET_TRACE
246#    define PACKET		pr_debug("sl811: "stuff)
247#else
248#    define PACKET(stuff...)	do{}while(0)
249#endif