drivers/firmware/tisci/tisci.c

/*
 * Copyright (c) 2025, Texas Instruments
 *
 * SPDX-License-Identifier: Apache-2.0
 */

#include <stdint.h>
#include <stdio.h>
#define DT_DRV_COMPAT ti_k2g_sci
#include <zephyr/drivers/mbox.h>
#include <zephyr/device.h>
#include "tisci.h"
#include <zephyr/drivers/firmware/tisci/tisci.h>
#include <zephyr/kernel.h>
#include <zephyr/sys/util.h>
#define LOG_LEVEL CONFIG_MBOX_LOG_LEVEL
#include <zephyr/logging/log.h>
LOG_MODULE_REGISTER(ti_k2g_sci);

/**
 * @struct tisci_config - TISCI device configuration structure
 * @mbox_tx: Mailbox transmit channel specification.
 * @mbox_rx: Mailbox receive channel specification.
 * @host_id: Host ID for the device.
 * @max_msg_size: Maximum supported message size in bytes.
 * @max_rx_timeout_ms: Maximum receive timeout in milliseconds.
 */
struct tisci_config {
	struct mbox_dt_spec mbox_tx;
	struct mbox_dt_spec mbox_rx;
	uint32_t host_id;
	int max_msg_size;
	int max_rx_timeout_ms;
};

/**
 * @struct tisci_xfer - TISCI transfer details
 * @param tx_message: Transmit message
 * @param rx_message: Received message
 */
struct tisci_xfer {
	struct mbox_msg tx_message;
	struct rx_msg rx_message;
};

/**
 * @struct tisci_data - Runtime data for TISCI device communication
 * @xfer: Structure holding the current transfer details, including buffers and status.
 * @seq: Current transfer sequence number, used to track message order.
 * @rx_message: Structure for storing the most recently received message.
 * @data_sem: Semaphore used to synchronize access to the data structure.
 */
struct tisci_data {
	struct tisci_xfer xfer;
	uint8_t seq;
	struct rx_msg rx_message;
	struct k_sem data_sem;
};

/* Core/Setup Functions */
static struct tisci_xfer *tisci_setup_one_xfer(const struct device *dev, uint16_t msg_type,
					       uint32_t msg_flags, void *req_buf,
					       size_t tx_message_size, void *resp_buf,
					       size_t rx_message_size)
{
	struct tisci_data *data = dev->data;

	k_sem_take(&data->data_sem, K_FOREVER);

	const struct tisci_config *config = dev->config;
	struct tisci_xfer *xfer = &data->xfer;
	struct tisci_msg_hdr *hdr;

	if (rx_message_size > config->max_msg_size || tx_message_size > config->max_msg_size ||
	    (rx_message_size > 0 && rx_message_size < sizeof(*hdr)) ||
	    tx_message_size < sizeof(*hdr)) {
		return NULL;
	}

	data->seq++;

	xfer->tx_message.data = req_buf;
	xfer->tx_message.size = tx_message_size;
	xfer->rx_message.buf = resp_buf;
	xfer->rx_message.size = (uint8_t)rx_message_size;

	hdr = (struct tisci_msg_hdr *)req_buf;
	hdr->seq = data->seq;
	hdr->type = msg_type;
	hdr->host = config->host_id;
	hdr->flags = msg_flags;

	if (rx_message_size) {
		hdr->flags = hdr->flags | TISCI_FLAG_REQ_ACK_ON_PROCESSED;
	}

	return xfer;
}

static void callback(const struct device *dev, mbox_channel_id_t channel_id, void *user_data,
		     struct mbox_msg *mbox_data)
{
	struct rx_msg *msg = user_data;

	k_sem_give(msg->response_ready_sem);
}

static bool tisci_is_response_ack(void *r)
{
	struct tisci_msg_hdr *hdr = (struct tisci_msg_hdr *)r;

	return hdr->flags & TISCI_FLAG_RESP_GENERIC_ACK ? true : false;
}

static int tisci_get_response(const struct device *dev, struct tisci_xfer *xfer)
{
	if (!dev) {
		return -EINVAL;
	}

	struct tisci_data *data = dev->data;
	const struct tisci_config *config = dev->config;
	struct tisci_msg_hdr *hdr;

	if (!xfer->rx_message.buf) {
		LOG_ERR("No response buffer provided");
		return -EINVAL;
	}

	if (k_sem_take(data->rx_message.response_ready_sem, K_MSEC(config->max_rx_timeout_ms)) !=
	    0) {
		LOG_ERR("Timeout waiting for response");
		return -ETIMEDOUT;
	}

	if (xfer->rx_message.size > config->max_msg_size) {
		LOG_ERR("rx_message.size [ %d ] > max_msg_size\n", xfer->rx_message.size);
		return -EINVAL;
	}

	if (data->rx_message.size < xfer->rx_message.size) {
		LOG_ERR("rx_message.size [ %d ] < xfer->rx_message.size\n", data->rx_message.size);
		return -EINVAL;
	}

	memcpy(xfer->rx_message.buf, data->rx_message.buf, xfer->rx_message.size);
	hdr = (struct tisci_msg_hdr *)xfer->rx_message.buf;

	/* Sanity check for message response */
	if (hdr->seq != data->seq) {
		LOG_ERR("HDR seq != data seq [%d != %d]\n", hdr->seq, data->seq);
		return -EINVAL;
	}

	k_sem_give(&data->data_sem);
	return 0;
}

static int tisci_do_xfer(const struct device *dev, struct tisci_xfer *xfer)
{
	if (!dev) {
		return -EINVAL;
	}

	const struct tisci_config *config = dev->config;
	struct mbox_msg *msg = &xfer->tx_message;
	int ret;

	ret = mbox_send_dt(&config->mbox_tx, msg);
	if (ret < 0) {
		LOG_ERR("Could not send (%d)\n", ret);
		return ret;
	}

	/* Get response if requested */
	if (xfer->rx_message.size) {
		ret = tisci_get_response(dev, xfer);
		if (ret) {
			return ret;
		}
		if (!tisci_is_response_ack(xfer->rx_message.buf)) {
			LOG_ERR("TISCI Response in NACK\n");
			return -ENODEV;
		}
	}

	return 0;
}

