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 | |
20 | struct dsp_pipeline_entry { |
21 | struct mISDN_dsp_element *elem; |
22 | void *p; |
23 | struct list_head list; |
24 | }; |
25 | struct dsp_element_entry { |
26 | struct mISDN_dsp_element *elem; |
27 | struct device dev; |
28 | struct list_head list; |
29 | }; |
30 | |
31 | static LIST_HEAD(dsp_elements); |
32 | |
33 | /* sysfs */ |
34 | static const struct class elements_class = { |
35 | .name = "dsp_pipeline" , |
36 | }; |
37 | |
38 | static ssize_t |
39 | attr_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(buf: p, fmt: "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 | |
57 | static struct device_attribute element_attributes[] = { |
58 | __ATTR(args, 0444, attr_show_args, NULL), |
59 | }; |
60 | |
61 | static void |
62 | mISDN_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: &entry->list); |
67 | kfree(objp: entry); |
68 | } |
69 | |
70 | int 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(size: sizeof(struct dsp_element_entry), GFP_ATOMIC); |
79 | if (!entry) |
80 | return -ENOMEM; |
81 | |
82 | INIT_LIST_HEAD(list: &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(dev: &entry->dev, data: elem); |
88 | dev_set_name(dev: &entry->dev, name: "%s" , elem->name); |
89 | ret = device_register(dev: &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(new: &entry->list, head: &dsp_elements); |
96 | |
97 | for (i = 0; i < ARRAY_SIZE(element_attributes); ++i) { |
98 | ret = device_create_file(device: &entry->dev, |
99 | entry: &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 | |
109 | err2: |
110 | device_unregister(dev: &entry->dev); |
111 | return ret; |
112 | err1: |
113 | put_device(dev: &entry->dev); |
114 | return ret; |
115 | } |
116 | EXPORT_SYMBOL(mISDN_dsp_element_register); |
117 | |
118 | void 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(dev: &entry->dev); |
128 | return; |
129 | } |
130 | printk(KERN_ERR "%s: element %s not in list.\n" , __func__, elem->name); |
131 | } |
132 | EXPORT_SYMBOL(mISDN_dsp_element_unregister); |
133 | |
134 | int dsp_pipeline_module_init(void) |
135 | { |
136 | int err; |
137 | |
138 | err = class_register(class: &elements_class); |
139 | if (err) |
140 | return err; |
141 | |
142 | dsp_hwec_init(); |
143 | |
144 | return 0; |
145 | } |
146 | |
147 | void dsp_pipeline_module_exit(void) |
148 | { |
149 | struct dsp_element_entry *entry, *n; |
150 | |
151 | dsp_hwec_exit(); |
152 | |
153 | class_unregister(class: &elements_class); |
154 | |
155 | list_for_each_entry_safe(entry, n, &dsp_elements, list) { |
156 | list_del(entry: &entry->list); |
157 | printk(KERN_WARNING "%s: element was still registered: %s\n" , |
158 | __func__, entry->elem->name); |
159 | kfree(objp: entry); |
160 | } |
161 | } |
162 | |
163 | int dsp_pipeline_init(struct dsp_pipeline *pipeline) |
164 | { |
165 | if (!pipeline) |
166 | return -EINVAL; |
167 | |
168 | INIT_LIST_HEAD(list: &pipeline->list); |
169 | |
170 | return 0; |
171 | } |
172 | |
173 | static 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: &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(objp: entry); |
185 | } |
186 | } |
187 | |
188 | void dsp_pipeline_destroy(struct dsp_pipeline *pipeline) |
189 | { |
190 | |
191 | if (!pipeline) |
192 | return; |
193 | |
194 | _dsp_pipeline_destroy(pipeline); |
195 | } |
196 | |
197 | int 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(head: &pipeline->list)) |
209 | _dsp_pipeline_destroy(pipeline); |
210 | |
211 | dup = next = kstrdup(s: 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(size: 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), arg: args); |
241 | list_add_tail(new: &pipeline_entry->list, |
242 | head: &pipeline->list); |
243 | } else { |
244 | pipeline_entry->p = elem->new(args); |
245 | if (pipeline_entry->p) { |
246 | list_add_tail(new: &pipeline_entry-> |
247 | list, head: &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(objp: 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(head: &pipeline->list)) |
269 | pipeline->inuse = 1; |
270 | else |
271 | pipeline->inuse = 0; |
272 | |
273 | kfree(objp: dup); |
274 | return 0; |
275 | } |
276 | |
277 | void 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 | |
289 | void 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 | } |
301 | |