1// SPDX-License-Identifier: GPL-2.0-only
2/*******************************************************************************
3    AudioScience HPI driver
4    Common Linux HPI ioctl and module probe/remove functions
5
6    Copyright (C) 1997-2014  AudioScience Inc. <support@audioscience.com>
7
8
9*******************************************************************************/
10#define SOURCEFILE_NAME "hpioctl.c"
11
12#include "hpi_internal.h"
13#include "hpi_version.h"
14#include "hpimsginit.h"
15#include "hpidebug.h"
16#include "hpimsgx.h"
17#include "hpioctl.h"
18#include "hpicmn.h"
19
20#include <linux/fs.h>
21#include <linux/interrupt.h>
22#include <linux/slab.h>
23#include <linux/moduleparam.h>
24#include <linux/uaccess.h>
25#include <linux/pci.h>
26#include <linux/stringify.h>
27#include <linux/module.h>
28#include <linux/vmalloc.h>
29#include <linux/nospec.h>
30
31#ifdef MODULE_FIRMWARE
32MODULE_FIRMWARE("asihpi/dsp5000.bin");
33MODULE_FIRMWARE("asihpi/dsp6200.bin");
34MODULE_FIRMWARE("asihpi/dsp6205.bin");
35MODULE_FIRMWARE("asihpi/dsp6400.bin");
36MODULE_FIRMWARE("asihpi/dsp6600.bin");
37MODULE_FIRMWARE("asihpi/dsp8700.bin");
38MODULE_FIRMWARE("asihpi/dsp8900.bin");
39#endif
40
41static int prealloc_stream_buf;
42module_param(prealloc_stream_buf, int, 0444);
43MODULE_PARM_DESC(prealloc_stream_buf,
44	"Preallocate size for per-adapter stream buffer");
45
46/* Allow the debug level to be changed after module load.
47 E.g.   echo 2 > /sys/module/asihpi/parameters/hpiDebugLevel
48*/
49module_param(hpi_debug_level, int, 0644);
50MODULE_PARM_DESC(hpi_debug_level, "debug verbosity 0..5");
51
52/* List of adapters found */
53static struct hpi_adapter adapters[HPI_MAX_ADAPTERS];
54
55/* Wrapper function to HPI_Message to enable dumping of the
56   message and response types.
57*/
58static void hpi_send_recv_f(struct hpi_message *phm, struct hpi_response *phr,
59	struct file *file)
60{
61	if ((phm->adapter_index >= HPI_MAX_ADAPTERS)
62		&& (phm->object != HPI_OBJ_SUBSYSTEM))
63		phr->error = HPI_ERROR_INVALID_OBJ_INDEX;
64	else
65		hpi_send_recv_ex(phm, phr, file);
66}
67
68/* This is called from hpifunc.c functions, called by ALSA
69 * (or other kernel process) In this case there is no file descriptor
70 * available for the message cache code
71 */
72void hpi_send_recv(struct hpi_message *phm, struct hpi_response *phr)
73{
74	hpi_send_recv_f(phm, phr, HOWNER_KERNEL);
75}
76
77EXPORT_SYMBOL(hpi_send_recv);
78/* for radio-asihpi */
79
80int asihpi_hpi_release(struct file *file)
81{
82	struct hpi_message hm;
83	struct hpi_response hr;
84
85/* HPI_DEBUG_LOG(INFO,"hpi_release file %p, pid %d\n", file, current->pid); */
86	/* close the subsystem just in case the application forgot to. */
87	hpi_init_message_response(&hm, &hr, HPI_OBJ_SUBSYSTEM,
88		HPI_SUBSYS_CLOSE);
89	hpi_send_recv_ex(&hm, &hr, file);
90	return 0;
91}
92
93long asihpi_hpi_ioctl(struct file *file, unsigned int cmd, unsigned long arg)
94{
95	struct hpi_ioctl_linux __user *phpi_ioctl_data;
96	void __user *puhm;
97	void __user *puhr;
98	union hpi_message_buffer_v1 *hm;
99	union hpi_response_buffer_v1 *hr;
100	u16 msg_size;
101	u16 res_max_size;
102	u32 uncopied_bytes;
103	int err = 0;
104
105	if (cmd != HPI_IOCTL_LINUX)
106		return -EINVAL;
107
108	hm = kmalloc(sizeof(*hm), GFP_KERNEL);
109	hr = kzalloc(sizeof(*hr), GFP_KERNEL);
110	if (!hm || !hr) {
111		err = -ENOMEM;
112		goto out;
113	}
114
115	phpi_ioctl_data = (struct hpi_ioctl_linux __user *)arg;
116
117	/* Read the message and response pointers from user space.  */
118	if (get_user(puhm, &phpi_ioctl_data->phm)
119		|| get_user(puhr, &phpi_ioctl_data->phr)) {
120		err = -EFAULT;
121		goto out;
122	}
123
124	/* Now read the message size and data from user space.  */
125	if (get_user(msg_size, (u16 __user *)puhm)) {
126		err = -EFAULT;
127		goto out;
128	}
129	if (msg_size > sizeof(*hm))
130		msg_size = sizeof(*hm);
131
132	/* printk(KERN_INFO "message size %d\n", hm->h.wSize); */
133
134	uncopied_bytes = copy_from_user(hm, puhm, msg_size);
135	if (uncopied_bytes) {
136		HPI_DEBUG_LOG(ERROR, "uncopied bytes %d\n", uncopied_bytes);
137		err = -EFAULT;
138		goto out;
139	}
140
141	/* Override h.size in case it is changed between two userspace fetches */
142	hm->h.size = msg_size;
143
144	if (get_user(res_max_size, (u16 __user *)puhr)) {
145		err = -EFAULT;
146		goto out;
147	}
148	/* printk(KERN_INFO "user response size %d\n", res_max_size); */
149	if (res_max_size < sizeof(struct hpi_response_header)) {
150		HPI_DEBUG_LOG(WARNING, "small res size %d\n", res_max_size);
151		err = -EFAULT;
152		goto out;
153	}
154
155	res_max_size = min_t(size_t, res_max_size, sizeof(*hr));
156
157	switch (hm->h.function) {
158	case HPI_SUBSYS_CREATE_ADAPTER:
159	case HPI_ADAPTER_DELETE:
160		/* Application must not use these functions! */
161		hr->h.size = sizeof(hr->h);
162		hr->h.error = HPI_ERROR_INVALID_OPERATION;
163		hr->h.function = hm->h.function;
164		uncopied_bytes = copy_to_user(puhr, hr, hr->h.size);
165		if (uncopied_bytes)
166			err = -EFAULT;
167		else
168			err = 0;
169		goto out;
170	}
171
172	hr->h.size = res_max_size;
173	if (hm->h.object == HPI_OBJ_SUBSYSTEM) {
174		hpi_send_recv_f(&hm->m0, &hr->r0, file);
175	} else {
176		u16 __user *ptr = NULL;
177		u32 size = 0;
178		/* -1=no data 0=read from user mem, 1=write to user mem */
179		int wrflag = -1;
180		struct hpi_adapter *pa = NULL;
181
182		if (hm->h.adapter_index < ARRAY_SIZE(adapters))
183			pa = &adapters[array_index_nospec(hm->h.adapter_index,
184							  ARRAY_SIZE(adapters))];
185
186		if (!pa || !pa->adapter || !pa->adapter->type) {
187			hpi_init_response(&hr->r0, hm->h.object,
188				hm->h.function, HPI_ERROR_BAD_ADAPTER_NUMBER);
189
190			uncopied_bytes =
191				copy_to_user(puhr, hr, sizeof(hr->h));
192			if (uncopied_bytes)
193				err = -EFAULT;
194			else
195				err = 0;
196			goto out;
197		}
198
199		if (mutex_lock_interruptible(&pa->mutex)) {
200			err = -EINTR;
201			goto out;
202		}
203
204		/* Dig out any pointers embedded in the message.  */
205		switch (hm->h.function) {
206		case HPI_OSTREAM_WRITE:
207		case HPI_ISTREAM_READ:{
208				/* Yes, sparse, this is correct. */
209				ptr = (u16 __user *)hm->m0.u.d.u.data.pb_data;
210				size = hm->m0.u.d.u.data.data_size;
211
212				/* Allocate buffer according to application request.
213				   ?Is it better to alloc/free for the duration
214				   of the transaction?
215				 */
216				if (pa->buffer_size < size) {
217					HPI_DEBUG_LOG(DEBUG,
218						"Realloc adapter %d stream "
219						"buffer from %zd to %d\n",
220						hm->h.adapter_index,
221						pa->buffer_size, size);
222					if (pa->p_buffer) {
223						pa->buffer_size = 0;
224						vfree(pa->p_buffer);
225					}
226					pa->p_buffer = vmalloc(size);
227					if (pa->p_buffer)
228						pa->buffer_size = size;
229					else {
230						HPI_DEBUG_LOG(ERROR,
231							"HPI could not allocate "
232							"stream buffer size %d\n",
233							size);
234
235						mutex_unlock(&pa->mutex);
236						err = -EINVAL;
237						goto out;
238					}
239				}
240
241				hm->m0.u.d.u.data.pb_data = pa->p_buffer;
242				if (hm->h.function == HPI_ISTREAM_READ)
243					/* from card, WRITE to user mem */
244					wrflag = 1;
245				else
246					wrflag = 0;
247				break;
248			}
249
250		default:
251			size = 0;
252			break;
253		}
254
255		if (size && (wrflag == 0)) {
256			uncopied_bytes =
257				copy_from_user(pa->p_buffer, ptr, size);
258			if (uncopied_bytes)
259				HPI_DEBUG_LOG(WARNING,
260					"Missed %d of %d "
261					"bytes from user\n", uncopied_bytes,
262					size);
263		}
264
265		hpi_send_recv_f(&hm->m0, &hr->r0, file);
266
267		if (size && (wrflag == 1)) {
268			uncopied_bytes =
269				copy_to_user(ptr, pa->p_buffer, size);
270			if (uncopied_bytes)
271				HPI_DEBUG_LOG(WARNING,
272					"Missed %d of %d " "bytes to user\n",
273					uncopied_bytes, size);
274		}
275
276		mutex_unlock(&pa->mutex);
277	}
278
279	/* on return response size must be set */
280	/*printk(KERN_INFO "response size %d\n", hr->h.wSize); */
281
282	if (!hr->h.size) {
283		HPI_DEBUG_LOG(ERROR, "response zero size\n");
284		err = -EFAULT;
285		goto out;
286	}
287
288	if (hr->h.size > res_max_size) {
289		HPI_DEBUG_LOG(ERROR, "response too big %d %d\n", hr->h.size,
290			res_max_size);
291		hr->h.error = HPI_ERROR_RESPONSE_BUFFER_TOO_SMALL;
292		hr->h.specific_error = hr->h.size;
293		hr->h.size = sizeof(hr->h);
294	}
295
296	uncopied_bytes = copy_to_user(puhr, hr, hr->h.size);
297	if (uncopied_bytes) {
298		HPI_DEBUG_LOG(ERROR, "uncopied bytes %d\n", uncopied_bytes);
299		err = -EFAULT;
300		goto out;
301	}
302
303out:
304	kfree(hm);
305	kfree(hr);
306	return err;
307}
308
309static int asihpi_irq_count;
310
311static irqreturn_t asihpi_isr(int irq, void *dev_id)
312{
313	struct hpi_adapter *a = dev_id;
314	int handled;
315
316	if (!a->adapter->irq_query_and_clear) {
317		pr_err("asihpi_isr ASI%04X:%d no handler\n", a->adapter->type,
318			a->adapter->index);
319		return IRQ_NONE;
320	}
321
322	handled = a->adapter->irq_query_and_clear(a->adapter, 0);
323
324	if (!handled)
325		return IRQ_NONE;
326
327	asihpi_irq_count++;
328	/* printk(KERN_INFO "asihpi_isr %d ASI%04X:%d irq handled\n",
329	   asihpi_irq_count, a->adapter->type, a->adapter->index); */
330
331	if (a->interrupt_callback)
332		return IRQ_WAKE_THREAD;
333
334	return IRQ_HANDLED;
335}
336
337static irqreturn_t asihpi_isr_thread(int irq, void *dev_id)
338{
339	struct hpi_adapter *a = dev_id;
340
341	if (a->interrupt_callback)
342		a->interrupt_callback(a);
343	return IRQ_HANDLED;
344}
345
346int asihpi_adapter_probe(struct pci_dev *pci_dev,
347			 const struct pci_device_id *pci_id)
348{
349	int idx, nm, low_latency_mode = 0, irq_supported = 0;
350	int adapter_index;
351	unsigned int memlen;
352	struct hpi_message hm;
353	struct hpi_response hr;
354	struct hpi_adapter adapter;
355	struct hpi_pci pci = { 0 };
356
357	memset(&adapter, 0, sizeof(adapter));
358
359	dev_printk(KERN_DEBUG, &pci_dev->dev,
360		"probe %04x:%04x,%04x:%04x,%04x\n", pci_dev->vendor,
361		pci_dev->device, pci_dev->subsystem_vendor,
362		pci_dev->subsystem_device, pci_dev->devfn);
363
364	if (pcim_enable_device(pci_dev) < 0) {
365		dev_err(&pci_dev->dev,
366			"pci_enable_device failed, disabling device\n");
367		return -EIO;
368	}
369
370	pci_set_master(pci_dev);	/* also sets latency timer if < 16 */
371
372	hpi_init_message_response(&hm, &hr, HPI_OBJ_SUBSYSTEM,
373		HPI_SUBSYS_CREATE_ADAPTER);
374	hpi_init_response(&hr, HPI_OBJ_SUBSYSTEM, HPI_SUBSYS_CREATE_ADAPTER,
375		HPI_ERROR_PROCESSING_MESSAGE);
376
377	hm.adapter_index = HPI_ADAPTER_INDEX_INVALID;
378
379	nm = HPI_MAX_ADAPTER_MEM_SPACES;
380
381	for (idx = 0; idx < nm; idx++) {
382		HPI_DEBUG_LOG(INFO, "resource %d %pR\n", idx,
383			&pci_dev->resource[idx]);
384
385		if (pci_resource_flags(pci_dev, idx) & IORESOURCE_MEM) {
386			memlen = pci_resource_len(pci_dev, idx);
387			pci.ap_mem_base[idx] =
388				ioremap(pci_resource_start(pci_dev, idx),
389				memlen);
390			if (!pci.ap_mem_base[idx]) {
391				HPI_DEBUG_LOG(ERROR,
392					"ioremap failed, aborting\n");
393				/* unmap previously mapped pci mem space */
394				goto err;
395			}
396		}
397	}
398
399	pci.pci_dev = pci_dev;
400	hm.u.s.resource.bus_type = HPI_BUS_PCI;
401	hm.u.s.resource.r.pci = &pci;
402
403	/* call CreateAdapterObject on the relevant hpi module */
404	hpi_send_recv_ex(&hm, &hr, HOWNER_KERNEL);
405	if (hr.error)
406		goto err;
407
408	adapter_index = hr.u.s.adapter_index;
409	adapter.adapter = hpi_find_adapter(adapter_index);
410
411	if (prealloc_stream_buf) {
412		adapter.p_buffer = vmalloc(prealloc_stream_buf);
413		if (!adapter.p_buffer) {
414			HPI_DEBUG_LOG(ERROR,
415				"HPI could not allocate "
416				"kernel buffer size %d\n",
417				prealloc_stream_buf);
418			goto err;
419		}
420	}
421
422	hpi_init_message_response(&hm, &hr, HPI_OBJ_ADAPTER,
423		HPI_ADAPTER_OPEN);
424	hm.adapter_index = adapter.adapter->index;
425	hpi_send_recv_ex(&hm, &hr, HOWNER_KERNEL);
426
427	if (hr.error) {
428		HPI_DEBUG_LOG(ERROR, "HPI_ADAPTER_OPEN failed, aborting\n");
429		goto err;
430	}
431
432	/* Check if current mode == Low Latency mode */
433	hpi_init_message_response(&hm, &hr, HPI_OBJ_ADAPTER,
434		HPI_ADAPTER_GET_MODE);
435	hm.adapter_index = adapter.adapter->index;
436	hpi_send_recv_ex(&hm, &hr, HOWNER_KERNEL);
437
438	if (!hr.error
439		&& hr.u.ax.mode.adapter_mode == HPI_ADAPTER_MODE_LOW_LATENCY)
440		low_latency_mode = 1;
441	else
442		dev_info(&pci_dev->dev,
443			"Adapter at index %d is not in low latency mode\n",
444			adapter.adapter->index);
445
446	/* Check if IRQs are supported */
447	hpi_init_message_response(&hm, &hr, HPI_OBJ_ADAPTER,
448		HPI_ADAPTER_GET_PROPERTY);
449	hm.adapter_index = adapter.adapter->index;
450	hm.u.ax.property_set.property = HPI_ADAPTER_PROPERTY_SUPPORTS_IRQ;
451	hpi_send_recv_ex(&hm, &hr, HOWNER_KERNEL);
452	if (hr.error || !hr.u.ax.property_get.parameter1) {
453		dev_info(&pci_dev->dev,
454			"IRQs not supported by adapter at index %d\n",
455			adapter.adapter->index);
456	} else {
457		irq_supported = 1;
458	}
459
460	/* WARNING can't init mutex in 'adapter'
461	 * and then copy it to adapters[] ?!?!
462	 */
463	adapters[adapter_index] = adapter;
464	mutex_init(&adapters[adapter_index].mutex);
465	pci_set_drvdata(pci_dev, &adapters[adapter_index]);
466
467	if (low_latency_mode && irq_supported) {
468		if (!adapter.adapter->irq_query_and_clear) {
469			dev_err(&pci_dev->dev,
470				"no IRQ handler for adapter %d, aborting\n",
471				adapter.adapter->index);
472			goto err;
473		}
474
475		/* Disable IRQ generation on DSP side by setting the rate to 0 */
476		hpi_init_message_response(&hm, &hr, HPI_OBJ_ADAPTER,
477			HPI_ADAPTER_SET_PROPERTY);
478		hm.adapter_index = adapter.adapter->index;
479		hm.u.ax.property_set.property = HPI_ADAPTER_PROPERTY_IRQ_RATE;
480		hm.u.ax.property_set.parameter1 = 0;
481		hm.u.ax.property_set.parameter2 = 0;
482		hpi_send_recv_ex(&hm, &hr, HOWNER_KERNEL);
483		if (hr.error) {
484			HPI_DEBUG_LOG(ERROR,
485				"HPI_ADAPTER_GET_MODE failed, aborting\n");
486			goto err;
487		}
488
489		/* Note: request_irq calls asihpi_isr here */
490		if (request_threaded_irq(pci_dev->irq, asihpi_isr,
491					 asihpi_isr_thread, IRQF_SHARED,
492					 "asihpi", &adapters[adapter_index])) {
493			dev_err(&pci_dev->dev, "request_irq(%d) failed\n",
494				pci_dev->irq);
495			goto err;
496		}
497
498		adapters[adapter_index].interrupt_mode = 1;
499
500		dev_info(&pci_dev->dev, "using irq %d\n", pci_dev->irq);
501		adapters[adapter_index].irq = pci_dev->irq;
502	} else {
503		dev_info(&pci_dev->dev, "using polled mode\n");
504	}
505
506	dev_info(&pci_dev->dev, "probe succeeded for ASI%04X HPI index %d\n",
507		 adapter.adapter->type, adapter_index);
508
509	return 0;
510
511err:
512	while (--idx >= 0) {
513		if (pci.ap_mem_base[idx]) {
514			iounmap(pci.ap_mem_base[idx]);
515			pci.ap_mem_base[idx] = NULL;
516		}
517	}
518
519	if (adapter.p_buffer) {
520		adapter.buffer_size = 0;
521		vfree(adapter.p_buffer);
522	}
523
524	HPI_DEBUG_LOG(ERROR, "adapter_probe failed\n");
525	return -ENODEV;
526}
527
528void asihpi_adapter_remove(struct pci_dev *pci_dev)
529{
530	int idx;
531	struct hpi_message hm;
532	struct hpi_response hr;
533	struct hpi_adapter *pa;
534	struct hpi_pci pci;
535
536	pa = pci_get_drvdata(pci_dev);
537	pci = pa->adapter->pci;
538
539	/* Disable IRQ generation on DSP side */
540	hpi_init_message_response(&hm, &hr, HPI_OBJ_ADAPTER,
541		HPI_ADAPTER_SET_PROPERTY);
542	hm.adapter_index = pa->adapter->index;
543	hm.u.ax.property_set.property = HPI_ADAPTER_PROPERTY_IRQ_RATE;
544	hm.u.ax.property_set.parameter1 = 0;
545	hm.u.ax.property_set.parameter2 = 0;
546	hpi_send_recv_ex(&hm, &hr, HOWNER_KERNEL);
547
548	hpi_init_message_response(&hm, &hr, HPI_OBJ_ADAPTER,
549		HPI_ADAPTER_DELETE);
550	hm.adapter_index = pa->adapter->index;
551	hpi_send_recv_ex(&hm, &hr, HOWNER_KERNEL);
552
553	/* unmap PCI memory space, mapped during device init. */
554	for (idx = 0; idx < HPI_MAX_ADAPTER_MEM_SPACES; ++idx)
555		iounmap(pci.ap_mem_base[idx]);
556
557	if (pa->irq)
558		free_irq(pa->irq, pa);
559
560	vfree(pa->p_buffer);
561
562	if (1)
563		dev_info(&pci_dev->dev,
564			 "remove %04x:%04x,%04x:%04x,%04x, HPI index %d\n",
565			 pci_dev->vendor, pci_dev->device,
566			 pci_dev->subsystem_vendor, pci_dev->subsystem_device,
567			 pci_dev->devfn, pa->adapter->index);
568
569	memset(pa, 0, sizeof(*pa));
570}
571
572void __init asihpi_init(void)
573{
574	struct hpi_message hm;
575	struct hpi_response hr;
576
577	memset(adapters, 0, sizeof(adapters));
578
579	printk(KERN_INFO "ASIHPI driver " HPI_VER_STRING "\n");
580
581	hpi_init_message_response(&hm, &hr, HPI_OBJ_SUBSYSTEM,
582		HPI_SUBSYS_DRIVER_LOAD);
583	hpi_send_recv_ex(&hm, &hr, HOWNER_KERNEL);
584}
585
586void asihpi_exit(void)
587{
588	struct hpi_message hm;
589	struct hpi_response hr;
590
591	hpi_init_message_response(&hm, &hr, HPI_OBJ_SUBSYSTEM,
592		HPI_SUBSYS_DRIVER_UNLOAD);
593	hpi_send_recv_ex(&hm, &hr, HOWNER_KERNEL);
594}
595