xref: /linux/drivers/char/dsp56k.c (revision ca64d84e93762f4e587e040a44ad9f6089afc777)
1 /*
2  * The DSP56001 Device Driver, saviour of the Free World(tm)
3  *
4  * Authors: Fredrik Noring   <noring@nocrew.org>
5  *          lars brinkhoff   <lars@nocrew.org>
6  *          Tomas Berndtsson <tomas@nocrew.org>
7  *
8  * First version May 1996
9  *
10  * History:
11  *  97-01-29   Tomas Berndtsson,
12  *               Integrated with Linux 2.1.21 kernel sources.
13  *  97-02-15   Tomas Berndtsson,
14  *               Fixed for kernel 2.1.26
15  *
16  * BUGS:
17  *  Hmm... there must be something here :)
18  *
19  * Copyright (C) 1996,1997 Fredrik Noring, lars brinkhoff & Tomas Berndtsson
20  *
21  * This file is subject to the terms and conditions of the GNU General Public
22  * License.  See the file COPYING in the main directory of this archive
23  * for more details.
24  */
25 
26 #include <linux/module.h>
27 #include <linux/major.h>
28 #include <linux/types.h>
29 #include <linux/errno.h>
30 #include <linux/delay.h>	/* guess what */
31 #include <linux/fs.h>
32 #include <linux/mm.h>
33 #include <linux/init.h>
34 #include <linux/device.h>
35 #include <linux/mutex.h>
36 #include <linux/firmware.h>
37 #include <linux/platform_device.h>
38 #include <linux/uaccess.h>	/* For put_user and get_user */
39 
40 #include <asm/atarihw.h>
41 #include <asm/traps.h>
42 
43 #include <asm/dsp56k.h>
44 
45 /* minor devices */
46 #define DSP56K_DEV_56001        0    /* The only device so far */
47 
48 #define TIMEOUT    10   /* Host port timeout in number of tries */
49 #define MAXIO    2048   /* Maximum number of words before sleep */
50 #define DSP56K_MAX_BINARY_LENGTH (3*64*1024)
51 
52 #define DSP56K_TX_INT_ON	dsp56k_host_interface.icr |=  DSP56K_ICR_TREQ
53 #define DSP56K_RX_INT_ON	dsp56k_host_interface.icr |=  DSP56K_ICR_RREQ
54 #define DSP56K_TX_INT_OFF	dsp56k_host_interface.icr &= ~DSP56K_ICR_TREQ
55 #define DSP56K_RX_INT_OFF	dsp56k_host_interface.icr &= ~DSP56K_ICR_RREQ
56 
57 #define DSP56K_TRANSMIT		(dsp56k_host_interface.isr & DSP56K_ISR_TXDE)
58 #define DSP56K_RECEIVE		(dsp56k_host_interface.isr & DSP56K_ISR_RXDF)
59 
60 #define handshake(count, maxio, timeout, ENABLE, f) \
61 { \
62 	long i, t, m; \
63 	while (count > 0) { \
64 		m = min_t(unsigned long, count, maxio); \
65 		for (i = 0; i < m; i++) { \
66 			for (t = 0; t < timeout && !ENABLE; t++) \
67 				msleep(20); \
68 			if(!ENABLE) \
69 				return -EIO; \
70 			f; \
71 		} \
72 		count -= m; \
73 		if (m == maxio) msleep(20); \
74 	} \
75 }
76 
77 #define tx_wait(n) \
78 { \
79 	int t; \
80 	for(t = 0; t < n && !DSP56K_TRANSMIT; t++) \
81 		msleep(10); \
82 	if(!DSP56K_TRANSMIT) { \
83 		return -EIO; \
84 	} \
85 }
86 
87 #define rx_wait(n) \
88 { \
89 	int t; \
90 	for(t = 0; t < n && !DSP56K_RECEIVE; t++) \
91 		msleep(10); \
92 	if(!DSP56K_RECEIVE) { \
93 		return -EIO; \
94 	} \
95 }
96 
97 static DEFINE_MUTEX(dsp56k_mutex);
98 static struct dsp56k_device {
99 	unsigned long in_use;
100 	long maxio, timeout;
101 	int tx_wsize, rx_wsize;
102 } dsp56k;
103 
104 static struct class *dsp56k_class;
105 
106 static int dsp56k_reset(void)
107 {
108 	u_char status;
109 
110 	/* Power down the DSP */
111 	sound_ym.rd_data_reg_sel = 14;
112 	status = sound_ym.rd_data_reg_sel & 0xef;
113 	sound_ym.wd_data = status;
114 	sound_ym.wd_data = status | 0x10;
115 
116 	udelay(10);
117 
118 	/* Power up the DSP */
119 	sound_ym.rd_data_reg_sel = 14;
120 	sound_ym.wd_data = sound_ym.rd_data_reg_sel & 0xef;
121 
122 	return 0;
123 }
124 
125 static int dsp56k_upload(u_char __user *bin, int len)
126 {
127 	struct platform_device *pdev;
128 	const struct firmware *fw;
129 	const char fw_name[] = "dsp56k/bootstrap.bin";
130 	int err;
131 	int i;
132 
133 	dsp56k_reset();
134 
135 	pdev = platform_device_register_simple("dsp56k", 0, NULL, 0);
136 	if (IS_ERR(pdev)) {
137 		printk(KERN_ERR "Failed to register device for \"%s\"\n",
138 		       fw_name);
139 		return -EINVAL;
140 	}
141 	err = request_firmware(&fw, fw_name, &pdev->dev);
142 	platform_device_unregister(pdev);
143 	if (err) {
144 		printk(KERN_ERR "Failed to load image \"%s\" err %d\n",
145 		       fw_name, err);
146 		return err;
147 	}
148 	if (fw->size % 3) {
149 		printk(KERN_ERR "Bogus length %d in image \"%s\"\n",
150 		       fw->size, fw_name);
151 		release_firmware(fw);
152 		return -EINVAL;
153 	}
154 	for (i = 0; i < fw->size; i = i + 3) {
155 		/* tx_wait(10); */
156 		dsp56k_host_interface.data.b[1] = fw->data[i];
157 		dsp56k_host_interface.data.b[2] = fw->data[i + 1];
158 		dsp56k_host_interface.data.b[3] = fw->data[i + 2];
159 	}
160 	release_firmware(fw);
161 	for (; i < 512; i++) {
162 		/* tx_wait(10); */
163 		dsp56k_host_interface.data.b[1] = 0;
164 		dsp56k_host_interface.data.b[2] = 0;
165 		dsp56k_host_interface.data.b[3] = 0;
166 	}
167 
168 	for (i = 0; i < len; i++) {
169 		tx_wait(10);
170 		get_user(dsp56k_host_interface.data.b[1], bin++);
171 		get_user(dsp56k_host_interface.data.b[2], bin++);
172 		get_user(dsp56k_host_interface.data.b[3], bin++);
173 	}
174 
175 	tx_wait(10);
176 	dsp56k_host_interface.data.l = 3;    /* Magic execute */
177 
178 	return 0;
179 }
180 
181 static ssize_t dsp56k_read(struct file *file, char __user *buf, size_t count,
182 			   loff_t *ppos)
183 {
184 	struct inode *inode = file_inode(file);
185 	int dev = iminor(inode) & 0x0f;
186 
187 	switch(dev)
188 	{
189 	case DSP56K_DEV_56001:
190 	{
191 
192 		long n;
193 
194 		/* Don't do anything if nothing is to be done */
195 		if (!count) return 0;
196 
197 		n = 0;
198 		switch (dsp56k.rx_wsize) {
199 		case 1:  /* 8 bit */
200 		{
201 			handshake(count, dsp56k.maxio, dsp56k.timeout, DSP56K_RECEIVE,
202 				  put_user(dsp56k_host_interface.data.b[3], buf+n++));
203 			return n;
204 		}
205 		case 2:  /* 16 bit */
206 		{
207 			short __user *data;
208 
209 			count /= 2;
210 			data = (short __user *) buf;
211 			handshake(count, dsp56k.maxio, dsp56k.timeout, DSP56K_RECEIVE,
212 				  put_user(dsp56k_host_interface.data.w[1], data+n++));
213 			return 2*n;
214 		}
215 		case 3:  /* 24 bit */
216 		{
217 			count /= 3;
218 			handshake(count, dsp56k.maxio, dsp56k.timeout, DSP56K_RECEIVE,
219 				  put_user(dsp56k_host_interface.data.b[1], buf+n++);
220 				  put_user(dsp56k_host_interface.data.b[2], buf+n++);
221 				  put_user(dsp56k_host_interface.data.b[3], buf+n++));
222 			return 3*n;
223 		}
224 		case 4:  /* 32 bit */
225 		{
226 			long __user *data;
227 
228 			count /= 4;
229 			data = (long __user *) buf;
230 			handshake(count, dsp56k.maxio, dsp56k.timeout, DSP56K_RECEIVE,
231 				  put_user(dsp56k_host_interface.data.l, data+n++));
232 			return 4*n;
233 		}
234 		}
235 		return -EFAULT;
236 	}
237 
238 	default:
239 		printk(KERN_ERR "DSP56k driver: Unknown minor device: %d\n", dev);
240 		return -ENXIO;
241 	}
242 }
243 
244 static ssize_t dsp56k_write(struct file *file, const char __user *buf, size_t count,
245 			    loff_t *ppos)
246 {
247 	struct inode *inode = file_inode(file);
248 	int dev = iminor(inode) & 0x0f;
249 
250 	switch(dev)
251 	{
252 	case DSP56K_DEV_56001:
253 	{
254 		long n;
255 
256 		/* Don't do anything if nothing is to be done */
257 		if (!count) return 0;
258 
259 		n = 0;
260 		switch (dsp56k.tx_wsize) {
261 		case 1:  /* 8 bit */
262 		{
263 			handshake(count, dsp56k.maxio, dsp56k.timeout, DSP56K_TRANSMIT,
264 				  get_user(dsp56k_host_interface.data.b[3], buf+n++));
265 			return n;
266 		}
267 		case 2:  /* 16 bit */
268 		{
269 			const short __user *data;
270 
271 			count /= 2;
272 			data = (const short __user *)buf;
273 			handshake(count, dsp56k.maxio, dsp56k.timeout, DSP56K_TRANSMIT,
274 				  get_user(dsp56k_host_interface.data.w[1], data+n++));
275 			return 2*n;
276 		}
277 		case 3:  /* 24 bit */
278 		{
279 			count /= 3;
280 			handshake(count, dsp56k.maxio, dsp56k.timeout, DSP56K_TRANSMIT,
281 				  get_user(dsp56k_host_interface.data.b[1], buf+n++);
282 				  get_user(dsp56k_host_interface.data.b[2], buf+n++);
283 				  get_user(dsp56k_host_interface.data.b[3], buf+n++));
284 			return 3*n;
285 		}
286 		case 4:  /* 32 bit */
287 		{
288 			const long __user *data;
289 
290 			count /= 4;
291 			data = (const long __user *)buf;
292 			handshake(count, dsp56k.maxio, dsp56k.timeout, DSP56K_TRANSMIT,
293 				  get_user(dsp56k_host_interface.data.l, data+n++));
294 			return 4*n;
295 		}
296 		}
297 
298 		return -EFAULT;
299 	}
300 	default:
301 		printk(KERN_ERR "DSP56k driver: Unknown minor device: %d\n", dev);
302 		return -ENXIO;
303 	}
304 }
305 
306 static long dsp56k_ioctl(struct file *file, unsigned int cmd,
307 			 unsigned long arg)
308 {
309 	int dev = iminor(file_inode(file)) & 0x0f;
310 	void __user *argp = (void __user *)arg;
311 
312 	switch(dev)
313 	{
314 	case DSP56K_DEV_56001:
315 
316 		switch(cmd) {
317 		case DSP56K_UPLOAD:
318 		{
319 			char __user *bin;
320 			int r, len;
321 			struct dsp56k_upload __user *binary = argp;
322 
323 			if(get_user(len, &binary->len) < 0)
324 				return -EFAULT;
325 			if(get_user(bin, &binary->bin) < 0)
326 				return -EFAULT;
327 
328 			if (len <= 0) {
329 				return -EINVAL;      /* nothing to upload?!? */
330 			}
331 			if (len > DSP56K_MAX_BINARY_LENGTH) {
332 				return -EINVAL;
333 			}
334 			mutex_lock(&dsp56k_mutex);
335 			r = dsp56k_upload(bin, len);
336 			mutex_unlock(&dsp56k_mutex);
337 			if (r < 0) {
338 				return r;
339 			}
340 
341 			break;
342 		}
343 		case DSP56K_SET_TX_WSIZE:
344 			if (arg > 4 || arg < 1)
345 				return -EINVAL;
346 			mutex_lock(&dsp56k_mutex);
347 			dsp56k.tx_wsize = (int) arg;
348 			mutex_unlock(&dsp56k_mutex);
349 			break;
350 		case DSP56K_SET_RX_WSIZE:
351 			if (arg > 4 || arg < 1)
352 				return -EINVAL;
353 			mutex_lock(&dsp56k_mutex);
354 			dsp56k.rx_wsize = (int) arg;
355 			mutex_unlock(&dsp56k_mutex);
356 			break;
357 		case DSP56K_HOST_FLAGS:
358 		{
359 			int dir, out, status;
360 			struct dsp56k_host_flags __user *hf = argp;
361 
362 			if(get_user(dir, &hf->dir) < 0)
363 				return -EFAULT;
364 			if(get_user(out, &hf->out) < 0)
365 				return -EFAULT;
366 
367 			mutex_lock(&dsp56k_mutex);
368 			if ((dir & 0x1) && (out & 0x1))
369 				dsp56k_host_interface.icr |= DSP56K_ICR_HF0;
370 			else if (dir & 0x1)
371 				dsp56k_host_interface.icr &= ~DSP56K_ICR_HF0;
372 			if ((dir & 0x2) && (out & 0x2))
373 				dsp56k_host_interface.icr |= DSP56K_ICR_HF1;
374 			else if (dir & 0x2)
375 				dsp56k_host_interface.icr &= ~DSP56K_ICR_HF1;
376 
377 			status = 0;
378 			if (dsp56k_host_interface.icr & DSP56K_ICR_HF0) status |= 0x1;
379 			if (dsp56k_host_interface.icr & DSP56K_ICR_HF1) status |= 0x2;
380 			if (dsp56k_host_interface.isr & DSP56K_ISR_HF2) status |= 0x4;
381 			if (dsp56k_host_interface.isr & DSP56K_ISR_HF3) status |= 0x8;
382 			mutex_unlock(&dsp56k_mutex);
383 			return put_user(status, &hf->status);
384 		}
385 		case DSP56K_HOST_CMD:
386 			if (arg > 31)
387 				return -EINVAL;
388 			mutex_lock(&dsp56k_mutex);
389 			dsp56k_host_interface.cvr = (u_char)((arg & DSP56K_CVR_HV_MASK) |
390 							     DSP56K_CVR_HC);
391 			mutex_unlock(&dsp56k_mutex);
392 			break;
393 		default:
394 			return -EINVAL;
395 		}
396 		return 0;
397 
398 	default:
399 		printk(KERN_ERR "DSP56k driver: Unknown minor device: %d\n", dev);
400 		return -ENXIO;
401 	}
402 }
403 
404 /* As of 2.1.26 this should be dsp56k_poll,
405  * but how do I then check device minor number?
406  * Do I need this function at all???
407  */
408 #if 0
409 static __poll_t dsp56k_poll(struct file *file, poll_table *wait)
410 {
411 	int dev = iminor(file_inode(file)) & 0x0f;
412 
413 	switch(dev)
414 	{
415 	case DSP56K_DEV_56001:
416 		/* poll_wait(file, ???, wait); */
417 		return EPOLLIN | EPOLLRDNORM | EPOLLOUT;
418 
419 	default:
420 		printk("DSP56k driver: Unknown minor device: %d\n", dev);
421 		return 0;
422 	}
423 }
424 #endif
425 
426 static int dsp56k_open(struct inode *inode, struct file *file)
427 {
428 	int dev = iminor(inode) & 0x0f;
429 	int ret = 0;
430 
431 	mutex_lock(&dsp56k_mutex);
432 	switch(dev)
433 	{
434 	case DSP56K_DEV_56001:
435 
436 		if (test_and_set_bit(0, &dsp56k.in_use)) {
437 			ret = -EBUSY;
438 			goto out;
439 		}
440 
441 		dsp56k.timeout = TIMEOUT;
442 		dsp56k.maxio = MAXIO;
443 		dsp56k.rx_wsize = dsp56k.tx_wsize = 4;
444 
445 		DSP56K_TX_INT_OFF;
446 		DSP56K_RX_INT_OFF;
447 
448 		/* Zero host flags */
449 		dsp56k_host_interface.icr &= ~DSP56K_ICR_HF0;
450 		dsp56k_host_interface.icr &= ~DSP56K_ICR_HF1;
451 
452 		break;
453 
454 	default:
455 		ret = -ENODEV;
456 	}
457 out:
458 	mutex_unlock(&dsp56k_mutex);
459 	return ret;
460 }
461 
462 static int dsp56k_release(struct inode *inode, struct file *file)
463 {
464 	int dev = iminor(inode) & 0x0f;
465 
466 	switch(dev)
467 	{
468 	case DSP56K_DEV_56001:
469 		clear_bit(0, &dsp56k.in_use);
470 		break;
471 	default:
472 		printk(KERN_ERR "DSP56k driver: Unknown minor device: %d\n", dev);
473 		return -ENXIO;
474 	}
475 
476 	return 0;
477 }
478 
479 static const struct file_operations dsp56k_fops = {
480 	.owner		= THIS_MODULE,
481 	.read		= dsp56k_read,
482 	.write		= dsp56k_write,
483 	.unlocked_ioctl	= dsp56k_ioctl,
484 	.open		= dsp56k_open,
485 	.release	= dsp56k_release,
486 	.llseek		= noop_llseek,
487 };
488 
489 
490 /****** Init and module functions ******/
491 
492 static const char banner[] __initconst = KERN_INFO "DSP56k driver installed\n";
493 
494 static int __init dsp56k_init_driver(void)
495 {
496 	int err = 0;
497 
498 	if(!MACH_IS_ATARI || !ATARIHW_PRESENT(DSP56K)) {
499 		printk("DSP56k driver: Hardware not present\n");
500 		return -ENODEV;
501 	}
502 
503 	if(register_chrdev(DSP56K_MAJOR, "dsp56k", &dsp56k_fops)) {
504 		printk("DSP56k driver: Unable to register driver\n");
505 		return -ENODEV;
506 	}
507 	dsp56k_class = class_create(THIS_MODULE, "dsp56k");
508 	if (IS_ERR(dsp56k_class)) {
509 		err = PTR_ERR(dsp56k_class);
510 		goto out_chrdev;
511 	}
512 	device_create(dsp56k_class, NULL, MKDEV(DSP56K_MAJOR, 0), NULL,
513 		      "dsp56k");
514 
515 	printk(banner);
516 	goto out;
517 
518 out_chrdev:
519 	unregister_chrdev(DSP56K_MAJOR, "dsp56k");
520 out:
521 	return err;
522 }
523 module_init(dsp56k_init_driver);
524 
525 static void __exit dsp56k_cleanup_driver(void)
526 {
527 	device_destroy(dsp56k_class, MKDEV(DSP56K_MAJOR, 0));
528 	class_destroy(dsp56k_class);
529 	unregister_chrdev(DSP56K_MAJOR, "dsp56k");
530 }
531 module_exit(dsp56k_cleanup_driver);
532 
533 MODULE_LICENSE("GPL");
534 MODULE_FIRMWARE("dsp56k/bootstrap.bin");
535