/* Clock Management Functions */
int tisci_cmd_get_clock_state(const struct device *dev, uint32_t dev_id, uint8_t clk_id,
			      uint8_t *programmed_state, uint8_t *current_state)
{
	struct tisci_msg_resp_get_clock_state resp;
	struct tisci_msg_req_get_clock_state req;
	struct tisci_xfer *xfer;
	int ret;

	if (!programmed_state && !current_state) {
		return -EINVAL;
	}

	xfer = tisci_setup_one_xfer(dev, TISCI_MSG_GET_CLOCK_STATE, 0, &req, sizeof(req), &resp,
				    sizeof(resp));
	if (!xfer) {
		LOG_ERR("Failed to setup transfer");
		return -EINVAL;
	}

	req.dev_id = dev_id;
	req.clk_id = clk_id;
	ret = tisci_do_xfer(dev, xfer);
	if (ret) {
		LOG_ERR("Failed to get clock state (ret=%d)", ret);
		return ret;
	}

	if (programmed_state) {
		*programmed_state = resp.programmed_state;
	}
	if (current_state) {
		*current_state = resp.current_state;
	}
	return 0;
}

int tisci_cmd_clk_is_auto(const struct device *dev, uint32_t dev_id, uint8_t clk_id,
			  bool *req_state)
{
	uint8_t state = 0;
	int ret;

	if (!req_state) {
		return -EINVAL;
	}

	ret = tisci_cmd_get_clock_state(dev, dev_id, clk_id, &state, NULL);
	if (ret) {
		return ret;
	}

	*req_state = (state == MSG_CLOCK_SW_STATE_AUTO);
	return 0;
}

int tisci_cmd_clk_is_on(const struct device *dev, uint32_t dev_id, uint8_t clk_id, bool *req_state,
			bool *curr_state)
{
	uint8_t c_state = 0, r_state = 0;
	int ret;

	if (!req_state && !curr_state) {
		return -EINVAL;
	}

	ret = tisci_cmd_get_clock_state(dev, dev_id, clk_id, &r_state, &c_state);
	if (ret) {
		return ret;
	}

	if (req_state) {
		*req_state = (r_state == MSG_CLOCK_SW_STATE_REQ);
	}
	if (curr_state) {
		*curr_state = (c_state == MSG_CLOCK_HW_STATE_READY);
	}
	return 0;
}

int tisci_cmd_clk_is_off(const struct device *dev, uint32_t dev_id, uint8_t clk_id, bool *req_state,
			 bool *curr_state)
{
	uint8_t c_state = 0, r_state = 0;
	int ret;

	if (!req_state && !curr_state) {
		return -EINVAL;
	}

	ret = tisci_cmd_get_clock_state(dev, dev_id, clk_id, &r_state, &c_state);
	if (ret) {
		return ret;
	}

	if (req_state) {
		*req_state = (r_state == MSG_CLOCK_SW_STATE_UNREQ);
	}
	if (curr_state) {
		*curr_state = (c_state == MSG_CLOCK_HW_STATE_NOT_READY);
	}
	return 0;
}

int tisci_cmd_clk_get_match_freq(const struct device *dev, uint32_t dev_id, uint8_t clk_id,
				 uint64_t min_freq, uint64_t target_freq, uint64_t max_freq,
				 uint64_t *match_freq)
{
	struct tisci_msg_resp_query_clock_freq resp;
	struct tisci_msg_req_query_clock_freq req;
	struct tisci_xfer *xfer;
	int ret;

	if (!match_freq) {
		return -EINVAL;
	}

	xfer = tisci_setup_one_xfer(dev, TISCI_MSG_QUERY_CLOCK_FREQ, 0, &req, sizeof(req), &resp,
				    sizeof(resp));
	if (!xfer) {
		LOG_ERR("Failed to setup transfer");
		return -EINVAL;
	}

	req.dev_id = dev_id;
	req.clk_id = clk_id;
	req.min_freq_hz = min_freq;
	req.target_freq_hz = target_freq;
	req.max_freq_hz = max_freq;

	ret = tisci_do_xfer(dev, xfer);
	if (ret) {
		LOG_ERR("Failed to get matching clock frequency (ret=%d)", ret);
		return ret;
	}

	*match_freq = resp.freq_hz;

	return 0;
}

int tisci_cmd_clk_set_freq(const struct device *dev, uint32_t dev_id, uint8_t clk_id,
			   uint64_t min_freq, uint64_t target_freq, uint64_t max_freq)
{
	struct tisci_msg_req_set_clock_freq req;
	struct tisci_msg_resp_set_clock_freq resp;
	struct tisci_xfer *xfer;
	int ret;

	xfer = tisci_setup_one_xfer(dev, TISCI_MSG_SET_CLOCK_FREQ, 0, &req, sizeof(req), &resp,
				    sizeof(resp));
	if (!xfer) {
		LOG_ERR("Failed to setup transfer");
		return -EINVAL;
	}

	req.dev_id = dev_id;
	req.clk_id = clk_id;
	req.min_freq_hz = min_freq;
	req.target_freq_hz = target_freq;
	req.max_freq_hz = max_freq;

	ret = tisci_do_xfer(dev, xfer);
	if (ret) {
		LOG_ERR("Failed to set clock frequency (ret=%d)", ret);
		return ret;
	}

	return 0;
}

int tisci_cmd_clk_get_freq(const struct device *dev, uint32_t dev_id, uint8_t clk_id,
			   uint64_t *freq)
{
	struct tisci_msg_resp_get_clock_freq resp;
	struct tisci_msg_req_get_clock_freq req;
	struct tisci_xfer *xfer;
	int ret;

	if (!freq) {
		return -EINVAL;
	}

	xfer = tisci_setup_one_xfer(dev, TISCI_MSG_GET_CLOCK_FREQ, 0, &req, sizeof(req), &resp,
				    sizeof(resp));
	if (!xfer) {
		LOG_ERR("Failed to setup transfer");
		return -EINVAL;
	}

	req.dev_id = dev_id;
	req.clk_id = clk_id;

	ret = tisci_do_xfer(dev, xfer);
	if (ret) {
		LOG_ERR("Failed to get clock frequency (ret=%d)", ret);
		return ret;
	}

	*freq = resp.freq_hz;

	return 0;
}

int tisci_set_clock_state(const struct device *dev, uint32_t dev_id, uint8_t clk_id, uint32_t flags,
			  uint8_t state)
{
	struct tisci_msg_req_set_clock_state req;
	struct tisci_msg_resp_set_clock_state resp;
	struct tisci_xfer *xfer;
	int ret;

	xfer = tisci_setup_one_xfer(dev, TISCI_MSG_SET_CLOCK_STATE, flags, &req, sizeof(req), &resp,
				    sizeof(resp));
	if (!xfer) {
		LOG_ERR("Failed to setup transfer");
		return -EINVAL;
	}

	req.dev_id = dev_id;
	req.clk_id = clk_id;
	req.request_state = state;

	ret = tisci_do_xfer(dev, xfer);
	if (ret) {
		LOG_ERR("Failed to set clock state (ret=%d)", ret);
		return ret;
	}

	return 0;
}

