1 /*******************************************************************************
2 AudioScience HPI driver
3 Common Linux HPI ioctl and module probe/remove functions
5 Copyright (C) 1997-2014 AudioScience Inc. <support@audioscience.com>
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of version 2 of the GNU General Public License as
9 published by the Free Software Foundation;
11 This program is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 *******************************************************************************/
17 #define SOURCEFILE_NAME "hpioctl.c"
19 #include "hpi_internal.h"
20 #include "hpi_version.h"
21 #include "hpimsginit.h"
28 #include <linux/interrupt.h>
29 #include <linux/slab.h>
30 #include <linux/moduleparam.h>
31 #include <linux/uaccess.h>
32 #include <linux/pci.h>
33 #include <linux/stringify.h>
34 #include <linux/module.h>
35 #include <linux/vmalloc.h>
37 #ifdef MODULE_FIRMWARE
38 MODULE_FIRMWARE("asihpi/dsp5000.bin");
39 MODULE_FIRMWARE("asihpi/dsp6200.bin");
40 MODULE_FIRMWARE("asihpi/dsp6205.bin");
41 MODULE_FIRMWARE("asihpi/dsp6400.bin");
42 MODULE_FIRMWARE("asihpi/dsp6600.bin");
43 MODULE_FIRMWARE("asihpi/dsp8700.bin");
44 MODULE_FIRMWARE("asihpi/dsp8900.bin");
47 static int prealloc_stream_buf
;
48 module_param(prealloc_stream_buf
, int, S_IRUGO
);
49 MODULE_PARM_DESC(prealloc_stream_buf
,
50 "Preallocate size for per-adapter stream buffer");
52 /* Allow the debug level to be changed after module load.
53 E.g. echo 2 > /sys/module/asihpi/parameters/hpiDebugLevel
55 module_param(hpi_debug_level
, int, S_IRUGO
| S_IWUSR
);
56 MODULE_PARM_DESC(hpi_debug_level
, "debug verbosity 0..5");
58 /* List of adapters found */
59 static struct hpi_adapter adapters
[HPI_MAX_ADAPTERS
];
61 /* Wrapper function to HPI_Message to enable dumping of the
62 message and response types.
64 static void hpi_send_recv_f(struct hpi_message
*phm
, struct hpi_response
*phr
,
67 if ((phm
->adapter_index
>= HPI_MAX_ADAPTERS
)
68 && (phm
->object
!= HPI_OBJ_SUBSYSTEM
))
69 phr
->error
= HPI_ERROR_INVALID_OBJ_INDEX
;
71 hpi_send_recv_ex(phm
, phr
, file
);
74 /* This is called from hpifunc.c functions, called by ALSA
75 * (or other kernel process) In this case there is no file descriptor
76 * available for the message cache code
78 void hpi_send_recv(struct hpi_message
*phm
, struct hpi_response
*phr
)
80 hpi_send_recv_f(phm
, phr
, HOWNER_KERNEL
);
83 EXPORT_SYMBOL(hpi_send_recv
);
84 /* for radio-asihpi */
86 int asihpi_hpi_release(struct file
*file
)
88 struct hpi_message hm
;
89 struct hpi_response hr
;
91 /* HPI_DEBUG_LOG(INFO,"hpi_release file %p, pid %d\n", file, current->pid); */
92 /* close the subsystem just in case the application forgot to. */
93 hpi_init_message_response(&hm
, &hr
, HPI_OBJ_SUBSYSTEM
,
95 hpi_send_recv_ex(&hm
, &hr
, file
);
99 long asihpi_hpi_ioctl(struct file
*file
, unsigned int cmd
, unsigned long arg
)
101 struct hpi_ioctl_linux __user
*phpi_ioctl_data
;
104 union hpi_message_buffer_v1
*hm
;
105 union hpi_response_buffer_v1
*hr
;
111 if (cmd
!= HPI_IOCTL_LINUX
)
114 hm
= kmalloc(sizeof(*hm
), GFP_KERNEL
);
115 hr
= kzalloc(sizeof(*hr
), GFP_KERNEL
);
121 phpi_ioctl_data
= (struct hpi_ioctl_linux __user
*)arg
;
123 /* Read the message and response pointers from user space. */
124 if (get_user(puhm
, &phpi_ioctl_data
->phm
)
125 || get_user(puhr
, &phpi_ioctl_data
->phr
)) {
130 /* Now read the message size and data from user space. */
131 if (get_user(msg_size
, (u16 __user
*)puhm
)) {
135 if (msg_size
> sizeof(*hm
))
136 msg_size
= sizeof(*hm
);
138 /* printk(KERN_INFO "message size %d\n", hm->h.wSize); */
140 uncopied_bytes
= copy_from_user(hm
, puhm
, msg_size
);
141 if (uncopied_bytes
) {
142 HPI_DEBUG_LOG(ERROR
, "uncopied bytes %d\n", uncopied_bytes
);
147 /* Override h.size in case it is changed between two userspace fetches */
148 hm
->h
.size
= msg_size
;
150 if (get_user(res_max_size
, (u16 __user
*)puhr
)) {
154 /* printk(KERN_INFO "user response size %d\n", res_max_size); */
155 if (res_max_size
< sizeof(struct hpi_response_header
)) {
156 HPI_DEBUG_LOG(WARNING
, "small res size %d\n", res_max_size
);
161 res_max_size
= min_t(size_t, res_max_size
, sizeof(*hr
));
163 switch (hm
->h
.function
) {
164 case HPI_SUBSYS_CREATE_ADAPTER
:
165 case HPI_ADAPTER_DELETE
:
166 /* Application must not use these functions! */
167 hr
->h
.size
= sizeof(hr
->h
);
168 hr
->h
.error
= HPI_ERROR_INVALID_OPERATION
;
169 hr
->h
.function
= hm
->h
.function
;
170 uncopied_bytes
= copy_to_user(puhr
, hr
, hr
->h
.size
);
178 hr
->h
.size
= res_max_size
;
179 if (hm
->h
.object
== HPI_OBJ_SUBSYSTEM
) {
180 hpi_send_recv_f(&hm
->m0
, &hr
->r0
, file
);
182 u16 __user
*ptr
= NULL
;
184 /* -1=no data 0=read from user mem, 1=write to user mem */
186 struct hpi_adapter
*pa
= NULL
;
188 if (hm
->h
.adapter_index
< ARRAY_SIZE(adapters
))
189 pa
= &adapters
[hm
->h
.adapter_index
];
191 if (!pa
|| !pa
->adapter
|| !pa
->adapter
->type
) {
192 hpi_init_response(&hr
->r0
, hm
->h
.object
,
193 hm
->h
.function
, HPI_ERROR_BAD_ADAPTER_NUMBER
);
196 copy_to_user(puhr
, hr
, sizeof(hr
->h
));
204 if (mutex_lock_interruptible(&pa
->mutex
)) {
209 /* Dig out any pointers embedded in the message. */
210 switch (hm
->h
.function
) {
211 case HPI_OSTREAM_WRITE
:
212 case HPI_ISTREAM_READ
:{
213 /* Yes, sparse, this is correct. */
214 ptr
= (u16 __user
*)hm
->m0
.u
.d
.u
.data
.pb_data
;
215 size
= hm
->m0
.u
.d
.u
.data
.data_size
;
217 /* Allocate buffer according to application request.
218 ?Is it better to alloc/free for the duration
221 if (pa
->buffer_size
< size
) {
223 "Realloc adapter %d stream "
224 "buffer from %zd to %d\n",
226 pa
->buffer_size
, size
);
231 pa
->p_buffer
= vmalloc(size
);
233 pa
->buffer_size
= size
;
236 "HPI could not allocate "
237 "stream buffer size %d\n",
240 mutex_unlock(&pa
->mutex
);
246 hm
->m0
.u
.d
.u
.data
.pb_data
= pa
->p_buffer
;
247 if (hm
->h
.function
== HPI_ISTREAM_READ
)
248 /* from card, WRITE to user mem */
260 if (size
&& (wrflag
== 0)) {
262 copy_from_user(pa
->p_buffer
, ptr
, size
);
264 HPI_DEBUG_LOG(WARNING
,
266 "bytes from user\n", uncopied_bytes
,
270 hpi_send_recv_f(&hm
->m0
, &hr
->r0
, file
);
272 if (size
&& (wrflag
== 1)) {
274 copy_to_user(ptr
, pa
->p_buffer
, size
);
276 HPI_DEBUG_LOG(WARNING
,
277 "Missed %d of %d " "bytes to user\n",
278 uncopied_bytes
, size
);
281 mutex_unlock(&pa
->mutex
);
284 /* on return response size must be set */
285 /*printk(KERN_INFO "response size %d\n", hr->h.wSize); */
288 HPI_DEBUG_LOG(ERROR
, "response zero size\n");
293 if (hr
->h
.size
> res_max_size
) {
294 HPI_DEBUG_LOG(ERROR
, "response too big %d %d\n", hr
->h
.size
,
296 hr
->h
.error
= HPI_ERROR_RESPONSE_BUFFER_TOO_SMALL
;
297 hr
->h
.specific_error
= hr
->h
.size
;
298 hr
->h
.size
= sizeof(hr
->h
);
301 uncopied_bytes
= copy_to_user(puhr
, hr
, hr
->h
.size
);
302 if (uncopied_bytes
) {
303 HPI_DEBUG_LOG(ERROR
, "uncopied bytes %d\n", uncopied_bytes
);
314 static int asihpi_irq_count
;
316 static irqreturn_t
asihpi_isr(int irq
, void *dev_id
)
318 struct hpi_adapter
*a
= dev_id
;
321 if (!a
->adapter
->irq_query_and_clear
) {
322 pr_err("asihpi_isr ASI%04X:%d no handler\n", a
->adapter
->type
,
327 handled
= a
->adapter
->irq_query_and_clear(a
->adapter
, 0);
333 /* printk(KERN_INFO "asihpi_isr %d ASI%04X:%d irq handled\n",
334 asihpi_irq_count, a->adapter->type, a->adapter->index); */
336 if (a
->interrupt_callback
)
337 a
->interrupt_callback(a
);
342 int asihpi_adapter_probe(struct pci_dev
*pci_dev
,
343 const struct pci_device_id
*pci_id
)
345 int idx
, nm
, low_latency_mode
= 0, irq_supported
= 0;
348 struct hpi_message hm
;
349 struct hpi_response hr
;
350 struct hpi_adapter adapter
;
353 memset(&adapter
, 0, sizeof(adapter
));
355 dev_printk(KERN_DEBUG
, &pci_dev
->dev
,
356 "probe %04x:%04x,%04x:%04x,%04x\n", pci_dev
->vendor
,
357 pci_dev
->device
, pci_dev
->subsystem_vendor
,
358 pci_dev
->subsystem_device
, pci_dev
->devfn
);
360 if (pci_enable_device(pci_dev
) < 0) {
361 dev_err(&pci_dev
->dev
,
362 "pci_enable_device failed, disabling device\n");
366 pci_set_master(pci_dev
); /* also sets latency timer if < 16 */
368 hpi_init_message_response(&hm
, &hr
, HPI_OBJ_SUBSYSTEM
,
369 HPI_SUBSYS_CREATE_ADAPTER
);
370 hpi_init_response(&hr
, HPI_OBJ_SUBSYSTEM
, HPI_SUBSYS_CREATE_ADAPTER
,
371 HPI_ERROR_PROCESSING_MESSAGE
);
373 hm
.adapter_index
= HPI_ADAPTER_INDEX_INVALID
;
375 nm
= HPI_MAX_ADAPTER_MEM_SPACES
;
377 for (idx
= 0; idx
< nm
; idx
++) {
378 HPI_DEBUG_LOG(INFO
, "resource %d %pR\n", idx
,
379 &pci_dev
->resource
[idx
]);
381 if (pci_resource_flags(pci_dev
, idx
) & IORESOURCE_MEM
) {
382 memlen
= pci_resource_len(pci_dev
, idx
);
383 pci
.ap_mem_base
[idx
] =
384 ioremap(pci_resource_start(pci_dev
, idx
),
386 if (!pci
.ap_mem_base
[idx
]) {
388 "ioremap failed, aborting\n");
389 /* unmap previously mapped pci mem space */
395 pci
.pci_dev
= pci_dev
;
396 hm
.u
.s
.resource
.bus_type
= HPI_BUS_PCI
;
397 hm
.u
.s
.resource
.r
.pci
= &pci
;
399 /* call CreateAdapterObject on the relevant hpi module */
400 hpi_send_recv_ex(&hm
, &hr
, HOWNER_KERNEL
);
404 adapter_index
= hr
.u
.s
.adapter_index
;
405 adapter
.adapter
= hpi_find_adapter(adapter_index
);
407 if (prealloc_stream_buf
) {
408 adapter
.p_buffer
= vmalloc(prealloc_stream_buf
);
409 if (!adapter
.p_buffer
) {
411 "HPI could not allocate "
412 "kernel buffer size %d\n",
413 prealloc_stream_buf
);
418 hpi_init_message_response(&hm
, &hr
, HPI_OBJ_ADAPTER
,
420 hm
.adapter_index
= adapter
.adapter
->index
;
421 hpi_send_recv_ex(&hm
, &hr
, HOWNER_KERNEL
);
424 HPI_DEBUG_LOG(ERROR
, "HPI_ADAPTER_OPEN failed, aborting\n");
428 /* Check if current mode == Low Latency mode */
429 hpi_init_message_response(&hm
, &hr
, HPI_OBJ_ADAPTER
,
430 HPI_ADAPTER_GET_MODE
);
431 hm
.adapter_index
= adapter
.adapter
->index
;
432 hpi_send_recv_ex(&hm
, &hr
, HOWNER_KERNEL
);
435 && hr
.u
.ax
.mode
.adapter_mode
== HPI_ADAPTER_MODE_LOW_LATENCY
)
436 low_latency_mode
= 1;
438 dev_info(&pci_dev
->dev
,
439 "Adapter at index %d is not in low latency mode\n",
440 adapter
.adapter
->index
);
442 /* Check if IRQs are supported */
443 hpi_init_message_response(&hm
, &hr
, HPI_OBJ_ADAPTER
,
444 HPI_ADAPTER_GET_PROPERTY
);
445 hm
.adapter_index
= adapter
.adapter
->index
;
446 hm
.u
.ax
.property_set
.property
= HPI_ADAPTER_PROPERTY_SUPPORTS_IRQ
;
447 hpi_send_recv_ex(&hm
, &hr
, HOWNER_KERNEL
);
448 if (hr
.error
|| !hr
.u
.ax
.property_get
.parameter1
) {
449 dev_info(&pci_dev
->dev
,
450 "IRQs not supported by adapter at index %d\n",
451 adapter
.adapter
->index
);
456 /* WARNING can't init mutex in 'adapter'
457 * and then copy it to adapters[] ?!?!
459 adapters
[adapter_index
] = adapter
;
460 mutex_init(&adapters
[adapter_index
].mutex
);
461 pci_set_drvdata(pci_dev
, &adapters
[adapter_index
]);
463 if (low_latency_mode
&& irq_supported
) {
464 if (!adapter
.adapter
->irq_query_and_clear
) {
465 dev_err(&pci_dev
->dev
,
466 "no IRQ handler for adapter %d, aborting\n",
467 adapter
.adapter
->index
);
471 /* Disable IRQ generation on DSP side by setting the rate to 0 */
472 hpi_init_message_response(&hm
, &hr
, HPI_OBJ_ADAPTER
,
473 HPI_ADAPTER_SET_PROPERTY
);
474 hm
.adapter_index
= adapter
.adapter
->index
;
475 hm
.u
.ax
.property_set
.property
= HPI_ADAPTER_PROPERTY_IRQ_RATE
;
476 hm
.u
.ax
.property_set
.parameter1
= 0;
477 hm
.u
.ax
.property_set
.parameter2
= 0;
478 hpi_send_recv_ex(&hm
, &hr
, HOWNER_KERNEL
);
481 "HPI_ADAPTER_GET_MODE failed, aborting\n");
485 /* Note: request_irq calls asihpi_isr here */
486 if (request_irq(pci_dev
->irq
, asihpi_isr
, IRQF_SHARED
,
487 "asihpi", &adapters
[adapter_index
])) {
488 dev_err(&pci_dev
->dev
, "request_irq(%d) failed\n",
493 adapters
[adapter_index
].interrupt_mode
= 1;
495 dev_info(&pci_dev
->dev
, "using irq %d\n", pci_dev
->irq
);
496 adapters
[adapter_index
].irq
= pci_dev
->irq
;
498 dev_info(&pci_dev
->dev
, "using polled mode\n");
501 dev_info(&pci_dev
->dev
, "probe succeeded for ASI%04X HPI index %d\n",
502 adapter
.adapter
->type
, adapter_index
);
507 for (idx
= 0; idx
< HPI_MAX_ADAPTER_MEM_SPACES
; idx
++) {
508 if (pci
.ap_mem_base
[idx
]) {
509 iounmap(pci
.ap_mem_base
[idx
]);
510 pci
.ap_mem_base
[idx
] = NULL
;
514 if (adapter
.p_buffer
) {
515 adapter
.buffer_size
= 0;
516 vfree(adapter
.p_buffer
);
519 HPI_DEBUG_LOG(ERROR
, "adapter_probe failed\n");
523 void asihpi_adapter_remove(struct pci_dev
*pci_dev
)
526 struct hpi_message hm
;
527 struct hpi_response hr
;
528 struct hpi_adapter
*pa
;
531 pa
= pci_get_drvdata(pci_dev
);
532 pci
= pa
->adapter
->pci
;
534 /* Disable IRQ generation on DSP side */
535 hpi_init_message_response(&hm
, &hr
, HPI_OBJ_ADAPTER
,
536 HPI_ADAPTER_SET_PROPERTY
);
537 hm
.adapter_index
= pa
->adapter
->index
;
538 hm
.u
.ax
.property_set
.property
= HPI_ADAPTER_PROPERTY_IRQ_RATE
;
539 hm
.u
.ax
.property_set
.parameter1
= 0;
540 hm
.u
.ax
.property_set
.parameter2
= 0;
541 hpi_send_recv_ex(&hm
, &hr
, HOWNER_KERNEL
);
543 hpi_init_message_response(&hm
, &hr
, HPI_OBJ_ADAPTER
,
545 hm
.adapter_index
= pa
->adapter
->index
;
546 hpi_send_recv_ex(&hm
, &hr
, HOWNER_KERNEL
);
548 /* unmap PCI memory space, mapped during device init. */
549 for (idx
= 0; idx
< HPI_MAX_ADAPTER_MEM_SPACES
; ++idx
)
550 iounmap(pci
.ap_mem_base
[idx
]);
553 free_irq(pa
->irq
, pa
);
558 dev_info(&pci_dev
->dev
,
559 "remove %04x:%04x,%04x:%04x,%04x, HPI index %d\n",
560 pci_dev
->vendor
, pci_dev
->device
,
561 pci_dev
->subsystem_vendor
, pci_dev
->subsystem_device
,
562 pci_dev
->devfn
, pa
->adapter
->index
);
564 memset(pa
, 0, sizeof(*pa
));
567 void __init
asihpi_init(void)
569 struct hpi_message hm
;
570 struct hpi_response hr
;
572 memset(adapters
, 0, sizeof(adapters
));
574 printk(KERN_INFO
"ASIHPI driver " HPI_VER_STRING
"\n");
576 hpi_init_message_response(&hm
, &hr
, HPI_OBJ_SUBSYSTEM
,
577 HPI_SUBSYS_DRIVER_LOAD
);
578 hpi_send_recv_ex(&hm
, &hr
, HOWNER_KERNEL
);
581 void asihpi_exit(void)
583 struct hpi_message hm
;
584 struct hpi_response hr
;
586 hpi_init_message_response(&hm
, &hr
, HPI_OBJ_SUBSYSTEM
,
587 HPI_SUBSYS_DRIVER_UNLOAD
);
588 hpi_send_recv_ex(&hm
, &hr
, HOWNER_KERNEL
);