2 * compress_core.c - compress offload core
4 * Copyright (C) 2011 Intel Corporation
5 * Authors: Vinod Koul <vinod.koul@linux.intel.com>
6 * Pierre-Louis Bossart <pierre-louis.bossart@linux.intel.com>
7 * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
9 * This program is free software; you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License as published by
11 * the Free Software Foundation; version 2 of the License.
13 * This program is distributed in the hope that it will be useful, but
14 * WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 * General Public License for more details.
18 * You should have received a copy of the GNU General Public License along
19 * with this program; if not, write to the Free Software Foundation, Inc.,
20 * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
22 * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
25 #define FORMAT(fmt) "%s: %d: " fmt, __func__, __LINE__
26 #define pr_fmt(fmt) KBUILD_MODNAME ": " FORMAT(fmt)
28 #include <linux/file.h>
30 #include <linux/list.h>
31 #include <linux/math64.h>
33 #include <linux/mutex.h>
34 #include <linux/poll.h>
35 #include <linux/slab.h>
36 #include <linux/sched.h>
37 #include <linux/types.h>
38 #include <linux/uio.h>
39 #include <linux/uaccess.h>
40 #include <linux/module.h>
41 #include <linux/compat.h>
42 #include <sound/core.h>
43 #include <sound/initval.h>
44 #include <sound/info.h>
45 #include <sound/compress_params.h>
46 #include <sound/compress_offload.h>
47 #include <sound/compress_driver.h>
49 /* struct snd_compr_codec_caps overflows the ioctl bit size for some
50 * architectures, so we need to disable the relevant ioctls.
52 #if _IOC_SIZEBITS < 14
53 #define COMPR_CODEC_CAPS_OVERFLOW
57 * - add substream support for multiple devices in case of
58 * SND_DYNAMIC_MINORS is not used
59 * - Multiple node representation
60 * driver should be able to register multiple nodes
63 static DEFINE_MUTEX(device_mutex
);
65 struct snd_compr_file
{
67 struct snd_compr_stream stream
;
70 static void error_delayed_work(struct work_struct
*work
);
73 * a note on stream states used:
74 * we use following states in the compressed core
75 * SNDRV_PCM_STATE_OPEN: When stream has been opened.
76 * SNDRV_PCM_STATE_SETUP: When stream has been initialized. This is done by
77 * calling SNDRV_COMPRESS_SET_PARAMS. Running streams will come to this
78 * state at stop by calling SNDRV_COMPRESS_STOP, or at end of drain.
79 * SNDRV_PCM_STATE_PREPARED: When a stream has been written to (for
80 * playback only). User after setting up stream writes the data buffer
81 * before starting the stream.
82 * SNDRV_PCM_STATE_RUNNING: When stream has been started and is
83 * decoding/encoding and rendering/capturing data.
84 * SNDRV_PCM_STATE_DRAINING: When stream is draining current data. This is done
85 * by calling SNDRV_COMPRESS_DRAIN.
86 * SNDRV_PCM_STATE_PAUSED: When stream is paused. This is done by calling
87 * SNDRV_COMPRESS_PAUSE. It can be stopped or resumed by calling
88 * SNDRV_COMPRESS_STOP or SNDRV_COMPRESS_RESUME respectively.
90 static int snd_compr_open(struct inode
*inode
, struct file
*f
)
92 struct snd_compr
*compr
;
93 struct snd_compr_file
*data
;
94 struct snd_compr_runtime
*runtime
;
95 enum snd_compr_direction dirn
;
96 int maj
= imajor(inode
);
99 if ((f
->f_flags
& O_ACCMODE
) == O_WRONLY
)
100 dirn
= SND_COMPRESS_PLAYBACK
;
101 else if ((f
->f_flags
& O_ACCMODE
) == O_RDONLY
)
102 dirn
= SND_COMPRESS_CAPTURE
;
106 if (maj
== snd_major
)
107 compr
= snd_lookup_minor_data(iminor(inode
),
108 SNDRV_DEVICE_TYPE_COMPRESS
);
113 pr_err("no device data!!!\n");
117 if (dirn
!= compr
->direction
) {
118 pr_err("this device doesn't support this direction\n");
119 snd_card_unref(compr
->card
);
123 data
= kzalloc(sizeof(*data
), GFP_KERNEL
);
125 snd_card_unref(compr
->card
);
129 INIT_DELAYED_WORK(&data
->stream
.error_work
, error_delayed_work
);
131 data
->stream
.ops
= compr
->ops
;
132 data
->stream
.direction
= dirn
;
133 data
->stream
.private_data
= compr
->private_data
;
134 data
->stream
.device
= compr
;
135 runtime
= kzalloc(sizeof(*runtime
), GFP_KERNEL
);
138 snd_card_unref(compr
->card
);
141 runtime
->state
= SNDRV_PCM_STATE_OPEN
;
142 init_waitqueue_head(&runtime
->sleep
);
143 data
->stream
.runtime
= runtime
;
144 f
->private_data
= (void *)data
;
145 mutex_lock(&compr
->lock
);
146 ret
= compr
->ops
->open(&data
->stream
);
147 mutex_unlock(&compr
->lock
);
152 snd_card_unref(compr
->card
);
156 static int snd_compr_free(struct inode
*inode
, struct file
*f
)
158 struct snd_compr_file
*data
= f
->private_data
;
159 struct snd_compr_runtime
*runtime
= data
->stream
.runtime
;
161 cancel_delayed_work_sync(&data
->stream
.error_work
);
163 switch (runtime
->state
) {
164 case SNDRV_PCM_STATE_RUNNING
:
165 case SNDRV_PCM_STATE_DRAINING
:
166 case SNDRV_PCM_STATE_PAUSED
:
167 data
->stream
.ops
->trigger(&data
->stream
, SNDRV_PCM_TRIGGER_STOP
);
173 data
->stream
.ops
->free(&data
->stream
);
174 kfree(data
->stream
.runtime
->buffer
);
175 kfree(data
->stream
.runtime
);
180 static int snd_compr_update_tstamp(struct snd_compr_stream
*stream
,
181 struct snd_compr_tstamp
*tstamp
)
183 if (!stream
->ops
->pointer
)
185 stream
->ops
->pointer(stream
, tstamp
);
186 pr_debug("dsp consumed till %d total %d bytes\n",
187 tstamp
->byte_offset
, tstamp
->copied_total
);
188 if (stream
->direction
== SND_COMPRESS_PLAYBACK
)
189 stream
->runtime
->total_bytes_transferred
= tstamp
->copied_total
;
191 stream
->runtime
->total_bytes_available
= tstamp
->copied_total
;
195 static size_t snd_compr_calc_avail(struct snd_compr_stream
*stream
,
196 struct snd_compr_avail
*avail
)
198 memset(avail
, 0, sizeof(*avail
));
199 snd_compr_update_tstamp(stream
, &avail
->tstamp
);
200 /* Still need to return avail even if tstamp can't be filled in */
202 if (stream
->runtime
->total_bytes_available
== 0 &&
203 stream
->runtime
->state
== SNDRV_PCM_STATE_SETUP
&&
204 stream
->direction
== SND_COMPRESS_PLAYBACK
) {
205 pr_debug("detected init and someone forgot to do a write\n");
206 return stream
->runtime
->buffer_size
;
208 pr_debug("app wrote %lld, DSP consumed %lld\n",
209 stream
->runtime
->total_bytes_available
,
210 stream
->runtime
->total_bytes_transferred
);
211 if (stream
->runtime
->total_bytes_available
==
212 stream
->runtime
->total_bytes_transferred
) {
213 if (stream
->direction
== SND_COMPRESS_PLAYBACK
) {
214 pr_debug("both pointers are same, returning full avail\n");
215 return stream
->runtime
->buffer_size
;
217 pr_debug("both pointers are same, returning no avail\n");
222 avail
->avail
= stream
->runtime
->total_bytes_available
-
223 stream
->runtime
->total_bytes_transferred
;
224 if (stream
->direction
== SND_COMPRESS_PLAYBACK
)
225 avail
->avail
= stream
->runtime
->buffer_size
- avail
->avail
;
227 pr_debug("ret avail as %lld\n", avail
->avail
);
231 static inline size_t snd_compr_get_avail(struct snd_compr_stream
*stream
)
233 struct snd_compr_avail avail
;
235 return snd_compr_calc_avail(stream
, &avail
);
239 snd_compr_ioctl_avail(struct snd_compr_stream
*stream
, unsigned long arg
)
241 struct snd_compr_avail ioctl_avail
;
244 avail
= snd_compr_calc_avail(stream
, &ioctl_avail
);
245 ioctl_avail
.avail
= avail
;
247 switch (stream
->runtime
->state
) {
248 case SNDRV_PCM_STATE_OPEN
:
250 case SNDRV_PCM_STATE_XRUN
:
256 if (copy_to_user((__u64 __user
*)arg
,
257 &ioctl_avail
, sizeof(ioctl_avail
)))
262 static int snd_compr_write_data(struct snd_compr_stream
*stream
,
263 const char __user
*buf
, size_t count
)
267 struct snd_compr_runtime
*runtime
= stream
->runtime
;
269 u64 app_pointer
= div64_u64(runtime
->total_bytes_available
,
270 runtime
->buffer_size
);
271 app_pointer
= runtime
->total_bytes_available
-
272 (app_pointer
* runtime
->buffer_size
);
274 dstn
= runtime
->buffer
+ app_pointer
;
275 pr_debug("copying %ld at %lld\n",
276 (unsigned long)count
, app_pointer
);
277 if (count
< runtime
->buffer_size
- app_pointer
) {
278 if (copy_from_user(dstn
, buf
, count
))
281 copy
= runtime
->buffer_size
- app_pointer
;
282 if (copy_from_user(dstn
, buf
, copy
))
284 if (copy_from_user(runtime
->buffer
, buf
+ copy
, count
- copy
))
287 /* if DSP cares, let it know data has been written */
288 if (stream
->ops
->ack
)
289 stream
->ops
->ack(stream
, count
);
293 static ssize_t
snd_compr_write(struct file
*f
, const char __user
*buf
,
294 size_t count
, loff_t
*offset
)
296 struct snd_compr_file
*data
= f
->private_data
;
297 struct snd_compr_stream
*stream
;
301 if (snd_BUG_ON(!data
))
304 stream
= &data
->stream
;
305 mutex_lock(&stream
->device
->lock
);
306 /* write is allowed when stream is running or has been steup */
307 switch (stream
->runtime
->state
) {
308 case SNDRV_PCM_STATE_SETUP
:
309 case SNDRV_PCM_STATE_PREPARED
:
310 case SNDRV_PCM_STATE_RUNNING
:
313 mutex_unlock(&stream
->device
->lock
);
317 avail
= snd_compr_get_avail(stream
);
318 pr_debug("avail returned %ld\n", (unsigned long)avail
);
319 /* calculate how much we can write to buffer */
323 if (stream
->ops
->copy
) {
324 char __user
* cbuf
= (char __user
*)buf
;
325 retval
= stream
->ops
->copy(stream
, cbuf
, avail
);
327 retval
= snd_compr_write_data(stream
, buf
, avail
);
330 stream
->runtime
->total_bytes_available
+= retval
;
332 /* while initiating the stream, write should be called before START
333 * call, so in setup move state */
334 if (stream
->runtime
->state
== SNDRV_PCM_STATE_SETUP
) {
335 stream
->runtime
->state
= SNDRV_PCM_STATE_PREPARED
;
336 pr_debug("stream prepared, Houston we are good to go\n");
339 mutex_unlock(&stream
->device
->lock
);
344 static ssize_t
snd_compr_read(struct file
*f
, char __user
*buf
,
345 size_t count
, loff_t
*offset
)
347 struct snd_compr_file
*data
= f
->private_data
;
348 struct snd_compr_stream
*stream
;
352 if (snd_BUG_ON(!data
))
355 stream
= &data
->stream
;
356 mutex_lock(&stream
->device
->lock
);
358 /* read is allowed when stream is running, paused, draining and setup
359 * (yes setup is state which we transition to after stop, so if user
360 * wants to read data after stop we allow that)
362 switch (stream
->runtime
->state
) {
363 case SNDRV_PCM_STATE_OPEN
:
364 case SNDRV_PCM_STATE_PREPARED
:
365 case SNDRV_PCM_STATE_SUSPENDED
:
366 case SNDRV_PCM_STATE_DISCONNECTED
:
369 case SNDRV_PCM_STATE_XRUN
:
374 avail
= snd_compr_get_avail(stream
);
375 pr_debug("avail returned %ld\n", (unsigned long)avail
);
376 /* calculate how much we can read from buffer */
380 if (stream
->ops
->copy
) {
381 retval
= stream
->ops
->copy(stream
, buf
, avail
);
387 stream
->runtime
->total_bytes_transferred
+= retval
;
390 mutex_unlock(&stream
->device
->lock
);
394 static int snd_compr_mmap(struct file
*f
, struct vm_area_struct
*vma
)
399 static inline int snd_compr_get_poll(struct snd_compr_stream
*stream
)
401 if (stream
->direction
== SND_COMPRESS_PLAYBACK
)
402 return POLLOUT
| POLLWRNORM
;
404 return POLLIN
| POLLRDNORM
;
407 static unsigned int snd_compr_poll(struct file
*f
, poll_table
*wait
)
409 struct snd_compr_file
*data
= f
->private_data
;
410 struct snd_compr_stream
*stream
;
414 if (snd_BUG_ON(!data
))
417 stream
= &data
->stream
;
419 mutex_lock(&stream
->device
->lock
);
421 switch (stream
->runtime
->state
) {
422 case SNDRV_PCM_STATE_OPEN
:
423 case SNDRV_PCM_STATE_XRUN
:
424 retval
= snd_compr_get_poll(stream
) | POLLERR
;
430 poll_wait(f
, &stream
->runtime
->sleep
, wait
);
432 avail
= snd_compr_get_avail(stream
);
433 pr_debug("avail is %ld\n", (unsigned long)avail
);
434 /* check if we have at least one fragment to fill */
435 switch (stream
->runtime
->state
) {
436 case SNDRV_PCM_STATE_DRAINING
:
437 /* stream has been woken up after drain is complete
438 * draining done so set stream state to stopped
440 retval
= snd_compr_get_poll(stream
);
441 stream
->runtime
->state
= SNDRV_PCM_STATE_SETUP
;
443 case SNDRV_PCM_STATE_RUNNING
:
444 case SNDRV_PCM_STATE_PREPARED
:
445 case SNDRV_PCM_STATE_PAUSED
:
446 if (avail
>= stream
->runtime
->fragment_size
)
447 retval
= snd_compr_get_poll(stream
);
450 retval
= snd_compr_get_poll(stream
) | POLLERR
;
454 mutex_unlock(&stream
->device
->lock
);
459 snd_compr_get_caps(struct snd_compr_stream
*stream
, unsigned long arg
)
462 struct snd_compr_caps caps
;
464 if (!stream
->ops
->get_caps
)
467 memset(&caps
, 0, sizeof(caps
));
468 retval
= stream
->ops
->get_caps(stream
, &caps
);
471 if (copy_to_user((void __user
*)arg
, &caps
, sizeof(caps
)))
477 #ifndef COMPR_CODEC_CAPS_OVERFLOW
479 snd_compr_get_codec_caps(struct snd_compr_stream
*stream
, unsigned long arg
)
482 struct snd_compr_codec_caps
*caps
;
484 if (!stream
->ops
->get_codec_caps
)
487 caps
= kzalloc(sizeof(*caps
), GFP_KERNEL
);
491 retval
= stream
->ops
->get_codec_caps(stream
, caps
);
494 if (copy_to_user((void __user
*)arg
, caps
, sizeof(*caps
)))
501 #endif /* !COMPR_CODEC_CAPS_OVERFLOW */
503 /* revisit this with snd_pcm_preallocate_xxx */
504 static int snd_compr_allocate_buffer(struct snd_compr_stream
*stream
,
505 struct snd_compr_params
*params
)
507 unsigned int buffer_size
;
510 buffer_size
= params
->buffer
.fragment_size
* params
->buffer
.fragments
;
511 if (stream
->ops
->copy
) {
513 /* if copy is defined the driver will be required to copy
517 buffer
= kmalloc(buffer_size
, GFP_KERNEL
);
521 stream
->runtime
->fragment_size
= params
->buffer
.fragment_size
;
522 stream
->runtime
->fragments
= params
->buffer
.fragments
;
523 stream
->runtime
->buffer
= buffer
;
524 stream
->runtime
->buffer_size
= buffer_size
;
528 static int snd_compress_check_input(struct snd_compr_params
*params
)
530 /* first let's check the buffer parameter's */
531 if (params
->buffer
.fragment_size
== 0 ||
532 params
->buffer
.fragments
> INT_MAX
/ params
->buffer
.fragment_size
)
535 /* now codec parameters */
536 if (params
->codec
.id
== 0 || params
->codec
.id
> SND_AUDIOCODEC_MAX
)
539 if (params
->codec
.ch_in
== 0 || params
->codec
.ch_out
== 0)
546 snd_compr_set_params(struct snd_compr_stream
*stream
, unsigned long arg
)
548 struct snd_compr_params
*params
;
551 if (stream
->runtime
->state
== SNDRV_PCM_STATE_OPEN
) {
553 * we should allow parameter change only when stream has been
554 * opened not in other cases
556 params
= kmalloc(sizeof(*params
), GFP_KERNEL
);
559 if (copy_from_user(params
, (void __user
*)arg
, sizeof(*params
))) {
564 retval
= snd_compress_check_input(params
);
568 retval
= snd_compr_allocate_buffer(stream
, params
);
574 retval
= stream
->ops
->set_params(stream
, params
);
578 stream
->metadata_set
= false;
579 stream
->next_track
= false;
581 if (stream
->direction
== SND_COMPRESS_PLAYBACK
)
582 stream
->runtime
->state
= SNDRV_PCM_STATE_SETUP
;
584 stream
->runtime
->state
= SNDRV_PCM_STATE_PREPARED
;
594 snd_compr_get_params(struct snd_compr_stream
*stream
, unsigned long arg
)
596 struct snd_codec
*params
;
599 if (!stream
->ops
->get_params
)
602 params
= kzalloc(sizeof(*params
), GFP_KERNEL
);
605 retval
= stream
->ops
->get_params(stream
, params
);
608 if (copy_to_user((char __user
*)arg
, params
, sizeof(*params
)))
617 snd_compr_get_metadata(struct snd_compr_stream
*stream
, unsigned long arg
)
619 struct snd_compr_metadata metadata
;
622 if (!stream
->ops
->get_metadata
)
625 if (copy_from_user(&metadata
, (void __user
*)arg
, sizeof(metadata
)))
628 retval
= stream
->ops
->get_metadata(stream
, &metadata
);
632 if (copy_to_user((void __user
*)arg
, &metadata
, sizeof(metadata
)))
639 snd_compr_set_metadata(struct snd_compr_stream
*stream
, unsigned long arg
)
641 struct snd_compr_metadata metadata
;
644 if (!stream
->ops
->set_metadata
)
647 * we should allow parameter change only when stream has been
648 * opened not in other cases
650 if (copy_from_user(&metadata
, (void __user
*)arg
, sizeof(metadata
)))
653 retval
= stream
->ops
->set_metadata(stream
, &metadata
);
654 stream
->metadata_set
= true;
660 snd_compr_tstamp(struct snd_compr_stream
*stream
, unsigned long arg
)
662 struct snd_compr_tstamp tstamp
= {0};
665 ret
= snd_compr_update_tstamp(stream
, &tstamp
);
667 ret
= copy_to_user((struct snd_compr_tstamp __user
*)arg
,
668 &tstamp
, sizeof(tstamp
)) ? -EFAULT
: 0;
672 static int snd_compr_pause(struct snd_compr_stream
*stream
)
676 if (stream
->runtime
->state
!= SNDRV_PCM_STATE_RUNNING
)
678 retval
= stream
->ops
->trigger(stream
, SNDRV_PCM_TRIGGER_PAUSE_PUSH
);
680 stream
->runtime
->state
= SNDRV_PCM_STATE_PAUSED
;
684 static int snd_compr_resume(struct snd_compr_stream
*stream
)
688 if (stream
->runtime
->state
!= SNDRV_PCM_STATE_PAUSED
)
690 retval
= stream
->ops
->trigger(stream
, SNDRV_PCM_TRIGGER_PAUSE_RELEASE
);
692 stream
->runtime
->state
= SNDRV_PCM_STATE_RUNNING
;
696 static int snd_compr_start(struct snd_compr_stream
*stream
)
700 if (stream
->runtime
->state
!= SNDRV_PCM_STATE_PREPARED
)
702 retval
= stream
->ops
->trigger(stream
, SNDRV_PCM_TRIGGER_START
);
704 stream
->runtime
->state
= SNDRV_PCM_STATE_RUNNING
;
708 static int snd_compr_stop(struct snd_compr_stream
*stream
)
712 if (stream
->runtime
->state
== SNDRV_PCM_STATE_PREPARED
||
713 stream
->runtime
->state
== SNDRV_PCM_STATE_SETUP
)
715 retval
= stream
->ops
->trigger(stream
, SNDRV_PCM_TRIGGER_STOP
);
717 snd_compr_drain_notify(stream
);
718 stream
->runtime
->total_bytes_available
= 0;
719 stream
->runtime
->total_bytes_transferred
= 0;
724 static void error_delayed_work(struct work_struct
*work
)
726 struct snd_compr_stream
*stream
;
728 stream
= container_of(work
, struct snd_compr_stream
, error_work
.work
);
730 mutex_lock(&stream
->device
->lock
);
732 stream
->ops
->trigger(stream
, SNDRV_PCM_TRIGGER_STOP
);
733 wake_up(&stream
->runtime
->sleep
);
735 mutex_unlock(&stream
->device
->lock
);
739 * snd_compr_stop_error: Report a fatal error on a stream
740 * @stream: pointer to stream
741 * @state: state to transition the stream to
743 * Stop the stream and set its state.
745 * Should be called with compressed device lock held.
747 int snd_compr_stop_error(struct snd_compr_stream
*stream
,
748 snd_pcm_state_t state
)
750 if (stream
->runtime
->state
== state
)
753 stream
->runtime
->state
= state
;
755 pr_debug("Changing state to: %d\n", state
);
757 queue_delayed_work(system_power_efficient_wq
, &stream
->error_work
, 0);
761 EXPORT_SYMBOL_GPL(snd_compr_stop_error
);
763 static int snd_compress_wait_for_drain(struct snd_compr_stream
*stream
)
768 * We are called with lock held. So drop the lock while we wait for
769 * drain complete notification from the driver
771 * It is expected that driver will notify the drain completion and then
772 * stream will be moved to SETUP state, even if draining resulted in an
773 * error. We can trigger next track after this.
775 stream
->runtime
->state
= SNDRV_PCM_STATE_DRAINING
;
776 mutex_unlock(&stream
->device
->lock
);
778 /* we wait for drain to complete here, drain can return when
779 * interruption occurred, wait returned error or success.
780 * For the first two cases we don't do anything different here and
781 * return after waking up
784 ret
= wait_event_interruptible(stream
->runtime
->sleep
,
785 (stream
->runtime
->state
!= SNDRV_PCM_STATE_DRAINING
));
786 if (ret
== -ERESTARTSYS
)
787 pr_debug("wait aborted by a signal");
789 pr_debug("wait for drain failed with %d\n", ret
);
792 wake_up(&stream
->runtime
->sleep
);
793 mutex_lock(&stream
->device
->lock
);
798 static int snd_compr_drain(struct snd_compr_stream
*stream
)
802 if (stream
->runtime
->state
== SNDRV_PCM_STATE_PREPARED
||
803 stream
->runtime
->state
== SNDRV_PCM_STATE_SETUP
)
806 retval
= stream
->ops
->trigger(stream
, SND_COMPR_TRIGGER_DRAIN
);
808 pr_debug("SND_COMPR_TRIGGER_DRAIN failed %d\n", retval
);
809 wake_up(&stream
->runtime
->sleep
);
813 return snd_compress_wait_for_drain(stream
);
816 static int snd_compr_next_track(struct snd_compr_stream
*stream
)
820 /* only a running stream can transition to next track */
821 if (stream
->runtime
->state
!= SNDRV_PCM_STATE_RUNNING
)
824 /* you can signal next track if this is intended to be a gapless stream
825 * and current track metadata is set
827 if (stream
->metadata_set
== false)
830 retval
= stream
->ops
->trigger(stream
, SND_COMPR_TRIGGER_NEXT_TRACK
);
833 stream
->metadata_set
= false;
834 stream
->next_track
= true;
838 static int snd_compr_partial_drain(struct snd_compr_stream
*stream
)
841 if (stream
->runtime
->state
== SNDRV_PCM_STATE_PREPARED
||
842 stream
->runtime
->state
== SNDRV_PCM_STATE_SETUP
)
844 /* stream can be drained only when next track has been signalled */
845 if (stream
->next_track
== false)
848 retval
= stream
->ops
->trigger(stream
, SND_COMPR_TRIGGER_PARTIAL_DRAIN
);
850 pr_debug("Partial drain returned failure\n");
851 wake_up(&stream
->runtime
->sleep
);
855 stream
->next_track
= false;
856 return snd_compress_wait_for_drain(stream
);
859 static long snd_compr_ioctl(struct file
*f
, unsigned int cmd
, unsigned long arg
)
861 struct snd_compr_file
*data
= f
->private_data
;
862 struct snd_compr_stream
*stream
;
863 int retval
= -ENOTTY
;
865 if (snd_BUG_ON(!data
))
868 stream
= &data
->stream
;
870 mutex_lock(&stream
->device
->lock
);
871 switch (_IOC_NR(cmd
)) {
872 case _IOC_NR(SNDRV_COMPRESS_IOCTL_VERSION
):
873 retval
= put_user(SNDRV_COMPRESS_VERSION
,
874 (int __user
*)arg
) ? -EFAULT
: 0;
876 case _IOC_NR(SNDRV_COMPRESS_GET_CAPS
):
877 retval
= snd_compr_get_caps(stream
, arg
);
879 #ifndef COMPR_CODEC_CAPS_OVERFLOW
880 case _IOC_NR(SNDRV_COMPRESS_GET_CODEC_CAPS
):
881 retval
= snd_compr_get_codec_caps(stream
, arg
);
884 case _IOC_NR(SNDRV_COMPRESS_SET_PARAMS
):
885 retval
= snd_compr_set_params(stream
, arg
);
887 case _IOC_NR(SNDRV_COMPRESS_GET_PARAMS
):
888 retval
= snd_compr_get_params(stream
, arg
);
890 case _IOC_NR(SNDRV_COMPRESS_SET_METADATA
):
891 retval
= snd_compr_set_metadata(stream
, arg
);
893 case _IOC_NR(SNDRV_COMPRESS_GET_METADATA
):
894 retval
= snd_compr_get_metadata(stream
, arg
);
896 case _IOC_NR(SNDRV_COMPRESS_TSTAMP
):
897 retval
= snd_compr_tstamp(stream
, arg
);
899 case _IOC_NR(SNDRV_COMPRESS_AVAIL
):
900 retval
= snd_compr_ioctl_avail(stream
, arg
);
902 case _IOC_NR(SNDRV_COMPRESS_PAUSE
):
903 retval
= snd_compr_pause(stream
);
905 case _IOC_NR(SNDRV_COMPRESS_RESUME
):
906 retval
= snd_compr_resume(stream
);
908 case _IOC_NR(SNDRV_COMPRESS_START
):
909 retval
= snd_compr_start(stream
);
911 case _IOC_NR(SNDRV_COMPRESS_STOP
):
912 retval
= snd_compr_stop(stream
);
914 case _IOC_NR(SNDRV_COMPRESS_DRAIN
):
915 retval
= snd_compr_drain(stream
);
917 case _IOC_NR(SNDRV_COMPRESS_PARTIAL_DRAIN
):
918 retval
= snd_compr_partial_drain(stream
);
920 case _IOC_NR(SNDRV_COMPRESS_NEXT_TRACK
):
921 retval
= snd_compr_next_track(stream
);
925 mutex_unlock(&stream
->device
->lock
);
929 /* support of 32bit userspace on 64bit platforms */
931 static long snd_compr_ioctl_compat(struct file
*file
, unsigned int cmd
,
934 return snd_compr_ioctl(file
, cmd
, (unsigned long)compat_ptr(arg
));
938 static const struct file_operations snd_compr_file_ops
= {
939 .owner
= THIS_MODULE
,
940 .open
= snd_compr_open
,
941 .release
= snd_compr_free
,
942 .write
= snd_compr_write
,
943 .read
= snd_compr_read
,
944 .unlocked_ioctl
= snd_compr_ioctl
,
946 .compat_ioctl
= snd_compr_ioctl_compat
,
948 .mmap
= snd_compr_mmap
,
949 .poll
= snd_compr_poll
,
952 static int snd_compress_dev_register(struct snd_device
*device
)
956 struct snd_compr
*compr
;
958 if (snd_BUG_ON(!device
|| !device
->device_data
))
960 compr
= device
->device_data
;
962 pr_debug("reg %s for device %s, direction %d\n", str
, compr
->name
,
964 /* register compressed device */
965 ret
= snd_register_device(SNDRV_DEVICE_TYPE_COMPRESS
,
966 compr
->card
, compr
->device
,
967 &snd_compr_file_ops
, compr
, &compr
->dev
);
969 pr_err("snd_register_device failed\n %d", ret
);
976 static int snd_compress_dev_disconnect(struct snd_device
*device
)
978 struct snd_compr
*compr
;
980 compr
= device
->device_data
;
981 snd_unregister_device(&compr
->dev
);
985 #ifdef CONFIG_SND_VERBOSE_PROCFS
986 static void snd_compress_proc_info_read(struct snd_info_entry
*entry
,
987 struct snd_info_buffer
*buffer
)
989 struct snd_compr
*compr
= (struct snd_compr
*)entry
->private_data
;
991 snd_iprintf(buffer
, "card: %d\n", compr
->card
->number
);
992 snd_iprintf(buffer
, "device: %d\n", compr
->device
);
993 snd_iprintf(buffer
, "stream: %s\n",
994 compr
->direction
== SND_COMPRESS_PLAYBACK
995 ? "PLAYBACK" : "CAPTURE");
996 snd_iprintf(buffer
, "id: %s\n", compr
->id
);
999 static int snd_compress_proc_init(struct snd_compr
*compr
)
1001 struct snd_info_entry
*entry
;
1004 sprintf(name
, "compr%i", compr
->device
);
1005 entry
= snd_info_create_card_entry(compr
->card
, name
,
1006 compr
->card
->proc_root
);
1009 entry
->mode
= S_IFDIR
| S_IRUGO
| S_IXUGO
;
1010 if (snd_info_register(entry
) < 0) {
1011 snd_info_free_entry(entry
);
1014 compr
->proc_root
= entry
;
1016 entry
= snd_info_create_card_entry(compr
->card
, "info",
1019 snd_info_set_text_ops(entry
, compr
,
1020 snd_compress_proc_info_read
);
1021 if (snd_info_register(entry
) < 0) {
1022 snd_info_free_entry(entry
);
1026 compr
->proc_info_entry
= entry
;
1031 static void snd_compress_proc_done(struct snd_compr
*compr
)
1033 snd_info_free_entry(compr
->proc_info_entry
);
1034 compr
->proc_info_entry
= NULL
;
1035 snd_info_free_entry(compr
->proc_root
);
1036 compr
->proc_root
= NULL
;
1039 static inline void snd_compress_set_id(struct snd_compr
*compr
, const char *id
)
1041 strlcpy(compr
->id
, id
, sizeof(compr
->id
));
1044 static inline int snd_compress_proc_init(struct snd_compr
*compr
)
1049 static inline void snd_compress_proc_done(struct snd_compr
*compr
)
1053 static inline void snd_compress_set_id(struct snd_compr
*compr
, const char *id
)
1058 static int snd_compress_dev_free(struct snd_device
*device
)
1060 struct snd_compr
*compr
;
1062 compr
= device
->device_data
;
1063 snd_compress_proc_done(compr
);
1064 put_device(&compr
->dev
);
1069 * snd_compress_new: create new compress device
1070 * @card: sound card pointer
1071 * @device: device number
1072 * @dirn: device direction, should be of type enum snd_compr_direction
1073 * @compr: compress device pointer
1075 int snd_compress_new(struct snd_card
*card
, int device
,
1076 int dirn
, const char *id
, struct snd_compr
*compr
)
1078 static struct snd_device_ops ops
= {
1079 .dev_free
= snd_compress_dev_free
,
1080 .dev_register
= snd_compress_dev_register
,
1081 .dev_disconnect
= snd_compress_dev_disconnect
,
1086 compr
->device
= device
;
1087 compr
->direction
= dirn
;
1089 snd_compress_set_id(compr
, id
);
1091 snd_device_initialize(&compr
->dev
, card
);
1092 dev_set_name(&compr
->dev
, "comprC%iD%i", card
->number
, device
);
1094 ret
= snd_device_new(card
, SNDRV_DEV_COMPRESS
, compr
, &ops
);
1096 snd_compress_proc_init(compr
);
1100 EXPORT_SYMBOL_GPL(snd_compress_new
);
1102 static int snd_compress_add_device(struct snd_compr
*device
)
1109 /* register the card */
1110 ret
= snd_card_register(device
->card
);
1116 pr_err("failed with %d\n", ret
);
1121 static int snd_compress_remove_device(struct snd_compr
*device
)
1123 return snd_card_free(device
->card
);
1127 * snd_compress_register - register compressed device
1129 * @device: compressed device to register
1131 int snd_compress_register(struct snd_compr
*device
)
1135 if (device
->name
== NULL
|| device
->ops
== NULL
)
1138 pr_debug("Registering compressed device %s\n", device
->name
);
1139 if (snd_BUG_ON(!device
->ops
->open
))
1141 if (snd_BUG_ON(!device
->ops
->free
))
1143 if (snd_BUG_ON(!device
->ops
->set_params
))
1145 if (snd_BUG_ON(!device
->ops
->trigger
))
1148 mutex_init(&device
->lock
);
1150 /* register a compressed card */
1151 mutex_lock(&device_mutex
);
1152 retval
= snd_compress_add_device(device
);
1153 mutex_unlock(&device_mutex
);
1156 EXPORT_SYMBOL_GPL(snd_compress_register
);
1158 int snd_compress_deregister(struct snd_compr
*device
)
1160 pr_debug("Removing compressed device %s\n", device
->name
);
1161 mutex_lock(&device_mutex
);
1162 snd_compress_remove_device(device
);
1163 mutex_unlock(&device_mutex
);
1166 EXPORT_SYMBOL_GPL(snd_compress_deregister
);
1168 static int __init
snd_compress_init(void)
1173 static void __exit
snd_compress_exit(void)
1177 module_init(snd_compress_init
);
1178 module_exit(snd_compress_exit
);
1180 MODULE_DESCRIPTION("ALSA Compressed offload framework");
1181 MODULE_AUTHOR("Vinod Koul <vinod.koul@linux.intel.com>");
1182 MODULE_LICENSE("GPL v2");