int tisci_cmd_clk_set_parent(const struct device *dev, uint32_t dev_id, uint8_t clk_id,
			     uint8_t parent_id)
{
	struct tisci_msg_req_set_clock_parent req;
	struct tisci_msg_resp_set_clock_parent resp;
	struct tisci_xfer *xfer;
	int ret;

	xfer = tisci_setup_one_xfer(dev, TISCI_MSG_SET_CLOCK_PARENT, 0, &req, sizeof(req), &resp,
				    sizeof(resp));

	req.dev_id = dev_id;
	req.clk_id = clk_id;
	req.parent_id = parent_id;

	ret = tisci_do_xfer(dev, xfer);
	if (ret) {
		LOG_ERR("Failed to set clock parent (ret=%d)", ret);
		return ret;
	}

	return 0;
}

int tisci_cmd_clk_get_parent(const struct device *dev, uint32_t dev_id, uint8_t clk_id,
			     uint8_t *parent_id)
{
	struct tisci_msg_resp_get_clock_parent resp;
	struct tisci_msg_req_get_clock_parent req;
	struct tisci_xfer *xfer;
	int ret;

	if (!parent_id) {
		return -EINVAL;
	}

	xfer = tisci_setup_one_xfer(dev, TISCI_MSG_GET_CLOCK_PARENT, 0, &req, sizeof(req), &resp,
				    sizeof(resp));
	if (!xfer) {
		LOG_ERR("Failed to setup transfer");
		return -EINVAL;
	}

	req.dev_id = dev_id;
	req.clk_id = clk_id;

	ret = tisci_do_xfer(dev, xfer);
	if (ret) {
		LOG_ERR("Failed to get clock parent (ret=%d)", ret);
		return ret;
	}

	*parent_id = resp.parent_id;

	return 0;
}

int tisci_cmd_clk_get_num_parents(const struct device *dev, uint32_t dev_id, uint8_t clk_id,
				  uint8_t *num_parents)
{
	struct tisci_msg_resp_get_clock_num_parents resp;
	struct tisci_msg_req_get_clock_num_parents req;
	struct tisci_xfer *xfer;
	int ret;

	if (!num_parents) {
		return -EINVAL;
	}

	xfer = tisci_setup_one_xfer(dev, TISCI_MSG_GET_NUM_CLOCK_PARENTS, 0, &req, sizeof(req),
				    &resp, sizeof(resp));
	if (!xfer) {
		LOG_ERR("Failed to setup transfer");
		return -EINVAL;
	}

	req.dev_id = dev_id;
	req.clk_id = clk_id;

	ret = tisci_do_xfer(dev, xfer);
	if (ret) {
		LOG_ERR("Failed to get number of clock parents (ret=%d)", ret);
		return ret;
	}

	*num_parents = resp.num_parents;

	return 0;
}

int tisci_cmd_get_clock(const struct device *dev, uint32_t dev_id, uint8_t clk_id, bool needs_ssc,
			bool can_change_freq, bool enable_input_term)
{
	uint32_t flags = 0;

	flags |= needs_ssc ? MSG_FLAG_CLOCK_ALLOW_SSC : 0;
	flags |= can_change_freq ? MSG_FLAG_CLOCK_ALLOW_FREQ_CHANGE : 0;
	flags |= enable_input_term ? MSG_FLAG_CLOCK_INPUT_TERM : 0;

	return tisci_set_clock_state(dev, dev_id, clk_id, flags, MSG_CLOCK_SW_STATE_REQ);
}

int tisci_cmd_idle_clock(const struct device *dev, uint32_t dev_id, uint8_t clk_id)
{

	return tisci_set_clock_state(dev, dev_id, clk_id, 0, MSG_CLOCK_SW_STATE_UNREQ);
}

int tisci_cmd_put_clock(const struct device *dev, uint32_t dev_id, uint8_t clk_id)
{

	return tisci_set_clock_state(dev, dev_id, clk_id, 0, MSG_CLOCK_SW_STATE_UNREQ);
}

/* Device Management Functions */
int tisci_set_device_state(const struct device *dev, uint32_t dev_id, uint32_t flags, uint8_t state)
{
	struct tisci_msg_req_set_device_state req;
	struct tisci_msg_resp_set_device_state resp;
	struct tisci_xfer *xfer;
	int ret;

	xfer = tisci_setup_one_xfer(dev, TISCI_MSG_SET_DEVICE_STATE, flags, &req, sizeof(req),
				    &resp, sizeof(resp));
	if (!xfer) {
		LOG_ERR("Failed to setup transfer");
		return -EINVAL;
	}

	req.id = dev_id;
	req.state = state;

	ret = tisci_do_xfer(dev, xfer);
	if (ret) {
		LOG_ERR("Failed to set device state (ret=%d)", ret);
		return ret;
	}

	return 0;
}

int tisci_set_device_state_no_wait(const struct device *dev, uint32_t dev_id, uint32_t flags,
				   uint8_t state)
{
	struct tisci_msg_req_set_device_state req;
	struct tisci_msg_resp_set_device_state resp;
	struct tisci_xfer *xfer;
	int ret;

	xfer = tisci_setup_one_xfer(dev, TISCI_MSG_SET_DEVICE_STATE,
				    flags | TISCI_FLAG_REQ_GENERIC_NORESPONSE, &req, sizeof(req),
				    &resp, sizeof(resp));
	if (!xfer) {
		LOG_ERR("Failed to setup transfer");
		return -EINVAL;
	}

	req.id = dev_id;
	req.state = state;

	ret = tisci_do_xfer(dev, xfer);
	if (ret) {
		LOG_ERR("Failed to set device state without wait (ret=%d)", ret);
		return ret;
	}

	return 0;
}

int tisci_get_device_state(const struct device *dev, uint32_t dev_id, uint32_t *clcnt,
			   uint32_t *resets, uint8_t *p_state, uint8_t *c_state)
{
	struct tisci_msg_resp_get_device_state resp;
	struct tisci_msg_req_get_device_state req;
	struct tisci_xfer *xfer;
	int ret;

	if (!clcnt && !resets && !p_state && !c_state) {
		return -EINVAL;
	}

	xfer = tisci_setup_one_xfer(dev, TISCI_MSG_GET_DEVICE_STATE, 0, &req, sizeof(req), &resp,
				    sizeof(resp));
	if (!xfer) {
		LOG_ERR("Failed to setup transfer");
		return -EINVAL;
	}

	req.id = dev_id;

	ret = tisci_do_xfer(dev, xfer);
	if (ret) {
		LOG_ERR("Failed to get device state (ret=%d)", ret);
		return ret;
	}

	if (clcnt) {
		*clcnt = resp.context_loss_count;
	}
	if (resets) {
		*resets = resp.resets;
	}
	if (p_state) {
		*p_state = resp.programmed_state;
	}
	if (c_state) {
		*c_state = resp.current_state;
	}

	return 0;
}

