drivers/tee/qcomtee/async.c

Source file repositories/reference/linux-study-clean/drivers/tee/qcomtee/async.c

File Facts

System
Linux kernel
Corpus path
drivers/tee/qcomtee/async.c
Extension
.c
Size
5826 bytes
Lines
183
Domain
Driver Families
Bucket
drivers/tee
Inferred role
Driver Families: implementation source
Status
source implementation candidate

Why This File Exists

Repeatable hardware-adapter layer. Deep compatibility for every driver is out of scope; this atlas records patterns, probe lifecycles, bus glue, IRQ/DMA usage, and links back to core abstractions.

Dependency Surface

Detected Declarations

Annotated Snippet

struct qcomtee_async_msg_hdr {
	u32 version;
	u32 op;
};

/* Size of an empty async message. */
#define QCOMTEE_ASYNC_MSG_ZERO sizeof(struct qcomtee_async_msg_hdr)

/**
 * struct qcomtee_async_release_msg - Release asynchronous message.
 * @hdr: message header as &struct qcomtee_async_msg_hdr.
 * @counts: number of objects in @object_ids.
 * @object_ids: array of object IDs that should be released.
 *
 * Available in Maj = 0x0001, Min >= 0x0000.
 */
struct qcomtee_async_release_msg {
	struct qcomtee_async_msg_hdr hdr;
	u32 counts;
	u32 object_ids[] __counted_by(counts);
};

/**
 * qcomtee_get_async_buffer() - Get the start of the asynchronous message.
 * @oic: context used for the current invocation.
 * @async_buffer: return buffer to extract from or fill in async messages.
 *
 * If @oic is used for direct object invocation, the whole outbound buffer
 * is available for the async message. If @oic is used for a callback request,
 * the tail of the outbound buffer (after the callback request message) is
 * available for the async message.
 *
 * The start of the async buffer is aligned, see qcomtee_msg_offset_align().
 */
static void qcomtee_get_async_buffer(struct qcomtee_object_invoke_ctx *oic,
				     struct qcomtee_buffer *async_buffer)
{
	struct qcomtee_msg_callback *msg;
	unsigned int offset;
	int i;

	if (!(oic->flags & QCOMTEE_OIC_FLAG_BUSY)) {
		/* The outbound buffer is empty. Using the whole buffer. */
		offset = 0;
	} else {
		msg = (struct qcomtee_msg_callback *)oic->out_msg.addr;

		/* Start offset in a message for buffer arguments. */
		offset = qcomtee_msg_buffer_args(struct qcomtee_msg_callback,
						 qcomtee_msg_args(msg));

		/* Add size of IB arguments. */
		qcomtee_msg_for_each_input_buffer(i, msg)
			offset += qcomtee_msg_offset_align(msg->args[i].b.size);

		/* Add size of OB arguments. */
		qcomtee_msg_for_each_output_buffer(i, msg)
			offset += qcomtee_msg_offset_align(msg->args[i].b.size);
	}

	async_buffer->addr = oic->out_msg.addr + offset;
	async_buffer->size = oic->out_msg.size - offset;
}

/**
 * async_release() - Process QTEE async release requests.
 * @oic: context used for the current invocation.
 * @msg: async message for object release.
 * @size: size of the async buffer available.
 *
 * Return: Size of the outbound buffer used when processing @msg.
 */
static size_t async_release(struct qcomtee_object_invoke_ctx *oic,
			    struct qcomtee_async_msg_hdr *async_msg,
			    size_t size)
{
	struct qcomtee_async_release_msg *msg;
	struct qcomtee_object *object;
	int i;

	msg = (struct qcomtee_async_release_msg *)async_msg;

	for (i = 0; i < msg->counts; i++) {
		object = qcomtee_idx_erase(oic, msg->object_ids[i]);
		qcomtee_object_put(object);
	}

	return struct_size(msg, object_ids, msg->counts);
}

Annotation

Implementation Notes