1 /******************************************************************************
3 AudioScience HPI driver
4 Copyright (C) 1997-2011 AudioScience Inc. <support@audioscience.com>
6 This program is free software; you can redistribute it and/or modify
7 it under the terms of version 2 of the GNU General Public License as
8 published by the Free Software Foundation;
10 This program is distributed in the hope that it will be useful,
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 GNU General Public License for more details.
15 You should have received a copy of the GNU General Public License
16 along with this program; if not, write to the Free Software
17 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
19 HPI Operating System Specific macros for Linux Kernel driver
21 (C) Copyright AudioScience Inc. 1997-2003
22 ******************************************************************************/
26 #undef HPI_OS_LINUX_KERNEL
27 #define HPI_OS_LINUX_KERNEL
29 #define HPI_OS_DEFINED
30 #define HPI_BUILD_KERNEL_MODE
33 #include <linux/ioctl.h>
34 #include <linux/kernel.h>
35 #include <linux/string.h>
36 #include <linux/device.h>
37 #include <linux/firmware.h>
38 #include <linux/interrupt.h>
39 #include <linux/pci.h>
40 #include <linux/mutex.h>
42 #define HPI_NO_OS_FILE_OPS
48 /** Details of a memory area allocated with pci_alloc_consistent
49 Need all info for parameters to pci_free_consistent
51 struct consistent_dma_area
{
53 /* looks like dma-mapping dma_devres ?! */
56 dma_addr_t dma_handle
;
59 static inline u16
hpios_locked_mem_get_phys_addr(struct consistent_dma_area
60 *locked_mem_handle
, u32
*p_physical_addr
)
62 *p_physical_addr
= locked_mem_handle
->dma_handle
;
66 static inline u16
hpios_locked_mem_get_virt_addr(struct consistent_dma_area
67 *locked_mem_handle
, void **pp_virtual_addr
)
69 *pp_virtual_addr
= locked_mem_handle
->vaddr
;
73 static inline u16
hpios_locked_mem_valid(struct consistent_dma_area
76 return locked_mem_handle
->size
!= 0;
79 struct hpi_ioctl_linux
{
84 /* Conflict?: H is already used by a number of drivers hid, bluetooth hci,
85 and some sound drivers sb16, hdsp, emu10k. AFAIK 0xFC is ununsed command
87 #define HPI_IOCTL_LINUX _IOWR('H', 0xFC, struct hpi_ioctl_linux)
89 #define HPI_DEBUG_FLAG_ERROR KERN_ERR
90 #define HPI_DEBUG_FLAG_WARNING KERN_WARNING
91 #define HPI_DEBUG_FLAG_NOTICE KERN_NOTICE
92 #define HPI_DEBUG_FLAG_INFO KERN_INFO
93 #define HPI_DEBUG_FLAG_DEBUG KERN_DEBUG
94 #define HPI_DEBUG_FLAG_VERBOSE KERN_DEBUG /* kernel has no verbose */
96 #include <linux/spinlock.h>
100 struct hpios_spinlock
{
101 spinlock_t lock
; /* SEE hpios_spinlock */
105 /* The reason for all this evilness is that ALSA calls some of a drivers
106 * operators in atomic context, and some not. But all our functions channel
107 * through the HPI_Message conduit, so we can't handle the different context
111 #define IN_LOCK_IRQ 0
112 static inline void cond_lock(struct hpios_spinlock
*l
)
114 if (irqs_disabled()) {
115 /* NO bh or isr can execute on this processor,
116 so ordinary lock will do
118 spin_lock(&((l
)->lock
));
119 l
->lock_context
= IN_LOCK_IRQ
;
121 spin_lock_bh(&((l
)->lock
));
122 l
->lock_context
= IN_LOCK_BH
;
126 static inline void cond_unlock(struct hpios_spinlock
*l
)
128 if (l
->lock_context
== IN_LOCK_BH
)
129 spin_unlock_bh(&((l
)->lock
));
131 spin_unlock(&((l
)->lock
));
134 #define hpios_msgxlock_init(obj) spin_lock_init(&(obj)->lock)
135 #define hpios_msgxlock_lock(obj) cond_lock(obj)
136 #define hpios_msgxlock_unlock(obj) cond_unlock(obj)
138 #define hpios_dsplock_init(obj) spin_lock_init(&(obj)->dsp_lock.lock)
139 #define hpios_dsplock_lock(obj) cond_lock(&(obj)->dsp_lock)
140 #define hpios_dsplock_unlock(obj) cond_unlock(&(obj)->dsp_lock)
142 #ifdef CONFIG_SND_DEBUG
143 #define HPI_BUILD_DEBUG
146 #define HPI_ALIST_LOCKING
147 #define hpios_alistlock_init(obj) spin_lock_init(&((obj)->list_lock.lock))
148 #define hpios_alistlock_lock(obj) spin_lock(&((obj)->list_lock.lock))
149 #define hpios_alistlock_unlock(obj) spin_unlock(&((obj)->list_lock.lock))
153 /** pci drvdata points to an instance of this struct */
155 struct hpi_adapter_obj
*adapter
;
156 struct snd_card
*snd_card
;
158 /* mutex prevents contention for one card
159 between multiple user programs (via ioctl) */