mirror of https://github.com/Qortal/Brooklyn
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
97 lines
3.0 KiB
97 lines
3.0 KiB
/* SPDX-License-Identifier: GPL-2.0-only |
|
* |
|
* Copyright (C) 2020-21 Intel Corporation. |
|
*/ |
|
|
|
#ifndef IOSM_IPC_TASK_QUEUE_H |
|
#define IOSM_IPC_TASK_QUEUE_H |
|
|
|
/* Number of available element for the input message queue of the IPC |
|
* ipc_task |
|
*/ |
|
#define IPC_THREAD_QUEUE_SIZE 256 |
|
|
|
/** |
|
* struct ipc_task_queue_args - Struct for Task queue elements |
|
* @ipc_imem: Pointer to struct iosm_imem |
|
* @msg: Message argument for tasklet function. (optional, can be NULL) |
|
* @completion: OS object used to wait for the tasklet function to finish for |
|
* synchronous calls |
|
* @func: Function to be called in tasklet (tl) context |
|
* @arg: Generic integer argument for tasklet function (optional) |
|
* @size: Message size argument for tasklet function (optional) |
|
* @response: Return code of tasklet function for synchronous calls |
|
* @is_copy: Is true if msg contains a pointer to a copy of the original msg |
|
* for async. calls that needs to be freed once the tasklet returns |
|
*/ |
|
struct ipc_task_queue_args { |
|
struct iosm_imem *ipc_imem; |
|
void *msg; |
|
struct completion *completion; |
|
int (*func)(struct iosm_imem *ipc_imem, int arg, void *msg, |
|
size_t size); |
|
int arg; |
|
size_t size; |
|
int response; |
|
u8 is_copy:1; |
|
}; |
|
|
|
/** |
|
* struct ipc_task_queue - Struct for Task queue |
|
* @q_lock: Protect the message queue of the ipc ipc_task |
|
* @args: Message queue of the IPC ipc_task |
|
* @q_rpos: First queue element to process. |
|
* @q_wpos: First free element of the input queue. |
|
*/ |
|
struct ipc_task_queue { |
|
spinlock_t q_lock; /* for atomic operation on queue */ |
|
struct ipc_task_queue_args args[IPC_THREAD_QUEUE_SIZE]; |
|
unsigned int q_rpos; |
|
unsigned int q_wpos; |
|
}; |
|
|
|
/** |
|
* struct ipc_task - Struct for Task |
|
* @dev: Pointer to device structure |
|
* @ipc_tasklet: Tasklet for serialized work offload |
|
* from interrupts and OS callbacks |
|
* @ipc_queue: Task for entry into ipc task queue |
|
*/ |
|
struct ipc_task { |
|
struct device *dev; |
|
struct tasklet_struct *ipc_tasklet; |
|
struct ipc_task_queue ipc_queue; |
|
}; |
|
|
|
/** |
|
* ipc_task_init - Allocate a tasklet |
|
* @ipc_task: Pointer to ipc_task structure |
|
* Returns: 0 on success and failure value on error. |
|
*/ |
|
int ipc_task_init(struct ipc_task *ipc_task); |
|
|
|
/** |
|
* ipc_task_deinit - Free a tasklet, invalidating its pointer. |
|
* @ipc_task: Pointer to ipc_task structure |
|
*/ |
|
void ipc_task_deinit(struct ipc_task *ipc_task); |
|
|
|
/** |
|
* ipc_task_queue_send_task - Synchronously/Asynchronously call a function in |
|
* tasklet context. |
|
* @imem: Pointer to iosm_imem struct |
|
* @func: Function to be called in tasklet context |
|
* @arg: Integer argument for func |
|
* @msg: Message pointer argument for func |
|
* @size: Size argument for func |
|
* @wait: if true wait for result |
|
* |
|
* Returns: Result value returned by func or failure value if func could not |
|
* be called. |
|
*/ |
|
int ipc_task_queue_send_task(struct iosm_imem *imem, |
|
int (*func)(struct iosm_imem *ipc_imem, int arg, |
|
void *msg, size_t size), |
|
int arg, void *msg, size_t size, bool wait); |
|
|
|
#endif
|
|
|