1 // SPDX-License-Identifier: GPL-2.0-only
3 // Copyright(c) 2022 Intel Corporation. All rights reserved.
5 // Authors: Ranjani Sridharan <ranjani.sridharan@linux.intel.com>
6 // Peter Ujfalusi <peter.ujfalusi@linux.intel.com>
9 #include <linux/debugfs.h>
10 #include <linux/errno.h>
11 #include <linux/list.h>
12 #include <linux/module.h>
13 #include <linux/mutex.h>
14 #include <linux/slab.h>
15 #include <sound/sof/ipc4/header.h>
17 #include "sof-client.h"
19 #include "ipc3-priv.h"
20 #include "ipc4-priv.h"
23 * struct sof_ipc_event_entry - IPC client event description
24 * @ipc_msg_type: IPC msg type of the event the client is interested
25 * @cdev: sof_client_dev of the requesting client
26 * @callback: Callback function of the client
27 * @list: item in SOF core client event list
29 struct sof_ipc_event_entry {
31 struct sof_client_dev *cdev;
32 sof_client_event_callback callback;
33 struct list_head list;
37 * struct sof_state_event_entry - DSP panic event subscription entry
38 * @cdev: sof_client_dev of the requesting client
39 * @callback: Callback function of the client
40 * @list: item in SOF core client event list
42 struct sof_state_event_entry {
43 struct sof_client_dev *cdev;
44 sof_client_fw_state_callback callback;
45 struct list_head list;
48 static void sof_client_auxdev_release(struct device *dev)
50 struct auxiliary_device *auxdev = to_auxiliary_dev(dev);
51 struct sof_client_dev *cdev = auxiliary_dev_to_sof_client_dev(auxdev);
53 kfree(cdev->auxdev.dev.platform_data);
57 static int sof_client_dev_add_data(struct sof_client_dev *cdev, const void *data,
63 d = kmemdup(data, size, GFP_KERNEL);
68 cdev->auxdev.dev.platform_data = d;
72 #if IS_ENABLED(CONFIG_SND_SOC_SOF_DEBUG_IPC_FLOOD_TEST)
73 static int sof_register_ipc_flood_test(struct snd_sof_dev *sdev)
78 if (sdev->pdata->ipc_type != SOF_IPC)
81 for (i = 0; i < CONFIG_SND_SOC_SOF_DEBUG_IPC_FLOOD_TEST_NUM; i++) {
82 ret = sof_client_dev_register(sdev, "ipc_flood", i, NULL, 0);
89 sof_client_dev_unregister(sdev, "ipc_flood", i);
95 static void sof_unregister_ipc_flood_test(struct snd_sof_dev *sdev)
99 for (i = 0; i < CONFIG_SND_SOC_SOF_DEBUG_IPC_FLOOD_TEST_NUM; i++)
100 sof_client_dev_unregister(sdev, "ipc_flood", i);
103 static inline int sof_register_ipc_flood_test(struct snd_sof_dev *sdev)
108 static inline void sof_unregister_ipc_flood_test(struct snd_sof_dev *sdev) {}
109 #endif /* CONFIG_SND_SOC_SOF_DEBUG_IPC_FLOOD_TEST */
111 #if IS_ENABLED(CONFIG_SND_SOC_SOF_DEBUG_IPC_MSG_INJECTOR)
112 static int sof_register_ipc_msg_injector(struct snd_sof_dev *sdev)
114 return sof_client_dev_register(sdev, "msg_injector", 0, NULL, 0);
117 static void sof_unregister_ipc_msg_injector(struct snd_sof_dev *sdev)
119 sof_client_dev_unregister(sdev, "msg_injector", 0);
122 static inline int sof_register_ipc_msg_injector(struct snd_sof_dev *sdev)
127 static inline void sof_unregister_ipc_msg_injector(struct snd_sof_dev *sdev) {}
128 #endif /* CONFIG_SND_SOC_SOF_DEBUG_IPC_MSG_INJECTOR */
130 #if IS_ENABLED(CONFIG_SND_SOC_SOF_DEBUG_IPC_KERNEL_INJECTOR)
131 static int sof_register_ipc_kernel_injector(struct snd_sof_dev *sdev)
133 /* Only IPC3 supported right now */
134 if (sdev->pdata->ipc_type != SOF_IPC)
137 return sof_client_dev_register(sdev, "kernel_injector", 0, NULL, 0);
140 static void sof_unregister_ipc_kernel_injector(struct snd_sof_dev *sdev)
142 sof_client_dev_unregister(sdev, "kernel_injector", 0);
145 static inline int sof_register_ipc_kernel_injector(struct snd_sof_dev *sdev)
150 static inline void sof_unregister_ipc_kernel_injector(struct snd_sof_dev *sdev) {}
151 #endif /* CONFIG_SND_SOC_SOF_DEBUG_IPC_KERNEL_INJECTOR */
153 int sof_register_clients(struct snd_sof_dev *sdev)
157 if (sdev->dspless_mode_selected)
160 /* Register platform independent client devices */
161 ret = sof_register_ipc_flood_test(sdev);
163 dev_err(sdev->dev, "IPC flood test client registration failed\n");
167 ret = sof_register_ipc_msg_injector(sdev);
169 dev_err(sdev->dev, "IPC message injector client registration failed\n");
170 goto err_msg_injector;
173 ret = sof_register_ipc_kernel_injector(sdev);
175 dev_err(sdev->dev, "IPC kernel injector client registration failed\n");
176 goto err_kernel_injector;
179 /* Platform depndent client device registration */
181 if (sof_ops(sdev) && sof_ops(sdev)->register_ipc_clients)
182 ret = sof_ops(sdev)->register_ipc_clients(sdev);
187 sof_unregister_ipc_kernel_injector(sdev);
190 sof_unregister_ipc_msg_injector(sdev);
193 sof_unregister_ipc_flood_test(sdev);
198 void sof_unregister_clients(struct snd_sof_dev *sdev)
200 if (sof_ops(sdev) && sof_ops(sdev)->unregister_ipc_clients)
201 sof_ops(sdev)->unregister_ipc_clients(sdev);
203 sof_unregister_ipc_kernel_injector(sdev);
204 sof_unregister_ipc_msg_injector(sdev);
205 sof_unregister_ipc_flood_test(sdev);
208 int sof_client_dev_register(struct snd_sof_dev *sdev, const char *name, u32 id,
209 const void *data, size_t size)
211 struct auxiliary_device *auxdev;
212 struct sof_client_dev *cdev;
215 cdev = kzalloc(sizeof(*cdev), GFP_KERNEL);
220 auxdev = &cdev->auxdev;
222 auxdev->dev.parent = sdev->dev;
223 auxdev->dev.release = sof_client_auxdev_release;
226 ret = sof_client_dev_add_data(cdev, data, size);
228 goto err_dev_add_data;
230 ret = auxiliary_device_init(auxdev);
232 dev_err(sdev->dev, "failed to initialize client dev %s.%d\n", name, id);
236 ret = auxiliary_device_add(&cdev->auxdev);
238 dev_err(sdev->dev, "failed to add client dev %s.%d\n", name, id);
240 * sof_client_auxdev_release() will be invoked to free up memory
241 * allocations through put_device()
243 auxiliary_device_uninit(&cdev->auxdev);
247 /* add to list of SOF client devices */
248 mutex_lock(&sdev->ipc_client_mutex);
249 list_add(&cdev->list, &sdev->ipc_client_list);
250 mutex_unlock(&sdev->ipc_client_mutex);
255 kfree(cdev->auxdev.dev.platform_data);
262 EXPORT_SYMBOL_NS_GPL(sof_client_dev_register, SND_SOC_SOF_CLIENT);
264 void sof_client_dev_unregister(struct snd_sof_dev *sdev, const char *name, u32 id)
266 struct sof_client_dev *cdev;
268 mutex_lock(&sdev->ipc_client_mutex);
271 * sof_client_auxdev_release() will be invoked to free up memory
272 * allocations through put_device()
274 list_for_each_entry(cdev, &sdev->ipc_client_list, list) {
275 if (!strcmp(cdev->auxdev.name, name) && cdev->auxdev.id == id) {
276 list_del(&cdev->list);
277 auxiliary_device_delete(&cdev->auxdev);
278 auxiliary_device_uninit(&cdev->auxdev);
283 mutex_unlock(&sdev->ipc_client_mutex);
285 EXPORT_SYMBOL_NS_GPL(sof_client_dev_unregister, SND_SOC_SOF_CLIENT);
287 int sof_client_ipc_tx_message(struct sof_client_dev *cdev, void *ipc_msg,
288 void *reply_data, size_t reply_bytes)
290 if (cdev->sdev->pdata->ipc_type == SOF_IPC) {
291 struct sof_ipc_cmd_hdr *hdr = ipc_msg;
293 return sof_ipc_tx_message(cdev->sdev->ipc, ipc_msg, hdr->size,
294 reply_data, reply_bytes);
295 } else if (cdev->sdev->pdata->ipc_type == SOF_INTEL_IPC4) {
296 struct sof_ipc4_msg *msg = ipc_msg;
298 return sof_ipc_tx_message(cdev->sdev->ipc, ipc_msg, msg->data_size,
299 reply_data, reply_bytes);
304 EXPORT_SYMBOL_NS_GPL(sof_client_ipc_tx_message, SND_SOC_SOF_CLIENT);
306 int sof_client_ipc_rx_message(struct sof_client_dev *cdev, void *ipc_msg, void *msg_buf)
308 if (cdev->sdev->pdata->ipc_type == SOF_IPC) {
309 struct sof_ipc_cmd_hdr *hdr = ipc_msg;
311 if (hdr->size < sizeof(hdr)) {
312 dev_err(cdev->sdev->dev, "The received message size is invalid\n");
316 sof_ipc3_do_rx_work(cdev->sdev, ipc_msg, msg_buf);
322 EXPORT_SYMBOL_NS_GPL(sof_client_ipc_rx_message, SND_SOC_SOF_CLIENT);
324 int sof_client_ipc_set_get_data(struct sof_client_dev *cdev, void *ipc_msg,
327 if (cdev->sdev->pdata->ipc_type == SOF_IPC) {
328 struct sof_ipc_cmd_hdr *hdr = ipc_msg;
330 return sof_ipc_set_get_data(cdev->sdev->ipc, ipc_msg, hdr->size,
332 } else if (cdev->sdev->pdata->ipc_type == SOF_INTEL_IPC4) {
333 struct sof_ipc4_msg *msg = ipc_msg;
335 return sof_ipc_set_get_data(cdev->sdev->ipc, ipc_msg,
336 msg->data_size, set);
341 EXPORT_SYMBOL_NS_GPL(sof_client_ipc_set_get_data, SND_SOC_SOF_CLIENT);
343 #ifdef CONFIG_SND_SOC_SOF_INTEL_IPC4
344 struct sof_ipc4_fw_module *sof_client_ipc4_find_module(struct sof_client_dev *c, const guid_t *uuid)
346 struct snd_sof_dev *sdev = c->sdev;
348 if (sdev->pdata->ipc_type == SOF_INTEL_IPC4)
349 return sof_ipc4_find_module_by_uuid(sdev, uuid);
350 dev_err(sdev->dev, "Only supported with IPC4\n");
354 EXPORT_SYMBOL_NS_GPL(sof_client_ipc4_find_module, SND_SOC_SOF_CLIENT);
357 int sof_suspend_clients(struct snd_sof_dev *sdev, pm_message_t state)
359 struct auxiliary_driver *adrv;
360 struct sof_client_dev *cdev;
362 mutex_lock(&sdev->ipc_client_mutex);
364 list_for_each_entry(cdev, &sdev->ipc_client_list, list) {
365 /* Skip devices without loaded driver */
366 if (!cdev->auxdev.dev.driver)
369 adrv = to_auxiliary_drv(cdev->auxdev.dev.driver);
371 adrv->suspend(&cdev->auxdev, state);
374 mutex_unlock(&sdev->ipc_client_mutex);
378 EXPORT_SYMBOL_NS_GPL(sof_suspend_clients, SND_SOC_SOF_CLIENT);
380 int sof_resume_clients(struct snd_sof_dev *sdev)
382 struct auxiliary_driver *adrv;
383 struct sof_client_dev *cdev;
385 mutex_lock(&sdev->ipc_client_mutex);
387 list_for_each_entry(cdev, &sdev->ipc_client_list, list) {
388 /* Skip devices without loaded driver */
389 if (!cdev->auxdev.dev.driver)
392 adrv = to_auxiliary_drv(cdev->auxdev.dev.driver);
394 adrv->resume(&cdev->auxdev);
397 mutex_unlock(&sdev->ipc_client_mutex);
401 EXPORT_SYMBOL_NS_GPL(sof_resume_clients, SND_SOC_SOF_CLIENT);
403 struct dentry *sof_client_get_debugfs_root(struct sof_client_dev *cdev)
405 return cdev->sdev->debugfs_root;
407 EXPORT_SYMBOL_NS_GPL(sof_client_get_debugfs_root, SND_SOC_SOF_CLIENT);
409 /* DMA buffer allocation in client drivers must use the core SOF device */
410 struct device *sof_client_get_dma_dev(struct sof_client_dev *cdev)
412 return cdev->sdev->dev;
414 EXPORT_SYMBOL_NS_GPL(sof_client_get_dma_dev, SND_SOC_SOF_CLIENT);
416 const struct sof_ipc_fw_version *sof_client_get_fw_version(struct sof_client_dev *cdev)
418 struct snd_sof_dev *sdev = sof_client_dev_to_sof_dev(cdev);
420 return &sdev->fw_ready.version;
422 EXPORT_SYMBOL_NS_GPL(sof_client_get_fw_version, SND_SOC_SOF_CLIENT);
424 size_t sof_client_get_ipc_max_payload_size(struct sof_client_dev *cdev)
426 struct snd_sof_dev *sdev = sof_client_dev_to_sof_dev(cdev);
428 return sdev->ipc->max_payload_size;
430 EXPORT_SYMBOL_NS_GPL(sof_client_get_ipc_max_payload_size, SND_SOC_SOF_CLIENT);
432 enum sof_ipc_type sof_client_get_ipc_type(struct sof_client_dev *cdev)
434 struct snd_sof_dev *sdev = sof_client_dev_to_sof_dev(cdev);
436 return sdev->pdata->ipc_type;
438 EXPORT_SYMBOL_NS_GPL(sof_client_get_ipc_type, SND_SOC_SOF_CLIENT);
440 /* module refcount management of SOF core */
441 int sof_client_core_module_get(struct sof_client_dev *cdev)
443 struct snd_sof_dev *sdev = sof_client_dev_to_sof_dev(cdev);
445 if (!try_module_get(sdev->dev->driver->owner))
450 EXPORT_SYMBOL_NS_GPL(sof_client_core_module_get, SND_SOC_SOF_CLIENT);
452 void sof_client_core_module_put(struct sof_client_dev *cdev)
454 struct snd_sof_dev *sdev = sof_client_dev_to_sof_dev(cdev);
456 module_put(sdev->dev->driver->owner);
458 EXPORT_SYMBOL_NS_GPL(sof_client_core_module_put, SND_SOC_SOF_CLIENT);
460 /* IPC event handling */
461 void sof_client_ipc_rx_dispatcher(struct snd_sof_dev *sdev, void *msg_buf)
463 struct sof_ipc_event_entry *event;
466 if (sdev->pdata->ipc_type == SOF_IPC) {
467 struct sof_ipc_cmd_hdr *hdr = msg_buf;
469 msg_type = hdr->cmd & SOF_GLB_TYPE_MASK;
470 } else if (sdev->pdata->ipc_type == SOF_INTEL_IPC4) {
471 struct sof_ipc4_msg *msg = msg_buf;
473 msg_type = SOF_IPC4_NOTIFICATION_TYPE_GET(msg->primary);
475 dev_dbg_once(sdev->dev, "Not supported IPC version: %d\n",
476 sdev->pdata->ipc_type);
480 mutex_lock(&sdev->client_event_handler_mutex);
482 list_for_each_entry(event, &sdev->ipc_rx_handler_list, list) {
483 if (event->ipc_msg_type == msg_type)
484 event->callback(event->cdev, msg_buf);
487 mutex_unlock(&sdev->client_event_handler_mutex);
490 int sof_client_register_ipc_rx_handler(struct sof_client_dev *cdev,
492 sof_client_event_callback callback)
494 struct snd_sof_dev *sdev = sof_client_dev_to_sof_dev(cdev);
495 struct sof_ipc_event_entry *event;
500 if (cdev->sdev->pdata->ipc_type == SOF_IPC) {
501 if (!(ipc_msg_type & SOF_GLB_TYPE_MASK))
503 } else if (cdev->sdev->pdata->ipc_type == SOF_INTEL_IPC4) {
504 if (!(ipc_msg_type & SOF_IPC4_NOTIFICATION_TYPE_MASK))
507 dev_warn(sdev->dev, "%s: Not supported IPC version: %d\n",
508 __func__, sdev->pdata->ipc_type);
512 event = kmalloc(sizeof(*event), GFP_KERNEL);
516 event->ipc_msg_type = ipc_msg_type;
518 event->callback = callback;
520 /* add to list of SOF client devices */
521 mutex_lock(&sdev->client_event_handler_mutex);
522 list_add(&event->list, &sdev->ipc_rx_handler_list);
523 mutex_unlock(&sdev->client_event_handler_mutex);
527 EXPORT_SYMBOL_NS_GPL(sof_client_register_ipc_rx_handler, SND_SOC_SOF_CLIENT);
529 void sof_client_unregister_ipc_rx_handler(struct sof_client_dev *cdev,
532 struct snd_sof_dev *sdev = sof_client_dev_to_sof_dev(cdev);
533 struct sof_ipc_event_entry *event;
535 mutex_lock(&sdev->client_event_handler_mutex);
537 list_for_each_entry(event, &sdev->ipc_rx_handler_list, list) {
538 if (event->cdev == cdev && event->ipc_msg_type == ipc_msg_type) {
539 list_del(&event->list);
545 mutex_unlock(&sdev->client_event_handler_mutex);
547 EXPORT_SYMBOL_NS_GPL(sof_client_unregister_ipc_rx_handler, SND_SOC_SOF_CLIENT);
549 /*DSP state notification and query */
550 void sof_client_fw_state_dispatcher(struct snd_sof_dev *sdev)
552 struct sof_state_event_entry *event;
554 mutex_lock(&sdev->client_event_handler_mutex);
556 list_for_each_entry(event, &sdev->fw_state_handler_list, list)
557 event->callback(event->cdev, sdev->fw_state);
559 mutex_unlock(&sdev->client_event_handler_mutex);
562 int sof_client_register_fw_state_handler(struct sof_client_dev *cdev,
563 sof_client_fw_state_callback callback)
565 struct snd_sof_dev *sdev = sof_client_dev_to_sof_dev(cdev);
566 struct sof_state_event_entry *event;
571 event = kmalloc(sizeof(*event), GFP_KERNEL);
576 event->callback = callback;
578 /* add to list of SOF client devices */
579 mutex_lock(&sdev->client_event_handler_mutex);
580 list_add(&event->list, &sdev->fw_state_handler_list);
581 mutex_unlock(&sdev->client_event_handler_mutex);
585 EXPORT_SYMBOL_NS_GPL(sof_client_register_fw_state_handler, SND_SOC_SOF_CLIENT);
587 void sof_client_unregister_fw_state_handler(struct sof_client_dev *cdev)
589 struct snd_sof_dev *sdev = sof_client_dev_to_sof_dev(cdev);
590 struct sof_state_event_entry *event;
592 mutex_lock(&sdev->client_event_handler_mutex);
594 list_for_each_entry(event, &sdev->fw_state_handler_list, list) {
595 if (event->cdev == cdev) {
596 list_del(&event->list);
602 mutex_unlock(&sdev->client_event_handler_mutex);
604 EXPORT_SYMBOL_NS_GPL(sof_client_unregister_fw_state_handler, SND_SOC_SOF_CLIENT);
606 enum sof_fw_state sof_client_get_fw_state(struct sof_client_dev *cdev)
608 struct snd_sof_dev *sdev = sof_client_dev_to_sof_dev(cdev);
610 return sdev->fw_state;
612 EXPORT_SYMBOL_NS_GPL(sof_client_get_fw_state, SND_SOC_SOF_CLIENT);