int tisci_cmd_get_device(const struct device *dev, uint32_t dev_id)
{

	return tisci_set_device_state(dev, dev_id, 0, MSG_DEVICE_SW_STATE_ON);
}

int tisci_cmd_get_device_exclusive(const struct device *dev, uint32_t dev_id)
{

	return tisci_set_device_state(dev, dev_id, MSG_FLAG_DEVICE_EXCLUSIVE,
				      MSG_DEVICE_SW_STATE_ON);
}

int tisci_cmd_idle_device(const struct device *dev, uint32_t dev_id)
{

	return tisci_set_device_state(dev, dev_id, 0, MSG_DEVICE_SW_STATE_RETENTION);
}

int tisci_cmd_idle_device_exclusive(const struct device *dev, uint32_t dev_id)
{

	return tisci_set_device_state(dev, dev_id, MSG_FLAG_DEVICE_EXCLUSIVE,
				      MSG_DEVICE_SW_STATE_RETENTION);
}

int tisci_cmd_put_device(const struct device *dev, uint32_t dev_id)
{

	return tisci_set_device_state(dev, dev_id, 0, MSG_DEVICE_SW_STATE_AUTO_OFF);
}

int tisci_cmd_dev_is_valid(const struct device *dev, uint32_t dev_id)
{
	uint8_t unused;

	return tisci_get_device_state(dev, dev_id, NULL, NULL, NULL, &unused);
}

int tisci_cmd_dev_get_clcnt(const struct device *dev, uint32_t dev_id, uint32_t *count)
{

	return tisci_get_device_state(dev, dev_id, count, NULL, NULL, NULL);
}

int tisci_cmd_dev_is_idle(const struct device *dev, uint32_t dev_id, bool *r_state)
{
	int ret;
	uint8_t state;

	if (!r_state) {
		return -EINVAL;
	}

	ret = tisci_get_device_state(dev, dev_id, NULL, NULL, &state, NULL);
	if (ret) {
		return ret;
	}

	*r_state = (state == MSG_DEVICE_SW_STATE_RETENTION);

	return 0;
}

int tisci_cmd_dev_is_stop(const struct device *dev, uint32_t dev_id, bool *r_state,
			  bool *curr_state)
{
	int ret;
	uint8_t p_state, c_state;

	if (!r_state && !curr_state) {
		return -EINVAL;
	}

	ret = tisci_get_device_state(dev, dev_id, NULL, NULL, &p_state, &c_state);
	if (ret) {
		return ret;
	}

	if (r_state) {
		*r_state = (p_state == MSG_DEVICE_SW_STATE_AUTO_OFF);
	}
	if (curr_state) {
		*curr_state = (c_state == MSG_DEVICE_HW_STATE_OFF);
	}

	return 0;
}

int tisci_cmd_dev_is_on(const struct device *dev, uint32_t dev_id, bool *r_state, bool *curr_state)
{
	int ret;
	uint8_t p_state, c_state;

	if (!r_state && !curr_state) {
		return -EINVAL;
	}

	ret = tisci_get_device_state(dev, dev_id, NULL, NULL, &p_state, &c_state);
	if (ret) {
		return ret;
	}

	if (r_state) {
		*r_state = (p_state == MSG_DEVICE_SW_STATE_ON);
	}
	if (curr_state) {
		*curr_state = (c_state == MSG_DEVICE_HW_STATE_ON);
	}

	return 0;
}

int tisci_cmd_dev_is_trans(const struct device *dev, uint32_t dev_id, bool *curr_state)
{
	int ret;
	uint8_t state;

	if (!curr_state) {
		return -EINVAL;
	}

	ret = tisci_get_device_state(dev, dev_id, NULL, NULL, NULL, &state);
	if (ret) {
		return ret;
	}

	*curr_state = (state == MSG_DEVICE_HW_STATE_TRANS);

	return 0;
}

int tisci_cmd_set_device_resets(const struct device *dev, uint32_t dev_id, uint32_t reset_state)
{
	struct tisci_msg_req_set_device_resets req;
	struct tisci_msg_resp_set_device_resets resp;
	struct tisci_xfer *xfer;
	int ret;

	xfer = tisci_setup_one_xfer(dev, TISCI_MSG_SET_DEVICE_RESETS, 0, &req, sizeof(req), &resp,
				    sizeof(resp));
	if (!xfer) {
		LOG_ERR("Failed to setup transfer");
		return -EINVAL;
	}

	req.id = dev_id;
	req.resets = reset_state;

	ret = tisci_do_xfer(dev, xfer);
	if (ret) {
		LOG_ERR("Failed to set device resets (ret=%d)", ret);
		return ret;
	}

	return 0;
}

int tisci_cmd_get_device_resets(const struct device *dev, uint32_t dev_id, uint32_t *reset_state)
{

	return tisci_get_device_state(dev, dev_id, NULL, reset_state, NULL, NULL);
}

/* Processor Management Functions */
int tisci_cmd_proc_request(const struct device *dev, uint8_t proc_id)
{
	struct tisci_msg_req_proc_request req;
	struct tisci_msg_resp_proc_request resp;
	struct tisci_xfer *xfer;
	int ret;

	xfer = tisci_setup_one_xfer(dev, TISCI_MSG_PROC_REQUEST, 0, &req, sizeof(req), &resp,
				    sizeof(resp));
	if (!xfer) {
		LOG_ERR("Failed to setup transfer");
		return -EINVAL;
	}

	req.processor_id = proc_id;

	ret = tisci_do_xfer(dev, xfer);
	if (ret) {
		LOG_ERR("Failed to request processor control (ret=%d)", ret);
		return ret;
	}

	return 0;
}

int tisci_cmd_proc_release(const struct device *dev, uint8_t proc_id)
{
	struct tisci_msg_req_proc_release req;
	struct tisci_msg_resp_proc_release resp;
	struct tisci_xfer *xfer;
	int ret;

	xfer = tisci_setup_one_xfer(dev, TISCI_MSG_PROC_RELEASE, 0, &req, sizeof(req), &resp,
				    sizeof(resp));
	if (!xfer) {
		LOG_ERR("Failed to setup transfer");
		return -EINVAL;
	}

	req.processor_id = proc_id;

	ret = tisci_do_xfer(dev, xfer);
	if (ret) {
		LOG_ERR("Failed to release processor control (ret=%d)", ret);
		return ret;
	}

	return 0;
}

