1 /* 2 * Intel SST generic IPC Support 3 * 4 * Copyright (C) 2015, Intel Corporation. All rights reserved. 5 * 6 * This program is free software; you can redistribute it and/or 7 * modify it under the terms of the GNU General Public License version 8 * 2 as published by the Free Software Foundation. 9 * 10 * This program is distributed in the hope that it will be useful, 11 * but WITHOUT ANY WARRANTY; without even the implied warranty of 12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 13 * GNU General Public License for more details. 14 * 15 */ 16 17 #ifndef __SST_GENERIC_IPC_H 18 #define __SST_GENERIC_IPC_H 19 20 #include <linux/types.h> 21 #include <linux/kernel.h> 22 #include <linux/wait.h> 23 #include <linux/list.h> 24 #include <linux/workqueue.h> 25 #include <linux/sched.h> 26 #include <linux/kthread.h> 27 28 #define IPC_MAX_MAILBOX_BYTES 256 29 30 struct ipc_message { 31 struct list_head list; 32 u64 header; 33 34 /* direction wrt host CPU */ 35 char *tx_data; 36 size_t tx_size; 37 char *rx_data; 38 size_t rx_size; 39 40 wait_queue_head_t waitq; 41 bool pending; 42 bool complete; 43 bool wait; 44 int errno; 45 }; 46 47 struct sst_generic_ipc; 48 49 struct sst_plat_ipc_ops { 50 void (*tx_msg)(struct sst_generic_ipc *, struct ipc_message *); 51 void (*shim_dbg)(struct sst_generic_ipc *, const char *); 52 void (*tx_data_copy)(struct ipc_message *, char *, size_t); 53 u64 (*reply_msg_match)(u64 header, u64 *mask); 54 bool (*is_dsp_busy)(struct sst_dsp *dsp); 55 }; 56 57 /* SST generic IPC data */ 58 struct sst_generic_ipc { 59 struct device *dev; 60 struct sst_dsp *dsp; 61 62 /* IPC messaging */ 63 struct list_head tx_list; 64 struct list_head rx_list; 65 struct list_head empty_list; 66 wait_queue_head_t wait_txq; 67 struct task_struct *tx_thread; 68 struct kthread_worker kworker; 69 struct kthread_work kwork; 70 bool pending; 71 struct ipc_message *msg; 72 int tx_data_max_size; 73 int rx_data_max_size; 74 75 struct sst_plat_ipc_ops ops; 76 }; 77 78 int sst_ipc_tx_message_wait(struct sst_generic_ipc *ipc, u64 header, 79 void *tx_data, size_t tx_bytes, void *rx_data, size_t rx_bytes); 80 81 int sst_ipc_tx_message_nowait(struct sst_generic_ipc *ipc, u64 header, 82 void *tx_data, size_t tx_bytes); 83 84 struct ipc_message *sst_ipc_reply_find_msg(struct sst_generic_ipc *ipc, 85 u64 header); 86 87 void sst_ipc_tx_msg_reply_complete(struct sst_generic_ipc *ipc, 88 struct ipc_message *msg); 89 90 void sst_ipc_drop_all(struct sst_generic_ipc *ipc); 91 int sst_ipc_init(struct sst_generic_ipc *ipc); 92 void sst_ipc_fini(struct sst_generic_ipc *ipc); 93 94 #endif 95