xref: /openbmc/linux/drivers/scsi/arm/cumana_2.c (revision bbaa836b)
1 // SPDX-License-Identifier: GPL-2.0-only
2 /*
3  *  linux/drivers/acorn/scsi/cumana_2.c
4  *
5  *  Copyright (C) 1997-2005 Russell King
6  *
7  *  Changelog:
8  *   30-08-1997	RMK	0.0.0	Created, READONLY version.
9  *   22-01-1998	RMK	0.0.1	Updated to 2.1.80.
10  *   15-04-1998	RMK	0.0.1	Only do PIO if FAS216 will allow it.
11  *   02-05-1998	RMK	0.0.2	Updated & added DMA support.
12  *   27-06-1998	RMK		Changed asm/delay.h to linux/delay.h
13  *   18-08-1998	RMK	0.0.3	Fixed synchronous transfer depth.
14  *   02-04-2000	RMK	0.0.4	Updated for new error handling code.
15  */
16 #include <linux/module.h>
17 #include <linux/blkdev.h>
18 #include <linux/kernel.h>
19 #include <linux/string.h>
20 #include <linux/ioport.h>
21 #include <linux/proc_fs.h>
22 #include <linux/delay.h>
23 #include <linux/interrupt.h>
24 #include <linux/init.h>
25 #include <linux/dma-mapping.h>
26 #include <linux/pgtable.h>
27 
28 #include <asm/dma.h>
29 #include <asm/ecard.h>
30 #include <asm/io.h>
31 
32 #include "../scsi.h"
33 #include <scsi/scsi_host.h>
34 #include "fas216.h"
35 #include "scsi.h"
36 
37 #include <scsi/scsicam.h>
38 
39 #define CUMANASCSI2_STATUS		(0x0000)
40 #define STATUS_INT			(1 << 0)
41 #define STATUS_DRQ			(1 << 1)
42 #define STATUS_LATCHED			(1 << 3)
43 
44 #define CUMANASCSI2_ALATCH		(0x0014)
45 #define ALATCH_ENA_INT			(3)
46 #define ALATCH_DIS_INT			(2)
47 #define ALATCH_ENA_TERM			(5)
48 #define ALATCH_DIS_TERM			(4)
49 #define ALATCH_ENA_BIT32		(11)
50 #define ALATCH_DIS_BIT32		(10)
51 #define ALATCH_ENA_DMA			(13)
52 #define ALATCH_DIS_DMA			(12)
53 #define ALATCH_DMA_OUT			(15)
54 #define ALATCH_DMA_IN			(14)
55 
56 #define CUMANASCSI2_PSEUDODMA		(0x0200)
57 
58 #define CUMANASCSI2_FAS216_OFFSET	(0x0300)
59 #define CUMANASCSI2_FAS216_SHIFT	2
60 
61 /*
62  * Version
63  */
64 #define VERSION "1.00 (13/11/2002 2.5.47)"
65 
66 /*
67  * Use term=0,1,0,0,0 to turn terminators on/off
68  */
69 static int term[MAX_ECARDS] = { 1, 1, 1, 1, 1, 1, 1, 1 };
70 
71 #define NR_SG	256
72 
73 struct cumanascsi2_info {
74 	FAS216_Info		info;
75 	struct expansion_card	*ec;
76 	void __iomem		*base;
77 	unsigned int		terms;		/* Terminator state	*/
78 	struct scatterlist	sg[NR_SG];	/* Scatter DMA list	*/
79 };
80 
81 #define CSTATUS_IRQ	(1 << 0)
82 #define CSTATUS_DRQ	(1 << 1)
83 
84 /* Prototype: void cumanascsi_2_irqenable(ec, irqnr)
85  * Purpose  : Enable interrupts on Cumana SCSI 2 card
86  * Params   : ec    - expansion card structure
87  *          : irqnr - interrupt number
88  */
89 static void
90 cumanascsi_2_irqenable(struct expansion_card *ec, int irqnr)
91 {
92 	struct cumanascsi2_info *info = ec->irq_data;
93 	writeb(ALATCH_ENA_INT, info->base + CUMANASCSI2_ALATCH);
94 }
95 
96 /* Prototype: void cumanascsi_2_irqdisable(ec, irqnr)
97  * Purpose  : Disable interrupts on Cumana SCSI 2 card
98  * Params   : ec    - expansion card structure
99  *          : irqnr - interrupt number
100  */
101 static void
102 cumanascsi_2_irqdisable(struct expansion_card *ec, int irqnr)
103 {
104 	struct cumanascsi2_info *info = ec->irq_data;
105 	writeb(ALATCH_DIS_INT, info->base + CUMANASCSI2_ALATCH);
106 }
107 
108 static const expansioncard_ops_t cumanascsi_2_ops = {
109 	.irqenable	= cumanascsi_2_irqenable,
110 	.irqdisable	= cumanascsi_2_irqdisable,
111 };
112 
113 /* Prototype: void cumanascsi_2_terminator_ctl(host, on_off)
114  * Purpose  : Turn the Cumana SCSI 2 terminators on or off
115  * Params   : host   - card to turn on/off
116  *          : on_off - !0 to turn on, 0 to turn off
117  */
118 static void
119 cumanascsi_2_terminator_ctl(struct Scsi_Host *host, int on_off)
120 {
121 	struct cumanascsi2_info *info = (struct cumanascsi2_info *)host->hostdata;
122 
123 	if (on_off) {
124 		info->terms = 1;
125 		writeb(ALATCH_ENA_TERM, info->base + CUMANASCSI2_ALATCH);
126 	} else {
127 		info->terms = 0;
128 		writeb(ALATCH_DIS_TERM, info->base + CUMANASCSI2_ALATCH);
129 	}
130 }
131 
132 /* Prototype: void cumanascsi_2_intr(irq, *dev_id, *regs)
133  * Purpose  : handle interrupts from Cumana SCSI 2 card
134  * Params   : irq    - interrupt number
135  *	      dev_id - user-defined (Scsi_Host structure)
136  */
137 static irqreturn_t
138 cumanascsi_2_intr(int irq, void *dev_id)
139 {
140 	struct cumanascsi2_info *info = dev_id;
141 
142 	return fas216_intr(&info->info);
143 }
144 
145 /* Prototype: fasdmatype_t cumanascsi_2_dma_setup(host, SCpnt, direction, min_type)
146  * Purpose  : initialises DMA/PIO
147  * Params   : host      - host
148  *	      SCpnt     - command
149  *	      direction - DMA on to/off of card
150  *	      min_type  - minimum DMA support that we must have for this transfer
151  * Returns  : type of transfer to be performed
152  */
153 static fasdmatype_t
154 cumanascsi_2_dma_setup(struct Scsi_Host *host, struct scsi_pointer *SCp,
155 		       fasdmadir_t direction, fasdmatype_t min_type)
156 {
157 	struct cumanascsi2_info *info = (struct cumanascsi2_info *)host->hostdata;
158 	struct device *dev = scsi_get_device(host);
159 	int dmach = info->info.scsi.dma;
160 
161 	writeb(ALATCH_DIS_DMA, info->base + CUMANASCSI2_ALATCH);
162 
163 	if (dmach != NO_DMA &&
164 	    (min_type == fasdma_real_all || SCp->this_residual >= 512)) {
165 		int bufs, map_dir, dma_dir, alatch_dir;
166 
167 		bufs = copy_SCp_to_sg(&info->sg[0], SCp, NR_SG);
168 
169 		if (direction == DMA_OUT) {
170 			map_dir = DMA_TO_DEVICE;
171 			dma_dir = DMA_MODE_WRITE;
172 			alatch_dir = ALATCH_DMA_OUT;
173 		} else {
174 			map_dir = DMA_FROM_DEVICE;
175 			dma_dir = DMA_MODE_READ;
176 			alatch_dir = ALATCH_DMA_IN;
177 		}
178 
179 		dma_map_sg(dev, info->sg, bufs, map_dir);
180 
181 		disable_dma(dmach);
182 		set_dma_sg(dmach, info->sg, bufs);
183 		writeb(alatch_dir, info->base + CUMANASCSI2_ALATCH);
184 		set_dma_mode(dmach, dma_dir);
185 		enable_dma(dmach);
186 		writeb(ALATCH_ENA_DMA, info->base + CUMANASCSI2_ALATCH);
187 		writeb(ALATCH_DIS_BIT32, info->base + CUMANASCSI2_ALATCH);
188 		return fasdma_real_all;
189 	}
190 
191 	/*
192 	 * If we're not doing DMA,
193 	 *  we'll do pseudo DMA
194 	 */
195 	return fasdma_pio;
196 }
197 
198 /*
199  * Prototype: void cumanascsi_2_dma_pseudo(host, SCpnt, direction, transfer)
200  * Purpose  : handles pseudo DMA
201  * Params   : host      - host
202  *	      SCpnt     - command
203  *	      direction - DMA on to/off of card
204  *	      transfer  - minimum number of bytes we expect to transfer
205  */
206 static void
207 cumanascsi_2_dma_pseudo(struct Scsi_Host *host, struct scsi_pointer *SCp,
208 			fasdmadir_t direction, int transfer)
209 {
210 	struct cumanascsi2_info *info = (struct cumanascsi2_info *)host->hostdata;
211 	unsigned int length;
212 	unsigned char *addr;
213 
214 	length = SCp->this_residual;
215 	addr = SCp->ptr;
216 
217 	if (direction == DMA_OUT)
218 #if 0
219 		while (length > 1) {
220 			unsigned long word;
221 			unsigned int status = readb(info->base + CUMANASCSI2_STATUS);
222 
223 			if (status & STATUS_INT)
224 				goto end;
225 
226 			if (!(status & STATUS_DRQ))
227 				continue;
228 
229 			word = *addr | *(addr + 1) << 8;
230 			writew(word, info->base + CUMANASCSI2_PSEUDODMA);
231 			addr += 2;
232 			length -= 2;
233 		}
234 #else
235 		printk ("PSEUDO_OUT???\n");
236 #endif
237 	else {
238 		if (transfer && (transfer & 255)) {
239 			while (length >= 256) {
240 				unsigned int status = readb(info->base + CUMANASCSI2_STATUS);
241 
242 				if (status & STATUS_INT)
243 					return;
244 
245 				if (!(status & STATUS_DRQ))
246 					continue;
247 
248 				readsw(info->base + CUMANASCSI2_PSEUDODMA,
249 				       addr, 256 >> 1);
250 				addr += 256;
251 				length -= 256;
252 			}
253 		}
254 
255 		while (length > 0) {
256 			unsigned long word;
257 			unsigned int status = readb(info->base + CUMANASCSI2_STATUS);
258 
259 			if (status & STATUS_INT)
260 				return;
261 
262 			if (!(status & STATUS_DRQ))
263 				continue;
264 
265 			word = readw(info->base + CUMANASCSI2_PSEUDODMA);
266 			*addr++ = word;
267 			if (--length > 0) {
268 				*addr++ = word >> 8;
269 				length --;
270 			}
271 		}
272 	}
273 }
274 
275 /* Prototype: int cumanascsi_2_dma_stop(host, SCpnt)
276  * Purpose  : stops DMA/PIO
277  * Params   : host  - host
278  *	      SCpnt - command
279  */
280 static void
281 cumanascsi_2_dma_stop(struct Scsi_Host *host, struct scsi_pointer *SCp)
282 {
283 	struct cumanascsi2_info *info = (struct cumanascsi2_info *)host->hostdata;
284 	if (info->info.scsi.dma != NO_DMA) {
285 		writeb(ALATCH_DIS_DMA, info->base + CUMANASCSI2_ALATCH);
286 		disable_dma(info->info.scsi.dma);
287 	}
288 }
289 
290 /* Prototype: const char *cumanascsi_2_info(struct Scsi_Host * host)
291  * Purpose  : returns a descriptive string about this interface,
292  * Params   : host - driver host structure to return info for.
293  * Returns  : pointer to a static buffer containing null terminated string.
294  */
295 const char *cumanascsi_2_info(struct Scsi_Host *host)
296 {
297 	struct cumanascsi2_info *info = (struct cumanascsi2_info *)host->hostdata;
298 	static char string[150];
299 
300 	sprintf(string, "%s (%s) in slot %d v%s terminators o%s",
301 		host->hostt->name, info->info.scsi.type, info->ec->slot_no,
302 		VERSION, info->terms ? "n" : "ff");
303 
304 	return string;
305 }
306 
307 /* Prototype: int cumanascsi_2_set_proc_info(struct Scsi_Host *host, char *buffer, int length)
308  * Purpose  : Set a driver specific function
309  * Params   : host   - host to setup
310  *          : buffer - buffer containing string describing operation
311  *          : length - length of string
312  * Returns  : -EINVAL, or 0
313  */
314 static int
315 cumanascsi_2_set_proc_info(struct Scsi_Host *host, char *buffer, int length)
316 {
317 	int ret = length;
318 
319 	if (length >= 11 && strncmp(buffer, "CUMANASCSI2", 11) == 0) {
320 		buffer += 11;
321 		length -= 11;
322 
323 		if (length >= 5 && strncmp(buffer, "term=", 5) == 0) {
324 			if (buffer[5] == '1')
325 				cumanascsi_2_terminator_ctl(host, 1);
326 			else if (buffer[5] == '0')
327 				cumanascsi_2_terminator_ctl(host, 0);
328 			else
329 				ret = -EINVAL;
330 		} else {
331 			ret = -EINVAL;
332 		}
333 	} else {
334 		ret = -EINVAL;
335 	}
336 
337 	return ret;
338 }
339 
340 static int cumanascsi_2_show_info(struct seq_file *m, struct Scsi_Host *host)
341 {
342 	struct cumanascsi2_info *info;
343 	info = (struct cumanascsi2_info *)host->hostdata;
344 
345 	seq_printf(m, "Cumana SCSI II driver v%s\n", VERSION);
346 	fas216_print_host(&info->info, m);
347 	seq_printf(m, "Term    : o%s\n",
348 			info->terms ? "n" : "ff");
349 
350 	fas216_print_stats(&info->info, m);
351 	fas216_print_devices(&info->info, m);
352 	return 0;
353 }
354 
355 static struct scsi_host_template cumanascsi2_template = {
356 	.module				= THIS_MODULE,
357 	.show_info			= cumanascsi_2_show_info,
358 	.write_info			= cumanascsi_2_set_proc_info,
359 	.name				= "Cumana SCSI II",
360 	.info				= cumanascsi_2_info,
361 	.queuecommand			= fas216_queue_command,
362 	.eh_host_reset_handler		= fas216_eh_host_reset,
363 	.eh_bus_reset_handler		= fas216_eh_bus_reset,
364 	.eh_device_reset_handler	= fas216_eh_device_reset,
365 	.eh_abort_handler		= fas216_eh_abort,
366 	.cmd_size			= sizeof(struct fas216_cmd_priv),
367 	.can_queue			= 1,
368 	.this_id			= 7,
369 	.sg_tablesize			= SG_MAX_SEGMENTS,
370 	.dma_boundary			= IOMD_DMA_BOUNDARY,
371 	.proc_name			= "cumanascsi2",
372 };
373 
374 static int cumanascsi2_probe(struct expansion_card *ec,
375 			     const struct ecard_id *id)
376 {
377 	struct Scsi_Host *host;
378 	struct cumanascsi2_info *info;
379 	void __iomem *base;
380 	int ret;
381 
382 	ret = ecard_request_resources(ec);
383 	if (ret)
384 		goto out;
385 
386 	base = ecardm_iomap(ec, ECARD_RES_MEMC, 0, 0);
387 	if (!base) {
388 		ret = -ENOMEM;
389 		goto out_region;
390 	}
391 
392 	host = scsi_host_alloc(&cumanascsi2_template,
393 			       sizeof(struct cumanascsi2_info));
394 	if (!host) {
395 		ret = -ENOMEM;
396 		goto out_region;
397 	}
398 
399 	ecard_set_drvdata(ec, host);
400 
401 	info = (struct cumanascsi2_info *)host->hostdata;
402 	info->ec	= ec;
403 	info->base	= base;
404 
405 	cumanascsi_2_terminator_ctl(host, term[ec->slot_no]);
406 
407 	info->info.scsi.io_base		= base + CUMANASCSI2_FAS216_OFFSET;
408 	info->info.scsi.io_shift	= CUMANASCSI2_FAS216_SHIFT;
409 	info->info.scsi.irq		= ec->irq;
410 	info->info.scsi.dma		= ec->dma;
411 	info->info.ifcfg.clockrate	= 40; /* MHz */
412 	info->info.ifcfg.select_timeout	= 255;
413 	info->info.ifcfg.asyncperiod	= 200; /* ns */
414 	info->info.ifcfg.sync_max_depth	= 7;
415 	info->info.ifcfg.cntl3		= CNTL3_BS8 | CNTL3_FASTSCSI | CNTL3_FASTCLK;
416 	info->info.ifcfg.disconnect_ok	= 1;
417 	info->info.ifcfg.wide_max_size	= 0;
418 	info->info.ifcfg.capabilities	= FASCAP_PSEUDODMA;
419 	info->info.dma.setup		= cumanascsi_2_dma_setup;
420 	info->info.dma.pseudo		= cumanascsi_2_dma_pseudo;
421 	info->info.dma.stop		= cumanascsi_2_dma_stop;
422 
423 	ec->irqaddr	= info->base + CUMANASCSI2_STATUS;
424 	ec->irqmask	= STATUS_INT;
425 
426 	ecard_setirq(ec, &cumanascsi_2_ops, info);
427 
428 	ret = fas216_init(host);
429 	if (ret)
430 		goto out_free;
431 
432 	ret = request_irq(ec->irq, cumanascsi_2_intr,
433 			  0, "cumanascsi2", info);
434 	if (ret) {
435 		printk("scsi%d: IRQ%d not free: %d\n",
436 		       host->host_no, ec->irq, ret);
437 		goto out_release;
438 	}
439 
440 	if (info->info.scsi.dma != NO_DMA) {
441 		if (request_dma(info->info.scsi.dma, "cumanascsi2")) {
442 			printk("scsi%d: DMA%d not free, using PIO\n",
443 			       host->host_no, info->info.scsi.dma);
444 			info->info.scsi.dma = NO_DMA;
445 		} else {
446 			set_dma_speed(info->info.scsi.dma, 180);
447 			info->info.ifcfg.capabilities |= FASCAP_DMA;
448 		}
449 	}
450 
451 	ret = fas216_add(host, &ec->dev);
452 	if (ret == 0)
453 		goto out;
454 
455 	if (info->info.scsi.dma != NO_DMA)
456 		free_dma(info->info.scsi.dma);
457 	free_irq(ec->irq, info);
458 
459  out_release:
460 	fas216_release(host);
461 
462  out_free:
463 	scsi_host_put(host);
464 
465  out_region:
466 	ecard_release_resources(ec);
467 
468  out:
469 	return ret;
470 }
471 
472 static void cumanascsi2_remove(struct expansion_card *ec)
473 {
474 	struct Scsi_Host *host = ecard_get_drvdata(ec);
475 	struct cumanascsi2_info *info = (struct cumanascsi2_info *)host->hostdata;
476 
477 	ecard_set_drvdata(ec, NULL);
478 	fas216_remove(host);
479 
480 	if (info->info.scsi.dma != NO_DMA)
481 		free_dma(info->info.scsi.dma);
482 	free_irq(ec->irq, info);
483 
484 	fas216_release(host);
485 	scsi_host_put(host);
486 	ecard_release_resources(ec);
487 }
488 
489 static const struct ecard_id cumanascsi2_cids[] = {
490 	{ MANU_CUMANA, PROD_CUMANA_SCSI_2 },
491 	{ 0xffff, 0xffff },
492 };
493 
494 static struct ecard_driver cumanascsi2_driver = {
495 	.probe		= cumanascsi2_probe,
496 	.remove		= cumanascsi2_remove,
497 	.id_table	= cumanascsi2_cids,
498 	.drv = {
499 		.name		= "cumanascsi2",
500 	},
501 };
502 
503 static int __init cumanascsi2_init(void)
504 {
505 	return ecard_register_driver(&cumanascsi2_driver);
506 }
507 
508 static void __exit cumanascsi2_exit(void)
509 {
510 	ecard_remove_driver(&cumanascsi2_driver);
511 }
512 
513 module_init(cumanascsi2_init);
514 module_exit(cumanascsi2_exit);
515 
516 MODULE_AUTHOR("Russell King");
517 MODULE_DESCRIPTION("Cumana SCSI-2 driver for Acorn machines");
518 module_param_array(term, int, NULL, 0);
519 MODULE_PARM_DESC(term, "SCSI bus termination");
520 MODULE_LICENSE("GPL");
521