int tisci_cmd_proc_handover(const struct device *dev, uint8_t proc_id, uint8_t host_id)
{
	struct tisci_msg_req_proc_handover req;
	struct tisci_msg_resp_proc_handover resp;
	struct tisci_xfer *xfer;
	int ret;

	xfer = tisci_setup_one_xfer(dev, TISCI_MSG_PROC_HANDOVER, 0, &req, sizeof(req), &resp,
				    sizeof(resp));
	if (!xfer) {
		LOG_ERR("Failed to setup transfer");
		return -EINVAL;
	}

	req.processor_id = proc_id;
	req.host_id = host_id;

	ret = tisci_do_xfer(dev, xfer);
	if (ret) {
		LOG_ERR("Failed to handover processor control (ret=%d)", ret);
		return ret;
	}

	return 0;
}

int tisci_cmd_set_proc_boot_cfg(const struct device *dev, uint8_t proc_id, uint64_t bootvector,
				uint32_t config_flags_set, uint32_t config_flags_clear)
{
	struct tisci_msg_req_set_proc_boot_config req;
	struct tisci_msg_resp_set_proc_boot_config resp;
	struct tisci_xfer *xfer;
	int ret;

	xfer = tisci_setup_one_xfer(dev, TISCI_MSG_SET_PROC_BOOT_CONFIG, 0, &req, sizeof(req),
				    &resp, sizeof(resp));
	if (!xfer) {
		LOG_ERR("Failed to setup transfer");
		return -EINVAL;
	}

	req.processor_id = proc_id;
	req.bootvector_low = bootvector & TISCI_ADDR_LOW_MASK;
	req.bootvector_high = (bootvector & TISCI_ADDR_HIGH_MASK) >> TISCI_ADDR_HIGH_SHIFT;
	req.config_flags_set = config_flags_set;
	req.config_flags_clear = config_flags_clear;

	ret = tisci_do_xfer(dev, xfer);
	if (ret) {
		LOG_ERR("Failed to set processor boot configuration (ret=%d)", ret);
		return ret;
	}

	return 0;
}

int tisci_cmd_set_proc_boot_ctrl(const struct device *dev, uint8_t proc_id,
				 uint32_t control_flags_set, uint32_t control_flags_clear)
{
	struct tisci_msg_req_set_proc_boot_ctrl req;
	struct tisci_msg_resp_set_proc_boot_ctrl resp;
	struct tisci_xfer *xfer;
	int ret;

	xfer = tisci_setup_one_xfer(dev, TISCI_MSG_SET_PROC_BOOT_CTRL, 0, &req, sizeof(req), &resp,
				    sizeof(resp));
	if (!xfer) {
		LOG_ERR("Failed to setup transfer");
		return -EINVAL;
	}

	req.processor_id = proc_id;
	req.control_flags_set = control_flags_set;
	req.control_flags_clear = control_flags_clear;

	ret = tisci_do_xfer(dev, xfer);
	if (ret) {
		LOG_ERR("Failed to set processor boot control (ret=%d)", ret);
		return ret;
	}

	return 0;
}

int tisci_cmd_proc_auth_boot_image(const struct device *dev, uint64_t *image_addr,
				   uint32_t *image_size)
{
	struct tisci_msg_req_proc_auth_boot_image req;
	struct tisci_msg_resp_proc_auth_boot_image resp;
	struct tisci_xfer *xfer;
	int ret;

	if (!image_addr) {
		return -EINVAL;
	}

	xfer = tisci_setup_one_xfer(dev, TISCI_MSG_PROC_AUTH_BOOT_IMAGE, 0, &req, sizeof(req),
				    &resp, sizeof(resp));
	if (!xfer) {
		LOG_ERR("Failed to setup transfer");
		return -EINVAL;
	}

	req.cert_addr_low = *image_addr & TISCI_ADDR_LOW_MASK;
	req.cert_addr_high = (*image_addr & TISCI_ADDR_HIGH_MASK) >> TISCI_ADDR_HIGH_SHIFT;

	ret = tisci_do_xfer(dev, xfer);
	if (ret) {
		LOG_ERR("Failed to authenticate boot image (ret=%d)", ret);
		return ret;
	}

	*image_addr =
		(resp.image_addr_low & TISCI_ADDR_LOW_MASK) |
		(((uint64_t)resp.image_addr_high << TISCI_ADDR_HIGH_SHIFT) & TISCI_ADDR_HIGH_MASK);

	if (image_size) {
		*image_size = resp.image_size;
	}

	return 0;
}

int tisci_cmd_get_proc_boot_status(const struct device *dev, uint8_t proc_id, uint64_t *bv,
				   uint32_t *cfg_flags, uint32_t *ctrl_flags, uint32_t *sts_flags)
{
	struct tisci_msg_resp_get_proc_boot_status resp;
	struct tisci_msg_req_get_proc_boot_status req;
	struct tisci_xfer *xfer;
	int ret;

	if (!bv && !cfg_flags && !ctrl_flags && !sts_flags) {
		return -EINVAL;
	}

	xfer = tisci_setup_one_xfer(dev, TISCI_MSG_GET_PROC_BOOT_STATUS, 0, &req, sizeof(req),
				    &resp, sizeof(resp));
	if (!xfer) {
		LOG_ERR("Failed to setup transfer");
		return -EINVAL;
	}

	req.processor_id = proc_id;

	ret = tisci_do_xfer(dev, xfer);
	if (ret) {
		LOG_ERR("Failed to get processor boot status (ret=%d)", ret);
		return ret;
	}

	if (bv) {
		*bv = (resp.bootvector_low & TISCI_ADDR_LOW_MASK) |
		      (((uint64_t)resp.bootvector_high << TISCI_ADDR_HIGH_SHIFT) &
		       TISCI_ADDR_HIGH_MASK);
	}
	if (cfg_flags) {
		*cfg_flags = resp.config_flags;
	}
	if (ctrl_flags) {
		*ctrl_flags = resp.control_flags;
	}
	if (sts_flags) {
		*sts_flags = resp.status_flags;
	}

	return 0;
}

/* Resource Management Functions */
int tisci_get_resource_range(const struct device *dev, uint32_t dev_id, uint8_t subtype,
			     uint8_t s_host, uint16_t *range_start, uint16_t *range_num)
{
	struct tisci_msg_resp_get_resource_range resp;
	struct tisci_msg_req_get_resource_range req;
	struct tisci_xfer *xfer;
	int ret;

	if (!s_host) {
		return -EINVAL;
	}
	if (!range_start && !range_num) {
		return -EINVAL;
	}

	xfer = tisci_setup_one_xfer(dev, TISCI_MSG_GET_RESOURCE_RANGE, 0, &req, sizeof(req), &resp,
				    sizeof(resp));
	if (!xfer) {
		LOG_ERR("Failed to setup transfer");
		return -EINVAL;
	}

	req.secondary_host = s_host;
	req.type = dev_id & MSG_RM_RESOURCE_TYPE_MASK;
	req.subtype = subtype & MSG_RM_RESOURCE_SUBTYPE_MASK;

	ret = tisci_do_xfer(dev, xfer);
	if (ret) {
		LOG_ERR("Failed to get resource range (ret=%d)", ret);
		return ret;
	}

	if (!resp.range_start && !resp.range_num) {
		return -ENODEV;
	}

	if (range_start) {
		*range_start = resp.range_start;
	}
	if (range_num) {
		*range_num = resp.range_num;
	}

	return 0;
}

