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 30struct ipc_message { 31 struct list_head list; 32 u64 header; 33 34 /* direction wrt host CPU */ 35 char tx_data[IPC_MAX_MAILBOX_BYTES]; 36 size_t tx_size; 37 char rx_data[IPC_MAX_MAILBOX_BYTES]; 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 47struct sst_generic_ipc; 48 49struct 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}; 55 56/* SST generic IPC data */ 57struct sst_generic_ipc { 58 struct device *dev; 59 struct sst_dsp *dsp; 60 61 /* IPC messaging */ 62 struct list_head tx_list; 63 struct list_head rx_list; 64 struct list_head empty_list; 65 wait_queue_head_t wait_txq; 66 struct task_struct *tx_thread; 67 struct kthread_worker kworker; 68 struct kthread_work kwork; 69 bool pending; 70 struct ipc_message *msg; 71 72 struct sst_plat_ipc_ops ops; 73}; 74 75int sst_ipc_tx_message_wait(struct sst_generic_ipc *ipc, u64 header, 76 void *tx_data, size_t tx_bytes, void *rx_data, size_t rx_bytes); 77 78int sst_ipc_tx_message_nowait(struct sst_generic_ipc *ipc, u64 header, 79 void *tx_data, size_t tx_bytes); 80 81struct ipc_message *sst_ipc_reply_find_msg(struct sst_generic_ipc *ipc, 82 u64 header); 83 84void sst_ipc_tx_msg_reply_complete(struct sst_generic_ipc *ipc, 85 struct ipc_message *msg); 86 87void sst_ipc_drop_all(struct sst_generic_ipc *ipc); 88int sst_ipc_init(struct sst_generic_ipc *ipc); 89void sst_ipc_fini(struct sst_generic_ipc *ipc); 90 91#endif 92