hc
2024-10-22 8ac6c7a54ed1b98d142dce24b11c6de6a1e239a5
kernel/sound/soc/intel/atom/sst/sst_stream.c
....@@ -1,3 +1,4 @@
1
+// SPDX-License-Identifier: GPL-2.0-only
12 /*
23 * sst_stream.c - Intel SST Driver for audio engine
34 *
....@@ -7,15 +8,6 @@
78 * Dharageswari R <dharageswari.r@intel.com>
89 * KP Jeeja <jeeja.kp@intel.com>
910 * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
10
- *
11
- * This program is free software; you can redistribute it and/or modify
12
- * it under the terms of the GNU General Public License as published by
13
- * the Free Software Foundation; version 2 of the License.
14
- *
15
- * This program is distributed in the hope that it will be useful, but
16
- * WITHOUT ANY WARRANTY; without even the implied warranty of
17
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
18
- * General Public License for more details.
1911 *
2012 * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
2113 */
....@@ -31,7 +23,6 @@
3123 #include <asm/platform_sst_audio.h>
3224 #include "../sst-mfld-platform.h"
3325 #include "sst.h"
34
-#include "../../common/sst-dsp.h"
3526
3627 int sst_alloc_stream_mrfld(struct intel_sst_drv *sst_drv_ctx, void *params)
3728 {
....@@ -100,8 +91,8 @@
10091
10192 /**
10293 * sst_realloc_stream - Send msg for (re-)allocating a stream using the
103
- * @sst_drv_ctx intel_sst_drv context pointer
104
- * @str_id: stream ID
94
+ * @sst_drv_ctx: intel_sst_drv context pointer
95
+ * @str_id: stream ID
10596 *
10697 * Send a msg for (re-)allocating a stream using the parameters previously
10798 * passed to sst_alloc_stream_mrfld() for the same stream ID.
....@@ -150,12 +141,13 @@
150141 }
151142
152143 /**
153
-* sst_start_stream - Send msg for a starting stream
154
-* @str_id: stream ID
155
-*
156
-* This function is called by any function which wants to start
157
-* a stream.
158
-*/
144
+ * sst_start_stream - Send msg for a starting stream
145
+ * @sst_drv_ctx: intel_sst_drv context pointer
146
+ * @str_id: stream ID
147
+ *
148
+ * This function is called by any function which wants to start
149
+ * a stream.
150
+ */
159151 int sst_start_stream(struct intel_sst_drv *sst_drv_ctx, int str_id)
160152 {
161153 int retval = 0;
....@@ -242,7 +234,8 @@
242234
243235 /**
244236 * sst_pause_stream - Send msg for a pausing stream
245
- * @str_id: stream ID
237
+ * @sst_drv_ctx: intel_sst_drv context pointer
238
+ * @str_id: stream ID
246239 *
247240 * This function is called by any function which wants to pause
248241 * an already running stream.
....@@ -286,7 +279,8 @@
286279
287280 /**
288281 * sst_resume_stream - Send msg for resuming stream
289
- * @str_id: stream ID
282
+ * @sst_drv_ctx: intel_sst_drv context pointer
283
+ * @str_id: stream ID
290284 *
291285 * This function is called by any function which wants to resume
292286 * an already paused stream.
....@@ -353,7 +347,8 @@
353347
354348 /**
355349 * sst_drop_stream - Send msg for stopping stream
356
- * @str_id: stream ID
350
+ * @sst_drv_ctx: intel_sst_drv context pointer
351
+ * @str_id: stream ID
357352 *
358353 * This function is called by any function which wants to stop
359354 * a stream.
....@@ -385,12 +380,14 @@
385380 }
386381
387382 /**
388
-* sst_drain_stream - Send msg for draining stream
389
-* @str_id: stream ID
390
-*
391
-* This function is called by any function which wants to drain
392
-* a stream.
393
-*/
383
+ * sst_drain_stream - Send msg for draining stream
384
+ * @sst_drv_ctx: intel_sst_drv context pointer
385
+ * @str_id: stream ID
386
+ * @partial_drain: boolean indicating if a gapless transition is taking place
387
+ *
388
+ * This function is called by any function which wants to drain
389
+ * a stream.
390
+ */
394391 int sst_drain_stream(struct intel_sst_drv *sst_drv_ctx,
395392 int str_id, bool partial_drain)
396393 {
....@@ -423,7 +420,8 @@
423420
424421 /**
425422 * sst_free_stream - Frees a stream
426
- * @str_id: stream ID
423
+ * @sst_drv_ctx: intel_sst_drv context pointer
424
+ * @str_id: stream ID
427425 *
428426 * This function is called by any function which wants to free
429427 * a stream.