int tisci_cmd_get_resource_range(const struct device *dev, uint32_t dev_id, uint8_t subtype,
				 uint16_t *range_start, uint16_t *range_num)
{
	return tisci_get_resource_range(dev, dev_id, subtype, TISCI_IRQ_SECONDARY_HOST_INVALID,
					range_start, range_num);
}

int tisci_cmd_get_resource_range_from_shost(const struct device *dev, uint32_t dev_id,
					    uint8_t subtype, uint8_t s_host, uint16_t *range_start,
					    uint16_t *range_num)
{
	return tisci_get_resource_range(dev, dev_id, subtype, s_host, range_start, range_num);
}

/* Board Configuration Functions */

int cmd_set_board_config_using_msg(const struct device *dev, uint16_t msg_type, uint64_t addr,
				   uint32_t size)
{
	struct tisci_msg_board_config_req req;
	struct tisci_msg_board_config_resp resp;
	struct tisci_xfer *xfer;
	int ret;

	xfer = tisci_setup_one_xfer(dev, msg_type, 0, &req, sizeof(req), &resp, sizeof(resp));
	if (!xfer) {
		LOG_ERR(" Failed to setup board config transfer");
		return -EINVAL;
	}

	req.boardcfgp_high = (addr >> 32) & 0xFFFFFFFFU;
	req.boardcfgp_low = addr & 0xFFFFFFFFU;
	req.boardcfg_size = size;

	ret = tisci_do_xfer(dev, xfer);
	if (ret) {
		LOG_ERR("Board config transfer failed (ret=%d)", ret);
		return ret;
	}

	return 0;
}

/* Version/Revision Function */
int tisci_cmd_get_revision(const struct device *dev, struct tisci_version_info *ver)
{
	struct tisci_msg_hdr hdr;
	struct tisci_msg_resp_version rev_info;
	struct tisci_xfer *xfer;
	int ret;

	if (!ver) {
		return -EINVAL;
	}

	xfer = tisci_setup_one_xfer(dev, TISCI_MSG_VERSION, 0, &hdr, sizeof(hdr), &rev_info,
				    sizeof(rev_info));
	if (!xfer) {
		LOG_ERR("Failed to setup transfer");
		return -EINVAL;
	}

	ret = tisci_do_xfer(dev, xfer);
	if (ret) {
		LOG_ERR("Failed to get version (ret=%d)", ret);
		return ret;
	}

	ver->abi_major = rev_info.abi_major;
	ver->abi_minor = rev_info.abi_minor;
	ver->firmware_revision = rev_info.firmware_revision;
	strncpy(ver->firmware_description, rev_info.firmware_description,
		sizeof(ver->firmware_description));
	return 0;
}

/* System Control Functions */

int tisci_cmd_sys_reset(const struct device *dev)
{
	struct tisci_msg_req_reboot req;
	struct tisci_msg_resp_reboot resp;
	struct tisci_xfer *xfer;
	int ret;

	xfer = tisci_setup_one_xfer(dev, TISCI_MSG_SYS_RESET, 0, &req, sizeof(req), &resp,
				    sizeof(resp));
	if (!xfer) {
		LOG_ERR(" Failed to setup system reset transfer");
		return -EINVAL;
	}

	req.domain = 0;

	ret = tisci_do_xfer(dev, xfer);
	if (ret) {
		LOG_ERR("System reset request failed (ret=%d)", ret);
		return ret;
	}

	return 0;
}

/* Memory Management Functions */

int tisci_cmd_query_msmc(const struct device *dev, uint64_t *msmc_start, uint64_t *msmc_end)
{
	struct tisci_msg_resp_query_msmc resp;
	struct tisci_msg_hdr req;
	struct tisci_xfer *xfer;
	int ret;

	if (!msmc_start || !msmc_end) {
		return -EINVAL;
	}

	xfer = tisci_setup_one_xfer(dev, TISCI_MSG_QUERY_MSMC, 0, &req, sizeof(req), &resp,
				    sizeof(resp));
	if (!xfer) {
		LOG_ERR(" Failed to setup MSMC query transfer");
		return -EINVAL;
	}

	ret = tisci_do_xfer(dev, xfer);
	if (ret) {
		LOG_ERR("MSMC query failed (ret=%d)", ret);
		return ret;
	}

	*msmc_start =
		((uint64_t)resp.msmc_start_high << TISCI_ADDR_HIGH_SHIFT) | resp.msmc_start_low;
	*msmc_end = ((uint64_t)resp.msmc_end_high << TISCI_ADDR_HIGH_SHIFT) | resp.msmc_end_low;

	return 0;
}

/* Firewall Management Functions */

int tisci_cmd_set_fwl_region(const struct device *dev, const struct tisci_msg_fwl_region *region)
{
	struct tisci_msg_fwl_set_firewall_region_req req;
	struct tisci_msg_fwl_set_firewall_region_resp resp;
	struct tisci_xfer *xfer;
	int ret;

	if (!region) {
		return -EINVAL;
	}

	xfer = tisci_setup_one_xfer(dev, TISCI_MSG_FWL_SET, 0, &req, sizeof(req), &resp,
				    sizeof(resp));
	if (!xfer) {
		LOG_ERR(" Failed to setup firewall config transfer");
		return -EINVAL;
	}

	req.fwl_id = region->fwl_id;
	req.region = region->region;
	req.n_permission_regs = region->n_permission_regs;
	req.control = region->control;
	memcpy(req.permissions, region->permissions, sizeof(uint32_t) * FWL_MAX_PRIVID_SLOTS);
	req.start_address = region->start_address;
	req.end_address = region->end_address;

	ret = tisci_do_xfer(dev, xfer);
	if (ret) {
		LOG_ERR("Firewall config transfer failed (ret=%d)", ret);
		return ret;
	}

	return 0;
}

