Loading...
1// SPDX-License-Identifier: GPL-2.0-or-later
2/*
3 * dsp_pipeline.c: pipelined audio processing
4 *
5 * Copyright (C) 2007, Nadi Sarrar
6 *
7 * Nadi Sarrar <nadi@beronet.com>
8 */
9
10#include <linux/kernel.h>
11#include <linux/slab.h>
12#include <linux/list.h>
13#include <linux/string.h>
14#include <linux/mISDNif.h>
15#include <linux/mISDNdsp.h>
16#include <linux/export.h>
17#include "dsp.h"
18#include "dsp_hwec.h"
19
20struct dsp_pipeline_entry {
21 struct mISDN_dsp_element *elem;
22 void *p;
23 struct list_head list;
24};
25struct dsp_element_entry {
26 struct mISDN_dsp_element *elem;
27 struct device dev;
28 struct list_head list;
29};
30
31static LIST_HEAD(dsp_elements);
32
33/* sysfs */
34static const struct class elements_class = {
35 .name = "dsp_pipeline",
36};
37
38static ssize_t
39attr_show_args(struct device *dev, struct device_attribute *attr, char *buf)
40{
41 struct mISDN_dsp_element *elem = dev_get_drvdata(dev);
42 int i;
43 char *p = buf;
44
45 *buf = 0;
46 for (i = 0; i < elem->num_args; i++)
47 p += sprintf(p, "Name: %s\n%s%s%sDescription: %s\n\n",
48 elem->args[i].name,
49 elem->args[i].def ? "Default: " : "",
50 elem->args[i].def ? elem->args[i].def : "",
51 elem->args[i].def ? "\n" : "",
52 elem->args[i].desc);
53
54 return p - buf;
55}
56
57static struct device_attribute element_attributes[] = {
58 __ATTR(args, 0444, attr_show_args, NULL),
59};
60
61static void
62mISDN_dsp_dev_release(struct device *dev)
63{
64 struct dsp_element_entry *entry =
65 container_of(dev, struct dsp_element_entry, dev);
66 list_del(&entry->list);
67 kfree(entry);
68}
69
70int mISDN_dsp_element_register(struct mISDN_dsp_element *elem)
71{
72 struct dsp_element_entry *entry;
73 int ret, i;
74
75 if (!elem)
76 return -EINVAL;
77
78 entry = kzalloc(sizeof(struct dsp_element_entry), GFP_ATOMIC);
79 if (!entry)
80 return -ENOMEM;
81
82 INIT_LIST_HEAD(&entry->list);
83 entry->elem = elem;
84
85 entry->dev.class = &elements_class;
86 entry->dev.release = mISDN_dsp_dev_release;
87 dev_set_drvdata(&entry->dev, elem);
88 dev_set_name(&entry->dev, "%s", elem->name);
89 ret = device_register(&entry->dev);
90 if (ret) {
91 printk(KERN_ERR "%s: failed to register %s\n",
92 __func__, elem->name);
93 goto err1;
94 }
95 list_add_tail(&entry->list, &dsp_elements);
96
97 for (i = 0; i < ARRAY_SIZE(element_attributes); ++i) {
98 ret = device_create_file(&entry->dev,
99 &element_attributes[i]);
100 if (ret) {
101 printk(KERN_ERR "%s: failed to create device file\n",
102 __func__);
103 goto err2;
104 }
105 }
106
107 return 0;
108
109err2:
110 device_unregister(&entry->dev);
111 return ret;
112err1:
113 put_device(&entry->dev);
114 return ret;
115}
116EXPORT_SYMBOL(mISDN_dsp_element_register);
117
118void mISDN_dsp_element_unregister(struct mISDN_dsp_element *elem)
119{
120 struct dsp_element_entry *entry, *n;
121
122 if (!elem)
123 return;
124
125 list_for_each_entry_safe(entry, n, &dsp_elements, list)
126 if (entry->elem == elem) {
127 device_unregister(&entry->dev);
128 return;
129 }
130 printk(KERN_ERR "%s: element %s not in list.\n", __func__, elem->name);
131}
132EXPORT_SYMBOL(mISDN_dsp_element_unregister);
133
134int dsp_pipeline_module_init(void)
135{
136 int err;
137
138 err = class_register(&elements_class);
139 if (err)
140 return err;
141
142 dsp_hwec_init();
143
144 return 0;
145}
146
147void dsp_pipeline_module_exit(void)
148{
149 struct dsp_element_entry *entry, *n;
150
151 dsp_hwec_exit();
152
153 class_unregister(&elements_class);
154
155 list_for_each_entry_safe(entry, n, &dsp_elements, list) {
156 list_del(&entry->list);
157 printk(KERN_WARNING "%s: element was still registered: %s\n",
158 __func__, entry->elem->name);
159 kfree(entry);
160 }
161}
162
163int dsp_pipeline_init(struct dsp_pipeline *pipeline)
164{
165 if (!pipeline)
166 return -EINVAL;
167
168 INIT_LIST_HEAD(&pipeline->list);
169
170 return 0;
171}
172
173static inline void _dsp_pipeline_destroy(struct dsp_pipeline *pipeline)
174{
175 struct dsp_pipeline_entry *entry, *n;
176
177 list_for_each_entry_safe(entry, n, &pipeline->list, list) {
178 list_del(&entry->list);
179 if (entry->elem == dsp_hwec)
180 dsp_hwec_disable(container_of(pipeline, struct dsp,
181 pipeline));
182 else
183 entry->elem->free(entry->p);
184 kfree(entry);
185 }
186}
187
188void dsp_pipeline_destroy(struct dsp_pipeline *pipeline)
189{
190
191 if (!pipeline)
192 return;
193
194 _dsp_pipeline_destroy(pipeline);
195}
196
197int dsp_pipeline_build(struct dsp_pipeline *pipeline, const char *cfg)
198{
199 int found = 0;
200 char *dup, *next, *tok, *name, *args;
201 struct dsp_element_entry *entry, *n;
202 struct dsp_pipeline_entry *pipeline_entry;
203 struct mISDN_dsp_element *elem;
204
205 if (!pipeline)
206 return -EINVAL;
207
208 if (!list_empty(&pipeline->list))
209 _dsp_pipeline_destroy(pipeline);
210
211 dup = next = kstrdup(cfg, GFP_ATOMIC);
212 if (!dup)
213 return 0;
214 while ((tok = strsep(&next, "|"))) {
215 if (!strlen(tok))
216 continue;
217 name = strsep(&tok, "(");
218 args = strsep(&tok, ")");
219 if (args && !*args)
220 args = NULL;
221
222 list_for_each_entry_safe(entry, n, &dsp_elements, list)
223 if (!strcmp(entry->elem->name, name)) {
224 elem = entry->elem;
225
226 pipeline_entry = kmalloc(sizeof(struct
227 dsp_pipeline_entry), GFP_ATOMIC);
228 if (!pipeline_entry) {
229 printk(KERN_ERR "%s: failed to add "
230 "entry to pipeline: %s (out of "
231 "memory)\n", __func__, elem->name);
232 goto _out;
233 }
234 pipeline_entry->elem = elem;
235
236 if (elem == dsp_hwec) {
237 /* This is a hack to make the hwec
238 available as a pipeline module */
239 dsp_hwec_enable(container_of(pipeline,
240 struct dsp, pipeline), args);
241 list_add_tail(&pipeline_entry->list,
242 &pipeline->list);
243 } else {
244 pipeline_entry->p = elem->new(args);
245 if (pipeline_entry->p) {
246 list_add_tail(&pipeline_entry->
247 list, &pipeline->list);
248 } else {
249 printk(KERN_ERR "%s: failed "
250 "to add entry to pipeline: "
251 "%s (new() returned NULL)\n",
252 __func__, elem->name);
253 kfree(pipeline_entry);
254 }
255 }
256 found = 1;
257 break;
258 }
259
260 if (found)
261 found = 0;
262 else
263 printk(KERN_ERR "%s: element not found, skipping: "
264 "%s\n", __func__, name);
265 }
266
267_out:
268 if (!list_empty(&pipeline->list))
269 pipeline->inuse = 1;
270 else
271 pipeline->inuse = 0;
272
273 kfree(dup);
274 return 0;
275}
276
277void dsp_pipeline_process_tx(struct dsp_pipeline *pipeline, u8 *data, int len)
278{
279 struct dsp_pipeline_entry *entry;
280
281 if (!pipeline)
282 return;
283
284 list_for_each_entry(entry, &pipeline->list, list)
285 if (entry->elem->process_tx)
286 entry->elem->process_tx(entry->p, data, len);
287}
288
289void dsp_pipeline_process_rx(struct dsp_pipeline *pipeline, u8 *data, int len,
290 unsigned int txlen)
291{
292 struct dsp_pipeline_entry *entry;
293
294 if (!pipeline)
295 return;
296
297 list_for_each_entry_reverse(entry, &pipeline->list, list)
298 if (entry->elem->process_rx)
299 entry->elem->process_rx(entry->p, data, len, txlen);
300}
1/*
2 * dsp_pipeline.c: pipelined audio processing
3 *
4 * Copyright (C) 2007, Nadi Sarrar
5 *
6 * Nadi Sarrar <nadi@beronet.com>
7 *
8 * This program is free software; you can redistribute it and/or modify it
9 * under the terms of the GNU General Public License as published by the Free
10 * Software Foundation; either version 2 of the License, or (at your option)
11 * any later version.
12 *
13 * This program is distributed in the hope that it will be useful, but WITHOUT
14 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
15 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
16 * more details.
17 *
18 * You should have received a copy of the GNU General Public License along with
19 * this program; if not, write to the Free Software Foundation, Inc., 59
20 * Temple Place - Suite 330, Boston, MA 02111-1307, USA.
21 *
22 * The full GNU General Public License is included in this distribution in the
23 * file called LICENSE.
24 *
25 */
26
27#include <linux/kernel.h>
28#include <linux/slab.h>
29#include <linux/list.h>
30#include <linux/string.h>
31#include <linux/mISDNif.h>
32#include <linux/mISDNdsp.h>
33#include "dsp.h"
34#include "dsp_hwec.h"
35
36/* uncomment for debugging */
37/*#define PIPELINE_DEBUG*/
38
39struct dsp_pipeline_entry {
40 struct mISDN_dsp_element *elem;
41 void *p;
42 struct list_head list;
43};
44struct dsp_element_entry {
45 struct mISDN_dsp_element *elem;
46 struct device dev;
47 struct list_head list;
48};
49
50static LIST_HEAD(dsp_elements);
51
52/* sysfs */
53static struct class *elements_class;
54
55static ssize_t
56attr_show_args(struct device *dev, struct device_attribute *attr, char *buf)
57{
58 struct mISDN_dsp_element *elem = dev_get_drvdata(dev);
59 int i;
60 char *p = buf;
61
62 *buf = 0;
63 for (i = 0; i < elem->num_args; i++)
64 p += sprintf(p, "Name: %s\n%s%s%sDescription: %s\n\n",
65 elem->args[i].name,
66 elem->args[i].def ? "Default: " : "",
67 elem->args[i].def ? elem->args[i].def : "",
68 elem->args[i].def ? "\n" : "",
69 elem->args[i].desc);
70
71 return p - buf;
72}
73
74static struct device_attribute element_attributes[] = {
75 __ATTR(args, 0444, attr_show_args, NULL),
76};
77
78static void
79mISDN_dsp_dev_release(struct device *dev)
80{
81 struct dsp_element_entry *entry =
82 container_of(dev, struct dsp_element_entry, dev);
83 list_del(&entry->list);
84 kfree(entry);
85}
86
87int mISDN_dsp_element_register(struct mISDN_dsp_element *elem)
88{
89 struct dsp_element_entry *entry;
90 int ret, i;
91
92 if (!elem)
93 return -EINVAL;
94
95 entry = kzalloc(sizeof(struct dsp_element_entry), GFP_ATOMIC);
96 if (!entry)
97 return -ENOMEM;
98
99 entry->elem = elem;
100
101 entry->dev.class = elements_class;
102 entry->dev.release = mISDN_dsp_dev_release;
103 dev_set_drvdata(&entry->dev, elem);
104 dev_set_name(&entry->dev, elem->name);
105 ret = device_register(&entry->dev);
106 if (ret) {
107 printk(KERN_ERR "%s: failed to register %s\n",
108 __func__, elem->name);
109 goto err1;
110 }
111 list_add_tail(&entry->list, &dsp_elements);
112
113 for (i = 0; i < ARRAY_SIZE(element_attributes); ++i) {
114 ret = device_create_file(&entry->dev,
115 &element_attributes[i]);
116 if (ret) {
117 printk(KERN_ERR "%s: failed to create device file\n",
118 __func__);
119 goto err2;
120 }
121 }
122
123#ifdef PIPELINE_DEBUG
124 printk(KERN_DEBUG "%s: %s registered\n", __func__, elem->name);
125#endif
126
127 return 0;
128
129err2:
130 device_unregister(&entry->dev);
131 return ret;
132err1:
133 kfree(entry);
134 return ret;
135}
136EXPORT_SYMBOL(mISDN_dsp_element_register);
137
138void mISDN_dsp_element_unregister(struct mISDN_dsp_element *elem)
139{
140 struct dsp_element_entry *entry, *n;
141
142 if (!elem)
143 return;
144
145 list_for_each_entry_safe(entry, n, &dsp_elements, list)
146 if (entry->elem == elem) {
147 device_unregister(&entry->dev);
148#ifdef PIPELINE_DEBUG
149 printk(KERN_DEBUG "%s: %s unregistered\n",
150 __func__, elem->name);
151#endif
152 return;
153 }
154 printk(KERN_ERR "%s: element %s not in list.\n", __func__, elem->name);
155}
156EXPORT_SYMBOL(mISDN_dsp_element_unregister);
157
158int dsp_pipeline_module_init(void)
159{
160 elements_class = class_create(THIS_MODULE, "dsp_pipeline");
161 if (IS_ERR(elements_class))
162 return PTR_ERR(elements_class);
163
164#ifdef PIPELINE_DEBUG
165 printk(KERN_DEBUG "%s: dsp pipeline module initialized\n", __func__);
166#endif
167
168 dsp_hwec_init();
169
170 return 0;
171}
172
173void dsp_pipeline_module_exit(void)
174{
175 struct dsp_element_entry *entry, *n;
176
177 dsp_hwec_exit();
178
179 class_destroy(elements_class);
180
181 list_for_each_entry_safe(entry, n, &dsp_elements, list) {
182 list_del(&entry->list);
183 printk(KERN_WARNING "%s: element was still registered: %s\n",
184 __func__, entry->elem->name);
185 kfree(entry);
186 }
187
188#ifdef PIPELINE_DEBUG
189 printk(KERN_DEBUG "%s: dsp pipeline module exited\n", __func__);
190#endif
191}
192
193int dsp_pipeline_init(struct dsp_pipeline *pipeline)
194{
195 if (!pipeline)
196 return -EINVAL;
197
198 INIT_LIST_HEAD(&pipeline->list);
199
200#ifdef PIPELINE_DEBUG
201 printk(KERN_DEBUG "%s: dsp pipeline ready\n", __func__);
202#endif
203
204 return 0;
205}
206
207static inline void _dsp_pipeline_destroy(struct dsp_pipeline *pipeline)
208{
209 struct dsp_pipeline_entry *entry, *n;
210
211 list_for_each_entry_safe(entry, n, &pipeline->list, list) {
212 list_del(&entry->list);
213 if (entry->elem == dsp_hwec)
214 dsp_hwec_disable(container_of(pipeline, struct dsp,
215 pipeline));
216 else
217 entry->elem->free(entry->p);
218 kfree(entry);
219 }
220}
221
222void dsp_pipeline_destroy(struct dsp_pipeline *pipeline)
223{
224
225 if (!pipeline)
226 return;
227
228 _dsp_pipeline_destroy(pipeline);
229
230#ifdef PIPELINE_DEBUG
231 printk(KERN_DEBUG "%s: dsp pipeline destroyed\n", __func__);
232#endif
233}
234
235int dsp_pipeline_build(struct dsp_pipeline *pipeline, const char *cfg)
236{
237 int len, incomplete = 0, found = 0;
238 char *dup, *tok, *name, *args;
239 struct dsp_element_entry *entry, *n;
240 struct dsp_pipeline_entry *pipeline_entry;
241 struct mISDN_dsp_element *elem;
242
243 if (!pipeline)
244 return -EINVAL;
245
246 if (!list_empty(&pipeline->list))
247 _dsp_pipeline_destroy(pipeline);
248
249 if (!cfg)
250 return 0;
251
252 len = strlen(cfg);
253 if (!len)
254 return 0;
255
256 dup = kmalloc(len + 1, GFP_ATOMIC);
257 if (!dup)
258 return 0;
259 strcpy(dup, cfg);
260 while ((tok = strsep(&dup, "|"))) {
261 if (!strlen(tok))
262 continue;
263 name = strsep(&tok, "(");
264 args = strsep(&tok, ")");
265 if (args && !*args)
266 args = NULL;
267
268 list_for_each_entry_safe(entry, n, &dsp_elements, list)
269 if (!strcmp(entry->elem->name, name)) {
270 elem = entry->elem;
271
272 pipeline_entry = kmalloc(sizeof(struct
273 dsp_pipeline_entry), GFP_ATOMIC);
274 if (!pipeline_entry) {
275 printk(KERN_ERR "%s: failed to add "
276 "entry to pipeline: %s (out of "
277 "memory)\n", __func__, elem->name);
278 incomplete = 1;
279 goto _out;
280 }
281 pipeline_entry->elem = elem;
282
283 if (elem == dsp_hwec) {
284 /* This is a hack to make the hwec
285 available as a pipeline module */
286 dsp_hwec_enable(container_of(pipeline,
287 struct dsp, pipeline), args);
288 list_add_tail(&pipeline_entry->list,
289 &pipeline->list);
290 } else {
291 pipeline_entry->p = elem->new(args);
292 if (pipeline_entry->p) {
293 list_add_tail(&pipeline_entry->
294 list, &pipeline->list);
295#ifdef PIPELINE_DEBUG
296 printk(KERN_DEBUG "%s: created "
297 "instance of %s%s%s\n",
298 __func__, name, args ?
299 " with args " : "", args ?
300 args : "");
301#endif
302 } else {
303 printk(KERN_ERR "%s: failed "
304 "to add entry to pipeline: "
305 "%s (new() returned NULL)\n",
306 __func__, elem->name);
307 kfree(pipeline_entry);
308 incomplete = 1;
309 }
310 }
311 found = 1;
312 break;
313 }
314
315 if (found)
316 found = 0;
317 else {
318 printk(KERN_ERR "%s: element not found, skipping: "
319 "%s\n", __func__, name);
320 incomplete = 1;
321 }
322 }
323
324_out:
325 if (!list_empty(&pipeline->list))
326 pipeline->inuse = 1;
327 else
328 pipeline->inuse = 0;
329
330#ifdef PIPELINE_DEBUG
331 printk(KERN_DEBUG "%s: dsp pipeline built%s: %s\n",
332 __func__, incomplete ? " incomplete" : "", cfg);
333#endif
334 kfree(dup);
335 return 0;
336}
337
338void dsp_pipeline_process_tx(struct dsp_pipeline *pipeline, u8 *data, int len)
339{
340 struct dsp_pipeline_entry *entry;
341
342 if (!pipeline)
343 return;
344
345 list_for_each_entry(entry, &pipeline->list, list)
346 if (entry->elem->process_tx)
347 entry->elem->process_tx(entry->p, data, len);
348}
349
350void dsp_pipeline_process_rx(struct dsp_pipeline *pipeline, u8 *data, int len,
351 unsigned int txlen)
352{
353 struct dsp_pipeline_entry *entry;
354
355 if (!pipeline)
356 return;
357
358 list_for_each_entry_reverse(entry, &pipeline->list, list)
359 if (entry->elem->process_rx)
360 entry->elem->process_rx(entry->p, data, len, txlen);
361}
362
363