xref: /netbsd/sys/arch/acorn32/podulebus/rapide.c (revision c4a72b64)
1 /*	$NetBSD: rapide.c,v 1.7 2002/10/02 03:31:59 thorpej Exp $	*/
2 
3 /*
4  * Copyright (c) 1997-1998 Mark Brinicombe
5  * Copyright (c) 1997-1998 Causality Limited
6  *
7  * Redistribution and use in source and binary forms, with or without
8  * modification, are permitted provided that the following conditions
9  * are met:
10  * 1. Redistributions of source code must retain the above copyright
11  *    notice, this list of conditions and the following disclaimer.
12  * 2. Redistributions in binary form must reproduce the above copyright
13  *    notice, this list of conditions and the following disclaimer in the
14  *    documentation and/or other materials provided with the distribution.
15  * 3. All advertising materials mentioning features or use of this software
16  *    must display the following acknowledgement:
17  *	This product includes software developed by Mark Brinicombe
18  *	for the NetBSD Project.
19  * 4. The name of the author may not be used to endorse or promote products
20  *    derived from this software without specific prior written permission.
21  *
22  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
23  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
24  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
25  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
26  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
27  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
28  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
29  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
30  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
31  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
32  *
33  * Card driver and probe and attach functions to use generic IDE driver
34  * for the RapIDE podule
35  */
36 
37 /*
38  * Thanks to Chris Honey at Raymond Datalink for providing information on
39  * addressing the RapIDE podule.
40  * RapIDE32 is Copyright (C) 1995,1996 Raymond Datalink. RapIDE32 is
41  * manufactured under license by Yellowstone Educational Solutions.
42  */
43 
44 /*
45  * At present this driver only supports the Issue 2 RapIDE podule.
46  */
47 
48 /*
49  * A small amount of work is required for Issue 1 podule support.
50  * The primary differences are the register addresses.
51  * Things are eased by the fact that we can identify the card by register
52  * the same register on both issues of the podule.
53  * Once we kmnow the issue we must change all our addresses accordingly.
54  * All the control registers are mapped the same between cards.
55  * The interrupt handler needs to take note that the issue 1 card needs
56  * the interrupt to be cleared via the interrupt clear register.
57  * This means we share addresses for the mapping of the control block and
58  * thus the card driver does not need to know about the differences.
59  * The differences show up a the controller level.
60  * A structure is used to hold the information about the addressing etc.
61  * An array of these structures holds the information for the primary and
62  * secondary connectors. This needs to be extended to hold this information
63  * for both issues. Then the indexing of this structures will utilise the
64  * card version number.
65  *
66  * Opps just noticed a mistake. The interrupt request register is different
67  * between cards so the card level attach routine will need to consider this.
68  */
69 
70 #include <sys/param.h>
71 #include <sys/systm.h>
72 #include <sys/conf.h>
73 #include <sys/device.h>
74 #include <sys/malloc.h>
75 
76 #include <machine/intr.h>
77 #include <machine/io.h>
78 #include <machine/bus.h>
79 #include <machine/bootconfig.h>
80 #include <arm/iomd/iomdreg.h>
81 #include <arm/iomd/iomdvar.h>
82 #include <acorn32/podulebus/podulebus.h>
83 #include <acorn32/podulebus/rapidereg.h>
84 
85 #include <dev/ata/atavar.h>
86 #include <dev/ic/wdcvar.h>
87 #include <dev/podulebus/podules.h>
88 
89 
90 /*
91  * RapIDE podule device.
92  *
93  * This probes and attaches the top level RapIDE device to the podulebus.
94  * It then configures any children of the RapIDE device.
95  * The attach args specify whether it is configuring the primary or
96  * secondary channel.
97  * The children are expected to be wdc devices using rapide attachments.
98  */
99 
100 /*
101  * RapIDE card softc structure.
102  *
103  * Contains the device node, podule information and global information
104  * required by the driver such as the card version and the interrupt mask.
105  */
106 
107 struct rapide_softc {
108 	struct wdc_softc	sc_wdcdev;	/* common wdc definitions */
109 	struct channel_softc	*wdc_chanarray[2]; /* channels definition */
110 	podule_t 		*sc_podule;		/* Our podule info */
111 	int 			sc_podule_number;	/* Our podule number */
112 	int			sc_intr_enable_mask;	/* Global intr mask */
113 	int			sc_version;		/* Card version */
114 	bus_space_tag_t		sc_ctliot;		/* Bus tag */
115 	bus_space_handle_t	sc_ctlioh;		/* control handler */
116 	struct rapide_channel {
117 		struct channel_softc wdc_channel; /* generic part */
118 		irqhandler_t	rc_ih;			/* interrupt handler */
119 		int		rc_irqmask;	/* IRQ mask for this channel */
120 	} rapide_channels[2];
121 };
122 
123 int	rapide_probe	__P((struct device *, struct cfdata *, void *));
124 void	rapide_attach	__P((struct device *, struct device *, void *));
125 void	rapide_shutdown	__P((void *arg));
126 int	rapide_intr	__P((void *));
127 
128 CFATTACH_DECL(rapide, sizeof(struct rapide_softc),
129     rapide_probe, rapide_attach, NULL, NULL);
130 
131 /*
132  * We have a private bus space tag.
133  * This is created by copying the podulebus tag and then replacing
134  * a couple of the transfer functions.
135  */
136 
137 static struct bus_space rapide_bs_tag;
138 
139 bs_rm_4_proto(rapide);
140 bs_wm_4_proto(rapide);
141 
142 /*
143  * Create an array of address structures. These define the addresses and
144  * masks needed for the different channels for the card.
145  *
146  * XXX - Needs some work for issue 1 cards.
147  */
148 
149 struct {
150 	u_int registers;
151 	u_int aux_register;
152 	u_int data_register;
153 	u_int irq_mask;
154 } rapide_info[] = {
155 	{ PRIMARY_DRIVE_REGISTERS_OFFSET, PRIMARY_AUX_REGISTER_OFFSET,
156 	     PRIMARY_DATA_REGISTER_OFFSET, PRIMARY_IRQ_MASK },
157 	{ SECONDARY_DRIVE_REGISTERS_OFFSET, SECONDARY_AUX_REGISTER_OFFSET,
158 	    SECONDARY_DATA_REGISTER_OFFSET, SECONDARY_IRQ_MASK }
159 };
160 
161 
162 /*
163  * Card probe function
164  *
165  * Just match the manufacturer and podule ID's
166  */
167 
168 int
169 rapide_probe(parent, cf, aux)
170 	struct device *parent;
171 	struct cfdata *cf;
172 	void *aux;
173 {
174 	struct podule_attach_args *pa = (void *)aux;
175 
176 	return (pa->pa_product == PODULE_RAPIDE);
177 }
178 
179 /*
180  * Card attach function
181  *
182  * Identify the card version and configure any children.
183  * Install a shutdown handler to kill interrupts on shutdown
184  */
185 
186 void
187 rapide_attach(parent, self, aux)
188 	struct device *parent, *self;
189 	void *aux;
190 {
191 	struct rapide_softc *sc = (void *)self;
192 	struct podule_attach_args *pa = (void *)aux;
193 	bus_space_tag_t iot;
194 	bus_space_handle_t ctlioh;
195 	u_int iobase;
196 	int channel;
197 	struct rapide_channel *rcp;
198 	struct channel_softc *cp;
199 	irqhandler_t *ihp;
200 
201 	/* Note the podule number and validate */
202 	if (pa->pa_podule_number == -1)
203 		panic("Podule has disappeared !");
204 
205 	sc->sc_podule_number = pa->pa_podule_number;
206 	sc->sc_podule = pa->pa_podule;
207 	podules[sc->sc_podule_number].attached = 1;
208 
209 	set_easi_cycle_type(sc->sc_podule_number, EASI_CYCLE_TYPE_C);
210 
211 	/*
212 	 * Duplicate the podule bus space tag and provide alternative
213 	 * bus_space_read_multi_4() and bus_space_write_multi_4()
214 	 * functions.
215 	 */
216 	rapide_bs_tag = *pa->pa_iot;
217 	rapide_bs_tag.bs_rm_4 = rapide_bs_rm_4;
218 	rapide_bs_tag.bs_wm_4 = rapide_bs_wm_4;
219 	sc->sc_ctliot = iot = &rapide_bs_tag;
220 
221 	if (bus_space_map(iot, pa->pa_podule->easi_base +
222 	    CONTROL_REGISTERS_OFFSET, CONTROL_REGISTER_SPACE, 0, &ctlioh))
223 		panic("%s: Cannot map control registers", self->dv_xname);
224 
225 	sc->sc_ctlioh = ctlioh;
226 	sc->sc_version = bus_space_read_1(iot, ctlioh, VERSION_REGISTER_OFFSET) & VERSION_REGISTER_MASK;
227 /*	bus_space_unmap(iot, ctl_ioh, CONTROL_REGISTER_SPACE);*/
228 
229 	printf(": Issue %d\n", sc->sc_version + 1);
230 	if (sc->sc_version != VERSION_2_ID)
231 		return;
232 
233 	if (shutdownhook_establish(rapide_shutdown, (void *)sc) == NULL)
234 		panic("%s: Cannot install shutdown handler", self->dv_xname);
235 
236 	/* Set the interrupt info for this podule */
237 	sc->sc_podule->irq_addr = pa->pa_podule->easi_base
238 	    + CONTROL_REGISTERS_OFFSET + IRQ_REQUEST_REGISTER_BYTE_OFFSET;
239 	sc->sc_podule->irq_mask = IRQ_MASK;
240 
241 	iobase = pa->pa_podule->easi_base;
242 
243 	/* Fill in wdc and channel infos */
244 	sc->sc_wdcdev.cap |= WDC_CAPABILITY_DATA32;
245 	sc->sc_wdcdev.PIO_cap = 0;
246 	sc->sc_wdcdev.channels = sc->wdc_chanarray;
247 	sc->sc_wdcdev.nchannels = 2;
248 	for (channel = 0 ; channel < 2; channel++) {
249 		rcp = &sc->rapide_channels[channel];
250 		sc->wdc_chanarray[channel] = &rcp->wdc_channel;
251 		cp = &rcp->wdc_channel;
252 
253 		cp->channel = channel;
254 		cp->wdc = &sc->sc_wdcdev;
255 		cp->ch_queue = malloc(sizeof(struct channel_queue),
256 		    M_DEVBUF, M_NOWAIT);
257 		if (cp->ch_queue == NULL) {
258 			printf("%s %s channel: can't allocate memory for "
259 			    "command queue", self->dv_xname,
260 			    (channel == 0) ? "primary" : "secondary");
261 			continue;
262 		}
263 		cp->cmd_iot = iot;
264 		cp->ctl_iot = iot;
265 		cp->data32iot = iot;
266 
267 		if (bus_space_map(iot, iobase + rapide_info[channel].registers,
268 		    DRIVE_REGISTERS_SPACE, 0, &cp->cmd_ioh))
269 			continue;
270 		if (bus_space_map(iot, iobase +
271 		    rapide_info[channel].aux_register, 4, 0, &cp->ctl_ioh)) {
272 			bus_space_unmap(iot, cp->cmd_ioh,
273 			   DRIVE_REGISTERS_SPACE);
274 			continue;
275 		}
276 		if (bus_space_map(iot, iobase +
277 		    rapide_info[channel].data_register, 4, 0, &cp->data32ioh)) {
278 			bus_space_unmap(iot, cp->cmd_ioh,
279 			   DRIVE_REGISTERS_SPACE);
280 			bus_space_unmap(iot, cp->ctl_ioh, 4);
281 			continue;
282 		}
283 		/* Disable interrupts and clear any pending interrupts */
284 		rcp->rc_irqmask = rapide_info[channel].irq_mask;
285 		sc->sc_intr_enable_mask &= ~rcp->rc_irqmask;
286 		bus_space_write_1(iot, sc->sc_ctlioh, IRQ_MASK_REGISTER_OFFSET,
287 		    sc->sc_intr_enable_mask);
288 		/* XXX - Issue 1 cards will need to clear any pending interrupts */
289 		wdcattach(cp);
290 		ihp = &rcp->rc_ih;
291 		ihp->ih_func = rapide_intr;
292 		ihp->ih_arg = rcp;
293 		ihp->ih_level = IPL_BIO;
294 		ihp->ih_name = "rapide";
295 		ihp->ih_maskaddr = pa->pa_podule->irq_addr;
296 		ihp->ih_maskbits = rcp->rc_irqmask;
297 		if (irq_claim(sc->sc_podule->interrupt, ihp))
298 			panic("%s: Cannot claim interrupt %d",
299 			    self->dv_xname, sc->sc_podule->interrupt);
300 		/* clear any pending interrupts and enable interrupts */
301 		sc->sc_intr_enable_mask |= rcp->rc_irqmask;
302 		bus_space_write_1(iot, sc->sc_ctlioh,
303 		    IRQ_MASK_REGISTER_OFFSET, sc->sc_intr_enable_mask);
304 		/* XXX - Issue 1 cards will need to clear any pending interrupts */
305 	}
306 }
307 
308 /*
309  * Card shutdown function
310  *
311  * Called via do_shutdown_hooks() during kernel shutdown.
312  * Clear the cards's interrupt mask to stop any podule interrupts.
313  */
314 
315 void
316 rapide_shutdown(arg)
317 	void *arg;
318 {
319 	struct rapide_softc *sc = arg;
320 
321 	/* Disable card interrupts */
322 	bus_space_write_1(sc->sc_ctliot, sc->sc_ctlioh,
323 	    IRQ_MASK_REGISTER_OFFSET, 0);
324 }
325 
326 /*
327  * Podule interrupt handler
328  *
329  * If the interrupt was from our card pass it on to the wdc interrupt handler
330  */
331 
332 int
333 rapide_intr(arg)
334 	void *arg;
335 {
336 	struct rapide_channel *rcp = arg;
337 	irqhandler_t *ihp = &rcp->rc_ih;
338 	volatile u_char *intraddr = (volatile u_char *)ihp->ih_maskaddr;
339 
340 	/* XXX - Issue 1 cards will need to clear the interrupt */
341 
342 	/* XXX - not bus space yet - should really be handled by podulebus */
343 	if ((*intraddr) & ihp->ih_maskbits)
344 		wdcintr(&rcp->wdc_channel);
345 
346 	return(0);
347 }
348