int tisci_cmd_get_fwl_region(const struct device *dev, struct tisci_msg_fwl_region *region)
{
	struct tisci_msg_fwl_get_firewall_region_req req;
	struct tisci_msg_fwl_get_firewall_region_resp resp;
	struct tisci_xfer *xfer;
	int ret;

	if (!region) {
		return -EINVAL;
	}

	xfer = tisci_setup_one_xfer(dev, TISCI_MSG_FWL_GET, 0, &req, sizeof(req), &resp,
				    sizeof(resp));
	if (!xfer) {
		LOG_ERR(" Failed to setup firewall query transfer");
		return -EINVAL;
	}

	req.fwl_id = region->fwl_id;
	req.region = region->region;
	req.n_permission_regs = region->n_permission_regs;

	ret = tisci_do_xfer(dev, xfer);
	if (ret) {
		LOG_ERR("Firewall query transfer failed (ret=%d)", ret);
		return ret;
	}

	region->fwl_id = resp.fwl_id;
	region->region = resp.region;
	region->n_permission_regs = resp.n_permission_regs;
	region->control = resp.control;
	memcpy(region->permissions, resp.permissions, sizeof(uint32_t) * FWL_MAX_PRIVID_SLOTS);
	region->start_address = resp.start_address;
	region->end_address = resp.end_address;

	return 0;
}

int tisci_cmd_change_fwl_owner(const struct device *dev, struct tisci_msg_fwl_owner *owner)
{
	struct tisci_msg_fwl_change_owner_info_req req;
	struct tisci_msg_fwl_change_owner_info_resp resp;
	struct tisci_xfer *xfer;
	int ret;

	if (!owner) {
		return -EINVAL;
	}

	xfer = tisci_setup_one_xfer(dev, TISCI_MSG_FWL_CHANGE_OWNER, 0, &req, sizeof(req), &resp,
				    sizeof(resp));
	if (!xfer) {
		LOG_ERR(" Failed to setup firewall owner change transfer");
		return -EINVAL;
	}

	req.fwl_id = owner->fwl_id;
	req.region = owner->region;
	req.owner_index = owner->owner_index;

	ret = tisci_do_xfer(dev, xfer);
	if (ret) {
		LOG_ERR("Firewall owner change failed (ret=%d)", ret);
		return ret;
	}

	owner->fwl_id = resp.fwl_id;
	owner->region = resp.region;
	owner->owner_index = resp.owner_index;
	owner->owner_privid = resp.owner_privid;
	owner->owner_permission_bits = resp.owner_permission_bits;

	return 0;
}

/* UDMAP Management Functions */

int tisci_cmd_rm_udmap_tx_ch_cfg(const struct device *dev,
				 const struct tisci_msg_rm_udmap_tx_ch_cfg *params)
{
	struct tisci_msg_rm_udmap_tx_ch_cfg_req req;
	struct tisci_msg_rm_udmap_tx_ch_cfg_resp resp;
	struct tisci_xfer *xfer;
	int ret;

	if (!params) {
		return -EINVAL;
	}

	xfer = tisci_setup_one_xfer(dev, TISCI_MSG_RM_UDMAP_TX_CH_CFG, 0, &req, sizeof(req), &resp,
				    sizeof(resp));
	if (!xfer) {
		LOG_ERR(" Failed to setup UDMAP TX channel config transfer");
		return -EINVAL;
	}

	/* Copy all configuration parameters */
	req.valid_params = params->valid_params;
	req.nav_id = params->nav_id;
	req.index = params->index;
	req.tx_pause_on_err = params->tx_pause_on_err;
	req.tx_filt_einfo = params->tx_filt_einfo;
	req.tx_filt_pswords = params->tx_filt_pswords;
	req.tx_atype = params->tx_atype;
	req.tx_chan_type = params->tx_chan_type;
	req.tx_supr_tdpkt = params->tx_supr_tdpkt;
	req.tx_fetch_size = params->tx_fetch_size;
	req.tx_credit_count = params->tx_credit_count;
	req.txcq_qnum = params->txcq_qnum;
	req.tx_priority = params->tx_priority;
	req.tx_qos = params->tx_qos;
	req.tx_orderid = params->tx_orderid;
	req.fdepth = params->fdepth;
	req.tx_sched_priority = params->tx_sched_priority;
	req.tx_burst_size = params->tx_burst_size;
	req.tx_tdtype = params->tx_tdtype;
	req.extended_ch_type = params->extended_ch_type;

	ret = tisci_do_xfer(dev, xfer);
	if (ret) {
		LOG_ERR("UDMAP TX channel %u config failed (ret=%d)", params->index, ret);
		return ret;
	}

	LOG_DBG("UDMAP TX channel %u configured successfully", params->index);
	return 0;
}

int tisci_cmd_rm_udmap_rx_ch_cfg(const struct device *dev,
				 const struct tisci_msg_rm_udmap_rx_ch_cfg *params)
{
	struct tisci_msg_rm_udmap_rx_ch_cfg_req req;
	struct tisci_msg_rm_udmap_rx_ch_cfg_resp resp;
	struct tisci_xfer *xfer;
	int ret;

	if (!params) {
		return -EINVAL;
	}

	xfer = tisci_setup_one_xfer(dev, TISCI_MSG_RM_UDMAP_RX_CH_CFG, 0, &req, sizeof(req), &resp,
				    sizeof(resp));
	if (!xfer) {
		LOG_ERR(" Failed to setup UDMAP RX channel config transfer");
		return -EINVAL;
	}

	/* Copy all configuration parameters */
	req.valid_params = params->valid_params;
	req.nav_id = params->nav_id;
	req.index = params->index;
	req.rx_fetch_size = params->rx_fetch_size;
	req.rxcq_qnum = params->rxcq_qnum;
	req.rx_priority = params->rx_priority;
	req.rx_qos = params->rx_qos;
	req.rx_orderid = params->rx_orderid;
	req.rx_sched_priority = params->rx_sched_priority;
	req.flowid_start = params->flowid_start;
	req.flowid_cnt = params->flowid_cnt;
	req.rx_pause_on_err = params->rx_pause_on_err;
	req.rx_atype = params->rx_atype;
	req.rx_chan_type = params->rx_chan_type;
	req.rx_ignore_short = params->rx_ignore_short;
	req.rx_ignore_long = params->rx_ignore_long;

	ret = tisci_do_xfer(dev, xfer);
	if (ret) {
		LOG_ERR("UDMAP RX channel %u config failed (ret=%d)", params->index, ret);
		return ret;
	}

	LOG_DBG("UDMAP RX channel %u configured successfully", params->index);
	return 0;
}

/* PSI-L Management Functions */

int tisci_cmd_rm_psil_pair(const struct device *dev, uint32_t nav_id, uint32_t src_thread,
			   uint32_t dst_thread)
{
	struct tisci_msg_psil_pair_req req;
	struct tisci_msg_psil_pair_resp resp;
	struct tisci_xfer *xfer;
	int ret;

	xfer = tisci_setup_one_xfer(dev, TISCI_MSG_RM_PSIL_PAIR, 0, &req, sizeof(req), &resp,
				    sizeof(resp));
	if (!xfer) {
		LOG_ERR(" Failed to setup PSI-L pair transfer");
		return -EINVAL;
	}

	req.nav_id = nav_id;
	req.src_thread = src_thread;
	req.dst_thread = dst_thread;

	ret = tisci_do_xfer(dev, xfer);
	if (ret) {
		LOG_ERR("PSI-L pair failed nav:%u %u->%u (ret=%d)", nav_id, src_thread, dst_thread,
			ret);
		return ret;
	}

	LOG_DBG("PSI-L pair successful nav:%u %u->%u", nav_id, src_thread, dst_thread);
	return 0;
}

int tisci_cmd_rm_psil_unpair(const struct device *dev, uint32_t nav_id, uint32_t src_thread,
			     uint32_t dst_thread)
{
	struct tisci_msg_psil_unpair_req req;
	struct tisci_msg_psil_unpair_resp resp;
	struct tisci_xfer *xfer;
	int ret;

	xfer = tisci_setup_one_xfer(dev, TISCI_MSG_RM_PSIL_UNPAIR, 0, &req, sizeof(req), &resp,
				    sizeof(resp));
	if (!xfer) {
		LOG_ERR(" Failed to setup PSI-L unpair transfer");
		return -EINVAL;
	}

	req.nav_id = nav_id;
	req.src_thread = src_thread;
	req.dst_thread = dst_thread;

	ret = tisci_do_xfer(dev, xfer);
	if (ret) {
		LOG_ERR("PSI-L unpair failed %u->%u (ret=%d)", src_thread, dst_thread, ret);
		return ret;
	}

	LOG_DBG("PSI-L unpair successful %u->%u", src_thread, dst_thread);
	return 0;
}

/* Interrupt Management Functions */
int tisci_cmd_rm_irq_set(const struct device *dev, struct tisci_irq_set_req *client_req)
{
	struct tisci_xfer *xfer;
	struct tisci_msg_rm_irq_set_resp resp = {0};
	int ret;

	if (!client_req) {
		return -EINVAL;
	}

	struct tisci_msg_rm_irq_set_req req = {
		.hdr = {0},
		.valid_params = client_req->valid_params,
		.src_id = client_req->src_id,
		.src_index = client_req->src_index,
		.dst_id = client_req->dst_id,
		.dst_host_irq = client_req->dst_host_irq,
		.ia_id = client_req->ia_id,
		.vint = client_req->vint,
		.global_event = client_req->global_event,
		.vint_status_bit_index = client_req->vint_status_bit_index,
		.secondary_host = client_req->secondary_host,
	};

	xfer = tisci_setup_one_xfer(dev, TISCI_MSG_RM_IRQ_SET, 0, &req, sizeof(req), &resp,
				    sizeof(resp));
	if (!xfer) {
		LOG_ERR("Failed to setup transfer");
		return -EINVAL;
	}

	ret = tisci_do_xfer(dev, xfer);
	if (ret) {
		LOG_ERR("Failed to set IRQ (ret=%d)", ret);
		return ret;
	}

	return 0;
}

int tisci_cmd_rm_irq_release(const struct device *dev, struct tisci_irq_release_req *client_req)
{
	struct tisci_xfer *xfer;
	struct tisci_msg_rm_irq_release_resp resp = {0};
	int ret;

	if (!client_req) {
		return -EINVAL;
	}

	struct tisci_msg_rm_irq_release_req req = {
		.hdr = {0},
		.valid_params = client_req->valid_params,
		.src_id = client_req->src_id,
		.src_index = client_req->src_index,
		.dst_id = client_req->dst_id,
		.dst_host_irq = client_req->dst_host_irq,
		.ia_id = client_req->ia_id,
		.vint = client_req->vint,
		.global_event = client_req->global_event,
		.vint_status_bit_index = client_req->vint_status_bit_index,
		.secondary_host = client_req->secondary_host,
	};

	xfer = tisci_setup_one_xfer(dev, TISCI_MSG_RM_IRQ_RELEASE, 0, &req, sizeof(req), &resp,
				    sizeof(resp));
	if (!xfer) {
		LOG_ERR("Failed to setup transfer");
		return -EINVAL;
	}

	ret = tisci_do_xfer(dev, xfer);
	if (ret) {
		LOG_ERR("Failed to release IRQ (ret=%d)", ret);
		return ret;
	}

	return 0;
}

/* Init function */
static int tisci_init(const struct device *dev)
{
	const struct tisci_config *config = dev->config;
	struct tisci_data *data = dev->data;
	int ret;

	k_sem_init(data->rx_message.response_ready_sem, 0, 1);

	ret = mbox_register_callback_dt(&config->mbox_rx, callback, &data->rx_message);
	if (ret < 0) {
		LOG_ERR("Could not register callback (%d)\n", ret);
		return ret;
	}

	ret = mbox_set_enabled_dt(&config->mbox_rx, true);
	if (ret < 0) {
		LOG_ERR("Could not enable RX channel (%d)\n", ret);
		return ret;
	}
	return 0;
}

/* Device Tree Instantiation */
#define TISCI_DEFINE(_n)                                                                           \
	static uint8_t rx_message_buf_##_n[MAILBOX_MBOX_SIZE] = {0};                               \
	static struct k_sem response_ready_sem_##_n;                                               \
	static struct tisci_data tisci_data_##_n = {                                               \
		.seq = 0,                                                                          \
		.rx_message =                                                                      \
			{                                                                          \
				.buf = rx_message_buf_##_n,                                        \
				.size = sizeof(rx_message_buf_##_n),                               \
				.response_ready_sem = &response_ready_sem_##_n,                    \
			},                                                                         \
		.data_sem = Z_SEM_INITIALIZER(tisci_data_##_n.data_sem, 1, 1),                     \
	};                                                                                         \
	static const struct tisci_config tisci_config_##_n = {                                     \
		.mbox_tx = MBOX_DT_SPEC_INST_GET(_n, tx),                                          \
		.mbox_rx = MBOX_DT_SPEC_INST_GET(_n, rx),                                          \
		.host_id = DT_INST_PROP(_n, ti_host_id),                                           \
		.max_msg_size = MAILBOX_MBOX_SIZE,                                                 \
		.max_rx_timeout_ms = 10000,                                                        \
	};                                                                                         \
	DEVICE_DT_INST_DEFINE(_n, tisci_init, NULL, &tisci_data_##_n, &tisci_config_##_n,          \
			      PRE_KERNEL_1, CONFIG_TISCI_INIT_PRIORITY, NULL);

DT_INST_FOREACH_STATUS_OKAY(TISCI_DEFINE)